Merge branch 'master' of https://github.com/blakadder/templates

blakadder · Jun 17, 2024 · 6021357 · 6021357
2 parents 62476e5 + 4477e32
commit 6021357
Show file tree

Hide file tree

Showing 35 changed files with 270 additions and 26 deletions.
diff --git a/_templates/ESP32-C6-EVB b/_templates/ESP32-C6-EVB
@@ -3,7 +3,7 @@ date_added: 2023-12-12
 title: Olimex ESP32-C6-EVB
 model: ESP32-C6-EVB
 image: /assets/device_images/ESP32-C6-EVB.webp
-templatec6: '{"NAME":"ESP32-C6-EVB","GPIO":[1,7648,7649,7650,1,1,1,1,288,32,224,225,1,1,1,7651,1,1,1,1,1,1,226,227,0,0,0,0,0,0,0],"FLAG":0,"BASE":1}' 
+templatec6: '{"NAME":"ESP32-C6-EVB","GPIO":[1,160,161,162,1,1,1,1,288,32,224,225,1,1,1,163,1,1,1,1,1,1,226,227,0,0,0,0,0,0,0],"FLAG":0,"BASE":1}' 
 link: https://www.olimex.com/Products/IoT/ESP32-C6/ESP32-C6-EVB/open-source-hardware
 link2: 
 mlink: 
@@ -14,12 +14,12 @@ standard: global
 ---
 [PCB Pinout](https://github.com/OLIMEX/ESP32-C6-EVB/blob/main/HARDWARE/Hardware-revision-A/ESP32-C6-EVB_Rev_A.pdf)
 
-Used `tasmota32c6cdc-arduino30.factory.bin` and Tasmota Web Installer to flash the device with built in USB-C serial adapter.
+Used `tasmota32c6.factory.bin` and Tasmota Web Installer to flash the device with built in USB-C serial adapter.
 
 **Bootloader procedure**:
 
 - Press and hold button BUT1
 - Press and release button RST1
 - Release button BUT1
 
-Tested only relays, led and button.
+Tested only relays, led and button.
diff --git a/_templates/ESP32-S3-DevKitC-1-N16R8V b/_templates/ESP32-S3-DevKitC-1-N16R8V
@@ -0,0 +1,21 @@
+---
+date_added: 2024-03-27
+title: Espressif ESP32-S3-DevKitC-1-N16R8V
+model: ESP32-S3-DevKitC-1-N16R8V
+image: /assets/device_images/espressif_ESP32-S3-DevKitC-1.webp
+templates3: '{"NAME":"ESP32-S3-DevKitC-1-N16R8V","GPIO":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0,0,1376,1,1,1,1,1,1,1,1,1,1],"FLAG":0,"BASE":1}'
+category: diy
+type: Development Board
+standard: global
+mlink: https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html
+link: https://www2.mouser.com/ProductDetail/Espressif-Systems/ESP32-S3-DevKitC-1-N32R8V?qs=Li%252BoUPsLEnvTvWIWLPCZ4g%3D%3D
+flash: serial
+chip: s3
+autoconf: true
+---
+Flash: 16 MB Octal SPI (OT)
+PSRAM: 8 MB Octal SPI (OT)
+
+For boards with Octal SPI flash/PSRAM memory embedded, the pins GPIO35, GPIO36 and GPIO37 are used for the internal communication between ESP32-S3 and SPI flash/PSRAM memory, thus not available for external use.
+
+Used `tasmota32s3-opi_opi.factory.bin` and Tasmota Web Installer to flash the device with built in USB-C serial adapter. [Download](https://github.com/Jason2866/Tasmota-specials/blob/firmware/firmware/tasmota32/other/tasmota32s3-opi_opi.factory.bin)
diff --git a/_templates/ESP32-S3-DevKitC-1-N32R8V b/_templates/ESP32-S3-DevKitC-1-N32R8V
@@ -0,0 +1,24 @@
+---
+date_added: 2024-03-27
+title: Adafruit ESP32-S3-DevKitC-1-N32R8V
+model: ESP32-S3-DevKitC-1-N32R8V
+image: /assets/device_images/adafruit_ESP32-S3-DevKitC-1-N32R8V.webp
+templates3: '{"NAME":"ESP32-S3-DevKitC-1-N16R8V","GPIO":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,0,0,0,1376,1,1,1,1,1,1,1,1,1,1],"FLAG":0,"BASE":1}'
+category: diy
+type: Development Board
+standard: global
+mlink: https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html
+link: https://www.adafruit.com/product/5364
+flash: serial
+chip: s3
+autoconf: true
+---
+This version is equipped with the ESP32-S3-WROOM-2 (PCB antenna) with 32MB Flash and 8MB PSRAM.
+ * Flash: 32 MB Octal SPI (OT)
+ * PSRAM: 8 MB Octal SPI (OT)
+
+For boards with Octal SPI flash/PSRAM memory embedded, the pins GPIO35, GPIO36 and GPIO37 are used for the internal communication between ESP32-S3 and SPI flash/PSRAM memory, thus not available for external use.
+
+[ESP32S3WROOM2 datasheet](https://www.mouser.fr/datasheet/2/891/esp32_s3_wroom_2_datasheet_en-2902185.pdf)
+
+Used `tasmota32s3-opi_opi.factory.bin` and Tasmota Web Installer to flash the device with built in USB-C serial adapter. [Download](https://github.com/Jason2866/Tasmota-specials/blob/firmware/firmware/tasmota32/other/tasmota32s3-opi_opi.factory.bin)
diff --git a/_templates/M5NanoC6 b/_templates/M5NanoC6
@@ -0,0 +1,15 @@
+---
+date_added: 2024-05-12
+title: M5Stack NanoC6 Dev Kit
+model: C125
+category: diy
+type: Development Board
+standard: global
+image: /assets/device_images/M5Stack_NanoC6.webp
+templatec6: '{"NAME":"M5Stack NanoC6","GPIO":[1,1,1,1056,1,1,1,288,1,160,1,1,1,1,1,1,1,1,1,1,1376,1,1,1,0,0,0,0,0,0,0],"FLAG":0,"BASE":1}'
+mlink: https://shop.m5stack.com/products/m5stack-nanoc6-dev-kit
+link2: https://docs.m5stack.com/en/core/M5NanoC6
+link: https://aliexpress.com/item/1005006738362789.html
+link3: https://www.digikey.com/en/products/detail/m5stack-technology-co-ltd/C125/22571399
+build: tasmota32c6.bin
+---
diff --git a/_templates/RMW002 b/_templates/RMW002
@@ -13,3 +13,6 @@ type: Relay Module
 standard: global
 ---
 This devices comes with a Tuya module not compatible with Tasmota which needs to be replaced with an [ESP-02S](ESP-02S)
+
+Recent devices seem to have moved the "switch 1) to GPIO14 (away from GPIO5)
+
diff --git a/_templates/auvisio_S06 b/_templates/auvisio_S06
@@ -7,7 +7,7 @@ standard: global
 flash: serial
 mlink: https://www.pearl.de/a-NX4519-1254.shtml
 image: https://user-images.githubusercontent.com/5904370/56278781-254d5080-6107-11e9-90b4-a68579147e74.png
-template: '{"NAME":"NX-4519-675","GPIO":[0,0,0,0,52,51,0,0,0,0,8,0,0],"FLAG":0,"BASE":18}' 
+template9: '{"NAME":"NX-4519-675","GPIO":[0,0,0,0,288,1088,0,0,0,32,1056,0,0,0],"FLAG":0,"BASE":18}'
 link: https://www.aliexpress.com/item/4000291431322.html
 link2: https://www.amazon.de/dp/B07N88CQ6Z
 unsupported: false

diff --git a/_templates/dingtian_DT-R004 b/_templates/dingtian_DT-R004
@@ -0,0 +1,51 @@
+---
+date_added: 2024-04-26
+title: Dingtian 4 Channel
+model: DT-R004
+image: https://raw.githubusercontent.com/jeroenst/templates/8a4aa285e4ab283d993165501f67824d985b936d/assets/device_images/dingtian_DT-R004.webp
+template32: '{"NAME":"Dingtian DT-R004","GPIO":[0,9408,225,9440,0,0,0,0,227,9952,0,0,224,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,226,162,0,163,160,0,0,161],"FLAG":0,"BASE":1}' 
+link: https://nl.aliexpress.com/item/4000091488766.html
+mlink: https://www.dingtian-tech.com/en_us/relay4.html
+flash: serial
+category: relay
+type: Relay Board
+standard: global
+---
+## Warning
+When ordering this board ask for relay board with test firmware, otherwise the ESP32 will be locked.
+
+Relay 1 is connected to GPIO 16 which is used for PSRAM in Tasmota, to prevent a pulse on Relay 1 upon boot use the tasmota32-nopsram firmware. (https://github.com/arendst/Tasmota/discussions/21266)
+
+### Description
+Dingtian relay boards are ESP32 based boards with 2, 4, 8, 16, 24 or 32 relays and inputs.
+
+At the 2 and 4 relay boards the relays and inputs are directly connected to the gpio's of the ESP32.
+
+Example for the 4 relay board:
+![image](https://raw.githubusercontent.com/jeroenst/templates/8a4aa285e4ab283d993165501f67824d985b936d/assets/device_images/dingtian_DT-R004.webp)
+
+Pinout for the 4 relay board:
+![image](https://raw.githubusercontent.com/jeroenst/templates/8a4aa285e4ab283d993165501f67824d985b936d/assets/pinouts/dingtian_DT-R004.webp)
+
+### Mqtt Messages
+Inputs state are reported through SENSOR message at teleperiod:
+
+```shell
+MQT: tele/dingtian1/SENSOR = "{"Time":"2024-04-26T09:17:15","Switch1":"ON","Switch2":"ON","Switch3":"ON","Switch4":"ON"}"
+```
+
+Input changes are only reported when using switchmode 15 or 16:
+
+```shell
+ MQT: stat/dingtian1/SENSOR = {"Time":"2024-04-26T09:24:02","Switch1":"OFF","Switch2":"ON","Switch3":"OFF","Switch4":"OFF"} (retained)
+```
+
+When using switchmode 0, Input changes are not reported, but the output changes are reported:
+
+```shell
+ MQT: stat/dingtian1/RESULT = {"POWER1":"ON"}
+```
+
+### Note
+
+For using Modbus on the RS485 port (if ordered with this option) have a look at https://tasmota.github.io/docs/Modbus-Bridge/
diff --git a/_templates/duux_DXCF10 b/_templates/duux_DXCF10
@@ -8,8 +8,31 @@ link: https://www.amazon.de/dp/B088WBKJ7J
 link2: https://www.idealo.de/preisvergleich/Typ/8716164994780.html
 link3: https://www.bol.com/nl/nl/p/duux-whisper-flex-zwart-dxcf10-smart-statiefventilator-staande-ventilator-geruisloos/9200000120816337/
 mlink: https://duux.com/en/product/whisper-flex-smart-zwart/
-flash: tuya-convert
+flash: serial
 category: misc
 type: Fan
 standard: eu
 ---
+## MCU Functions
+
+- `dpid1` Power relay - When toggled will turn fan on / off.
+- `dpid2` Mode - 0 = Manual Mode, 1 = Natural Mode, 2 = Sleep Mode
+  - Natural Mode: The fan speed varies randomly between (speed 3 to 6), in - the interval of every 15 seconds, giving the effect of a natural breeze.
+  - Sleep Mode: The fan will operate at speed setting 1
+  - Manual Mode: Fan speed is set by dpid3
+- `dpid3` Sets the fan speed: 0 slow - 25 fast, (display 1 - 26)
+- `dpid4` Oscillates horizontally
+- `dpid5` Oscillates vertically
+- `dpid6` Set an automatic timer: 0 - 12 h
+
+Configure Tasmota’s DpIds with the correct FnIds:
+
+```
+Backlog TuyaMCU 61,2; TuyaMCU 62,3; TuyaMCU 12,4; TuyaMCU 13,5; TuyaMCU 64,6;
+```
+
+Configure the correct Enums lists for Speed, Mode and Timer:
+
+```
+Backlog TuyaEnumlist 1,2; TuyaEnumlist 2,25; TuyaEnumlist 4,12;
+```
diff --git a/_templates/duux_DXCF12 b/_templates/duux_DXCF12
@@ -8,7 +8,7 @@ link3: https://www.bol.com/nl/nl/p/duux-whisper-flex-zwart-dxcf12-smart-statiefv
 link2: https://www.idealo.de/preisvergleich/OffersOfProduct/201477637_-whisper-flex-smart-schwarz-dxcf12-duux.html
 link: https://www.amazon.de/dp/B08F94JGK8/
 mlink: https://duux.com/en/product/whisper-flex-smart-zwart-battery-pack/
-flash: tuya-convert
+flash: serial
 category: misc
 type: Fan
 standard: global
@@ -35,4 +35,4 @@ Configure the correct Enums lists for Speed, Mode and Timer:
 
 ```
 Backlog TuyaEnumlist 1,2; TuyaEnumlist 2,25; TuyaEnumlist 4,12;
-```
+```
diff --git a/_templates/espressif_ESP32-S3-DevKitC-1 b/_templates/espressif_ESP32-S3-DevKitC-1
@@ -7,11 +7,13 @@ templates3: '{"NAME":"ESP32-S3-DevKitC-1","GPIO":[1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,
 category: diy
 type: Development Board
 standard: global
-mlink: https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1.html
+mlink: https://docs.espressif.com/projects/esp-idf/en/latest/esp32s3/hw-reference/esp32s3/user-guide-devkitc-1-v1.0.html
 link: https://www.aliexpress.com/item/1005003979778978.html
 link2: https://www.amazon.com/dp/B09Y8NSW82
 link3: https://www.dfrobot.com/product-2587.html
 flash: serial
 chip: s3
 autoconf: true
 ---
+
+Both the initial and v1.1 versions of ESP32-S3-DevKitC-1 are available on the market. The main difference lies in the GPIO assignment for the RGB LED: the initial version uses GPIO48, whereas v1.1 uses GPIO38.
diff --git a/_templates/etekcity_ESW15-USA b/_templates/etekcity_ESW15-USA
@@ -1,9 +1,9 @@
 ---
 date_added: 2020-03-08
-title: Etekcity 15A
+title: ETEKCITY Voltson Smart Wi-Fi Outlet
 model: ESW15-USA
 image: /assets/device_images/etekcity-ESW15-USA.webp
-template: '{"NAME":"ESW15-US","GPIO":[0,0,0,0,0,21,0,0,132,133,17,130,52],"FLAG":0,"BASE":18}' 
+template: '{"NAME":"ESW15-USA","GPIO":[0,0,0,0,416,224,0,0,2656,2688,32,2592,544,4704],"FLAG":0,"BASE":18}' 
 link: https://www.amazon.com/dp/B07PLFZ58Y/
 link2: https://www.amazon.com/dp/B07Y7RC7K7/
 mlink: https://www.etekcity.com/product/100328
@@ -12,3 +12,69 @@ category: plug
 type: Plug
 standard: us
 ---
+
+## Flashing New Firmware
+
+### 1. Connect The Device To A USB Serial Converter
+
+Using the table below as a guide, connect each pin of a USB serial converter to its corresponding test pad on the PCB.
+
+| USB serial converter | Smart Outlet Test Pad
+| -------------------- | -
+| RX / RXD             | TX
+| TX / TXD             | RX
+| GND                  | GND
+| VCC                  | 3.3v
+| GND                  | IO0 (looks like 100)
+
+**_NOTE:_**  The IO0 test pad on the PCB might look like the number 100. This pad is connected to GPIO0 on the ESP-01F. When pulled low (grounded) during power on, it will put the ESP module into Flash Mode. You can either connect this to the GND pin of the USB serial converter or the GND test pad on the device. **You will need to disconnect this pad from ground for the device to boot normally. If you want to test the firmware before reassembling the plug, wire this in such a way that you can easily detach it from ground.**
+
+### 2. Boot Into Flash Mode
+
+When an ESP module is powered on normally, it will start executing the installed firmware. The ESP module needs to be put into Flash Mode before its firmware can be erased, read, or written to.
+
+Follow the steps below to boot the ESP module into Flash Mode:
+
+1. With all the other pins correctly connected to the USB serial converter, disconnect the 5V VCC wire and plug the USB serial converter into a USB port on a computer.
+2. Ensure the IO0 pin is pulled low (connected to any ground source) before proceeding.
+3. Plug the VCC wire back into the USB serial converter. The device should boot into Flash Mode, usually indicated by the indicator LED lighting up solid blue.
+4. Determine the COM port that the USB serial converter is attached to on the computer, and proceed by either backing up the firmware or flashing new firmware to the device.
+
+### 3. Firmware Backup (optional)
+
+If you want to make a backup of the OEM firmware so you can reflash it later for any reason, follow the steps below.
+
+⚠ **SECURITY WARNING:** If the device is already set up, this procedure will also include any specific configurations, such as Wi-Fi credentials. You may want to factory reset the device and back up a clean version of the firmware as well if you plan on reselling this item in the future. Additional documentation on how to use esptool can be found [here](https://docs.espressif.com/projects/esptool/en/latest/esp32/index.html).
+
+Follow the steps below to back up the firmware currently installed on the ESP module.
+
+1. Download the latest esptool release for your operating system from [GitHub](https://github.com/espressif/esptool/releases).
+2. Extract it and open a terminal in the folder where esptool is located.
+3. With the ESP module booted into Flash Mode, run the following commands to back up or restore the firmware.
+
+**_NOTE:_** The following command examples assume you are using a Windows computer with PowerShell and the USB serial converter is attached to COM3.
+
+#### Backup Firmware
+
+```bash
+.\esptool.exe -b 115200 --port COM3 read_flash 0 ALL Etekcity_Voltson_etekcity-ESW15-USA.bin
+```
+
+#### Restore Firmware
+
+```bash
+.\esptool.exe -b 115200 --port COM3 write_flash 0 Etekcity_Voltson_etekcity-ESW15-USA.bin
+```
+
+### 4. Flashing Tasmota
+
+You can use this [official site](https://tasmota.github.io/install/) to flash Tasmota to your device.
+
+1. With the ESP module booted into Flash Mode, connect to the device and flash Tasmota to the device ( e.g., **_Tasmota (english)_** ).
+2. Once the installation is successful, disconnect the VCC wire from the USB serial converter to power off the device.
+3. Disconnect the IO0 test pad from GND so that the device will no longer boot into Flash Mode when powered on.
+4. Plug the VCC wire back into the USB serial converter. The device should now boot normally.
+5. You should now see a new Wi-Fi signal with an SSID that includes "tasmota". Connect to this and use the captive portal to configure the Wi-Fi.
+6. Once configured, the device will get an IP via the DHCP server on the network, and its web portal will be accessible.
+
+**_NOTE:_** The PWM output for the night light on the device will seem glitchy when powered only via the 3.3V. Once the plug is connected to an outlet, the night light will behave normally.
diff --git a/_templates/ghome_EP2-A b/_templates/ghome_EP2-A
@@ -3,7 +3,7 @@ date_added: 2023-12-09
 title: GHome EP2-A
 model: EP2-A
 image: /assets/device_images/ghome_EP2-A.webp
-template9: '{"NAME":"GHome EP2-A","GPIO":[320,0,576,0,2656,2720,0,0,2624,32,0,224,0,0],"FLAG":0,"BASE":45}' 
+template9: '{"NAME":"GHome EP2-A","GPIO":[576,0,320,0,2656,2720,0,0,2624,32,0,224,0,0],"FLAG":0,"BASE":45}' 
 link2: https://www.amazon.es/dp/B09Q5BLMVT/
 link: https://www.amazon.de/dp/B09Q5K34NV
 mlink: 
@@ -12,3 +12,4 @@ category: plug
 type: Plug
 standard: eu
 ---
+If you prefer the blue LED (instead of the green one) to represent "Power ON", swap Led1i and LedLinki in the ***Configure Template*** page.
diff --git a/_templates/gosund_SP111_v1_1 b/_templates/gosund_SP111_v1_1
@@ -15,6 +15,11 @@ This layout is for PCB marked as "SP111_A_Wifi_Ver1.1". It has the "3450W max" l
 
 ![Pinout](https://user-images.githubusercontent.com/5904370/73123199-b4886e00-3f8d-11ea-8b5e-e850efaa603f.png)
 
+To enter programming mode:
+1. Power the device with GPIO2 connected to GND. Red LED should turn on.
+2. After couple of seconds, remove the connection between GPIO2 and GND. The red LED should then turn off.
+3. The device is ready to be flashed.
+
 If the template doesn't work see other hardware versions of the same plug:
 * [Gosund SP111](gosund_SP111)
 * [Gosund SP111 v1.4](gosund_SP111_v1_4)
diff --git a/_templates/ilonda_L88 b/_templates/ilonda_L88
@@ -14,6 +14,7 @@ type: Miscellaneous
 standard: global
 ---
 
+Now(5/24) comes with WBR3 module that needs to be [changed](https://blakadder.com/replace-tuya-esp12/)
 Once programmed, the following option must be activated in the Tasmota console: `PulseTime1 30`
 
 The value of 30 indicates a time period of 30 tenths of a second, or 3 seconds. It is the pulse of the signal that activates the motor because if it is left activated, the motor never stops. The pulse initiates the motor movement and the stop position is defined by electrical contacs in the hardware. It is not a critical value. It's about half the time it takes for the motor to complete one lap.

diff --git a/_templates/kmc_4 b/_templates/kmc_4
@@ -8,7 +8,11 @@ standard: us
 link: https://www.amazon.com/dp/B0786B1LGM
 image: https://images-na.ssl-images-amazon.com/images/I/41W9sOQhBKL._SX679_.jpg
 template: '{"NAME":"KMC 4 Outlet","GPIO":[0,56,0,0,133,132,0,0,130,22,23,21,17],"FLAG":0,"BASE":36}' 
-link2: 
+link2: https://www.amazon.com/dp/B07SWZ2N4J
 ---
 
 KMC 4 Outlet WiFi Smart Plug Energy Monitoring Smart Outlet
+
+- 10-June-2024: Bought 2 from amazon(link2) and was able to flash both
+
+*Note: Until they connect to wifi they seem to continually turn power on/off for some reason
diff --git a/_templates/lenovo_ZG38C02927 b/_templates/lenovo_ZG38C02927
@@ -6,6 +6,7 @@ image: /assets/device_images/lenovo_ZG38C02927.webp
 template: '{"NAME":"Lenovo PIR","GPIO":[255,107,255,108,255,255,0,0,255,255,255,255,255],"FLAG":0,"BASE":54}' 
 link: https://www.aliexpress.com/item/4001022480011.html
 link2: https://www.jbhifi.com.au/products/lenovo-smart-motion-sensor
+link3: https://www.binglee.com.au/products/smart-motion-sensor-zg38c02927
 mlink: 
 flash: serial
 category: sensor

diff --git a/_templates/lilygo_T-Internet-POE b/_templates/lilygo_T-Internet-POE
@@ -42,3 +42,5 @@ The card reader uses these pins for communication:
 | 15 | SCLK |
 
 So if you need the card reader in your project, three pins of the 2x8 header are already in use for SPI!
+
+[Known issue](https://github.com/espressif/arduino-esp32/issues/1912#issuecomment-426247971) with the LAN chip
diff --git a/_templates/m5stack_atom_lite b/_templates/m5stack_atom_lite
@@ -3,7 +3,7 @@ date_added: 2021-04-07
 title: M5Stack Atom Lite ESP32
 model: C008
 image: /assets/device_images/m5stack_atom_lite.webp
-template32: '{"NAME":"M5Stack Atom Lite","GPIO":[1,1,1,1,1,1,1,1,1056,1,1,1,1,1,1,1,0,1,1,1,0,1,640,1376,0,0,0,0,608,1,1,1,1,0,0,32],"FLAG":0,"BASE":1}' 
+template32: '{"NAME":"M5Stack Atom Lite","GPIO":[0,0,0,0,0,0,0,0,1056,0,0,0,0,0,0,1,0,1,1,1,0,1,1,1376,0,0,0,0,1,1,1,0,0,0,0,32],"FLAG":0,"BASE":1}' 
 link: https://www.aliexpress.com/item/4000576823662.html
 link2: https://www.banggood.com/M5Stack-ATOM-Lite-ESP32-Development-Board-Kit-Neo-LED-Blockly-Programmable-Kit-p-1645120.html
 link3: https://www.amazon.co.uk/dp/B08GKR9GCX

diff --git a/_templates/milfra_KS-501 b/_templates/milfra_KS-501
@@ -15,3 +15,11 @@ standard: [eu, fr]
 ---
 
 Pinouts are shown on the ESP32 Board. It's VCC, GNC, RX, TX, ESP32C3 Rev.3
+
+On some devices the serial connection is disabled and won't work. One can
+then use the ESP32 built in USB-to-serial adapter by connecting a USB cable
+directly to the board. The pin opposite of `VCC` is `USB data +` (green wire),
+the pin opposite of `GND` is `USB data -` (white wire). Do *not* connect the
+other two (5V and GND) wires of the USB cable. Those have the wrong voltage
+and will brick your device! Connect `GND` and `VCC` on the board to a
+suitable 3V3 power supply instead.