# MAR ver 2.1 / MAR Color ver 2.1

## Changes
- Separate builds for standard ESP32-S3 N16R8 + SSD1306 and Waveshare ESP32-S3-LCD-1.47B (USB-C). MAR Color keeps its color display and branding.
- Wi-Fi sleep removed: restored the earlier connection and setup behavior. Wi-Fi stays enabled. Automatic five-minute internet probes and recent experimental recovery changes are removed. Other 2.1 features are retained.
- Weather lookup and forecast run in a worker; location saving reports progress and preserves the old location if it fails.
- All eight Meshtastic channel slots (0–7), optional same-index cross-band forwarding, and optional position, node-info and supported telemetry beacon text summaries. There is no ninth channel slot 8. Configure matching channel keys on both radios; the bridge can only forward decoded packets the radios supply. DMs, MQTT traffic and reactions are not bridged. Beacons are labeled text summaries, not native node/position packets.
- Any punctuation prefix except #; 12 disabled action examples, Enable all / Disable all editor controls, collapsible commands and cross-band sections, and separated Enable/Remove controls. Save changes to apply editor controls. These controls are not unauthenticated remote admin commands.
- Per-radio modem preset reference lists. These labels do not change the radios' actual presets.
- Dashboard login is optional and off by default. Setup Wi-Fi still uses ESP32MESH. If login is enabled, the existing password remains; fresh installs use admin / ESP32MESH.
- Screen brightness/contrast and timeout, BOOT wake, timezone and 12/24-hour time. Internet time synchronization is needed after a cold start.
- PROTO traceroute to a specified node on either connected radio, channel 0–7. The trace action targets the command requester. One request per minute; results depend on radio firmware and route support. A timeout is reported after 60 seconds.
- Node power telemetry uses the reported mA value directly, with one decimal place.
- Primary-channel terminal policy and behavior are preserved.

## Update — keep settings
1. On https://systron.llc/flasher/ choose your board's version 2.1.
2. Connect MAR with a USB data cable. Close other serial applications. Confirm the board type and click Connect & identify; select its COM port.
3. Click Flash update — keep settings. Leave USB connected until verification finishes, then press RESET if needed.
4. Open the MAR dashboard and review Device settings. BOOT reopens setup Wi-Fi when needed.

USB updating accepts the published/recognized MAR builds with the matching partition layout and board family. It replaces both application slots and verifies saved-data areas unchanged. If rejected, nothing is written: do not rename a different board's image. Use full flash only if you accept resetting saved data. Older 2.0 portals may reject the new filenames; use the USB updater for that upgrade.

## Full flash — new installation or clean reset
1. Choose the correct board and version, then Connect & identify.
2. Check the full-erase confirmation and click Full flash — erase settings. Wi-Fi, commands and saved settings are deleted.
3. Keep USB connected until verified. Press RESET if needed and allow several seconds to start.
4. Join MeshAutoResponder-Setup with password ESP32MESH, then open http://192.168.4.1/wifi to save home Wi-Fi. Open http://192.168.4.1/ for the dashboard. Press BOOT to open the setup hotspot.

If the port will not connect: hold BOOT, tap RESET, release BOOT, and select the boot-mode COM port (which may differ). Use desktop Chrome or Edge for USB flashing.

## Hardware
Standard: ESP32-S3 N16R8, radio 1 MAR RX17/TX18; radio 2 RX15/TX16; SSD1306 SDA8/SCL9, RGB48.
MAR Color: Waveshare ESP32-S3-LCD-1.47B, 16 MB flash / 8 MB PSRAM, radio 1 MAR RX6/TX2; radio 2 RX4/TX5; ST7789 MOSI45/SCLK40/CS42/DC41/RST39/BL46, RGB38.
Cross TX to RX, use 3.3V UART logic and common ground. Radio serial is 38400 baud in PROTO mode. Use the verified board power arrangement; do not join USB and node supply outputs together.

## Build and validation
Source and licenses are included. PlatformIO: pio run -e esp32s3-n16r8 -e mar-color-2. Host bridge tests: python tools/test_bridge.py --zig PATH_TO_ZIG.
Both target builds and automated bridge/protocol/weather-UI checks passed. MAR Color was flashed and the user confirmed working connectivity. The standard board build is ready but has not been physically tested with this rollback.
Application-only BINs are for the updater; do not write them at address 0. Full BINs start at 0x0. Partition/app offset is unchanged at 0x10000. Each board's ZIP includes both BINs and corresponding complete source.