diff --git a/README.md b/README.md index f7ec98c..8c26a50 100644 --- a/README.md +++ b/README.md @@ -1,24 +1,59 @@ # Arduino Playground -En samling af Arduino-sketches til forskellige boards og små hardwareforsøg. +En samling af Arduino-sketches, eksperimenter og profiler til forskellige +boards. -## Struktur +## Mine boards -Hver sketch placeres i sin egen mappe under `sketches/`. Mappen og den primære -`.ino`-fil skal have samme navn, så projektet kan åbnes direkte i Arduino IDE. +### Arduino UNO R4 WiFi + +- **Primær MCU:** Renesas RA4M1, 48 MHz Arm Cortex-M4 +- **Trådløs MCU:** ESP32-S3-MINI-1-N8 +- **Hukommelse:** 256 KB flash, 32 KB SRAM og 8 KB data flash +- **Logikniveau:** 5 V på RA4M1-I/O; Qwiic og ESP32-S3 bruger 3,3 V +- **Trådløst:** Wi-Fi 4 på 2,4 GHz og Bluetooth 5 Low Energy +- **Onboard:** 12×8 rød LED-matrix, RTC, 14-bit ADC, 12-bit DAC på A0, + OPAMP, USB HID og Qwiic-stik +- **Interfaces:** GPIO, PWM, UART, I²C, SPI, CAN og USB-C +- **Sensorer:** ingen dedikerede miljø- eller bevægelsessensorer; MCU'en har + intern chiptemperaturmåling og kapacitiv touch-hardware +- **Arduino CLI FQBN:** `arduino:renesas_uno:unor4wifi` + +Detaljer, identifikation og links findes i +[`boards/arduino-uno-r4-wifi`](boards/arduino-uno-r4-wifi/README.md). + +## Projektstruktur + +Boards og sketches bruger samme stabile board-id: ```text +boards/ + arduino-uno-r4-wifi/ + README.md sketches/ - blink/ - blink.ino + arduino-uno-r4-wifi/ + led_matrix_demo/ + led_matrix_demo.ino ``` -Board-specifik dokumentation, forbindelser og nødvendige biblioteker beskrives -i en README ved den enkelte sketch. +Hver sketch ligger i sin egen mappe, og mappen og den primære `.ino`-fil har +samme navn, så den kan åbnes direkte i Arduino IDE. Board-specifik +dokumentation, forbindelser og biblioteker beskrives ved den enkelte sketch. ## Sketches -- `led_matrix_demo` – animationer til UNO R4 WiFi-matrixen -- `led_matrix_scrolling_text` – fast løbetekst på matrixen -- `wifi_matrix_message_board` – browserstyret løbetekst via Wi-Fi +### Arduino UNO R4 WiFi + +- [`led_matrix_demo`](sketches/arduino-uno-r4-wifi/led_matrix_demo) – animationer + til den indbyggede LED-matrix +- [`led_matrix_scrolling_text`](sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text) + – fast løbetekst på matrixen +- [`wifi_matrix_message_board`](sketches/arduino-uno-r4-wifi/wifi_matrix_message_board) + – browserstyret løbetekst via Wi-Fi + +## Tilføjelse af flere boards + +Nye boards får en profil under `boards//` og deres sketches placeres +under `sketches//`. Board-id skrives med små bogstaver og bindestreger, +eksempelvis `arduino-uno-r4-wifi`. diff --git a/boards/arduino-uno-r4-wifi/README.md b/boards/arduino-uno-r4-wifi/README.md new file mode 100644 index 0000000..9a0331f --- /dev/null +++ b/boards/arduino-uno-r4-wifi/README.md @@ -0,0 +1,61 @@ +# Arduino UNO R4 WiFi + +## Identifikation + +| Felt | Værdi | +| --- | --- | +| Producent | Arduino | +| Model | UNO R4 WiFi | +| Primær MCU | Renesas R7FA4M1AB3CFM (RA4M1) | +| Trådløs MCU | ESP32-S3-MINI-1-N8 | +| Arduino CLI FQBN | `arduino:renesas_uno:unor4wifi` | +| Normal USB-ID | `VID 2341 / PID 1002` | +| USB-bootloader-ID | `VID 2341 / PID 006D` | + +## Out-of-the-box + +Boardet kan bruges uden ekstra komponenter til: + +- grafik, animationer og løbetekst på den indbyggede 12×8 LED-matrix; +- Wi-Fi-klient, access point, webserver, HTTPS, MQTT, UDP og NTP; +- Bluetooth Low Energy som peripheral eller central; +- real-time clock og alarmer; +- USB-mus og -tastaturemulering; +- analog måling via 14-bit ADC; +- analog spændingsgenerering via 12-bit DAC på A0; +- signalbehandling med den indbyggede operationsforstærker; +- CAN-kommunikation med en ekstern CAN-transceiver. + +Boardet har ingen dedikeret accelerometer-, gyroskop-, lys-, fugt-, tryk- eller +rumtemperatursensor. RA4M1 har en intern temperatursensor til chiptemperatur og +kapacitiv touch-hardware, men ingen færdige touchflader på selve boardet. + +## Elektriske hoveddata + +| Egenskab | Værdi | +| --- | --- | +| RA4M1 clock | 48 MHz | +| Flash | 256 KB | +| SRAM | 32 KB | +| Data flash | 8 KB | +| GPIO-logik | 5 V | +| Forsyning via USB-C | 5 V | +| VIN / DC-jack | 6–24 V | +| Wi-Fi | 802.11 b/g/n, 2,4 GHz | +| Bluetooth | Bluetooth 5 Low Energy | +| Matrix | 12×8 røde LEDs | +| Qwiic | 3,3 V I²C | + +## Sketches i dette repo + +- [`led_matrix_demo`](../../sketches/arduino-uno-r4-wifi/led_matrix_demo) +- [`led_matrix_scrolling_text`](../../sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text) +- [`wifi_matrix_message_board`](../../sketches/arduino-uno-r4-wifi/wifi_matrix_message_board) + +## Kilder + +- [Arduino UNO R4 WiFi hardware documentation](https://docs.arduino.cc/hardware/uno-r4-wifi/) +- [Arduino UNO R4 WiFi datasheet](https://docs.arduino.cc/resources/datasheets/ABX00087-datasheet.pdf) +- [Arduino UNO R4 WiFi network examples](https://docs.arduino.cc/tutorials/uno-r4-wifi/wifi-examples) +- [ArduinoCore-renesas](https://github.com/arduino/ArduinoCore-renesas) +- [Renesas RA4M1 product information](https://www.renesas.com/en/products/ra4m1/part-details/r7fa4m1ab3cfm-aa0) diff --git a/sketches/led_matrix_demo/README.md b/sketches/arduino-uno-r4-wifi/led_matrix_demo/README.md similarity index 88% rename from sketches/led_matrix_demo/README.md rename to sketches/arduino-uno-r4-wifi/led_matrix_demo/README.md index 8fb4ee6..b49faee 100644 --- a/sketches/led_matrix_demo/README.md +++ b/sketches/arduino-uno-r4-wifi/led_matrix_demo/README.md @@ -18,7 +18,7 @@ Der kræves ingen ekstra komponenter eller biblioteker. ## Kompilering ```powershell -arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/led_matrix_demo +arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/arduino-uno-r4-wifi/led_matrix_demo ``` ## Upload @@ -26,6 +26,6 @@ arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/led_matrix_dem Upload først efter godkendelse: ```powershell -arduino-cli upload --port COM5 --fqbn arduino:renesas_uno:unor4wifi sketches/led_matrix_demo +arduino-cli upload --port COM5 --fqbn arduino:renesas_uno:unor4wifi sketches/arduino-uno-r4-wifi/led_matrix_demo ``` diff --git a/sketches/led_matrix_demo/led_matrix_demo.ino b/sketches/arduino-uno-r4-wifi/led_matrix_demo/led_matrix_demo.ino similarity index 100% rename from sketches/led_matrix_demo/led_matrix_demo.ino rename to sketches/arduino-uno-r4-wifi/led_matrix_demo/led_matrix_demo.ino diff --git a/sketches/led_matrix_scrolling_text/README.md b/sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text/README.md similarity index 85% rename from sketches/led_matrix_scrolling_text/README.md rename to sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text/README.md index 2378d45..17aff76 100644 --- a/sketches/led_matrix_scrolling_text/README.md +++ b/sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text/README.md @@ -16,7 +16,7 @@ arduino-cli lib install ArduinoGraphics ## Kompilering ```powershell -arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/led_matrix_scrolling_text +arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text ``` ## Upload @@ -24,6 +24,6 @@ arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/led_matrix_scr Upload først efter godkendelse: ```powershell -arduino-cli upload --port COM5 --fqbn arduino:renesas_uno:unor4wifi sketches/led_matrix_scrolling_text +arduino-cli upload --port COM5 --fqbn arduino:renesas_uno:unor4wifi sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text ``` diff --git a/sketches/led_matrix_scrolling_text/led_matrix_scrolling_text.ino b/sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text/led_matrix_scrolling_text.ino similarity index 100% rename from sketches/led_matrix_scrolling_text/led_matrix_scrolling_text.ino rename to sketches/arduino-uno-r4-wifi/led_matrix_scrolling_text/led_matrix_scrolling_text.ino diff --git a/sketches/wifi_matrix_message_board/README.md b/sketches/arduino-uno-r4-wifi/wifi_matrix_message_board/README.md similarity index 93% rename from sketches/wifi_matrix_message_board/README.md rename to sketches/arduino-uno-r4-wifi/wifi_matrix_message_board/README.md index f62eeda..ffea034 100644 --- a/sketches/wifi_matrix_message_board/README.md +++ b/sketches/arduino-uno-r4-wifi/wifi_matrix_message_board/README.md @@ -42,7 +42,7 @@ arduino-cli lib install ArduinoGraphics ## Kompilering ```powershell -arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/wifi_matrix_message_board +arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/arduino-uno-r4-wifi/wifi_matrix_message_board ``` ## Upload @@ -50,6 +50,6 @@ arduino-cli compile --fqbn arduino:renesas_uno:unor4wifi sketches/wifi_matrix_me Upload først efter godkendelse: ```powershell -arduino-cli upload --port COM5 --fqbn arduino:renesas_uno:unor4wifi sketches/wifi_matrix_message_board +arduino-cli upload --port COM5 --fqbn arduino:renesas_uno:unor4wifi sketches/arduino-uno-r4-wifi/wifi_matrix_message_board ``` diff --git a/sketches/wifi_matrix_message_board/arduino_secrets.example.h b/sketches/arduino-uno-r4-wifi/wifi_matrix_message_board/arduino_secrets.example.h similarity index 100% rename from sketches/wifi_matrix_message_board/arduino_secrets.example.h rename to sketches/arduino-uno-r4-wifi/wifi_matrix_message_board/arduino_secrets.example.h diff --git a/sketches/wifi_matrix_message_board/wifi_matrix_message_board.ino b/sketches/arduino-uno-r4-wifi/wifi_matrix_message_board/wifi_matrix_message_board.ino similarity index 100% rename from sketches/wifi_matrix_message_board/wifi_matrix_message_board.ino rename to sketches/arduino-uno-r4-wifi/wifi_matrix_message_board/wifi_matrix_message_board.ino