# IDEA.md – en egen infotavla på e-ink Det här är en fristående uppdragsbeskrivning. Ge den i sin helhet till Claude Code (eller ett liknande verktyg) för att bygga en egen implementation. Den bygger på Paper Mono, egna appar till M5Stacks e-ink-kort Paper Mono, designade i Claude Design och byggda med Claude Code. ## 1. Vad som ska byggas En liten infotavla hemma på ett e-ink-kort med batteri: klocka, väder, avgångar, inköpslista och fler appar på en skärm som drar lite ström och alltid syns. Tre delar: - **Programmet på kortet** (Arduino/C++): hämtar vad det ska visa, ritar, sover. Klockan tickar lokalt. Appväljare på kortet. - **En hubb** (server): hämtar och förenklar data – väder, avgångar, kalender, nyheter – och ger varje kort dess app, inställningar och data. - **En admin** (webb): välja app och ställa in varje kort, med en förhandsvisning som är exakt det kortet visar. Appar i Paper Mono: klocka (med äggklocka), inköpslista, väder, kalender (ICS), avgångar, meddelandetavla, nyheter (RSS), nedräkning, gäst-wifi med QR-kod, sol och måne, och meddelanden mellan kort över LoRa-radio. **Inte**: firmware som uppdateras trådlöst, fler användare med roller. ## 2. Stack och arkitektur Det som **spelar roll** är markerat; resten går att byta. - **Kortet**: M5Stack Paper Mono (ESP32-S3, 8 MB PSRAM, 480 × 800 e-ink med fyra gråskalor, pekskärm, batteri). Arduino-kärnan och M5Unified/M5GFX. Kompilera och ladda upp med `arduino-cli`. - **Viktigt: en portabel ritkärna i C++** som ritar alla appar till en 1-bitsbuffert och kompileras på tre sätt: för kortet, till **WebAssembly** för adminens förhandsvisning och för datorn för tester. Samma kod ger samma pixlar. Ingen Arduino-kod i kärnan. - **Indata till kärnan är JSON**: app, variant, status, batteri, tid, tidszon och appens data. Demodata hör hemma på servern, inte i kärnan. - **Hubben**: PHP och MariaDB. Kortet hämtar sitt läge med ETag/304, så att inget skickas när inget ändrats. Hubben hämtar från SMHI, Trafiklab, ICS och RSS och cachar. - **Admin**: React och Vite, med kärnan som WebAssembly för alla förhandsvisningar. Inga externa anrop – typsnitten ligger lokalt. ## 3. Beslut som visade sig avgörande **Design först, med en referensrenderare.** Låt designverktyget rita skärmarna med en renderare i JavaScript, och porta den rad för rad till C++. Efterlikna JavaScript exakt: koordinater som `double`, avrundning som `Math.round`, heltalsomvandling som `|0`, text räknad i tecken, stabil sortering. **Ett facit ur designen.** Kör designens renderare i en riktig webbläsare och spara exakta bildbuffertar för varje skärm (65 i Paper Mono). Kärnan ska ge alla rätt, både på datorn och som WebAssembly, efter varje ändring. Typsnitt och ikoner genereras ur samma uttag. **Kortet sover lätt mellan hämtningarna**, och klockan ritas från kortets egen klocka. Hur ofta kortet hämtar väljs per kort i admin. **Inga hemligheter i programmet.** Samma program på alla kort: kortet slumpar en egen nyckel och parkopplas genom att en kod på skärmen jämförs i admin. Wifi och hubbens adress ställs in med mobilen via en QR-kod och en portal på kortet. **Batteriet syns.** Logg per timme, uppskattad batteritid per app, lysdioden visar nivån, och ett mejl med en bild av skärmen när det är dags att ladda. ## 4. Fallgropar - **Rita alltid inom en transaktion** (`startWrite()`/`endWrite()`). Annars uppdaterar grafikbiblioteket e-ink-skärmen efter varje ritanrop, och en bild med tio delar blinkar tio gånger. - **Pekskärmen kan vara vriden.** I M5GFX 0.2.30 räknas pekskärmens koordinater om fast de redan stämmer med bilden. Rätta efter `M5.begin()`, och testa pekskärmen efter varje uppdatering av biblioteket. - **Starten tar 14,5 s med standardinställningar** – tre fulla rensningar av skärmen. Med `clear_display = false` och snabbaste läget för första bilden tar det 4 s. - **Välj uppdateringsläge efter syfte**: kvalitetsläget (3,45 s, blinkar) då och då för att rensa spökbilder, snabbaste läget (79–167 ms) för interaktion. - **Serieporten verkar död** i början eftersom starten tar lång tid, och `arduino-cli monitor` skriver ingenting från WSL. Läs porten på annat sätt (till exempel via PowerShell i UTF-8) och vänta längre. - **Testa sömn och batteri utan USB-kabel.** Med kabeln i vaknar ESP32-S3 ibland aldrig ur lätt sömn. - **Typsnitt utan å, ä, ö.** Kontrollera att typsnittet har svenska tecken. - **Använd inte namn som `min`, `max` eller `PI` i kärnan** – de är makron på kortet. - **Under WSL bevakas inte filändringar på en Windows-disk.** Låt utvecklingsservern polla. ## 5. Krav och mätningar - Från start till första bilden: runt 4 s. - Vaken runt 2 s per hämtning (wifi ungefär 1,1 s, HTTPS ungefär 0,6 s). - Batteri: stabilt 10–11 dygn per laddning i de senaste mätningarna; målet är 14 dagar. - Facit: alla skärmar rätt, 0 fel. ## 6. Så verifieras det - Kärnans facittest på datorn och som WebAssembly efter varje ändring i kärnan. - Kompilering och uppladdning till kortet, och provkörning på kortet av en människa. - Mätningar på hårdvaran för sömn, vakentid och batteri – utan kabel. - Admin i en riktig webbläsare. ## 7. Arbetssätt - **Faser**: först en spik som provar planens största osäkerhet på hårdvaran (lätt sömn, wifi, HTTPS, batteri), sedan ritkärnan, servern och firmwareklienten, admin, apparna och driftsättningen. - **Skriv ner lärdomarna** om hårdvaran och biblioteken i projektets instruktioner, så att de inte upptäcks igen. - **Ett ärende i taget**, med mätningen i den avslutande kommentaren. ## 8. Prompten > Bygg en infotavla för [M5Stack Paper Mono] med [klocka, väder, avgångar och inköpslista]: ett program på kortet som hämtar, ritar och sover, en hubb i [PHP och MariaDB] som hämtar datan, och en admin i [React] med en förhandsvisning som är exakt det kortet visar. > > Läs hela IDEA.md nedan först. > > Arbeta så här: > 1. Börja med en spik på hårdvaran: lätt sömn, wifi, HTTPS och batteri. Mät innan något annat byggs. > 2. Skriv en portabel ritkärna i C++ som kompileras för kortet, till WebAssembly och för datorn, och testa den mot ett facit. > 3. Låt mig provköra på kortet, och skriv ner varje lärdom om hårdvaran. > > [klistra in IDEA.md här]