Un nœud Linux. Un câble USB. Le cluster entier sur une barre AMOLED.
La Flexbar est une superbe barre tactile AMOLED… livrée avec FlexDesigner, une appli Electron qu'il faut garder ouverte en permanence sur un poste graphique. Frustrant quand on veut juste un écran d'état permanent posé à côté du rack.
Alors on a rétro-conçu son protocole série (USB CDC, en clair) et écrit un démon headless qui la pilote depuis n'importe quel Linux — typiquement un LXC sur le cluster Proxmox qu'elle supervise. Résultat : nœuds, VMs, CPU/RAM, alertes et disque, en temps réel, zéro appli graphique.
🧠 Le firmware d'usine est conservé — on ne fait que parler sa langue.
| 🖥️ Vue cluster | nœuds en ligne · VMs actives · CPU % · RAM % agrégés |
| 📈 Sparklines | historique glissant CPU/RAM en fond de tuile |
| 🚨 Alertes auto | nœud HS + stockage ≥ 80 % / ≥ 90 %, dérivées de l'état réel |
| 🐧 Rotation VMs | LXC/QEMU, templates exclus, CPU/RAM par invité |
| 💾 Disque cluster | espace libre agrégé + jauge d'utilisation |
| 🎨 Style | emojis couleur · police Orbitron · code couleur par seuil |
| 🔌 Résilient | reconnexion auto (la barre se ré-énumère au boot) |
| 🔒 Lecture seule | token PVEAuditor — aucune action possible sur le cluster |
De haut en bas sur l'image = de gauche à droite sur la barre (5 keys) :
| # | Tuile | Contenu |
|---|---|---|
| 0 | 🛡 Marque | logo / wordmark |
| 1 | 🖥 Stats | NODES · VMS · CPU (+ sparkline) · RAM (+ sparkline) |
| 2 | 🚨 Alertes | worst-of du cluster, rotation, ou ✅ OK |
| 3 | 🐧 VMs | rotation sur les invités, nom + CPU/RAM % (ou stoppé) |
| 4 | 💾 Disque | X To libre + jauge d'utilisation |
flowchart LR
PVE["Proxmox API<br/>/cluster/resources"] -->|"token RO"| D
subgraph D["Démon Node.js (headless)"]
direction TB
M["metrics.js<br/>alertes · disque"]
R["render.js<br/>@napi-rs/canvas → PNG RGB"]
P["protocol.js<br/>trame série"]
end
D -->|"USB CDC · 1 PNG / key"| BAR["🟦 Flexbar<br/>ESP32-S3 · AMOLED"]
BAR -.->|"événements tap"| D
Aucune dépendance graphique : @napi-rs/canvas (Skia) génère les PNG côté serveur, le démon les
pousse sur le fil série.
Sur le nœud Linux où la barre est branchée (recette LXC complète + systemd :
daemon/DEPLOY.md) :
# 1) Node 20 + polices — un LXC minimal n'en a AUCUNE (sinon : texte invisible !)
apt-get install -y nodejs fontconfig fonts-liberation fonts-dejavu-core fonts-noto-color-emoji
# 2) Démon
cd daemon && npm install --omit=dev
cp socbar-daemon.config.example.json socbar-daemon.config.json # ← url + token Proxmox
# 3) Go
node daemon.js --demo # données fictives (valide l'affichage)
node daemon.js # données réelles du clusterCrée un token lecture seule : Datacenter → Permissions → API Tokens, rôle PVEAuditor.
Capturé via un shim serialport posé entre FlexDesigner et la barre (flux non chiffré).
Chaque dessin = une trame binaire, puis un PNG brut :
MAGIC (32 o constants) 5a0000a5 a9c4d1f2 … 8c7a2d9f
en-tête (8×uint32 LE) [0x1000, 1, 1, 0, len, len, 0, type] type 8 = données
payload aafcfdfe + jsonLen + binLen + total + <JSON> + <binaire>
JSON {"event":"$plugin-N","data":{"$cmd":"draw"}} ← N = index de la key
binaire \x89PNG … IEND ← PNG RGB aux dims de la key
sequenceDiagram
participant B as Flexbar
participant D as Démon
B->>D: handshake (fixedBar : disposition des keys)
loop toutes les 3 s
D->>B: MAGIC + header + {"$cmd":"draw"} + PNG RGB
Note over B: dessine la key N
end
B-->>D: {"evt":"click", key:{…}} (tap)
Tout est documenté dans PROTOCOL.md ; le codec vit dans
daemon/protocol.js.
PNG RGB, pas RGBA — sinon la barre affiche des rayures
La barre décode le PNG en colortype 2 (RGB). Un PNG RGBA (le défaut de canvas) sort en
zébrures illisibles. daemon/png.js reconvertit explicitement en RGB via pngjs.
Un LXC minimal n'a AUCUNE police — texte invisible, barre « vide »
@napi-rs/canvas dessine les fonds mais pas le texte → PNG ~762 o au lieu de ~7 Ko.
Fix : fonts-liberation fonts-dejavu-core + fc-cache. Diagnostic : fc-list | wc -l == 0.
Emojis couleur : installer la police ne suffit pas
Skia rend des tofu tant que la police n'est pas enregistrée explicitement via
GlobalFonts.registerFromPath(...). La couleur des emojis est intrinsèque (ignore fillStyle).
render.js s'en charge au chargement.
La barre se ré-énumère — le port disparaît à chaque (dé)connexion
Fermer le port série resette l'ESP32 → nouveau /dev/ttyACM*. Le démon se reconnecte tout seul
(auto-détection par VID/PID 303A:82BF). En LXC : passthrough résilient (cf. DEPLOY.md).
Stockage non partagé = un par nœud — dédup par nom = données faussées
Un lvmthin local existe une fois par nœud, avec un usage différent. Déduire par nom seul
masquait le nœud chargé. Clé correcte : nom si partagé, sinon nom@nœud (cf. metrics.js).
daemon/ ⭐ le démon headless (Proxmox → barre) — commence ici
DEPLOY.md recette LXC privilégié + passthrough USB + systemd
render.js widgets → PNG (emoji + Orbitron + sparklines + jauge)
protocol.js codec de la trame série
metrics.js alertes + agrégat disque
proxmox.js client API (token lecture seule)
fonts/ Orbitron (OFL)
backend/ le plugin FlexDesigner d'origine (macOS) → PLUGIN.md
PROTOCOL.md le protocole série rétro-conçu
assets/ captures
- Démon headless pilotant la barre sans FlexDesigner
- Cockpit Proxmox : nœuds, VMs, alertes, disque
- Emojis couleur + police Orbitron + sparklines
- Couleur des sparklines selon le niveau (vert → orange → rouge)
- Drill-down tactile (tap → liste des nœuds / top VMs)
- Rotation « uptime des sites » dans une tuile
- Initialisation autonome de la disposition des keys
- Code sous MIT.
- Police UI Orbitron sous SIL OFL 1.1 (embarquée —
daemon/fonts/README.md). - Zekton (la police d'ENIAC) est commerciale, donc non incluse. Si tu la possèdes, dépose
Zekton.ttfdansdaemon/fonts/et change la famille dansrender.js.
🎨 Pourquoi Orbitron ? (le comparatif)
Zekton étant introuvable/commerciale, plusieurs alternatives libres (OFL) ont été rendues sur la vraie pipeline de la barre avant de trancher :
Projet indépendant, non affilié à ENIAC. Le protocole a été rétro-conçu à des fins d'interopérabilité, sur du matériel possédé, à partir d'un flux non chiffré. Le firmware d'usine n'est ni modifié ni redistribué. Usage responsable.