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.