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]

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

* 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

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

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.

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

  1. Christophe says:

    Hi,
    just thank you for your firmware,
    i’m wondering, can you add the ability to read the whole file name in the print session, like this one : “https://www.lesimprimantes3d.fr/forum/applications/core/interface/file/attachment.php?id=111389” ? it would be awesome 🙂

  2. Bharat Pareek says:

    Hi

    I have noticed that auto bed levelling is not being done correctly. At one end of board it starts from the edge, where as on the opposite one there is a lot of space left like around 2 inches.

  3. Branden DiBiase says:

    Anyway you can send me the non complied files? I am looking to add a bl touch with a bondtech ddx extruder and need to change a couple of things. I would greatly appreciate any help!

  4. Jim says:

    Is there an easy way to increase the max hotend temperature? I love this firmware but want to print Nylon at 280C and 260 seems to be the max.

  5. dribblestick dribblestick says:

    @patrick. I am also on ender 3 v2 with a 4.2.2 board The bl touch connector is a single plug, not a split plug as I am guessing earlier bl touches were.. I couldnt access creality to get the bltouch installed so installed from elsewhere. But to confirm something you asked. The Z switch is definitely disconnected on mine as per whatever it was that I read that said to disconnect it. I did have a couple of occasions before switching to the alpha build where the printer drove the nozzle into the bed hard so I set the mechanical block to prevent any further reoccurences, but the z switch is very disconnected on my setup and things are working as expected.

  6. Andrew says:

    Installed the firmware for a 4.2.2 board on Ender 3 V2, which worked fine for several days. All of a sudden, the nozzle crashed into the bed when Auto Homing, as the probe did not deploy. Any ideas? The wiring is not loose, I thoroughly checked. Reinstalled firmware, no luck. The probe refuses to deploy on Auto Home. So strange. Thanks! Andrew

      • Andrew says:

        Are you sure? It’s brand new. I did about 3 full prints and then it stopped working. It self tests okay on startup, it’s just the auto home or Z level functions. Thank you!

        • Smith3D says:

          if it doesn’t extend you bltouch pin at the beginning, check the 3 pin cable wiring
          if it failed during leveling, chances are 2 pin cable wiring issue.
          if both solution above doesn’t solve, change the bltouch pin.

  7. dribblestick dribblestick says:

    I absolutely love this firmware. From the awesome white lines around options boxes ( I cant say how many times I had hit bed level again by accident without that little tweak) to its general all round goodness in fixing so many issue I was having with my printer. I switched to the alpha build as I couldnt get a consistent print using the other on my 422 board ender 3 v2. although it seemed to do a full bed level fine and the bed was already level manually, it just seemed to be getting into tighter tolerances as soon as it went right of centre. Alpha seems to have sorted it. I did have one occasion with the alpha that had the printer set off and try to print before the nozzle and bed were up to temp. but thats only happened once in around 10 or fiftenn prints so definitely a glitch moment rather than a regular thing. I just wanted to say thanks for the fw. appreciated.

  8. Patrick Dorion says:

    I’m having a real hard time with my BL Touch… I was hoping maybe you could help…

    I have a Ender 3 v2 with a 4.2.2 board, and a Creality BL Touch from their website.

    When I installed the BL Touch, I just had to run the wire to the header in the motherboard, I had the metal piece, screws, and tie-wraps in the pack, too. Then I watched a video, and it suggested unplugging the Z limit switch, which I’m not sure about, because I haven’t see that anywhere else. I try with/without, and so a definitive answer would help me save a troubleshooting step…

    I started with the newest firmware from Creality for my machine, and board, and In the leaflet I got with the package, it says there’s a Z-Offset menu, which I couldn’t find, but the screenshots are from an original Ender 3 screen, not an Ender 3 V2 interface, so there’s no Z-Offset menu to help me set the offset.

    The video I watched was doing it manually, but I can’t move my Z into the negative, and changing the Z offset didn’t seem to affect the homing at all. This is the video: https://www.youtube.com/watch?v=r_mboxnkXfI

    The fact I have a 4.2.2 board is from the PCB silkscreen, at this point I’m wondering if it’s not a 4.2.7, but your firmware doesn’t distinguish…

    Anyhoo, after installing your firmware, first, on boot, the needle doesn’t bounce up and down like it did on the Creality firmware, second, it doesn’t home Z. It does the limit switches, but and it goes up a bit not to crash the bed, but keeps going up, and never goes down. Bed levelling doesn’t work, I’ve never seen the needle extend with your firmware.

    So I don’t know what’s going on… I can’t print anything at this point because I can’t set the Z offset in any way, and your firmware doesn’t extend the needle on my BL Touch at all, it didn’t happen once, it doesn’t go into probe mode for some reason…

    Is there anything you can recommend? I really like your firmware, and its additions, btw.

    Before installing your firmware, I formatted the SD card, everything…

    I’m starting to be depressed because 3D printing is a lot harder than I thought it was going to be, and this was going to hopefully help me get better prints, and better adhesion, and less of the nozzle removing prints off the surface, but right now I can’t get it to work.

    Closest I got was with the Creality firmware, but I can’t set the Z offset like he does in the video, it won’t allow me to move it, and setting even a negative Z offset that would crash the head in the bed doesn’t do anything with it… Like I could’ve fiddled and got it, but Z offset doesn’t even work…

    Could you walk me briefly, but point by point, everything I should’ve done, in what order? If it works, I’ll be happy to give you a donation for your time… I’d just like to get it working, so I can start printing again…

    Thanks,

    • Smith3D says:

      if it doesn’t extend you bltouch pin at the beginning, check the 3 pin cable wiring
      if it failed during leveling, chances are 2 pin cable wiring issue.
      if both issue above doesn’t solve, change the bltouch pin.

    • dribblestick dribblestick says:

      I dont know how i missed the reply option. would have saved the separate post down the page. anyway. same printer, also with bl touch (v3?). z switch is 100 percent disconnected and printer working fine. I still have the physical z block set to keep from any potential errant issues of the nozzle hitting the bed if the BL decides to throw a whappy.

    • lukeman says:

      @Patrick I have the exact same issue (got the E3v2 kit with no adapter board) and have gone through the exact process you have. I first tried the Creality firmware (seems to work but the trigger doesn’t seem to stop the Z-axis), then the smith3d (sameish: sort of works but doesn’t). I shelved the project for a week or two and went back to mesh leveling, but was revisiting it this evening to see if my sensor is defective and I need to find a new one or if something else could be going on.

      My current theory (based on the above wiring details, which I’ve had trouble finding anywhere else) is that it is indeed a wiring issue with the last two pins. Every other wire correlates to the same spot on the sensor, but the 5-pin cable sent in the kit has the final two pins (white and black) reversed. I’d like to hear from someone who has it working with a 5-pin connector to confirm, but it seems like with the 5-pin cable the wire order should to be consistent on both ends. I’m hoping to rewire my cable soon. If it works for me (or fries something on my board) I’ll let you know.

      • lukeman says:

        ^ Can’t edit but just realized the wires that swap on my cable are actually blue and red (pins 4 and 5 on both sides).

    • lukeman says:

      ^ Update: after de-pinning the last two wires on the JST connector and switching the order my BLTouch is now working! I’m on the Creality BLTouch release just to confirm things were working with a more “stock” implementation, but I’ll be moving to a nicer firmware soon.

      It’s a bit tricky to get the pins out, but after struggling for quite a while I set up my phone on a stand and used it to magnify to connector and it was much easier to see when I had the tweezers in the right spot and when I didn’t.

  9. evothiele says:

    how do I adjust the probe offset. the probe is off the left side of the bed when I try to run the leveling sequence.

  10. Jason says:

    Thanks for the rewiring Zswitch option! This was the only thing that fixed my random probe errors and random crashes into the bed, I replaced with a brand new BL Touch, and tried a different wiring harness and it still occured, so I had to resort to the rewiring option. Is this rewiring needed because of something wrong on the ender3v2 main board?

  11. Alberto says:

    What is the wiring difference between your solution and the BL Touch instructions?
    They say to connect the red plug to the Z axis connector and the 3 wires plug to then small board that fits the LCD connector.

  12. Robert Kight says:

    I’m running the alpha firmware at the moment (2.0.X.17) and it’s working great, overall! The only issue I’ve run into is one that also happened on 2.0.X.16. When using the “refuel” option, clicking on extrude sometimes causes the printer to retract, instead. Imagine the annoyance when you’re trying to purge after a material change, so you set it to 50 or 60 mm, hit extrude, and your filament starts backing out with no way to cancel.

  13. Matt says:

    (E3v2, bltouch 3.1, bracket from jk thingiverse, latest smith3d firmware)
    When probing, it starts just about 5mm away from 0,0.. but when it gets to the other side of the bed, it’s 20-30mm away. It is almost as if it thinks the bed is smaller than it is. Is this normal?

  14. Gökhan Selen says:

    Ender 3 v2 Var with bltouch
    I have a filament sensor, I also want to install my
    My motherboard 4.2.7 What software do I need to install

  15. Gökhan Selen says:

    Ender3 v2 Var bltouch v
    var filament sensör de takmak istiyorum
    Anakartım 4.2.7
    Hangi yazılımı yüklemem gerek

  16. Juan Calvo says:

    Hello,

    I was wondering if you would mind to publish the configuration files that you use to publish your firmware.

    I’m in a bit of a complicated situation, I need use a ZSwitch firmware but I’d like to enable filament sensor. I tried to compile it using your firmware but using Marlin’s configuration for your branch. Unfortunately some of the menu options were missing and the firmware in general was behaving rather badly.

    I’d like to be able to compile ZSwitch version of your firmware but with filament sensor enabled.

    Thank you very much for your work, it’s sincerely amazing.

    Juan

  17. Automata Pro says:

    Very nicely done!!! I would like to ask if there is a version that adds the BTT Smart Filament Sensor along with the BLT. Thanks!!!!! 🙂

  18. Manuj Singh says:

    Hello Team this is my 3rd time requesting I know you guys are busy but help me with the fix!!
    I have ender3v2 (4.2.2 Board ) – Normal Switch Filament sensor and Generic BLtouch
    JAN 15th 2021 I downloaded >>> Smith3D-E3V2-2.0.x.16-5×5-Fast-filamentsrunout-221220.bin for ender 3v2 which has For 4.2.2 Board (link is https://github.com/smith3d/Marlin/releases/download/2.0.x.16/Smith3D-E3V2-2.0.x.16-5×5-Fast-filamentsrunout-221220.bin)
    What I tested
    The filament sensor is perfectly working
    BL touch is working fine with Offset
    What is not working or tested at that time
    – Resume function after a power outage
    FYI I was printing lithophanes which take hours to complete. 2 incidents happened the printer did not resume the print NO error was displayed or msg to resume.
    So I reflashed with Creality firmware checked resume function works fine But not on your firmware ( is there a bug?)

    You replied “it should resume unless your SD card is power resume file is corrupted” I understand if it corrupted what are the steps to fix it.. please reply

    Thanks

  19. Eric Marshall says:

    I had an issue with the BL Touch failing during levelling (red flashing). After checking the wiring and connections, the issue would not go away. I removed the BL Touch and turned the socket head screw in the top DOWN by 1/4 turn. The levelling sequence now operates reliably!

    • Bharat Pareek says:

      Hi even I am getting random probe failures with a 3DTouch 3.0

      Which socket screw are you talking about here? Please guide,

  20. MrBenDavid says:

    Hello! If I want to use Octoprint with BLTouch, should I use one of the releases on GitHub? I’m Ender 3 v2 4.2.2. Thanks for the help!

  21. Αντώνης Λινάκης says:

    Is it possible to use tramming wizard with the ender 3 v2 screen?
    If possible could you add it to next compile version?
    Thanks.

  22. Manuj Singh says:

    Thank you for your reply .. Please tell me How to fix this “unless your SD card is power resume file is corrupted” How can I fix the resume file on SD card?
    Please share the link and the steps.

    Thank you
    Regards
    Manuj

  23. ctlcad says:

    Hi
    I am new to 3d printing so this might be an bit of a noob question – if so my apologies in advance.
    I am about to install a bltouch to my E3V2 as my first significant upgrade and plan to download V2.0.X.16 from the page above.
    However I would also like to start using the Arc Welder plugin, I believe the stock firmware has G2 & G3 arc recognition disabled so can you advise if firmware V2.0.X.16 has G2 & G3 code enabled?
    Thanks
    CTL

  24. appsmyth says:

    I’ve compiled and using Alpha Build (V2.0.X.17) quite successfully. For your info note that in Control Menu “Storage configuration” is not displayed properly (printed like “..orage configuration”) . Furthermore in status bar, fan indication display 0 when fan is on.
    It will be great to have this fixed in a newer version, as well as more menu useful options.
    Thank you in advance!

  25. Nathan says:

    Hi,
    Alpha is not yet available in filament sensor ? I have a filament end sensor from hotends.fr. I would like to use the alpha to solve communication problems with my bltouch and octoprint.
    Thank you in advance,
    Nathan

  26. mlabovich says:

    I just installed the BL Touch and the firmware for the Ender 3 v2. I followed the suggestion on your site and went to Aux Leveling at the prepare section. Aux Leveling almost looks greyed our but when I select it, the screen says Homing and the probe touches down in the middle 2 times before pulling up. I then tried to level the bed and when I try and select any of the options (bottom left) nothing happens.

    Any suggestions of how I can level the bed? Do I need to reset something?

    Thanks in advance.

    • Sim says:

      Exact same thing happening on my ender 3v2. My probe just sits about 10 inches up and is unresponveisve to anything. I re-flashed which seemed to fix it – did 1 print which worked fine and then back to the same as before. I’ve relfashed and still didn’t fix it.

  27. Douglas D says:

    Using Marlin Firmware V2.0.X.16 – Smith3D on ender 3 V2. Works great printing from SD card but getting the probe errors when using Octoprint. It’s the plug and play kit and don’t really want to look at doing any re-wiring. Any workarounds that may allow me to use Octoprint with it.

      • tfaz099 says:

        Hello,
        Im trying to figure out where on your website i can ask a question.
        I want to use a Micro Swiss Direct Drive Extruder kit and need to put this code in as per the Micro Swiss instructions: (can someone please help with how i would do this? — i can compile etc but if you have a version that would be great; otherwise do you have a full source i can compile on my own in one download?)
        Thank you

        “We will need to modify two lines of the code in Configuration.h tab.
        • Open Configuration.h tab and find these lines:
        #define X_MIN_POS
        #define Y_MIN_POS
        • Add negative offsets amount to each line:
        #define X_MIN_POS -5
        #define Y_MIN_POS -10
        • Flash the firmware
        • Offsets amount might need to be slightly tweaked for different printers”

    • Danny says:

      I have the same issue now. Sometimes works properly but this takes reeeeaaaaly so much time (just trying and trying not only with octoprint but without too probe just freezing)

    • Atomique13 says:

      I recently flashed V2.0.X.16 on my Ender 3 V2 and I couldn’t print from Octoprint because I got probe errors, I had an old version of Octoprint. Now I am using Octoprint 1.5.3 and OctoPi 0.18.0 and it works like a charm. Also try to adjust BLTouch magnetic screw, the middle one, I set it flush with the BLTouch’s body.

Leave a Reply

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