BLLEDController Guide

This guide has been supervised

For the rev 2 firmware and guide for the esp8266 and esp32 versions of the blledcontroller head over here:

BL Led Controller

What is a BL Led Controller

The BL Led Controller is an accessory designed to provide additional lighting for Bambulab X1 and X1C 3D printers. Users can customize it by flashing their own firmware, which gives them complete control over the LED strip’s lighting behavior. The firmware is open-sourced, allowing users to modify and create their own lighting patterns and behaviors. The BL Led Controller is capable of communicating directly with the printer, ensuring that the LED strip’s lighting is always in sync with the printer’s status. Overall, it is a valuable accessory that enhances the printing experience and provides increased flexibility for users. 

We’ve created a guide that will help you set up your BL LED Controller quickly and easily. Whether you’re new to this technology or an experienced user, we’re confident that our step-by-step instructions will make the process a breeze.

If you’re interested in purchasing the Bambulab LED Controller, you can find it on Etsy.

In case you’ve previously installed custom firmware on your device and want to revert it to the original firmware, we’ve also included a flashing section to guide you through the process.

Additionally, if you’re curious about the specific power adapter and LED strip we use, you can find links to them below:
Ledstrip: AliExpress RGBCCT 12MM PCB 24V
Power Supply: AliExpress 24V 1A Power Adapter

Alternatively if you live near the Action store francise you can purchase this instead outsourcing your parts from aliexpress:

If you want to make your own case, here you can find the 3d model:

Github source:
Join our Discord:

Getting started

Before you get too excited and wire everything up, let’s take a step back and Read the note section down below and then lets configure the device first.

  1. Remove the board from its enclosure by using a flathead screwdriver to remove the back cover. Pull up one of the corners to do this.

  2. Connect a micro-USB cable to both your computer and the device. If you don’t already have it installed, make sure to install the CH340 drivers, which are mentioned in the flashing section.

[Note]: Ensure that the board isn’t receiving 24V when you plug it into your computer.

3. Take out your phone and navigate to the Wi-Fi settings. You should see a new network called “Bambulab LED Controller” popping up. This might take a couple of minutes to start up. Once you see it, connect to this network.

4. After you have successfully connected to the “Bambulab LED Controller” network, a page will open up on your phone allowing you to set up your Wi-Fi details. Click on “Configure Wi-Fi” to begin.

5. When you click on “Configure Wi-Fi,” it will open another page where you can configure your Wi-Fi settings. You can either select the SSID name from the top or manually type it in the SSID input box. After entering the SSID and password, click on “Save” to save your settings.

6. Once you have entered the details correctly, the “Bambulab LED Controller” network should no longer be visible. To access the device’s IP address, navigate to the flashing section of the page, click on “Connect,” select the appropriate port, and then click on “Logs & Console.” Once the page has loaded, press the reset button on the device and wait for the IP address, username, and password to appear.

7.Once you have obtained the IP address, open your web browser and enter the IP address in the address bar. You will be directed to a webpage where you’ll need to enter your username and password from Step 6. Once you’ve logged in, fill in your device’s IP address, access code, and serial number in their respective fields.

To find your IP address and access code, click on the cogwheel on the left side of the page, and then select “Network.” Your serial number can be found by clicking on the cogwheel on the left side, then selecting “General,” and then “Device.”

After entering the necessary information, click on “Save” to save your settings.

8. That’s it! You have successfully configured the Bambulab LED Controller, and it is now ready to be connected to your chosen LED strip and a 24V power adapter.


First of all, you need a serial driver to connect the bl led controller to your computer.
The devices uses a CH340 chip, that can be downloaded here.
Please check the licence before flashing.

  1. Make sure you’ve the right driver installed.
  2. Connect the device to the computer via a microusb cable.
  3. Open this page via Chrome or Edge browser and click on the connect button below