portal:komunikace_se_serverem
Komunikace se serverem
Požadavek na server
První požadavek se děje s parametrem "timestamp_check" a případnými naměřenými hodnotami z volitelného čidla teploty/vlhkosti/tlaku. Server vrátí aktuální timestamp obsahu na serveru a pokud je novější než jaký je uložený timestamp v paměti zařízení, tak se stáhne nový obsah. Pro ten se již používají volání bez timestamp_check a naměřených hodnot.
| Parametr | Příklad | Popis |
|---|---|---|
| mac | DA:AB:CA:04:A5:65 | MAC adresa zařízení, která slouží jako jeho identifikátor. |
| timestamp_check | 1 | Parametr se uvádí pouze při prvním připojení kdy se zjišťuje, jestli je na serveru nový obsah. |
| rssi | -51 | Síla signálu na Wi-Fi. |
| ssid | MOJE_APCKO_DOMA | Název AP na které se zařízení připojuje. |
| v | 3.92 | Napětí na baterii. |
| x | 800 | Rozlišení - šířka. |
| y | 480 | Rozlišení - výška. |
| c | 4G | Barevnost ePaperu - viz tabulka níže. |
| fw | 2.3 | Verze FW. |
| ap_retries | 0 | Kolik bylo potřeba pokusů na připojená se k AP (pro pozdější debuging). |
| temp | 21.53 | Teplota. |
| hum | 53 | Vlhkost. |
| pres | 1025 | Tlak. |
Rozlišení a barevnost slouží především k prvotnímu spárování ePaperu, následně se při sestavení vraceného obrázku používá nastavení uvedené u zavedeného zařízení.
| Barevnost | Popis |
|---|---|
| BW | Černá, bílá |
| 4G | Stupně šedi (4 barvy) |
| 8G | Stupně šedi (8 barev) |
| RBW | Tříbarevný s červenou |
| YBW | Tříbarevný se žlutou |
| 4C | Čtyřbarevný (červená a žlutá) |
| 7color | 7 barev |
Odpověď ze serveru
< HTTP/1.1 200 OK < Date: Sat, 24 May 2025 19:16:46 GMT < Server: Apache < Expires: Thu, 19 Nov 1981 08:52:00 GMT < Content-Disposition: attachment; filename=348518974bc0/obrazovka.z2 < Data-Length: 58211 < Content-Description: File Transfer < Sleep: 44 < Timestamp: 05242116 < Connection: close < Content-Type: image/z2
V odpovědi najdeme dvě zásadní informace pro zařízení:
- Sleep - Čas v minutách na jak dlouho chceme zařízení uspat, než se má serveru dotázat pro nová data.
- Timestamp - Časový otisk posledních dat, které má zařízení porovnat s tím již načteným aby vědělo, zda má stahovat a zobrazovat nová data, nebo se jen uspat na dobu, kterou server vrátil v odpovědi.
V hlavičce "Content-Type" je sice uvedené, zda se jedná o formát zX nebo BMP, ale to se v kódu detekuje a řeší načtením prvních bytů z těla odpovědi.