Repository navigation
PanelOS 0.0.1
First version.
System
- Mainline Linux kernel (7.3) trimmed to the board (17.8 MB Image) and a Buildroot root filesystem as initramfs, in the panel's recovery partition; the stock firmware and U-Boot stay untouched.
- Kernel patches: a panel descriptor for the Sitronix ST7701S display and CST226SE support in the Hynitron touch driver. Wi-Fi with rtw88 (RTL8723DS), audio through the RK809 codec, the PDM microphones, light and proximity sensor (STK3310).
- Default boot into PanelOS through the stock U-Boot's bootloader message (
nspanel-bootmode open | android | status); one-shot test boots that fall back to the stock firmware without network (S41testboot). - Settings, Wi-Fi configuration and the Home Assistant login on a persistent partition; Wi-Fi recovery by rebinding the SDIO controller.
- Boot animation from the first second of user space (
tools/splash/,nspanel-splash), with a light band until Wi-Fi is up; the UI comes as soon as Wi-Fi is up.
Panel app (Rust + Slint, drawn straight to DRM/KMS)
- Native Home Assistant dashboard from a dashboard chosen for the panel: tiles, entities, headings, thermostat, media control, camera, weather, glance and gauge cards; tabs for several views; live states for exactly the dashboard's entities; dashboard edits appear at once.
- Control by tap; details layers for lights (brightness, colour temperature, colour), shutters, climate and media.
- Camera snapshots through Home Assistant, about 1 frame/s, full screen on tap.
- Pairing by QR code (Home Assistant's own login, OAuth), no token typing.
- Themes (dark, light, auto), settings screen, screensaver (clock or screen off), automatic brightness from the light sensor, wake on approach.
- Assistant mode: smart-display home screen with clock, weather and forecast, media card and quick tiles; weather, media, conversation, message and camera layers.
Voice satellite (ESPHome native API)
- On-device wake words (microWakeWord: Okay Nabu, Hey Jarvis, Hey Mycroft, Alexa and experimental ones), selectable from Home Assistant; an internal "stop" model while the panel speaks or a timer rings.
- Assist pipelines, echo cancellation (WebRTC AEC3) while the speaker plays, so the wake word works during an answer too.
- Follow-up listening; an empty follow-up ends after 5 s.
- Timers with a full-screen alarm (stopped by "stop" or a short sentence without the wake word), announcements, volume and microphone mute.
Home Assistant
- The panel is an ESPHome device for Home Assistant's built-in integration: settings and sensors as entities (screen, dashboard, theme, brightness, volume, illuminance, SoC temperature, Wi-Fi signal, presence and more).
- Optional integration
custom_components/nspanel_pro(Home Assistant Marketplace, HACS or manual): assistant mode settings,show_viewandshow_messageactions.
Install and tools
- Install over Wi-Fi ADB from the rooted stock firmware, no opening the case (
tools/flash_recovery_adb.sh); updates from a running PanelOS over SSH (tools/flash_recovery_ssh.sh). - Backup of all stock partitions (
tools/backup_partitions.sh) and restore paths, including the USB rescue mode (docs/restore.md). - Step-by-step install guide for Windows (WSL), Linux and Mac (
docs/install.md).