Board Contact
Confirm that your debug probe and USB-to-UART adapter are visible before building firmware.
lsusb
Each color block is one learning example. Start with board contact, then move through flash, serial output, LED timing, the CleverOS scheduler, queue messaging, and the browser viewer.
These examples are the current LPCXpresso51U68 bring-up path. Open any card to see the expected result, commands, and a direct code download.
Confirm that your debug probe and USB-to-UART adapter are visible before building firmware.
lsusb
Build and flash the smallest firmware first, proving startup, linker script, vector checksum, and probe path.
make -C firmware/lpc51u68_minimal clean all
Initialize the board serial port and print a repeating counter through a USB-to-UART adapter.
make -C firmware/lpc51u68_uart clean all
Cycle the LPCXpresso51U68 D2 RGB LED while printing each state over the serial debug channel.
make -C firmware/lpc51u68_gpio_blink clean all
Use the millisecond SysTick to schedule periodic serial reports without a busy delay loop.
make -C firmware/lpc51u68_systick_uart clean all
Start the CleverOS runtime with two tasks, SysTick, PendSV context switching, LED output, and serial logs.
make -C firmware/lpc51u68_cleveros_boot clean all
Demonstrate two readable RTOS tasks: one reports over serial, while one changes the LED state.
make -C firmware/lpc51u68_cleveros_boot clean all
Run producer and consumer tasks that exchange timestamped messages through a bounded queue.
make -C firmware/lpc51u68_cleveros_queue_demo clean all
Serve a small local browser page that tails the serial adapter and keeps demo logs readable.
python3 -m pip install pyserial
The queue demo is the first feature-oriented demonstration because it proves task communication, critical sections, runtime timing, UART telemetry, and LED output in one compact example.
make -C firmware/lpc51u68_cleveros_queue_demo clean all make -C firmware/lpc51u68_cleveros_queue_demo flash make -C firmware/lpc51u68_cleveros_queue_demo verify flash queue prod tick 0x00004944 0x00000024 0x00000001 queue cons tick 0x00004996 msg 0x00000024 age 0x00000052 depth 0x00000001 led red
These pages are prepared as scaffolds so the next CleverOS features can be documented with the same result-and-download structure.
Fill task stacks with a known pattern, measure high-water marks, and report margin over serial.
make -C firmware/lpc51u68_cleveros_stack_demo clean all
Track idle time and task activity so CPU load trends can be observed while demos run.
make -C firmware/lpc51u68_cleveros_load_demo clean all
Demonstrate allocation accounting and leak reporting hooks for future product firmware.
make -C firmware/lpc51u68_cleveros_alloc_demo clean all