doc: add v3 changes

CHANGELOG.md

@@ -1,3 +1,16 @@
+v3
+--
+
+changes:
+
+- more appropriate LED resistor values
+- change LED meaning
+- use only PDM mic
+- replace ESP32-S2 with ESP32 for PDM support, and better WLED support
+- make USB optional (only needed for debug)
+- add one I/O to port (allowing 3-line protocols like SPI or I2S)
+- change input capacitors (for manufacturability)
+
 v2
 --
 

README.md

@@ -13,6 +13,7 @@ It allows to:
 - provide power and data (DMX512) over the Ethernet cables
 - proper 5V LED data signal output (up to three of them)
 - embed microphone for sound reactive effects
+- put board in waterproof enclosure (for [sonoff](https://www.sonoffegypt.com/products/sonoff-ip66-waterproof-case) or generic [100x68x50 mm](https://www.aliexpress.com/item/1005005622148025.html)).
 
 usage
 =====
@@ -20,26 +21,29 @@ usage
 flashing
 --------
 
-Once the board is assembled, press the DL button on the bottom side (if populated) or short DL with 0V on the side of the MCU using tweezers while powering up the board.
+There are several ways to flash the board (from easiest to more development friendly):
-This will put the ESP32-S2 into download mode and allow flashing the [WLED firmware](https://github.com/Aircoookie/WLED/releases) using [esptool](https://github.com/espressif/esptool) as follows (the [web interface](https://install.wled.me/) fails installing over USB CDC ACM):
+
+- connect USB to serial adapter TX and RX signals on the DEBUG port. Short DL to GND pin while powering up to enter download mode
+- populate DL and RST buttons to not have to short the pins by hand
+- connect USB to serial adapter RTS to RST and DTR to DL on the DEBUG port, to switch to download mode from the computer
+- populate the USB-C port and CH340K USB to serial adapter to avoid using and external adapter
+
+Once in download mode, we can flash the [WLED firmware](https://github.com/Aircoookie/WLED/releases) using the [web interface](https://install.wled.me/), or [esptool](https://github.com/espressif/esptool):
 
 ~~~
-wget https://install.wled.me/bin/release_0_14_0/esp32-s2_bootloader_v2.bin
+wget https://install.wled.me/bin/release_0_14_0/esp32_bootloader_v4.bin
-esptool.py --port /dev/ttyACM0 --after no_reset write_flash 0x0 ./esp32-s2_bootloader_v2.bin
+esptool.py --port /dev/ttyACM0 --after no_reset write_flash 0x0 ./esp32_bootloader_v4.bin
-wget https://install.wled.me/bin/release_0_14_0/WLED_0.14.0_ESP32-S2.bin # there is no audio reactive variant for it
+wget https://install.wled.me/bin/release_0_14_0/WLED_0.14.0_ESP32_audioreactive.bin
-esptool.py --port /dev/ttyACM0 --after no_reset write_flash 0x10000 WLED_0.14.0_ESP32-S2.bin
+esptool.py --port /dev/ttyACM0 --after no_reset write_flash 0x10000 WLED_0.14.0_ESP32_audioreactive.bin
 ~~~
 
-Alternatively you can use the UART pint on the side of the ESP32-S2 to flash it using a USB to UART adapter.
-Connect RTS to R and DTR to DL to allow automatic switching into download mode.
-
 TODO: make a custom WLED build with
 
 - status LED set
 - audio reactive enabled
-- DMX out enabled
+- DMX out (needs to be implemented)
-- DMX in enabled (usermod)
+- DMX in enabled (needs to be implemented)
-- all pins configured
+- all pins configured (that's just a configuration)
 
 status
 ------
@@ -59,7 +63,7 @@ The board can be used in various configurations:
 
 - LED strip (for small, medium, or large LED installations): using 5V or 12V
 - power supply: 5V or 8-60V
-- enclosure: with or without a [sonoff enclosure](https://www.sonoffegypt.com/products/sonoff-ip66-waterproof-case)
+- enclosure: with or without a waterproof enclosure
 - chain: a single standalone device, or with additional WLED chain devices
 - DMX: controlled using WiFi, or DMX
 
@@ -259,7 +263,7 @@ Features already implemented:
 - proper 5V DOUT for WS2812B IC input, 3 channels (can be combined for LEDs requiring an additional clock signal)
 - in-line LED data resistors for [signal conditioning](https://quinled.info/data-signal-cable-conditioning/). Ideally it should use a smaller value since it's intended for running the signal along ground over short distances, but there were already 100 Ohm on the board for DMX512 termination, and it allows better compatibility for longer single ended cables.
 - external WiFi antenna port, by using the U variant of the ESP32-S2-MINI, with appropriate connector
-- PCB fitting in [sonoff waterproof enclosure](https://www.sonoffegypt.com/products/sonoff-ip66-waterproof-case)
+- PCB fitting in waterproof enclosure (sonoff or generic 100x68x50)
 - high voltage input (up to 60V, using TPS54560DDAR)
 - input protection (reverse polarity, PPTC), only for 8-60V power input
 - microphone for sound reactive