diff --git a/README.md b/README.md index abdeb74..721cb0f 100644 --- a/README.md +++ b/README.md @@ -13,17 +13,17 @@ The Pico 2W plugs directly into the display board's header socket. No additional ### Pin Mapping (PicoResTouch-LCD-2.8) -| Component | GPIO | Function | -| :---------------- | :----- | :---------------- | -| **LCD SCLK** | `GP10` | SPI1 Clock | -| **LCD MOSI** | `GP11` | SPI1 TX | -| **LCD MISO** | `GP12` | SPI1 RX | -| **LCD CS** | `GP9` | Display select | -| **LCD DC** | `GP8` | Data/Command | -| **LCD RST** | `GP15` | Display reset | -| **LCD BL** | `GP13` | Backlight (PWM) | -| **Touch CS** | `GP16` | Touch select | -| **Touch IRQ** | `GP17` | Touch interrupt | +| Component | GPIO | Function | +| :------------ | :----- | :-------------- | +| **LCD SCLK** | `GP10` | SPI1 Clock | +| **LCD MOSI** | `GP11` | SPI1 TX | +| **LCD MISO** | `GP12` | SPI1 RX | +| **LCD CS** | `GP9` | Display select | +| **LCD DC** | `GP8` | Data/Command | +| **LCD RST** | `GP15` | Display reset | +| **LCD BL** | `GP13` | Backlight (PWM) | +| **Touch CS** | `GP16` | Touch select | +| **Touch IRQ** | `GP17` | Touch interrupt | All display and touch peripherals share SPI1. @@ -57,13 +57,14 @@ When idle (no input for 60 seconds), the board enters demo mode where two AI pla Accessible from the main menu. All settings are saved to flash (EEPROM) and persist across reboots. -| Setting | Range | Description | -| :------------------- | :------- | :------------------------------------------------- | -| **AI Ply** | 1-10 | Search depth for the AI. Higher = stronger. | -| **Blunder** | ON/OFF | AI randomly picks a bad move at the configured %. | -| **Blunder %** | 5-100% | Chance of a blunder when enabled (step 5). | +| Setting | Range | Description | +| :------------ | :----- | :------------------------------------------------ | +| **AI Ply** | 1-10 | Search depth for the AI. Higher = stronger. | +| **Blunder** | ON/OFF | AI randomly picks a bad move at the configured %. | +| **Blunder %** | 5-100% | Chance of a blunder when enabled (step 5). | Additional options: + - **View Game Log** - Paginated list of all played games (type, level, winner, moves). Player wins highlighted in red. Option to clear the log. - **Recalibrate Touch** - Re-run the two-point touch calibration. @@ -74,6 +75,7 @@ The last 100 games are stored in flash. Each entry records the game type (Yellow ## Touch Calibration On first boot, the display shows a two-point calibration screen (touch top-left, then bottom-right crosshairs). Calibration data is stored in EEPROM. To recalibrate: + - Hold the touchscreen during boot, **or** - Use Settings > Recalibrate Touch. @@ -106,14 +108,14 @@ pio device monitor Configurable parameters defined as `-D` flags in `platformio.ini`: -| Flag | Default | Description | -| :--------------------- | :------ | :------------------------------------------------ | -| `DEFAULT_LOOK_AHEAD` | `8` | Default AI search depth (plies) | -| `DEFAULT_IDLE_TIMEOUT` | `60` | Seconds before demo mode activates | -| `DEMO_RESET_PAUSE` | `20000` | Milliseconds before finished game enters demo | -| `MAX_GAME_LOG` | `100` | Maximum number of games stored in the game log | -| `BLUNDER_ENABLED` | `0` | Default blunder mode (0 = off, 1 = on) | -| `BLUNDER_CHANCE` | `20` | Default blunder chance percentage | +| Flag | Default | Description | +| :--------------------- | :------ | :--------------------------------------------- | +| `DEFAULT_LOOK_AHEAD` | `8` | Default AI search depth (plies) | +| `DEFAULT_IDLE_TIMEOUT` | `60` | Seconds before demo mode activates | +| `DEMO_RESET_PAUSE` | `20000` | Milliseconds before finished game enters demo | +| `MAX_GAME_LOG` | `100` | Maximum number of games stored in the game log | +| `BLUNDER_ENABLED` | `0` | Default blunder mode (0 = off, 1 = on) | +| `BLUNDER_CHANCE` | `20` | Default blunder chance percentage | ## AI