Firmware & Guides

Ender 3 V2 BLTouch Firmware Installation Guide by Smith3D [Updated –13 November 2022]

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
01
Aug
Contents hide
1 BLTouch Installation
2 BLTouch Mount
3 Firmware
4 Some UI customizations the community has added
5 Some other features were offered compared to Stock firmware
6 And remember to add “M420 S1” in Cura!
7 You can also add G29 for Bed Leveling before every prints
8 Nozzle Crashing Into Bed?
9 Steps to produce a good leveling
10 What if you are not getting an accurate Z Offset from the Tool? (Live Adjust Z Offset)
11 FAQ
11.1 Z-axis won’t budge
11.2 Black Screen of Death after flashed
11.3 Bltouch probe not centered / change probe offset
11.4 Manual Leveled & still printing in mid air or nozzle hitting the bed
11.5 Sometimes Probe doesn’t finish during leveling
11.6 Setting is not saved
11.7 OctoPrint Settings
11.8 Power Lose Recovery doesn’t work
11.9 Motor making noises and freeze during print.
11.10 Sometimes UI/ print progress bar does not reflect to the latest
11.11 Can I use 3DTouch or BLTouch older than v3.1?
11.12 Where can I get the source code? How to compile?
11.13 How to donate?
11.14 What happens If I don’t want a BLTouch anymore?
12 3D Printer Repair Service by Smith3D

BLTouch Installation

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
If you are using a different extension wire, please pay attention to the wire colors above.

BLTouch Mount

BLTouch Mount for Ender3 V2 – Link here (Use the two screws provided by BLTouch to screw it in.)

Firmware

Download Marlin Firmware V2.0.1 – Jyer Builds
Download Marlin Firmware 20221002 – Professional Firmware Builds

* Last Update from Jyers has been 1 year ago, Professional Firmware has more features but setup guide maybe different.

The very first thing you should to is go into Control > Advanced and adjust Probe Offset X to -42 & Probe Y Offset -10 (Printed Mount). and Control > Store Setting.

If you are using Creality official BL-Touch set, you have to set it to Probe X Offset -44 & Probe Y Offset -6.

MountProbe X OffsetProbe Y Offset
Custom Mount V3-42-10
Creality Official Mount-44-6

Video Guide by CHEP : https://www.youtube.com/watch?v=TroPjdkSEOY (Video guide doesn’t include manual leveling, do make sure you do manual bed leveling after adjust the z offset)

Unless your system is well tuned, please use the firmware above instead of high speed. Slow Probe & 5 x 5, which is great for first time tuning.

[8th April] As for Smith3D firmware, we have depreciated our firmware & move on to Jyer firmware as it offer much better features & functionality.

For BTT Filament Sensor & Standard Filament sensor, do enable them
inside Control > Advanced > Filament Sensor/Runout Distance

If you have never change your motherboard, it’s 4.2.2 by default

For 4.2.2 5×5 (High Speed) – download here
For 4.2.7 Board 5×5 (High Speed) – download here
For more info regarding this release
For people who’s suffering random probe fails, please refer to the FAQ below for z switch port firmware.

If flashed & auto leveling doesn’t work, please reset configuration (Control > Restore Default) or try to flash again with different filename. If you are getting Black screen, do format your MicroSD Card to FAT32 and rename the firmware & try again.

Older Build (V1.3.5b)

If you are facing issue on newer builds, you may try the older build

Download Marlin Firmware V1.2.2 – Jyers

What’s BL Touch High Speed Mode?

  • The high speed mode probes multiple points without stowing the needle, making it much much faster. But also prone to crashes if your bed is severely slanted. Please make good use of Manual leveling before you try this.

For Ender 3 V2 no bootloader installation is required. Copy the firmware into your SD card and then slot it in, the printer will begin flashing once you reboot it. Do remember that you need a different filename each time you flash a new firmware eg. firmware1.1bin > firmware1.2bin, else the system will ignore it.

For user who would prefer official firmware from Creality, you may check this guide here

Some UI customizations the community has added

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
For Manual Leveling, please refer to CHEP guide https://www.youtube.com/watch?v=_EfWVUJjBdA

Some other features were offered compared to Stock firmware

  • Turn on and off display during printing
  • PID Autotune Menu
  • Change Filament menu
  • Adjust probe offset, filament sensor in the menu
  • __h__m Time Format Setting

And remember to add “M420 S1” in Cura!

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
VERY IMPORTANT Add M420 S1; after the G28 in your start G-code in the starting G-code of your cura profile. To enable leveling on every prints. As the current marlin for Ender 3 V2 is unable to make “leveling enabled” persistent after reboot. M420 S1; Enable ABL (If you are getting error for Fade Height) This line of code always appear in other printer profile such as CR10SProV2/Ender5Plus where there is BLTouch built in.

You can also add G29 for Bed Leveling before every prints

Instead of adding the M420 S1 command above. You can replace it with G29 (Place it after G28). G29 basically starts a new round of auto bed leveling , good for users who would prefer a fresh bed leveling before every prints.

Nozzle Crashing Into Bed?

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]

Steps to produce a good leveling

  • Once you setup the Probe Offset X & Probe Offset Y, Store Setting and go to Prepare > Auto Home. Make sure your probe is directly at the center of the bed.
Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
Picture by CHEP
  • Start with Manual leveling to make sure the bed is leveled as much as you can, by manually adjusting bed spring. This is to reduce the amount of Z compensation ABL will need to apply when printing. Please refer to CHEP’s guide for how you can level your bed with a piece of paper. The firmware has included the buttons needed for printer to go to all 4 corners + center so you don’t have to do it via a gcode print file.
  • After the bed is leveled, get a good Z-offset by using the Prepare > Z-Offset. Remember to pre-heat your nozzle while using this as any remaining material stuck on nozzle tip might interfere the result while gauging with A4 paper. This tool will Auto home and then move Z to 0 to show actual Z offset. Prepare a paper to put between nozzle and bed, then try sliding it in and out, Microstep Up/Down & adjust Z offset until you feel a little friction between paper and nozzle. Use Home Z-Axis to double confirm if the z offset is the right one.
Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
Picture by CHEP
  • Once you got your Z offset, go to main menu and press “Leveling”. It will probe 5×5 points and save the mesh to your printer.
  • Done and start printing!
  • Again, it’s very important to heat up nozzle to 180-200 while using Z-offset (if there is PLA in nozzle) Else the Z-offset will vary a lot depending on the leftover material stuck on nozzle tip.

What if you are not getting an accurate Z Offset from the Tool? (Live Adjust Z Offset)

Sometimes moving the Z axis up and down bit by bit might cause a little slippages, which makes the Z-Offset gauging with A4 paper inaccurate.

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]
Picture by CHEP

If you want a better gauging result. We recommend user to adjust Z Offset via Tune during printing

FAQ

Z-axis won’t budge

Pay attention to the wiring color, some wires are inverted. If you are using 3rd party wiring, most probably the last two orange and yellow are inverted. You have to manually revert it back using a tweezer.

Black Screen of Death after flashed

Please follow this reddit link for full guide on how to do a proper flash
In summary
– Use newly formated sd card, with only bin file
– Rename bin file
– Unplug & reconnect power cord

Bltouch probe not centered / change probe offset

adjust Control > Advanced > Probe Offset X & Probe Offset Y

Manual Leveled & still printing in mid air or nozzle hitting the bed

Use slow probe 5×5 firmware to see if the situation is improving, if not check if your M420/G29 is added inside the start of gcode. Use either G29 or M420. Remember to save setting after leveled.

Sometimes Probe doesn’t finish during leveling

Solution 1:
Some users has issue with the bltouch port. the trigger signal or ground is not attached properly. Connect the two pin to the z switch stop & flash the firmware below.

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]

Download 2.0.x.17 ZSwitchStop 5×5 Fast Smith3d Marlin Firmware

Solution 2:
Try connect via Pronterface and check what’s the error code returned.

Summary (this reddit link explained in detail)
– Make sure bed not totally out of level, probe may out of reach or nozzle hit the bed first
– Check if your bed is badly warped
– Check if your bltouch pin is bent
– Check the XY axis wheel tension
– Check the Z axis for binding

Solution 3:
There is a resistor fix for this, you can solder a resistor and use the bltouch port.

Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]

Setting is not saved

Remember to click “Control > Store Setting” everytime you setup completed. Check if eeprom is deleted in SD Card.

OctoPrint Settings

OctoPrint Settings by Jyers

Power Lose Recovery doesn’t work

Power Lose Recovery only works when it reached certain layer. check your SD card if there is a PLR file exist. PLR determine if to display the Resume Printing message.

Motor making noises and freeze during print.

This will happen if you just flashed the firmware & does not reset the configuration. Just turn off and on your printer will do, restore default setting. Another possible issue is the dupont connectors on the motherboard loosen, do hot glue the connectors in place or upgrade it to 5 pin JST connector.

Sometimes UI/ print progress bar does not reflect to the latest

Known marlin bug. Restart, press back, will do.

Can I use 3DTouch or BLTouch older than v3.1?

May not compatible, this firmware is optimized for BLTouch v3.1.

Where can I get the source code? How to compile?

Github Repository is here.

If you are having issue compiling your own marlin, remember to set default_envs = STM32F103RET6_creality in platform.ini

How to donate?

Please donate to Marlin Firmware & https://www.paypal.com/paypalme/jyers. Without them, there will be no great firmware for Ender 3 V2

What happens If I don’t want a BLTouch anymore?

You may revert your firmware to the official non-BLTouch firmware downloadable via this link – https://www.creality.com/pages/download-ender-3-v2

3D Printer Repair Service by Smith3D

If you are around Kuala Lumpur, Malaysia and would prefer an expert to service your Creality 3D Printer, check out our repair 3D printer service.

Smith3D

1,297 thoughts on “Ender 3 V2 BLTouch Firmware Installation Guide by Smith3D [Updated –13 November 2022]”

  2. Larry says:

    Do you have the command in marlin set like this

    #define PROBING_HEATERS_OFF

    I’m getting interference from the heater wires so the probe isn’t working correctly and believe this could fix the problem.

    Reply
  3. Vic says:

    Hey,

    Thank you very much for the time and effort in creating this. Everything worked perfectly from the first try. Ender 3 v2 with bltouch v3.1 with premade extension cables. Easy peasy. Your firmware update is amazing!! I had no idea about the levelling function. Thank you

    Reply
  4. Mikael says:

    When I do auto level, it starts well but does not go all the way to the right side and probe.

    I am running Marlin Firmware V2.0.X.14 – Smith3D Slow Probe & 5 x 5

    What is the problem ??

    Reply
  6. Eiffeltom says:

    Great job.
    I have Firmware V2.0.X.14 5×5 – is it ok that on the left it measures cca 10 mm from the edge but on the right it measures much further from the edge, cca 50 mm? The extruder has space to move more to the right so that the probe can measure also nearer to the edge like on the left side.

    Reply
  7. Joseph Fannon says:

    Is there a way to set the probes physical offset other then the Z offset so the printer knows the location of the mesh and can adjust the nozzle more precisely? Had a larger print that after configuring the BLtouch it was pushing the nozzle too far down in one corner causing no filament to extrude even after running a G29 code on that run.

    Reply
  8. Timothy Ward says:

    This guide is brilliant and works very well.
    Is there any chance you can do a 5×5 grid firmware version with the filament runout sensor included?

    Reply
  11. Jim says:

    Thank you very much for the guide, but for the life of me I cannot get the bl touch to stop the hot end from crashing into the bed until I power down the ender 2. I tried swapping the 2 pin around but still no luck, any ideas why this might be happening?

    Reply
  12. Armin says:

    Hi, thanks for the great work – I would be lost without this guide ;). I still have a problem though.

    Everything seems to work but I have to keep adjusting the Z-Offset after everyprint (ranging from around 4.50 to 5.30).
    Even after Switching from the Z-Offset Tool to Aux Leveling (checking with the center measuring point) the Z-Offset seems wrong. Even after turning the printer on/off the Z-Offset seems to keep changing.

    Anything I can do or check?

    Thank you 🙂

    Reply
  13. Armin says:

    Hi, thanks for the great work – I would be lost without this guide ;). I still have a problem though.
    I bought a Bltouch from 3.1 from Amazon (so no chinese knock off – at least I hope that’s the case)

    Everything seems to work but I have to keep adjusting the Z-Offset after everyprint (ranging from around 4.50 to 5.30).
    Even after Switching from the Z-Offset Tool to Aux Leveling (checking with the center measuring point) the Z-Offset seems wrong. Even after turning the printer on/off the Z-Offset seems to keep changing.

    Anything I can do or check?

    Thank you 🙂

    Reply
  14. mkalbunyo says:

    Hello. Two days ago I bought trianglelab bltouch but when i do probing bltouch gives error randomly when stowing second time. I tried a lot of thing but non of them worked.

    Reply
      • mkalbunyo says:

        Thank you for your reply. I solved problem with flashing different precompiled firmware. I read a comment in different website and it was saying about second time stowing timing. I think when bltouch touches the bed at second time, measuring time is too short and printer can not measuring. I am leaving the website here for you can inspect it. Also English is not my native language. I am sorry for mistakes I did. Here is my current firmware. “https://is.gd/jto6aH” enter the precompiled firmware folder. name is “adv_menu_Bltouch_2020092.bin”

        Reply
  15. Donald Schafer says:

    I am looking for the firmware for the ender 3 V2 that come with the bltouch and the temp to go to 315 to print in carbon fiber nylon. Any help would be appreciated. Thank you

    Reply
  16. Corito Meltono says:

    CRAP! I just installed the Slow Probe & 5 x 5, as I am a 1st time BLtouch user and wanted to take things slowly. My 1st time selecting Bed Level and things were looking fine, BUT every time the head chassis goes all the way to the right it rams the screw/nut into the frame of the printer!!!

    Why does it go so far to the right and how can I fix this? I dont want to permentantly damage my Ender bc it keeps ramming the x axis into the frame 🙁

    Thanks for your help, anyone that can help

    Reply
  17. Gregory says:

    First, thank you for putting this all together. It would be great if you could enable Linear Advance as well though. I can make the edits to your Configuration_adv file and compile myself but it doesnt seem to be pulling all of the data together. I dont get the white boarders or your extra (and super nice) menus. I’m very new compiling, so it could be me, but I think Linear Advance is something everyone is going to want.

    You will also have to define MINIMUM_STEPPER_PULSE to value 1 or greater in Configuration_adv for it work on this board, but it does work and gives some great corners.

    Thank you.

    Reply
  18. Erkan Erdogan says:

    Hi. Maybe a stupid question but how does one change XYZ probe offset if i make my own mount? Could someone explain this to me please?

    Reply
  19. Joshua says:

    Thank you for this guide. I am experiencing same BLtouch sensing issues occasionally. I have Ender 3v2 original board. I tired 2 different V3.1 BLtouch, and 3×3, 4×4 fast prob and Creality’s firmware as well. Normally, the BLtouch pin goes down, touch the bed, BLtouch light up, pin retracts. But sometimes there is an error, the pin goes down, touch the bed, BLtouch keep flashing, pin doesn’t retract. Do you know the fix? I would say it only happen 1/10. When it happens the nozzle just keep crushing into the build plate.

    Reply
  20. Mike Abbott says:

    Hi. I am having some problems with the Marlin firmware. On “Auto Home” the X & Y axis home OK. The nozzle then moves to the center of the bed, rises a few mm and then stops. The same thing happens with the Creality firmware. I’ve tried disconnecting the BL Touch but the same thing happens. When I load the original non BL touch Creality firmware, everything works OK. Am I missing something?

    Reply
      • Mike Abbott says:

        Thanks, I’ve checked the wiring and it’s as shown on the pictures in the instructions. The pin on the BL Touch goes up and down a couple of times when I switch on and stays up. I can use the “Move” option to move the Z axis up and down but when I try to Auto Home only the X and Y home, Z does not come down at all.

        I have an Ender 3 V2 with the V4.2.2 control board. The BL touch is V3.1.

        I will return the BL Touch for a replacement. Thanks for your help.

        Reply
  21. Eckhaert says:

    Hey. Thanks for the guide, it has helped me a lot.
    However, there is a slight issue with the firmwares that I have no idea how to fix. Maybe you can help point me in the right direction.
    I have a Hero Me gen 5 mounted on my ender 3 V2, for part cooling.
    The BLtouch mount for the 2x 5015 blower version is a bit more offset to the left of the hotend, and when it tries to probe the first left point of each line, the Bltouch pokes on the side of the bed, rather than on it.
    It also offsets the print head a bit on the Y axis, but it’s fine on that axis, as it’s still on the bed.

    Reply
  23. Everett says:

    I installed your firm it worked for about 10 mins. Now when when I hit auto level it just goes to the center of the bed and sticks the bltouch needle in and out and doesn’t do ANYTHING else. The display freezes on the “bed leveling please wait until done” message.

    Reply
  25. Fabs says:

    Hey and thanks for the tutorial.

    I have an 4.2.7 Board and installed your FW for 4.2.7 but i can not: Auto-Home AUX-Leveling etc.
    The printer does not move.

    Any ideas?

    Reply
  26. No.Trace says:

    Hi …
    First thanks a lot for the great Firmware … but with the Version .14 the AutoBedLeveling won’t work at any print?!
    I added the G29 Code and sometimes the BedLeveling will start the 5×5 probe, but it will stop after 6 or 7 “Steps”
    and starts the Print. I also tried to reset and reconfigure the settings, and also i tried to refresh the firm (with another filename”
    both solutions won’t work …
    Perhaps there is a new version “in work”? Or can you tell me what i can do now?
    Thanks Kai

    Reply
  28. Joshua Wang says:

    I am looking to add bltouch to my ender 3 v2. What is the difference between Smith3D firmware and Creality firmware? I only need 3×3 prob. Thank you!

    Reply
  29. Tomas says:

    Hello

    Just tried this firmware yesterday, managed to setup everything fine. Did a print and everything went fine.
    Tried printing again today and it won’t work. After probing (if I use g29) it just moves the hotend to the top right corner and extrudes at a mad speed. No printing or priming. I had to cancel everything.

    Currently using Cura, already tried reseting the printer settings. Any ideas what might be the cause?

    Reply
  30. Maunz says:

    Hey there.
    Thanks for this great tutorial.
    My question now is:
    Why do you connect the 2 pin cable also in this line? I watched more tutorials and there the 2 pin replaced the z axis limiter.
    Howerver i did so and it burned my Mainboard :(.
    And before i killed my board i defenitly figured out the error was the 2 pin.
    So i ordered a New board 4.2.7 for my v2.
    So what is the different? And also in a Video from creality i should use the Adapter?

    I am confused and dont want to burn another board.

    Greets

    Reply
    • Marcel says:

      I used the antclabs extension cable on my Ender 3 V2 with 4.2.2 Mainboard and cabled it like it is shown in the antclabs picture above and it is working fine. What I have read on another webside is that if the cables aren’t correct in the plug with the three cables then it can happen that the mainboard get damaged.

      Reply
    • sol says:

      Hi, the connection of cable really subjected to firmware which in this case, smith3d configure the firmware to read z-stop using the dedicated bl-touch and disalbe z-axis switch. All this can be configured in configuration.h. If you want to use smith3d firmware, you have to follow their wiring guide.

      Reply

Leave a Reply

Your email address will not be published. Required fields are marked *