Firmware & Guides
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]](https://www.smith3d.com/wp-content/uploads/2020/08/1-1024x496.png)
Aug
BLTouch Installation
![Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]](https://i1.wp.com/smith3d.com/wp-content/uploads/2020/07/1-scaled.jpg?fit=980%2C487&ssl=1 "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]](https://smith3d.com/wp-content/uploads/2020/08/7.jpg "Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]")
BLTouch Mount
BLTouch Mount for Ender3 V2 – Link here (Use the two screws provided by BLTouch to screw it in.)
Firmware
* 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.
| Mount | Probe X Offset | Probe 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
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]](https://smith3d.com/wp-content/uploads/2021/04/Untitled-1.jpg "Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]")
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]](https://smith3d.com/wp-content/uploads/2021/05/image-3-1024x611.png "Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]")
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]](https://smith3d.com/wp-content/uploads/2020/08/0.jpg "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]](https://smith3d.com/wp-content/uploads/2021/05/image-1024x564.png "Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]")
- 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]](https://smith3d.com/wp-content/uploads/2021/05/image-1-1024x560.png "Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]")
- 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]](https://smith3d.com/wp-content/uploads/2021/05/image-5-1024x534.png "Ender 3 v2 bltouch firmware installation guide by smith3d.com [updated –13 november 2022]")
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]](https://smith3d.com/wp-content/uploads/2021/01/zswitchstop.jpg "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]](https://user-images.githubusercontent.com/80574048/111040575-6cdfd280-842b-11eb-971c-446933b9b475.jpeg "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
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/download/32
Hello, can i use this Firmware for Ender 3 Pro with SKR Mini E3 Board with BLTouch too?
this is for Ender 3 V2
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.
we didn’t set any additional #define other than the recommended. you may recompile the source in the git.
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
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 ??
fantastic firmware, clear and speed
just when i stop print, the steppers is not disable, why?
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.
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.
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?
I am wondering the same thing.
Have you found a way to make that work already?
I can’t see anything in the change log has this got the M600 filament change in the firmware
has this also got the M600 Filament Change added
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?
oops I meant to say Ender 3 V2
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 🙂
I see the exact same, very wierd
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 🙂
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.
when random errors, check your wiring or your bltouch maybe faulty.
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”
Hi …
how is the bed leveling realized in that firmware?
Can you perhaps tell ist, or post a video on youtube?
THX Kai
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
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
you did something wrong. either no autohome or messed with the cable
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.
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?
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.
there are chance the bltouch doesn’t retract as expected, therefore error.
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?
your wiring or bltouch is having the issue.
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.
I have the same problem, has the replacement fixed the problem?
I had the same problem that you mentioned and from above: printer homes fine in X and Y but not in Z. During the Z-home cycle, the probe does retract and extend 2-3 times but the axis never lowers the extruder, leaving the probe in space. I tried running the .14 firmware with no luck. My solution was to use a different compiled firmware for the Ender 3 V2 here: https://www.youtube.com/watch?v=km7owhK1kjo&ab_channel=MidnightTech.
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.
you have to change the nozzle to probe offset. use the github repository and compile one yourselves ya
works great! is there an option that will allow use of a filament run out sensor?
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.
Could it be your wire loose? Because you stated it’s working for 10 minutes.
This problem is still there. Could you compile a new version with filament runout sensor, please?
For me happens the same. As soon as I Auto home it freezes. Same happens when starting a print, after heating up.
2.0.x.09 works fine. Just went back on that, but I would like to activate the filament sensor.
Hey Everett,
Did you figure out why it was freezing? I’m compiling my own firmware and ran into the same issue.
Thanks in advance!
Does the color LCD firmware need to be updated as well? I have the V4.2.2 in the Ender 2 V2
not needed. default will do.
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?
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
some old bltouch is having this issue, it can be causes by the bltouch magnetic weaken. try to remagnetize the pin.
Hi …
thank you for the help … but how can i remagnetize the pin?
And why won’t this “error” in Version .9?
CU Kai
hmm, can you flash back to .9 and see if everything is working as expected everytime?
Hi …
Now i have testet the Version .12 (other ones i did not found on my pc) 😉
But also with .12 i got this “error” … here i made a video: https://youtu.be/8Y_yhLZVZvc
CU Kai
On your video, the very last probe, it doesn’t goes all the way in. Your bltouch is faulty.
one of the solution. Wasn’t sure if it’s help.
https://www.youtube.com/watch?v=eDfGZ4bjxiM
Hi ,,,
Now it works again … but i did not remagnetize the pin …
I flashed the .14 Firmware again, but this time with a 8GB SD Card and after that i
new setup the leveling settings … perhaps that helped ?!
Thanks for your help … CU Kai
let me know if it’s happening again, some are facing this issue and sounds like you found the solution (use 8GB SD card)
Hi there …
Some new Information … i tested the .14 and .12 … and after a few prints i got the “error” again.
Also if i reload all settings and also when i recalibrate the bltouch …
First i thought the 8GB SD card was the solution, but i do not think so-.
Now i am back on .9 Firm and after setting all up everything works.
So I’ll stay at .9 first ,,,
Thanks and Greetings Kai
Hi …
I am sorry, but I also get the Error with the V9 Firmware.
This firmware should not have the Error, perhaps you can take a look if there are some differences?!
https://github.com/cosmoderp/Marlin/tree/Ender-3-v2-Advanced-Menu-9_18_20/pre-compiled%20firmwares
CU and thanks a lot for your work … Kai !
it shouldn’t be have any error, because we only added new menus. the marlin version by cosmoderp is newer than V9 but before V12 & V14. Most likely something related to your hardware issue.
The firmware’s is suitable to both versions of pcb 4.2.2 and 4.2.7 ?? thnx …
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!
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?
does restart help? probably hardware or cache. Restore default
I did some searching and the only conclusion I found and tried and worked was the filename size. If the filename is over 20 characters the problem happens. I started shortening the name and has worked great so far.
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
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.
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.