Files
battleship/docs/BOARD_PASSPORT.md
T
2026-08-27 22:16:23 +03:00

71 lines
3.6 KiB
Markdown

# 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.