Organize sketches by board and add UNO R4 profile

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
+### Arduino UNO R4 WiFi
-`.ino`-fil skal have samme navn, så projektet kan åbnes direkte i Arduino IDE.
+
+- **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/
+  arduino-uno-r4-wifi/
-    blink.ino
+    led_matrix_demo/
+      led_matrix_demo.ino
 ```
 
-Board-specifik dokumentation, forbindelser og nødvendige biblioteker beskrives
+Hver sketch ligger i sin egen mappe, og mappen og den primære `.ino`-fil har
-i en README ved den enkelte sketch.
+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
+### Arduino UNO R4 WiFi
-- `led_matrix_scrolling_text` – fast løbetekst på matrixen
+
-- `wifi_matrix_message_board` – browserstyret løbetekst via Wi-Fi
+- [`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/<board-id>/` og deres sketches placeres
+under `sketches/<board-id>/`. Board-id skrives med små bogstaver og bindestreger,
+eksempelvis `arduino-uno-r4-wifi`.
 

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)

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
 ```
 

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
 ```
 

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
 ```