You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"title": "Arduino Programs Guide: safety-first compile-checked Arduino Uno course",
5
-
"description": "Arduino Programs Guide is a progressive, safety-first Arduino Uno course covering serial commands, LED patterns, PWM motor control, state machines, and emergency-stop behaviour. Each lesson pairs a compile-checked sketch with wiring, safety, test, and extension guidance. Usage: follow the lessons in order, build the documented circuits safely, compile and upload the sketches, and complete each verification checklist. Applications include classroom instruction, introductory embedded systems labs, supervised motor-control exercises, and independent Arduino study.",
"description": "<h2>Overview</h2><p><strong>Arduino Programs Guide</strong> is a progressive, safety-first Arduino Uno course covering serial commands, LED patterns, PWM motor control, state machines, and emergency-stop behaviour. Each lesson pairs a compile-checked sketch with wiring, safety, verification, and extension guidance.</p><h2>Learning outcomes</h2><ul><li>Map serial commands to digital outputs and reusable functions.</li><li>Build non-blocking LED patterns with arrays, bit masks, and <code>millis()</code>.</li><li>Drive motors safely with PWM, transistor or H-bridge drivers, and fail-safe stops.</li><li>Integrate analog sensing, emergency override, and telemetry in a supervised capstone.</li></ul><h2>Getting started</h2><ul><li>Read the hardware-safety and getting-started guides.</li><li>Build Exercise A with power disconnected.</li><li>Upload and verify over Serial Monitor before adding Bluetooth.</li><li>Progress through Exercises A to F and complete each checklist.</li></ul><pre><code>arduino-cli compile --fqbn arduino:avr:uno exercises/exercise-a-arrow-controller</code></pre><h2>Quick start</h2><p>Exercise A accepts simple arrow commands at 9600 baud:</p><pre><code>// USB Serial or TTL Bluetooth serial at 9600 baud\n// U D L R C control four LEDs and a clear command</code></pre><h2>Applications</h2><ul><li>Introductory Arduino Uno coursework and maker-space labs.</li><li>Safety-first PWM and H-bridge motor lessons.</li><li>Compile-checked embedded systems instruction.</li><li>Independent practice with serial control and state machines.</li></ul><h2>Compatibility, safety, and limitations</h2><p>The course targets Arduino Uno and the Arduino AVR Boards core. CI compiles every sketch; that is not hardware validation. Never connect a DC motor directly to an Arduino pin. Motor lessons require a suitable driver, flyback protection, an external motor supply, and a shared ground. Other boards may differ in PWM pins, voltage levels, serial ports, or ADC ranges.</p><h2>Documentation</h2><ul><li><a href=\"https://github.com/devkyato/Arduino-Programs-Guide/blob/main/docs/README.md\">Documentation index</a></li><li><a href=\"https://github.com/devkyato/Arduino-Programs-Guide/blob/main/docs/hardware-safety.md\">Hardware safety</a></li><li><a href=\"https://github.com/devkyato/Arduino-Programs-Guide/blob/main/docs/getting-started.md\">Getting started</a></li></ul><h2>Related software</h2><p><a href=\"https://github.com/devkyato/Custom-Arduino-Libraries\">ArduinoPatterns</a> is the companion library for optional non-blocking abstractions after Exercise B.</p><h2>Citation</h2><p>@dev.mako (devkyato). (2026). <strong>Arduino Programs Guide: safety-first compile-checked Arduino Uno course</strong> (Version 1.0.2). Zenodo. <a href=\"https://doi.org/10.5281/zenodo.21853286\">https://doi.org/10.5281/zenodo.21853286</a></p>",
| Prerequisites | Arduino Uno or compatible board, breadboard, LEDs/resistors, and for C–F a motor driver, flyback protection, and separate motor supply |
60
+
| Suggested pacing | one lesson per session for A–B; one to two sessions for each motor lesson |
61
+
| Assessment | require completed wiring checklists, Serial Monitor verification, and a short reflection on safety or non-blocking behaviour |
62
+
| Safety gate | do not begin Exercises C–F until students can explain why motors need drivers and shared ground |
55
63
56
-
The examples target the Arduino Uno and the Arduino AVR Boards core. CI compiles
57
-
every sketch with the official Arduino toolchain. Other boards may use different
58
-
PWM pins, voltage levels, serial ports, or ADC ranges; porting notes are welcome
64
+
## Companion library progression
65
+
66
+
Exercise B teaches non-blocking patterns by hand. After students understand the timing model,
67
+
they can optionally refactor LED banks and timed sequences with
68
+
[ArduinoPatterns](https://github.com/devkyato/Custom-Arduino-Libraries). The course itself remains
69
+
complete without the library.
70
+
71
+
## Applications
72
+
73
+
- Introductory Arduino Uno coursework and maker-space labs.
74
+
- Safety-first PWM and H-bridge motor lessons.
75
+
- Compile-checked embedded systems laboratories.
76
+
- Independent practice with serial, state machines, and digital outputs.
77
+
78
+
## Compatibility and limitations
79
+
80
+
The examples target the Arduino Uno and the Arduino AVR Boards core. CI compiles every sketch
81
+
with the official Arduino toolchain; that is not hardware validation. Other boards may use
82
+
different PWM pins, voltage levels, serial ports, or ADC ranges. Porting notes are welcome
59
83
only when verified on hardware.
60
84
61
-
## Citation
85
+
## Documentation index
62
86
63
-
If you use this software in research or teaching, please cite the Zenodo archive / this repository:
- Keep Exercises A–B LED-only so students learn serial and timing before power electronics.
27
+
- Gate Exercises C–F on a short safety quiz or checklist review.
28
+
- After Exercise B, introduce [ArduinoPatterns](https://github.com/devkyato/Custom-Arduino-Libraries) as an optional abstraction, not a required dependency.
29
+
- Prefer verification checklists over grading wiring aesthetics; unsafe motor wiring fails the lesson.
30
+
31
+
## Offline archive contents
32
+
33
+
Release ZIP `Arduino-Programs-Guide-1.0.2.zip` includes exercises, extras, docs, citation metadata, changelog, and governance files so the course can be taught without a live GitHub session.
0 commit comments