wifi_ir: progetto Go.Comma R9 - documentazione, script flash e setup

docs/hardware.md

@@ -0,0 +1,47 @@
+# Hardware Go.Comma R9
+
+## Specifiche
+
+| Specifica | Valore |
+|---|---|
+| Modello | Go.Comma R9 Smart Remote |
+| Chip WiFi | ESP8266 (Tensilica Xtensa LX106) |
+| Modulo | TYWE3S (2MB flash) |
+| LED IR | 7 LED a 38KHz |
+| Ricevitore IR | TSOP38238 o equivalente (38KHz) |
+| Tensione | 5V (USB) / 3.3V (modulo) |
+
+## Pinout TYWE3S sul PCB
+
+Il modulo TYWE3S ha 14 pin a semicerchio. Sui pad del PCB sono serigrafate le connessioni:
+
+| Pin TYWE3S | Funzione Go.Comma | Utilizzo flashing |
+|---|---|---|
+| TX (GPIO1) | — | ← RX USB-UART |
+| RX (GPIO3) | — | → TX USB-UART |
+| GND | — | GND |
+| GPIO0 | Flash mode | → GND (per flash) |
+| GPIO14 | **IR TX** (7 LED) | — |
+| GPIO5 | **IR RX** (ricevitore) | — |
+| GPIO4 | **LED** (indicatore) | — |
+| GPIO13 | **Pulsante** (fisico) | — |
+| 3.3V | Alimentazione modulo | Già alimentato |
+| RST | Reset | — |
+| EN (CH_PD) | Chip enable | — |
+
+## Schema collegamenti USB-UART
+
+```
+USB-UART (CH340/CP2102)        Go.Comma R9 (PCB)
+══════════════════════        ═════════════════
+         TX  ─────────────────▶  RX (pad sul PCB)
+         RX  ◀─────────────────  TX (pad sul PCB)
+        GND  ─────────────────  GND
+        GND  ─────────────────  GPIO0 (pad, per flash mode)
+```
+
+**Note**:
+- Usare 3.3V, NON 5V — l'ESP8266 lavora a 3.3V
+- Collegare GPIO0 a GND PRIMA di accendere il telecomando
+- Il telecomando ha la sua alimentazione (pile), non serve VCC esterno
+- Rimuovere GPIO0 da GND dopo il flash