How sliicy/8x8x8-led works
Project type and purpose
• This is a hardware-integrated desktop application for driving an 8×8×8 LED/RGB cube over USB.
• It consists of:
• A WinForms GUI (8x8x8-LED.WinForm) offering applets (Clock, Pong, Snake, Music Visualizer, etc.).
• Embedded firmware for two microcontroller targets (Monochrome STC12C5A60S2 and RGB GD32F103RETx).
• Mechanical assets (3D-printed parts) and electrical schematics.
File structure
• Top-level directories:
• 3D Printed Parts – Blender and STL files for cube base design.
• 8x8x8-LED.Core – Business logic, data models (Cube, Position, Direction), helpers (ColorHelper, SerialHelper).
• 8x8x8-LED.WinForm – Presentation layer with Views for each applet; uses Core library; manages SerialPort.
• Examples – Sample images/videos demonstrating animations.
• Firmware – Embedded code for Monochrome (C with STC) and RGB (Arduino/STM32) microcontrollers, plus build scripts.
• Schematics – PDFs and datasheets describing the electrical design.
• The solution file (8x8x8-LED.sln) ties together the Core and WinForm projects.
• Configuration files: App.config (WinForms), .csproj files, packages.config, build scripts for firmware.
Extract insights from README
• Key workflows:
• User runs WinForms EXE → configures COM port & cube type → selects mini-applet → backend Core library assembles frame data → SerialHelper dispatches packets over USB→ microcontroller firmware drives LED matrix.
• Separate flash processes needed for firmware builds (STC ISP tool for monochrome, Arduino IDE + STM32CubeProgrammer for RGB).
• Dependencies: .NET Framework (WinForms), C# libraries, Arduino toolchain, STC flashing tool.
• Hardware & mechanical add-ons: 3D-printed cube base, schematics for assembly.
Detail
• Mini-applet as a logical subcomponent under the UI layer.
• Firmware forks (Monochrome vs. RGB) as separate modules with their respective toolchains and protocols (baud rates).
• Don’t omit the 3D-printed base or schematics—they’re part of the system’s deliverables.