Klipper on the BIQU BX V3

biqu_bx_klipper_v3.md

Klipper on the BIQU BX V3

NOTE: If you have a V2 board/screen(HDMI),click here

First, a few requirements:

1. You need Klipper setup on your Raspberry PI ( borad that support DSI) with your favorite control interface (Octoprint, Fluidd, Mainsail, etc..).
   • I recommend installing official Raspberry Pi OS
     • Download this file https://downloads.raspberrypi.com/raspios_armhf/images/raspios_armhf-2023-05-03/2023-05-03-raspios-bullseye-armhf.img.xz and use the Raspberry Pi Installer and select custom image.
2. Install the Drivers for V3 screen https://github.com/bigtreetech/BIQU-BX/tree/master/Firmware/RPi-Linux-RPi-7inch-DSI
3. You need your favorite Touchscreen UI installed (unless you just want to run headless).
   • Use this to install all you need https://github.com/dw-0/kiauh
     • If you have a issue with the screen is black, press the smal button under the turn knob
4. You MUST have removed the Z endstop physical switch. Not disconnected, but completely removed.

NOTE: CAN will not work on this board due to a hardware mis-configuration
NOTE: I2C is not quite working yet!

Ok, so let's get started.

---

Klipper firmware configuration

When configuring the klipper firmware to run on the BTT SKR SE BX board, there are a couple things to know about.

1. Use the main klipper branch.
2. In order for the toucscreen to work, you will need to set GPIO pins PB5 and PE5 to an initial state during the config
3. Use the config/printer-biqu-bx-2021.cfg file for your intial printer.cfg
4. Once you are setup, you will need to calibrate your sensorless homing: https://www.klipper3d.org/TMC_Drivers.html?h=sensorless+ho#sensorless-homing

A note on connection methods:

There are 4 different connections you can make from the Raspberry Pi to the mainboard, 2 Serial and 2 USB.

• Serial (on UART4 PA0/PA1) <--- For v3 board/screen you need to use this

To use serial connections, you have to enable the serial port on the raspberry pi and compile the correct serial port for the BX mainboard. Once you have the serial port enabled on the raspberry pi, it will show up as /dev/ttyAMAx, with x being the port number.

Once you have it setup, your printer.cfg should then contain the following under the MCU section: serial: /dev/ttyAMAx, substituting the x for your port number.

---

HDMI configuration

As v3 uses DSI you don't need any HDMI settings

Drivers for V3 screen

• Go to and follow the guide https://github.com/bigtreetech/BIQU-BX/tree/master/Firmware/RPi-Linux-RPi-7inch-DSI

Config.txt

Example on /boot/config.txt

Make sure this are in the config.txt file, some wil be added by the drivers installation skript.
[all]
dtparam=i2c_vc=on
dtparam=i2c_arm=on
enable_uart=1
dtoverlay=disable-bt
dtoverlay=vc4-kms-dsi-btt-bxv3-7inch
disable_splash=1

Slicer configuration

For your slicer, you need to call the PRINT_START macro instead of any preliminary gcode. The NOZZLE and BED temps get passed in as arguments. Some examples for the more popular slicers:

• Cura: PRINT_START BED={material_bed_temperature_layer_0} NOZZLE={material_print_temperature_layer_0}
• PrusaSlicer: PRINT_START NOZZLE=[first_layer_temperature] BED=[bed_temperature]
• Ideamaker: PRINT_START NOZZLE={temperature_heatbed} BED={temperature_extruder1}
• Simplify3D: PRINT_START NOZZLE=[extruder0_temperature] BED=[bed0_temperature]
• Kiri:Moto: PRINT_START NOZZLE={temp} BED={bed_temp}

---

Klipper Functionality

Here are some notes on how I have Klipper setup and working quite well for my machine.

Touchscreen Sleep

The Touchscreen will go dark when the printer idle timeout occurs. This happens when there is not a print job in action and currently set for 5 minutes. Pressing the Menu Knob on the display will wake up the Touchscreen.

LEDS

The Neopixels are setup and will cycle through colors on bootup. I have the idle timeout set to shut off the LEDS when the printer is inactive. The LEDs automatically come on when a print is started or when the LCD is wakened.

Homing Routine

I have programmed a reliable homing routine that works well for me, however you can adjust or setup your own to taste. My routine will do the following:

1. Raise the Z axis
2. Home the X axis
3. Home the Y axis
4. Move the probe to the center of the bed (different than the nozzle at center)
5. Home the Z with the probe.

• When starting a print, additionally:

6. After the bed reaches temp, the printer waits for 90 seconds with the probe close to the bed to warm up the probe.
7. Steps 1-5 are repeated with a warm probe
8. Move to the origin to start the print.

This worked really well, thank you so much (funcionou perfeitamente mano, valeu kkkk, vi agora no seu perfil q você é br) Which macros are you using?

Saudações de Santa Catarina!

Here is the macros that my friend @varazir shared with me.

########################################
## MACROS
########################################

# Slicer setup: "print_start NOZZLE=<temp> BED=<temp>
# This macro does a preheat on the probe for better accuracy and needs
# the temps passed in. examples:
# Cura: PRINT_START BED={material_bed_temperature_layer_0} NOZZLE={material_print_temperature_layer_0}
# PrusaSlicer: PRINT_START NOZZLE=[first_layer_temperature] BED=[bed_temperature]
#   Use PRINT_END for the slicer ending script
[gcode_macro PRINT_START]
gcode:
    BED_MESH_PROFILE LOAD="default"
    # SKEW_PROFILE LOAD="default"
    # Turn on screen if it's not on
    SET_PIN PIN=screen VALUE=1
    #Home so that the probe is positioned to heat    
    SET_LED LED=led BLUE=0.94 RED=0.63 GREEN=0.13
    M117 Initial homing sequence.
    G28
    
    SET_LED LED=led BLUE=0.0 RED=1.0 GREEN=0.0
    M117 Getting the heaters up to temp!
    M104 S170                                                          ; Set Extruder temperature, no wait
    M140 S60                                                            ; Set Heat Bed temperature
    M190 S60                                                            ; Wait for Heat Bed temperature
    
    M117 Lets dance!
    G4 S90 
    Z_TILT_ADJUST
    
    M117 Mash it!
    BED_MESH_CALIBRATE
    
    M117 Lats park it!
    Smart_Park
    
    M117 Getting the extruder up to temp
    M140 S{params.BED}      ; Set Heat Bed temperature
    M104 S{params.NOZZLE}    ; Set Extruder temperature
    M109 S{params.NOZZLE}    ; Wait for Extruder temperature
    M190 S{params.BED}    ; Wait for Heat Bed temperature
    
    M117 Purging
    LINE_PURGE
    SET_LED LED=led BLUE=1.0 RED=1.0 GREEN=1.0
    
    M117 Lets make
    
[gcode_macro PRINT_END]
gcode:
    TURN_OFF_HEATERS    ;turn off heaters... 
    SAVE_GCODE_STATE NAME=END_state
    M83                 ;set relative extrusion
    G92 E0              ;reset extrusion amount
    M204 S10000         ;set max acceleration
    G1 E-2 F4000        ;retract 2mm
    M204 S3000          ;set max acceleration

    ;move the toolhead out of the way
    ;if the tool is less than 30mm away from Z Max, move it to Z max, otherwise, move Z up 30mm
    
    ;Obtain the Z axis limit from the [stepper_z] section of the config file and make
    ;  a decision where to move the Z axis based on the current toolhead 
    {% if printer.toolhead.position.z|float + 30 >= printer.configfile.config["stepper_z"]["position_max"]|float %}
    G90                  ;set absolute extrusion
    G1 Z{printer.configfile.config["stepper_z"]["position_max"]|float} F1000 ;Move tool
    {% else %}

    G91                  ;set relative extrusion
    G1 Z30 F1000         ;move Z axis up 30mm
    {% endif %}

    RESTORE_GCODE_STATE NAME=END_state
    G1 X0 Y200 F24000    ;park tool at back of printer
    M107                
    #UNLOAD_FILAMENT     ;this is a good spot to call an unload 
                         ;filament macro, if you are into that sort of thing
    # SET_GCODE_OFFSET Z=0 ;reset whatever babystepping you have done
    M84                  ;disable motors
    CLEAR_PAUSE          ;clear whatever PAUSE state you may have if you have it
    #print a message on your LCD    test
    M117 DONE!!!
    SET_SKEW CLEAR=1

[gcode_macro LOAD_FILAMENT]
gcode:
    {% set speed = params.SPEED|default(300) %}
    {% set max_velocity = printer.configfile.settings['extruder'].max_extrude_only_velocity %}
    SAVE_GCODE_STATE NAME=load_state
    M300 # beep
    G91
    G92 E0
    G1 E25 F{max_velocity} # fast-load
    G1 E15 F{speed} # purge
    M300
    M300
    RESTORE_GCODE_STATE NAME=load_state

[gcode_macro UNLOAD_FILAMENT]
gcode:
    {% set speed = params.SPEED|default(300) %}
    {% set max_velocity = printer.configfile.settings['extruder'].max_extrude_only_velocity %}
    SAVE_GCODE_STATE NAME=unload_state
    G91
    M300 # beep
    G92 E0
    G1 E25 F{speed} # purge
    G1 E-50 F{max_velocity} # fast-unload
    M300
    M300
    RESTORE_GCODE_STATE NAME=unload_state


[gcode_macro _bot_data]
variable_lapse_video_size: 0
variable_lapse_filename: 'None'
variable_lapse_path: 'None'
gcode:
   M118 Setting bot lapse variables

#[pwm_cycle_time BEEPER_pin]
#pin: PA14
   
[gcode_macro M300]
gcode:
    # Use a default 1kHz tone if S is omitted.
    {% set S = params.S|default(1000)|int %}
    # Use a 10ms duration is P is omitted.
    {% set P = params.P|default(100)|int %}
    SET_PIN PIN=beeper VALUE=0.5 CYCLE_TIME={ 1.0/S if S > 0 else 1 }
    G4 P{P}
    SET_PIN PIN=beeper VALUE=0

Thank you, I was looking for some filament loading and unloading macros

Thanks for help out, I haven't used my BX for almost a year now. I bought a Bambulab A1 and both my Wanhao and BX printer started to collect dust so I moved them to the attic storage.

Thanks for help out, I haven't used my BX for almost a year now. I bought a Bambulab A1 and both my Wanhao and BX printer started to collect dust so I moved them to the attic storage.

Kind of sad to see those machines sitting idle, especially knowing what the BX is capable of! But I totally get it, the Bambulab A1 really makes everything so much easier. I still keep my old printers up and running; each one has its strengths and is useful for certain types of prints. Who knows, maybe one day the urge will come back to fire up the old veterans and get them running again.