Intial commit

2026-08-27 22:16:23 +03:00
commit a5963c9ed6
12 changed files with 3178 additions and 0 deletions
@@ -0,0 +1,70 @@
+# Board passport
+
+## Identification status
+
+The target board has not been identified. No photograph of the physical
+markings is available in the repository, no `sources/` directory is present,
+and no serial device is exposed to the build environment. Consequently, the
+manufacturer, exact board model and revision, module variant, flash size,
+PSRAM, USB connection, built-in LED, and board-specific pinout cannot be
+confirmed without guessing.
+
+Required evidence to unblock Milestone 000:
+
+- clear photographs of both sides of the board, including all PCB and module
+  markings;
+- the manufacturer's product page, schematic, and pinout matching those
+  markings;
+- the flash/module ordering code, or an `esptool.py flash_id` report from the
+  connected board.
+
+## Current repository baseline (not hardware confirmation)
+
+| Item | Observed value | Status |
+|---|---|---|
+| PlatformIO Core | 6.1.19 | Installed locally |
+| PlatformIO platform | `platformio/espressif32` 7.0.1 | Installed locally; `platformio.ini` is not version-pinned |
+| Framework | ESP-IDF 6.0.1 | Current project setting conflicts with the Arduino-first MVP baseline |
+| Arduino Core | Not installed | Cannot be pinned and verified against this board yet |
+| PlatformIO board | `esp32-c6-devkitm-1` | Unverified candidate, not evidence of the physical model |
+| Board-profile flash size | 4 MB | Unverified; profile metadata only |
+| Generated SDK flash size | 2 MB | Conflicts with the board profile |
+| Generated partition table | Single application, no LittleFS | Does not meet Milestone 000 |
+
+The current configuration is not a safe flashing baseline. It must not be used
+to upload firmware until the physical flash size and board identity are
+confirmed.
+
+## Candidate reference only
+
+If the physical markings prove that the board is an Espressif
+ESP32-C6-DevKitM-1, the matching authoritative references are:
+
+- [ESP32-C6-DevKitM-1 user guide](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c6/esp32-c6-devkitm-1/user_guide.html)
+- [ESP32-C6-DevKitM-1 schematic](https://docs.espressif.com/projects/esp-dev-kits/en/latest/_static/esp32-c6-devkitm-1/schematics/esp32-c6-devkitm-1-schematics.pdf)
+- [ESP32-C6-MINI-1 datasheet](https://www.espressif.com/sites/default/files/documentation/esp32-c6-mini-1_mini-1u_datasheet_en.pdf)
+
+For that board only, Espressif documents an ESP32-C6-MINI-1(U) module with
+4 MB in-package SPI flash, no PSRAM, a USB-C connector connected through a
+USB-to-UART bridge, UART0 on GPIO16/GPIO17, native USB D-/D+ on GPIO12/GPIO13,
+and an addressable RGB LED on GPIO8. These values are deliberately not adopted
+as the target specifications until the markings match.
+
+## Memory map and partition status
+
+No partition CSV has been selected because the physical flash capacity is
+unknown. The eventual layout must reserve, at minimum, NVS, PHY initialization,
+one application partition, and one LittleFS data partition, with offsets and
+sizes validated against the confirmed flash capacity. Selecting a 4 MB layout
+now could make flashing unsafe on a smaller device.
+
+## Risks carried to the next action
+
+- A generic “ESP32-C6 Mini” may not match Espressif's DevKitM-1 pinout, LED
+  polarity/type, USB bridge, or flash capacity.
+- GPIO8, GPIO12, GPIO13, GPIO16, and GPIO17 must not be assigned from the
+  candidate documentation until the exact board is confirmed.
+- Official `platformio/espressif32` 7.0.1 exposes the C6 DevKitM profile only
+  for ESP-IDF and its bundled Arduino Core 2.0.17 does not support ESP32-C6.
+  An exact Arduino-compatible PlatformIO platform/Core pairing must be chosen
+  and pinned after the board is identified, then proven by Milestone 001.