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

3.6 KiB

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:

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.