PRISM K1 Firmware Specification

What problem does it solve?

This Skill provides the definitive technical blueprint for the PRISM K1 ESP32-S3 LED controller firmware. It eliminates ambiguity for embedded developers, ensuring precise understanding of hardware, memory, FreeRTOS tasks, and communication protocols, which is crucial for custom firmware development or advanced debugging.

Core Features & Use Cases

• Hardware & LED Configuration: Detailed specs for ESP32-S3, 320 WS2812B LEDs, and dual GPIO mapping.
• FreeRTOS Task Management: Understand task priorities, stack sizes, and real-time guarantees for 120 FPS LED refresh.
• WebSocket TLV Protocol: Implement robust communication for pattern uploads with CRC32 validation.
• Use Case: An embedded developer needs to extend the K1's functionality, perhaps by adding new sensor inputs. This Skill provides all the necessary information to safely integrate new features without compromising the core real-time LED playback or existing communication channels.

Quick Start

Example: Connecting from a web editor (PRISM.node)

const ws = new WebSocket('ws://device-ip:8080'); const payload = /* pattern binary data */; const plan = makePutPlan(payload); // See: wsTlv.ts await sendPlanOverWs('ws://device-ip:8080', plan); // Firmware validates CRC32 and stores to /littlefs // LED playback reads pattern and displays at 120 FPS