Skip to content

Commit 711d79b

Browse files
committed
Add table for different ESP32 bootloaders
1 parent 7caa8b4 commit 711d79b

1 file changed

Lines changed: 9 additions & 24 deletions

File tree

docs/basics/install-binary.md

Lines changed: 9 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -33,11 +33,17 @@ esptool.py write-flash 0x0 ./WLED_XXX.bin
3333

3434
#### ESP32
3535

36-
Firstly, flash the version 4 bootloader file, which you can find [here](https://github.com/Aircoookie/WLED/releases/download/v0.13.1/esp32_bootloader_v4.bin).
37-
This step only has to be done once, to update afterwards the bootloader does not have to be re-installed.
36+
Unlike the ESP8266, the ESP32 requires a bootloader to be installed before WLED can be flashed. The exact bootloader depends on the specific ESP32 variant being used. Below you will find a list of bootloader links for the supported ESP32 models.
37+
38+
| Model | Bootloader |
39+
|---|---|
40+
ESP32 | [Bootloader Version 4](https://github.com/Aircoookie/WLED/releases/download/v0.13.1/esp32_bootloader_v4.bin)
41+
ESP32-C3 | [Bootloader Version 2](https://github.com/wled/WLED-WebInstaller/raw/refs/heads/master/bin/Release/release_0_15_3/esp32-c3_bootloader_v2.bin)
42+
ESP32-S2 | [Bootloader S2](https://github.com/wled/WLED-WebInstaller/raw/refs/heads/master/bin/Release/release_0_15_3/bootloader_s2.bin)
43+
ESP32-S3 | [Booloader S3](https://github.com/wled/WLED-WebInstaller/raw/refs/heads/master/bin/Release/release_0_15_3/bootloader_s3.bin)
3844

3945
```bash
40-
esptool.py write-flash 0x0 ./esp32_bootloader_v4.bin
46+
esptool.py write-flash 0x0 ./esp32_bootloader_xx.bin
4147
```
4248

4349
Now you can flash the actual firmware binary. Keep in mind the bootloader needs to have a flash offset of 0, but the firmware 0x10000.
@@ -56,27 +62,6 @@ esptool.py erase-flash
5662

5763
If you have a MagicHome controller, here is a [good video tutorial](https://www.youtube.com/watch?v=qgBAU39v07k) on how to flash it.
5864

59-
#### ESP32-C3
60-
61-
Firstly, flash the version 2 bootloader file, which you can find [here](https://github.com/wled/WLED-WebInstaller/raw/refs/heads/master/bin/Release/release_0_15_3/esp32-c3_bootloader_v2.bin).
62-
This step only has to be done once, to update afterwards the bootloader does not have to be re-installed.
63-
64-
```bash
65-
esptool.py write-flash 0x0 ./esp32-c3_bootloader_v2.bin
66-
```
67-
68-
Now you can flash the actual firmware binary. Keep in mind the bootloader needs to have a flash offset of 0, but the firmware 0x10000.
69-
70-
```bash
71-
esptool.py write-flash 0x10000 ./WLED_XXX.bin
72-
```
73-
74-
- If you experience issues, run this command before trying `write-flash` again (Note: this will erase all settings stored on the ESP!)
75-
76-
```bash
77-
esptool.py erase-flash
78-
```
79-
8065

8166
### ESP8266 Flashing method 3: [ESP Home Flasher](https://github.com/esphome/esphome-flasher/releases) tool
8267

0 commit comments

Comments
 (0)