You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/docs/adding-devices.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -36,7 +36,7 @@ standard: uk, us
36
36
|`board`| Type of board used in product |`esp8266`, `esp32`, `rp2040`, `bk72xx`, `rtl87xx`| No (but required to show on Boards page) |
37
37
|`project-url`| URL for product or GitHub. This should point directly to a working Yaml file or page where the yaml file is easily accessible (ie. a Github Repo) Repo || No |
38
38
|`made-for-esphome`| Has the manufacturer certified the device for ESPHome |`True`, `False`| No |
39
-
|`difficulty`| Difficulty rating |`1`: Comes with ESPhome, `2`: Plug-n-flash, `3`: Disassembly required, `4`: Soldering required, `5`: Chip needs replacement | No |
39
+
|`difficulty`| Difficulty rating |`1`: Comes with ESPHome, `2`: Plug-n-flash, `3`: Disassembly required, `4`: Soldering required, `5`: Chip needs replacement | No |
Copy file name to clipboardExpand all lines: src/docs/devices/ESP32-Relay-X1/index.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,10 +24,10 @@ They are available from aliexpress.
24
24
25
25
This board has headers for every GPIO pin on its ESP32 via 2 sets of 2x10 headers, and an additional 6 pin header below the ESP32 for flashing. The micro USB is for power only, no serial connection.
26
26
27
-
I was able to flash it using the ESPhome web tool and an FTDI connector. I was able to use the 5V pin with the FTDI set to 5V as well and connected to the GPIO pins, but 3.3V should be used if possible (it would not flash for me at 3.3V). I was unable to flash with a USB cable.
27
+
I was able to flash it using the ESPHome web tool and an FTDI connector. I was able to use the 5V pin with the FTDI set to 5V as well and connected to the GPIO pins, but 3.3V should be used if possible (it would not flash for me at 3.3V). I was unable to flash with a USB cable.
Copy file name to clipboardExpand all lines: src/docs/devices/Feit-DIMSMART-3-CAN/index.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -27,7 +27,7 @@ I don't like to solder onto that pad because it can pull the pad off. This makes
27
27
ltchiptool flash read beken-72xx ./dimmer1
28
28
```
29
29
30
-
## Installing ESPhome
30
+
## Installing ESPHome
31
31
32
32
I used ltchiptool's UPK2ESPHome to parse the firmware. The result is the configuration below. Put that config into a .yml file and compile the firmware:
Copy file name to clipboardExpand all lines: src/docs/devices/Feit-PLUG3-WIFI-WP-2-N/index.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,13 +21,13 @@ The SmartPlug leverages a Generic BK7231N module based on the BK7231N chip (a va
21
21
22
22
## GPIO Pinout
23
23
24
-
| Pin | Function |
25
-
| --- | --------------------|
26
-
| P26 | (PWM0) Pushbutton |
27
-
| P17 | (PWM1) Status LED |
28
-
| P15 | (PWM2) Relay |
29
-
| P10 | (RXD1) UART 1 RX |
30
-
| P11 | (TXD1) UART 1 TX |
24
+
| Pin | Function |
25
+
| --- | -----------------|
26
+
| P26 | (PWM0) Pushbutton |
27
+
| P17 | (PWM1) Status LED |
28
+
| P15 | (PWM2) Relay |
29
+
| P10 | (RXD1) UART 1 RX |
30
+
| P11 | (TXD1) UART 1 TX |
31
31
32
32
Disassembly is straightforward but DO NOT open the device while it is plugged into mains power as that presents a safety hazard. There are six phillips head screws on the bottom; they are all the same size. Remove those screws and set aside.
33
33

@@ -40,15 +40,15 @@ Next, use a USB FTDI adapter (I used [this](https://www.amazon.com/HiLetgo-FT232
40
40
41
41
## Preparing to flash
42
42
43
-
Using ESPhome, create a new device and give it a name. On the "Installation" screen, click 'SKIP THIS STEP' at the bottom. For the device type, you can select "Generic - BK7231N (Tuya QFN32)". Copy the encryption key if you plan on using it otherwise click 'skip'. Now you should see that device in the list; click on 'EDIT' just below and copy over the config with the one below. Make sure to update with your Wifi credentials and encryption key if using. Then click 'INSTALL' and then choose the 'Manual download' option. The reason for this is we need to use a special tool for the initial flash; ESPhome OTA updates will work as expected after the initial installation. Once it's compiled, select the top button to download the uf2 file.
43
+
Using ESPHome, create a new device and give it a name. On the "Installation" screen, click 'SKIP THIS STEP' at the bottom. For the device type, you can select "Generic - BK7231N (Tuya QFN32)". Copy the encryption key if you plan on using it otherwise click 'skip'. Now you should see that device in the list; click on 'EDIT' just below and copy over the config with the one below. Make sure to update with your Wifi credentials and encryption key if using. Then click 'INSTALL' and then choose the 'Manual download' option. The reason for this is we need to use a special tool for the initial flash; ESPHome OTA updates will work as expected after the initial installation. Once it's compiled, select the top button to download the uf2 file.
44
44
45
45
Using a Windows computer, [download](https://github.com/libretiny-eu/ltchiptool/releases) and run LTCHIPTOOL and be sure you are on the 'Flashing' tab. Plug in your USB FTDI adapter and select it from the 'Device port' list, set the baud rate of 115200, and set the 'Chip family' to 'Beken 72xx'. It is recommended to read through the [Beken BK72xx](https://docs.libretiny.eu/docs/platform/beken-72xx/) info page to better understand the following steps.
46
46
47
47
## Dumping original firmware
48
48
49
49
If you'd like to dump the original firmware, obviously you need to do this before flashing. If you have no interest in ever returning to the stock firmware skip to the next section. In the 'Output file' box, select the location you would like to save the file to. Select "Read flash" and then click 'Start'. Now is when you need that jumper wire you attached to ground earlier. Use it to tap the CEN pin briefly while LTCHIPTOOL is trying to read the device. This will reboot the BK7231N where it very briefly goes into program mode before continuing to its regular routine. You should see the progress of the read begin. You may have to try this a couple times to get it right. It will take a minute or two to dowload the flash. If you'd like to download the ROM for whatever reason (contains the bootloader/download mode), you can also do that now using the same method but selecting 'Read ROM' before hitting 'Start' again.
50
50
51
-
## Installing ESPhome
51
+
## Installing ESPHome
52
52
53
53
On the 'Flashing' tab within LTCHIPTOOL, choose 'Write flash / identify file' option and then browse to the uF2 file you compiled earlier and then press 'Start'. You will again need to tickle the CEN pin on the BK7231N module with your ground wire to get it to start flashing. Once it completes, it should reboot and join your WiFi network. You can now disconnect your temporary wire connections to the PCB, carefully reseat the PCB on to the pegs. Place the top cover back onto the base ensuring that the cord and outlet seals are all seated properly. Secure it all shut with the 6 screws and you're done!!
0 commit comments