Support AVR and megaAVR PlatformIO boards

Jackhammer9 · Jackhammer9 · commit 81ce51363240 · 2025-11-12T21:38:15.000+01:00
diff --git a/README.md b/README.md
@@ -94,8 +94,8 @@ Place `target()` **at the very top of your script**, immediately after imports.
 | ---------: | :----: | :----------: | --------------------------------------------------------------------------- |
 |     `port` |  `str` |      —       | Serial port, e.g. `"COM3"` or `"/dev/ttyACM0"`.                             |
 |   `upload` | `bool` |    `True`    | If `True`, compile & upload via PlatformIO. If `False`, only transpile.     |
-| `platform` |  `str` | `"atmelavr"` | PlatformIO platform ID, e.g. `"espressif32"` for ESP32 boards.             |
-|    `board` |  `str` |   `"uno"`    | PlatformIO board ID, e.g. `"esp32dev"`. Must be compatible with `platform`. |
+| `platform` |  `str` | `"atmelavr"` | PlatformIO platform ID. Reduino currently supports `atmelavr` and `atmelmegaavr`. |
+|    `board` |  `str` |   `"uno"`    | PlatformIO board ID. Must be compatible with `platform`. |
 
 **Returns:** `str` of the generated Arduino C++ source.
 
@@ -149,31 +149,30 @@ print(cpp)
 
 ### Targeting different platforms & boards
 
-Reduino validates that the requested PlatformIO platform/board pair is supported. The
-following combinations are available out of the box:
+Reduino validates that the requested PlatformIO platform/board pair is supported.
+At the moment two PlatformIO platforms are available:
 
-| PlatformIO platform | Supported boards                 |
-| ------------------- | -------------------------------- |
-| `atmelavr`          | `uno`, `nano`                     |
-| `atmelsam`          | `due`                             |
-| `espressif32`       | `esp32dev`, `esp32doit-devkit-v1` |
+* `atmelavr` – classic AVR-based boards (Uno, Nano, Leonardo, etc.).
+* `atmelmegaavr` – newer megaAVR devices (Nano Every, Uno WiFi Rev2, Curiosity Nano kits, ...).
 
-If you pick an unsupported board, or a board that does not belong to the selected
-platform, `target()` raises a `ValueError` with a helpful message.
+Every board listed in the [PlatformIO board registry for `atmelavr`](https://docs.platformio.org/en/latest/boards/atmelavr.html)
+and [`atmelmegaavr`](https://docs.platformio.org/en/latest/boards/atmelmegaavr.html) can be targeted. If you choose an
+unsupported board, or one that does not belong to the selected platform, `target()` raises
+a `ValueError` with a helpful message.
 
 ```python
 from Reduino import target
 
-# Build for an ESP32 dev module without uploading automatically.
+# Build for an Arduino Nano Every without uploading automatically.
 target(
     "COM9",
     upload=False,
-    platform="espressif32",
-    board="esp32dev",
+    platform="atmelmegaavr",
+    board="nano_every",
 )
 
-# Build for an Arduino Nano and upload immediately.
-target("/dev/ttyUSB0", platform="atmelavr", board="nano")
+# Build for a classic Arduino Uno and upload immediately.
+target("/dev/ttyUSB0", platform="atmelavr", board="uno")
 ```
 
 > [!IMPORTANT]
diff --git a/src/Reduino/toolchain/pio.py b/src/Reduino/toolchain/pio.py
@@ -5,10 +5,322 @@
 from pathlib import Path
 from typing import Iterable, List
 
+SUPPORTED_ATMELAVR_BOARDS = frozenset(
+    """
+    1284p16m
+    1284p8m
+    168pa16m
+    168pa8m
+    328p16m
+    328p8m
+    32u416m
+    644pa16m
+    644pa8m
+    AT90CAN128
+    AT90CAN32
+    AT90CAN64
+    ATmega128
+    ATmega1280
+    ATmega1281
+    ATmega1284
+    ATmega1284P
+    ATmega16
+    ATmega162
+    ATmega164A
+    ATmega164P
+    ATmega165
+    ATmega165P
+    ATmega168
+    ATmega168P
+    ATmega168PB
+    ATmega169A
+    ATmega169P
+    ATmega2560
+    ATmega2561
+    ATmega32
+    ATmega324A
+    ATmega324P
+    ATmega324PA
+    ATmega324PB
+    ATmega325
+    ATmega3250
+    ATmega3250P
+    ATmega325P
+    ATmega328
+    ATmega328P
+    ATmega328PB
+    ATmega329
+    ATmega3290
+    ATmega3290P
+    ATmega329P
+    ATmega48
+    ATmega48P
+    ATmega48PB
+    ATmega64
+    ATmega640
+    ATmega644A
+    ATmega644P
+    ATmega645
+    ATmega6450
+    ATmega6450P
+    ATmega645P
+    ATmega649
+    ATmega6490
+    ATmega6490P
+    ATmega649P
+    ATmega8
+    ATmega8515
+    ATmega8535
+    ATmega88
+    ATmega88P
+    ATmega88PB
+    LilyPadUSB
+    a-star32U4
+    alorium_hinj
+    alorium_sno
+    alorium_xlr8
+    altair
+    ardhat
+    arduboy
+    arduboy_devkit
+    at90pwm216
+    at90pwm316
+    atmegangatmega168
+    atmegangatmega8
+    attiny13
+    attiny13a
+    attiny1634
+    attiny167
+    attiny2313
+    attiny24
+    attiny25
+    attiny261
+    attiny43
+    attiny4313
+    attiny44
+    attiny441
+    attiny45
+    attiny461
+    attiny48
+    attiny828
+    attiny84
+    attiny841
+    attiny85
+    attiny861
+    attiny87
+    attiny88
+    blend
+    blendmicro16
+    blendmicro8
+    bluefruitmicro
+    bob3
+    btatmega168
+    btatmega328
+    chiwawa
+    circuitplay_classic
+    controllino_maxi
+    controllino_maxi_automation
+    controllino_mega
+    controllino_mini
+    diecimilaatmega168
+    diecimilaatmega328
+    digispark-pro
+    digispark-pro32
+    digispark-pro64
+    digispark-tiny
+    dwenguino
+    elektor_uno_r4
+    emonpi
+    engduinov3
+    esplora
+    ethernet
+    feather328p
+    feather32u4
+    fio
+    flora8
+    ftduino
+    fysetc_f6_13
+    gemma
+    itsybitsy32u4_3V
+    itsybitsy32u4_5V
+    leonardo
+    leonardoeth
+    lightblue-bean
+    lightblue-beanplus
+    lightup
+    lilypadatmega168
+    lilypadatmega328
+    lora32u4II
+    mayfly
+    megaADK
+    megaatmega1280
+    megaatmega2560
+    metro
+    micro
+    mightyhat
+    miniatmega168
+    miniatmega328
+    miniwireless
+    moteino
+    moteino8mhz
+    moteinomega
+    nanoatmega168
+    nanoatmega328
+    nanoatmega328new
+    nibo2
+    nibobee
+    nibobee_1284
+    niboburger
+    niboburger_1284
+    one
+    panStampAVR
+    pinoccio
+    pro16MHzatmega168
+    pro16MHzatmega328
+    pro8MHzatmega168
+    pro8MHzatmega328
+    protrinket3
+    protrinket3ftdi
+    protrinket5
+    protrinket5ftdi
+    prusa_mm_control
+    prusa_rambo
+    quirkbot
+    raspduino
+    reprap_rambo
+    robotControl
+    robotMotor
+    sanguino_atmega1284_8m
+    sanguino_atmega1284p
+    sanguino_atmega644
+    sanguino_atmega644_8m
+    sanguino_atmega644p
+    sanguino_atmega644p_8m
+    seeeduino
+    sleepypi
+    smart7688
+    sodaq_galora
+    sodaq_mbili
+    sodaq_moja
+    sodaq_ndogo
+    sodaq_tatu
+    sparkfun_digitalsandbox
+    sparkfun_fiov3
+    sparkfun_makeymakey
+    sparkfun_megamini
+    sparkfun_megapro16MHz
+    sparkfun_megapro8MHz
+    sparkfun_promicro16
+    sparkfun_promicro8
+    sparkfun_qduinomini
+    sparkfun_redboard
+    sparkfun_satmega128rfa1
+    sparkfun_serial7seg
+    the_things_uno
+    tinyduino
+    tinylily
+    trinket3
+    trinket5
+    uno
+    uno_mini
+    usbasp
+    uview
+    whispernode
+    wildfirev2
+    wildfirev3
+    yun
+    yunmini
+    zumbt328
+    """.split()
+)
+
+SUPPORTED_ATMELMEGAAVR_BOARDS = frozenset(
+    """
+    ATmega1608
+    ATmega1609
+    ATmega3208
+    ATmega3209
+    ATmega4808
+    ATmega4809
+    ATmega808
+    ATmega809
+    ATtiny1604
+    ATtiny1606
+    ATtiny1607
+    ATtiny1614
+    ATtiny1616
+    ATtiny1617
+    ATtiny1624
+    ATtiny1626
+    ATtiny1627
+    ATtiny202
+    ATtiny204
+    ATtiny212
+    ATtiny214
+    ATtiny3216
+    ATtiny3217
+    ATtiny3224
+    ATtiny3226
+    ATtiny3227
+    ATtiny402
+    ATtiny404
+    ATtiny406
+    ATtiny412
+    ATtiny414
+    ATtiny416
+    ATtiny417
+    ATtiny424
+    ATtiny426
+    ATtiny427
+    ATtiny804
+    ATtiny806
+    ATtiny807
+    ATtiny814
+    ATtiny816
+    ATtiny817
+    ATtiny824
+    ATtiny826
+    ATtiny827
+    AVR128DA28
+    AVR128DA32
+    AVR128DA48
+    AVR128DA64
+    AVR128DB28
+    AVR128DB32
+    AVR128DB48
+    AVR128DB64
+    AVR32DA28
+    AVR32DA32
+    AVR32DA48
+    AVR32DB28
+    AVR32DB32
+    AVR32DB48
+    AVR64DA28
+    AVR64DA32
+    AVR64DA48
+    AVR64DA64
+    AVR64DB28
+    AVR64DB32
+    AVR64DB48
+    AVR64DB64
+    AVR64DD14
+    AVR64DD20
+    AVR64DD28
+    AVR64DD32
+    avr_iot_wg
+    curiosity_nano_4809
+    curiosity_nano_da
+    curiosity_nano_db
+    nano_every
+    uno_wifi_rev2
+    xplained_nano_416
+    xplained_pro_4809
+    """.split()
+)
+
 SUPPORTED_PLATFORMS: dict[str, set[str]] = {
-    "atmelavr": {"uno", "nano"},
-    "atmelsam": {"due"},
-    "espressif32": {"esp32dev", "esp32doit-devkit-v1"},
+    "atmelavr": SUPPORTED_ATMELAVR_BOARDS,
+    "atmelmegaavr": SUPPORTED_ATMELMEGAAVR_BOARDS,
 }
 
 BOARD_TO_PLATFORM = {
@@ -65,9 +377,10 @@ def validate_platform_board(platform: str, board: str) -> None:
         )
 
     if board not in BOARD_TO_PLATFORM:
-        supported = ", ".join(sorted(BOARD_TO_PLATFORM))
         raise ValueError(
-            f"Unsupported PlatformIO board '{board}'. Supported boards: {supported}."
+            f"Unsupported PlatformIO board '{board}'. Supported boards for the AVR platforms "
+            "are listed at https://docs.platformio.org/en/latest/boards/atmelavr.html "
+            "and https://docs.platformio.org/en/latest/boards/atmelmegaavr.html."
         )
 
     required_platform = BOARD_TO_PLATFORM[board]
diff --git a/tests/test_toolchain.py b/tests/test_toolchain.py
