Adding Wireless Buttons

Important Notice

• The wireless button requires installation of a battery; the battery model is CR927.

• Return to the homepage and click the + inside the red box as shown in the image.
  Loading...
• Once the interface below appears, press the wireless button with the installed battery normally.
• The wireless button's ID will be automatically generated in the red box; this ID is unique.
  Loading...
• Enter the desired name for the button in the red box.
  Loading...
• Click the first red box, and the second blue box will appear.
  Loading...

Important Notes

• Custom GCODE and Request API are controlled via wireless connection.
• Triggering GPIO is controlled via wired connection.

Custom GCODE

• For custom GCODE, you can enter the code or macro name you need to execute in the red box; AirClick will automatically send it to the printer for execution.
  Loading...

Request API

• Klipper API Settings
• RRF API Settings
• BambuLab API Settings

1. Predefined APIs can implement custom macros, emergency stop, Klipper restart, firmware restart, system shutdown, etc.

Loading...

2. Custom API Instructions
   • Refer to the Moonraker API documentation for all APIs.
   • The method must match the method in the Moonraker API.
   • The params must match the params in the Moonraker API.
3. Below is an example using the API to start printing a specified file.
   • The image below is an example from the Moonraker official documentation.
   Loading...
   • The image below shows how to fill in the API in AirClick.
   Loading...
4. Save this button to enable starting the print of a specified file.

1. Custom API Instructions
   • Refer to the RepRapFirmware HTTP API documentation for all APIs.
   • Only GET request interfaces are supported.
   • The method must match the uri in the RRF HTTP API.
   • The params must match the url query in the RRF HTTP API.
2. Below is an example using the API to delete a specified file or folder.
   • The image below is an example from the RRF official documentation.
   Loading...
   • The image below shows how to fill in the API in AirClick.
   Loading...
   • The params here need to rewrite the URL parameters into JSON format, e.g., /?aaaa=bbb&cccc=ddd.
   • After modification, it becomes:

     {
         "aaaa": "bbb",
         "cccc": "ddd"
     }

3. Save this button to enable deleting the specified file or folder.

1. Predefined APIs can implement pause printing, cancel printing, LED control, etc.

Loading...

• For LED control, it is recommended to use the automatic switch mode. In this mode, the LED status will be automatically detected and switched, enabling one-click on or off.

2. Custom API Instructions
   • Please refer to the relevant Github Open BambuAPI documentation for BambuLab APIs.
3. Below is an example using the API to set printing speed.
   • The complete parameters sent via BambuLab LAN MQTT are as follows:

     {
         "print": {
             "sequence_id": "0",
             "command": "print_speed",
             "param": "2" // Print speed level as a string
                          // 1 = silent
                          // 2 = standard
                          // 3 = sport
                          // 4 = ludicrous
         }
     }

   • The image below shows how to fill in the API in AirClick.
   Loading...
4. Save this button to enable setting the printing speed.

Triggering GPIO (Klipper Only)

• Triggering GPIO requires the STM32F072 to be connected to Klipper.

• For firmware flashing and connection, please refer to this document Firmware Flashing and Connection.

• The available IOs are from PB0 to PB9, totaling ten IOs. After properly flashing the firmware and connecting to Klipper, you only need to configure it correctly. Below is a reference configuration.

  [mcu AirClick]
  serial: /dev/serial/by-id/usb-Klipper_stm32f072xb_AirClick-if00
  ### Search for the USB ID and modify this line accordingly
  
  [gcode_button _test]
  pin: ^!AirClick:PB0
  press_gcode:
      M118 PB0
  
  [gcode_button _test1]
  pin: ^!AirClick:PB1
  press_gcode:
      M118 PB1
  
  [gcode_button _test2]
  pin: ^!AirClick:PB2
  press_gcode:
      M118 PB2
  
  [gcode_button _test3]
  pin: ^!AirClick:PB3
  press_gcode:
      M118 PB3
  
  [gcode_button _test4]
  pin: ^!AirClick:PB4
  press_gcode:
      M118 PB4
  
  [gcode_button _test5]
  pin: ^!AirClick:PB5
  press_gcode:
      M118 PB5
  
  [gcode_button _test6]
  pin: ^!AirClick:PB6
  press_gcode:
      M118 PB6
  
  [gcode_button _test7]
  pin: ^!AirClick:PB7
  press_gcode:
      M118 PB7
  
  [gcode_button _test8]
  pin: ^!AirClick:PB8
  press_gcode:
      M118 PB8
  
  [gcode_button _test9]
  pin: ^!AirClick:PB9
  press_gcode:
      M118 PB9