romasku · sakowicz · Mar 1, 2026 · Mar 1, 2026 · Mar 1, 2026 · Apr 5, 2026
diff --git a/docs/.images/raspberry_pi_gpio_pinout.png b/docs/.images/raspberry_pi_gpio_pinout.png
diff --git a/docs/flashing/README.md b/docs/flashing/README.md
@@ -0,0 +1,11 @@
+# Flashing Guides
+
+Instructions for flashing custom firmware onto Zigbee modules.
+
+## By Chip Type
+
+| Chip Family | Guide |
+|-------------|-------|
+| Silicon Labs (EFR32MG21) | [SiLabs Flashing](silabs.md) |
+| Telink (TLSR8258) | [Telink Flashing](telink.md) |
+| ZBMINIL2 | [ZBMINIL2 Flashing](zbminil2.md) |
diff --git a/docs/flashing/silabs.md b/docs/flashing/silabs.md
@@ -1,93 +1,17 @@
-# How to Flash via Wire
+# Silicon Labs (EFR32MG21) Flashing
 
-### What You'll Need
+Guides for flashing custom firmware onto Silicon Labs EFR32MG21 chips (Tuya ZS3L module).
 
-- A J-Link programmer (JLink v9 confirmed to work)
-- A soldering iron
-- Some spare jumper wires
+## Flashing Methods
 
-### Step 1: Disassemble the Device
+| Method | Hardware Required |
+|--------|-------------------|
+| [J-Link v9](silabs_jlink_v9.md) | J-Link programmer |
+| [Raspberry Pi GPIO](silabs_raspberry_pi.md) | Raspberry Pi 3B+ |
 
-Unplug the device from the mains. **Never attempt to disassemble it while it is plugged in!**
+## ZS3L Module
 
-In general, you need to disassemble devices until you have access to the ZS3L module or MCU itself. Here is a detailed example guide for the Moes 4 Gang switch.
+- Chip: EFR32MG21A020
+- Flash: 768 KiB
+- Pinout: [Tuya ZS3L Documentation](https://developer.tuya.com/en/docs/iot/zs3l?id=K97r37j19f496)
 
-First, pop the front glass panel:
-
-![Front glass disassembly](/docs/.images/moes_4_gang_disassemble_front.jpg)
-
-Then gently detach the PCB from the device. Alternate the sides you use for leverage to avoid damage to the connector.
-
-![PCB disassembly](/docs/.images/moes_4_gang_disassemble_pcb.jpg)
-
-### Step 2: Solder the Wires
-
-You'll need to solder five wires as shown in the photos: GND, 3.3V, SWDIO, SWCLK, RST.
-
-If you have a ZS3L module, you can use the following [Tuya docs](https://developer.tuya.com/en/docs/iot/zs3l?id=K97r37j19f496) for reference. Or just follow this schema:
-
-![PCB connections](/docs/.images/meos_4_gang_pcb.jpg)
-
-For Moes 4 gang, we can re-use the connector to plug in power:
-
-![PCB power](/docs/.images/moes_4_gang_pcb_power.jpg)
-
-But you have to solder to the other pins. There is no need for a long-term connection, but be sure not to bridge the pins together.
-
-![PCB power](/docs/.images/moes_4_gang_pcb_wires.jpg)
-
-Finally, attach the wires to your J-Link programmer (for JLINK V9, the connection should look like this, following the color schema used above):
-
-![PCB power](/docs/.images/jlink_wires.jpg)
-
-### Step 3: Flash the Firmware
-
-Download both the bootloader and firmware for your device from [bin/](https://github.com/romasku/tuya-zigbee-switch/raw/refs/heads/main/bin). You'll need the generic `efr32mg21_bootloader.s37` and the `.s37` file specific for your device.
-
-#### Using Commander Software
-
-There are different software options that you can use for flashing, but one of the easiest options is to use Simplicity Commander from Silicon Labs. Download Commander from [this page](https://www.silabs.com/software-and-tools/simplicity-studio/simplicity-commander?tab=getting-started).
-
-Plug the J-Link into your PC, then open Commander and select your flasher. It may be named as some random set of numbers, that's ok.
-
-![commander select device](/docs/.images/commander_select_kit.png)
-
-**Check the connection:**
-
-Open the device info page to verify that the connection is good:
-
-![commander device info](/docs/.images/commander_device_info.png)
-
-If this doesn't work, you can try constantly tapping on the device touch button. This is because the device can be in deep sleep and the flasher cannot communicate with it. If this is your case, keep tapping until you erase the chip.
-
-**Erase the chip:**
-
-Open the flash tab and erase the chip. **THIS WILL DELETE STOCK FIRMWARE!** If you want to keep it, press "Open shell" below and use this command to backup the stock firmware:
-
-```
-commander readmem --device EFR32MG21 --region @mainflash --outfile stock_dump.bin
-```
-
-![commander erase](/docs/.images/commander_erase.png)
-
-**Flash the bootloader and firmware:**
-
-Now you'll need to flash both the bootloader and firmware separately.
-
-1. Press "Browse":
-
-   ![commander ](/docs/.images/commander_browse.png)
-
-2. Select the bootloader file (`efr32mg21_bootloader.s37`):
-
-   ![commander ](/docs/.images/commander_select_bootloader.png)
-
-3. Press "Flash" and wait until the process finishes:
-
-   ![commander ](/docs/.images/commander_flash.png)
-
-4. Now select your device-specific firmware file and press "Flash" again. Wait until the process finishes:
-
-   ![commander ](/docs/.images/commander_select_firmware.png)
-
-If done correctly, the onboard LED will start flashing automatically. You can try joining the device to a Zigbee network to verify that it connects properly. Once confirmed, disconnect everything, unsolder the wires, and reassemble the case.
diff --git a/docs/flashing/silabs_jlink_v9.md b/docs/flashing/silabs_jlink_v9.md
@@ -0,0 +1,93 @@
+# How to Flash via Wire
+
+### What You'll Need
+
+- A J-Link programmer (JLink v9 confirmed to work)
+- A soldering iron
+- Some spare jumper wires
+
+### Step 1: Disassemble the Device
+
+Unplug the device from the mains. **Never attempt to disassemble it while it is plugged in!**
+
+In general, you need to disassemble devices until you have access to the ZS3L module or MCU itself. Here is a detailed example guide for the Moes 4 Gang switch.
+
+First, pop the front glass panel:
+
+![Front glass disassembly](/docs/.images/moes_4_gang_disassemble_front.jpg)
+
+Then gently detach the PCB from the device. Alternate the sides you use for leverage to avoid damage to the connector.
+
+![PCB disassembly](/docs/.images/moes_4_gang_disassemble_pcb.jpg)
+
+### Step 2: Solder the Wires
+
+You'll need to solder five wires as shown in the photos: GND, 3.3V, SWDIO, SWCLK, RST.
+
+If you have a ZS3L module, you can use the following [Tuya docs](https://developer.tuya.com/en/docs/iot/zs3l?id=K97r37j19f496) for reference. Or just follow this schema:
+
+![PCB connections](/docs/.images/meos_4_gang_pcb.jpg)
+
+For Moes 4 gang, we can re-use the connector to plug in power:
+
+![PCB power](/docs/.images/moes_4_gang_pcb_power.jpg)
+
+But you have to solder to the other pins. There is no need for a long-term connection, but be sure not to bridge the pins together.
+
+![PCB power](/docs/.images/moes_4_gang_pcb_wires.jpg)
+
+Finally, attach the wires to your J-Link programmer (for JLINK V9, the connection should look like this, following the color schema used above):
+
+![PCB power](/docs/.images/jlink_wires.jpg)
+
+### Step 3: Flash the Firmware
+
+Download both the bootloader and firmware for your device from [bin/](https://github.com/romasku/tuya-zigbee-switch/raw/refs/heads/main/bin). You'll need the generic `efr32mg21_bootloader.s37` and the `.s37` file specific for your device.
+
+#### Using Commander Software
+
+There are different software options that you can use for flashing, but one of the easiest options is to use Simplicity Commander from Silicon Labs. Download Commander from [this page](https://www.silabs.com/software-and-tools/simplicity-studio/simplicity-commander?tab=getting-started).
+
+Plug the J-Link into your PC, then open Commander and select your flasher. It may be named as some random set of numbers, that's ok.
+
+![commander select device](/docs/.images/commander_select_kit.png)
+
+**Check the connection:**
+
+Open the device info page to verify that the connection is good:
+
+![commander device info](/docs/.images/commander_device_info.png)
+
+If this doesn't work, you can try constantly tapping on the device touch button. This is because the device can be in deep sleep and the flasher cannot communicate with it. If this is your case, keep tapping until you erase the chip.
+
+**Erase the chip:**
+
+Open the flash tab and erase the chip. **THIS WILL DELETE STOCK FIRMWARE!** If you want to keep it, press "Open shell" below and use this command to backup the stock firmware:
+
+```
+commander readmem --device EFR32MG21 --region @mainflash --outfile stock_dump.bin
+```
+
+![commander erase](/docs/.images/commander_erase.png)
+
+**Flash the bootloader and firmware:**
+
+Now you'll need to flash both the bootloader and firmware separately.
+
+1. Press "Browse":
+
+   ![commander ](/docs/.images/commander_browse.png)
+
+2. Select the bootloader file (`efr32mg21_bootloader.s37`):
+
+   ![commander ](/docs/.images/commander_select_bootloader.png)
+
+3. Press "Flash" and wait until the process finishes:
+
+   ![commander ](/docs/.images/commander_flash.png)
+
+4. Now select your device-specific firmware file and press "Flash" again. Wait until the process finishes:
+
+   ![commander ](/docs/.images/commander_select_firmware.png)
+
+If done correctly, the onboard LED will start flashing automatically. You can try joining the device to a Zigbee network to verify that it connects properly. Once confirmed, disconnect everything, unsolder the wires, and reassemble the case.