Hardware Deployment Plan


1. Raspberry Pi Setup

Use a Raspberry Pi 4 or Zero 2 W. Install Raspberry Pi OS Lite (64-bit). The Lite version ensures no desktop environment interrupts our precise LED timings.

2. GPIO Connections

Connect the WS2812B Data line to GPIO 18 (Pin 12). This pin supports Hardware PWM, which is mandatory for the 800kbps strict timing.
Note: Use a 3.3V to 5V logic level shifter (like 74AHCT125) to prevent LED flickering.

3. LED Control Software

Install the rpi_ws281x library (available for Python and Node.js). This library bypasses the Linux kernel scheduler to directly access the PWM peripheral via DMA (Direct Memory Access), ensuring our 0s and 1s hit the nanosecond requirements visualized in the ticker above.

4. Captive Portal Setup

Use hostapd to turn the Pi into a Wi-Fi hotspot and dnsmasq to route all DNS requests to the Pi's IP address. Serve this exact HTML/JS/CSS bundle via a lightweight HTTP server (like Nginx or Express).

5. AI Assistance with Gemini CLI

For on-device AI debugging during hardware wiring and software deployment, install the Gemini CLI directly on the Pi:

npm install -g @google/gemini-cli

Use it to instantly troubleshoot Python library errors, write animation algorithms, or configure hostapd network interfaces without leaving the terminal.