Flashing the BSC
Support
For problems or questions, contact the community support channels.
Flashing Guide: LILYGO T-CONNECT¶
For initial setup, the firmware must be flashed manually to the LILYGO T-CONNECT board. Standard firmware is available from GitHub Releases.
Step 1: Download the Firmware¶
Download firmware_tconnect_full_xx_xx.bin. Here, xx_xx is the required language, for example de_DE or en_US.
Important
Use only the file whose name includes full.
Step 2: Prepare the Board¶
Connect the T-CONNECT board to your computer via USB. To enter download mode:
- Hold down BOOT.
- Briefly press RESET.
- Release BOOT.
The board is now in flashing mode.
Step 3a: Espressif Flash Download Tool (Windows Only)¶
Download the official ESP Flash Download Tool.
- Start the tool and select ESP32-S3 as the target device.

- Enter the firmware files and configure the settings as shown.

- Check that the correct COM port is selected, the checkboxes are checked and the rows are highlighted in green.
Click START to begin flashing.
Step 3b: esptool.py (Linux and Windows)¶
Alternatively, flash with the Python tool esptool.py. Example command, including flash erasure:
esptool.py --chip esp32s3 --port /dev/ttyUSB0 --baud 921600 write_flash -e 0x0 firmware_tconnect_full_xx_xx.bin
File Location
Make sure the .bin file is in the current working directory.
Step 4: Restart the Board¶
After flashing successfully, briefly press RESET once. The board loads the new firmware and starts normally. You can then connect to the BSC and configure it.
Flashing Guide: Original BSC Supplied by LILYGO¶
The current PCB supplier ships boards with special firmware that must be upgraded to the current release. Download and extract bsc_firmware.zip from Releases. The extracted firmware.bin is the firmware to upload.
- At first startup, this supplier firmware provides a Wi-Fi access point named
ESP-*without a Wi-Fi passphrase. Connect to it. - Open
http://192.168.4.1/update, entering the URL exactly. If a smartphone cannot open the address, disable mobile data for this procedure. - Upload the extracted
firmware.bin. No other files, such as a filesystem image, are required. - Wait a few seconds for the device to restart.
- If successful, an LED on the board flashes. You can now connect to the BSC to configure it.
Flashing Guide: Unprogrammed Original BSC¶
For initial setup of an unprogrammed board, manually flash all four files available in the current release.
On original BSC hardware, connect a USB-to-serial converter with 3.3 V logic levels to the three-pin J2 header at the upper left of the board, labelled Prog. A 5 V converter can damage the controller. ESP32 development boards usually have a USB port. Subsequent updates can be installed through the web interface.
- Before flashing, disconnect power, fit jumper J4 and reconnect power to enter download mode. Remove J4 after successful flashing so the board starts normally.
- PCB version >= V2.3: J6 must not be fitted during flashing, but must be refitted afterwards.
- You can use 921600 baud. If this causes problems, reduce it to 230400 baud.
- Erase the module's existing flash memory before programming with the tools below.
Flashing Options¶
Manufacturer's Download Tool (Windows Only)¶
Download the ESP32 manufacturer's Flash Download Tools from Espressif. Apply the settings shown below:

Enter the firmware files on the next screen and apply the settings. Check the box next to every file and make sure each row is highlighted in green.

Click Start to begin uploading.
esptool (Linux and Windows), Including Erasure¶
esptool.py --port /dev/ttyUSB0 --chip auto write_flash -e -ff 80m -fm dio 0x01000 bootloader.bin 0x08000 partitions.bin 0x0e000 boot_app0.bin 0x10000 firmware.bin
Flashing in a Browser¶
In Chrome, you can use the Adafruit online tool. After connecting to the controller, flash the four release files at these addresses:
bootloader.bin:0x1000partitions.bin:0x8000boot_app0.bin:0xe000firmware.bin:0x10000
Flashing Test Versions¶
- Flash the individual test
firmware.binthrough the BSC web frontend's OTA function under Settings / Update. - Alternatively, flash that
firmware.bintogether with the other three release files using the full procedure above.
Connecting to the BSC¶
The board must already be programmed.
- On first startup, BSC firmware provides an access point named
bsc_*. - Once connected, open
192.168.4.1orbsc.infoto configure the device. - Username:
bsc - Password:
admin