\defgroup puz puzzle
\brief Puzzle modules

## Arduino-based puzzle modules

> [!NOTE]
> Because of the poorly designed hardware (21-22) used during development
> (23-24), all puzzle modules ended up being developed using Arduino boards.

The Arduino based puzzle modules also use CMake with the
[Arduino-CMake-Toolchain][arduino-cmake]. To build any of these puzzles, make
sure you have done the following:

- Install the official Arduino IDE
- Open "Tools" > "Board" > "Board manager"
- Install the "Arduino AVR Boards" package (1.8.6 works at the time of writing)

Some puzzle modules also require installing libraries through the Arduino
library manager. Dependencies for specific puzzle modules are detailed on their
Doxygen pages.

### Flashing

```
$ ninja -C build upload
```

<!--

## ESP-based puzzle modules

### ESP-IDF SDK Setup instructions

1. Install ESP-IDF extension in Visual Studio Code
2. Install using 'express' option
3. Install ESP-IDF v5.2.1 (release version)

   Additional help:
   - [For windows](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/windows-setup.html#get-started-windows-first-steps)
   - [For Linux](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/linux-macos-setup.html#get-started-linux-macos-first-steps)

-->

[arduino-cmake]: https://github.com/a9183756-gh/Arduino-CMake-Toolchain