Greenfield bare-metal firmware for a Pi Zero that lights a WS2812B strip above an 88-key keybed. The Pi is a USB MIDI gadget; the PC is the host and owns the piano connection and everything else. No network stack, no filesystem, no shell. Circle is a submodule pinned to Step51. Builds kernel.img (RASPPI=1, Zero / Zero W) and kernel7.img (RASPPI=2, Zero 2 / Zero 2 W); both coexist on one card, so either model runs from the same SD. Resolves two open assumptions from the plan against the Circle sources rather than by guessing: - CWS28XXStripe clocks the waveform out over SPI at a fixed 6.4MHz, one SPI byte per LED bit. On device 0 that puts data on MOSI = GPIO10 = physical pin 19. The implied 5.28ms frame time matches the plan's arithmetic. - The USB gadget lifecycle follows sample/29-miniorgan, which already carries a USB_GADGET_MODE path. Three details the hardware forces: - The gadget destroys and recreates its CUSBMIDIDevice across a USB suspend, so the kernel re-fetches it and clears notes held at that moment. Otherwise a chord would stay lit forever when the PC sleeps. - Rendering blocks for ~5.3ms of SPI traffic, so the MIDI packet handler only records state and the main loop draws. - MAX_LIT_KEYS complements the global brightness ceiling. 176 LEDs at full white would draw ~10.5A against a 6A supply; together the two clamps make that unreachable rather than merely unlikely. Every Phase 0 product decision has a named slot in firmware/config.h, all overridable at build time via EXTRADEFINE. tests/run.sh compiles the real pianoleds.cpp against stubbed Circle headers and checks the mapping, note-off paths, range clamping and both power clamps across nine configuration variants. It verifies arithmetic, not wiring, and does not replace bench-testing on real hardware. Claude-Session: https://claude.ai/code/session_01TVCB25LBsmeteWvaSMz4Ne
60 lines
1.1 KiB
C++
60 lines
1.1 KiB
C++
//
|
|
// kernel.h
|
|
//
|
|
#ifndef _kernel_h
|
|
#define _kernel_h
|
|
|
|
#include <circle/actled.h>
|
|
#include <circle/koptions.h>
|
|
#include <circle/devicenameservice.h>
|
|
#include <circle/serial.h>
|
|
#include <circle/exceptionhandler.h>
|
|
#include <circle/interrupt.h>
|
|
#include <circle/timer.h>
|
|
#include <circle/logger.h>
|
|
#include <circle/types.h>
|
|
#include <circle/usb/usbcontroller.h>
|
|
#include <circle/usb/usbmidi.h>
|
|
#include "pianoleds.h"
|
|
|
|
enum TShutdownMode
|
|
{
|
|
ShutdownNone,
|
|
ShutdownHalt,
|
|
ShutdownReboot
|
|
};
|
|
|
|
class CKernel
|
|
{
|
|
public:
|
|
CKernel (void);
|
|
~CKernel (void);
|
|
|
|
boolean Initialize (void);
|
|
|
|
TShutdownMode Run (void);
|
|
|
|
private:
|
|
// Pick up the MIDI device after the host has enumerated us, and again
|
|
// after every re-enumeration.
|
|
void UpdateMIDIDevice (void);
|
|
|
|
private:
|
|
// do not change this order
|
|
CActLED m_ActLED;
|
|
CKernelOptions m_Options;
|
|
CDeviceNameService m_DeviceNameService;
|
|
CSerialDevice m_Serial;
|
|
CExceptionHandler m_ExceptionHandler;
|
|
CInterruptSystem m_Interrupt;
|
|
CTimer m_Timer;
|
|
CLogger m_Logger;
|
|
|
|
CUSBController *m_pUSB;
|
|
CUSBMIDIDevice *m_pMIDIDevice;
|
|
|
|
CPianoLEDs m_PianoLEDs;
|
|
};
|
|
|
|
#endif
|