https://wiki.merenienergie.cz/subdom/wiki/api.php?action=feedcontributions&feedformat=atom&user=AdamnSDS: Síťový Dohledový Systém - Příspěvky uživatele [cs]2026-11-03T13:42:05ZPříspěvky uživateleMediaWiki 1.35.1https://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_BIG&diff=991SDS BIG2026-10-31T16:19:41Z<p>Adamn: </p>
<hr />
<div> Tato stránka platí pro SDS Druhé Produktové Řady (viz [[Seznam Všech SDS]])<br />
<br />
== SDS BIG / BIG2 : 64 / 128 / 512 ==<br />
__NOTOC__<br />
* jednodeskový Ethernetový modul - Plug & Play <br />
* komunikace: nativně Ethernet 100 MBit/sec MDI/MDIX <br />
* webové rozhraní<br />
* programovatelnost<br />
* autonomní provoz<br />
* bezpečnost<br />
* výrobek SDS BIG nebo SDS BIG2 - každý s výlučnými subvariantami: 64 / 128 / 512<br />
* a s doplňujícími variantami: +DP, +DS84<br />
* varianta napájení Active PoE IEEE802.3af Class 0<br />
<br />
<br />
Toto SDS je aktuálně v prodeji.<br />
<br />
Původní produkt SDS-BIG byl postupně inovován, a je tedy k dispozici jako SDS-BIG2, který je plně zpětně kompatibilní ve všech vlastnostech, a současně přidává nové.<br />
<br />
<div class="successbox">'''Jak toto SDS koupit ?''' Na oficiálním eShopu '''www.onlinetechnology.cz'''</div><br />
<br />
<br />
== Modul ==<br />
<br />
Modul SDS-BIG, respektive jeho '''aktualizace''' s názvem SDS-BIG2, je k dispozici v DIN plastové krabičce, určené pro montáž do rozvaděče.<br />
<br />
Modul je možné spojit (uvnitř stejné DIN krabičky) se sandwich deskou, a tak rozšířit SDS-BIG o např.: grafický display, klávesnici, DALI sběrnici (master), GSM/LTE modul, LoRA síť, CAN, RS232, M-BUS atd.<br />
<br />
Modul pracuje na základě jednoprocesorového SoC (System on Chip), kde vykonává výrobcem nahraný firmware, a tento firmware dále vykonává uživatelem nahraný program (jazyk FULL-C). Firmware je napsán dle vývojových pravidel pro FW Safety, a je založen na bezpečném (Safety) RTOS.<br />
<br />
Rozlišení BIG a BIG2 lze provést přečtením typu vypsaného ve webovém rozhraní výrobku, nebo prohlédnutím základní desky (potisk):<br />
<br />
SDS-BIG 512 je téměř ve všem cca 3,5x rychlejší než SDS-BIG 128 či 64.<br />
<br />
<br />
<div class="successbox">SDS BIG rev1</div><br />
Základní deska SDS-BIG, bez DIN krabičky (ve které je celý modul umístěn):<br />
<br />
[[Soubor:SDS_BIG_rev1_FULL.jpg]]<br />
<br />
<br><br><br />
<div class="successbox">SDS BIG2 DP</div><br />
Základní deska SDS-BIG2-DP, bez DIN krabičky (ve které je celý modul umístěn):<br />
<br />
[[Soubor:BIG2-DP-rev1-foto.jpg]]<br />
<br />
<br><br><br />
<div class="successbox">SDS BIG2 DP DS84</div><br />
Základní deska SDS-BIG2-DP-DS84, bez DIN krabičky (ve které je celý modul umístěn):<br />
<br />
DOPLNIT OBRÁZEK<br />
<br />
<br><br><br />
<div class="successbox">SDS BIG2 DP DS84 PoE</div><br />
Základní deska SDS-BIG2-DP-DS84-PoE, bez DIN krabičky (ve které je celý modul umístěn):<br />
<br />
DOPLNIT OBRÁZEK<br />
<br />
<br />
== Základní prvky a připojení pro všechny varianty SDS-BIG, BIG2 ==<br />
<br><br><br />
<br />
<div class="successbox">SDS BIG rev1</div><br />
Obrázek znázorňuje základní prvky modulu SDS-BIG rev1:<br />
<br />
[[Soubor:SDS_BIG_rev1_intro.jpg]]<br />
<br />
<br><br><br />
<div class="successbox">SDS BIG2-DP / SDS BIG2-DP-DS84</div><br />
Obrázek znázorňuje základní prvky modulu SDS-BIG2-DP resp. SDS-BIG2-DP-DS84:<br />
<br />
[[Soubor:SDS_BIG2_rev1_intro.png]]<br />
<br />
<br><br><br />
<div class="successbox">SDS BIG2-DP-DS84-PoE</div><br />
Obrázek znázorňuje základní prvky modulu SDS-BIG2-DP-DS84-PoE:<br />
<br />
DOPLNIT OBRÁZEK<br />
<br />
<br />
=== Zapojení svorek a konektorů ===<br />
<br />
Konektor '''SDS-1''':<br />
{| class="filehistory" width="99%"<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''PIN'''<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''Funkce'''<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''Detaily'''<br />
|-<br />
| style="padding: 5px;"| 1<br />
| style="padding: 5px;"| RS485 A+<br />
| style="padding: 5px;"| Datový vodič sběrnice RS485 (viz [[SDS_BIG:_RS485|návod]])<br />
|-<br />
| style="padding: 5px;"| 1<br />
| style="padding: 5px;"| RS485 B-<br />
| style="padding: 5px;"| Datový vodič sběrnice RS485 (viz [[SDS_BIG:_RS485|návod]]),<br> '''pozor, BIG vždy vyžaduje externí rezistor na RS845-BUS-GND'''<br> (ale to už neplatí pro BIG2)<br />
|-<br />
| style="padding: 5px;"| 3<br />
| style="padding: 5px;"| RS485 BUS GND (bus ground)<br />
| style="padding: 5px;"| Společný nulový vodič (pozor: GND, nikoliv PE !) sběrnice RS485 - použijte pro vzájemné propojení zařízení na vaší sběrnici<br />
|-<br />
| style="padding: 5px;"| 4<br />
| style="padding: 5px;"| PWM1 OUT<br />
| style="padding: 5px;"| Výstup PWM1 modulace, tento PIN-4 je spínán (v rytmu PWM1) pomocí BS170 na PIN-5 (PWM1-GND)<br />
|-<br />
| style="padding: 5px;"| 5<br />
| style="padding: 5px;"| PWM1 GND<br />
| style="padding: 5px;"| Nulový vodič spínače PWM1 modulace (tzn. PIN-4 spíná vůči PIN-5)<br />
|-<br />
| style="padding: 5px;"| 6<br />
| style="padding: 5px;"| Analogový vstup č. 1<br />
| style="padding: 5px;"| Základní rozsah je 0V až max 33V, měření je vždy vůči PIN-11<br />
|-<br />
| style="padding: 5px;"| 7<br />
| style="padding: 5px;"| Analogový vstup č. 2<br />
| style="padding: 5px;"| Základní rozsah je 0V až max 33V, měření je vždy vůči PIN-11<br />
|-<br />
| style="padding: 5px;"| 8<br />
| style="padding: 5px;"| Analogový vstup č. 3<br />
| style="padding: 5px;"| Základní rozsah je 0V až max 33V, měření je vždy vůči PIN-11<br />
|-<br />
| style="padding: 5px;"| 9<br />
| style="padding: 5px;"| Analogový vstup č. 4<br />
| style="padding: 5px;"| Základní rozsah je 0V až max 33V, měření je vždy vůči PIN-11<br />
|-<br />
| style="padding: 5px;"| 10<br />
| style="padding: 5px;"| Analogový vstup č. 5<br />
| style="padding: 5px;"| Základní rozsah je 0V až max 33V, měření je vždy vůči PIN-11<br />
|-<br />
| style="padding: 5px;"| 11<br />
| style="padding: 5px;"| Společný nulový vodič všech analogových vstupů<br />
| style="padding: 5px;"| Vůči tomuto pinu je prováděno měření napětí na analogových vstupech, sem připojte společný 0V vodič všech A/D vstupů<br />
|-<br />
| style="padding: 5px;"| 12<br />
| style="padding: 5px;"| Analogový vstup pro odporové (teplotní) čidlo (obecné napájené měření odporu)<br />
| style="padding: 5px;"| Analogový vstup pro odporové čidlo, vyžadující napájení při měření. Měření PIN-12 je provedeno vůči PIN-13.<br />
|-<br />
| style="padding: 5px;"| 13<br />
| style="padding: 5px;"| Nulový vodič pro analogový vstup pro odporové čidlo<br />
| style="padding: 5px;"| Čidlo zapojte vždy mezi PIN-12 a PIN-13<br />
|-<br />
| style="padding: 5px;"| 14<br />
| style="padding: 5px;"| Datový vodič 1-Wire sběrnice "A" <br />
| style="padding: 5px;"| Pracovní napětí 5V (toto jsou DATA - tj. 1-W sběrnice - zapojte vůči PIN-15)<br />
|-<br />
| style="padding: 5px;"| 15<br />
| style="padding: 5px;"| Nulový vodič 1-Wire sběrnice "A"<br />
| style="padding: 5px;"| Vše na 1-Wire sběrnici "A" má GND na PIN-15<br />
|-<br />
| style="padding: 5px;"| 16<br />
| style="padding: 5px;"| Napájecí vodič 1-Wire sběrnice "A"<br />
| style="padding: 5px;"| Napájení pro prvky na 1-W sběrnici, napětí +5V<br />
|}<br />
<br />
<br />
Konektor '''SDS-2''':<br />
{| class="filehistory" width="99%"<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''PIN'''<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''Funkce'''<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''Detaily'''<br />
|-<br />
| style="padding: 5px;"| 1<br />
| style="padding: 5px;"| OPTO 8 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 2<br />
| style="padding: 5px;"| OPTO 8 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 3<br />
| style="padding: 5px;"| OPTO 7 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 4<br />
| style="padding: 5px;"| OPTO 7 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 5<br />
| style="padding: 5px;"| OPTO 6 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 6<br />
| style="padding: 5px;"| OPTO 6 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 7<br />
| style="padding: 5px;"| OPTO 5 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 8<br />
| style="padding: 5px;"| OPTO 5 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 9<br />
| style="padding: 5px;"| OPTO 4 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 10<br />
| style="padding: 5px;"| OPTO 4 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 11<br />
| style="padding: 5px;"| OPTO 3 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 12<br />
| style="padding: 5px;"| OPTO 3 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 13<br />
| style="padding: 5px;"| OPTO 2 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 14<br />
| style="padding: 5px;"| OPTO 2 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 15<br />
| style="padding: 5px;"| OPTO 1 minus<br />
| style="padding: 5px;"| Katoda LED v optočlenu<br />
|-<br />
| style="padding: 5px;"| 16<br />
| style="padding: 5px;"| OPTO 1 plus<br />
| style="padding: 5px;"| Anoda LED v optočlenu<br />
|}<br />
<br />
Konektory '''SC1''' a '''SC2''' a '''SC3''' jsou určeny pro připojení doplňující sandwich desky. Různé doplňující desky mohou využívat různé tyto konektory (tedy nezbytně ne všechny).<br />
<br />
PWM2, PWM3 a PWM4 jsou dostupné jen pro BIG2. Pozn. pozor - PWM2 není vyvedena na hlavní svorky.<br />
<br />
BIG2 má, oproti BIG, vylepšené reléové výstupy. BIG2 poskytuje 6x přepínací kontakt (zatímco BIG pouze 6x spínací). BIG2 je také navrženo s většími a robustnějšími relé.<br />
<br />
<br />
=== Napájení modulu ===<br />
<br />
Napájení lze použít stejnosměrné (DC) nebo střídavé (AC), a napájecí napětí se vždy připojuje na svorkový konektor označený '''X2'''. V případě varianty výrobku, která podporuje Active PoE, lze celý modul napájet přes LAN připojení (dle normy IEEE802.3af) - v tomto případě SDS poskytuje i externí výstup 12Vdc nebo 24Vdc (dle typu), získaný z PoE vstupu.<br />
<br />
<br />
'''Pouze BIG''' (není na BIG2): Výstupní (modulem zpracované) napájení (usměrněné na DC a jištěné pojistkou) je k dispozici na svorkovém konektoru označeném '''X4'''. Tento konektor poskytuje pouze výstup (nelze přes něj modul SDS napájet), a právě tento výstup se především používá pro externí napájení jednotlivých optických vstupů.<br />
<br />
'''Pouze BIG2''' (není na BIG): konektor X5 poskytuje dva PWM výstupy a jejich společnou zem (PWMGND), a to specificky pro PWM3 a PWM4 výstupy.<br />
<br />
'''Pouze BIG2 PoE''' - napájení přes Active PoE (LAN konektor) nebo AC/DC přes svorky na konektoru X11.<br />
<br />
Měření napájecího napětí - je kalibrováno tak, aby ukazovalo napětí na vstupních svorkách. Měření je interně provedeno přes napěťový (rezistivní) dělič, který má rozdílné hodnoty pro BIG a pro BIG2. Firmware typ desky pozná a použije tu správnou kalibraci.<br />
<br />
'''Pouze BIG2''' - v případě, že neodpovídá zobrazovaná hodnota měření napájecího napětí, zkontrolujte na desce BIG2 rezistor R48, který musí být osazen o hodnotě 220k. Je možné že (pouze) u prototypové série mohlo dojít k záměně za hodnotu 180k, která je platná pouze pro variantu BIG. Všechny nově vyrobené kusy už to mají správně.<br />
<br />
<br />
== Zapojení optických vstupů ==<br />
<br />
Obrázek ukazuje celkové (vnější a vnitřní zapojení) optického vstupu. Protože modul SDS-BIG má osm zcela samostatných optických vstupů, je toto zapojení patřičně opakováno.<br />
<br />
[[Soubor:SDS_BIG_rev1_optoinput_schematic.gif]]<br />
<br />
Všechny optické vstupy jsou pasivní ("DRY"), to znamená že '''nejsou''' vnitřně napájeny uvnitř modulu SDS-BIG. Napětí pro aktivaci optického vstupu je potřeba přivést (z venku) na konkrétní svorky. Zde lze s výhodou využít výstupní vedlejší svorkový konektor '''X4''', který poskytuje DC napětí například právě pro tento účel.<br />
<br />
Všechny opto-vstupy (a vstup LOGIC-S0) lze, kromě základní detekce zap/vyp, využít k připojení měřičů energií (s rozhraním S0). Konfigurace se provádí přes webové rozhraní SDS.<br />
<br />
Optické vstupy lze externě napájet, i v případě provozu SDS modulu z Active PoE - a to díky tomu, že v takovém případě SDS modul poskytuje (interně generované) výstupní napětí 12Vdc nebo 24Vdc (jednu z těchto hodnot si vyberte při objednávce)<br />
<br />
<br />
== Zapojení analogových vstupů 1 až 5 ==<br />
<br />
Moduly SDS-BIG a BIG2 nabízí pět samostatných analogových vstupů, které jsou k dispozici uživateli (jsou vyvedeny na konektor). '''Všechny vstupy měří vůči společné svorce GND (pozor při připojování)'''.<br />
<br />
Rozsah měření lze změnit tak, že se buď vymění rezistory v odporovém děliči na desce modulu SDS-BIG (BIG2), nebo (v případě potřeby zvýšit horní hranici měření) stačí zapojit vnější sériový rezistor mezi zdroj napětí a vstup modulu.<br />
<br />
Moduly SDS-BIG a BIG2 mají několik dalších interních měřících bodů, které jsou zapojeny napevno a uživatel toto zapojení nemůže změnit. Tyto body měří např. vstupní napájecí napětí, více viz tabulka všech vstupů.<br />
<br />
Pozor, vstup pro měření odporu má navíc přivedené vnitřní napájení, ovládané modulem SDS-BIG (BIG2).<br />
<br />
Pozor, tak jako u všech ostatních vstupů a výstupů - piny označené jako GND nejsou přímo spojeny se svorkami napájecích konektorů (X2 a nebo X4), protože tyto konektory jsou odděleny od vnitřních GND přes diody, ale určité '''spojení tam je (přes diodu)''' - pozor na to !<br />
<br />
Obrázek ukazuje zapojení jednoho z pěti základních vstupů pro měření napětí:<br />
<br />
[[Soubor:SDS_BIG_rev1_analoginput_schematic.gif]]<br />
<br />
Při změně rozsahu je potřeba změnit kalibraci zařízení SDS - to je úkol uživatele, viz viz [[SDS_2PR:_ADC_vstupy_a_kalibrace|návod]].<br />
<br />
<br />
== Zapojení vstupu pro měření odporu ==<br />
<br />
Jako další vstup (mimo už popsané AI1 až AI5 vstupy), je k dispozici vstup pro měření odporu. <br />
<br />
Tento vstup se '''od ostatních vstupů liší''' ve dvou věcech: (1.) je napájen zevnitř SDS a také (2.) napájení je přerušovaně řízeno, aby nedocházelo k ohřevu odporu a tím k chybnému měření.<br />
<br />
Odporový vstup je určen pro připojení teplotních čidel (KTY81, Pt100/1000, Ni100/1000 atd.).<br />
<br />
Samozřejmě odporový vstup lze obecně použít pro měření pasivního odporu, např. vnějšího rezistoru, potenciometru, a tak dále.<br />
<br />
Opět opakuji, tento '''jediný''' vstup má vnitřní napájení, které SDS automaticky (bez zásahu uživatele) připojuje na tento vstup automaticky - to znamená, že na svorkách je už napětí, takže nesmíte přivést vnější napětí na tento vstup sami.<br />
<br />
Ve webovém rozhraní SDS lze provést kalibraci naměřených hodnot (převod digitální hodnoty na fyzikální veličinu - odpor, teplotu, atd.). Kalibraci zadává uživatel, viz [[SDS_2PR:_ADC_vstupy_a_kalibrace|návod]].<br />
<br />
<br />
== Udržení reálného času ==<br />
<br />
Všechny SDS jsou vybaveny interním obvodem RTC (Real Time Clock), a ten je vždy využit. Čas, udržovaný obvodem RTC, je automaticky průběžně aktualizován prostřednictvím NTP protokolu. Dojde-li např. k restartu SDS (např. z důvodu aktualizace firmware atd.), tak je platný a aktuální čas díky RTC obvodu stále k dispozici (i dříve než se provede NTP dotaz).<br />
<br />
POZOR - pouze některé vybrané moduly SDS, udržují čas i v době, kdy je modul plně '''odpojen od napájení''' - jedná se HW záležitost. Zvažte tuto potřebu při výběru vhodného typu SDS modulu.<br />
<br />
Pro ty SDS moduly, které neudržují čas v době bez napájení, je u takového požadavku potřeba externí RTC obvod (viz doplněk SW-RTC-COM-O6).<br />
<br />
SDS moduly, které umožňují připojení externího RTC obvodu:<br />
* SDS-BIG : přes konektor SC2<br />
* SDS-BIG2-DP : přes konektor SC2<br />
* SDS-BIG2-DP-DS84 : přes konektor SC2<br />
<br />
Toto ale není nutné pro SDS moduly, které to už nativně umí samy ve svém základu:<br />
<br />
SDS moduly, které '''umí udržet čas i při odpojeném napájení''', '''bez''' potřeby externího RTC obvodu, jen za pomocí záložní baterie (mají rozšířenou funkci interního RTC):<br />
* SDS-BIG2-DP-DS84-64<br />
* SDS-BIG2-DP-DS84-PoE-64<br />
* SDS-BIG2-DP-DS84-128 <br />
* SDS-BIG2-DP-DS84-PoE-128 <br />
* SDS-BIG2-DP-DS84-512<br />
* SDS-BIG2-DP-DS84-PoE-512<br />
<br />
<br />
== Rozšíření v rámci sestavy výrobku ==<br />
<br />
Základní modul lze přímo rozšířit pomocí specifických sandwich desek. To znamená, že v rámci jednoho fyzického zařízení SDS-BIG (BIG2) lze umístit jak základní desku SDS-BIG (BIG2), tak do ní připojit SANDWICH doplňkovou desku a obě tyto desky mít ve společné DIN krabičce.<br />
<br />
'''Některé z uvedených sandwich desek vyžadují napájení 24V DC''' (jen tuto hladinu a ne jinou) - tomu musíte přizpůsobit napájení SDS. V případě varianty SDS musíte při objednávce specifikovat, že chcete verzi která interně pracuje na 24V.<br />
<br />
<u>Lze si vybrat z následujících doplňkových sandwich desek:</u><br />
<br />
* [[SDS BIG: DALI|LCD+KEY+DALI]] - poskytuje grafické LCD plně ovladatelné z FULL-C programu, klávesnici s pěti tlačítky (stisk přenášen do FULL-C programu ke zpracování) a DALI master pro řízení světel a jiných DALI slave modulů<br />
<br />
* LCD+KEY+CANCOM - poskytuje LCD, klávesnici, a rozhraní sběrnice CAN 2.0 A,B a rozhraní RS232 (COM6), vse přímo přístupné z FULL-C programu<br />
<br />
* [[SDS BIG: LoRA|LCD+KEY+LORA]] - poskytuje LCD, klávesnici a připojení k LoRa WAN 868 síti (nebo FSK komunikaci přímo mezi více SDS moduly v rámci lokální rádiové sítě)<br />
<br />
* [[SDS BIG: LoRA|SW-LORA]] - poskytuje pouze LoRa WAN 868 připojení (ekonomická varianta)<br />
<br />
* SW-GSM - poskytuje pouze GSM připojení (držák SIM na desce) (ekonomická varianta)<br />
<br />
* [[SDS BIG: MBUS|LCD+KEY+MBUS]] - poskytuje MBUS (MeterBus) MASTER rozhraní<br />
<br />
* [[SDS_BIG: SW-RELE6|SW-RELE6]] - poskytuje 4 silové SPDT relé, dvě signálové SPDT relé, tři N-FET spínače jako výstupy, a současně 4 opticky izolované binární vstupy (jen stavové zap/vyp vstupy, pozor: tyto nemají funkci počítače pulsů), plus jedno uživatelské tlačítko a dvě uživatelské LED<br />
<br />
* [[SDS_BIG:_SW-RTC-COM-O6|SW-RTC-COM-O6]] - poskytuje zálohovaný RTC obvod, výstup rozhraní RS232, pět N-FET spínačů jako výstupy, dvě uživatelské LED, jedno uživatelské tlačítko<br />
<br />
* [[SDS_BIG:_SW-IN24S7AI2|SW-IN24-S7-AI2]] - poskytuje 24 digitálních vstupů, 7 výstupů, a 2 samostatné vstupy pro měření proudu smyčky 4-20 mA<br />
<br />
<br />
Například sestavou BIG + RELE6 získáte v jedné DIN krabičce 12 reléových výstupů a další doplňující vstupy a výstupy.<br />
<br />
Komunikace s doplňující deskou se provádí výhradně přes FULL-C program. Příklady a hotové programy k dispozici u výrobce, nebo dle návodu zde na wiki.<br />
<br />
<br />
Zapojení konektoru SC3 je zde:<br />
<br />
[[Soubor:Sds_big_rev1_com_port_conn.png]]<br />
<br />
Pozor! ač tento konektor vypadá fyzicky stejně jako podobný konektor na výrobku SDS-MINI, je zapojen '''jinak''' - tzn. zapojení mezi SDS-BIG (BIG2) a SDS-MINI je '''rozdílné'''.<br />
<br />
Lze si samozřejmě navrhnout a vyrobit i vaši vlastní rozšiřovací desku. Kontaktuje nás ohledně detailů, vše poskytneme.<br />
<br />
<br />
== Další detaily ==<br />
<br />
<br />
Některé vybrané body:<br />
<br />
<br />
* '''Výkonný Procesor''' (64/128: 0.2GHz ARM) (512: 0.5GHz ARM)<br />
<br />
Použití nového procesoru umožňuje rozšířit funkce zařízení, zejména možnosti programování ve '''FULL-C''' (nová generace SDS-C).<br />
<br />
<br />
* '''Administrační Webové Rozhraní'''<br />
<br />
SDS-BIG (BIG2) nabízí webové rozhraní, které je vůči První Produktové Řadě SDS inovováno. K dispozici jsou i M2M protokoly a [[M2M:_Druhá_Produktová_Řada|speciální webové stránky (XML, CSV)]].<br />
<br />
<br />
* '''Uživatelské Webové Rozhraní'''<br />
<br />
Uživatel může do SDS nahrát UserWEB projekt (do paměti DF) a také může využít SD kartu, na které je možnost mít nahrány webové stránky a další soubory. Detaily viz [[User_Web_Page]].<br />
<br />
<br />
* '''SD karta'''<br />
<br />
Do zařízení lze vložit mikroSD kartu, prakticky bez omezení velikosti. <br />
Na tuto kartu lze přistupovat pomocí specifických funkcí FULL-C (čtení a zápis do souboru). Samozřejmostí je možnost zobrazení obsahu SD karty přes HTTP server. Takto lze i např. přes FULL-C program měnit statické webové stránky (soubory uložené na SD kartě) a nechat je uživatele si je zobrazit.<br />
<br />
<br />
* '''A/D převod: 64/128 ADC: 12 bitů , 512 ADC: 16 bitů'''<br />
<br />
Zařízení SDS-BIG (BIG2) nabízí pět samostatných vstupů pro měření napětí a ještě k tomu jeden napájený vstup pro měření odporu.<br />
<br />
Vzhledem k technice oversamplingu je ENOB dostatečně vysoký.<br />
<br />
Měření odporu umožňuje přímé dvoudrátové připojení Pt100/Pt1000/Ni1000/KTY81 a tak dále, nebo lze např. připojit potenciometr.<br />
Doplňkově je možnost SDS-BIG (BIG2) rozšířit o multiplexní kartu, která nabízí osm dalších vstupů pro měření odporu. <br />
Měření odporu je řízeno interně (bez zásahu uživatele) v SDS tak, že napájení pro měření (měřící proud) je spínán jen v okamžiku měření - nedochází tak k parazitnímu ohřevu měřeného odporu.<br />
<br />
Na desce SDS-BIG (BIG2) je osazen zdroj precizní reference pro A/D převodník (externí reference). Tím je dosaženo zvýšení přesnosti a stability (dlouhodobá a teplotní stabilita) převodu napětí na digitální hodnotu.<br />
<br />
Všechny externí vstupy jsou odděleny operačním zesilovačem, takže je možnost zvolit i velmi malý proud ve vstupním děliči napětí. Toho se s výhodou dá využít pro měření napětí článků baterií, kdy se dá snížit vybíjecí proud (způsobený vstupním děličem) na minimum.<br />
<br />
Deska SDS-BIG dále měří své napájecí napětí (ze svorek), což je využito např. pro zablokování zápisu na SD kartu při poklesu napájení.<br />
Dále se měří ještě napětí ve vnitřní větvi +5V, použité pro napájení vnitřních analogových obvodů, a tak lze kompenzovat chybu měření na všech ostatních vstupech.<br />
<br />
Vstupní napěťový dělič je k dispozici přímo na desce SDS-BIG (BIG2). Rozšíření (nebo zmenšení) rozsahu je možné změnou hodnoty jednotlivých rezistorů, nebo připojením externího rezistoru do série (tak jak je tomu i u ostatních modulů SDS).<br />
<br />
Všechny SDS poskytují digitální rozsahy v rozsahu 12bitů (efektivní bitová šířka). U modulu varianty 512 je možné (navíc) číst raw hodnotu i v rozsahu 16bitů (ENOB). Dosažené ENOB hodnoty jsou dány matematickým zpracováním (decimace) spolu s určenou výslednou šířkou pásma dostupných dat.<br />
<br />
<br />
* '''Binární vstupy'''<br />
<br />
Zařízení SDS-BIG (BIG2) nabízí osm samostatných opticky oddělených vstupů. Vstupy jsou zapojeny tak, že vyžadují určitý minimální proud a určité minimální napětí, aby došlo k jejich aktivaci. Hodnota minimálního napětí se dá snadno změnit pro každý vstup zvlášť (změnou jedné součástky u konkrétního vstupu). Tento "filtr" je výhodný zejména v případě připojení dlouhých vedení, které mají souběhy se silovým vedením, a ve kterých se indukuje rušivé napětí (což by způsobovalo např. falešné S0 impulsy, které jsou zapojením SDS-BIG (BIG2) potlačeny). Pozn. podobně jsou zapojeny i vstupy na SDS-TTCPRO modulu.<br />
<br />
Vstupy nejsou vnitřně napájeny. Zařízení SDS-BIG nabízí samostatné výstupní svorky s napájecím napětím (které lze přímo použít pro napájení vstupů), pokud nebudete chtít použít externí zdroj pro optické vstupy.<br />
<br />
Optické vstupy lze využít pro připojení k S0 měřičům (elektroměry atd.), nebo je lze použít jako zap/vyp (binární) signalizaci. Dále je ještě navíc k dispozici LOGIC-S0 vstup v RJ konektoru.<br />
<br />
<br />
* '''PWM výstupy'''<br />
<br />
SDS-BIG: K dispozici je '''jeden''' PWM výstup, kde MOSFET tranzistor (uvnitř SDS) spíná svorku PWMout na svorku GND. Připojení externího pull-up je možné (to už je vaše část zapojení, mimo SDS).<br />
<br />
SDS-BIG2: K dispozici jsou '''čtyři''' PWM výstupy (z toho ale jen '''tři''' vyvedené na hlavní svorky), každý se svým MOSFET tranzistorem (uvnitř SDS), který spíná příslušnou výstupní svorku na společné GND.<br />
<br />
Dbejte na nepřekročení limitů (napětí, proud, výkon) které má PWMout spínat - viz SOA pro tranzistor BS170.<br />
<br />
PWM výstup lze použít k libovolným účelům, nebo pro připojení k modulu SDS-PWM10.<br />
<br />
<br />
* '''RS485 master'''<br />
<br />
Na desce SDS-BIG (BIG2) je k dispozici RS485-master, včetně zakončovacího rezistoru 120R.<br />
<br />
Rezistor 120R lze odpojit (vypájet), pokud je SDS-BIG (BIG2) umístěn uprostřed sběrnice (a ne okraji sběrnice).<br />
<br />
POUZE '''SDS-BIG''': '''Vždy je nutné vodič B- sběrnice spojit na BUS-GND vodič přes (externí) rezistor 390R''', jinak v klidu bude sběrnice v neurčeném stavu a budou se ztrácet data. Toto zapojení závisí na všech konkrétních prvcích na sběrnici, a pokud nějaký už tento rezistor v sobě má, pak se samozřejmě dvakrát nesmí zapojit ! Nicméně většinou je nutné z vaší strany tento rezistor dodatečně připojit - zkontrolujte si to.<br />
<br />
'''SDS-BIG2''': Není potřeba zapojovat externí rezistor 390R, ten už je na SDS-BIG2 zapojen přímo uvnitř SDS (naopak u původního SDS-BIG chyběl a musí se doplnit externě).<br />
<br />
<br />
Návod viz [[SDS_BIG:_RS485]].<br />
<br />
Přístup k RS485 lince má FULL-C program, a RS485 lze také (pokud máte nainstalován vhodný firmware ve vašem SDS) použít jak Virtual COM Port (serial-over-Ethernet), tak jak je tomu u ostatních modulů SDS.<br />
<br />
<br />
* '''Reléové výstupy'''<br />
<br />
K dispozici je šest samostatných reléových výstupů. Relé mohou být osazeny se spínacím nebo rozpínacím kontaktem (toto se určuje při objednávce). Podle napájecího napětí zařízení SDS-BIG se určí typ relé (cívka 12V nebo 24V - '''toto musíte určit při objednávce'''). Pro varianty BIG2 jsou cívky relé interně zapojeny jinak (a jsou vždy na 5V), a proto už není potřeba cokoliv specifikovat jako u původních prvních verzí BIG.<br />
<br />
Relé mohou svými kontakty spínat AC i DC napětí. POZOR ALE NA OMEZENÍ (kombinované omezení max. proud/napětí/zátěž), viz parametry konkrétního relé.<br />
<br />
<br />
* '''Napájení: AC nebo DC'''<br />
<br />
Zařízení SDS-BIG (BIG2) lze napájet střídavým nebo stejnosměrným proudem. <br />
<br />
<br />
BIG: Rozsah je 9V až 35V stejnosměrných (pozor při napájení střídavým proudem, ať se nepřekročí vnitřní maximální napětí, tedy max 28Vac). <br />
<br />
<br />
BIG2 a BIG2-PoE: Rozsah je 9V až 40V stejnosměrných (pozor při napájení střídavým proudem, ať se nepřekročí vnitřní maximální napětí, tedy max 28Vac). <br />
<br />
<br />
BIG a BIG2-PoE: K dispozici je také výstup stejnosměrného proudu pro napájení např. optických vstupů (jedná se usměrněné a pojistkou jištěné napájecí napětí modulu SDS-BIG). Pozor, toto není k dispozici na SDS-BIG2, pouze na SDS-BIG2-PoE. Vždy se pro jistotu podívejte na popis pinů na konektorech, je-li patřičný výstup k dispozici !<br />
<br />
<br />
Horní hodnota přípustného napětí (35Vdc / 40Vdc / 28Vac) je dána vnitřní konstrukcí SDS-BIG (BIG2). Pokud chcete SDS-BIG (BIG2) napájet z vyššího napětí, musíte předřadit externí DC/DC měnič.<br />
<br />
<br />
* '''1-W (OneWire) vstupy'''<br />
<br />
K dispozici jsou dvě zcela samostatné 1-W sběrnice, jedna je dostupná na svorkách, druhá přes RJ konektor.<br />
<br />
Napájení sběrnic je 5V (zvýšeno oproti ostatním výrobkům SDS), takže je možné zapojit delší kabeláž pro sběrnici. <br />
Obě sběrnice jsou řízeny speciálními chipy, takže je na nich přesné časování - tím pádem je SDS-BIG (BIG2) odolnější a kvalitnější ve srovnání s ostatními zařízeními SDS, které speciální chip pro 1-W nepoužívají.<br />
<br />
Varianta SDS BIG/BIG2 označená DS84 obsahuje modernější komunikační chip (master) pro sběrnici 1-W, a vylepšuje tak schopnosti SDS s touto sběrnicí pracovat.<br />
<br />
<br />
* '''Ethernet: 100Mbit/s'''<br />
<br />
Zařízení má nativní 100Mbit/s Ethernetové kabelové rozhraní. Toto rozhraní je možné připojit do 10/100/1000 Mbit/s switche. Rozhraní má také automatické přizpůsobení pro křížené a nekřížené kabely.<br />
<br />
Komunikace se domlouvá pomocí Auto Negotiation - vybírá se automaticky rychlost 10 nebo 100 Mbit/s , automaticky se také určí režim provozu Full Duplex nebo Half Duplex.<br />
<br />
Varianta "DP" má inovované rozhraní Ethernet, které umožňuje maximální délku ethernetového kabelu o maximální délce 150 metrů (varianty bez "DP" mají maximálně 100m).<br />
<br />
<br />
* '''Zálohovací baterie'''<br />
<br />
Použitím 3V Lithiové knoflíkové zálohovací baterie zaručuje udržení obsahu záložní paměti i při (náhodném či dlouhodobém) výpadku napájení.<br />
<br />
Záložní paměť udržuje provozní data jako jsou stavy počítadel.<br />
<br />
Vámi nahraný FULL-C program není uložen v záložní paměti, ale v pevné paměti (DF), která nepotřebuje zálohu, protože udrží svůj obsah i bez napájení. Přítomnost záložní baterie tedy nemá vliv na udržení nahraného FULL-C programu (a UserWeb projektu a dalšího nastavení zařízení), tyto všechny věci se při odstranění napájení neztratí a zůstávají.<br />
<br />
<br />
== Srovnání ==<br />
<br />
Varianty BIG:<br />
* "BIG 64" - první existující varianta<br />
* "BIG 128" - rozšířená varianta 64 na dvojnásobek programové paměti pro FULL-C program (jinak beze změn vůči 64)<br />
* "BIG 512" - rozšířená varianta 128 na čtyřnásobek programové paměti pro FULL-C program, přidána funkce udržení RTC, několikanásobně rychlejší procesor, zvětšená FC konzole atd.<br />
<br />
Varianty BIG2:<br />
* "BIG2 64" (tzn. bez DP, bez DS84) - není vyráběno<br />
* "BIG2 128 DP DS84" - na vyžádání<br />
* "BIG2 512 DP DS84" - standardní varianta ve výrobě (512 DP DS84).<br />
<br />
<br />
Z hlediska rozměrů, zapojení vstupů a výstupů, obecného použití atd. - jsou všechny varianty BIG stejné. To samé platí i mezi všemi variantami BIG2.<br />
<br />
BIG lze nahradit BIG2 bez nutnosti cokoliv zásadního měnit (pouze pozor na svorky relé, a chybějící X4 u BIG2), nebo přepisovat FULL-C program atd. - kompatibilita a záměnnost mezi BIG a BIG2 byla plně zachována.<br />
<br />
Primárně se jednotlivé BIG (a BIG2) mezi sebou liší velikostí dostupné programové paměti (pro váš FULL-C program), tzn. výlučné varianty 64, 128 nebo 512.<br />
<br />
Varianta 512 však má (oproti 64/128) ještě jednu výhodu, a to je výrazně novější a rychlejší procesor. <br />
<br />
FULL-C program, který lze spustit na zařízení varianty 64, bude bez jakýchkoliv potřebných změn fungovat i na variantě 128 a také na variantě 512.<br />
<br />
FULL-C program, který lze spustit na zařízení varianty 128, bude bez jakýchkoliv potřebných změn fungovat i na variantě 512.<br />
<br />
PoE variatna je plně záměnná s ne-PoE variantou, není tam zásadní funkční rozdíl (respektive, PoE přidává navíc tuto funkčnost, a nic víc).<br />
<br />
V rámci BIG2 jsou zavedeny dvě kombinovatelné varianty - a to DP a DS84. V prodeji bude pouze plná kombinace, tedy "SDS BIG2 xxx DP DS84". Tyto varianty označují interní HW změny v rámci výrobku SDS BIG2. Jedná se o reakci na nové požadavky a také reagujeme na dostupnost modernějších součástek, které umožní zachovat původní funkce a rozšířit je.<br />
<br />
* DP = aktualizovaný HW (SDS BIG2) v oblasti Ethernetu, zejména ve zvýšeném maximálním dosahu ETH kabelu (až 150m)<br />
* DS84 = aktualizovaný HW (SDS BIG2) v oblasti sběrnic OneWire (1-W), kdy je použit modernější ovladač sběrnice s novými možnostmi uživatelské konfigurace<br />
<br />
Samozřejmě základní společnou vlastností BIG2 je rozšíření počtu PWM výstupů (čtyři PWM, z toho tři jsou vyvedeny na hlavní svorky modulu).<br />
<br />
<br />
== Dostupnost ==<br />
<br />
SDS moduly jsou v prodeji - objednávejte na eShopu. <br />
<br />
Diskuse a podpora je k dispozici na našem fóru: forum.merenienergie.cz .</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_tips_and_tricks&diff=990FULL-C: tips and tricks2026-10-31T16:18:37Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Důležité poznámky k práci s FULL-C ==<br />
<br />
Zde jsou neseřazené tipy a triky, tak, vytvořené tak, jak jak postupem času dostáváme různé dotazy od uživatelů.<br />
<br />
Současně (na konci stránky) naleznete kritické tipy a postupy, jak efektivně zapsat váš program tak, aby byl co nejvíce rychlý. Je důležité si to přečíst.<br />
<br />
<br />
* '''Dbejte na to''', aby verze FC byla '''stejná''' jak pro překladač (FULLC.EXE) tak i pro vaše SDS. Pokud má vaše SDS starší firmware (a tedy starší verzi FC, například 0x06), zatímco překladač je novější (například FULLC.exe s verzí FC 0x08), tak SDS odmítne novější FC program spustit. Toto se řeší velmi snadno, a to aktualizací firmware ve vašem SDS.<br />
<br />
<br />
* I když proběhne překlad ve FULLC.EXE v pořádku, '''stále může váš FULL-C program obsahovat chyby''' - to se dozvíte '''teprve''' z konzole (web zařízení SDS: typicky 192.168.1.250/echo.htm), proto ji '''vždy průběžně kontrolujte''' !<br />
<br />
<br />
* Pozor na ''signed'' a ''unsigned'' typy a jejich používání. FULL-C se chová dle standardu C, a detaily standardu vás mohou zmást.<br />
<br />
Např. '''char''' je signed ! (pokud jej explicitně nedefinujeme jako '''unsigned char''').<br />
<br />
Příklad - chceme vypsat HEX kód pro jednobajtový znak.<br />
<br />
Toto ale neudělá to co "chceme": vypíše to '''FFFFFFDB''' - přesně podle specifikace jazyka C, kdy dojde nejprve k převodu na int32 <br />
<syntaxhighlight lang="c"><br />
char ch = 0xDB;<br />
printf("%x", ch);<br />
</syntaxhighlight><br />
<br />
Příklad správného zápisu: vypíše to '''DB''' tak jak chceme, a to proto že jsme správně uvedli že to chceme zpracovat jako '''unsigned char'''.<br />
<syntaxhighlight lang="c"><br />
char ch = 0xDB;<br />
printf("%x", (unsigned char)ch);<br />
</syntaxhighlight><br />
<br />
Další příklad velkého problému je následující kus programu pro výpis obsahu textového pole jako HEX znaků:<br />
<syntaxhighlight lang="c"><br />
char pole[32];<br />
char * ch;<br />
<br />
ch = (char *)&pole;<br />
for (i = 0; i < 32; i++)<br />
{<br />
printf("%02x", *ch++); // <<<<<<< WARNING !!!! *ch is signed char !!!<br />
}<br />
</syntaxhighlight><br />
<br />
Opět, správné řešení je ve správném přetypování: <pre> printf("%02x", (unsigned char)*ch++); </pre><br />
<br />
<br />
* Před provedením jakékoliv síťové komunikace ve FULL-C (např. odeslání emailu), '''vždy zkontrolujte''' stav, a to pomocí: ''status = SDS_get_u(27);'' (když je ''status==0'' tak SDS nemá připojení - nezačínejte komunikaci, čekejte a testuje stav).<br />
<br />
<br />
* Pole pro uchování textů můžete přímo deklarovat, např. na zásobníku (stack) jako ''char text[128];'' - nebo na haldě (heap), pro což využijte ''text = (char *)malloc(128);'' a ''free(text);text=0;'' funkce. Výběr z těchto možností je na vás (malé pole / malé texty jdou dát na zásobník, velké už patří do haldy).<br />
<br />
<br />
* Využijte 64-bitových proměnných (int64_t nebo uint64_t) tam, kde vám 32 bitů nestačí. Například pro počítadla, nebo výpočty s velkými čísly (nebo jen stačí že by měl být velký mezivýsledek a při použití 32-bit čísel by jste o něj "přišli").<br />
<br />
<br />
* Pro zjištění, jaký největší blok paměti (heap) lze v danou chvíli alokovat pomocí ''malloc()'' funkce, využijte funkci ''SDS_heap_stats()'' . Ačkoliv může být celková hodnota volné heap pamět velká, toto celkové volné místo je vždy roztroušeno na různé malé oddělené bloky (fragmentace) - a vždy lze alokovat jen po jednom bloku, a jeho největší možná velikost je zjistitelná právě ze zmíněné funkce.<br />
<br />
<br />
* Vždy když uvolníte paměť, nezapomeňte ihned ručně vynulovat daný uvolněný ukazatel. Zabrání to chybám ve vašem programu. Příklad: <br />
<syntaxhighlight lang="c"><br />
// definice ukazatale<br />
void *ptr; <br />
<br />
...<br />
// alokujeme si pamet, pro priklad 32 bajtu<br />
ptr = malloc(32);<br />
<br />
// pamet na kterou ukazuje ptr lze ted pouzivat (pozor at nepristupujete mimo alokovany rozsah)<br />
...<br />
<br />
// uz pamet nepotrebujeme, tak ji uvolnime:<br />
free(ptr); <br />
ptr = 0; // vzdy ihned za zavolanim free() nastavte ptr do nuly !!!<br />
<br />
... <br />
</syntaxhighlight><br />
<br />
<br />
* Funkce ''printf()'' a ''puts()'' a ''putchar()'' zapisují do konzole (web zařízení SDS, typicky: 192.168.1.250/echo.htm), čehož lze využít pro ladění programu, nebo pro dálkový monitoring zařízení. Nicméně pro průběžné spolehlivé získávání hodnot a údajů z SDS nebo vašeho programu, je vhodně použít systém sdílených proměnných, nebo SNMP.<br />
<br />
<br />
* FULL-C používá právě přesně 32-bitů pro datový typ ''float''. Počítejte s touto informací pro správné pochopení přesnosti práce s desetinnými čísly (omezené rozlišení dané 32bity). Pro většinu aplikací toto nepředstavuje problém, pokud ale chcete provádět složité výpočty s desetinnými čísly, je potřeba znát tato omezení. Přesné vysvětlení viz např. [https://en.wikipedia.org/wiki/Single-precision_floating-point_format|"Single-precision floating-point format"].<br />
<br />
<br />
* Funkce ''printf()'' a ''sprintf()'' umí zpracovat ''float'' proměnné (%f), ale neumí je uživatelský formátovat (neumí např. %0.2f - ale umí jen základní %f, to znamená že vypíše úplně celou délku čísla se všemi pozicemi za tečkou, což může být i dost dlouhý text). Toto je aktualizováno v nové verzi FULL-C (tam už to jde).<br />
<br />
<br />
* '''Nepoužívejte prázdný string''' (tj. "").<br><br />
Tři příklady '''zakázaného kódu''' pro FULL-C:<br />
<syntaxhighlight lang="c"><br />
// do not do any of the following:<br />
//<br />
char text1[10] = ""; // spatne !<br />
//<br />
strncpy(text2,"",10); // spatne !<br />
//<br />
sprintf(text2,""); // spatne !<br />
</syntaxhighlight><br />
<br />
<br />
* Před použitím některé z funkcí, které přistupují k serveru na Internetu, je vhodné provést volání ''dns_resolv()'' pro zjištění aktuální IP adresy (IP0.IP1.IP2.IP3) daného serveru, vždy před zavoláním konkrétní funkce (např. ''http_get()'' ). Určitě není vhodné používat přímo natvrdo zapsané číselné adresy (ty se mohou změnit např. při přesunu serveru).<br />
<br />
<br />
* Pokud některá z FULL-C funkcí selže (např. ''smtp_send()'' ohlásí přes ''smtp_send_status()'' chybu), tak je vhodné mít FULL-C program napsán tak, aby chvíli počkal, a pak to celé zkusil znovu. Při více selháních je pak potřeba provést další akci (oznámit chybu, zjistit stav připojení k síti, atd.).<br />
<br />
<br />
* Přes FULL-C lze '''pouze číst''' kalibrační konstanty pro analogové vstupy. Pokud je chcete hromadně nastavit, použijte s výhodou 192.168.1.250/cgi_cfg_adc?xxxx volání (uživatel musí být přihlášen).<br />
<br />
<br />
* Každý FULL-C program může nastavit tzv. "brand" (uživatelskou značku / popisek) pro zařízení SDS, na kterém je spuštěn. Protože SDS je často dodáváno v rámci OEM pro další zástavbu do většího celku, může si finální systémový integrátor nastavit své doplňující texty (název firmy, odkazy na web, telefonní čísla na podporu, doplňující texty, informace o sériovém čísle atd.), které jsou pak zobrazeny v rámci stránek webové administrace zařízení SDS (login, welcome, atd.). Toto nastavení provádí FULL-C program zavolání ''SDS_set_a()'' s příslušným indexem a textem. Typicke se takový FULL-C kód dává na úplný začátek programu.<br />
<br />
<br />
* FULL-C program lze nachystat a vydat tak, že je "zablokován" tak aby fungoval pouze na jediném konkrétním vybraném SDS zařízení. Každé SDS má své unikátní sériové číslo (viz tabulka indexů pro ''SDSget_u()'' ), a FULL-C program může tuto hodnotu porovnat (s tím, co do FULL-C programu vloží autor programu). Toto uživatelské zablokování programu může předejít chybám, kdy by se např. nevhodný program nahrál omylem na jiný hardware. Pokud vydáváte FULL-C program prostřednictvím .FC souboru, kam zvolíte nepřiložit zdrojový .C kód, pak máte neprůstřelnou možnost zamezit použití programu na jakémkoliv jiném SDS než jaké sami určíte (zdrojový kód nebude cílovému uživateli k dispozici, a navíc váš program otestuje sériové číslo daného SDS na shodu). Samozřejmě to znamená, že musíte zmíněné sériové číslo daného SDS zjistit předem, než vydáte program, aby jste to číslo mohli do programu vložit.<br />
<br />
<br />
* Pokud ve svém programu využíváte sériovou sběrnici RS485, dbejte na správné zapojení sběrnice. Naše fórum je plné příkladů, kdy autor programu řešil problém s RS485 a nakonec se ukázalo, že sběrnice byla špatně zapojená (přehozené A/B dráty, nezakončená rezistory, neuvedená do známého klidového stavu přes rezistory atd.). Pro ověření programu je vždy dobré vzít pasivní "odposlech" sběrnice (osciloskop, osobní počítač) a zkontrolovat "překryv" (kdy více zařízení vysílá najednou, což je na RS485 kolize a poškození dat). Právě "překryv" je nejčastějším problémem způsobující poškození komunikace, hned po špatném nastavení komunikační rychlosti v programu. Vždy zkontrolujte svůj hardware, tj. celou sběrnici, je-li správně impedančně zakončena (nejvzdálenější konce) a zda-li jste správně zapojili oba klidové rezistory (pozor, na SDS-BIG tyto nejsou a musí se ručně doplnit "zvenku").<br />
<br />
<br />
* Pokud chcete přes sdílené proměnné (sv) přenášet čísla datového typu ''float'' (desetinná čísla), a pak je chcete například zobrazit na UserWEB webové stránce (a nebo přenést na server atd.), použijte následující trik. Vytiskněte obsah float čísla do Txx[] proměnné, pomocí sprintf(), nikoiv však s využitím %f - ale právě přes následující kód:<br />
<syntaxhighlight lang="c"><br />
// definujeme si sdilenou promennou T00<br />
char T00[32];<br />
<br />
void FloatToT00(void)<br />
{<br />
// vstupni float<br />
float xf;<br />
<br />
// pomocna promenna (presne 4 bajty, protoze "float" je ve FULL-C reprezentovan jako 32-bit)<br />
unsigned int xw;<br />
<br />
// zapiseme vzorovou hodnotu<br />
xf = 12.34;<br />
<br />
// ziskej 32bit obsah xf (= cteni 4 bajtu dat ktere reprezentuji dany float)<br />
xw = *(unsigned int *)&xf;<br />
// a zapis do T00, zarovnej vzdy na osm mist (at se to da pozdeji spravne zpracovat - prevest zpet na float)<br />
sprintf((char *)T00, "%08X", xw);<br />
<br />
// T00[] ted obsahuje "414570A4" (coz je hex reprezentace puvodni float hodnoty 12.34)<br />
}<br />
</syntaxhighlight><br />
Pokud se po spuštění tohoto kódu pak podíváte např. na 192.168.1.250/shared.txt , tak tam uvidíte toto: "T00|414570A4|" (krom jiného textu). S tím už pak v JavaScriptu není problém pracovat (převést zpět na float a korektně zobrazit nebo dále zpracovat). Řada přímých příkladu je k dispozici, stačí hledat na Internetu podle klíčových slov "javascript convert hex to float". <br />
Toto se řeší právě z důvodu že FULL-C printf funkce (a další podobné) umí jen %f ale bez dalších parametrů, takže tisknou float čísla na všechny místa za desetinnou tečkou, což je ve většině případů nežádoucí (při zobrazování na webových stránkách a podobně).<br />
<br />
<br />
* Přistupovat ke všem údajům ze sběrnic 1-Wire, ve FULL-C, je samozřejmě možné, je však potřeba vědět jak. Detaily viz stránka [[FULL-C: OneWire]].<br />
<br />
<br />
* Pamatujte, že varianta '''SDS-64''' (viz [[SDS BIG|varianty]]) má k diposozi pouze celkem 64kB programové paměti (a SDS-128 má jen 128kB této paměti, a SDS-512 jen 512kB celkové FULL-C paměti) - do které '''se musí vlézt celý''' váš přeložený FULL-C program, a k tomu také celý STACK a všechna potřebná paměť HEAP. Toto omezení není dáno programově, ale právě použitým hardware v SDS, takže jej nelze jednoduše "obejít" - pokud se vám to nevleze do varianty 64 tak musíte použít variantu 128 (nebo 512), to je jediné řešení.<br />
<br />
<br />
* Vždy '''správně nastavte velikost''' STACKu - číselnou hodnotu nastavte v okně editoru zdrojového textu FULL-C. Pokud nastavíte hodnotu pro váš program jako moc malou, program nebude fungovat (při volání více funkcí může být pro nedostatek stacku ukončen). Příliš velká hodnota snižuje volnou paměť heap (pokud heap nepoužíváte, nastavte stack na vyšší hodnotu pro klid). Správnou hodnotu zjistíte určitým odhadem (podle velikosti a složitosti programu, podle toho kolik proměnných používáte a kolik parametrů se předává při volání funkcí, a kolik funkcí se v sobě volá). Nastavení je možné nechat automaticky odhadnou překladač, nebo jej můžete ručně zadat (odhad není přesný).<br />
<br />
<br />
* Inicializaci proměnných '''provádějte v kódu, nikoliv při deklaraci'''. Jde o to, že při inicializaci hodnot v proměnné či poli, provedené kódem, se spotřebuje zlomek stack paměti, oproti inicializace přímo při deklaraci. Stack paměti je vždy málo a je potřeba jí šetřit. Je to vlastnost FULL-C.<br />
<br />
Příklad inicializace při deklaraci: <br />
<syntaxhighlight lang="c"><br />
unsigned int numbers[5] = {0,1,2,3,4}; // toto spotřebuje hodně stacku - TAKHLE TEDY NE<br />
</syntaxhighlight><br />
Příklad identické inicializace kódem:<br />
<syntaxhighlight lang="c"><br />
// toto řešení je doporučené, nespotřebovává stack<br />
unsigned int numbers[5];<br />
number[0] = 0;<br />
number[1] = 1;<br />
number[2] = 2;<br />
number[3] = 3;<br />
number[4] = 4;<br />
</syntaxhighlight><br />
Nebo, příklad odpovídající inicializace kódem:<br />
<syntaxhighlight lang="c"><br />
// toto řešení je doporučené, nespotřebovává stack<br />
unsigned int numbers[5];<br />
unsigned int i;<br />
for (i = 0; i < 5; i++) { number[0] = i; };<br />
</syntaxhighlight><br />
<br />
<br />
>>>>>>>>>>>> Následující informace je platná pouze pro firmware starší než 10.7.2017<br />
<br />
* SDS ukazuje aktuální využití své 64kB programové paměti, na webové stránce v administraci.<br />
<pre><br />
HEAP STATS: curalloc=1892, totfree=58632 maxfree=58632, nget=12 nrel=0<br />
HEAP STATS: bc_locked=1120, stackTop=2984 (of 5000)<br />
</pre><br />
Jak to dékódovat: první řádek ukazuje celkové využití paměti a počet alokací a uvolnění:<br />
curalloc = celkem alokovaná paměť (heap malloc, a všechny interní FULL-C funkce a interní data v SDS)<br />
totfree = celkem zbývající volná (alokovatelná) heap pamět (součet všech volných heap fragmentů)<br />
maxfree = největší volný heap fragment, který je možné alokovat v jednom kuse<br />
nget = celkový počet alokací (volání malloc/calloc) (včetně vnitřních volání interních FULL-C funkcí v SDS)<br />
nrel = celkový počet uvolnění předchozích alokací (volání free() funkce)<br />
Druhý řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
bc_locked = kolik bajtů paměti je využito (uzamčeno) pro 'bytecode' vašeho FULL-C (kolik si vzal samotný kód FULL-C programu v paměti)<br />
stackTop = kolik bajtů zásobníku (stacku) je v tento okamžik využito (pokud je to na limitu, víte, že musíte upravit nastavení při překladu)<br />
(of X) = kolik bajtů může nejvíce zásobník (stack) zabrat z celé paměti (nastaveno uživatelem před překladem)<br />
<br />
<br />
<br />
>>>>>>>>>>>> Následující informace je platná pouze pro firmware 10.7.2017 (včetně) a novější (viz také [[SDS BIG|varianty]])<br />
<br />
* SDS ukazuje aktuální využití své 64kB nebo 128kB nebo 512kB programové paměti, na webové stránce v administraci.<br />
<pre><br />
FC: VER 0x08, PROGMEM 128kB<br />
MEM STATS:<br />
- HEAP: used=(492 of 120675), totfree=120164 (biggest=65396), num(get=11,rel=0)<br />
- STACK: used=(364 of 10004)<br />
- BC: locked=(264+128+388)<br />
- SYS: free=280<br />
</pre><br />
Jak to dékodovat: první řádek ukazuje informace o SDS:<br />
VER = verze FC<br />
PROGMEM = varianta hardware (64kB nebo 128kB nebo 512kB celkové paměti pro program a data)<br />
Druhý řádek ukazuje celkové využití paměti a počet alokací a uvolnění:<br />
HEAP used = celkem alokovaná paměť (heap malloc, a všechny interní FULL-C funkce a interní data v SDS)<br />
totfree = celkem zbývající volná (alokovatelná) heap pamět (součet všech volných heap fragmentů)<br />
biggest = největší volný heap fragment, který je možné alokovat v jednom kuse<br />
nget = celkový počet alokací (volání malloc/calloc) (včetně vnitřních volání interních FULL-C funkcí v SDS)<br />
nrel = celkový počet uvolnění předchozích alokací (volání free() funkce)<br />
Druhý řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
STACK used = kolik bajtů zásobníku (stacku) je v tento okamžik využito (pokud je to na limitu, víte, že musíte upravit nastavení při překladu)<br />
Třetí řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
BC locked = kolik bajtů paměti je využito (uzamčeno) pro 'bytecode' vašeho FULL-C (kolik si vzal samotný kód FULL-C programu v paměti)<br />
Čtvrtý řádek nemá pro FULL-C význam:<br />
SYS = interní hodnota<br />
<br />
----<br />
<br />
== Jak funguje FULL-C v SDS ==<br />
<br />
Zde jsou popsány hlubší technologické detaily popisující princip FULL-C. Zajímat budou zejména ty, kteří pracují na složitých programech.<br />
<br />
Program je uživatelem zadán jako '''jeden jediný textový soubor - zdrojový kód v jazyce FULL-C'''. Tento zdrojový kód (text) je zpracován v naší Windows aplikaci (FULLC.exe, k dispozici ke stažení na této WiKi) do formy výsledného souboru, který primárně obsahuje tzv. ''bytecode''. Tento soubor je následně přes síť nahrán do konkrétního zařízení SDS, kde je trvale uložen (až do nahrání jiného souboru) a je zařízením SDS spouštěn.<br />
<br />
== Komprese ==<br />
<br />
Program je přenášen z FULLC.exe do SDS přes počítačovou síť. Aby se nemuselo přenášet tolik dat, je bytecode komprimován. Typická úspora je 25% původního objemu.<br />
<br />
S touto informací je potřeba plánovat při navrhování rozložení paměti - aby se tam vše vešlo. To že komprimovaný program (výstup FULLC.exe) se do paměti SDS na první pohled "vleze", ještě neznamená, že se program i podaří spustit (stále se může "vlézt", ale nezbude místo na zásobník nebo haldu - a to je konec).<br />
<br />
<br />
'''ZÁKLADNÍ OMEZENÍ''':<br />
<br />
Zařízení SDS je k dispozici ve třech základních variantách: varianta "64" má k dispozici 64kB paměti pro celkové potřeby programu, a varianta "128" má k dispozici 2x64kB (tj. 128kB) paměti pro celkové potřeby programu. Varianta "512" nabízí největší dostupnou paměť pro program a data.<br />
<br />
Do celé této celkové paměti se musí vlézt nejen surový ''bytecode'' ale i všechny provozní záležitostí (zásobník - stack, proměnné, halda - heap).<br />
<br />
<br />
'''Skladba paměti - varianta "64":'''<br />
<br />
(START I-64kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ instrukce programu (bytecode)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ halda (heap)<br />
...<br />
64kB + konec <br />
<br />
(KONEC I-64kB BLOKU)<br />
<br />
Další paměť (více než 1x 64kB) už není ve variantě "64" k dispozici - vše se tedy musí vlézt do jednoho 64kB velkého bloku. Pokud to pro vaše potřeby nestačí, musíte použít variantu s pamětí 128kB nebo 512kB, které jsou popsány dále.<br />
<br />
<br />
'''Skladba paměti - varianta "128":'''<br />
<br />
(START I-64kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ první část haldy (heap-1)<br />
...<br />
64kB + konec <br />
<br />
(KONEC I-64kB BLOKU)<br />
<br />
(START II-64kB BLOKU)<br />
<br />
0 + instrukce programu (bytecode)<br />
...<br />
+ druhá část haldy (heap-2), jen pokud nezabere program celý II-64kB blok<br />
...<br />
64kB + konec<br />
<br />
(KONEC II-64kB BLOKU)<br />
<br />
Jak lze vidět, varianta "128" nabízí dva bloky po 64kB. Tyto bloky na sebe sice lineárně nenavazují (tj. součtem je to sice 128kB, ale ne v celku), nicméně přináší významnou úlevu předchozímu omezení původní varianty "64".<br />
<br />
Pro použití varianty "128" je ovšem potřeba mít správný hardware (SDS), tzn. SDS výrobní varianty "64" nelze programově změnit na variantu "128" - to lze jedině použitím vhodného SDS hardware. Samozřejmě program původně určený pro "64" lze na SDS "128" spustit, bez jakýchkoliv omezení (ale naopak, program 128 nelze na 64 spustit, protože varianta 64 nemá dost paměti pro program varianty 128).<br />
<br />
<br />
'''Skladba paměti - varianta "512":'''<br />
<br />
(START I-504kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ první část haldy (heap-1)<br />
...<br />
504kB + konec <br />
<br />
(KONEC I-504kB BLOKU)<br />
<br />
(START II-8kB BLOKU)<br />
<br />
0 + druhá část haldy (heap-2)<br />
...<br />
8kB + konec<br />
<br />
(KONEC II-8kB BLOKU)<br />
<br />
SOUČET: celková dostupná paměť 504+8 = 512kB<br />
<br />
Jak lze vidět, varianta "512" nabízí dva bloky, jeden 504kB a druhý 8kB. V součtu je k dispozici 512kB paměti, která je (dle rozpisu uvedeného výše) rozdělena na jednotlivé dynamické části - skutečně použité velikosti každé části už pak závisí na obsahu vašeho FULL-C programu a vašem nastavení (vámi určená velikost zásobníku).<br />
<br />
Programy určené pro variantu 512 lze spustit pouze na správném typu hardware - SDS varianty 512.<br />
<br />
<br />
'''Další informace:'''<br />
<br />
Velikost programu (bytecode + stringblob) a proměnných (variables) je pevná, a je přímo dána vámi tj. programátorem (podle toho, jaký napíšete program, tak bude tato oblast velká).<br />
<br />
Zbytek je použit pro haldu (heap), což je různě veliký paměťový prostor který má program k dispozici (funkce: malloc, realloc, free), pokud jej tedy potřebuje. Pokud bude váš program moc velký, pak se může stát že halda nemusí existovat - a systém nebude schopen takový program vůbec spustit ! Vždy je potřeba mít haldo o velikosti alespoň hodnoty 1/8 velikosti programu.<br />
<br />
Zásobník (stack) je vždy umístěn na začátku paměťového prostoru, a jeho velikost je opět jednorázově určena programátorem (podle odhadu nebo aktuální měření). Pokud je zásobník příliš malý, může být program předčasně ukončen (řešením je zvětšení velikosti zásobníku (na úkor velikosti heapu) a nové nahraní programu do zařízení). Toto je zřejmě nejčastější problém u většiny FULL-C programů - špatně nastavená velikost zásobníku.<br />
<br />
Informace o aktuálním vyžití celého paměťového prostoru je k dispozici ve webovém rozhraní SDS (Menu, FULL-C). Odsud lze také přečíst skutečné využití zásobníku (nejvyšší dosažená velikost).<br />
<br />
<br />
== Heap ==<br />
<br />
Typický FULL-C program v zařízení SDS nemá potřebu používat haldu (heap) - typicky všechny proměnné (i velká pole) lze bez problému staticky deklarovat.<br />
<br />
Pokud však potřebujete dynamickou alokaci paměti, tak je k dispozici ten zbytek paměťového prostoru, který zůstane "volný" po nahrání programu (a vyhrazení zásobníku).<br />
<br />
Informace o velikosti volného heapu a fragmentaci lze opět nalézt ve webovém rozhraní SDS.<br />
<br />
<br />
== Opakování varování ==<br />
<br />
Velikost programu je omezena takto:<br />
<br />
* varianta SDS 64kB: vše se musí vlézt do 64kB (bytecode, proměnné, zásobník) <br />
* varianta SDS 128kB: vše se musí vlézt do 2x 64kB (128kB s danými omezeními, především bytecode omezen na 64kB protože se musí celý vlézt do jednoho bloku)<br />
* varianta SDS 512kB: vše se musí vlézt do 512kB, přičemž součet velikosti (bytecode, všechny proměnné, zásobník) je do velikosti 504kB (vše další je dostupné jako heap)<br />
* Zásobník (stack) musí mít dostatečnou velikost pro provoz programu (všechny vnořené volání funkcí, rekurze, atd.).<br />
* Halda (heap) musí být k dispozici o dostatečné velikosti, jinak se jakýkoliv program nespustí.<br />
<br />
Pokud by váš přeložený program byl moc velký, a to tak že se spolu s ním do paměti nevlezou další potřebné věci (zásobník atd.), nebudete moct program na zařízení SDS spustit.<br />
<br />
Vždy můžete kontrolovat stav programu (a využití paměti) na stránce "FULL-C" ve webové administraci zařízení SDS.<br />
<br />
<br />
== Jak programovat ==<br />
<br />
FULL-C program musí vždy mít definovanou funkci '''main()''', která je první spuštěnou funkcí v rámci spuštění programu.<br />
<br />
<syntaxhighlight lang="c"><br />
void main(void)<br />
{<br />
;<br />
}<br />
</syntaxhighlight><br />
<br />
Je úkolem programátora, aby funkce '''main()''' nebyla opuštěna (potom je program "ukončen" protože nemá kam dál pokračovat) = v takovém případě je program ukončen, a znovu bude spuštěn až po restartu SDS (nebo když by byl nahrán nový program, tak je pak spuštěn ten).<br />
<br />
FULL-C program tedy vždy začíná jako první provádět instrukce ve funkci '''main()'''.<br />
<br />
<br />
V základu lze činnosti provádět na základě těchto vstupů:<br />
<br />
* čas (např. každou vteřinu)<br />
* hardware (např. čtení vstupů)<br />
* hodnoty [[FULL-C: sharing|sdílených proměnných]] (např. změnou proměnné z uživatelské webové stránky)<br />
<br />
Výstupy programu mohou být:<br />
<br />
* ovládání hardware (např. spínání relé)<br />
* změna hodnot sdílených proměnných (např. pro dynamické zobrazení na uživatelské webové stránce)<br />
* odesílání stavů přes síť (např. HTTP-GET nebo SNMP-TRAP)<br />
<br />
<br />
Pro všechny tyto vypsané činnosti je potřeba znát [[FULL-C: functions|funkce a příkazy]], které programu umožní právě takovéto činnosti vykonávat.<br />
<br />
<br />
== OPTIMALIZACE KÓDU a jak je SDS vůbec rychlé ? ==<br />
<br />
Bylo provedeno detailní měření na SDS-BIG 128 a SDS-BIG 512, a postupy jsou použitelné pro všechna BIG a BIG2 zařízení.<br />
<br />
Pokud není uvedeno jinak, měřilo se při nezatížené síti. U SDS-BIG 64 lze očekávat prakticky stejné hodnoty jako u SDS-BIG 128, protože má stejnou frekvenci CPU.<br />
<br />
'''Časy uvedené v textu platí pro SDS-BIG 64/128.''' SDS-BIG 512 je téměř ve všem cca 3,5x rychlejší (viz tabulka). Jedinou výjimkou jsou makra s parametry. Všechny tipy platí pro obě varianty stejně.<br />
<br />
=== Základní orientace ===<br />
<br />
* Jeden jednoduchý příkaz (např. <code>x = y + z;</code>) trvá cca '''60–150 µs''', tj. řádově 10 000 jednoduchých příkazů za sekundu. Hlavní smyčka se 100 příkazy tak trvá cca 10 ms na jeden průchod.<br />
* Samotný výpočet je zanedbatelný: <code>+ - * / %</code>, 64bitová i float aritmetika trvají stejně. O rychlosti rozhoduje počet příkazů a způsob zápisu programu (viz tipy níže).<br />
* Výsledky měření jsou velmi opakovatelné (±0,1 %). Při nezatížené síti spotřebuje ostatní činnost SDS jen cca 2 % výkonu.<br />
<br />
=== Naměřené časy ===<br />
Platí pro SDS-BIG, BIG2 a všechny varianty (SMALL atd.) odvozené od BIG a BIG2.<br />
<br />
{| class="wikitable"<br />
! Zápis !! SDS-BIG 64/128 !! SDS-BIG 512<br />
|-<br />
| prázdný cyklus <code>for (i = 0; i < n; i++) { }</code>, jeden průchod || 109 µs || 31 µs<br />
|-<br />
| <code>for (i = n; i--; ) { }</code> / <code>while (i--) { }</code>, jeden průchod || 52 / 46 µs || 15 / 13 µs<br />
|-<br />
| <code>x = 5;</code> (x je lokální proměnná) || cca 60 µs || cca 17 µs<br />
|-<br />
| <code>x = y + z;</code> || cca 105 µs || cca 31 µs<br />
|-<br />
| <code>x++;</code> / <code>++x;</code> / <code>x += 1;</code> / <code>x = x + 1;</code> || 57 / 49 / 70 / 102 µs || 17 / 14 / 20 / 30 µs<br />
|-<br />
| konstanta: číslo / enum / <code>#define</code> (definované těsně před použitím) || +0 / +7 / +21 µs || +0 / +2 / +6 µs<br />
|-<br />
| konstanta: enum / <code>#define</code> (definované na začátku velkého programu) || +47 / +62 µs || +15 / +19 µs<br />
|-<br />
| globální proměnná, čtení / zápis (deklarovaná na začátku programu), oproti lokální || +32 / +90 µs || +11 / +31 µs<br />
|-<br />
| globální proměnná, čtení / zápis (deklarovaná těsně před použitím), oproti lokální || +7 / +13 µs || +2 / +4 µs<br />
|-<br />
| makro s parametry, např. <code>SQR(y)</code> || 870–1600 µs (!) || cca 3550 µs (!)<br />
|-<br />
| totéž jako funkce <code>sqr(y)</code> / rozepsané <code>y * y</code> || cca 195 / 105 µs || cca 60 / 31 µs<br />
|-<br />
| volání prázdné funkce bez parametrů || cca 105 µs || cca 36 µs<br />
|-<br />
| každý parametr funkce / každá lokální proměnná ve volané funkci, na každé volání || +35 / +65 µs || +10 / +18 µs<br />
|-<br />
| příkaz, který se neprovede (uvnitř nesplněné podmínky <code>if</code>) || cca 80 µs || cca 25 µs<br />
|-<br />
| volání funkce, které se neprovede (bez ohledu na velikost funkce) || cca 20 µs || cca 6 µs<br />
|-<br />
| <code>switch</code> nebo řetězec <code>if – else if</code>, na každou větev (bez ohledu na to, která platí) || cca 80–100 µs || cca 25–35 µs<br />
|-<br />
| tabulka hodnot <code>x = tab[k];</code> || cca 120 µs || cca 35 µs<br />
|-<br />
| <code>SDS_get_u32()</code> / <code>SDS_set_u32()</code> || cca 155 / 250 µs || cca 48 / 79 µs<br />
|-<br />
| 8 vstupů: 8x <code>SDS_get_u32()</code> / 1x <code>SDS_get_a()</code> || 1400 / 320 µs || 416 / 98 µs<br />
|-<br />
| <code>memcpy</code>, <code>strcpy</code>, <code>strcmp</code>, <code>strlen</code>, <code>snprintf</code>, <code>atoi</code>, ... (jedno volání) || 200–340 µs || 60–110 µs<br />
|-<br />
| kopie 64 bajtů vlastním cyklem / pomocí <code>memcpy</code> || 11–18 ms / 0,34 ms || 3,1–5,2 ms / 0,11 ms<br />
|-<br />
| <code>printf()</code> || cca 360 µs + 2,7 µs na znak || cca 110 µs + 1,1 µs na znak<br />
|-<br />
| <code>putchar()</code>, na každý znak || cca 375 µs || cca 115 µs<br />
|-<br />
| <code>wait(0)</code> / <code>wait(N)</code> || 0,6 ms / N ms + 0,5–0,7 ms || 0,19 ms / N ms + 0,1–0,15 ms<br />
|-<br />
| <code>echoclear()</code> || cca 1 ms || cca 0,5 ms<br />
|}<br />
<br />
=== Proměnné a konstanty ===<br />
<br />
* '''Nejčastěji používané proměnné funkce (čítače cyklů, mezisoučty) deklarujte jako poslední''' v seznamu deklarací. Proměnná deklarovaná později je rychlejší: čítač cyklu deklarovaný jako první z 27 lokálních proměnných zpomalí každý průchod cyklem o 38 µs, deklarovaný jako poslední nezpomalí nic.<br />
* '''Konstanty, globální proměnné a enum deklarujte co nejblíže místu použití''', např. těsně před funkcí, která je používá, nebo těsně před <code>main()</code> pro hlavní smyčku. Totéž definované na začátku velkého programu je výrazně pomalejší (viz tabulka). Navíc je to i čitelnější: definice je hned u použití.<br />
* '''Méně globálních položek = rychlejší program.''' Každá další globální proměnná, funkce nebo konstanta mírně zpomalí přístup ke všemu, co je v programu deklarováno před ní, včetně volání funkcí SDS.<br />
** Související globální proměnné spojte do jedné struktury (<code>struct</code>). Přístup k položce struktury stojí jen cca +14 µs.<br />
** Nevytvářejte zbytečně mnoho drobných globálních pomocných funkcí.<br />
* '''Používejte lokální proměnné.''' Na začátku funkce si zkopírujte globální proměnné a nastavení do lokálních proměnných, v cyklu pracujte s lokálními a výsledek zapište do globální proměnné jen jednou na konci.<br />
* '''Pro pojmenované konstanty používejte <code>enum</code> místo <code>#define</code>.''' <code>#define</code> je o cca 14 µs pomalejší než enum na stejném místě v programu. <code>#define</code> použijte jen tam, kde ho FULL-C vyžaduje (velikost pole).<br />
* '''Nepoužívejte makra s parametry''' (<code>#define SQR(a) ((a)*(a))</code>) v často prováděném kódu.<br />
** Stojí 870–1600 µs na každé použití a jejich rychlost se mění s velikostí programu a stavem paměti.<br />
** Na SDS-BIG 512 jsou dokonce pomalejší než na SDS-BIG 128 (cca 3550 µs).<br />
** Použijte funkci (cca 195 µs, na SDS-BIG 512 cca 60 µs) nebo výraz rozepište.<br />
* Nastavení, které uživatel mění, může zůstat na začátku programu jako <code>#define</code> nebo globální proměnná. Často prováděný kód si ale tyto hodnoty na začátku funkce zkopíruje do lokálních proměnných.<br />
* '''Nedeklarujte proměnné uvnitř těla cyklu''' (<code>for (...) { int t; ... }</code>). Funguje to, ale deklarace se provádí při každém průchodu (+25 µs, na SDS-BIG 512 +8 µs). Deklarujte na začátku funkce.<br />
<br />
=== Cykly ===<br />
<br />
* '''Cyklus směrem dolů je dvakrát rychlejší:''' <code>for (i = n; i--; ) { ... }</code> trvá 52 µs na průchod, <code>for (i = 0; i < n; i++)</code> 109 µs. V těle cyklu má i hodnoty n-1 ... 0. <code>while (i--)</code> je stejně rychlý.<br />
* <code>while (i < n) { ...; i++; }</code> ani <code>do { } while ()</code> nejsou rychlejší než <code>for</code>.<br />
* <code>++i</code> je o něco rychlejší než <code>i++</code>, <code>i += 1</code> je pomalejší.<br />
* '''Nikdy nepoužívejte globální proměnnou jako čítač cyklu''' (+113 µs na každý průchod).<br />
* Mez cyklu jako číslo nebo lokální proměnná nic nestojí. Jako globální proměnná stojí +29 µs na průchod, jako <code>#define</code> +56 µs na průchod. Zkopírujte ji předem do lokální proměnné.<br />
* Nejvíc ušetříte tím, co z cyklu vyjmete: každý příkaz uvnitř cyklu stojí cca 100 µs na každý průchod.<br />
<br />
=== Podmínky a kód, který se neprovede ===<br />
<br />
* '''I kód, který se neprovede, zabírá čas.''' Příkaz uvnitř nesplněné podmínky stojí cca 80 µs, skoro stejně jako provedený (cca 100 µs).<br />
* '''Velké, zřídka prováděné bloky přesuňte do samostatné funkce.''' Neprovedené volání funkce stojí jen cca 20 µs, bez ohledu na to, jak je funkce velká.<br />
* '''<code>return</code> čas neušetří.''' Volání funkce trvá úměrně délce celé funkce, ne jen té části, která se provedla. Často volané funkce udržujte krátké.<br />
* '''<code>switch</code> i řetězec <code>if – else if</code> stojí cca 80–100 µs na každou větev''', bez ohledu na to, která větev platí: 2 větve cca 270 µs, 8 větví cca 770–940 µs.<br />
* '''Kde to jde, použijte tabulku hodnot''' místo dlouhého <code>switch</code> nebo řetězce <code>if</code> (<code>x = tab[k];</code> cca 120 µs). Tabulku naplňte kódem na začátku programu, protože FULL-C nepovoluje inicializaci pole v deklaraci.<br />
* <code>&&</code> pravou stranu sice neprovede, ale i tak stojí čas.<br />
* Ternární operátor <code>?:</code> trvá stejně jako <code>if / else</code> a vždy vyhodnotí obě strany. '''Používejte ho jen s čísly''': s řetězci (<code>ok ? "OK" : "CHYBA"</code>) se program zastaví s chybou "first argument to '?' should be a number".<br />
<br />
=== Výrazy a příkazy ===<br />
<br />
* Méně příkazů je rychlejší: jeden výraz <code>x = ((y+z)*(y-z))/3;</code> trvá 233 µs, totéž rozdělené do 4 příkazů 393 µs.<br />
* Používejte zkrácené zápisy: <code>x++</code> 57 µs, <code>x += 1</code> 70 µs, <code>x = x + 1</code> 102 µs.<br />
* Bitový posun a násobení / dělení trvají stejně, <code>* 8</code> není třeba nahrazovat zápisem <code><< 3</code>.<br />
<br />
=== Datové typy ===<br />
<br />
* <code>int64_t</code>, <code>uint64_t</code> ani <code>float</code> nejsou pomalejší než <code>int</code>, používejte je bez obav.<br />
* <code>char</code> ani <code>short</code> nejsou rychlejší než <code>int</code>.<br />
* <code>ftoi()</code> je pomalejší než přetypování <code>(int)</code> (199 µs proti 146 µs).<br />
<br />
=== Funkce ===<br />
<br />
* '''Funkce jsou dost rychlé na to, abyste mohli psát přehledný kód:''' volání stojí cca 100 µs, tedy zhruba jako jeden příkaz. Rozdělte program do funkcí podle úkolů.<br />
* Každý parametr prodlouží volání o cca 35 µs, každá lokální proměnná deklarovaná ve volané funkci o cca 65 µs, každá další úroveň vnoření volání o cca 90 µs.<br />
* Malé, často volané funkce by měly pracovat jen se svými parametry, bez vlastních lokálních proměnných.<br />
* Pro předání většího množství dat předejte ukazatel na strukturu místo mnoha parametrů.<br />
* Vyhněte se řetězcům drobných obalových funkcí a rekurzi (stojí čas i místo v zásobníku).<br />
* Velikost zásobníku (STACK) nastavená ve FULLC.exe musí pokrýt nejhlubší vnoření volání.<br />
<br />
=== Řetězce a paměť ===<br />
<br />
* '''Vždy používejte knihovní funkce''' (<code>memcpy</code>, <code>memset</code>, <code>strcpy</code>, <code>strlen</code>, <code>strcmp</code>, <code>snprintf</code>, <code>atoi</code>, <code>strtoul</code>, ...). Jedno volání stojí 200–340 µs bez ohledu na délku dat. Totéž vlastním cyklem je 20–50x pomalejší: kopie 64 bajtů v cyklu trvá 11–18 ms.<br />
* <code>snprintf</code> včetně formátu <code>%0.2f</code> funguje a stojí cca 260–340 µs.<br />
* '''Nepoužívejte <code>malloc</code> / <code>free</code> v cyklech.''' Fragmentace haldy (heap) zpomaluje program a může způsobit selhání síťových funkcí. Paměť alokujte jednou na začátku programu, nebo použijte pevná pole. Nechte dostatek volné haldy pro síťové funkce.<br />
<br />
=== Funkce SDS (set a get) ===<br />
<br />
* <code>SDS_get_*()</code> stojí cca 155 µs, <code>SDS_set_u32()</code> cca 250 µs.<br />
* '''Kde to tabulka indexů umožňuje (označení "(a)"), čtěte bloky pomocí <code>SDS_get_a()</code>''': 8 vstupů jedním voláním za 320 µs místo 1400 µs. Pro optovstupy jen na firmware, kde je opravena známá chyba 5 (viz níže).<br />
* Hodnotu přečtěte jednou za průchod do lokální proměnné a dál používejte tu.<br />
* <code>SDS_get_a()</code> vyplní jen tolik položek, kolik jich daný hardware má. Požadujete-li víc, funkce nevyplní nic a nehlásí chybu. Proto vždy žádejte jen skutečný počet položek. Např. SDS-BIG 512 (BIG2): 9 optovstupů, 6 relé, 8 A/D vstupů, 9 S0 vstupů.<br />
<br />
=== Konzole (printf) ===<br />
<br />
* <code>printf()</code> stojí cca 360 µs + 2,7 µs na znak. <code>putchar()</code> stojí cca 375 µs '''na každý znak''', proto nikdy netiskněte po znacích.<br />
* Celý řádek si připravte pomocí <code>snprintf()</code> a vytiskněte ho jedním voláním.<br />
* Plná konzole tisk nezablokuje ani nezpomalí, ale její kapacita je omezená (BIG: pod cca 14 kB výstupu). Tiskněte stručně.<br />
* Konzole (echo.htm) je HTML stránka: znak <code><</code>, za kterým následuje písmeno nebo číslice, se bere jako HTML značka a část textu se nezobrazí. Ve výpisech se znaku <code><</code> vyhněte.<br />
<br />
=== wait() a měření času ===<br />
<br />
* '''SDS-BIG 64/128:''' <code>wait(N)</code> trvá N ms + cca 0,5–0,7 ms, <code>wait(0)</code> 0,6 ms. Při silném zatížení sítě může <code>wait(N)</code> trvat až o cca 1,7 ms déle.<br />
* '''SDS-BIG 512:''' <code>wait(N)</code> trvá N ms + cca 0,1–0,15 ms, <code>wait(0)</code> 0,19 ms.<br />
* <code>wait(0)</code> nepoužívejte jen pro "uvolnění" procesoru.<br />
* Pro měření času použijte index 45 (uptime v ms).<br />
* Pro přesná měření lze použít index 137 (čítač cyklů CPU). Na SDS-BIG 64/128 má 168 kroků na 1 µs a přeteče cca po 25 s, na SDS-BIG 512 má 480 kroků na 1 µs a přeteče cca po 9 s.<br />
<br />
=== Sériová linka (UART) ===<br />
<br />
Měřeno na COM6 s propojeným TX a RX, při rychlostech 9600–460800 Bd. Ve všech testech, i při silném zatížení sítě, proběhl přenos bez jediné chyby. RS485 na COM1 nebyla měřena.<br />
<br />
{| class="wikitable"<br />
! !! SDS-BIG 64/128 !! SDS-BIG 512<br />
|-<br />
| <code>SDS_serial_writeCH()</code>, na každý bajt || cca 0,5 ms || cca 0,16 ms<br />
|-<br />
| <code>SDS_serial_write()</code>, jedno volání || cca 0,85 ms + 1,6 µs na bajt || cca 0,37 ms + 0,6 µs na bajt<br />
|-<br />
| vysílací buffer (<code>SDS_serial_write()</code> se vrací ihned) || cca 600 B || nejméně 1024 B<br />
|-<br />
| přijímací buffer || nejméně 1024 B || nejméně 1024 B<br />
|-<br />
| <code>SDS_serial_read()</code>, když žádná data nečekají || cca 0,35 ms || cca 0,11 ms<br />
|-<br />
| nejkratší dotaz – odpověď (zápis až přečtení), kromě doby přenosu po lince || cca 4 ms (pod zátěží sítě až 6 ms) || cca 1,2 ms (pod zátěží sítě až 2,6 ms)<br />
|-<br />
| data lze přečíst po příchodu posledního bajtu za || cca 2,5 ms || cca 0,7–0,8 ms<br />
|}<br />
<br />
* '''Data odesílejte jedním voláním <code>SDS_serial_write()</code>''', nikdy po znacích pomocí <code>SDS_serial_writeCH()</code> v cyklu: 64 bajtů po znacích trvá 33–40 ms na SDS-BIG 128 a 10 ms na SDS-BIG 512, při jakékoliv rychlosti linky.<br />
* <code>SDS_serial_write()</code> se vrací ihned, aniž čeká na odvysílání, pokud se data vejdou do vysílacího bufferu. Při větším objemu čeká, dokud se zbytek do bufferu nevejde: na SDS-BIG 128 čekalo 1024 B při 115200 Bd 34 ms.<br />
* Přijímací buffer pojme nejméně 1024 B, takže program nemusí číst nepřetržitě.<br />
* <code>SDS_serial_read()</code> nevolejte v rychlé smyčce, protože stojí čas i bez dat. Stačí jednou za průchod hlavní smyčkou nebo po <code>wait()</code>.<br />
* Přijatá data jsou programu k dispozici se zpožděním (viz tabulka). U krátkých zpráv při vysokých rychlostech toto pevné zpoždění převažuje, takže vyšší rychlost linky pomůže hlavně u velkých bloků dat.<br />
<br />
=== MQTT ===<br />
<br />
* '''Nevolejte další funkci <code>mqtt_*()</code>, dokud předchozí není dokončena''': u publish, subscribe a unsubscribe sledujte <code>[12202]</code>, u connect a disconnect <code>[12200]</code>. Ve FW starším než 31.10.2026 takové volání poruší stav spojení (viz Známé chyby níže).<br />
* '''Stav spojení <code>[12200]</code> kontrolujte při každém průchodu hlavní smyčkou''' a v případě potřeby spojení obnovte postupem uvedeným v části Známé chyby. Po každém novém připojení je potřeba znovu provést subscribe, protože se tabulka přihlášení maže.<br />
* Po normálním <code>mqtt_disconnect()</code> skončí <code>[12200]</code> na hodnotě −2, ne 0. Považujte 0 i −2 za "odpojeno".<br />
* Kontrola stavu v čekací smyčce stojí čas (cca 0,3 ms na SDS-BIG 128). Do takové smyčky dejte <code>wait(10)</code>.<br />
<br />
{| class="wikitable"<br />
! !! SDS-BIG 128, FW starší než 10.2026 !! SDS-BIG 128, FW od 31.10.2026 včetně !! SDS-BIG 512, FW od 31.10.2026 včetně<br />
|-<br />
| <code>mqtt_connect()</code> || cca 0,2–0,45 s || cca 0,45 s || cca 2 ms<br />
|-<br />
| publish (do potvrzení brokerem) || cca 0,3–0,65 s (průměr 0,5 s) || cca 3–6 ms || cca 0,9 ms<br />
|-<br />
| nejvyšší počet publish za sekundu || cca 2 || cca 250 || cca 1000<br />
|-<br />
| zpráva přes broker a zpět || cca 0,5 s || cca 6 ms || cca 1,7 ms<br />
|-<br />
| subscribe / unsubscribe / disconnect || cca 0,3–0,65 s || cca 3–4 ms || cca 1 ms<br />
|-<br />
| při silném zatížení sítě || beze změny (cca 0,5 s) || většina publish 7–15 ms, některé až cca 1,5 s || publish cca 1,3–1,9 ms, výjimečně až cca 50 ms, cca 600 zpráv za sekundu<br />
|}<br />
<br />
* Pro FW starší než 10/2026: délka operace nezávisí na velikosti dat, a protože každá operace trvá cca 0,5 s:<br />
** na dokončení publish v hlavní smyčce nečekejte. Zavolejte <code>mqtt_publish()</code>, pokračujte v jiné práci a <code>[12202]</code> zkontrolujte při dalším průchodu;<br />
** '''posílejte více hodnot v jedné zprávě''' (např. JSON, celkem do cca 1465 znaků včetně názvu položky): publish s 1024 B trvá stejně dlouho jako s 8 B.<br />
* '''Firmware od 31.10.2026 včetně:''' čekat na dokončení publish lze, jedna operace trvá jednotky ms. Vždy ale používejte časový limit alespoň 3–5 s, protože při zatížení sítě může operace výjimečně trvat i cca 1,5 s.<br />
<br />
==== Známé chyby firmware (MQTT) ====<br />
<br />
'''1. Volání <code>mqtt_*()</code> dříve, než skončila předchozí operace, poruší stav spojení''' (FW starší než 31.10.2026)<br />
* Zavoláte-li např. <code>mqtt_publish()</code> ve chvíli, kdy předchozí publish ještě probíhá, zapíše se chybový kód −3 do <code>[12200]</code> (místo do <code>[12202]</code>). <code>[12200]</code> pak zůstane trvale na −3, přestože spojení ve skutečnosti funguje, a program se tak jeví jako odpojený.<br />
* Následné přímé zavolání <code>mqtt_connect()</code> selže s výsledkem −7 (při CONNACK 0).<br />
* Ochrana: nikdy nevolejte další funkci <code>mqtt_*()</code> před dokončením předchozí (viz MQTT výše).<br />
* Obnova spojení, která funguje ve všech verzích firmware:<br />
*# pokud <code>[12200]</code> není 4, 0 ani −2, zavolejte <code>mqtt_disconnect()</code>;<br />
*# počkejte, až bude <code>[12200]</code> rovno 0 nebo −2 (cca 0,3 s);<br />
*# počkejte dalších 500 ms;<br />
*# zavolejte <code>mqtt_connect()</code> a počkejte na hodnotu 4;<br />
*# znovu proveďte subscribe všech položek.<br />
<br />
'''2. Po <code>mqtt_disconnect()</code> skončí <code>[12200]</code> na −2 místo 0''' (všechny testované verze firmware)<br />
* Hodnota −2 v tomto případě neznamená chybu: považujte 0 i −2 za "odpojeno". Příklad, který po odpojení čeká pomocí <code>if (sys[2200] <= 0) goto error;</code>, by normální odpojení vyhodnotil jako chybu.<br />
<br />
=== Zatížení sítě a rezerva výkonu ===<br />
<br />
* '''SDS-BIG 64/128:'''<br />
** Při nezatížené síti spotřebuje ostatní činnost SDS cca 2 % výkonu a program není nikdy přerušen na déle než cca 0,6 ms.<br />
** Při silném zatížení (ping a HTTP dotazy z jednoho PC) spotřebuje 15–19 % výkonu. Program pak běží o cca 18–20 % pomaleji a je často přerušován, ale nikdy na déle než cca 1,5 ms.<br />
* '''SDS-BIG 512:'''<br />
** Při nezatížené síti spotřebuje ostatní činnost SDS cca 1 % výkonu a program není přerušen na déle než cca 0,03 ms.<br />
** Při silném zatížení (ping a HTTP dotazy z jednoho PC) spotřebuje ostatní činnost cca 45 % výkonu a program běží cca 1,8x pomaleji. I tak je ale stále cca 2x rychlejší než SDS-BIG 128 bez zátěže.<br />
** Občas, pravděpodobně při otevření stránky webového rozhraní přes HTTPS, se objeví jednotlivá pauza cca 10–25 ms. Programy s krátkými časovými limity (např. sériové protokoly) musí takovou pauzu snést.<br />
* '''U zařízení se silným síťovým provozem počítejte s rezervou výkonu''': cca 25 % na SDS-BIG 64/128, cca 50 % na SDS-BIG 512. Poměry mezi časy i všechny tipy výše platí i pod zátěží.<br />
<br />
=== Sběrnice 1-Wire ===<br />
<br />
* '''Pokud sběrnici 1-Wire nepoužíváte, zavolejte hned na začátku programu <code>SDS_disable_onewire()</code>.'''<br />
* Na SDS-BIG 512 s firmwarem starším než 31.10.2026 může odpojené čidlo 1-Wire program extrémně zpomalit (určitě si aktualizujte firmware!).<br />
* Stav 1-Wire masteru lze zkontrolovat čtením indexu 2998: 1 = detekce, 2 nebo 4 = chyba, 8 = v provozu, 16 = vypnuto.<br />
<br />
=== Známé chyby ve starším firmware (starší než 31.10.2026) ===<br />
<br />
'''1. Odpojené čidlo 1-Wire zpomalí program cca 125x''' (opraveno ve FW od 31.10.2026 včetně)<br />
* Pokud je v SDS evidováno dříve nalezené čidlo 1-Wire, které je fyzicky odpojené, zpomalí se FULL-C program cca 125x. Zpomalení začne, jakmile se 1-Wire master rozběhne (cca 7 s po startu SDS, index 2998 = 8), a program se už nezotaví.<br />
** Program pak dostane méně než 1 % výkonu: smyčka, která běžně trvá 54 µs na průchod, trvá 6,6–9,3 ms.<br />
* Ochrana: pokud 1-Wire nepoužíváte, zavolejte na začátku programu <code>SDS_disable_onewire()</code>. S ním běží program trvale plnou rychlostí.<br />
* Ochrana pro starší firmware, pokud 1-Wire používáte: zajistěte, aby všechna evidovaná čidla byla připojena, nebo aktualizujte firmware.<br />
<br />
'''2. Blokové čtení optovstupů <code>SDS_get_a(151, ...)</code> vrací chybné hodnoty''' (opraveno ve FW od 31.10.2026 včetně)<br />
* SDS-BIG 512 se starším firmware: volání může způsobit restart celého SDS.<br />
* Ve FW od 31.10.2026 opraveno: blokové čtení vrací stejné hodnoty jako <code>SDS_get_u32(151 + n)</code> (0 = aktivní, 1 = neaktivní).<br />
* Ochrana pro starší firmware: čtěte optovstupy jednotlivě pomocí <code>SDS_get_u32(151 + n)</code>, nebo aktualizujte firmware.<br />
<br />
=== Co rychlost neovlivní (pište přehledně) ===<br />
<br />
* Komentáře, i uvnitř cyklů a v neprováděných blocích.<br />
* Dlouhé, výstižné názvy proměnných.<br />
* Závorky navíc.<br />
* Rozdělení programu do funkcí podle úkolů (cca jeden příkaz na každé volání).<br />
* 64bitové a float typy.<br />
* Odsazení, prázdné řádky, formátování.<br />
<br />
<br />
=== Příklad ===<br />
<br />
Pomalý, ale běžný zápis:<br />
<pre><br />
#define OPTO_FIRST 151<br />
#define NUM_INPUTS 8<br />
#define WEIGHT(a) ((a)*(a))<br />
<br />
unsigned int g_weight;<br />
<br />
void main(void)<br />
{<br />
unsigned int i;<br />
<br />
for (;;)<br />
{<br />
g_weight = 0;<br />
for (i = 0; i < NUM_INPUTS; i++)<br />
{<br />
if (SDS_get_u32(OPTO_FIRST + i) == 0) g_weight = g_weight + WEIGHT(i + 1);<br />
}<br />
wait(100);<br />
}<br />
}<br />
</pre><br />
<br />
Totéž zapsané podle tipů výše (stejně čitelné):<br />
<pre><br />
#define NUM_INPUTS 8 // velikost pole: zde je #define nutny<br />
<br />
unsigned int g_weight; // vysledek pro zbytek programu<br />
<br />
enum inputs { OPTO_FIRST = 151 }; // definovano tesne pred pouzitim<br />
<br />
void main(void)<br />
{<br />
unsigned int opto[NUM_INPUTS];<br />
unsigned int w;<br />
unsigned int i; // nejpouzivanejsi promenna deklarovana posledni<br />
<br />
for (;;)<br />
{<br />
SDS_get_a(OPTO_FIRST, (void *)opto, NUM_INPUTS * 4); // 1 volani misto 8<br />
w = 0;<br />
for (i = NUM_INPUTS; i--; ) // cyklus dolu: i = 7 .. 0<br />
{<br />
if (opto[i] == 0) w += (i + 1) * (i + 1); // bez makra s parametry<br />
}<br />
g_weight = w; // globalni promenna zapsana jen jednou<br />
wait(100);<br />
}<br />
}<br />
</pre><br />
<br />
Změny oproti první verzi:<br />
* jedno blokové čtení místo 8 volání;<br />
* žádné makro s parametry;<br />
* mezisoučet v lokální proměnné místo globální;<br />
* cyklus směrem dolů;<br />
* konstanta definovaná těsně před použitím;<br />
* čítač cyklu deklarovaný jako poslední.<br />
<br />
Podle naměřených časů trvá jeden průchod první verze na SDS-BIG 128 cca 8–15 ms (podle počtu aktivních vstupů), druhé verze cca 2–3 ms. Na SDS-BIG 512 je to cca 3,5x méně u obou verzí; u první verze je rozdíl ještě větší, protože makra s parametry jsou na SDS-BIG 512 pomalejší.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_tips_and_tricks&diff=989FULL-C: tips and tricks2026-10-31T16:16:35Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Důležité poznámky k práci s FULL-C ==<br />
<br />
Zde jsou neseřazené tipy a triky, tak, vytvořené tak, jak jak postupem času dostáváme různé dotazy od uživatelů.<br />
<br />
Současně (na konci stránky) naleznete kritické tipy a postupy, jak efektivně zapsat váš program tak, aby byl co nejvíce rychlý. Je důležité si to přečíst.<br />
<br />
<br />
* '''Dbejte na to''', aby verze FC byla '''stejná''' jak pro překladač (FULLC.EXE) tak i pro vaše SDS. Pokud má vaše SDS starší firmware (a tedy starší verzi FC, například 0x06), zatímco překladač je novější (například FULLC.exe s verzí FC 0x08), tak SDS odmítne novější FC program spustit. Toto se řeší velmi snadno, a to aktualizací firmware ve vašem SDS.<br />
<br />
<br />
* I když proběhne překlad ve FULLC.EXE v pořádku, '''stále může váš FULL-C program obsahovat chyby''' - to se dozvíte '''teprve''' z konzole (web zařízení SDS: typicky 192.168.1.250/echo.htm), proto ji '''vždy průběžně kontrolujte''' !<br />
<br />
<br />
* Pozor na ''signed'' a ''unsigned'' typy a jejich používání. FULL-C se chová dle standardu C, a detaily standardu vás mohou zmást.<br />
<br />
Např. '''char''' je signed ! (pokud jej explicitně nedefinujeme jako '''unsigned char''').<br />
<br />
Příklad - chceme vypsat HEX kód pro jednobajtový znak.<br />
<br />
Toto ale neudělá to co "chceme": vypíše to '''FFFFFFDB''' - přesně podle specifikace jazyka C, kdy dojde nejprve k převodu na int32 <br />
<syntaxhighlight lang="c"><br />
char ch = 0xDB;<br />
printf("%x", ch);<br />
</syntaxhighlight><br />
<br />
Příklad správného zápisu: vypíše to '''DB''' tak jak chceme, a to proto že jsme správně uvedli že to chceme zpracovat jako '''unsigned char'''.<br />
<syntaxhighlight lang="c"><br />
char ch = 0xDB;<br />
printf("%x", (unsigned char)ch);<br />
</syntaxhighlight><br />
<br />
Další příklad velkého problému je následující kus programu pro výpis obsahu textového pole jako HEX znaků:<br />
<syntaxhighlight lang="c"><br />
char pole[32];<br />
char * ch;<br />
<br />
ch = (char *)&pole;<br />
for (i = 0; i < 32; i++)<br />
{<br />
printf("%02x", *ch++); // <<<<<<< WARNING !!!! *ch is signed char !!!<br />
}<br />
</syntaxhighlight><br />
<br />
Opět, správné řešení je ve správném přetypování: <pre> printf("%02x", (unsigned char)*ch++); </pre><br />
<br />
<br />
* Před provedením jakékoliv síťové komunikace ve FULL-C (např. odeslání emailu), '''vždy zkontrolujte''' stav, a to pomocí: ''status = SDS_get_u(27);'' (když je ''status==0'' tak SDS nemá připojení - nezačínejte komunikaci, čekejte a testuje stav).<br />
<br />
<br />
* Pole pro uchování textů můžete přímo deklarovat, např. na zásobníku (stack) jako ''char text[128];'' - nebo na haldě (heap), pro což využijte ''text = (char *)malloc(128);'' a ''free(text);text=0;'' funkce. Výběr z těchto možností je na vás (malé pole / malé texty jdou dát na zásobník, velké už patří do haldy).<br />
<br />
<br />
* Využijte 64-bitových proměnných (int64_t nebo uint64_t) tam, kde vám 32 bitů nestačí. Například pro počítadla, nebo výpočty s velkými čísly (nebo jen stačí že by měl být velký mezivýsledek a při použití 32-bit čísel by jste o něj "přišli").<br />
<br />
<br />
* Pro zjištění, jaký největší blok paměti (heap) lze v danou chvíli alokovat pomocí ''malloc()'' funkce, využijte funkci ''SDS_heap_stats()'' . Ačkoliv může být celková hodnota volné heap pamět velká, toto celkové volné místo je vždy roztroušeno na různé malé oddělené bloky (fragmentace) - a vždy lze alokovat jen po jednom bloku, a jeho největší možná velikost je zjistitelná právě ze zmíněné funkce.<br />
<br />
<br />
* Vždy když uvolníte paměť, nezapomeňte ihned ručně vynulovat daný uvolněný ukazatel. Zabrání to chybám ve vašem programu. Příklad: <br />
<syntaxhighlight lang="c"><br />
// definice ukazatale<br />
void *ptr; <br />
<br />
...<br />
// alokujeme si pamet, pro priklad 32 bajtu<br />
ptr = malloc(32);<br />
<br />
// pamet na kterou ukazuje ptr lze ted pouzivat (pozor at nepristupujete mimo alokovany rozsah)<br />
...<br />
<br />
// uz pamet nepotrebujeme, tak ji uvolnime:<br />
free(ptr); <br />
ptr = 0; // vzdy ihned za zavolanim free() nastavte ptr do nuly !!!<br />
<br />
... <br />
</syntaxhighlight><br />
<br />
<br />
* Funkce ''printf()'' a ''puts()'' a ''putchar()'' zapisují do konzole (web zařízení SDS, typicky: 192.168.1.250/echo.htm), čehož lze využít pro ladění programu, nebo pro dálkový monitoring zařízení. Nicméně pro průběžné spolehlivé získávání hodnot a údajů z SDS nebo vašeho programu, je vhodně použít systém sdílených proměnných, nebo SNMP.<br />
<br />
<br />
* FULL-C používá právě přesně 32-bitů pro datový typ ''float''. Počítejte s touto informací pro správné pochopení přesnosti práce s desetinnými čísly (omezené rozlišení dané 32bity). Pro většinu aplikací toto nepředstavuje problém, pokud ale chcete provádět složité výpočty s desetinnými čísly, je potřeba znát tato omezení. Přesné vysvětlení viz např. [https://en.wikipedia.org/wiki/Single-precision_floating-point_format|"Single-precision floating-point format"].<br />
<br />
<br />
* Funkce ''printf()'' a ''sprintf()'' umí zpracovat ''float'' proměnné (%f), ale neumí je uživatelský formátovat (neumí např. %0.2f - ale umí jen základní %f, to znamená že vypíše úplně celou délku čísla se všemi pozicemi za tečkou, což může být i dost dlouhý text). Toto je aktualizováno v nové verzi FULL-C (tam už to jde).<br />
<br />
<br />
* '''Nepoužívejte prázdný string''' (tj. "").<br><br />
Tři příklady '''zakázaného kódu''' pro FULL-C:<br />
<syntaxhighlight lang="c"><br />
// do not do any of the following:<br />
//<br />
char text1[10] = ""; // spatne !<br />
//<br />
strncpy(text2,"",10); // spatne !<br />
//<br />
sprintf(text2,""); // spatne !<br />
</syntaxhighlight><br />
<br />
<br />
* Před použitím některé z funkcí, které přistupují k serveru na Internetu, je vhodné provést volání ''dns_resolv()'' pro zjištění aktuální IP adresy (IP0.IP1.IP2.IP3) daného serveru, vždy před zavoláním konkrétní funkce (např. ''http_get()'' ). Určitě není vhodné používat přímo natvrdo zapsané číselné adresy (ty se mohou změnit např. při přesunu serveru).<br />
<br />
<br />
* Pokud některá z FULL-C funkcí selže (např. ''smtp_send()'' ohlásí přes ''smtp_send_status()'' chybu), tak je vhodné mít FULL-C program napsán tak, aby chvíli počkal, a pak to celé zkusil znovu. Při více selháních je pak potřeba provést další akci (oznámit chybu, zjistit stav připojení k síti, atd.).<br />
<br />
<br />
* Přes FULL-C lze '''pouze číst''' kalibrační konstanty pro analogové vstupy. Pokud je chcete hromadně nastavit, použijte s výhodou 192.168.1.250/cgi_cfg_adc?xxxx volání (uživatel musí být přihlášen).<br />
<br />
<br />
* Každý FULL-C program může nastavit tzv. "brand" (uživatelskou značku / popisek) pro zařízení SDS, na kterém je spuštěn. Protože SDS je často dodáváno v rámci OEM pro další zástavbu do většího celku, může si finální systémový integrátor nastavit své doplňující texty (název firmy, odkazy na web, telefonní čísla na podporu, doplňující texty, informace o sériovém čísle atd.), které jsou pak zobrazeny v rámci stránek webové administrace zařízení SDS (login, welcome, atd.). Toto nastavení provádí FULL-C program zavolání ''SDS_set_a()'' s příslušným indexem a textem. Typicke se takový FULL-C kód dává na úplný začátek programu.<br />
<br />
<br />
* FULL-C program lze nachystat a vydat tak, že je "zablokován" tak aby fungoval pouze na jediném konkrétním vybraném SDS zařízení. Každé SDS má své unikátní sériové číslo (viz tabulka indexů pro ''SDSget_u()'' ), a FULL-C program může tuto hodnotu porovnat (s tím, co do FULL-C programu vloží autor programu). Toto uživatelské zablokování programu může předejít chybám, kdy by se např. nevhodný program nahrál omylem na jiný hardware. Pokud vydáváte FULL-C program prostřednictvím .FC souboru, kam zvolíte nepřiložit zdrojový .C kód, pak máte neprůstřelnou možnost zamezit použití programu na jakémkoliv jiném SDS než jaké sami určíte (zdrojový kód nebude cílovému uživateli k dispozici, a navíc váš program otestuje sériové číslo daného SDS na shodu). Samozřejmě to znamená, že musíte zmíněné sériové číslo daného SDS zjistit předem, než vydáte program, aby jste to číslo mohli do programu vložit.<br />
<br />
<br />
* Pokud ve svém programu využíváte sériovou sběrnici RS485, dbejte na správné zapojení sběrnice. Naše fórum je plné příkladů, kdy autor programu řešil problém s RS485 a nakonec se ukázalo, že sběrnice byla špatně zapojená (přehozené A/B dráty, nezakončená rezistory, neuvedená do známého klidového stavu přes rezistory atd.). Pro ověření programu je vždy dobré vzít pasivní "odposlech" sběrnice (osciloskop, osobní počítač) a zkontrolovat "překryv" (kdy více zařízení vysílá najednou, což je na RS485 kolize a poškození dat). Právě "překryv" je nejčastějším problémem způsobující poškození komunikace, hned po špatném nastavení komunikační rychlosti v programu. Vždy zkontrolujte svůj hardware, tj. celou sběrnici, je-li správně impedančně zakončena (nejvzdálenější konce) a zda-li jste správně zapojili oba klidové rezistory (pozor, na SDS-BIG tyto nejsou a musí se ručně doplnit "zvenku").<br />
<br />
<br />
* Pokud chcete přes sdílené proměnné (sv) přenášet čísla datového typu ''float'' (desetinná čísla), a pak je chcete například zobrazit na UserWEB webové stránce (a nebo přenést na server atd.), použijte následující trik. Vytiskněte obsah float čísla do Txx[] proměnné, pomocí sprintf(), nikoiv však s využitím %f - ale právě přes následující kód:<br />
<syntaxhighlight lang="c"><br />
// definujeme si sdilenou promennou T00<br />
char T00[32];<br />
<br />
void FloatToT00(void)<br />
{<br />
// vstupni float<br />
float xf;<br />
<br />
// pomocna promenna (presne 4 bajty, protoze "float" je ve FULL-C reprezentovan jako 32-bit)<br />
unsigned int xw;<br />
<br />
// zapiseme vzorovou hodnotu<br />
xf = 12.34;<br />
<br />
// ziskej 32bit obsah xf (= cteni 4 bajtu dat ktere reprezentuji dany float)<br />
xw = *(unsigned int *)&xf;<br />
// a zapis do T00, zarovnej vzdy na osm mist (at se to da pozdeji spravne zpracovat - prevest zpet na float)<br />
sprintf((char *)T00, "%08X", xw);<br />
<br />
// T00[] ted obsahuje "414570A4" (coz je hex reprezentace puvodni float hodnoty 12.34)<br />
}<br />
</syntaxhighlight><br />
Pokud se po spuštění tohoto kódu pak podíváte např. na 192.168.1.250/shared.txt , tak tam uvidíte toto: "T00|414570A4|" (krom jiného textu). S tím už pak v JavaScriptu není problém pracovat (převést zpět na float a korektně zobrazit nebo dále zpracovat). Řada přímých příkladu je k dispozici, stačí hledat na Internetu podle klíčových slov "javascript convert hex to float". <br />
Toto se řeší právě z důvodu že FULL-C printf funkce (a další podobné) umí jen %f ale bez dalších parametrů, takže tisknou float čísla na všechny místa za desetinnou tečkou, což je ve většině případů nežádoucí (při zobrazování na webových stránkách a podobně).<br />
<br />
<br />
* Přistupovat ke všem údajům ze sběrnic 1-Wire, ve FULL-C, je samozřejmě možné, je však potřeba vědět jak. Detaily viz stránka [[FULL-C: OneWire]].<br />
<br />
<br />
* Pamatujte, že varianta '''SDS-64''' (viz [[SDS BIG|varianty]]) má k diposozi pouze celkem 64kB programové paměti (a SDS-128 má jen 128kB této paměti, a SDS-512 jen 512kB celkové FULL-C paměti) - do které '''se musí vlézt celý''' váš přeložený FULL-C program, a k tomu také celý STACK a všechna potřebná paměť HEAP. Toto omezení není dáno programově, ale právě použitým hardware v SDS, takže jej nelze jednoduše "obejít" - pokud se vám to nevleze do varianty 64 tak musíte použít variantu 128 (nebo 512), to je jediné řešení.<br />
<br />
<br />
* Vždy '''správně nastavte velikost''' STACKu - číselnou hodnotu nastavte v okně editoru zdrojového textu FULL-C. Pokud nastavíte hodnotu pro váš program jako moc malou, program nebude fungovat (při volání více funkcí může být pro nedostatek stacku ukončen). Příliš velká hodnota snižuje volnou paměť heap (pokud heap nepoužíváte, nastavte stack na vyšší hodnotu pro klid). Správnou hodnotu zjistíte určitým odhadem (podle velikosti a složitosti programu, podle toho kolik proměnných používáte a kolik parametrů se předává při volání funkcí, a kolik funkcí se v sobě volá). Nastavení je možné nechat automaticky odhadnou překladač, nebo jej můžete ručně zadat (odhad není přesný).<br />
<br />
<br />
* Inicializaci proměnných '''provádějte v kódu, nikoliv při deklaraci'''. Jde o to, že při inicializaci hodnot v proměnné či poli, provedené kódem, se spotřebuje zlomek stack paměti, oproti inicializace přímo při deklaraci. Stack paměti je vždy málo a je potřeba jí šetřit. Je to vlastnost FULL-C.<br />
<br />
Příklad inicializace při deklaraci: <br />
<syntaxhighlight lang="c"><br />
unsigned int numbers[5] = {0,1,2,3,4}; // toto spotřebuje hodně stacku - TAKHLE TEDY NE<br />
</syntaxhighlight><br />
Příklad identické inicializace kódem:<br />
<syntaxhighlight lang="c"><br />
// toto řešení je doporučené, nespotřebovává stack<br />
unsigned int numbers[5];<br />
number[0] = 0;<br />
number[1] = 1;<br />
number[2] = 2;<br />
number[3] = 3;<br />
number[4] = 4;<br />
</syntaxhighlight><br />
Nebo, příklad odpovídající inicializace kódem:<br />
<syntaxhighlight lang="c"><br />
// toto řešení je doporučené, nespotřebovává stack<br />
unsigned int numbers[5];<br />
unsigned int i;<br />
for (i = 0; i < 5; i++) { number[0] = i; };<br />
</syntaxhighlight><br />
<br />
<br />
>>>>>>>>>>>> Následující informace je platná pouze pro firmware starší než 10.7.2017<br />
<br />
* SDS ukazuje aktuální využití své 64kB programové paměti, na webové stránce v administraci.<br />
<pre><br />
HEAP STATS: curalloc=1892, totfree=58632 maxfree=58632, nget=12 nrel=0<br />
HEAP STATS: bc_locked=1120, stackTop=2984 (of 5000)<br />
</pre><br />
Jak to dékódovat: první řádek ukazuje celkové využití paměti a počet alokací a uvolnění:<br />
curalloc = celkem alokovaná paměť (heap malloc, a všechny interní FULL-C funkce a interní data v SDS)<br />
totfree = celkem zbývající volná (alokovatelná) heap pamět (součet všech volných heap fragmentů)<br />
maxfree = největší volný heap fragment, který je možné alokovat v jednom kuse<br />
nget = celkový počet alokací (volání malloc/calloc) (včetně vnitřních volání interních FULL-C funkcí v SDS)<br />
nrel = celkový počet uvolnění předchozích alokací (volání free() funkce)<br />
Druhý řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
bc_locked = kolik bajtů paměti je využito (uzamčeno) pro 'bytecode' vašeho FULL-C (kolik si vzal samotný kód FULL-C programu v paměti)<br />
stackTop = kolik bajtů zásobníku (stacku) je v tento okamžik využito (pokud je to na limitu, víte, že musíte upravit nastavení při překladu)<br />
(of X) = kolik bajtů může nejvíce zásobník (stack) zabrat z celé paměti (nastaveno uživatelem před překladem)<br />
<br />
<br />
<br />
>>>>>>>>>>>> Následující informace je platná pouze pro firmware 10.7.2017 (včetně) a novější (viz také [[SDS BIG|varianty]])<br />
<br />
* SDS ukazuje aktuální využití své 64kB nebo 128kB nebo 512kB programové paměti, na webové stránce v administraci.<br />
<pre><br />
FC: VER 0x08, PROGMEM 128kB<br />
MEM STATS:<br />
- HEAP: used=(492 of 120675), totfree=120164 (biggest=65396), num(get=11,rel=0)<br />
- STACK: used=(364 of 10004)<br />
- BC: locked=(264+128+388)<br />
- SYS: free=280<br />
</pre><br />
Jak to dékodovat: první řádek ukazuje informace o SDS:<br />
VER = verze FC<br />
PROGMEM = varianta hardware (64kB nebo 128kB nebo 512kB celkové paměti pro program a data)<br />
Druhý řádek ukazuje celkové využití paměti a počet alokací a uvolnění:<br />
HEAP used = celkem alokovaná paměť (heap malloc, a všechny interní FULL-C funkce a interní data v SDS)<br />
totfree = celkem zbývající volná (alokovatelná) heap pamět (součet všech volných heap fragmentů)<br />
biggest = největší volný heap fragment, který je možné alokovat v jednom kuse<br />
nget = celkový počet alokací (volání malloc/calloc) (včetně vnitřních volání interních FULL-C funkcí v SDS)<br />
nrel = celkový počet uvolnění předchozích alokací (volání free() funkce)<br />
Druhý řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
STACK used = kolik bajtů zásobníku (stacku) je v tento okamžik využito (pokud je to na limitu, víte, že musíte upravit nastavení při překladu)<br />
Třetí řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
BC locked = kolik bajtů paměti je využito (uzamčeno) pro 'bytecode' vašeho FULL-C (kolik si vzal samotný kód FULL-C programu v paměti)<br />
Čtvrtý řádek nemá pro FULL-C význam:<br />
SYS = interní hodnota<br />
<br />
----<br />
<br />
== Jak funguje FULL-C v SDS ==<br />
<br />
Zde jsou popsány hlubší technologické detaily popisující princip FULL-C. Zajímat budou zejména ty, kteří pracují na složitých programech.<br />
<br />
Program je uživatelem zadán jako '''jeden jediný textový soubor - zdrojový kód v jazyce FULL-C'''. Tento zdrojový kód (text) je zpracován v naší Windows aplikaci (FULLC.exe, k dispozici ke stažení na této WiKi) do formy výsledného souboru, který primárně obsahuje tzv. ''bytecode''. Tento soubor je následně přes síť nahrán do konkrétního zařízení SDS, kde je trvale uložen (až do nahrání jiného souboru) a je zařízením SDS spouštěn.<br />
<br />
== Komprese ==<br />
<br />
Program je přenášen z FULLC.exe do SDS přes počítačovou síť. Aby se nemuselo přenášet tolik dat, je bytecode komprimován. Typická úspora je 25% původního objemu.<br />
<br />
S touto informací je potřeba plánovat při navrhování rozložení paměti - aby se tam vše vešlo. To že komprimovaný program (výstup FULLC.exe) se do paměti SDS na první pohled "vleze", ještě neznamená, že se program i podaří spustit (stále se může "vlézt", ale nezbude místo na zásobník nebo haldu - a to je konec).<br />
<br />
<br />
'''ZÁKLADNÍ OMEZENÍ''':<br />
<br />
Zařízení SDS je k dispozici ve třech základních variantách: varianta "64" má k dispozici 64kB paměti pro celkové potřeby programu, a varianta "128" má k dispozici 2x64kB (tj. 128kB) paměti pro celkové potřeby programu. Varianta "512" nabízí největší dostupnou paměť pro program a data.<br />
<br />
Do celé této celkové paměti se musí vlézt nejen surový ''bytecode'' ale i všechny provozní záležitostí (zásobník - stack, proměnné, halda - heap).<br />
<br />
<br />
'''Skladba paměti - varianta "64":'''<br />
<br />
(START I-64kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ instrukce programu (bytecode)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ halda (heap)<br />
...<br />
64kB + konec <br />
<br />
(KONEC I-64kB BLOKU)<br />
<br />
Další paměť (více než 1x 64kB) už není ve variantě "64" k dispozici - vše se tedy musí vlézt do jednoho 64kB velkého bloku. Pokud to pro vaše potřeby nestačí, musíte použít variantu s pamětí 128kB nebo 512kB, které jsou popsány dále.<br />
<br />
<br />
'''Skladba paměti - varianta "128":'''<br />
<br />
(START I-64kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ první část haldy (heap-1)<br />
...<br />
64kB + konec <br />
<br />
(KONEC I-64kB BLOKU)<br />
<br />
(START II-64kB BLOKU)<br />
<br />
0 + instrukce programu (bytecode)<br />
...<br />
+ druhá část haldy (heap-2), jen pokud nezabere program celý II-64kB blok<br />
...<br />
64kB + konec<br />
<br />
(KONEC II-64kB BLOKU)<br />
<br />
Jak lze vidět, varianta "128" nabízí dva bloky po 64kB. Tyto bloky na sebe sice lineárně nenavazují (tj. součtem je to sice 128kB, ale ne v celku), nicméně přináší významnou úlevu předchozímu omezení původní varianty "64".<br />
<br />
Pro použití varianty "128" je ovšem potřeba mít správný hardware (SDS), tzn. SDS výrobní varianty "64" nelze programově změnit na variantu "128" - to lze jedině použitím vhodného SDS hardware. Samozřejmě program původně určený pro "64" lze na SDS "128" spustit, bez jakýchkoliv omezení (ale naopak, program 128 nelze na 64 spustit, protože varianta 64 nemá dost paměti pro program varianty 128).<br />
<br />
<br />
'''Skladba paměti - varianta "512":'''<br />
<br />
(START I-504kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ první část haldy (heap-1)<br />
...<br />
504kB + konec <br />
<br />
(KONEC I-504kB BLOKU)<br />
<br />
(START II-8kB BLOKU)<br />
<br />
0 + druhá část haldy (heap-2)<br />
...<br />
8kB + konec<br />
<br />
(KONEC II-8kB BLOKU)<br />
<br />
SOUČET: celková dostupná paměť 504+8 = 512kB<br />
<br />
Jak lze vidět, varianta "512" nabízí dva bloky, jeden 504kB a druhý 8kB. V součtu je k dispozici 512kB paměti, která je (dle rozpisu uvedeného výše) rozdělena na jednotlivé dynamické části - skutečně použité velikosti každé části už pak závisí na obsahu vašeho FULL-C programu a vašem nastavení (vámi určená velikost zásobníku).<br />
<br />
Programy určené pro variantu 512 lze spustit pouze na správném typu hardware - SDS varianty 512.<br />
<br />
<br />
'''Další informace:'''<br />
<br />
Velikost programu (bytecode + stringblob) a proměnných (variables) je pevná, a je přímo dána vámi tj. programátorem (podle toho, jaký napíšete program, tak bude tato oblast velká).<br />
<br />
Zbytek je použit pro haldu (heap), což je různě veliký paměťový prostor který má program k dispozici (funkce: malloc, realloc, free), pokud jej tedy potřebuje. Pokud bude váš program moc velký, pak se může stát že halda nemusí existovat - a systém nebude schopen takový program vůbec spustit ! Vždy je potřeba mít haldo o velikosti alespoň hodnoty 1/8 velikosti programu.<br />
<br />
Zásobník (stack) je vždy umístěn na začátku paměťového prostoru, a jeho velikost je opět jednorázově určena programátorem (podle odhadu nebo aktuální měření). Pokud je zásobník příliš malý, může být program předčasně ukončen (řešením je zvětšení velikosti zásobníku (na úkor velikosti heapu) a nové nahraní programu do zařízení). Toto je zřejmě nejčastější problém u většiny FULL-C programů - špatně nastavená velikost zásobníku.<br />
<br />
Informace o aktuálním vyžití celého paměťového prostoru je k dispozici ve webovém rozhraní SDS (Menu, FULL-C). Odsud lze také přečíst skutečné využití zásobníku (nejvyšší dosažená velikost).<br />
<br />
<br />
== Heap ==<br />
<br />
Typický FULL-C program v zařízení SDS nemá potřebu používat haldu (heap) - typicky všechny proměnné (i velká pole) lze bez problému staticky deklarovat.<br />
<br />
Pokud však potřebujete dynamickou alokaci paměti, tak je k dispozici ten zbytek paměťového prostoru, který zůstane "volný" po nahrání programu (a vyhrazení zásobníku).<br />
<br />
Informace o velikosti volného heapu a fragmentaci lze opět nalézt ve webovém rozhraní SDS.<br />
<br />
<br />
== Opakování varování ==<br />
<br />
Velikost programu je omezena takto:<br />
<br />
* varianta SDS 64kB: vše se musí vlézt do 64kB (bytecode, proměnné, zásobník) <br />
* varianta SDS 128kB: vše se musí vlézt do 2x 64kB (128kB s danými omezeními, především bytecode omezen na 64kB protože se musí celý vlézt do jednoho bloku)<br />
* varianta SDS 512kB: vše se musí vlézt do 512kB, přičemž součet velikosti (bytecode, všechny proměnné, zásobník) je do velikosti 504kB (vše další je dostupné jako heap)<br />
* Zásobník (stack) musí mít dostatečnou velikost pro provoz programu (všechny vnořené volání funkcí, rekurze, atd.).<br />
* Halda (heap) musí být k dispozici o dostatečné velikosti, jinak se jakýkoliv program nespustí.<br />
<br />
Pokud by váš přeložený program byl moc velký, a to tak že se spolu s ním do paměti nevlezou další potřebné věci (zásobník atd.), nebudete moct program na zařízení SDS spustit.<br />
<br />
Vždy můžete kontrolovat stav programu (a využití paměti) na stránce "FULL-C" ve webové administraci zařízení SDS.<br />
<br />
<br />
== Jak programovat ==<br />
<br />
FULL-C program musí vždy mít definovanou funkci '''main()''', která je první spuštěnou funkcí v rámci spuštění programu.<br />
<br />
<syntaxhighlight lang="c"><br />
void main(void)<br />
{<br />
;<br />
}<br />
</syntaxhighlight><br />
<br />
Je úkolem programátora, aby funkce '''main()''' nebyla opuštěna (potom je program "ukončen" protože nemá kam dál pokračovat) = v takovém případě je program ukončen, a znovu bude spuštěn až po restartu SDS (nebo když by byl nahrán nový program, tak je pak spuštěn ten).<br />
<br />
FULL-C program tedy vždy začíná jako první provádět instrukce ve funkci '''main()'''.<br />
<br />
<br />
V základu lze činnosti provádět na základě těchto vstupů:<br />
<br />
* čas (např. každou vteřinu)<br />
* hardware (např. čtení vstupů)<br />
* hodnoty [[FULL-C: sharing|sdílených proměnných]] (např. změnou proměnné z uživatelské webové stránky)<br />
<br />
Výstupy programu mohou být:<br />
<br />
* ovládání hardware (např. spínání relé)<br />
* změna hodnot sdílených proměnných (např. pro dynamické zobrazení na uživatelské webové stránce)<br />
* odesílání stavů přes síť (např. HTTP-GET nebo SNMP-TRAP)<br />
<br />
<br />
Pro všechny tyto vypsané činnosti je potřeba znát [[FULL-C: functions|funkce a příkazy]], které programu umožní právě takovéto činnosti vykonávat.<br />
<br />
<br />
== OPTIMALIZACE KÓDU a jak je SDS vůbec rychlé ? ==<br />
<br />
Bylo provedeno detailní měření na SDS-BIG 128 a SDS-BIG 512, a postupy jsou použitelné pro všechna BIG a BIG2 zařízení.<br />
<br />
Pokud není uvedeno jinak, měřilo se při nezatížené síti. U SDS-BIG 64 lze očekávat prakticky stejné hodnoty jako u SDS-BIG 128, protože má stejnou frekvenci CPU.<br />
<br />
'''Časy uvedené v textu platí pro SDS-BIG 64/128.''' SDS-BIG 512 je téměř ve všem cca 3,5x rychlejší (viz tabulka). Jedinou výjimkou jsou makra s parametry. Všechny tipy platí pro obě varianty stejně.<br />
<br />
=== Základní orientace ===<br />
<br />
* Jeden jednoduchý příkaz (např. <code>x = y + z;</code>) trvá cca '''60–150 µs''', tj. řádově 10 000 jednoduchých příkazů za sekundu. Hlavní smyčka se 100 příkazy tak trvá cca 10 ms na jeden průchod.<br />
* Samotný výpočet je zanedbatelný: <code>+ - * / %</code>, 64bitová i float aritmetika trvají stejně. O rychlosti rozhoduje počet příkazů a způsob zápisu programu (viz tipy níže).<br />
* Výsledky měření jsou velmi opakovatelné (±0,1 %). Při nezatížené síti spotřebuje ostatní činnost SDS jen cca 2 % výkonu.<br />
<br />
=== Naměřené časy ===<br />
Platí pro SDS-BIG, BIG2 a všechny varianty (SMALL atd.) odvozené od BIG a BIG2.<br />
<br />
{| class="wikitable"<br />
! Zápis !! SDS-BIG 64/128 !! SDS-BIG 512<br />
|-<br />
| prázdný cyklus <code>for (i = 0; i < n; i++) { }</code>, jeden průchod || 109 µs || 31 µs<br />
|-<br />
| <code>for (i = n; i--; ) { }</code> / <code>while (i--) { }</code>, jeden průchod || 52 / 46 µs || 15 / 13 µs<br />
|-<br />
| <code>x = 5;</code> (x je lokální proměnná) || cca 60 µs || cca 17 µs<br />
|-<br />
| <code>x = y + z;</code> || cca 105 µs || cca 31 µs<br />
|-<br />
| <code>x++;</code> / <code>++x;</code> / <code>x += 1;</code> / <code>x = x + 1;</code> || 57 / 49 / 70 / 102 µs || 17 / 14 / 20 / 30 µs<br />
|-<br />
| konstanta: číslo / enum / <code>#define</code> (definované těsně před použitím) || +0 / +7 / +21 µs || +0 / +2 / +6 µs<br />
|-<br />
| konstanta: enum / <code>#define</code> (definované na začátku velkého programu) || +47 / +62 µs || +15 / +19 µs<br />
|-<br />
| globální proměnná, čtení / zápis (deklarovaná na začátku programu), oproti lokální || +32 / +90 µs || +11 / +31 µs<br />
|-<br />
| globální proměnná, čtení / zápis (deklarovaná těsně před použitím), oproti lokální || +7 / +13 µs || +2 / +4 µs<br />
|-<br />
| makro s parametry, např. <code>SQR(y)</code> || 870–1600 µs (!) || cca 3550 µs (!)<br />
|-<br />
| totéž jako funkce <code>sqr(y)</code> / rozepsané <code>y * y</code> || cca 195 / 105 µs || cca 60 / 31 µs<br />
|-<br />
| volání prázdné funkce bez parametrů || cca 105 µs || cca 36 µs<br />
|-<br />
| každý parametr funkce / každá lokální proměnná ve volané funkci, na každé volání || +35 / +65 µs || +10 / +18 µs<br />
|-<br />
| příkaz, který se neprovede (uvnitř nesplněné podmínky <code>if</code>) || cca 80 µs || cca 25 µs<br />
|-<br />
| volání funkce, které se neprovede (bez ohledu na velikost funkce) || cca 20 µs || cca 6 µs<br />
|-<br />
| <code>switch</code> nebo řetězec <code>if – else if</code>, na každou větev (bez ohledu na to, která platí) || cca 80–100 µs || cca 25–35 µs<br />
|-<br />
| tabulka hodnot <code>x = tab[k];</code> || cca 120 µs || cca 35 µs<br />
|-<br />
| <code>SDS_get_u32()</code> / <code>SDS_set_u32()</code> || cca 155 / 250 µs || cca 48 / 79 µs<br />
|-<br />
| 8 vstupů: 8x <code>SDS_get_u32()</code> / 1x <code>SDS_get_a()</code> || 1400 / 320 µs || 416 / 98 µs<br />
|-<br />
| <code>memcpy</code>, <code>strcpy</code>, <code>strcmp</code>, <code>strlen</code>, <code>snprintf</code>, <code>atoi</code>, ... (jedno volání) || 200–340 µs || 60–110 µs<br />
|-<br />
| kopie 64 bajtů vlastním cyklem / pomocí <code>memcpy</code> || 11–18 ms / 0,34 ms || 3,1–5,2 ms / 0,11 ms<br />
|-<br />
| <code>printf()</code> || cca 360 µs + 2,7 µs na znak || cca 110 µs + 1,1 µs na znak<br />
|-<br />
| <code>putchar()</code>, na každý znak || cca 375 µs || cca 115 µs<br />
|-<br />
| <code>wait(0)</code> / <code>wait(N)</code> || 0,6 ms / N ms + 0,5–0,7 ms || 0,19 ms / N ms + 0,1–0,15 ms<br />
|-<br />
| <code>echoclear()</code> || cca 1 ms || cca 0,5 ms<br />
|}<br />
<br />
=== Proměnné a konstanty ===<br />
<br />
* '''Nejčastěji používané proměnné funkce (čítače cyklů, mezisoučty) deklarujte jako poslední''' v seznamu deklarací. Proměnná deklarovaná později je rychlejší: čítač cyklu deklarovaný jako první z 27 lokálních proměnných zpomalí každý průchod cyklem o 38 µs, deklarovaný jako poslední nezpomalí nic.<br />
* '''Konstanty, globální proměnné a enum deklarujte co nejblíže místu použití''', např. těsně před funkcí, která je používá, nebo těsně před <code>main()</code> pro hlavní smyčku. Totéž definované na začátku velkého programu je výrazně pomalejší (viz tabulka). Navíc je to i čitelnější: definice je hned u použití.<br />
* '''Méně globálních položek = rychlejší program.''' Každá další globální proměnná, funkce nebo konstanta mírně zpomalí přístup ke všemu, co je v programu deklarováno před ní, včetně volání funkcí SDS.<br />
** Související globální proměnné spojte do jedné struktury (<code>struct</code>). Přístup k položce struktury stojí jen cca +14 µs.<br />
** Nevytvářejte zbytečně mnoho drobných globálních pomocných funkcí.<br />
* '''Používejte lokální proměnné.''' Na začátku funkce si zkopírujte globální proměnné a nastavení do lokálních proměnných, v cyklu pracujte s lokálními a výsledek zapište do globální proměnné jen jednou na konci.<br />
* '''Pro pojmenované konstanty používejte <code>enum</code> místo <code>#define</code>.''' <code>#define</code> je o cca 14 µs pomalejší než enum na stejném místě v programu. <code>#define</code> použijte jen tam, kde ho FULL-C vyžaduje (velikost pole).<br />
* '''Nepoužívejte makra s parametry''' (<code>#define SQR(a) ((a)*(a))</code>) v často prováděném kódu.<br />
** Stojí 870–1600 µs na každé použití a jejich rychlost se mění s velikostí programu a stavem paměti.<br />
** Na SDS-BIG 512 jsou dokonce pomalejší než na SDS-BIG 128 (cca 3550 µs).<br />
** Použijte funkci (cca 195 µs, na SDS-BIG 512 cca 60 µs) nebo výraz rozepište.<br />
* Nastavení, které uživatel mění, může zůstat na začátku programu jako <code>#define</code> nebo globální proměnná. Často prováděný kód si ale tyto hodnoty na začátku funkce zkopíruje do lokálních proměnných.<br />
* '''Nedeklarujte proměnné uvnitř těla cyklu''' (<code>for (...) { int t; ... }</code>). Funguje to, ale deklarace se provádí při každém průchodu (+25 µs, na SDS-BIG 512 +8 µs). Deklarujte na začátku funkce.<br />
<br />
=== Cykly ===<br />
<br />
* '''Cyklus směrem dolů je dvakrát rychlejší:''' <code>for (i = n; i--; ) { ... }</code> trvá 52 µs na průchod, <code>for (i = 0; i < n; i++)</code> 109 µs. V těle cyklu má i hodnoty n-1 ... 0. <code>while (i--)</code> je stejně rychlý.<br />
* <code>while (i < n) { ...; i++; }</code> ani <code>do { } while ()</code> nejsou rychlejší než <code>for</code>.<br />
* <code>++i</code> je o něco rychlejší než <code>i++</code>, <code>i += 1</code> je pomalejší.<br />
* '''Nikdy nepoužívejte globální proměnnou jako čítač cyklu''' (+113 µs na každý průchod).<br />
* Mez cyklu jako číslo nebo lokální proměnná nic nestojí. Jako globální proměnná stojí +29 µs na průchod, jako <code>#define</code> +56 µs na průchod. Zkopírujte ji předem do lokální proměnné.<br />
* Nejvíc ušetříte tím, co z cyklu vyjmete: každý příkaz uvnitř cyklu stojí cca 100 µs na každý průchod.<br />
<br />
=== Podmínky a kód, který se neprovede ===<br />
<br />
* '''I kód, který se neprovede, zabírá čas.''' Příkaz uvnitř nesplněné podmínky stojí cca 80 µs, skoro stejně jako provedený (cca 100 µs).<br />
* '''Velké, zřídka prováděné bloky přesuňte do samostatné funkce.''' Neprovedené volání funkce stojí jen cca 20 µs, bez ohledu na to, jak je funkce velká.<br />
* '''<code>return</code> čas neušetří.''' Volání funkce trvá úměrně délce celé funkce, ne jen té části, která se provedla. Často volané funkce udržujte krátké.<br />
* '''<code>switch</code> i řetězec <code>if – else if</code> stojí cca 80–100 µs na každou větev''', bez ohledu na to, která větev platí: 2 větve cca 270 µs, 8 větví cca 770–940 µs.<br />
* '''Kde to jde, použijte tabulku hodnot''' místo dlouhého <code>switch</code> nebo řetězce <code>if</code> (<code>x = tab[k];</code> cca 120 µs). Tabulku naplňte kódem na začátku programu, protože FULL-C nepovoluje inicializaci pole v deklaraci.<br />
* <code>&&</code> pravou stranu sice neprovede, ale i tak stojí čas.<br />
* Ternární operátor <code>?:</code> trvá stejně jako <code>if / else</code> a vždy vyhodnotí obě strany. '''Používejte ho jen s čísly''': s řetězci (<code>ok ? "OK" : "CHYBA"</code>) se program zastaví s chybou "first argument to '?' should be a number".<br />
<br />
=== Výrazy a příkazy ===<br />
<br />
* Méně příkazů je rychlejší: jeden výraz <code>x = ((y+z)*(y-z))/3;</code> trvá 233 µs, totéž rozdělené do 4 příkazů 393 µs.<br />
* Používejte zkrácené zápisy: <code>x++</code> 57 µs, <code>x += 1</code> 70 µs, <code>x = x + 1</code> 102 µs.<br />
* Bitový posun a násobení / dělení trvají stejně, <code>* 8</code> není třeba nahrazovat zápisem <code><< 3</code>.<br />
<br />
=== Datové typy ===<br />
<br />
* <code>int64_t</code>, <code>uint64_t</code> ani <code>float</code> nejsou pomalejší než <code>int</code>, používejte je bez obav.<br />
* <code>char</code> ani <code>short</code> nejsou rychlejší než <code>int</code>.<br />
* <code>ftoi()</code> je pomalejší než přetypování <code>(int)</code> (199 µs proti 146 µs).<br />
<br />
=== Funkce ===<br />
<br />
* '''Funkce jsou dost rychlé na to, abyste mohli psát přehledný kód:''' volání stojí cca 100 µs, tedy zhruba jako jeden příkaz. Rozdělte program do funkcí podle úkolů.<br />
* Každý parametr prodlouží volání o cca 35 µs, každá lokální proměnná deklarovaná ve volané funkci o cca 65 µs, každá další úroveň vnoření volání o cca 90 µs.<br />
* Malé, často volané funkce by měly pracovat jen se svými parametry, bez vlastních lokálních proměnných.<br />
* Pro předání většího množství dat předejte ukazatel na strukturu místo mnoha parametrů.<br />
* Vyhněte se řetězcům drobných obalových funkcí a rekurzi (stojí čas i místo v zásobníku).<br />
* Velikost zásobníku (STACK) nastavená ve FULLC.exe musí pokrýt nejhlubší vnoření volání.<br />
<br />
=== Řetězce a paměť ===<br />
<br />
* '''Vždy používejte knihovní funkce''' (<code>memcpy</code>, <code>memset</code>, <code>strcpy</code>, <code>strlen</code>, <code>strcmp</code>, <code>snprintf</code>, <code>atoi</code>, <code>strtoul</code>, ...). Jedno volání stojí 200–340 µs bez ohledu na délku dat. Totéž vlastním cyklem je 20–50x pomalejší: kopie 64 bajtů v cyklu trvá 11–18 ms.<br />
* <code>snprintf</code> včetně formátu <code>%0.2f</code> funguje a stojí cca 260–340 µs.<br />
* '''Nepoužívejte <code>malloc</code> / <code>free</code> v cyklech.''' Fragmentace haldy (heap) zpomaluje program a může způsobit selhání síťových funkcí. Paměť alokujte jednou na začátku programu, nebo použijte pevná pole. Nechte dostatek volné haldy pro síťové funkce.<br />
<br />
=== Funkce SDS (set a get) ===<br />
<br />
* <code>SDS_get_*()</code> stojí cca 155 µs, <code>SDS_set_u32()</code> cca 250 µs.<br />
* '''Kde to tabulka indexů umožňuje (označení "(a)"), čtěte bloky pomocí <code>SDS_get_a()</code>''': 8 vstupů jedním voláním za 320 µs místo 1400 µs. Pro optovstupy jen na firmware, kde je opravena známá chyba 5 (viz níže).<br />
* Hodnotu přečtěte jednou za průchod do lokální proměnné a dál používejte tu.<br />
* <code>SDS_get_a()</code> vyplní jen tolik položek, kolik jich daný hardware má. Požadujete-li víc, funkce nevyplní nic a nehlásí chybu. Proto vždy žádejte jen skutečný počet položek. Např. SDS-BIG 512 (BIG2): 9 optovstupů, 6 relé, 8 A/D vstupů, 9 S0 vstupů.<br />
<br />
=== Konzole (printf) ===<br />
<br />
* <code>printf()</code> stojí cca 360 µs + 2,7 µs na znak. <code>putchar()</code> stojí cca 375 µs '''na každý znak''', proto nikdy netiskněte po znacích.<br />
* Celý řádek si připravte pomocí <code>snprintf()</code> a vytiskněte ho jedním voláním.<br />
* Plná konzole tisk nezablokuje ani nezpomalí, ale její kapacita je omezená (BIG: pod cca 14 kB výstupu). Tiskněte stručně.<br />
* Konzole (echo.htm) je HTML stránka: znak <code><</code>, za kterým následuje písmeno nebo číslice, se bere jako HTML značka a část textu se nezobrazí. Ve výpisech se znaku <code><</code> vyhněte.<br />
<br />
=== wait() a měření času ===<br />
<br />
* '''SDS-BIG 64/128:''' <code>wait(N)</code> trvá N ms + cca 0,5–0,7 ms, <code>wait(0)</code> 0,6 ms. Při silném zatížení sítě může <code>wait(N)</code> trvat až o cca 1,7 ms déle.<br />
* '''SDS-BIG 512:''' <code>wait(N)</code> trvá N ms + cca 0,1–0,15 ms, <code>wait(0)</code> 0,19 ms.<br />
* <code>wait(0)</code> nepoužívejte jen pro "uvolnění" procesoru.<br />
* Pro měření času použijte index 45 (uptime v ms).<br />
* Pro přesná měření lze použít index 137 (čítač cyklů CPU). Na SDS-BIG 64/128 má 168 kroků na 1 µs a přeteče cca po 25 s, na SDS-BIG 512 má 480 kroků na 1 µs a přeteče cca po 9 s.<br />
<br />
=== Sériová linka (UART) ===<br />
<br />
Měřeno na COM6 s propojeným TX a RX, při rychlostech 9600–460800 Bd. Ve všech testech, i při silném zatížení sítě, proběhl přenos bez jediné chyby. RS485 na COM1 nebyla měřena.<br />
<br />
{| class="wikitable"<br />
! !! SDS-BIG 64/128 !! SDS-BIG 512<br />
|-<br />
| <code>SDS_serial_writeCH()</code>, na každý bajt || cca 0,5 ms || cca 0,16 ms<br />
|-<br />
| <code>SDS_serial_write()</code>, jedno volání || cca 0,85 ms + 1,6 µs na bajt || cca 0,37 ms + 0,6 µs na bajt<br />
|-<br />
| vysílací buffer (<code>SDS_serial_write()</code> se vrací ihned) || cca 600 B || nejméně 1024 B<br />
|-<br />
| přijímací buffer || nejméně 1024 B || nejméně 1024 B<br />
|-<br />
| <code>SDS_serial_read()</code>, když žádná data nečekají || cca 0,35 ms || cca 0,11 ms<br />
|-<br />
| nejkratší dotaz – odpověď (zápis až přečtení), kromě doby přenosu po lince || cca 4 ms (pod zátěží sítě až 6 ms) || cca 1,2 ms (pod zátěží sítě až 2,6 ms)<br />
|-<br />
| data lze přečíst po příchodu posledního bajtu za || cca 2,5 ms || cca 0,7–0,8 ms<br />
|}<br />
<br />
* '''Data odesílejte jedním voláním <code>SDS_serial_write()</code>''', nikdy po znacích pomocí <code>SDS_serial_writeCH()</code> v cyklu: 64 bajtů po znacích trvá 33–40 ms na SDS-BIG 128 a 10 ms na SDS-BIG 512, při jakékoliv rychlosti linky.<br />
* <code>SDS_serial_write()</code> se vrací ihned, aniž čeká na odvysílání, pokud se data vejdou do vysílacího bufferu. Při větším objemu čeká, dokud se zbytek do bufferu nevejde: na SDS-BIG 128 čekalo 1024 B při 115200 Bd 34 ms.<br />
* Přijímací buffer pojme nejméně 1024 B, takže program nemusí číst nepřetržitě.<br />
* <code>SDS_serial_read()</code> nevolejte v rychlé smyčce, protože stojí čas i bez dat. Stačí jednou za průchod hlavní smyčkou nebo po <code>wait()</code>.<br />
* Přijatá data jsou programu k dispozici se zpožděním (viz tabulka). U krátkých zpráv při vysokých rychlostech toto pevné zpoždění převažuje, takže vyšší rychlost linky pomůže hlavně u velkých bloků dat.<br />
<br />
=== MQTT ===<br />
<br />
* '''Nevolejte další funkci <code>mqtt_*()</code>, dokud předchozí není dokončena''': u publish, subscribe a unsubscribe sledujte <code>[12202]</code>, u connect a disconnect <code>[12200]</code>. Ve FW 0x0019080B takové volání poruší stav spojení (viz Známé chyby níže).<br />
* '''Stav spojení <code>[12200]</code> kontrolujte při každém průchodu hlavní smyčkou''' a v případě potřeby spojení obnovte postupem uvedeným v části Známé chyby. Po každém novém připojení je potřeba znovu provést subscribe, protože se tabulka přihlášení maže.<br />
* Po normálním <code>mqtt_disconnect()</code> skončí <code>[12200]</code> na hodnotě −2, ne 0. Považujte 0 i −2 za "odpojeno".<br />
* Kontrola stavu v čekací smyčce stojí čas (cca 0,3 ms na SDS-BIG 128). Do takové smyčky dejte <code>wait(10)</code>.<br />
<br />
{| class="wikitable"<br />
! !! SDS-BIG 128, FW starší než 10.2026 !! SDS-BIG 128, FW od 31.10.2026 včetně !! SDS-BIG 512, FW od 31.10.2026 včetně<br />
|-<br />
| <code>mqtt_connect()</code> || cca 0,2–0,45 s || cca 0,45 s || cca 2 ms<br />
|-<br />
| publish (do potvrzení brokerem) || cca 0,3–0,65 s (průměr 0,5 s) || cca 3–6 ms || cca 0,9 ms<br />
|-<br />
| nejvyšší počet publish za sekundu || cca 2 || cca 250 || cca 1000<br />
|-<br />
| zpráva přes broker a zpět || cca 0,5 s || cca 6 ms || cca 1,7 ms<br />
|-<br />
| subscribe / unsubscribe / disconnect || cca 0,3–0,65 s || cca 3–4 ms || cca 1 ms<br />
|-<br />
| při silném zatížení sítě || beze změny (cca 0,5 s) || většina publish 7–15 ms, některé až cca 1,5 s || publish cca 1,3–1,9 ms, výjimečně až cca 50 ms, cca 600 zpráv za sekundu<br />
|}<br />
<br />
* Pro FW starší než 10/2026: délka operace nezávisí na velikosti dat, a protože každá operace trvá cca 0,5 s:<br />
** na dokončení publish v hlavní smyčce nečekejte. Zavolejte <code>mqtt_publish()</code>, pokračujte v jiné práci a <code>[12202]</code> zkontrolujte při dalším průchodu;<br />
** '''posílejte více hodnot v jedné zprávě''' (např. JSON, celkem do cca 1465 znaků včetně názvu položky): publish s 1024 B trvá stejně dlouho jako s 8 B.<br />
* '''Firmware od 31.10.2026 včetně:''' čekat na dokončení publish lze, jedna operace trvá jednotky ms. Vždy ale používejte časový limit alespoň 3–5 s, protože při zatížení sítě může operace výjimečně trvat i cca 1,5 s.<br />
<br />
==== Známé chyby firmware (MQTT) ====<br />
<br />
'''1. Volání <code>mqtt_*()</code> dříve, než skončila předchozí operace, poruší stav spojení''' (FW 0x0019080B, ve FW od ''<doplnit>'' opraveno)<br />
* Zavoláte-li např. <code>mqtt_publish()</code> ve chvíli, kdy předchozí publish ještě probíhá, zapíše se chybový kód −3 do <code>[12200]</code> (místo do <code>[12202]</code>). <code>[12200]</code> pak zůstane trvale na −3, přestože spojení ve skutečnosti funguje, a program se tak jeví jako odpojený.<br />
* Následné přímé zavolání <code>mqtt_connect()</code> selže s výsledkem −7 (při CONNACK 0).<br />
* Ochrana: nikdy nevolejte další funkci <code>mqtt_*()</code> před dokončením předchozí (viz MQTT výše).<br />
* Obnova spojení, která funguje ve všech verzích firmware:<br />
*# pokud <code>[12200]</code> není 4, 0 ani −2, zavolejte <code>mqtt_disconnect()</code>;<br />
*# počkejte, až bude <code>[12200]</code> rovno 0 nebo −2 (cca 0,3 s);<br />
*# počkejte dalších 500 ms;<br />
*# zavolejte <code>mqtt_connect()</code> a počkejte na hodnotu 4;<br />
*# znovu proveďte subscribe všech položek.<br />
<br />
'''2. Po <code>mqtt_disconnect()</code> skončí <code>[12200]</code> na −2 místo 0''' (všechny testované verze firmware)<br />
* Hodnota −2 v tomto případě neznamená chybu: považujte 0 i −2 za "odpojeno". Příklad, který po odpojení čeká pomocí <code>if (sys[2200] <= 0) goto error;</code>, by normální odpojení vyhodnotil jako chybu.<br />
<br />
=== Zatížení sítě a rezerva výkonu ===<br />
<br />
* '''SDS-BIG 64/128:'''<br />
** Při nezatížené síti spotřebuje ostatní činnost SDS cca 2 % výkonu a program není nikdy přerušen na déle než cca 0,6 ms.<br />
** Při silném zatížení (ping a HTTP dotazy z jednoho PC) spotřebuje 15–19 % výkonu. Program pak běží o cca 18–20 % pomaleji a je často přerušován, ale nikdy na déle než cca 1,5 ms.<br />
* '''SDS-BIG 512:'''<br />
** Při nezatížené síti spotřebuje ostatní činnost SDS cca 1 % výkonu a program není přerušen na déle než cca 0,03 ms.<br />
** Při silném zatížení (ping a HTTP dotazy z jednoho PC) spotřebuje ostatní činnost cca 45 % výkonu a program běží cca 1,8x pomaleji. I tak je ale stále cca 2x rychlejší než SDS-BIG 128 bez zátěže.<br />
** Občas, pravděpodobně při otevření stránky webového rozhraní přes HTTPS, se objeví jednotlivá pauza cca 10–25 ms. Programy s krátkými časovými limity (např. sériové protokoly) musí takovou pauzu snést.<br />
* '''U zařízení se silným síťovým provozem počítejte s rezervou výkonu''': cca 25 % na SDS-BIG 64/128, cca 50 % na SDS-BIG 512. Poměry mezi časy i všechny tipy výše platí i pod zátěží.<br />
<br />
=== Sběrnice 1-Wire ===<br />
<br />
* '''Pokud sběrnici 1-Wire nepoužíváte, zavolejte hned na začátku programu <code>SDS_disable_onewire()</code>.'''<br />
* Na SDS-BIG 512 s firmwarem starším než 31.10.2026 může odpojené čidlo 1-Wire program extrémně zpomalit (určitě si aktualizujte firmware!).<br />
* Stav 1-Wire masteru lze zkontrolovat čtením indexu 2998: 1 = detekce, 2 nebo 4 = chyba, 8 = v provozu, 16 = vypnuto.<br />
<br />
=== Známé chyby ve starším firmware (starší než 31.10.2026) ===<br />
<br />
'''1. Odpojené čidlo 1-Wire zpomalí program cca 125x''' (opraveno ve FW od 31.10.2026 včetně)<br />
* Pokud je v SDS evidováno dříve nalezené čidlo 1-Wire, které je fyzicky odpojené, zpomalí se FULL-C program cca 125x. Zpomalení začne, jakmile se 1-Wire master rozběhne (cca 7 s po startu SDS, index 2998 = 8), a program se už nezotaví.<br />
** Program pak dostane méně než 1 % výkonu: smyčka, která běžně trvá 54 µs na průchod, trvá 6,6–9,3 ms.<br />
* Ochrana: pokud 1-Wire nepoužíváte, zavolejte na začátku programu <code>SDS_disable_onewire()</code>. S ním běží program trvale plnou rychlostí.<br />
* Ochrana pro starší firmware, pokud 1-Wire používáte: zajistěte, aby všechna evidovaná čidla byla připojena, nebo aktualizujte firmware.<br />
<br />
'''2. Blokové čtení optovstupů <code>SDS_get_a(151, ...)</code> vrací chybné hodnoty''' (opraveno ve FW od 31.10.2026 včetně)<br />
* SDS-BIG 512: volání může způsobit restart celého SDS.<br />
* ''<doplnit po ověření na SDS-BIG 64/128: vrací nesmyslné hodnoty místo stavu vstupů>''<br />
* Ve FW od ''<doplnit>'' opraveno: blokové čtení vrací stejné hodnoty jako <code>SDS_get_u32(151 + n)</code> (0 = aktivní, 1 = neaktivní).<br />
* Ochrana pro starší firmware: čtěte optovstupy jednotlivě pomocí <code>SDS_get_u32(151 + n)</code>, nebo aktualizujte firmware.<br />
<br />
=== Co rychlost neovlivní (pište přehledně) ===<br />
<br />
* Komentáře, i uvnitř cyklů a v neprováděných blocích.<br />
* Dlouhé, výstižné názvy proměnných.<br />
* Závorky navíc.<br />
* Rozdělení programu do funkcí podle úkolů (cca jeden příkaz na každé volání).<br />
* 64bitové a float typy.<br />
* Odsazení, prázdné řádky, formátování.<br />
<br />
<br />
=== Příklad ===<br />
<br />
Pomalý, ale běžný zápis:<br />
<pre><br />
#define OPTO_FIRST 151<br />
#define NUM_INPUTS 8<br />
#define WEIGHT(a) ((a)*(a))<br />
<br />
unsigned int g_weight;<br />
<br />
void main(void)<br />
{<br />
unsigned int i;<br />
<br />
for (;;)<br />
{<br />
g_weight = 0;<br />
for (i = 0; i < NUM_INPUTS; i++)<br />
{<br />
if (SDS_get_u32(OPTO_FIRST + i) == 0) g_weight = g_weight + WEIGHT(i + 1);<br />
}<br />
wait(100);<br />
}<br />
}<br />
</pre><br />
<br />
Totéž zapsané podle tipů výše (stejně čitelné):<br />
<pre><br />
#define NUM_INPUTS 8 // velikost pole: zde je #define nutny<br />
<br />
unsigned int g_weight; // vysledek pro zbytek programu<br />
<br />
enum inputs { OPTO_FIRST = 151 }; // definovano tesne pred pouzitim<br />
<br />
void main(void)<br />
{<br />
unsigned int opto[NUM_INPUTS];<br />
unsigned int w;<br />
unsigned int i; // nejpouzivanejsi promenna deklarovana posledni<br />
<br />
for (;;)<br />
{<br />
SDS_get_a(OPTO_FIRST, (void *)opto, NUM_INPUTS * 4); // 1 volani misto 8<br />
w = 0;<br />
for (i = NUM_INPUTS; i--; ) // cyklus dolu: i = 7 .. 0<br />
{<br />
if (opto[i] == 0) w += (i + 1) * (i + 1); // bez makra s parametry<br />
}<br />
g_weight = w; // globalni promenna zapsana jen jednou<br />
wait(100);<br />
}<br />
}<br />
</pre><br />
<br />
Změny oproti první verzi:<br />
* jedno blokové čtení místo 8 volání;<br />
* žádné makro s parametry;<br />
* mezisoučet v lokální proměnné místo globální;<br />
* cyklus směrem dolů;<br />
* konstanta definovaná těsně před použitím;<br />
* čítač cyklu deklarovaný jako poslední.<br />
<br />
Podle naměřených časů trvá jeden průchod první verze na SDS-BIG 128 cca 8–15 ms (podle počtu aktivních vstupů), druhé verze cca 2–3 ms. Na SDS-BIG 512 je to cca 3,5x méně u obou verzí; u první verze je rozdíl ještě větší, protože makra s parametry jsou na SDS-BIG 512 pomalejší.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_tips_and_tricks&diff=988FULL-C: tips and tricks2026-10-31T11:01:42Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Důležité poznámky k práci s FULL-C ==<br />
<br />
Zde jsou neseřazené tipy a triky, tak, vytvořené tak, jak jak postupem času dostáváme různé dotazy od uživatelů.<br />
<br />
Současně (na konci stránky) naleznete kritické tipy a postupy, jak efektivně zapsat váš program tak, aby byl co nejvíce rychlý. Je důležité si to přečíst.<br />
<br />
<br />
* '''Dbejte na to''', aby verze FC byla '''stejná''' jak pro překladač (FULLC.EXE) tak i pro vaše SDS. Pokud má vaše SDS starší firmware (a tedy starší verzi FC, například 0x06), zatímco překladač je novější (například FULLC.exe s verzí FC 0x08), tak SDS odmítne novější FC program spustit. Toto se řeší velmi snadno, a to aktualizací firmware ve vašem SDS.<br />
<br />
<br />
* I když proběhne překlad ve FULLC.EXE v pořádku, '''stále může váš FULL-C program obsahovat chyby''' - to se dozvíte '''teprve''' z konzole (web zařízení SDS: typicky 192.168.1.250/echo.htm), proto ji '''vždy průběžně kontrolujte''' !<br />
<br />
<br />
* Pozor na ''signed'' a ''unsigned'' typy a jejich používání. FULL-C se chová dle standardu C, a detaily standardu vás mohou zmást.<br />
<br />
Např. '''char''' je signed ! (pokud jej explicitně nedefinujeme jako '''unsigned char''').<br />
<br />
Příklad - chceme vypsat HEX kód pro jednobajtový znak.<br />
<br />
Toto ale neudělá to co "chceme": vypíše to '''FFFFFFDB''' - přesně podle specifikace jazyka C, kdy dojde nejprve k převodu na int32 <br />
<syntaxhighlight lang="c"><br />
char ch = 0xDB;<br />
printf("%x", ch);<br />
</syntaxhighlight><br />
<br />
Příklad správného zápisu: vypíše to '''DB''' tak jak chceme, a to proto že jsme správně uvedli že to chceme zpracovat jako '''unsigned char'''.<br />
<syntaxhighlight lang="c"><br />
char ch = 0xDB;<br />
printf("%x", (unsigned char)ch);<br />
</syntaxhighlight><br />
<br />
Další příklad velkého problému je následující kus programu pro výpis obsahu textového pole jako HEX znaků:<br />
<syntaxhighlight lang="c"><br />
char pole[32];<br />
char * ch;<br />
<br />
ch = (char *)&pole;<br />
for (i = 0; i < 32; i++)<br />
{<br />
printf("%02x", *ch++); // <<<<<<< WARNING !!!! *ch is signed char !!!<br />
}<br />
</syntaxhighlight><br />
<br />
Opět, správné řešení je ve správném přetypování: <pre> printf("%02x", (unsigned char)*ch++); </pre><br />
<br />
<br />
* Před provedením jakékoliv síťové komunikace ve FULL-C (např. odeslání emailu), '''vždy zkontrolujte''' stav, a to pomocí: ''status = SDS_get_u(27);'' (když je ''status==0'' tak SDS nemá připojení - nezačínejte komunikaci, čekejte a testuje stav).<br />
<br />
<br />
* Pole pro uchování textů můžete přímo deklarovat, např. na zásobníku (stack) jako ''char text[128];'' - nebo na haldě (heap), pro což využijte ''text = (char *)malloc(128);'' a ''free(text);text=0;'' funkce. Výběr z těchto možností je na vás (malé pole / malé texty jdou dát na zásobník, velké už patří do haldy).<br />
<br />
<br />
* Využijte 64-bitových proměnných (int64_t nebo uint64_t) tam, kde vám 32 bitů nestačí. Například pro počítadla, nebo výpočty s velkými čísly (nebo jen stačí že by měl být velký mezivýsledek a při použití 32-bit čísel by jste o něj "přišli").<br />
<br />
<br />
* Pro zjištění, jaký největší blok paměti (heap) lze v danou chvíli alokovat pomocí ''malloc()'' funkce, využijte funkci ''SDS_heap_stats()'' . Ačkoliv může být celková hodnota volné heap pamět velká, toto celkové volné místo je vždy roztroušeno na různé malé oddělené bloky (fragmentace) - a vždy lze alokovat jen po jednom bloku, a jeho největší možná velikost je zjistitelná právě ze zmíněné funkce.<br />
<br />
<br />
* Vždy když uvolníte paměť, nezapomeňte ihned ručně vynulovat daný uvolněný ukazatel. Zabrání to chybám ve vašem programu. Příklad: <br />
<syntaxhighlight lang="c"><br />
// definice ukazatale<br />
void *ptr; <br />
<br />
...<br />
// alokujeme si pamet, pro priklad 32 bajtu<br />
ptr = malloc(32);<br />
<br />
// pamet na kterou ukazuje ptr lze ted pouzivat (pozor at nepristupujete mimo alokovany rozsah)<br />
...<br />
<br />
// uz pamet nepotrebujeme, tak ji uvolnime:<br />
free(ptr); <br />
ptr = 0; // vzdy ihned za zavolanim free() nastavte ptr do nuly !!!<br />
<br />
... <br />
</syntaxhighlight><br />
<br />
<br />
* Funkce ''printf()'' a ''puts()'' a ''putchar()'' zapisují do konzole (web zařízení SDS, typicky: 192.168.1.250/echo.htm), čehož lze využít pro ladění programu, nebo pro dálkový monitoring zařízení. Nicméně pro průběžné spolehlivé získávání hodnot a údajů z SDS nebo vašeho programu, je vhodně použít systém sdílených proměnných, nebo SNMP.<br />
<br />
<br />
* FULL-C používá právě přesně 32-bitů pro datový typ ''float''. Počítejte s touto informací pro správné pochopení přesnosti práce s desetinnými čísly (omezené rozlišení dané 32bity). Pro většinu aplikací toto nepředstavuje problém, pokud ale chcete provádět složité výpočty s desetinnými čísly, je potřeba znát tato omezení. Přesné vysvětlení viz např. [https://en.wikipedia.org/wiki/Single-precision_floating-point_format|"Single-precision floating-point format"].<br />
<br />
<br />
* Funkce ''printf()'' a ''sprintf()'' umí zpracovat ''float'' proměnné (%f), ale neumí je uživatelský formátovat (neumí např. %0.2f - ale umí jen základní %f, to znamená že vypíše úplně celou délku čísla se všemi pozicemi za tečkou, což může být i dost dlouhý text). Toto je aktualizováno v nové verzi FULL-C (tam už to jde).<br />
<br />
<br />
* '''Nepoužívejte prázdný string''' (tj. "").<br><br />
Tři příklady '''zakázaného kódu''' pro FULL-C:<br />
<syntaxhighlight lang="c"><br />
// do not do any of the following:<br />
//<br />
char text1[10] = ""; // spatne !<br />
//<br />
strncpy(text2,"",10); // spatne !<br />
//<br />
sprintf(text2,""); // spatne !<br />
</syntaxhighlight><br />
<br />
<br />
* Před použitím některé z funkcí, které přistupují k serveru na Internetu, je vhodné provést volání ''dns_resolv()'' pro zjištění aktuální IP adresy (IP0.IP1.IP2.IP3) daného serveru, vždy před zavoláním konkrétní funkce (např. ''http_get()'' ). Určitě není vhodné používat přímo natvrdo zapsané číselné adresy (ty se mohou změnit např. při přesunu serveru).<br />
<br />
<br />
* Pokud některá z FULL-C funkcí selže (např. ''smtp_send()'' ohlásí přes ''smtp_send_status()'' chybu), tak je vhodné mít FULL-C program napsán tak, aby chvíli počkal, a pak to celé zkusil znovu. Při více selháních je pak potřeba provést další akci (oznámit chybu, zjistit stav připojení k síti, atd.).<br />
<br />
<br />
* Přes FULL-C lze '''pouze číst''' kalibrační konstanty pro analogové vstupy. Pokud je chcete hromadně nastavit, použijte s výhodou 192.168.1.250/cgi_cfg_adc?xxxx volání (uživatel musí být přihlášen).<br />
<br />
<br />
* Každý FULL-C program může nastavit tzv. "brand" (uživatelskou značku / popisek) pro zařízení SDS, na kterém je spuštěn. Protože SDS je často dodáváno v rámci OEM pro další zástavbu do většího celku, může si finální systémový integrátor nastavit své doplňující texty (název firmy, odkazy na web, telefonní čísla na podporu, doplňující texty, informace o sériovém čísle atd.), které jsou pak zobrazeny v rámci stránek webové administrace zařízení SDS (login, welcome, atd.). Toto nastavení provádí FULL-C program zavolání ''SDS_set_a()'' s příslušným indexem a textem. Typicke se takový FULL-C kód dává na úplný začátek programu.<br />
<br />
<br />
* FULL-C program lze nachystat a vydat tak, že je "zablokován" tak aby fungoval pouze na jediném konkrétním vybraném SDS zařízení. Každé SDS má své unikátní sériové číslo (viz tabulka indexů pro ''SDSget_u()'' ), a FULL-C program může tuto hodnotu porovnat (s tím, co do FULL-C programu vloží autor programu). Toto uživatelské zablokování programu může předejít chybám, kdy by se např. nevhodný program nahrál omylem na jiný hardware. Pokud vydáváte FULL-C program prostřednictvím .FC souboru, kam zvolíte nepřiložit zdrojový .C kód, pak máte neprůstřelnou možnost zamezit použití programu na jakémkoliv jiném SDS než jaké sami určíte (zdrojový kód nebude cílovému uživateli k dispozici, a navíc váš program otestuje sériové číslo daného SDS na shodu). Samozřejmě to znamená, že musíte zmíněné sériové číslo daného SDS zjistit předem, než vydáte program, aby jste to číslo mohli do programu vložit.<br />
<br />
<br />
* Pokud ve svém programu využíváte sériovou sběrnici RS485, dbejte na správné zapojení sběrnice. Naše fórum je plné příkladů, kdy autor programu řešil problém s RS485 a nakonec se ukázalo, že sběrnice byla špatně zapojená (přehozené A/B dráty, nezakončená rezistory, neuvedená do známého klidového stavu přes rezistory atd.). Pro ověření programu je vždy dobré vzít pasivní "odposlech" sběrnice (osciloskop, osobní počítač) a zkontrolovat "překryv" (kdy více zařízení vysílá najednou, což je na RS485 kolize a poškození dat). Právě "překryv" je nejčastějším problémem způsobující poškození komunikace, hned po špatném nastavení komunikační rychlosti v programu. Vždy zkontrolujte svůj hardware, tj. celou sběrnici, je-li správně impedančně zakončena (nejvzdálenější konce) a zda-li jste správně zapojili oba klidové rezistory (pozor, na SDS-BIG tyto nejsou a musí se ručně doplnit "zvenku").<br />
<br />
<br />
* Pokud chcete přes sdílené proměnné (sv) přenášet čísla datového typu ''float'' (desetinná čísla), a pak je chcete například zobrazit na UserWEB webové stránce (a nebo přenést na server atd.), použijte následující trik. Vytiskněte obsah float čísla do Txx[] proměnné, pomocí sprintf(), nikoiv však s využitím %f - ale právě přes následující kód:<br />
<syntaxhighlight lang="c"><br />
// definujeme si sdilenou promennou T00<br />
char T00[32];<br />
<br />
void FloatToT00(void)<br />
{<br />
// vstupni float<br />
float xf;<br />
<br />
// pomocna promenna (presne 4 bajty, protoze "float" je ve FULL-C reprezentovan jako 32-bit)<br />
unsigned int xw;<br />
<br />
// zapiseme vzorovou hodnotu<br />
xf = 12.34;<br />
<br />
// ziskej 32bit obsah xf (= cteni 4 bajtu dat ktere reprezentuji dany float)<br />
xw = *(unsigned int *)&xf;<br />
// a zapis do T00, zarovnej vzdy na osm mist (at se to da pozdeji spravne zpracovat - prevest zpet na float)<br />
sprintf((char *)T00, "%08X", xw);<br />
<br />
// T00[] ted obsahuje "414570A4" (coz je hex reprezentace puvodni float hodnoty 12.34)<br />
}<br />
</syntaxhighlight><br />
Pokud se po spuštění tohoto kódu pak podíváte např. na 192.168.1.250/shared.txt , tak tam uvidíte toto: "T00|414570A4|" (krom jiného textu). S tím už pak v JavaScriptu není problém pracovat (převést zpět na float a korektně zobrazit nebo dále zpracovat). Řada přímých příkladu je k dispozici, stačí hledat na Internetu podle klíčových slov "javascript convert hex to float". <br />
Toto se řeší právě z důvodu že FULL-C printf funkce (a další podobné) umí jen %f ale bez dalších parametrů, takže tisknou float čísla na všechny místa za desetinnou tečkou, což je ve většině případů nežádoucí (při zobrazování na webových stránkách a podobně).<br />
<br />
<br />
* Přistupovat ke všem údajům ze sběrnic 1-Wire, ve FULL-C, je samozřejmě možné, je však potřeba vědět jak. Detaily viz stránka [[FULL-C: OneWire]].<br />
<br />
<br />
* Pamatujte, že varianta '''SDS-64''' (viz [[SDS BIG|varianty]]) má k diposozi pouze celkem 64kB programové paměti (a SDS-128 má jen 128kB této paměti, a SDS-512 jen 512kB celkové FULL-C paměti) - do které '''se musí vlézt celý''' váš přeložený FULL-C program, a k tomu také celý STACK a všechna potřebná paměť HEAP. Toto omezení není dáno programově, ale právě použitým hardware v SDS, takže jej nelze jednoduše "obejít" - pokud se vám to nevleze do varianty 64 tak musíte použít variantu 128 (nebo 512), to je jediné řešení.<br />
<br />
<br />
* Vždy '''správně nastavte velikost''' STACKu - číselnou hodnotu nastavte v okně editoru zdrojového textu FULL-C. Pokud nastavíte hodnotu pro váš program jako moc malou, program nebude fungovat (při volání více funkcí může být pro nedostatek stacku ukončen). Příliš velká hodnota snižuje volnou paměť heap (pokud heap nepoužíváte, nastavte stack na vyšší hodnotu pro klid). Správnou hodnotu zjistíte určitým odhadem (podle velikosti a složitosti programu, podle toho kolik proměnných používáte a kolik parametrů se předává při volání funkcí, a kolik funkcí se v sobě volá). Nastavení je možné nechat automaticky odhadnou překladač, nebo jej můžete ručně zadat (odhad není přesný).<br />
<br />
<br />
* Inicializaci proměnných '''provádějte v kódu, nikoliv při deklaraci'''. Jde o to, že při inicializaci hodnot v proměnné či poli, provedené kódem, se spotřebuje zlomek stack paměti, oproti inicializace přímo při deklaraci. Stack paměti je vždy málo a je potřeba jí šetřit. Je to vlastnost FULL-C.<br />
<br />
Příklad inicializace při deklaraci: <br />
<syntaxhighlight lang="c"><br />
unsigned int numbers[5] = {0,1,2,3,4}; // toto spotřebuje hodně stacku - TAKHLE TEDY NE<br />
</syntaxhighlight><br />
Příklad identické inicializace kódem:<br />
<syntaxhighlight lang="c"><br />
// toto řešení je doporučené, nespotřebovává stack<br />
unsigned int numbers[5];<br />
number[0] = 0;<br />
number[1] = 1;<br />
number[2] = 2;<br />
number[3] = 3;<br />
number[4] = 4;<br />
</syntaxhighlight><br />
Nebo, příklad odpovídající inicializace kódem:<br />
<syntaxhighlight lang="c"><br />
// toto řešení je doporučené, nespotřebovává stack<br />
unsigned int numbers[5];<br />
unsigned int i;<br />
for (i = 0; i < 5; i++) { number[0] = i; };<br />
</syntaxhighlight><br />
<br />
<br />
>>>>>>>>>>>> Následující informace je platná pouze pro firmware starší než 10.7.2017<br />
<br />
* SDS ukazuje aktuální využití své 64kB programové paměti, na webové stránce v administraci.<br />
<pre><br />
HEAP STATS: curalloc=1892, totfree=58632 maxfree=58632, nget=12 nrel=0<br />
HEAP STATS: bc_locked=1120, stackTop=2984 (of 5000)<br />
</pre><br />
Jak to dékódovat: první řádek ukazuje celkové využití paměti a počet alokací a uvolnění:<br />
curalloc = celkem alokovaná paměť (heap malloc, a všechny interní FULL-C funkce a interní data v SDS)<br />
totfree = celkem zbývající volná (alokovatelná) heap pamět (součet všech volných heap fragmentů)<br />
maxfree = největší volný heap fragment, který je možné alokovat v jednom kuse<br />
nget = celkový počet alokací (volání malloc/calloc) (včetně vnitřních volání interních FULL-C funkcí v SDS)<br />
nrel = celkový počet uvolnění předchozích alokací (volání free() funkce)<br />
Druhý řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
bc_locked = kolik bajtů paměti je využito (uzamčeno) pro 'bytecode' vašeho FULL-C (kolik si vzal samotný kód FULL-C programu v paměti)<br />
stackTop = kolik bajtů zásobníku (stacku) je v tento okamžik využito (pokud je to na limitu, víte, že musíte upravit nastavení při překladu)<br />
(of X) = kolik bajtů může nejvíce zásobník (stack) zabrat z celé paměti (nastaveno uživatelem před překladem)<br />
<br />
<br />
<br />
>>>>>>>>>>>> Následující informace je platná pouze pro firmware 10.7.2017 (včetně) a novější (viz také [[SDS BIG|varianty]])<br />
<br />
* SDS ukazuje aktuální využití své 64kB nebo 128kB nebo 512kB programové paměti, na webové stránce v administraci.<br />
<pre><br />
FC: VER 0x08, PROGMEM 128kB<br />
MEM STATS:<br />
- HEAP: used=(492 of 120675), totfree=120164 (biggest=65396), num(get=11,rel=0)<br />
- STACK: used=(364 of 10004)<br />
- BC: locked=(264+128+388)<br />
- SYS: free=280<br />
</pre><br />
Jak to dékodovat: první řádek ukazuje informace o SDS:<br />
VER = verze FC<br />
PROGMEM = varianta hardware (64kB nebo 128kB nebo 512kB celkové paměti pro program a data)<br />
Druhý řádek ukazuje celkové využití paměti a počet alokací a uvolnění:<br />
HEAP used = celkem alokovaná paměť (heap malloc, a všechny interní FULL-C funkce a interní data v SDS)<br />
totfree = celkem zbývající volná (alokovatelná) heap pamět (součet všech volných heap fragmentů)<br />
biggest = největší volný heap fragment, který je možné alokovat v jednom kuse<br />
nget = celkový počet alokací (volání malloc/calloc) (včetně vnitřních volání interních FULL-C funkcí v SDS)<br />
nrel = celkový počet uvolnění předchozích alokací (volání free() funkce)<br />
Druhý řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
STACK used = kolik bajtů zásobníku (stacku) je v tento okamžik využito (pokud je to na limitu, víte, že musíte upravit nastavení při překladu)<br />
Třetí řádek se vztahuje na FULL-C program samotný a jeho běh:<br />
BC locked = kolik bajtů paměti je využito (uzamčeno) pro 'bytecode' vašeho FULL-C (kolik si vzal samotný kód FULL-C programu v paměti)<br />
Čtvrtý řádek nemá pro FULL-C význam:<br />
SYS = interní hodnota<br />
<br />
----<br />
<br />
== Jak funguje FULL-C v SDS ==<br />
<br />
Zde jsou popsány hlubší technologické detaily popisující princip FULL-C. Zajímat budou zejména ty, kteří pracují na složitých programech.<br />
<br />
Program je uživatelem zadán jako '''jeden jediný textový soubor - zdrojový kód v jazyce FULL-C'''. Tento zdrojový kód (text) je zpracován v naší Windows aplikaci (FULLC.exe, k dispozici ke stažení na této WiKi) do formy výsledného souboru, který primárně obsahuje tzv. ''bytecode''. Tento soubor je následně přes síť nahrán do konkrétního zařízení SDS, kde je trvale uložen (až do nahrání jiného souboru) a je zařízením SDS spouštěn.<br />
<br />
== Komprese ==<br />
<br />
Program je přenášen z FULLC.exe do SDS přes počítačovou síť. Aby se nemuselo přenášet tolik dat, je bytecode komprimován. Typická úspora je 25% původního objemu.<br />
<br />
S touto informací je potřeba plánovat při navrhování rozložení paměti - aby se tam vše vešlo. To že komprimovaný program (výstup FULLC.exe) se do paměti SDS na první pohled "vleze", ještě neznamená, že se program i podaří spustit (stále se může "vlézt", ale nezbude místo na zásobník nebo haldu - a to je konec).<br />
<br />
<br />
'''ZÁKLADNÍ OMEZENÍ''':<br />
<br />
Zařízení SDS je k dispozici ve třech základních variantách: varianta "64" má k dispozici 64kB paměti pro celkové potřeby programu, a varianta "128" má k dispozici 2x64kB (tj. 128kB) paměti pro celkové potřeby programu. Varianta "512" nabízí největší dostupnou paměť pro program a data.<br />
<br />
Do celé této celkové paměti se musí vlézt nejen surový ''bytecode'' ale i všechny provozní záležitostí (zásobník - stack, proměnné, halda - heap).<br />
<br />
<br />
'''Skladba paměti - varianta "64":'''<br />
<br />
(START I-64kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ instrukce programu (bytecode)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ halda (heap)<br />
...<br />
64kB + konec <br />
<br />
(KONEC I-64kB BLOKU)<br />
<br />
Další paměť (více než 1x 64kB) už není ve variantě "64" k dispozici - vše se tedy musí vlézt do jednoho 64kB velkého bloku. Pokud to pro vaše potřeby nestačí, musíte použít variantu s pamětí 128kB nebo 512kB, které jsou popsány dále.<br />
<br />
<br />
'''Skladba paměti - varianta "128":'''<br />
<br />
(START I-64kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ první část haldy (heap-1)<br />
...<br />
64kB + konec <br />
<br />
(KONEC I-64kB BLOKU)<br />
<br />
(START II-64kB BLOKU)<br />
<br />
0 + instrukce programu (bytecode)<br />
...<br />
+ druhá část haldy (heap-2), jen pokud nezabere program celý II-64kB blok<br />
...<br />
64kB + konec<br />
<br />
(KONEC II-64kB BLOKU)<br />
<br />
Jak lze vidět, varianta "128" nabízí dva bloky po 64kB. Tyto bloky na sebe sice lineárně nenavazují (tj. součtem je to sice 128kB, ale ne v celku), nicméně přináší významnou úlevu předchozímu omezení původní varianty "64".<br />
<br />
Pro použití varianty "128" je ovšem potřeba mít správný hardware (SDS), tzn. SDS výrobní varianty "64" nelze programově změnit na variantu "128" - to lze jedině použitím vhodného SDS hardware. Samozřejmě program původně určený pro "64" lze na SDS "128" spustit, bez jakýchkoliv omezení (ale naopak, program 128 nelze na 64 spustit, protože varianta 64 nemá dost paměti pro program varianty 128).<br />
<br />
<br />
'''Skladba paměti - varianta "512":'''<br />
<br />
(START I-504kB BLOKU)<br />
<br />
0 + zásobník (stack)<br />
...<br />
+ řetězce programu (string blob)<br />
...<br />
+ nevyužitelná rezerva systému (zhruba 260 bajtů)<br />
...<br />
+ proměnné programu (variables)<br />
...<br />
+ první část haldy (heap-1)<br />
...<br />
504kB + konec <br />
<br />
(KONEC I-504kB BLOKU)<br />
<br />
(START II-8kB BLOKU)<br />
<br />
0 + druhá část haldy (heap-2)<br />
...<br />
8kB + konec<br />
<br />
(KONEC II-8kB BLOKU)<br />
<br />
SOUČET: celková dostupná paměť 504+8 = 512kB<br />
<br />
Jak lze vidět, varianta "512" nabízí dva bloky, jeden 504kB a druhý 8kB. V součtu je k dispozici 512kB paměti, která je (dle rozpisu uvedeného výše) rozdělena na jednotlivé dynamické části - skutečně použité velikosti každé části už pak závisí na obsahu vašeho FULL-C programu a vašem nastavení (vámi určená velikost zásobníku).<br />
<br />
Programy určené pro variantu 512 lze spustit pouze na správném typu hardware - SDS varianty 512.<br />
<br />
<br />
'''Další informace:'''<br />
<br />
Velikost programu (bytecode + stringblob) a proměnných (variables) je pevná, a je přímo dána vámi tj. programátorem (podle toho, jaký napíšete program, tak bude tato oblast velká).<br />
<br />
Zbytek je použit pro haldu (heap), což je různě veliký paměťový prostor který má program k dispozici (funkce: malloc, realloc, free), pokud jej tedy potřebuje. Pokud bude váš program moc velký, pak se může stát že halda nemusí existovat - a systém nebude schopen takový program vůbec spustit ! Vždy je potřeba mít haldo o velikosti alespoň hodnoty 1/8 velikosti programu.<br />
<br />
Zásobník (stack) je vždy umístěn na začátku paměťového prostoru, a jeho velikost je opět jednorázově určena programátorem (podle odhadu nebo aktuální měření). Pokud je zásobník příliš malý, může být program předčasně ukončen (řešením je zvětšení velikosti zásobníku (na úkor velikosti heapu) a nové nahraní programu do zařízení). Toto je zřejmě nejčastější problém u většiny FULL-C programů - špatně nastavená velikost zásobníku.<br />
<br />
Informace o aktuálním vyžití celého paměťového prostoru je k dispozici ve webovém rozhraní SDS (Menu, FULL-C). Odsud lze také přečíst skutečné využití zásobníku (nejvyšší dosažená velikost).<br />
<br />
<br />
== Heap ==<br />
<br />
Typický FULL-C program v zařízení SDS nemá potřebu používat haldu (heap) - typicky všechny proměnné (i velká pole) lze bez problému staticky deklarovat.<br />
<br />
Pokud však potřebujete dynamickou alokaci paměti, tak je k dispozici ten zbytek paměťového prostoru, který zůstane "volný" po nahrání programu (a vyhrazení zásobníku).<br />
<br />
Informace o velikosti volného heapu a fragmentaci lze opět nalézt ve webovém rozhraní SDS.<br />
<br />
<br />
== Opakování varování ==<br />
<br />
Velikost programu je omezena takto:<br />
<br />
* varianta SDS 64kB: vše se musí vlézt do 64kB (bytecode, proměnné, zásobník) <br />
* varianta SDS 128kB: vše se musí vlézt do 2x 64kB (128kB s danými omezeními, především bytecode omezen na 64kB protože se musí celý vlézt do jednoho bloku)<br />
* varianta SDS 512kB: vše se musí vlézt do 512kB, přičemž součet velikosti (bytecode, všechny proměnné, zásobník) je do velikosti 504kB (vše další je dostupné jako heap)<br />
* Zásobník (stack) musí mít dostatečnou velikost pro provoz programu (všechny vnořené volání funkcí, rekurze, atd.).<br />
* Halda (heap) musí být k dispozici o dostatečné velikosti, jinak se jakýkoliv program nespustí.<br />
<br />
Pokud by váš přeložený program byl moc velký, a to tak že se spolu s ním do paměti nevlezou další potřebné věci (zásobník atd.), nebudete moct program na zařízení SDS spustit.<br />
<br />
Vždy můžete kontrolovat stav programu (a využití paměti) na stránce "FULL-C" ve webové administraci zařízení SDS.<br />
<br />
<br />
== Jak programovat ==<br />
<br />
FULL-C program musí vždy mít definovanou funkci '''main()''', která je první spuštěnou funkcí v rámci spuštění programu.<br />
<br />
<syntaxhighlight lang="c"><br />
void main(void)<br />
{<br />
;<br />
}<br />
</syntaxhighlight><br />
<br />
Je úkolem programátora, aby funkce '''main()''' nebyla opuštěna (potom je program "ukončen" protože nemá kam dál pokračovat) = v takovém případě je program ukončen, a znovu bude spuštěn až po restartu SDS (nebo když by byl nahrán nový program, tak je pak spuštěn ten).<br />
<br />
FULL-C program tedy vždy začíná jako první provádět instrukce ve funkci '''main()'''.<br />
<br />
<br />
V základu lze činnosti provádět na základě těchto vstupů:<br />
<br />
* čas (např. každou vteřinu)<br />
* hardware (např. čtení vstupů)<br />
* hodnoty [[FULL-C: sharing|sdílených proměnných]] (např. změnou proměnné z uživatelské webové stránky)<br />
<br />
Výstupy programu mohou být:<br />
<br />
* ovládání hardware (např. spínání relé)<br />
* změna hodnot sdílených proměnných (např. pro dynamické zobrazení na uživatelské webové stránce)<br />
* odesílání stavů přes síť (např. HTTP-GET nebo SNMP-TRAP)<br />
<br />
<br />
Pro všechny tyto vypsané činnosti je potřeba znát [[FULL-C: functions|funkce a příkazy]], které programu umožní právě takovéto činnosti vykonávat.<br />
<br />
<br />
== OPTIMALIZACE KÓDU a jak je SDS vůbec rychlé ? ==<br />
<br />
Bylo provedeno detailní měření na SDS-BIG, a postupy jsou použitelné pro všechna BIG a BIG2 zařízení.<br />
<br />
=== Základní orientace ===<br />
<br />
* Jeden jednoduchý příkaz (např. <code>x = y + z;</code>) trvá cca '''60–150 µs''', tj. řádově 10 000 jednoduchých příkazů za sekundu. Hlavní smyčka se 100 příkazy tak trvá cca 10 ms na jeden průchod.<br />
* Samotný výpočet je zanedbatelný: <code>+ - * / %</code>, 64bitová i float aritmetika trvají stejně. O rychlosti rozhoduje počet příkazů a způsob zápisu programu (viz tipy níže).<br />
* Výsledky měření jsou velmi opakovatelné (±0,1 %). Při nezatížené síti spotřebuje ostatní činnost SDS jen cca 2 % výkonu.<br />
<br />
=== Naměřené časy (SDS-BIG 128) ===<br />
<br />
{| class="wikitable"<br />
! Zápis !! Čas<br />
|-<br />
| prázdný cyklus <code>for (i = 0; i < n; i++) { }</code>, jeden průchod || 109 µs<br />
|-<br />
| <code>for (i = n; i--; ) { }</code> / <code>while (i--) { }</code>, jeden průchod || 52 / 46 µs<br />
|-<br />
| <code>x = 5;</code> (x je lokální proměnná) || cca 60 µs<br />
|-<br />
| <code>x = y + z;</code> || cca 105 µs<br />
|-<br />
| <code>x++;</code> / <code>++x;</code> / <code>x += 1;</code> / <code>x = x + 1;</code> || 57 / 49 / 70 / 102 µs<br />
|-<br />
| konstanta: číslo / enum / <code>#define</code> (definované těsně před použitím) || +0 / +7 / +21 µs<br />
|-<br />
| konstanta: enum / <code>#define</code> (definované na začátku velkého programu) || +47 / +62 µs<br />
|-<br />
| globální proměnná, čtení / zápis (deklarovaná na začátku programu) || +32 / +90 µs oproti lokální<br />
|-<br />
| globální proměnná, čtení / zápis (deklarovaná těsně před použitím) || +7 / +13 µs oproti lokální<br />
|-<br />
| makro s parametry, např. <code>SQR(y)</code> || 870–1600 µs (!)<br />
|-<br />
| totéž jako funkce <code>sqr(y)</code> / rozepsané <code>y * y</code> || cca 195 / 105 µs<br />
|-<br />
| volání prázdné funkce bez parametrů || cca 105 µs<br />
|-<br />
| každý parametr funkce / každá lokální proměnná ve volané funkci || +35 / +65 µs na každé volání<br />
|-<br />
| příkaz, který se neprovede (uvnitř nesplněné podmínky <code>if</code>) || cca 80 µs (provedený: cca 100 µs)<br />
|-<br />
| volání funkce, které se neprovede || cca 20 µs, bez ohledu na velikost funkce<br />
|-<br />
| <code>switch</code> nebo řetězec <code>if – else if</code>, na každou větev || cca 80–100 µs, bez ohledu na to, která větev platí<br />
|-<br />
| tabulka hodnot <code>x = tab[k];</code> || cca 120 µs<br />
|-<br />
| <code>SDS_get_u32()</code> / <code>SDS_set_u32()</code> || cca 155 / 250 µs<br />
|-<br />
| 8 vstupů: 8x <code>SDS_get_u32()</code> / 1x <code>SDS_get_a()</code> || 1400 / 320 µs<br />
|-<br />
| <code>memcpy</code>, <code>strcpy</code>, <code>strcmp</code>, <code>strlen</code>, <code>snprintf</code>, <code>atoi</code>, ... || 200–340 µs na jedno volání<br />
|-<br />
| kopie 64 bajtů vlastním cyklem / pomocí <code>memcpy</code> || 11–18 ms / 0,34 ms<br />
|-<br />
| <code>printf()</code> || cca 330 µs + 2,7 µs na každý znak<br />
|-<br />
| <code>putchar()</code> || cca 375 µs na každý znak<br />
|-<br />
| <code>wait(0)</code> / <code>wait(N)</code> || 0,6 ms / N ms + 0,5–0,7 ms<br />
|}<br />
<br />
=== Proměnné a konstanty ===<br />
<br />
* '''Nejčastěji používané proměnné funkce (čítače cyklů, mezisoučty) deklarujte jako poslední''' v seznamu deklarací. Proměnná deklarovaná později je rychlejší: čítač cyklu deklarovaný jako první z 27 lokálních proměnných zpomalí každý průchod cyklem o 38 µs, deklarovaný jako poslední nezpomalí nic.<br />
* '''Konstanty, globální proměnné a enum deklarujte co nejblíže místu použití''', např. těsně před funkcí, která je používá, nebo těsně před <code>main()</code> pro hlavní smyčku. Totéž definované na začátku velkého programu je výrazně pomalejší (viz tabulka). Navíc je to i čitelnější: definice je hned u použití.<br />
* '''Méně globálních položek = rychlejší program.''' Každá další globální proměnná, funkce nebo konstanta mírně zpomalí přístup ke všemu, co je v programu deklarováno před ní, včetně volání funkcí SDS.<br />
** Související globální proměnné spojte do jedné struktury (<code>struct</code>). Přístup k položce struktury stojí jen cca +14 µs.<br />
** Nevytvářejte zbytečně mnoho drobných globálních pomocných funkcí.<br />
* '''Používejte lokální proměnné.''' Na začátku funkce si zkopírujte globální proměnné a nastavení do lokálních proměnných, v cyklu pracujte s lokálními a výsledek zapište do globální proměnné jen jednou na konci.<br />
* '''Pro pojmenované konstanty používejte <code>enum</code> místo <code>#define</code>.''' <code>#define</code> je o cca 14 µs pomalejší než enum na stejném místě v programu. <code>#define</code> použijte jen tam, kde ho FULL-C vyžaduje (velikost pole).<br />
* '''Nepoužívejte makra s parametry''' (<code>#define SQR(a) ((a)*(a))</code>) v často prováděném kódu. Stojí 870–1600 µs na každé použití a jejich rychlost se mění s velikostí programu a stavem paměti. Použijte funkci (cca 195 µs) nebo výraz rozepište.<br />
* Nastavení, které uživatel mění, může zůstat na začátku programu jako <code>#define</code> nebo globální proměnná. Často prováděný kód si ale tyto hodnoty na začátku funkce zkopíruje do lokálních proměnných.<br />
* '''Nedeklarujte proměnné uvnitř těla cyklu''' (<code>for (...) { int t; ... }</code>). Funguje to, ale deklarace se provádí při každém průchodu (+25 µs). Deklarujte na začátku funkce.<br />
<br />
=== Cykly ===<br />
<br />
* '''Cyklus směrem dolů je dvakrát rychlejší:''' <code>for (i = n; i--; ) { ... }</code> trvá 52 µs na průchod, <code>for (i = 0; i < n; i++)</code> 109 µs. V těle cyklu má i hodnoty n-1 ... 0. <code>while (i--)</code> je stejně rychlý.<br />
* <code>while (i < n) { ...; i++; }</code> ani <code>do { } while ()</code> nejsou rychlejší než <code>for</code>.<br />
* <code>++i</code> je o něco rychlejší než <code>i++</code>, <code>i += 1</code> je pomalejší.<br />
* '''Nikdy nepoužívejte globální proměnnou jako čítač cyklu''' (+113 µs na každý průchod).<br />
* Mez cyklu jako číslo nebo lokální proměnná nic nestojí. Jako globální proměnná stojí +29 µs na průchod, jako <code>#define</code> +56 µs na průchod. Zkopírujte ji předem do lokální proměnné.<br />
* Nejvíc ušetříte tím, co z cyklu vyjmete: každý příkaz uvnitř cyklu stojí cca 100 µs na každý průchod.<br />
<br />
=== Podmínky a kód, který se neprovede ===<br />
<br />
* '''I kód, který se neprovede, zabírá čas.''' Příkaz uvnitř nesplněné podmínky stojí cca 80 µs, skoro stejně jako provedený (cca 100 µs).<br />
* '''Velké, zřídka prováděné bloky přesuňte do samostatné funkce.''' Neprovedené volání funkce stojí jen cca 20 µs, bez ohledu na to, jak je funkce velká.<br />
* '''<code>return</code> čas neušetří.''' Volání funkce trvá úměrně délce celé funkce, ne jen té části, která se provedla. Často volané funkce udržujte krátké.<br />
* '''<code>switch</code> i řetězec <code>if – else if</code> stojí cca 80–100 µs na každou větev''', bez ohledu na to, která větev platí: 2 větve cca 270 µs, 8 větví cca 770–940 µs.<br />
* '''Kde to jde, použijte tabulku hodnot''' místo dlouhého <code>switch</code> nebo řetězce <code>if</code> (<code>x = tab[k];</code> cca 120 µs). Tabulku naplňte kódem na začátku programu, protože FULL-C nepovoluje inicializaci pole v deklaraci.<br />
* <code>&&</code> pravou stranu sice neprovede, ale i tak stojí čas.<br />
* Ternární operátor <code>?:</code> trvá stejně jako <code>if / else</code> a vždy vyhodnotí obě strany. '''Používejte ho jen s čísly''': s řetězci (<code>ok ? "OK" : "CHYBA"</code>) se program zastaví s chybou "first argument to '?' should be a number".<br />
<br />
=== Výrazy a příkazy ===<br />
<br />
* Méně příkazů je rychlejší: jeden výraz <code>x = ((y+z)*(y-z))/3;</code> trvá 233 µs, totéž rozdělené do 4 příkazů 393 µs.<br />
* Používejte zkrácené zápisy: <code>x++</code> 57 µs, <code>x += 1</code> 70 µs, <code>x = x + 1</code> 102 µs.<br />
* Bitový posun a násobení / dělení trvají stejně, <code>* 8</code> není třeba nahrazovat zápisem <code><< 3</code>.<br />
<br />
=== Datové typy ===<br />
<br />
* <code>int64_t</code>, <code>uint64_t</code> ani <code>float</code> nejsou pomalejší než <code>int</code>, používejte je bez obav.<br />
* <code>char</code> ani <code>short</code> nejsou rychlejší než <code>int</code>.<br />
* <code>ftoi()</code> je pomalejší než přetypování <code>(int)</code> (199 µs proti 146 µs).<br />
<br />
=== Funkce ===<br />
<br />
* '''Funkce jsou dost rychlé na to, abyste mohli psát přehledný kód:''' volání stojí cca 100 µs, tedy zhruba jako jeden příkaz. Rozdělte program do funkcí podle úkolů.<br />
* Každý parametr prodlouží volání o cca 35 µs, každá lokální proměnná deklarovaná ve volané funkci o cca 65 µs, každá další úroveň vnoření volání o cca 90 µs.<br />
* Malé, často volané funkce by měly pracovat jen se svými parametry, bez vlastních lokálních proměnných.<br />
* Pro předání většího množství dat předejte ukazatel na strukturu místo mnoha parametrů.<br />
* Vyhněte se řetězcům drobných obalových funkcí a rekurzi (stojí čas i místo v zásobníku).<br />
* Velikost zásobníku (STACK) nastavená ve FULLC.exe musí pokrýt nejhlubší vnoření volání.<br />
<br />
<br />
=== Řetězce a paměť ===<br />
<br />
* '''Vždy používejte knihovní funkce''' (<code>memcpy</code>, <code>memset</code>, <code>strcpy</code>, <code>strlen</code>, <code>strcmp</code>, <code>snprintf</code>, <code>atoi</code>, <code>strtoul</code>, ...). Jedno volání stojí 200–340 µs bez ohledu na délku dat. Totéž vlastním cyklem je 20–50x pomalejší: kopie 64 bajtů v cyklu trvá 11–18 ms.<br />
* <code>snprintf</code> včetně formátu <code>%0.2f</code> funguje a stojí cca 260–340 µs.<br />
* '''Nepoužívejte <code>malloc</code> / <code>free</code> v cyklech.''' Fragmentace haldy (heap) zpomaluje program a může způsobit selhání síťových funkcí. Paměť alokujte jednou na začátku programu, nebo použijte pevná pole. Nechte dostatek volné haldy pro síťové funkce.<br />
<br />
=== Funkce SDS (set a get) ===<br />
<br />
* <code>SDS_get_*()</code> stojí cca 155 µs, <code>SDS_set_u32()</code> cca 250 µs.<br />
* '''Kde to tabulka indexů umožňuje (označení "(a)"), čtěte bloky pomocí <code>SDS_get_a()</code>''': 8 vstupů jedním voláním za 320 µs místo 1400 µs.<br />
* Hodnotu přečtěte jednou za průchod do lokální proměnné a dál používejte tu.<br />
<br />
=== Konzole (printf) ===<br />
<br />
* <code>printf()</code> stojí cca 330 µs + 2,7 µs na znak. <code>putchar()</code> stojí cca 375 µs '''na každý znak''', proto nikdy netiskněte po znacích.<br />
* Celý řádek si připravte pomocí <code>snprintf()</code> a vytiskněte ho jedním voláním.<br />
* Plná konzole tisk nezablokuje ani nezpomalí, ale její kapacita je omezená. Tiskněte stručně.<br />
* Konzole (echo.htm) je HTML stránka: znak <code><</code>, za kterým následuje písmeno nebo číslice, se bere jako HTML značka a část textu se nezobrazí. Ve výpisech se znaku <code><</code> vyhněte.<br />
* <code>echoclear()</code> trvá cca 1 ms.<br />
<br />
=== wait() a měření času ===<br />
<br />
* <code>wait(N)</code> trvá N ms + cca 0,5–0,7 ms, <code>wait(0)</code> trvá 0,6 ms. Nepoužívejte ho jen pro "uvolnění" procesoru.<br />
* Při silném zatížení sítě může <code>wait(N)</code> trvat až o cca 1,7 ms déle.<br />
* Pro měření času použijte index 45 (uptime v ms). Pro přesná měření lze použít index 137 (čítač cyklů CPU, na SDS-BIG 64/128 168 kroků na 1 µs), který přeteče cca po 25 s.<br />
<br />
=== Sériová linka (UART) ===<br />
<br />
Měřeno na COM6 s propojeným TX a RX, při rychlostech 9600–460800 Bd. Ve všech testech, i při silném zatížení sítě, proběhl přenos bez jediné chyby.<br />
<br />
* '''Data odesílejte jedním voláním <code>SDS_serial_write()</code>''', nikdy po znacích pomocí <code>SDS_serial_writeCH()</code> v cyklu. writeCH stojí cca 0,5 ms na každý bajt (pod zátěží sítě 0,6 ms), takže 64 bajtů trvá 33–40 ms při jakékoliv rychlosti linky.<br />
* <code>SDS_serial_write()</code> stojí cca 0,85 ms + 1,6 µs na bajt a vrací se ihned, aniž čeká na odvysílání, pokud se data vejdou do vysílacího bufferu (cca 600 B). Při větším objemu funkce čeká, dokud se zbytek do bufferu nevejde: 1024 B při 115200 Bd čekalo 34 ms.<br />
* Přijímací buffer pojme nejméně 1024 B, takže program nemusí číst nepřetržitě.<br />
* <code>SDS_serial_read()</code> stojí cca 0,35 ms i tehdy, když žádná data nečekají. Nevolejte ho v rychlé smyčce. Stačí jednou za průchod hlavní smyčkou nebo po <code>wait()</code>.<br />
* Přijatá data jsou programu k dispozici se zpožděním: dotaz a odpověď trvají nejméně cca 4 ms plus doba přenosu po lince. Data lze přečíst cca 2,5 ms po příchodu posledního bajtu. Při silném zatížení sítě se to prodlouží na cca 4,3–6 ms.<br />
* Nad cca 115200 Bd u krátkých zpráv převažuje toto pevné zpoždění. Vyšší rychlost linky pomůže jen u velkých bloků dat.<br />
<br />
=== MQTT ===<br />
<br />
* '''Nevolejte další funkci <code>mqtt_*()</code>, dokud předchozí není dokončena''': u publish, subscribe a unsubscribe sledujte <code>[12202]</code>, u connect a disconnect <code>[12200]</code>. Ve FW 0x0019080B takové volání poruší stav spojení (viz Známé chyby níže).<br />
* '''Stav spojení <code>[12200]</code> kontrolujte při každém průchodu hlavní smyčkou''' a v případě potřeby spojení obnovte postupem uvedeným v části Známé chyby. Po každém novém připojení je potřeba znovu provést subscribe, protože se tabulka přihlášení maže.<br />
* Po normálním <code>mqtt_disconnect()</code> skončí <code>[12200]</code> na hodnotě −2, ne 0. Považujte 0 i −2 za "odpojeno".<br />
* PRO FIRMWARE STARŠÍ NEŽ 31.10.2026 platí, že každá operace publish, subscribe, unsubscribe i disconnect trvá cca 0,3–0,65 s (v průměru 0,5 s) bez ohledu na velikost dat, tj. nejvýše cca 2 zprávy za sekundu.<br />
** Na dokončení publish v hlavní smyčce nečekejte. Zavolejte <code>mqtt_publish()</code>, pokračujte v jiné práci a <code>[12202]</code> zkontrolujte při dalším průchodu.<br />
** '''Posílejte více hodnot v jedné zprávě''' (např. JSON, celkem do cca 1465 znaků včetně názvu položky): publish s 1024 B trvá stejně dlouho jako s 8 B.<br />
* pouze pro '''FW 31.10.2026 a novější:''' publish, subscribe, unsubscribe i disconnect trvají cca 3–6 ms (cca 250 zpráv za sekundu), cesta zprávy přes broker a zpět cca 6 ms. Při silném zatížení sítě trvá většina publish 7–15 ms, některé ale až cca 1,5 s. Proto vždy používejte časový limit alespoň 3–5 s.<br />
* <code>mqtt_connect()</code> trvá v obou verzích firmware cca 0,2–0,45 s.<br />
* Kontrola stavu v čekací smyčce stojí cca 0,3 ms na každé čtení. Do takové smyčky dejte <code>wait(10)</code>.<br />
<br />
==== Známé chyby firmware (MQTT) ====<br />
<br />
'''1. Volání <code>mqtt_*()</code> dříve, než skončila předchozí operace, poruší stav spojení''' (opraveno teprve od FW verze 31.10.2026)<br />
* Zavoláte-li např. <code>mqtt_publish()</code> ve chvíli, kdy předchozí publish ještě probíhá, zapíše se chybový kód −3 do <code>[12200]</code> (místo do <code>[12202]</code>). <code>[12200]</code> pak zůstane trvale na −3, přestože spojení ve skutečnosti funguje, a program se tak jeví jako odpojený.<br />
* Následné přímé zavolání <code>mqtt_connect()</code> selže s výsledkem −7 (při CONNACK 0).<br />
* Ochrana: nikdy nevolejte další funkci <code>mqtt_*()</code> před dokončením předchozí (viz MQTT výše).<br />
* Obnova spojení, která funguje v obou verzích firmware (původní i opravené od 31.10.2026):<br />
*# pokud <code>[12200]</code> není 4, 0 ani −2, zavolejte <code>mqtt_disconnect()</code>;<br />
*# počkejte, až bude <code>[12200]</code> rovno 0 nebo −2 (cca 0,3 s);<br />
*# počkejte dalších 500 ms;<br />
*# zavolejte <code>mqtt_connect()</code> a počkejte na hodnotu 4;<br />
*# znovu proveďte subscribe všech položek.<br />
<br />
<br />
=== Zatížení sítě a rezerva výkonu ===<br />
<br />
* Při nezatížené síti spotřebuje ostatní činnost SDS cca 2 % výkonu, program přitom není nikdy přerušen na déle než cca 0,6 ms.<br />
* Při silném zatížení (ping a HTTP dotazy z jednoho PC) spotřebuje 15–19 % výkonu. Program pak běží o cca 18–20 % pomaleji a je často přerušován, ale nikdy na déle než cca 1,5 ms.<br />
* '''U zařízení se silným síťovým provozem počítejte s rezervou cca 25 % výkonu.''' Poměry mezi časy i všechny tipy výše platí i pod zátěží.<br />
<br />
<br />
=== Co rychlost neovlivní (pište přehledně) ===<br />
<br />
* Komentáře, i uvnitř cyklů a v neprováděných blocích.<br />
* Dlouhé, výstižné názvy proměnných.<br />
* Závorky navíc.<br />
* Rozdělení programu do funkcí podle úkolů (cca jeden příkaz na každé volání).<br />
* 64bitové a float typy.<br />
* Odsazení, prázdné řádky, formátování.<br />
<br />
=== Příklad ===<br />
<br />
Pomalý, ale běžný zápis:<br />
<pre><br />
#define OPTO_FIRST 151<br />
#define NUM_INPUTS 8<br />
#define WEIGHT(a) ((a)*(a))<br />
<br />
unsigned int g_weight;<br />
<br />
void main(void)<br />
{<br />
unsigned int i;<br />
<br />
for (;;)<br />
{<br />
g_weight = 0;<br />
for (i = 0; i < NUM_INPUTS; i++)<br />
{<br />
if (SDS_get_u32(OPTO_FIRST + i) == 0) g_weight = g_weight + WEIGHT(i + 1);<br />
}<br />
wait(100);<br />
}<br />
}<br />
</pre><br />
<br />
Totéž zapsané podle tipů výše (stejně čitelné):<br />
<pre><br />
#define NUM_INPUTS 8 // velikost pole: zde je #define nutny<br />
<br />
unsigned int g_weight; // vysledek pro zbytek programu<br />
<br />
enum inputs { OPTO_FIRST = 151 }; // definovano tesne pred pouzitim<br />
<br />
void main(void)<br />
{<br />
unsigned int opto[NUM_INPUTS];<br />
unsigned int w;<br />
unsigned int i; // nejpouzivanejsi promenna deklarovana posledni<br />
<br />
for (;;)<br />
{<br />
SDS_get_a(OPTO_FIRST, (void *)opto, NUM_INPUTS * 4); // 1 volani misto 8<br />
w = 0;<br />
for (i = NUM_INPUTS; i--; ) // cyklus dolu: i = 7 .. 0<br />
{<br />
if (opto[i] == 0) w += (i + 1) * (i + 1); // bez makra s parametry<br />
}<br />
g_weight = w; // globalni promenna zapsana jen jednou<br />
wait(100);<br />
}<br />
}<br />
</pre><br />
<br />
Změny oproti první verzi:<br />
* jedno blokové čtení místo 8 volání;<br />
* žádné makro s parametry;<br />
* mezisoučet v lokální proměnné místo globální;<br />
* cyklus směrem dolů;<br />
* konstanta definovaná těsně před použitím;<br />
* čítač cyklu deklarovaný jako poslední.<br />
<br />
Podle naměřených časů trvá jeden průchod první verze cca 8–15 ms (podle počtu aktivních vstupů), druhé verze cca 2–3 ms.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_MQTT_functions&diff=987FULL-C: MQTT functions2026-10-31T10:08:42Z<p>Adamn: </p>
<hr />
<div>FULL-C<br />
<br />
== Síťové funkce: komunikace MQTT (klient) ve FULL-C ==<br />
__NOTOC__<br />
Zařízení SDS umožňuje komunikovat s MQTT brokerem, tedy SDS lze provozovat jako MQTT klienta.<br />
<br />
Za tímto účelem jsou k dispozici tyto funkce:<br />
<pre><br />
.<br />
void mqtt_connect(unsigned int IP0, unsigned int IP1, unsigned int IP2, unsigned int IP3, unsigned int TCPport, char *ClientID, char *username, char *password, unsigned int KeepAliveSec);<br />
void mqtt_disconnect(void);<br />
void mqtt_publish(char *FullTopicName, char *Value);<br />
void mqtt_subscribe(unsigned int TableIndex, char *FullTopicName);<br />
void mqtt_unsubscribe_index(unsigned int TableIndex);<br />
void mqtt_unsubscribe_name(char *FullTopicName);<br />
</pre><br />
<br />
Proměnné IP0 až IP3 skládají (po částech) dohromady konkrétní IP adresu (IP0.IP1.IP2.IP3), ke které se SDS (MQTT klient) připojí.<br />
<br />
<br />
== Princip ==<br />
<br />
[[MQTT|Veškerý popis využití MQTT je na této stránce (odkaz je zde).]]<br />
<br />
Implementace ve FULL-C odpovídá implementaci v SDS-C, jediný rozdíl je popsán zde:<br />
* SDS-C: přístup k údajům se provádí přes systémovou proměnnou sys[2199] až sys[2321] <br />
* FULL-C: přístup k údajům se provádí přes [[FULL-C: set_and_get|SDS_get_i32() respektive SDS_get_u32()]]<br />
<br />
<br />
== Příklady ==<br />
<br />
Základní připojení k brokeru, publikování položky a odpojení:<br />
<pre><br />
. <br />
// *** CONNECT<br />
<br />
// connect on start<br />
printf("connecting to MQTT broker...\n");<br />
<br />
// ip ip ip ip port client-id username password reserved<br />
mqtt_connect(192, 168, 1, 253, 1883, "sds-client-1234", "sds1234", "password", 0);<br />
<br />
// now wait for a complete connection:<br />
<br />
// done - connected ?<br />
while (SDS_get_i32(12200) != 4) <br />
{<br />
// any error - did it fail ?<br />
if (SDS_get_i32(12200) < 0) goto mqtt_conn_fail;<br />
}<br />
<br />
// OK, done, so now:<br />
// test the CONNACK result - see "3.2.2.3 Connect Return code"<br />
<br />
if (SDS_get_i32(12201) != 0) goto mqtt_conn_fail;<br />
<br />
// CONNECTED OK ! (result is 0x00)<br />
<br />
printf("connected to broker OK, result in 12200=%d\n", SDS_get_i32(12200));<br />
<br />
<br />
// *** PUBLISH<br />
<br />
printf("publishing...");<br />
<br />
mqtt_publish("sds/temps/value1", "123456");<br />
<br />
// wait until done<br />
while (SDS_get_i32(12202) == 1)<br />
{<br />
// disconnected ?<br />
if (SDS_get_i32(12200) < 0) goto mqtt_conn_fail; <br />
}<br />
<br />
// was it success ?<br />
if (SDS_get_i32(12202) != 2)<br />
{ <br />
// it FAILED<br />
printf("publish error = %d\n", SDS_get_i32(12202)); <br />
};<br />
<br />
printf("OK\n");<br />
<br />
<br />
// *** DISCONNECT<br />
<br />
mqtt_disconnect();<br />
<br />
// todo: wait for disconnection result !!!<br />
<br />
...<br />
<br />
return;<br />
<br />
//<br />
mqtt_conn_fail:<br />
<br />
printf("connection to broker - FAILED \n");<br />
</pre><br />
<br />
Samozřejmě si z příkladu vyberete jednotlivé části tak, jak zapadají do vašeho programu. Připojení je potřeba provést "jen jednou" na začátku, a SDS automaticky udržuje spojení (MQTT PING, tedy formou protokolového keep alive) až do buď (1.) uzavření spojení nebo (2.) výpadku síťového připojení (např. odpojení ETH kabelu z SDS) nebo (3.) specifické závažné chybě při komunikace mezi SDS a brokerem/serverem. Pokud by došlo ke ztrátě spojení (což se může stát), je toto předáno formou chybového hlášení (čtení patřičného indexu pomoci SDS_get funkce), a celý proces připojení a subscribe je potřeba samozřejmě zopakovat. Je proto nezbytné trvale kontrolovat příslušné systémové indexy.<br />
<br />
Je-li SDS připojeno, lze provádět neomezené publikování hodnot, a také se lze přihlásit k odběru (subscribe).<br />
<br />
SDS nabízí možnost využít svou tabulku přihlášení (subscribe table), kam si vložíte položky které vás zajímají (každou pod jiným indexem) a SDS bude pro tyto položky trvale udržovat jejich aktuální hodnoty (values), tak jak je bude broker do SDS posílat. Váš program se pak kdykoliv do tabulky může podívat a přečíst si aktuální stav. Samozřejmě použití tabulky není nutnost, ale bez ní můžete přijít o aktualizaci, pokud ji svým programem nezachytíte.<br />
<br />
Příklad přihlášení k odběru:<br />
<pre><br />
<br />
// note. SDS shall be connected to a broker, at this point<br />
<br />
// *** let us subscribe to a topic:<br />
<br />
printf("subscribing...");<br />
<br />
// for this example, we choose index '1':<br />
mqtt_subscribe(1, "ha/output/q1/state");<br />
<br />
// wait for result<br />
while (SDS_get_i32(12202) == 4)<br />
{<br />
// disconnected ?<br />
if (SDS_get_i32(12200) < 0) goto mqtt_conn_fail;<br />
}<br />
<br />
// success ?<br />
if (SDS_get_i32(12202) != 8)<br />
{ <br />
// failed...<br />
printf("sub error = %d\n", SDS_get_i32(12202)); <br />
};<br />
<br />
// OK we ARE subscribed !<br />
<br />
printf("OK\n");<br />
<br />
<br />
// *** example: watch for updates coming from broker, and print it to console<br />
<br />
unsigned int last1;<br />
char tn[32+1];<br />
char tv[32+1];<br />
<br />
last1 = 0;<br />
<br />
while(1)<br />
{<br />
<br />
// any change ? (any new message from broker, processed by SDS ?)<br />
if (last1 != SDS_get_u32(12291)) // 12291 is a timestamp for index #1<br />
{<br />
// store so we can compare it later, again<br />
last1 = SDS_get_u32(12291);<br />
<br />
// read Topic Name (tn) and the new Value (tv)<br />
SDS_get_a(12211, &tn, 32);<br />
SDS_get_a(12251, &tv, 32);<br />
<br />
// print to console<br />
printf("TOPIC #1: %s update to: %s \n", tn, tv);<br />
};<br />
<br />
// always check the connection state<br />
if (SDS_get_i32(12200) < 0)<br />
{ <br />
// disconnected<br />
printf("disconn\n"); break;<br />
}<br />
<br />
// continue loop<br />
}<br />
<br />
<br />
...<br />
<br />
// *** unsubscribe<br />
mqtt_unsubscribe_index(1);<br />
<br />
// todo: wait for result !<br />
<br />
</pre><br />
<br />
Další příklady budou eventuálně doplněny, požadavky na ně předejte přes forum.<br />
<br />
<br />
=== Udržování spojení ===<br />
<br />
PŘÍKLAD VE FULL-C:<br />
<syntaxhighlight lang="c"><br />
// MQTT: make sure the broker is connected, reconnect if needed (blocks up to ~20 s)<br />
// returns 1 = connected, 2 = freshly reconnected (subscribe again!), 0 = failed<br />
int mq_link(void)<br />
{<br />
int st;<br />
unsigned int t0;<br />
<br />
st = SDS_get_i32(12200);<br />
if (st == 4) return 1;<br />
<br />
// not connected or status damaged (e.g. -3 after a too-early call): clean up first<br />
if ((st != 0) && (st != -2))<br />
{<br />
mqtt_disconnect();<br />
t0 = SDS_get_u32(45);<br />
for (;;)<br />
{<br />
st = SDS_get_i32(12200);<br />
if ((st == 0) || (st == -2)) break;<br />
if ((SDS_get_u32(45) - t0) > 5000) break;<br />
wait(10);<br />
}<br />
wait(500);<br />
}<br />
<br />
mqtt_connect(192, 168, 3, 99, 1883, "my-sds", "user", "password", 60);<br />
t0 = SDS_get_u32(45);<br />
for (;;)<br />
{<br />
st = SDS_get_i32(12200);<br />
if (st == 4) break;<br />
if (st < 0) return 0;<br />
if ((SDS_get_u32(45) - t0) > 15000) return 0;<br />
wait(10);<br />
}<br />
if (SDS_get_i32(12201) != 0) { mqtt_disconnect(); return 0; }<br />
return 2;<br />
}<br />
</syntaxhighlight><br />
<br />
== Hodnoty v systémových indexech ==<br />
<br />
Pomocí SDS_set_u32() lze zapsat následující hodnoty (a pomoci SDS_get_u32() je zpátky přečíst):<br />
<br />
SDS_get_u32(11198) hodnota zapsaná do MQTT PUBLISH Fixed Header<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ( výchozí hodnota je 0b00110001 )<br />
<br />
<br />
Významy údajů vrácených funkcí SDS_get_i32() pro MQTT klienta: '''Hodnoty jsou jen pro čtení (read-only).'''<br />
<br />
SDS_get_i32(12200) stav průběhu mqtt_connect()<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz 12201 )<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno a odeslán CONNECT požadavek<br />
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz 12201 )<br />
8 = probíhá odpojování, čekáme na výsledek (na odpojení)<br />
<br />
SDS_get_i32(12201) výsledek mqtt_connect() = hodnota "CONNACK Connect Return"<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
-7 = nepoužito<br />
-6 = timeout při čekání na CONNACK, nepřipojeno<br />
-5 = nepoužito<br />
-4 = nepoužito<br />
-3 = nepoužito<br />
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)<br />
-1 = idle, nepřipojeno<br />
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)<br />
1 = MQTT 0x01: Connection Refused, unacceptable protocol version<br />
2 = MQTT 0x02: Connection Refused, identifier rejected<br />
3 = MQTT 0x03: Connection Refused, Server unavailable<br />
4 = MQTT 0x04: Connection Refused, bad user name or password<br />
5 = MQTT 0x05: Connection Refused, not authorized<br />
<br />
SDS_get_i32(12202) výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci<br />
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat<br />
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity<br />
0 = nepoužito<br />
1 = mqtt_publish() probíhá<br />
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci<br />
4 = mqtt_subscribe() probíhá - čekám na SUBACK<br />
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci<br />
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)<br />
32 = UNSUBACK dorazil z Brokera, můžete volat další funkce<br />
<br />
SDS_get_i32(12203) počet chyb v přijatých datech MQTT protokolu (data z Brokeru) (chyba způsobí zavření spojení)<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
<br />
<br />
=== Známé chyby ve firmware ===<br />
<br />
V průběhu provozu řady SDS bylo mnoha uživateli testováno, jak se MQTT v SDS chová. Byly nalezeny různé záležitosti, které se průběžně v nových vydáních firmware řeši a opravují.<br />
<br />
Pokud však máte starší firmware, nebo ještě pokud nebyl vůbec opravený firmware vydán, musíte tato omezení znát a použít opravné postupy ve vlastním FULL-C programu.<br />
<br />
'''Délka odeslání MQTT dat do brokeru'''<br />
<br />
Původní firmware může mít až půl sekundy zpoždění mezi zavoláním funkce mqtt_publish() a skutečným odesláním příslušného paketu do sítě. To je řešeno v novém firmware, ale pokud jej nemáte, musíte svůj FC program psát tak, aby s tímto uměl správně pracovat. <br />
<br />
'''Špatné předání chybových stavů'''<br />
<br />
Je-li zavoláno mqtt_publish() nebo mqtt_subscribe() nebo mqtt_unsubscribe_*(), zapíše to -3 do indexu [12200] namísto správného indexu [12202].<br />
Takže [12200] zůstane s obsahem -3, i když tam ta hodnota nemá co dělat. Toto má pak důsledek v tom, že pokud váš program testuje [12200] na hodnotu 4 tak ji tam neuvidí a bude si nesprávně myslet, že došlo k odpojení SDS od brokeru.<br><br />
''Toto je opraveno v novém firmware (11/2026 a novější).''<br />
<br />
Správně to má být: <br><br />
* [12200] a [12201] = pouze pro mqtt_connect a mqtt_disconnect<br><br />
* [12202] = pouze pro mqtt_publish, mqtt_subscribe, mqtt_unsubscribe_* atd.<br><br />
<br />
Ve starším firmware byla chyba, kdy místo do [12202] se některé chybové stavy (záporné hodnoty např. -3, -5, -7 atd.) zapsaly nesprávně do [12200].<br />
<br />
<br />
'''Po odpojení přes mqtt_disconnect() občas dojde k předání chyby výpadku TCP spojení'''<br />
<br />
Toto je vlastnost, která se týká sítě, a nelze ji vždy vyloučit.<br />
<br />
Po zavolání mqtt_disconnect() může postupně dojít k zápisu hodnoty -2 do [12200] (ihned po zavolání je zapsáno 32 do [12200], a pak proběhne ukončení TCP spojení, které může ve svém postupu zapsat -2).<br />
<br />
Proto pozor při použití testu <pre>SDS_get_i32(12200) != 4</pre> , protože to může vyhodnotit v podstatě správné ukončení spojení jako chybu.<br />
<br />
<br />
<br />
Konec stránky.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_MQTT_functions&diff=986FULL-C: MQTT functions2026-10-31T10:07:49Z<p>Adamn: </p>
<hr />
<div>FULL-C<br />
<br />
== Síťové funkce: komunikace MQTT (klient) ve FULL-C ==<br />
__NOTOC__<br />
Zařízení SDS umožňuje komunikovat s MQTT brokerem, tedy SDS lze provozovat jako MQTT klienta.<br />
<br />
Za tímto účelem jsou k dispozici tyto funkce:<br />
<pre><br />
.<br />
void mqtt_connect(unsigned int IP0, unsigned int IP1, unsigned int IP2, unsigned int IP3, unsigned int TCPport, char *ClientID, char *username, char *password, unsigned int KeepAliveSec);<br />
void mqtt_disconnect(void);<br />
void mqtt_publish(char *FullTopicName, char *Value);<br />
void mqtt_subscribe(unsigned int TableIndex, char *FullTopicName);<br />
void mqtt_unsubscribe_index(unsigned int TableIndex);<br />
void mqtt_unsubscribe_name(char *FullTopicName);<br />
</pre><br />
<br />
Proměnné IP0 až IP3 skládají (po částech) dohromady konkrétní IP adresu (IP0.IP1.IP2.IP3), ke které se SDS (MQTT klient) připojí.<br />
<br />
<br />
== Princip ==<br />
<br />
[[MQTT|Veškerý popis využití MQTT je na této stránce (odkaz je zde).]]<br />
<br />
Implementace ve FULL-C odpovídá implementaci v SDS-C, jediný rozdíl je popsán zde:<br />
* SDS-C: přístup k údajům se provádí přes systémovou proměnnou sys[2199] až sys[2321] <br />
* FULL-C: přístup k údajům se provádí přes [[FULL-C: set_and_get|SDS_get_i32() respektive SDS_get_u32()]]<br />
<br />
<br />
== Příklady ==<br />
<br />
Základní připojení k brokeru, publikování položky a odpojení:<br />
<pre><br />
. <br />
// *** CONNECT<br />
<br />
// connect on start<br />
printf("connecting to MQTT broker...\n");<br />
<br />
// ip ip ip ip port client-id username password reserved<br />
mqtt_connect(192, 168, 1, 253, 1883, "sds-client-1234", "sds1234", "password", 0);<br />
<br />
// now wait for a complete connection:<br />
<br />
// done - connected ?<br />
while (SDS_get_i32(12200) != 4) <br />
{<br />
// any error - did it fail ?<br />
if (SDS_get_i32(12200) < 0) goto mqtt_conn_fail;<br />
}<br />
<br />
// OK, done, so now:<br />
// test the CONNACK result - see "3.2.2.3 Connect Return code"<br />
<br />
if (SDS_get_i32(12201) != 0) goto mqtt_conn_fail;<br />
<br />
// CONNECTED OK ! (result is 0x00)<br />
<br />
printf("connected to broker OK, result in 12200=%d\n", SDS_get_i32(12200));<br />
<br />
<br />
// *** PUBLISH<br />
<br />
printf("publishing...");<br />
<br />
mqtt_publish("sds/temps/value1", "123456");<br />
<br />
// wait until done<br />
while (SDS_get_i32(12202) == 1)<br />
{<br />
// disconnected ?<br />
if (SDS_get_i32(12200) < 0) goto mqtt_conn_fail; <br />
}<br />
<br />
// was it success ?<br />
if (SDS_get_i32(12202) != 2)<br />
{ <br />
// it FAILED<br />
printf("publish error = %d\n", SDS_get_i32(12202)); <br />
};<br />
<br />
printf("OK\n");<br />
<br />
<br />
// *** DISCONNECT<br />
<br />
mqtt_disconnect();<br />
<br />
// todo: wait for disconnection result !!!<br />
<br />
...<br />
<br />
return;<br />
<br />
//<br />
mqtt_conn_fail:<br />
<br />
printf("connection to broker - FAILED \n");<br />
</pre><br />
<br />
Samozřejmě si z příkladu vyberete jednotlivé části tak, jak zapadají do vašeho programu. Připojení je potřeba provést "jen jednou" na začátku, a SDS automaticky udržuje spojení (MQTT PING, tedy formou protokolového keep alive) až do buď (1.) uzavření spojení nebo (2.) výpadku síťového připojení (např. odpojení ETH kabelu z SDS) nebo (3.) specifické závažné chybě při komunikace mezi SDS a brokerem/serverem. Pokud by došlo ke ztrátě spojení (což se může stát), je toto předáno formou chybového hlášení (čtení patřičného indexu pomoci SDS_get funkce), a celý proces připojení a subscribe je potřeba samozřejmě zopakovat. Je proto nezbytné trvale kontrolovat příslušné systémové indexy.<br />
<br />
Je-li SDS připojeno, lze provádět neomezené publikování hodnot, a také se lze přihlásit k odběru (subscribe).<br />
<br />
SDS nabízí možnost využít svou tabulku přihlášení (subscribe table), kam si vložíte položky které vás zajímají (každou pod jiným indexem) a SDS bude pro tyto položky trvale udržovat jejich aktuální hodnoty (values), tak jak je bude broker do SDS posílat. Váš program se pak kdykoliv do tabulky může podívat a přečíst si aktuální stav. Samozřejmě použití tabulky není nutnost, ale bez ní můžete přijít o aktualizaci, pokud ji svým programem nezachytíte.<br />
<br />
Příklad přihlášení k odběru:<br />
<pre><br />
<br />
// note. SDS shall be connected to a broker, at this point<br />
<br />
// *** let us subscribe to a topic:<br />
<br />
printf("subscribing...");<br />
<br />
// for this example, we choose index '1':<br />
mqtt_subscribe(1, "ha/output/q1/state");<br />
<br />
// wait for result<br />
while (SDS_get_i32(12202) == 4)<br />
{<br />
// disconnected ?<br />
if (SDS_get_i32(12200) < 0) goto mqtt_conn_fail;<br />
}<br />
<br />
// success ?<br />
if (SDS_get_i32(12202) != 8)<br />
{ <br />
// failed...<br />
printf("sub error = %d\n", SDS_get_i32(12202)); <br />
};<br />
<br />
// OK we ARE subscribed !<br />
<br />
printf("OK\n");<br />
<br />
<br />
// *** example: watch for updates coming from broker, and print it to console<br />
<br />
unsigned int last1;<br />
char tn[32+1];<br />
char tv[32+1];<br />
<br />
last1 = 0;<br />
<br />
while(1)<br />
{<br />
<br />
// any change ? (any new message from broker, processed by SDS ?)<br />
if (last1 != SDS_get_u32(12291)) // 12291 is a timestamp for index #1<br />
{<br />
// store so we can compare it later, again<br />
last1 = SDS_get_u32(12291);<br />
<br />
// read Topic Name (tn) and the new Value (tv)<br />
SDS_get_a(12211, &tn, 32);<br />
SDS_get_a(12251, &tv, 32);<br />
<br />
// print to console<br />
printf("TOPIC #1: %s update to: %s \n", tn, tv);<br />
};<br />
<br />
// always check the connection state<br />
if (SDS_get_i32(12200) < 0)<br />
{ <br />
// disconnected<br />
printf("disconn\n"); break;<br />
}<br />
<br />
// continue loop<br />
}<br />
<br />
<br />
...<br />
<br />
// *** unsubscribe<br />
mqtt_unsubscribe_index(1);<br />
<br />
// todo: wait for result !<br />
<br />
</pre><br />
<br />
Další příklady budou eventuálně doplněny, požadavky na ně předejte přes forum.<br />
<br />
<br />
=== Udržování spojení ===<br />
<br />
PŘÍKLAD VE FULL-C:<br />
<syntaxhighlight lang="c"><br />
// MQTT: make sure the broker is connected, reconnect if needed (blocks up to ~20 s)<br />
// returns 1 = connected, 2 = freshly reconnected (subscribe again!), 0 = failed<br />
int mq_link(void)<br />
{<br />
int st;<br />
unsigned int t0;<br />
<br />
st = SDS_get_i32(12200);<br />
if (st == 4) return 1;<br />
<br />
// not connected or status damaged (e.g. -3 after a too-early call): clean up first<br />
if ((st != 0) && (st != -2))<br />
{<br />
mqtt_disconnect();<br />
t0 = SDS_get_u32(45);<br />
for (;;)<br />
{<br />
st = SDS_get_i32(12200);<br />
if ((st == 0) || (st == -2)) break;<br />
if ((SDS_get_u32(45) - t0) > 5000) break;<br />
wait(10);<br />
}<br />
wait(500);<br />
}<br />
<br />
mqtt_connect(192, 168, 3, 99, 1883, "my-sds", "user", "password", 60);<br />
t0 = SDS_get_u32(45);<br />
for (;;)<br />
{<br />
st = SDS_get_i32(12200);<br />
if (st == 4) break;<br />
if (st < 0) return 0;<br />
if ((SDS_get_u32(45) - t0) > 15000) return 0;<br />
wait(10);<br />
}<br />
if (SDS_get_i32(12201) != 0) { mqtt_disconnect(); return 0; }<br />
return 2;<br />
}<br />
</syntaxhighlight><br />
<br />
== Hodnoty v systémových indexech ==<br />
<br />
Pomocí SDS_set_u32() lze zapsat následující hodnoty (a pomoci SDS_get_u32() je zpátky přečíst):<br />
<br />
SDS_get_u32(11198) hodnota zapsaná do MQTT PUBLISH Fixed Header<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ( výchozí hodnota je 0b00110001 )<br />
<br />
<br />
Významy údajů vrácených funkcí SDS_get_i32() pro MQTT klienta: '''Hodnoty jsou jen pro čtení (read-only).'''<br />
<br />
SDS_get_i32(12200) stav průběhu mqtt_connect()<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz 12201 )<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno a odeslán CONNECT požadavek<br />
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz 12201 )<br />
8 = probíhá odpojování, čekáme na výsledek (na odpojení)<br />
<br />
SDS_get_i32(12201) výsledek mqtt_connect() = hodnota "CONNACK Connect Return"<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
-7 = nepoužito<br />
-6 = timeout při čekání na CONNACK, nepřipojeno<br />
-5 = nepoužito<br />
-4 = nepoužito<br />
-3 = nepoužito<br />
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)<br />
-1 = idle, nepřipojeno<br />
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)<br />
1 = MQTT 0x01: Connection Refused, unacceptable protocol version<br />
2 = MQTT 0x02: Connection Refused, identifier rejected<br />
3 = MQTT 0x03: Connection Refused, Server unavailable<br />
4 = MQTT 0x04: Connection Refused, bad user name or password<br />
5 = MQTT 0x05: Connection Refused, not authorized<br />
<br />
SDS_get_i32(12202) výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci<br />
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat<br />
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity<br />
0 = nepoužito<br />
1 = mqtt_publish() probíhá<br />
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci<br />
4 = mqtt_subscribe() probíhá - čekám na SUBACK<br />
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci<br />
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)<br />
32 = UNSUBACK dorazil z Brokera, můžete volat další funkce<br />
<br />
SDS_get_i32(12203) počet chyb v přijatých datech MQTT protokolu (data z Brokeru) (chyba způsobí zavření spojení)<br />
--------------------------------------------------------------------------------------------------------------------------------------------<br />
<br />
<br />
=== Známé chyby ve firmware ===<br />
<br />
V průběhu provozu řady SDS bylo mnoha uživateli testováno, jak se MQTT v SDS chová. Byly nalezeny různé záležitosti, které se průběžně v nových vydáních firmware řeši a opravují.<br />
<br />
Pokud však máte starší firmware, nebo ještě pokud nebyl vůbec opravený firmware vydán, musíte tato omezení znát a použít opravné postupy ve vlastním FULL-C programu.<br />
<br />
'''Délka odeslání MQTT dat do brokeru'''<br />
<br />
Původní firmware může mít až půl sekundy zpoždění mezi zavoláním funkce mqtt_publish() a skutečným odesláním příslušného paketu do sítě. To je řešeno v novém firmware, ale pokud jej nemáte, musíte svůj FC program psát tak, aby s tímto uměl správně pracovat. <br />
<br />
'''Špatné předání chybových stavů'''<br />
<br />
Je-li zavoláno mqtt_publish() nebo mqtt_subscribe() nebo mqtt_unsubscribe_*(), zapíše to -3 do indexu [12200] namísto správného indexu [12202].<br />
Takže [12200] zůstane s obsahem -3, i když tam ta hodnota nemá co dělat. Toto má pak důsledek v tom, že pokud váš program testuje [12200] na hodnotu 4 tak ji tam neuvidí a bude si nesprávně myslet, že došlo k odpojení SDS od brokeru.<br><br />
''Toto je opraveno v novém firmware (11/2026 a novější).''<br />
<br />
Správně to má být: <br><br />
* [12200] a [12201] = pouze pro mqtt_connect a mqtt_disconnect<br><br />
* [12202] = pouze pro mqtt_publish, mqtt_subscribe, mqtt_unsubscribe_* atd.<br><br />
<br />
Ve starším firmware byla chyba, kdy místo do [12202] se některé chybové stavy (záporné hodnoty např. -3, -5, -7 atd.) zapsaly nesprávně do [12200].<br />
<br />
<br />
'''Po odpojení přes mqtt_disconnect() občas dojde k předání chyby výpadku TCP spojení'''<br />
<br />
Toto je vlastnost, která se týká sítě, a nelze ji vždy vyloučit.<br />
<br />
Po zavolání mqtt_disconnect() může postupně dojít k zápisu hodnoty -2 do [12200] (ihned po zavolání je zapsáno 32 do [12200], a pak proběhne ukončení TCP spojení, které může ve svém postupu zapsat -2).<br />
<br />
Proto pozor při použití testu <pre>if (sys[2200] <= 0) goto error;</pre> , protože to může vyhodnotit v podstatě správné ukončení spojení jako chybu.<br />
<br />
<br />
<br />
Konec stránky.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=MQTT&diff=985MQTT2026-10-31T10:07:38Z<p>Adamn: </p>
<hr />
<div><syntaxhighlight><br />
MQTT klient je dostupný pro První i Druhou Produktovou Řadu zařízení SDS. <br />
</syntaxhighlight><br />
<br />
<br />
MQTT is a Client Server publish/subscribe messaging transport protocol.<br />
<br />
MQTT je tedy jednou z možných variant jak přenášet údaje mezi SDS ("MQTT client") a centrálním serverem ("MQTT broker").<br />
<br />
SDS podporují MQTT komunikaci za předpokladu, že máte nainstalován aktuální firmware.<br />
<br />
MQTT komunikace se provádí pomocí příslušných SDS-C / FULL-C funkcí.<br />
<br />
<br />
=== K čemu je MQTT dobré ===<br />
<br />
Postupem času se MQTT ustálilo jako nejjednodušší řešení centrálního bodu pro sběr a distribuci jednoduchých dat a údajů. <br />
<br />
Samozřejmě pro složitější aplikace už není vhodný, ale např. pro malou domácí automatizaci, v rámci domácí sítě, je to akorát.<br />
<br />
Modelový příklad: máte doma řadu chytrých zařízení které chceta navzájem provázat a to ideálně bez přidaných nákladů. Pokud tato zařízení umí komunikovat pomocí MQTT přes TCP protokol, pak vám stačí spustit MQTT Broker (např. na rPI) a všechna zařízení v tu chvíli mohou spolu instantně komunikovat stylem postupného předávání hodnot.<br />
<br />
MQTT pracuje na principu "položka - hodnota" (TOPIC - VALUE). Je to takový neomezený seznam o dvou sloupcích a mnoha řádcích (tolik řádků kolik různyćh položek). Do tohoto seznamu můžete odkudkoliv zapisovat a tím měnit jednotlivé hodnoty nebo přidávat nové položky. A také se můžete jako klient přihlásit k odběru změn (jiný klient zapíše novou hodnotu a připojení přihlášení klienti ji dostanou).<br />
<br />
Každou položku je potřeba založit - to se stane automaticky při prvním zápisu (klient vždy zapisuje ten pár Topic-Value). Pokud už položka existuje, tak se při zápisu jen změní její hodnota.<br />
<br />
Zpátky k příkladu.<br />
<br />
Mějme spoustu modulů SDS které jsou všichni MQTT klienti, připojení ke společnému MQTT brokeru (server spuštěný např. na rPI). První SDS měří teplotu a pravidelně publikuje její hodnotu na MQTT broker, do položky "teplota1".<br />
<br />
Deset dalších SDS je přihlášeno k odběru (subscribe) této položky "teplota1", a každé toto přihlášené SDS obdrží všechny nové zapsané hodnoty do této položky (které tam píše to první SDS) a na základě této hodnoty mohou provádět nějakou regulační činnost.<br />
<br />
Tím se elegantně vyřešení komunikace z prvního SDS do dalších deseti, aniž by se muselo řešit jak to složitě bez MQTT provádět.<br />
<br />
Samozřejmě toto je jen jednoduchý příklad, protože typicky MQTT systém bývá mnohem složitější - ale stále stejně snadno realizovatelný (univerzální princip Publish/Subscribe).<br />
<br />
Vždy je potřeba, aby v SDS byl nahrán aktuální FW, který MQTT podporuje - pro SDS-C to lze ověřit přes sys[2199].<br />
<br />
<br />
=== Příklad: SDS a Node-RED ===<br />
<br />
Node-RED je jedním z velice oblíbených nástrojů pro beznákladovou realizaci složitější automatizace.<br />
<br />
Ze systému [[https://cookbook.nodered.org/mqtt/connect-to-broker Node-RED]] lze SDS plně ovládat - a to formou obousměrné komunikace přes MQTT.<br />
<br />
<br />
=== Příklad: SDS a SolPIPlog ===<br />
<br />
SolPIPlog je program pro monitorování FVE měničů (MPP Solar). SDS umí s tímto programem komunikovat přes MQTT. Příkladem je např. přepínání režimu (SOL/BAT) podle stavu HDO (který SDS zjistí přes svůj optovstup, kam se připojí kontajt relé od HDO).<br />
<br />
Samozřejmě MQTT má neomezené možnosti a dva zmíněné příklady jsou opravdu jen nástřelem toho, co se dá realizovat.<br />
<br />
<br />
== Specifikace ==<br />
<br />
SDS podporuje základní MQTT 3.1.1 protokol (Level4), nad TCP; toto je současný průmyslový standard. Implementace odpovídá http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html .<br />
<br />
Klíčové funkcionality protokolu, které lze vyvolat z SDS programu:<br />
* CONNECT<br />
* DISCONNECT<br />
* PUBLISH<br />
* SUBSCRIBE (+ ACK)<br />
* UNSUBSCRIBE (+ ACK)<br />
* PINGREQ (+ PINGRESP)<br />
<br />
Interně SDS automaticky provándí MQTT PING směrem do Broker.<br />
<br />
Všechny texty jsou přenášeny ve formátu UTF-8.<br />
<br />
V tuto chvíli není implementováno WILL MESSAGE.<br />
<br />
QoS je v režimu 0x00.<br />
<br />
Keep-Alive je ve výchozím nastavení 120 sekund a odesílání PINGREQ tedy co 96 sekund. Toto nastavení lze změnit při připojení.<br />
<br />
<br />
== Použití ==<br />
<br />
Použití MQTT máte v rámci SDS plně pod svou kontrolou, tím, že si vše ovládnete ve svém programu. MQTT tedy v rámci SDS není uzavřeno do webového rozhraní apod., právě naopak, je plně k dispozici.<br />
<br />
Standardní postup je následující:<br />
* 1. otevřete spojení z SDS (klient) na MQTT server (broker) <br />
* 2. - podle potřeby odešlete data z SDS na server (funkce PUBLISH)<br />
* 3. - podle potřeby se přihlásíte k odběru dat ze serveru (funkce SUBSCRIBE)<br />
* 4. až nebude spojení na server potřeba, odpojíte se<br />
<br />
Všechny čtyři body se ovládají voláním patřičných funkcí v programu, s vhodnými parametry, a se správným zpracováním výsledných hodnot.<br />
<br />
Dokud není zavolaná funkce hotová (to si musí program hlídat čtením patřičného sys[]), nesmí být zavolána další !<br />
<br />
'''Pozor:''' při každém novém startu SDS-C programu je MQTT Broker odpojen. Váš SDS-C program se tedy musí vždy nejprve připojit, aby mohl využívat další funkce pro komunikaci s brokerem.<br />
<br />
<br />
== Jak vyvíjet a testovat ==<br />
<br />
Vývoj a testování vždy předchází plnému nasazení - je dobré si svůj program nejprve odladit.<br />
<br />
<br />
=== Simulátor SDSC.exe ===<br />
<br />
V okně "NETWORK" otevřete kartu "MQTT".<br />
<br />
Zde lze simulovat chyby (neprovedené připojení, odmítnutí hesla) a tak odzkoušet robustnost svého SDS-C programu.<br />
<br />
Dále je zde seznam položek (Topics) které jednak SDS-C program publikoval, a také ke kterým je SDS-C program přihlášen (subscribe).<br />
<br />
Přihlášené položky jsou označeny číslem indexu do tabulky (#1 .. #31 - pozor, počet je různý pro různé SDS moduly).<br />
<br />
Změna hodnoty (value) pro každou položku je možná (buď poklepáním na řádek v seznamu, nebo tlačítkem "broker publish"). Ve všech těchto případech, po provedení změny, dojde k odeslání nové hodnoty do SDS-C programu (ale to samozřejmě jen za předpokladu že program je na daný topic přihlášen).<br />
<br />
<br />
=== Skutečné SDS ===<br />
<br />
Fyzický modul SDS lze samozřejmě připojit k reálnému MQTT brokeru.<br />
<br />
Při vývoji se může hodit pomocná stránka: 192.168.1.250/cgi_mqtt .<br />
<br />
<br />
== MQTT Broker snadno a rychle ==<br />
<br />
Nainstalujte si Mosquitto MQTT broker na svůj počítač (Windows / Linux). Ověřeno to máme na Win7, Win10, a také na rPI a odroid.<br />
<br />
https://mosquitto.org/download/<br />
<br />
Pro Windows, pak stačí spustit "C:\Program Files\mosquitto\mosquitto.exe", který (při spuštění bez parametrů = výchozí stav) otevře prázdné konzolové okno a zůstane aktivní. V tuto chvíli máte na svém Win PC aktivní MQTT broker, a to na "localhost:1883" (dejte si pozor na firewall).<br />
<br />
Samozřejmě pro Linux, rPI atd. platí jiný vhodný postup, ale výsledek je stejný.<br />
<br />
SDS pak lze na tento broker (server) připojit a provádět Publish a Subscribe.<br />
<br />
Pro kontrolu toho, jak se server chová a co vše v něm je (co tam SDS nebo jiní klienti poslali), tak je k dispozici vynikající nástroj MQTT Explorer.<br />
<br />
http://mqtt-explorer.com/<br />
<br />
Je opět zdarma a důrazně doporučuji se s ním seznámit a používat to.<br />
<br />
Umožňuje jednak plnou kontrolu položek (Topics) a jejich hodnot, ale také umí tyto položky ručně vytvořit nebo do nich zapsat (což se pak přenese do klientů kteří mají Subscribe na danou položku). Zkrátka ideální pro vývoj a testování.<br />
<br />
<br />
== MQTT broker v Internetu ==<br />
<br />
Pro bezpečnost je ideální mít svůj vlastní MQTT broker ve své síti. Stačí koupit malý Linuxový počítač (např. rPI) a tam MQTT broker nainstalovat a je to.<br />
<br />
Pokud si provedete vhodné nastavení své sítě a firewallu, lze k tomuto brokeru přistupovat i z Internetu.<br />
<br />
Toto je často žádoucí, např. máte-li svou domácí automatizaci která běží na MQTT a chcete ji dálkově ovládat a kontrolovat, např. z mobilní aplikace.<br />
<br />
Druhá možnost je využít nějaký veřejný MQTT broker, je jich plný Internet - ale toto přináší řadu bezpečnostních rizik a nedoporučujeme to. Když už mít broker na Internetu, tak na svém vlastním serveru.<br />
<br />
Důležité je, že SDS (MQTT klient) používá připojení k MQTT brokeru jako plain TCP, tedy nepoužívá v této verzi SSL/TLS (to až v budoucnu SDS třetí produktové řady).<br />
<br />
Proto je důležité umístit MQTT broker do vnitřní sítě (stejná síť na které jsou SDS), která je oddělena od sítě Internet bezpečným a spravně nastaveným firewallem.<br />
<br />
Takový MQTT broker pak může snadno obsluhovat všechny SDS a další klienty přes plain TCP spoje, a do Internetu může mít dodatečně zabezpečený TLS MQTT spoj. Takhle to nastavit jde.<br />
<br />
<br />
== Implementace v SDS-C a FULL-C ==<br />
<br />
Názvy funkcí a postupy jsou pro oba programovací jazyky shodné.<br />
<br />
'''Rozdíl''' je v indexech:<br />
* SDS-C má informace a údaje v sys[2199] až sys[2321]<br />
* FULL-C má informace a údaje dostupné přes get funkci od indexu 12199 až 12321.<br />
<br />
Všimněte si, že význam indexů pro SDS-C (2199 až 2321) je 1:1 namapován na FULL-C indexy (12199 až 12321 - tedy FULL-C má pouze aplikováno pevné posunutí o 10000).<br />
<br />
[[FULL-C: MQTT_functions|Detaily pro implementaci ve FULL-C (a příklady) naleznete zde.]]<br />
<br />
<br />
== Vzorový program SDS-C - připojení a Publish ==<br />
<br />
Následující program je pro SDS První Produktové Řady, které se programují jazykem SDS-C.<br />
<br />
MQTT Broker je spuštěn (např. na rPI) na adrese 192.168.4.249 (a TCP portu 1883). Náš klient (SDS) se přihlásí jako uživatel "sds1234" s heslem "password", a následně provede 2x PUBLISH a nakonec se odpojí.<br />
<br />
<syntaxhighlight lang="c"><br />
<br />
// network communication shall be started only after the SDS is connected to network (ethernet is up)<br />
echo('waiting for network availability');<br />
<br />
waiting_ethernet:<br />
if (sys[24] == 0) goto waiting_ethernet; // 0 = no ethernet<br />
if (sys[27] == 0) goto waiting_ethernet; // 0 = no IP address<br />
<br />
// OK, now we have an ethernet connection up and running<br />
<br />
...<br />
<br />
// EXAMPLE START:<br />
<br />
<br />
// connect on start<br />
echo('connecting to MQTT Broker...');<br />
<br />
// ip ip ip ip port client-id username password keepalive(sec)<br />
mqtt_connect(192, 168, 4, 249, 1883, 'sds-client-1234', 'sds1234', 'password', 120);<br />
<br />
// wait for a complete connection<br />
label waiting_for_mqqt_conn:<br />
<br />
// error - failed ?<br />
if (sys[2200] <= 0) goto mqtt_conn_fail; // error ? (any negative number is error code)<br />
<br />
// done - connected ?<br />
if (sys[2200] != 4) goto waiting_for_mqqt_conn; // success ? (yes only if == 4)<br />
<br />
// test the CONNACK result - see "3.2.2.3 Connect Return code" - we expect "0" as OK<br />
<br />
if (sys[2201] != 0) goto mqtt_conn_fail; // is broker's result code OK ? (OK only if == 0)<br />
<br />
// connected (CONNACK result is 0x00)<br />
<br />
echo('connected to broker: OK');<br />
<br />
//<br />
<br />
<br />
// example: let us publish three various topics<br />
<br />
mqtt_publish('sds/teploty/cidlo1', sys[310]); <br />
w1: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w1; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
mqtt_publish('sds/teploty/cidlo2', sys[311]);<br />
w2: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w2; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
mqtt_publish('sds/teploty/text_xyz', 'hello:', 1234, 'there'); // <- you can pass more than one parameter (all params will get joined together)<br />
w3: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w3; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
// ...<br />
<br />
// and let us subscribe to a topic<br />
<br />
mqtt_subscribe(1, 'ha/output/q1/state');<br />
w4:<br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 4) goto w4; // still working ? <br />
if (sys[2202] != 8) // success ?<br />
{ echo('sub error = ', sys[2202]); };<br />
<br />
//...<br />
<br />
<br />
// finally, once done - close the connection <br />
<br />
// go<br />
mqtt_disconnect();<br />
<br />
// we shall wait until the connection is properly closed<br />
wait_for_disconnect:<br />
if (sys[2200] <= 0) goto error; // error ?<br />
if (sys[2200] == 8) goto wait_for_disconnect; // success, or still working ?<br />
<br />
// done !<br />
echo('DISCONNECTED from broker');<br />
<br />
wait(250);<br />
<br />
// EXIT the example - we are DONE<br />
return;<br />
<br />
<br />
// error handling<br />
label mqtt_conn_fail:<br />
echo('unable to connect... error=', sys[2200],' connack=', sys[2201]);<br />
<br />
// error handling<br />
label error:<br />
echo('error');<br />
<br />
</syntaxhighlight><br />
<br />
<br />
Pozn. mqtt_connect() - parametry:<br />
* keepalive - hodnota 0 použije výchozí nastavení (120 sec), další platné hodnoty jsou 15 až 600 (sekund).<br />
* client-id - vždy by to měla být unikátní identifikace vašeho SDS, typicky přidělena správcem MQTT Broker<br />
<br />
<br />
== Vzorový program FULL-C - připojení a Publish ==<br />
<br />
Příklady pro FULL-C jsou na samostatné stránce: [[FULL-C: MQTT_functions]].<br />
<br />
Princip použití MQTT klient ve FULL-C je identický jako pro SDS-C, jen pozor na pevně posunuté indexy.<br />
<br />
<br />
== Odesílání hodnot do Brokeru ==<br />
<br />
Je-li SDS úspěšně připojeno, pak lze odeslat libovolnou hodnotu libovolné položky (Topic) z SDS do Brokeru, který si ji uschová a který ji také předá všem dalším připojeným zařízením, které jsou k dané položce (Topic) přihlášeny (subscribed).<br />
<br />
Názvy položek musí být centrálně koordinované, aby celá akce dávala smysl. To už je na vás.<br />
<br />
'''Omezení je na současnou velikost (společnou délku) názvu položky (Topic Name) a její hodnoty (Value), což se spolu musí vlézt do nejvíce cca 1465 znaků.'''<br />
<br />
<br />
POZOR - před, a po zavolání funkce mqtt_publish() je žádoucí testovat stav sys[2202] ( respektive pro FULL-C: get(12202) ), a dokud tam nebude očekávaný výsledek nebo chybový kód, tak nevolat další mqtt_xxx funkce !<br />
<br />
Vždy musíte ve svém programu správně reagovat na všechny chybové stavy ve sys[2202] (respektive get 12202), je to váš úkol, SDS to za vás řešit nebude (a tím vám svazovat ruce).<br />
<br />
Funkce mqtt_publish() umožňuje skládání parametrů - první parametr je vždy název položky (topic name), a všechny zbylé jsou převedeny na společnou hodnotu (value).<br />
<br />
<syntaxhighlight lang="c"><br />
// you can use multiple parameters for the VALUE<br />
// only the very first parameter represents a TOPIC NAME<br />
<br />
mqtt_publish('topicname', '1234', 'abcd', 'efgh', 'xyz');<br />
<br />
// result: 'topicname' gets a new VALUE of '1234abcdefghxyz'<br />
</syntaxhighlight><br />
<br />
<br />
== Příjem hodnot z Brokeru ==<br />
<br />
SDS se umí přihlásit na odběr hodnot pro různé položky. Pokud je SDS takto přihlášeno, tak jakákoliv změna hodnoty na straně Brokera (např. způsobena zápisem jiného zařízení, aplikace, atd.), se prakticky ihned přenese do SDS, kde si aktualizovanou hodnotu může váš program zpracovat dle potřeby.<br />
<br />
Přihlášení se provádí pomocí funkce mqtt_subscribe(). Aby se to povedlo, musíte být úspěšně připojeni k Brokeru.<br />
<br />
Přihlásit se lze k libovolné položce (Topicu), jejíž celý textový název musíte samozřejmě znát.<br />
<br />
Pozor - všechny názvy položek jsou citlivé na malé a velké písmena (nejsou záměnné).<br />
<br />
Pozor - platné indexy jsou 1 až N (protože index 0 je vyhrazený pro aktuálně interně zpracovávanou položku, nelze jej využít pro program).<br />
<br />
'''PŘÍKLAD V SDS-C:'''<br />
<syntaxhighlight lang="c"><br />
<br />
// SDS-C<br />
<br />
// expectation: broker has to be already connected (see the previous example)<br />
<br />
// let us:<br />
// subscribe to a topic named: "control/rele1", and let us assigned it a local index of 1<br />
<br />
mqtt_subscribe(1, 'control/rele1');<br />
<br />
// wait for the successful subscribe <br />
wS: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected (if any negative number)<br />
if (sys[2202] == 4) goto wS; // still working... (done when != 4)<br />
if (sys[2202] != 8) // success ? (only if == 8, otherwise error or failure)<br />
{ <br />
// FAILED -> not subscribed !<br />
echo('sub error = ', sys[2202]); <br />
return;<br />
};<br />
<br />
// now, as we are subscribed, we will watch for any incoming update (value change), as in the following example:<br />
<br />
var last1;<br />
last1 = 0;<br />
<br />
loop:<br />
<br />
// any change ? (any new message?)<br />
if (last1 != sys[2291]) // sys[2291] is a timestamp for index #1<br />
{<br />
// store so we can compare it later, again<br />
last1 = sys[2291];<br />
<br />
// use the new value!<br />
echo('TOPIC #1: "',sys[2211],'" update to: "',sys[2251],'" ');<br />
};<br />
<br />
if (sys[2200] < 0) goto error; // disconnected<br />
<br />
// continue loop<br />
goto loop;<br />
<br />
<br />
// ...<br />
<br />
<br />
// once we are not interesed in the topic any more, we can unsubscribe<br />
mqtt_unsubscribe_index(1);<br />
<br />
// handle the job<br />
if (sys[2200] < 0) goto error; // disconnected<br />
wU: <br />
if (sys[2202] < 0) goto error; // error (if any negative number)<br />
if (sys[2202] == 16) goto wU; // waiting until done (done when result == 32)<br />
<br />
echo('unsubscribed');<br />
<br />
</syntaxhighlight><br />
<br />
Příklad přehledně ukazuje, jak systém funguje. Pro jednoduchost je zde hrubá nekonečná smyčka (loop) ale každý jistě vidí i své, jiné řešení vhodnější pro svůj vlastní program.<br />
<br />
Základní princip je v používání SDS indexů #1 až #31, kterým přiřazujeme jednotlivé přihlášené položky (subscribed topics).<br />
<br />
Je na tvůrci programu, jak indexy využije a kterému indexu přiřadí jaký název položky (topic name). A konkrétní názvy položek vždy záleží na celém systémovém návrhu, kde SDS je zcela transparentní.<br />
<br />
Z principu MQTT protokolu, jsou hodnoty vždy uvedeny jako textový řetězec. Např. pomocí SDS-C funkce atoi to ale snadno převedete na číslo, se kterým lze dále pracovat, je-li to potřeba.<br />
<br />
Funkce umožňuje skládání parametrů - první parametr je vždy index, a všechny zbylé jsou převedeny na název položky (topic name).<br />
<br />
<br />
POZOR - před, a po zavolání funkce mqtt_subscribe() je žádoucí testovat stav sys[2202] (respektive get 12202), a dokud tam nebude očekávaný výsledek nebo chybový kód, tak nevolat další mqtt_xxx funkce !<br />
<br />
Vždy musíte ve svém SDS-C programu správně reagovat na všechny chybové stavy ve sys[2202] (respektive get 12202), je to váš úkol, SDS to za vás řešit nebude (a tím vám svazovat ruce).<br />
<br />
<br />
=== Délka odeslání MQTT dat do brokeru ===<br />
<br />
Původní firmware může mít až půl sekundy zpoždění mezi zavoláním funkce mqtt_publish() a skutečným odesláním příslušného paketu do sítě. To je řešeno v novém firmware, ale pokud jej nemáte, musíte svůj FC program psát tak, aby s tímto uměl správně pracovat. <br />
<br />
<br />
=== Maximální velikosti (položky subscribe tabulky) ===<br />
<br />
'''Stav 06/2020'''<br />
<br />
Maximální délka názvu položky (Topic Name) pro přihlášené položky je 128 znaků.<br />
<br />
Maximální délka obsahu hodnoty (Value) pro přihlášené položky je 384 znaků.<br />
<br />
''Informace'': <br />
<br />
Chystáme úpravu aby byl aplikován jen celkový limit (512 znaků) a ne tyto dva samostatné limity. V současném FW ale zatím stále platí.<br />
<br />
Toto omezení se vztahuje jen na Subscribe Tabulku a neplatí pro PUBLISH (tam jsou omezení jiná viz text výše).<br />
<br />
<br />
=== Volba indexů ===<br />
<br />
Je čistě na vás zvolit si každý použitý index do tabulky (tzn. první parametr do funkce mqtt_subscribe).<br />
<br />
Pokud provedete přihlášení s jedním stejným indexem na více různých položek (topics), tak SDS daný požadavek do Brokeru odešle (pro každou žádost). Nicméně SDS si uschová ve své paměti jen tu nejposlednější pro každý index.<br />
<br />
Takže si dejte pozor, aby jste si pro každý index provedli přihlášení (subscribe) jen a právě jednou.<br />
<br />
Tabulka je vždy vyčištena při odpojení od Brokeru.<br />
<br />
Nechcete-li využívat této pomocné tabulky, nemusíte; ale ztrácíte výhodu uchování poslední zaslané hodnoty pro každou položku v této tabulce uschovanou.<br />
<br />
SDS samozřejmě dává programu k dispozici všechny příchozí zprávy z Brokeru, nicméně pokud jich přijde více za sebou v rychlém sledu, nemusíte je zdaleka stačit programem zpracovat. A právě proto je zde na pomoc tento systém s tabulkou, kam SDS zaručeně zařadí poslední přijaté hodnoty pro každou položku (Topic), která vás zajímá.<br />
<br />
<br />
=== Pozor ===<br />
<br />
Každé SDS má k dispozici jinak velkou tabulku pro Subscribe - tedy jsou SDS, které mají k dispozici méně indexů než plných 32. S tím musíte počítat, a můžete využívat jen tolik indexů (řádků v tabulce), kolik jich cílové SDS poskytuje.<br />
<br />
Přesnou hodnotu si může SDS-C program zjistit čtením sys[2209] (respektive get 12209).<br />
<br />
Pokud se stane, že by vám počet dostupných indexů nestačil, lze si snadno pomoct - lepším návrhem využití jednotlivých Topic. Můžete např. neplýtvat a použít jeden Topic na řízení více věcí (příklad: ovládání jednotlivých relé přes jednotlivé bity ve společném čísle, přenášeném v rámci jediného Topicu).<br />
<br />
Při každém PŘIPOJENÍ k MQTT Brokeru dojde ke smazání celé tabulky (celého obsahu). Tzn. pokaždé když zavoláte mqtt_connect() tak dojde k vyčistění obsahu tabulky - a také ke zrušení všech přihlášení.<br />
<br />
Při každém připojení tedy musíte vždy poslat všechny požadavky na přihlášení, které vás aktuálně zajímají, bez ohledu na to, k čemu jste byli přihlášeni v případném předchozím připojení.<br />
<br />
<br />
== Velikosti ==<br />
<br />
Co můžete v rámci svého programu využít:<br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''SDS'''<br />
| style="padding: 5px;background-color:#bbcdcd;"| MQTT klient <br />
| style="padding: 5px;background-color:#cdcdcd;"| FW verze <br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>ClientID<br />
| style="padding: 5px;background-color:#cdcdcd;"| max délka <br>username<br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>password<br />
| style="padding: 5px;background-color:#cdcdcd;"| max délka <br>Topic Name<br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>Value<br />
| style="padding: 5px;background-color:#cdcdcd;"| počet položek ve<br>Subscribe tabulce<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: První Produktová Řada<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS MICRO LM (LIGHT, E)'''<br />
| style="padding: 5px;"|není<br />
| style="padding: 5px;"|-<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
|-<br />
| style="padding: 5px;"|'''SDS IO6 LM'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|96<br />
| style="padding: 5px;"|192<br />
| style="padding: 5px;"|2<br />
|-<br />
| style="padding: 5px;"|'''SDS MACRO LM'''<br />
| style="padding: 5px;"|není<br />
| style="padding: 5px;"|-<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
|-<br />
| style="padding: 5px;"|'''SDS UPS ONEDPS LM'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>jen EN verze<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|3<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: První Produktová Řada - verze ST<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS MICRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS MACRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|19.10.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|96<br />
| style="padding: 5px;"|256<br />
| style="padding: 5px;"|3<br />
|-<br />
| style="padding: 5px;"|'''SDS IO6 ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS TTCPRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS MINI ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: Druhá Produktová Řada<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS BIG 512'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|20<br />
|-<br />
| style="padding: 5px;"|'''SDS BIG 64/128'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS SMALL 64/128'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS STSW''' (OEM)<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
|}</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=MQTT&diff=984MQTT2026-10-31T10:06:32Z<p>Adamn: </p>
<hr />
<div><syntaxhighlight><br />
MQTT klient je dostupný pro První i Druhou Produktovou Řadu zařízení SDS. <br />
</syntaxhighlight><br />
<br />
<br />
MQTT is a Client Server publish/subscribe messaging transport protocol.<br />
<br />
MQTT je tedy jednou z možných variant jak přenášet údaje mezi SDS ("MQTT client") a centrálním serverem ("MQTT broker").<br />
<br />
SDS podporují MQTT komunikaci za předpokladu, že máte nainstalován aktuální firmware.<br />
<br />
MQTT komunikace se provádí pomocí příslušných SDS-C / FULL-C funkcí.<br />
<br />
<br />
=== K čemu je MQTT dobré ===<br />
<br />
Postupem času se MQTT ustálilo jako nejjednodušší řešení centrálního bodu pro sběr a distribuci jednoduchých dat a údajů. <br />
<br />
Samozřejmě pro složitější aplikace už není vhodný, ale např. pro malou domácí automatizaci, v rámci domácí sítě, je to akorát.<br />
<br />
Modelový příklad: máte doma řadu chytrých zařízení které chceta navzájem provázat a to ideálně bez přidaných nákladů. Pokud tato zařízení umí komunikovat pomocí MQTT přes TCP protokol, pak vám stačí spustit MQTT Broker (např. na rPI) a všechna zařízení v tu chvíli mohou spolu instantně komunikovat stylem postupného předávání hodnot.<br />
<br />
MQTT pracuje na principu "položka - hodnota" (TOPIC - VALUE). Je to takový neomezený seznam o dvou sloupcích a mnoha řádcích (tolik řádků kolik různyćh položek). Do tohoto seznamu můžete odkudkoliv zapisovat a tím měnit jednotlivé hodnoty nebo přidávat nové položky. A také se můžete jako klient přihlásit k odběru změn (jiný klient zapíše novou hodnotu a připojení přihlášení klienti ji dostanou).<br />
<br />
Každou položku je potřeba založit - to se stane automaticky při prvním zápisu (klient vždy zapisuje ten pár Topic-Value). Pokud už položka existuje, tak se při zápisu jen změní její hodnota.<br />
<br />
Zpátky k příkladu.<br />
<br />
Mějme spoustu modulů SDS které jsou všichni MQTT klienti, připojení ke společnému MQTT brokeru (server spuštěný např. na rPI). První SDS měří teplotu a pravidelně publikuje její hodnotu na MQTT broker, do položky "teplota1".<br />
<br />
Deset dalších SDS je přihlášeno k odběru (subscribe) této položky "teplota1", a každé toto přihlášené SDS obdrží všechny nové zapsané hodnoty do této položky (které tam píše to první SDS) a na základě této hodnoty mohou provádět nějakou regulační činnost.<br />
<br />
Tím se elegantně vyřešení komunikace z prvního SDS do dalších deseti, aniž by se muselo řešit jak to složitě bez MQTT provádět.<br />
<br />
Samozřejmě toto je jen jednoduchý příklad, protože typicky MQTT systém bývá mnohem složitější - ale stále stejně snadno realizovatelný (univerzální princip Publish/Subscribe).<br />
<br />
Vždy je potřeba, aby v SDS byl nahrán aktuální FW, který MQTT podporuje - pro SDS-C to lze ověřit přes sys[2199].<br />
<br />
<br />
=== Příklad: SDS a Node-RED ===<br />
<br />
Node-RED je jedním z velice oblíbených nástrojů pro beznákladovou realizaci složitější automatizace.<br />
<br />
Ze systému [[https://cookbook.nodered.org/mqtt/connect-to-broker Node-RED]] lze SDS plně ovládat - a to formou obousměrné komunikace přes MQTT.<br />
<br />
<br />
=== Příklad: SDS a SolPIPlog ===<br />
<br />
SolPIPlog je program pro monitorování FVE měničů (MPP Solar). SDS umí s tímto programem komunikovat přes MQTT. Příkladem je např. přepínání režimu (SOL/BAT) podle stavu HDO (který SDS zjistí přes svůj optovstup, kam se připojí kontajt relé od HDO).<br />
<br />
Samozřejmě MQTT má neomezené možnosti a dva zmíněné příklady jsou opravdu jen nástřelem toho, co se dá realizovat.<br />
<br />
<br />
== Specifikace ==<br />
<br />
SDS podporuje základní MQTT 3.1.1 protokol (Level4), nad TCP; toto je současný průmyslový standard. Implementace odpovídá http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html .<br />
<br />
Klíčové funkcionality protokolu, které lze vyvolat z SDS programu:<br />
* CONNECT<br />
* DISCONNECT<br />
* PUBLISH<br />
* SUBSCRIBE (+ ACK)<br />
* UNSUBSCRIBE (+ ACK)<br />
* PINGREQ (+ PINGRESP)<br />
<br />
Interně SDS automaticky provándí MQTT PING směrem do Broker.<br />
<br />
Všechny texty jsou přenášeny ve formátu UTF-8.<br />
<br />
V tuto chvíli není implementováno WILL MESSAGE.<br />
<br />
QoS je v režimu 0x00.<br />
<br />
Keep-Alive je ve výchozím nastavení 120 sekund a odesílání PINGREQ tedy co 96 sekund. Toto nastavení lze změnit při připojení.<br />
<br />
<br />
== Použití ==<br />
<br />
Použití MQTT máte v rámci SDS plně pod svou kontrolou, tím, že si vše ovládnete ve svém programu. MQTT tedy v rámci SDS není uzavřeno do webového rozhraní apod., právě naopak, je plně k dispozici.<br />
<br />
Standardní postup je následující:<br />
* 1. otevřete spojení z SDS (klient) na MQTT server (broker) <br />
* 2. - podle potřeby odešlete data z SDS na server (funkce PUBLISH)<br />
* 3. - podle potřeby se přihlásíte k odběru dat ze serveru (funkce SUBSCRIBE)<br />
* 4. až nebude spojení na server potřeba, odpojíte se<br />
<br />
Všechny čtyři body se ovládají voláním patřičných funkcí v programu, s vhodnými parametry, a se správným zpracováním výsledných hodnot.<br />
<br />
Dokud není zavolaná funkce hotová (to si musí program hlídat čtením patřičného sys[]), nesmí být zavolána další !<br />
<br />
'''Pozor:''' při každém novém startu SDS-C programu je MQTT Broker odpojen. Váš SDS-C program se tedy musí vždy nejprve připojit, aby mohl využívat další funkce pro komunikaci s brokerem.<br />
<br />
<br />
== Jak vyvíjet a testovat ==<br />
<br />
Vývoj a testování vždy předchází plnému nasazení - je dobré si svůj program nejprve odladit.<br />
<br />
<br />
=== Simulátor SDSC.exe ===<br />
<br />
V okně "NETWORK" otevřete kartu "MQTT".<br />
<br />
Zde lze simulovat chyby (neprovedené připojení, odmítnutí hesla) a tak odzkoušet robustnost svého SDS-C programu.<br />
<br />
Dále je zde seznam položek (Topics) které jednak SDS-C program publikoval, a také ke kterým je SDS-C program přihlášen (subscribe).<br />
<br />
Přihlášené položky jsou označeny číslem indexu do tabulky (#1 .. #31 - pozor, počet je různý pro různé SDS moduly).<br />
<br />
Změna hodnoty (value) pro každou položku je možná (buď poklepáním na řádek v seznamu, nebo tlačítkem "broker publish"). Ve všech těchto případech, po provedení změny, dojde k odeslání nové hodnoty do SDS-C programu (ale to samozřejmě jen za předpokladu že program je na daný topic přihlášen).<br />
<br />
<br />
=== Skutečné SDS ===<br />
<br />
Fyzický modul SDS lze samozřejmě připojit k reálnému MQTT brokeru.<br />
<br />
Při vývoji se může hodit pomocná stránka: 192.168.1.250/cgi_mqtt .<br />
<br />
<br />
== MQTT Broker snadno a rychle ==<br />
<br />
Nainstalujte si Mosquitto MQTT broker na svůj počítač (Windows / Linux). Ověřeno to máme na Win7, Win10, a také na rPI a odroid.<br />
<br />
https://mosquitto.org/download/<br />
<br />
Pro Windows, pak stačí spustit "C:\Program Files\mosquitto\mosquitto.exe", který (při spuštění bez parametrů = výchozí stav) otevře prázdné konzolové okno a zůstane aktivní. V tuto chvíli máte na svém Win PC aktivní MQTT broker, a to na "localhost:1883" (dejte si pozor na firewall).<br />
<br />
Samozřejmě pro Linux, rPI atd. platí jiný vhodný postup, ale výsledek je stejný.<br />
<br />
SDS pak lze na tento broker (server) připojit a provádět Publish a Subscribe.<br />
<br />
Pro kontrolu toho, jak se server chová a co vše v něm je (co tam SDS nebo jiní klienti poslali), tak je k dispozici vynikající nástroj MQTT Explorer.<br />
<br />
http://mqtt-explorer.com/<br />
<br />
Je opět zdarma a důrazně doporučuji se s ním seznámit a používat to.<br />
<br />
Umožňuje jednak plnou kontrolu položek (Topics) a jejich hodnot, ale také umí tyto položky ručně vytvořit nebo do nich zapsat (což se pak přenese do klientů kteří mají Subscribe na danou položku). Zkrátka ideální pro vývoj a testování.<br />
<br />
<br />
== MQTT broker v Internetu ==<br />
<br />
Pro bezpečnost je ideální mít svůj vlastní MQTT broker ve své síti. Stačí koupit malý Linuxový počítač (např. rPI) a tam MQTT broker nainstalovat a je to.<br />
<br />
Pokud si provedete vhodné nastavení své sítě a firewallu, lze k tomuto brokeru přistupovat i z Internetu.<br />
<br />
Toto je často žádoucí, např. máte-li svou domácí automatizaci která běží na MQTT a chcete ji dálkově ovládat a kontrolovat, např. z mobilní aplikace.<br />
<br />
Druhá možnost je využít nějaký veřejný MQTT broker, je jich plný Internet - ale toto přináší řadu bezpečnostních rizik a nedoporučujeme to. Když už mít broker na Internetu, tak na svém vlastním serveru.<br />
<br />
Důležité je, že SDS (MQTT klient) používá připojení k MQTT brokeru jako plain TCP, tedy nepoužívá v této verzi SSL/TLS (to až v budoucnu SDS třetí produktové řady).<br />
<br />
Proto je důležité umístit MQTT broker do vnitřní sítě (stejná síť na které jsou SDS), která je oddělena od sítě Internet bezpečným a spravně nastaveným firewallem.<br />
<br />
Takový MQTT broker pak může snadno obsluhovat všechny SDS a další klienty přes plain TCP spoje, a do Internetu může mít dodatečně zabezpečený TLS MQTT spoj. Takhle to nastavit jde.<br />
<br />
<br />
== Implementace v SDS-C a FULL-C ==<br />
<br />
Názvy funkcí a postupy jsou pro oba programovací jazyky shodné.<br />
<br />
'''Rozdíl''' je v indexech:<br />
* SDS-C má informace a údaje v sys[2199] až sys[2321]<br />
* FULL-C má informace a údaje dostupné přes get funkci od indexu 12199 až 12321.<br />
<br />
Všimněte si, že význam indexů pro SDS-C (2199 až 2321) je 1:1 namapován na FULL-C indexy (12199 až 12321 - tedy FULL-C má pouze aplikováno pevné posunutí o 10000).<br />
<br />
[[FULL-C: MQTT_functions|Detaily pro implementaci ve FULL-C (a příklady) naleznete zde.]]<br />
<br />
<br />
== Vzorový program SDS-C - připojení a Publish ==<br />
<br />
Následující program je pro SDS První Produktové Řady, které se programují jazykem SDS-C.<br />
<br />
MQTT Broker je spuštěn (např. na rPI) na adrese 192.168.4.249 (a TCP portu 1883). Náš klient (SDS) se přihlásí jako uživatel "sds1234" s heslem "password", a následně provede 2x PUBLISH a nakonec se odpojí.<br />
<br />
<syntaxhighlight lang="c"><br />
<br />
// network communication shall be started only after the SDS is connected to network (ethernet is up)<br />
echo('waiting for network availability');<br />
<br />
waiting_ethernet:<br />
if (sys[24] == 0) goto waiting_ethernet; // 0 = no ethernet<br />
if (sys[27] == 0) goto waiting_ethernet; // 0 = no IP address<br />
<br />
// OK, now we have an ethernet connection up and running<br />
<br />
...<br />
<br />
// EXAMPLE START:<br />
<br />
<br />
// connect on start<br />
echo('connecting to MQTT Broker...');<br />
<br />
// ip ip ip ip port client-id username password keepalive(sec)<br />
mqtt_connect(192, 168, 4, 249, 1883, 'sds-client-1234', 'sds1234', 'password', 120);<br />
<br />
// wait for a complete connection<br />
label waiting_for_mqqt_conn:<br />
<br />
// error - failed ?<br />
if (sys[2200] <= 0) goto mqtt_conn_fail; // error ? (any negative number is error code)<br />
<br />
// done - connected ?<br />
if (sys[2200] != 4) goto waiting_for_mqqt_conn; // success ? (yes only if == 4)<br />
<br />
// test the CONNACK result - see "3.2.2.3 Connect Return code" - we expect "0" as OK<br />
<br />
if (sys[2201] != 0) goto mqtt_conn_fail; // is broker's result code OK ? (OK only if == 0)<br />
<br />
// connected (CONNACK result is 0x00)<br />
<br />
echo('connected to broker: OK');<br />
<br />
//<br />
<br />
<br />
// example: let us publish three various topics<br />
<br />
mqtt_publish('sds/teploty/cidlo1', sys[310]); <br />
w1: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w1; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
mqtt_publish('sds/teploty/cidlo2', sys[311]);<br />
w2: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w2; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
mqtt_publish('sds/teploty/text_xyz', 'hello:', 1234, 'there'); // <- you can pass more than one parameter (all params will get joined together)<br />
w3: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w3; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
// ...<br />
<br />
// and let us subscribe to a topic<br />
<br />
mqtt_subscribe(1, 'ha/output/q1/state');<br />
w4:<br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 4) goto w4; // still working ? <br />
if (sys[2202] != 8) // success ?<br />
{ echo('sub error = ', sys[2202]); };<br />
<br />
//...<br />
<br />
<br />
// finally, once done - close the connection <br />
<br />
// go<br />
mqtt_disconnect();<br />
<br />
// we shall wait until the connection is properly closed<br />
wait_for_disconnect:<br />
if (sys[2200] <= 0) goto error; // error ?<br />
if (sys[2200] == 8) goto wait_for_disconnect; // success, or still working ?<br />
<br />
// done !<br />
echo('DISCONNECTED from broker');<br />
<br />
wait(250);<br />
<br />
// EXIT the example - we are DONE<br />
return;<br />
<br />
<br />
// error handling<br />
label mqtt_conn_fail:<br />
echo('unable to connect... error=', sys[2200],' connack=', sys[2201]);<br />
<br />
// error handling<br />
label error:<br />
echo('error');<br />
<br />
</syntaxhighlight><br />
<br />
<br />
Pozn. mqtt_connect() - parametry:<br />
* keepalive - hodnota 0 použije výchozí nastavení (120 sec), další platné hodnoty jsou 15 až 600 (sekund).<br />
* client-id - vždy by to měla být unikátní identifikace vašeho SDS, typicky přidělena správcem MQTT Broker<br />
<br />
<br />
== Vzorový program FULL-C - připojení a Publish ==<br />
<br />
Příklady pro FULL-C jsou na samostatné stránce: [[FULL-C: MQTT_functions]].<br />
<br />
Princip použití MQTT klient ve FULL-C je identický jako pro SDS-C, jen pozor na pevně posunuté indexy.<br />
<br />
<br />
== Odesílání hodnot do Brokeru ==<br />
<br />
Je-li SDS úspěšně připojeno, pak lze odeslat libovolnou hodnotu libovolné položky (Topic) z SDS do Brokeru, který si ji uschová a který ji také předá všem dalším připojeným zařízením, které jsou k dané položce (Topic) přihlášeny (subscribed).<br />
<br />
Názvy položek musí být centrálně koordinované, aby celá akce dávala smysl. To už je na vás.<br />
<br />
'''Omezení je na současnou velikost (společnou délku) názvu položky (Topic Name) a její hodnoty (Value), což se spolu musí vlézt do nejvíce cca 1465 znaků.'''<br />
<br />
<br />
POZOR - před, a po zavolání funkce mqtt_publish() je žádoucí testovat stav sys[2202] ( respektive pro FULL-C: get(12202) ), a dokud tam nebude očekávaný výsledek nebo chybový kód, tak nevolat další mqtt_xxx funkce !<br />
<br />
Vždy musíte ve svém programu správně reagovat na všechny chybové stavy ve sys[2202] (respektive get 12202), je to váš úkol, SDS to za vás řešit nebude (a tím vám svazovat ruce).<br />
<br />
Funkce mqtt_publish() umožňuje skládání parametrů - první parametr je vždy název položky (topic name), a všechny zbylé jsou převedeny na společnou hodnotu (value).<br />
<br />
<syntaxhighlight lang="c"><br />
// you can use multiple parameters for the VALUE<br />
// only the very first parameter represents a TOPIC NAME<br />
<br />
mqtt_publish('topicname', '1234', 'abcd', 'efgh', 'xyz');<br />
<br />
// result: 'topicname' gets a new VALUE of '1234abcdefghxyz'<br />
</syntaxhighlight><br />
<br />
<br />
== Příjem hodnot z Brokeru ==<br />
<br />
SDS se umí přihlásit na odběr hodnot pro různé položky. Pokud je SDS takto přihlášeno, tak jakákoliv změna hodnoty na straně Brokera (např. způsobena zápisem jiného zařízení, aplikace, atd.), se prakticky ihned přenese do SDS, kde si aktualizovanou hodnotu může váš program zpracovat dle potřeby.<br />
<br />
Přihlášení se provádí pomocí funkce mqtt_subscribe(). Aby se to povedlo, musíte být úspěšně připojeni k Brokeru.<br />
<br />
Přihlásit se lze k libovolné položce (Topicu), jejíž celý textový název musíte samozřejmě znát.<br />
<br />
Pozor - všechny názvy položek jsou citlivé na malé a velké písmena (nejsou záměnné).<br />
<br />
Pozor - platné indexy jsou 1 až N (protože index 0 je vyhrazený pro aktuálně interně zpracovávanou položku, nelze jej využít pro program).<br />
<br />
'''PŘÍKLAD V SDS-C:'''<br />
<syntaxhighlight lang="c"><br />
<br />
// SDS-C<br />
<br />
// expectation: broker has to be already connected (see the previous example)<br />
<br />
// let us:<br />
// subscribe to a topic named: "control/rele1", and let us assigned it a local index of 1<br />
<br />
mqtt_subscribe(1, 'control/rele1');<br />
<br />
// wait for the successful subscribe <br />
wS: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected (if any negative number)<br />
if (sys[2202] == 4) goto wS; // still working... (done when != 4)<br />
if (sys[2202] != 8) // success ? (only if == 8, otherwise error or failure)<br />
{ <br />
// FAILED -> not subscribed !<br />
echo('sub error = ', sys[2202]); <br />
return;<br />
};<br />
<br />
// now, as we are subscribed, we will watch for any incoming update (value change), as in the following example:<br />
<br />
var last1;<br />
last1 = 0;<br />
<br />
loop:<br />
<br />
// any change ? (any new message?)<br />
if (last1 != sys[2291]) // sys[2291] is a timestamp for index #1<br />
{<br />
// store so we can compare it later, again<br />
last1 = sys[2291];<br />
<br />
// use the new value!<br />
echo('TOPIC #1: "',sys[2211],'" update to: "',sys[2251],'" ');<br />
};<br />
<br />
if (sys[2200] < 0) goto error; // disconnected<br />
<br />
// continue loop<br />
goto loop;<br />
<br />
<br />
// ...<br />
<br />
<br />
// once we are not interesed in the topic any more, we can unsubscribe<br />
mqtt_unsubscribe_index(1);<br />
<br />
// handle the job<br />
if (sys[2200] < 0) goto error; // disconnected<br />
wU: <br />
if (sys[2202] < 0) goto error; // error (if any negative number)<br />
if (sys[2202] == 16) goto wU; // waiting until done (done when result == 32)<br />
<br />
echo('unsubscribed');<br />
<br />
</syntaxhighlight><br />
<br />
Příklad přehledně ukazuje, jak systém funguje. Pro jednoduchost je zde hrubá nekonečná smyčka (loop) ale každý jistě vidí i své, jiné řešení vhodnější pro svůj vlastní program.<br />
<br />
Základní princip je v používání SDS indexů #1 až #31, kterým přiřazujeme jednotlivé přihlášené položky (subscribed topics).<br />
<br />
Je na tvůrci programu, jak indexy využije a kterému indexu přiřadí jaký název položky (topic name). A konkrétní názvy položek vždy záleží na celém systémovém návrhu, kde SDS je zcela transparentní.<br />
<br />
Z principu MQTT protokolu, jsou hodnoty vždy uvedeny jako textový řetězec. Např. pomocí SDS-C funkce atoi to ale snadno převedete na číslo, se kterým lze dále pracovat, je-li to potřeba.<br />
<br />
Funkce umožňuje skládání parametrů - první parametr je vždy index, a všechny zbylé jsou převedeny na název položky (topic name).<br />
<br />
<br />
POZOR - před, a po zavolání funkce mqtt_subscribe() je žádoucí testovat stav sys[2202] (respektive get 12202), a dokud tam nebude očekávaný výsledek nebo chybový kód, tak nevolat další mqtt_xxx funkce !<br />
<br />
Vždy musíte ve svém SDS-C programu správně reagovat na všechny chybové stavy ve sys[2202] (respektive get 12202), je to váš úkol, SDS to za vás řešit nebude (a tím vám svazovat ruce).<br />
<br />
<br />
=== Známé chyby ve firmware ===<br />
<br />
V průběhu provozu řady SDS bylo mnoha uživateli testováno, jak se MQTT v SDS chová. Byly nalezeny různé záležitosti, které se průběžně v nových vydáních firmware řeši a opravují.<br />
<br />
Pokud však máte starší firmware, nebo ještě pokud nebyl vůbec opravený firmware vydán, musíte tato omezení znát a použít opravné postupy ve vlastním FULL-C programu.<br />
<br />
'''Délka odeslání MQTT dat do brokeru'''<br />
<br />
Původní firmware může mít až půl sekundy zpoždění mezi zavoláním funkce mqtt_publish() a skutečným odesláním příslušného paketu do sítě. To je řešeno v novém firmware, ale pokud jej nemáte, musíte svůj FC program psát tak, aby s tímto uměl správně pracovat. <br />
<br />
'''Špatné předání chybových stavů'''<br />
<br />
Je-li zavoláno mqtt_publish() nebo mqtt_subscribe() nebo mqtt_unsubscribe_*(), zapíše to -3 do indexu [12200] namísto správného indexu [12202].<br />
Takže [12200] zůstane s obsahem -3, i když tam ta hodnota nemá co dělat. Toto má pak důsledek v tom, že pokud váš program testuje [12200] na hodnotu 4 tak ji tam neuvidí a bude si nesprávně myslet, že došlo k odpojení SDS od brokeru.<br><br />
''Toto je opraveno v novém firmware (11/2026 a novější).''<br />
<br />
Správně to má být: <br><br />
* [12200] a [12201] = pouze pro mqtt_connect a mqtt_disconnect<br><br />
* [12202] = pouze pro mqtt_publish, mqtt_subscribe, mqtt_unsubscribe_* atd.<br><br />
<br />
Ve starším firmware byla chyba, kdy místo do [12202] se některé chybové stavy (záporné hodnoty např. -3, -5, -7 atd.) zapsaly nesprávně do [12200].<br />
<br />
<br />
'''Po odpojení přes mqtt_disconnect() občas dojde k předání chyby výpadku TCP spojení'''<br />
<br />
Toto je vlastnost, která se týká sítě, a nelze ji vždy vyloučit.<br />
<br />
Po zavolání mqtt_disconnect() může postupně dojít k zápisu hodnoty -2 do [12200] (ihned po zavolání je zapsáno 32 do [12200], a pak proběhne ukončení TCP spojení, které může ve svém postupu zapsat -2).<br />
<br />
Proto pozor při použití testu <pre>if (sys[2200] <= 0) goto error;</pre> , protože to může vyhodnotit v podstatě správné ukončení spojení jako chybu.<br />
<br />
<br />
<br />
=== Maximální velikosti (položky subscribe tabulky) ===<br />
<br />
'''Stav 06/2020'''<br />
<br />
Maximální délka názvu položky (Topic Name) pro přihlášené položky je 128 znaků.<br />
<br />
Maximální délka obsahu hodnoty (Value) pro přihlášené položky je 384 znaků.<br />
<br />
''Informace'': <br />
<br />
Chystáme úpravu aby byl aplikován jen celkový limit (512 znaků) a ne tyto dva samostatné limity. V současném FW ale zatím stále platí.<br />
<br />
Toto omezení se vztahuje jen na Subscribe Tabulku a neplatí pro PUBLISH (tam jsou omezení jiná viz text výše).<br />
<br />
<br />
=== Volba indexů ===<br />
<br />
Je čistě na vás zvolit si každý použitý index do tabulky (tzn. první parametr do funkce mqtt_subscribe).<br />
<br />
Pokud provedete přihlášení s jedním stejným indexem na více různých položek (topics), tak SDS daný požadavek do Brokeru odešle (pro každou žádost). Nicméně SDS si uschová ve své paměti jen tu nejposlednější pro každý index.<br />
<br />
Takže si dejte pozor, aby jste si pro každý index provedli přihlášení (subscribe) jen a právě jednou.<br />
<br />
Tabulka je vždy vyčištena při odpojení od Brokeru.<br />
<br />
Nechcete-li využívat této pomocné tabulky, nemusíte; ale ztrácíte výhodu uchování poslední zaslané hodnoty pro každou položku v této tabulce uschovanou.<br />
<br />
SDS samozřejmě dává programu k dispozici všechny příchozí zprávy z Brokeru, nicméně pokud jich přijde více za sebou v rychlém sledu, nemusíte je zdaleka stačit programem zpracovat. A právě proto je zde na pomoc tento systém s tabulkou, kam SDS zaručeně zařadí poslední přijaté hodnoty pro každou položku (Topic), která vás zajímá.<br />
<br />
<br />
=== Pozor ===<br />
<br />
Každé SDS má k dispozici jinak velkou tabulku pro Subscribe - tedy jsou SDS, které mají k dispozici méně indexů než plných 32. S tím musíte počítat, a můžete využívat jen tolik indexů (řádků v tabulce), kolik jich cílové SDS poskytuje.<br />
<br />
Přesnou hodnotu si může SDS-C program zjistit čtením sys[2209] (respektive get 12209).<br />
<br />
Pokud se stane, že by vám počet dostupných indexů nestačil, lze si snadno pomoct - lepším návrhem využití jednotlivých Topic. Můžete např. neplýtvat a použít jeden Topic na řízení více věcí (příklad: ovládání jednotlivých relé přes jednotlivé bity ve společném čísle, přenášeném v rámci jediného Topicu).<br />
<br />
Při každém PŘIPOJENÍ k MQTT Brokeru dojde ke smazání celé tabulky (celého obsahu). Tzn. pokaždé když zavoláte mqtt_connect() tak dojde k vyčistění obsahu tabulky - a také ke zrušení všech přihlášení.<br />
<br />
Při každém připojení tedy musíte vždy poslat všechny požadavky na přihlášení, které vás aktuálně zajímají, bez ohledu na to, k čemu jste byli přihlášeni v případném předchozím připojení.<br />
<br />
<br />
== Velikosti ==<br />
<br />
Co můžete v rámci svého programu využít:<br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''SDS'''<br />
| style="padding: 5px;background-color:#bbcdcd;"| MQTT klient <br />
| style="padding: 5px;background-color:#cdcdcd;"| FW verze <br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>ClientID<br />
| style="padding: 5px;background-color:#cdcdcd;"| max délka <br>username<br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>password<br />
| style="padding: 5px;background-color:#cdcdcd;"| max délka <br>Topic Name<br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>Value<br />
| style="padding: 5px;background-color:#cdcdcd;"| počet položek ve<br>Subscribe tabulce<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: První Produktová Řada<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS MICRO LM (LIGHT, E)'''<br />
| style="padding: 5px;"|není<br />
| style="padding: 5px;"|-<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
|-<br />
| style="padding: 5px;"|'''SDS IO6 LM'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|96<br />
| style="padding: 5px;"|192<br />
| style="padding: 5px;"|2<br />
|-<br />
| style="padding: 5px;"|'''SDS MACRO LM'''<br />
| style="padding: 5px;"|není<br />
| style="padding: 5px;"|-<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
|-<br />
| style="padding: 5px;"|'''SDS UPS ONEDPS LM'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>jen EN verze<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|3<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: První Produktová Řada - verze ST<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS MICRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS MACRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|19.10.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|96<br />
| style="padding: 5px;"|256<br />
| style="padding: 5px;"|3<br />
|-<br />
| style="padding: 5px;"|'''SDS IO6 ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS TTCPRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS MINI ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: Druhá Produktová Řada<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS BIG 512'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|20<br />
|-<br />
| style="padding: 5px;"|'''SDS BIG 64/128'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS SMALL 64/128'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS STSW''' (OEM)<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
|}</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=MQTT&diff=983MQTT2026-10-31T10:05:35Z<p>Adamn: </p>
<hr />
<div><syntaxhighlight><br />
MQTT klient je dostupný pro První i Druhou Produktovou Řadu zařízení SDS. <br />
</syntaxhighlight><br />
<br />
<br />
MQTT is a Client Server publish/subscribe messaging transport protocol.<br />
<br />
MQTT je tedy jednou z možných variant jak přenášet údaje mezi SDS ("MQTT client") a centrálním serverem ("MQTT broker").<br />
<br />
SDS podporují MQTT komunikaci za předpokladu, že máte nainstalován aktuální firmware.<br />
<br />
MQTT komunikace se provádí pomocí příslušných SDS-C / FULL-C funkcí.<br />
<br />
<br />
=== K čemu je MQTT dobré ===<br />
<br />
Postupem času se MQTT ustálilo jako nejjednodušší řešení centrálního bodu pro sběr a distribuci jednoduchých dat a údajů. <br />
<br />
Samozřejmě pro složitější aplikace už není vhodný, ale např. pro malou domácí automatizaci, v rámci domácí sítě, je to akorát.<br />
<br />
Modelový příklad: máte doma řadu chytrých zařízení které chceta navzájem provázat a to ideálně bez přidaných nákladů. Pokud tato zařízení umí komunikovat pomocí MQTT přes TCP protokol, pak vám stačí spustit MQTT Broker (např. na rPI) a všechna zařízení v tu chvíli mohou spolu instantně komunikovat stylem postupného předávání hodnot.<br />
<br />
MQTT pracuje na principu "položka - hodnota" (TOPIC - VALUE). Je to takový neomezený seznam o dvou sloupcích a mnoha řádcích (tolik řádků kolik různyćh položek). Do tohoto seznamu můžete odkudkoliv zapisovat a tím měnit jednotlivé hodnoty nebo přidávat nové položky. A také se můžete jako klient přihlásit k odběru změn (jiný klient zapíše novou hodnotu a připojení přihlášení klienti ji dostanou).<br />
<br />
Každou položku je potřeba založit - to se stane automaticky při prvním zápisu (klient vždy zapisuje ten pár Topic-Value). Pokud už položka existuje, tak se při zápisu jen změní její hodnota.<br />
<br />
Zpátky k příkladu.<br />
<br />
Mějme spoustu modulů SDS které jsou všichni MQTT klienti, připojení ke společnému MQTT brokeru (server spuštěný např. na rPI). První SDS měří teplotu a pravidelně publikuje její hodnotu na MQTT broker, do položky "teplota1".<br />
<br />
Deset dalších SDS je přihlášeno k odběru (subscribe) této položky "teplota1", a každé toto přihlášené SDS obdrží všechny nové zapsané hodnoty do této položky (které tam píše to první SDS) a na základě této hodnoty mohou provádět nějakou regulační činnost.<br />
<br />
Tím se elegantně vyřešení komunikace z prvního SDS do dalších deseti, aniž by se muselo řešit jak to složitě bez MQTT provádět.<br />
<br />
Samozřejmě toto je jen jednoduchý příklad, protože typicky MQTT systém bývá mnohem složitější - ale stále stejně snadno realizovatelný (univerzální princip Publish/Subscribe).<br />
<br />
Vždy je potřeba, aby v SDS byl nahrán aktuální FW, který MQTT podporuje - pro SDS-C to lze ověřit přes sys[2199].<br />
<br />
<br />
=== Příklad: SDS a Node-RED ===<br />
<br />
Node-RED je jedním z velice oblíbených nástrojů pro beznákladovou realizaci složitější automatizace.<br />
<br />
Ze systému [[https://cookbook.nodered.org/mqtt/connect-to-broker Node-RED]] lze SDS plně ovládat - a to formou obousměrné komunikace přes MQTT.<br />
<br />
<br />
=== Příklad: SDS a SolPIPlog ===<br />
<br />
SolPIPlog je program pro monitorování FVE měničů (MPP Solar). SDS umí s tímto programem komunikovat přes MQTT. Příkladem je např. přepínání režimu (SOL/BAT) podle stavu HDO (který SDS zjistí přes svůj optovstup, kam se připojí kontajt relé od HDO).<br />
<br />
Samozřejmě MQTT má neomezené možnosti a dva zmíněné příklady jsou opravdu jen nástřelem toho, co se dá realizovat.<br />
<br />
<br />
== Specifikace ==<br />
<br />
SDS podporuje základní MQTT 3.1.1 protokol (Level4), nad TCP; toto je současný průmyslový standard. Implementace odpovídá http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html .<br />
<br />
Klíčové funkcionality protokolu, které lze vyvolat z SDS programu:<br />
* CONNECT<br />
* DISCONNECT<br />
* PUBLISH<br />
* SUBSCRIBE (+ ACK)<br />
* UNSUBSCRIBE (+ ACK)<br />
* PINGREQ (+ PINGRESP)<br />
<br />
Interně SDS automaticky provándí MQTT PING směrem do Broker.<br />
<br />
Všechny texty jsou přenášeny ve formátu UTF-8.<br />
<br />
V tuto chvíli není implementováno WILL MESSAGE.<br />
<br />
QoS je v režimu 0x00.<br />
<br />
Keep-Alive je ve výchozím nastavení 120 sekund a odesílání PINGREQ tedy co 96 sekund. Toto nastavení lze změnit při připojení.<br />
<br />
<br />
== Použití ==<br />
<br />
Použití MQTT máte v rámci SDS plně pod svou kontrolou, tím, že si vše ovládnete ve svém programu. MQTT tedy v rámci SDS není uzavřeno do webového rozhraní apod., právě naopak, je plně k dispozici.<br />
<br />
Standardní postup je následující:<br />
* 1. otevřete spojení z SDS (klient) na MQTT server (broker) <br />
* 2. - podle potřeby odešlete data z SDS na server (funkce PUBLISH)<br />
* 3. - podle potřeby se přihlásíte k odběru dat ze serveru (funkce SUBSCRIBE)<br />
* 4. až nebude spojení na server potřeba, odpojíte se<br />
<br />
Všechny čtyři body se ovládají voláním patřičných funkcí v programu, s vhodnými parametry, a se správným zpracováním výsledných hodnot.<br />
<br />
Dokud není zavolaná funkce hotová (to si musí program hlídat čtením patřičného sys[]), nesmí být zavolána další !<br />
<br />
'''Pozor:''' při každém novém startu SDS-C programu je MQTT Broker odpojen. Váš SDS-C program se tedy musí vždy nejprve připojit, aby mohl využívat další funkce pro komunikaci s brokerem.<br />
<br />
<br />
== Jak vyvíjet a testovat ==<br />
<br />
Vývoj a testování vždy předchází plnému nasazení - je dobré si svůj program nejprve odladit.<br />
<br />
<br />
=== Simulátor SDSC.exe ===<br />
<br />
V okně "NETWORK" otevřete kartu "MQTT".<br />
<br />
Zde lze simulovat chyby (neprovedené připojení, odmítnutí hesla) a tak odzkoušet robustnost svého SDS-C programu.<br />
<br />
Dále je zde seznam položek (Topics) které jednak SDS-C program publikoval, a také ke kterým je SDS-C program přihlášen (subscribe).<br />
<br />
Přihlášené položky jsou označeny číslem indexu do tabulky (#1 .. #31 - pozor, počet je různý pro různé SDS moduly).<br />
<br />
Změna hodnoty (value) pro každou položku je možná (buď poklepáním na řádek v seznamu, nebo tlačítkem "broker publish"). Ve všech těchto případech, po provedení změny, dojde k odeslání nové hodnoty do SDS-C programu (ale to samozřejmě jen za předpokladu že program je na daný topic přihlášen).<br />
<br />
<br />
=== Skutečné SDS ===<br />
<br />
Fyzický modul SDS lze samozřejmě připojit k reálnému MQTT brokeru.<br />
<br />
Při vývoji se může hodit pomocná stránka: 192.168.1.250/cgi_mqtt .<br />
<br />
<br />
== MQTT Broker snadno a rychle ==<br />
<br />
Nainstalujte si Mosquitto MQTT broker na svůj počítač (Windows / Linux). Ověřeno to máme na Win7, Win10, a také na rPI a odroid.<br />
<br />
https://mosquitto.org/download/<br />
<br />
Pro Windows, pak stačí spustit "C:\Program Files\mosquitto\mosquitto.exe", který (při spuštění bez parametrů = výchozí stav) otevře prázdné konzolové okno a zůstane aktivní. V tuto chvíli máte na svém Win PC aktivní MQTT broker, a to na "localhost:1883" (dejte si pozor na firewall).<br />
<br />
Samozřejmě pro Linux, rPI atd. platí jiný vhodný postup, ale výsledek je stejný.<br />
<br />
SDS pak lze na tento broker (server) připojit a provádět Publish a Subscribe.<br />
<br />
Pro kontrolu toho, jak se server chová a co vše v něm je (co tam SDS nebo jiní klienti poslali), tak je k dispozici vynikající nástroj MQTT Explorer.<br />
<br />
http://mqtt-explorer.com/<br />
<br />
Je opět zdarma a důrazně doporučuji se s ním seznámit a používat to.<br />
<br />
Umožňuje jednak plnou kontrolu položek (Topics) a jejich hodnot, ale také umí tyto položky ručně vytvořit nebo do nich zapsat (což se pak přenese do klientů kteří mají Subscribe na danou položku). Zkrátka ideální pro vývoj a testování.<br />
<br />
<br />
== MQTT broker v Internetu ==<br />
<br />
Pro bezpečnost je ideální mít svůj vlastní MQTT broker ve své síti. Stačí koupit malý Linuxový počítač (např. rPI) a tam MQTT broker nainstalovat a je to.<br />
<br />
Pokud si provedete vhodné nastavení své sítě a firewallu, lze k tomuto brokeru přistupovat i z Internetu.<br />
<br />
Toto je často žádoucí, např. máte-li svou domácí automatizaci která běží na MQTT a chcete ji dálkově ovládat a kontrolovat, např. z mobilní aplikace.<br />
<br />
Druhá možnost je využít nějaký veřejný MQTT broker, je jich plný Internet - ale toto přináší řadu bezpečnostních rizik a nedoporučujeme to. Když už mít broker na Internetu, tak na svém vlastním serveru.<br />
<br />
Důležité je, že SDS (MQTT klient) používá připojení k MQTT brokeru jako plain TCP, tedy nepoužívá v této verzi SSL/TLS (to až v budoucnu SDS třetí produktové řady).<br />
<br />
Proto je důležité umístit MQTT broker do vnitřní sítě (stejná síť na které jsou SDS), která je oddělena od sítě Internet bezpečným a spravně nastaveným firewallem.<br />
<br />
Takový MQTT broker pak může snadno obsluhovat všechny SDS a další klienty přes plain TCP spoje, a do Internetu může mít dodatečně zabezpečený TLS MQTT spoj. Takhle to nastavit jde.<br />
<br />
<br />
== Implementace v SDS-C a FULL-C ==<br />
<br />
Názvy funkcí a postupy jsou pro oba programovací jazyky shodné.<br />
<br />
'''Rozdíl''' je v indexech:<br />
* SDS-C má informace a údaje v sys[2199] až sys[2321]<br />
* FULL-C má informace a údaje dostupné přes get funkci od indexu 12199 až 12321.<br />
<br />
Všimněte si, že význam indexů pro SDS-C (2199 až 2321) je 1:1 namapován na FULL-C indexy (12199 až 12321 - tedy FULL-C má pouze aplikováno pevné posunutí o 10000).<br />
<br />
[[FULL-C: MQTT_functions|Detaily pro implementaci ve FULL-C (a příklady) naleznete zde.]]<br />
<br />
<br />
== Vzorový program SDS-C - připojení a Publish ==<br />
<br />
Následující program je pro SDS První Produktové Řady, které se programují jazykem SDS-C.<br />
<br />
MQTT Broker je spuštěn (např. na rPI) na adrese 192.168.4.249 (a TCP portu 1883). Náš klient (SDS) se přihlásí jako uživatel "sds1234" s heslem "password", a následně provede 2x PUBLISH a nakonec se odpojí.<br />
<br />
<syntaxhighlight lang="c"><br />
<br />
// network communication shall be started only after the SDS is connected to network (ethernet is up)<br />
echo('waiting for network availability');<br />
<br />
waiting_ethernet:<br />
if (sys[24] == 0) goto waiting_ethernet; // 0 = no ethernet<br />
if (sys[27] == 0) goto waiting_ethernet; // 0 = no IP address<br />
<br />
// OK, now we have an ethernet connection up and running<br />
<br />
...<br />
<br />
// EXAMPLE START:<br />
<br />
<br />
// connect on start<br />
echo('connecting to MQTT Broker...');<br />
<br />
// ip ip ip ip port client-id username password keepalive(sec)<br />
mqtt_connect(192, 168, 4, 249, 1883, 'sds-client-1234', 'sds1234', 'password', 120);<br />
<br />
// wait for a complete connection<br />
label waiting_for_mqqt_conn:<br />
<br />
// error - failed ?<br />
if (sys[2200] <= 0) goto mqtt_conn_fail; // error ? (any negative number is error code)<br />
<br />
// done - connected ?<br />
if (sys[2200] != 4) goto waiting_for_mqqt_conn; // success ? (yes only if == 4)<br />
<br />
// test the CONNACK result - see "3.2.2.3 Connect Return code" - we expect "0" as OK<br />
<br />
if (sys[2201] != 0) goto mqtt_conn_fail; // is broker's result code OK ? (OK only if == 0)<br />
<br />
// connected (CONNACK result is 0x00)<br />
<br />
echo('connected to broker: OK');<br />
<br />
//<br />
<br />
<br />
// example: let us publish three various topics<br />
<br />
mqtt_publish('sds/teploty/cidlo1', sys[310]); <br />
w1: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w1; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
mqtt_publish('sds/teploty/cidlo2', sys[311]);<br />
w2: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w2; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
mqtt_publish('sds/teploty/text_xyz', 'hello:', 1234, 'there'); // <- you can pass more than one parameter (all params will get joined together)<br />
w3: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 1) goto w3; // still working ?<br />
if (sys[2202] != 2) // success ?<br />
{ echo('publish error = ', sys[2202]); };<br />
<br />
// ...<br />
<br />
// and let us subscribe to a topic<br />
<br />
mqtt_subscribe(1, 'ha/output/q1/state');<br />
w4:<br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected ?<br />
if (sys[2202] == 4) goto w4; // still working ? <br />
if (sys[2202] != 8) // success ?<br />
{ echo('sub error = ', sys[2202]); };<br />
<br />
//...<br />
<br />
<br />
// finally, once done - close the connection <br />
<br />
// go<br />
mqtt_disconnect();<br />
<br />
// we shall wait until the connection is properly closed<br />
wait_for_disconnect:<br />
if (sys[2200] <= 0) goto error; // error ?<br />
if (sys[2200] == 8) goto wait_for_disconnect; // success, or still working ?<br />
<br />
// done !<br />
echo('DISCONNECTED from broker');<br />
<br />
wait(250);<br />
<br />
// EXIT the example - we are DONE<br />
return;<br />
<br />
<br />
// error handling<br />
label mqtt_conn_fail:<br />
echo('unable to connect... error=', sys[2200],' connack=', sys[2201]);<br />
<br />
// error handling<br />
label error:<br />
echo('error');<br />
<br />
</syntaxhighlight><br />
<br />
<br />
Pozn. mqtt_connect() - parametry:<br />
* keepalive - hodnota 0 použije výchozí nastavení (120 sec), další platné hodnoty jsou 15 až 600 (sekund).<br />
* client-id - vždy by to měla být unikátní identifikace vašeho SDS, typicky přidělena správcem MQTT Broker<br />
<br />
<br />
== Vzorový program FULL-C - připojení a Publish ==<br />
<br />
Příklady pro FULL-C jsou na samostatné stránce: [[FULL-C: MQTT_functions]].<br />
<br />
Princip použití MQTT klient ve FULL-C je identický jako pro SDS-C, jen pozor na pevně posunuté indexy.<br />
<br />
<br />
== Odesílání hodnot do Brokeru ==<br />
<br />
Je-li SDS úspěšně připojeno, pak lze odeslat libovolnou hodnotu libovolné položky (Topic) z SDS do Brokeru, který si ji uschová a který ji také předá všem dalším připojeným zařízením, které jsou k dané položce (Topic) přihlášeny (subscribed).<br />
<br />
Názvy položek musí být centrálně koordinované, aby celá akce dávala smysl. To už je na vás.<br />
<br />
'''Omezení je na současnou velikost (společnou délku) názvu položky (Topic Name) a její hodnoty (Value), což se spolu musí vlézt do nejvíce cca 1465 znaků.'''<br />
<br />
<br />
POZOR - před, a po zavolání funkce mqtt_publish() je žádoucí testovat stav sys[2202] ( respektive pro FULL-C: get(12202) ), a dokud tam nebude očekávaný výsledek nebo chybový kód, tak nevolat další mqtt_xxx funkce !<br />
<br />
Vždy musíte ve svém programu správně reagovat na všechny chybové stavy ve sys[2202] (respektive get 12202), je to váš úkol, SDS to za vás řešit nebude (a tím vám svazovat ruce).<br />
<br />
Funkce mqtt_publish() umožňuje skládání parametrů - první parametr je vždy název položky (topic name), a všechny zbylé jsou převedeny na společnou hodnotu (value).<br />
<br />
<syntaxhighlight lang="c"><br />
// you can use multiple parameters for the VALUE<br />
// only the very first parameter represents a TOPIC NAME<br />
<br />
mqtt_publish('topicname', '1234', 'abcd', 'efgh', 'xyz');<br />
<br />
// result: 'topicname' gets a new VALUE of '1234abcdefghxyz'<br />
</syntaxhighlight><br />
<br />
<br />
== Příjem hodnot z Brokeru ==<br />
<br />
SDS se umí přihlásit na odběr hodnot pro různé položky. Pokud je SDS takto přihlášeno, tak jakákoliv změna hodnoty na straně Brokera (např. způsobena zápisem jiného zařízení, aplikace, atd.), se prakticky ihned přenese do SDS, kde si aktualizovanou hodnotu může váš program zpracovat dle potřeby.<br />
<br />
Přihlášení se provádí pomocí funkce mqtt_subscribe(). Aby se to povedlo, musíte být úspěšně připojeni k Brokeru.<br />
<br />
Přihlásit se lze k libovolné položce (Topicu), jejíž celý textový název musíte samozřejmě znát.<br />
<br />
Pozor - všechny názvy položek jsou citlivé na malé a velké písmena (nejsou záměnné).<br />
<br />
Pozor - platné indexy jsou 1 až N (protože index 0 je vyhrazený pro aktuálně interně zpracovávanou položku, nelze jej využít pro program).<br />
<br />
'''PŘÍKLAD V SDS-C:'''<br />
<syntaxhighlight lang="c"><br />
<br />
// SDS-C<br />
<br />
// expectation: broker has to be already connected (see the previous example)<br />
<br />
// let us:<br />
// subscribe to a topic named: "control/rele1", and let us assigned it a local index of 1<br />
<br />
mqtt_subscribe(1, 'control/rele1');<br />
<br />
// wait for the successful subscribe <br />
wS: <br />
if (sys[2200] < 0) goto mqtt_conn_fail; // disconnected (if any negative number)<br />
if (sys[2202] == 4) goto wS; // still working... (done when != 4)<br />
if (sys[2202] != 8) // success ? (only if == 8, otherwise error or failure)<br />
{ <br />
// FAILED -> not subscribed !<br />
echo('sub error = ', sys[2202]); <br />
return;<br />
};<br />
<br />
// now, as we are subscribed, we will watch for any incoming update (value change), as in the following example:<br />
<br />
var last1;<br />
last1 = 0;<br />
<br />
loop:<br />
<br />
// any change ? (any new message?)<br />
if (last1 != sys[2291]) // sys[2291] is a timestamp for index #1<br />
{<br />
// store so we can compare it later, again<br />
last1 = sys[2291];<br />
<br />
// use the new value!<br />
echo('TOPIC #1: "',sys[2211],'" update to: "',sys[2251],'" ');<br />
};<br />
<br />
if (sys[2200] < 0) goto error; // disconnected<br />
<br />
// continue loop<br />
goto loop;<br />
<br />
<br />
// ...<br />
<br />
<br />
// once we are not interesed in the topic any more, we can unsubscribe<br />
mqtt_unsubscribe_index(1);<br />
<br />
// handle the job<br />
if (sys[2200] < 0) goto error; // disconnected<br />
wU: <br />
if (sys[2202] < 0) goto error; // error (if any negative number)<br />
if (sys[2202] == 16) goto wU; // waiting until done (done when result == 32)<br />
<br />
echo('unsubscribed');<br />
<br />
</syntaxhighlight><br />
<br />
Příklad přehledně ukazuje, jak systém funguje. Pro jednoduchost je zde hrubá nekonečná smyčka (loop) ale každý jistě vidí i své, jiné řešení vhodnější pro svůj vlastní program.<br />
<br />
Základní princip je v používání SDS indexů #1 až #31, kterým přiřazujeme jednotlivé přihlášené položky (subscribed topics).<br />
<br />
Je na tvůrci programu, jak indexy využije a kterému indexu přiřadí jaký název položky (topic name). A konkrétní názvy položek vždy záleží na celém systémovém návrhu, kde SDS je zcela transparentní.<br />
<br />
Z principu MQTT protokolu, jsou hodnoty vždy uvedeny jako textový řetězec. Např. pomocí SDS-C funkce atoi to ale snadno převedete na číslo, se kterým lze dále pracovat, je-li to potřeba.<br />
<br />
Funkce umožňuje skládání parametrů - první parametr je vždy index, a všechny zbylé jsou převedeny na název položky (topic name).<br />
<br />
<br />
POZOR - před, a po zavolání funkce mqtt_subscribe() je žádoucí testovat stav sys[2202] (respektive get 12202), a dokud tam nebude očekávaný výsledek nebo chybový kód, tak nevolat další mqtt_xxx funkce !<br />
<br />
Vždy musíte ve svém SDS-C programu správně reagovat na všechny chybové stavy ve sys[2202] (respektive get 12202), je to váš úkol, SDS to za vás řešit nebude (a tím vám svazovat ruce).<br />
<br />
<br />
=== Udržování spojení ===<br />
<br />
PŘÍKLAD VE FULL-C:<br />
<syntaxhighlight lang="c"><br />
// MQTT: make sure the broker is connected, reconnect if needed (blocks up to ~20 s)<br />
// returns 1 = connected, 2 = freshly reconnected (subscribe again!), 0 = failed<br />
int mq_link(void)<br />
{<br />
int st;<br />
unsigned int t0;<br />
<br />
st = SDS_get_i32(12200);<br />
if (st == 4) return 1;<br />
<br />
// not connected or status damaged (e.g. -3 after a too-early call): clean up first<br />
if ((st != 0) && (st != -2))<br />
{<br />
mqtt_disconnect();<br />
t0 = SDS_get_u32(45);<br />
for (;;)<br />
{<br />
st = SDS_get_i32(12200);<br />
if ((st == 0) || (st == -2)) break;<br />
if ((SDS_get_u32(45) - t0) > 5000) break;<br />
wait(10);<br />
}<br />
wait(500);<br />
}<br />
<br />
mqtt_connect(192, 168, 3, 99, 1883, "my-sds", "user", "password", 60);<br />
t0 = SDS_get_u32(45);<br />
for (;;)<br />
{<br />
st = SDS_get_i32(12200);<br />
if (st == 4) break;<br />
if (st < 0) return 0;<br />
if ((SDS_get_u32(45) - t0) > 15000) return 0;<br />
wait(10);<br />
}<br />
if (SDS_get_i32(12201) != 0) { mqtt_disconnect(); return 0; }<br />
return 2;<br />
}<br />
</syntaxhighlight><br />
<br />
<br />
=== Známé chyby ve firmware ===<br />
<br />
V průběhu provozu řady SDS bylo mnoha uživateli testováno, jak se MQTT v SDS chová. Byly nalezeny různé záležitosti, které se průběžně v nových vydáních firmware řeši a opravují.<br />
<br />
Pokud však máte starší firmware, nebo ještě pokud nebyl vůbec opravený firmware vydán, musíte tato omezení znát a použít opravné postupy ve vlastním FULL-C programu.<br />
<br />
'''Délka odeslání MQTT dat do brokeru'''<br />
<br />
Původní firmware může mít až půl sekundy zpoždění mezi zavoláním funkce mqtt_publish() a skutečným odesláním příslušného paketu do sítě. To je řešeno v novém firmware, ale pokud jej nemáte, musíte svůj FC program psát tak, aby s tímto uměl správně pracovat. <br />
<br />
'''Špatné předání chybových stavů'''<br />
<br />
Je-li zavoláno mqtt_publish() nebo mqtt_subscribe() nebo mqtt_unsubscribe_*(), zapíše to -3 do indexu [12200] namísto správného indexu [12202].<br />
Takže [12200] zůstane s obsahem -3, i když tam ta hodnota nemá co dělat. Toto má pak důsledek v tom, že pokud váš program testuje [12200] na hodnotu 4 tak ji tam neuvidí a bude si nesprávně myslet, že došlo k odpojení SDS od brokeru.<br><br />
''Toto je opraveno v novém firmware (11/2026 a novější).''<br />
<br />
Správně to má být: <br><br />
* [12200] a [12201] = pouze pro mqtt_connect a mqtt_disconnect<br><br />
* [12202] = pouze pro mqtt_publish, mqtt_subscribe, mqtt_unsubscribe_* atd.<br><br />
<br />
Ve starším firmware byla chyba, kdy místo do [12202] se některé chybové stavy (záporné hodnoty např. -3, -5, -7 atd.) zapsaly nesprávně do [12200].<br />
<br />
<br />
'''Po odpojení přes mqtt_disconnect() občas dojde k předání chyby výpadku TCP spojení'''<br />
<br />
Toto je vlastnost, která se týká sítě, a nelze ji vždy vyloučit.<br />
<br />
Po zavolání mqtt_disconnect() může postupně dojít k zápisu hodnoty -2 do [12200] (ihned po zavolání je zapsáno 32 do [12200], a pak proběhne ukončení TCP spojení, které může ve svém postupu zapsat -2).<br />
<br />
Proto pozor při použití testu <pre>if (sys[2200] <= 0) goto error;</pre> , protože to může vyhodnotit v podstatě správné ukončení spojení jako chybu.<br />
<br />
<br />
<br />
=== Maximální velikosti (položky subscribe tabulky) ===<br />
<br />
'''Stav 06/2020'''<br />
<br />
Maximální délka názvu položky (Topic Name) pro přihlášené položky je 128 znaků.<br />
<br />
Maximální délka obsahu hodnoty (Value) pro přihlášené položky je 384 znaků.<br />
<br />
''Informace'': <br />
<br />
Chystáme úpravu aby byl aplikován jen celkový limit (512 znaků) a ne tyto dva samostatné limity. V současném FW ale zatím stále platí.<br />
<br />
Toto omezení se vztahuje jen na Subscribe Tabulku a neplatí pro PUBLISH (tam jsou omezení jiná viz text výše).<br />
<br />
<br />
=== Volba indexů ===<br />
<br />
Je čistě na vás zvolit si každý použitý index do tabulky (tzn. první parametr do funkce mqtt_subscribe).<br />
<br />
Pokud provedete přihlášení s jedním stejným indexem na více různých položek (topics), tak SDS daný požadavek do Brokeru odešle (pro každou žádost). Nicméně SDS si uschová ve své paměti jen tu nejposlednější pro každý index.<br />
<br />
Takže si dejte pozor, aby jste si pro každý index provedli přihlášení (subscribe) jen a právě jednou.<br />
<br />
Tabulka je vždy vyčištena při odpojení od Brokeru.<br />
<br />
Nechcete-li využívat této pomocné tabulky, nemusíte; ale ztrácíte výhodu uchování poslední zaslané hodnoty pro každou položku v této tabulce uschovanou.<br />
<br />
SDS samozřejmě dává programu k dispozici všechny příchozí zprávy z Brokeru, nicméně pokud jich přijde více za sebou v rychlém sledu, nemusíte je zdaleka stačit programem zpracovat. A právě proto je zde na pomoc tento systém s tabulkou, kam SDS zaručeně zařadí poslední přijaté hodnoty pro každou položku (Topic), která vás zajímá.<br />
<br />
<br />
=== Pozor ===<br />
<br />
Každé SDS má k dispozici jinak velkou tabulku pro Subscribe - tedy jsou SDS, které mají k dispozici méně indexů než plných 32. S tím musíte počítat, a můžete využívat jen tolik indexů (řádků v tabulce), kolik jich cílové SDS poskytuje.<br />
<br />
Přesnou hodnotu si může SDS-C program zjistit čtením sys[2209] (respektive get 12209).<br />
<br />
Pokud se stane, že by vám počet dostupných indexů nestačil, lze si snadno pomoct - lepším návrhem využití jednotlivých Topic. Můžete např. neplýtvat a použít jeden Topic na řízení více věcí (příklad: ovládání jednotlivých relé přes jednotlivé bity ve společném čísle, přenášeném v rámci jediného Topicu).<br />
<br />
Při každém PŘIPOJENÍ k MQTT Brokeru dojde ke smazání celé tabulky (celého obsahu). Tzn. pokaždé když zavoláte mqtt_connect() tak dojde k vyčistění obsahu tabulky - a také ke zrušení všech přihlášení.<br />
<br />
Při každém připojení tedy musíte vždy poslat všechny požadavky na přihlášení, které vás aktuálně zajímají, bez ohledu na to, k čemu jste byli přihlášeni v případném předchozím připojení.<br />
<br />
<br />
== Velikosti ==<br />
<br />
Co můžete v rámci svého programu využít:<br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| '''SDS'''<br />
| style="padding: 5px;background-color:#bbcdcd;"| MQTT klient <br />
| style="padding: 5px;background-color:#cdcdcd;"| FW verze <br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>ClientID<br />
| style="padding: 5px;background-color:#cdcdcd;"| max délka <br>username<br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>password<br />
| style="padding: 5px;background-color:#cdcdcd;"| max délka <br>Topic Name<br />
| style="padding: 5px;background-color:#bbcdcd;"| max délka <br>Value<br />
| style="padding: 5px;background-color:#cdcdcd;"| počet položek ve<br>Subscribe tabulce<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: První Produktová Řada<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS MICRO LM (LIGHT, E)'''<br />
| style="padding: 5px;"|není<br />
| style="padding: 5px;"|-<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
|-<br />
| style="padding: 5px;"|'''SDS IO6 LM'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|96<br />
| style="padding: 5px;"|192<br />
| style="padding: 5px;"|2<br />
|-<br />
| style="padding: 5px;"|'''SDS MACRO LM'''<br />
| style="padding: 5px;"|není<br />
| style="padding: 5px;"|-<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
| style="padding: 5px;"|0<br />
|-<br />
| style="padding: 5px;"|'''SDS UPS ONEDPS LM'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>jen EN verze<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|3<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: První Produktová Řada - verze ST<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS MICRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS MACRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|19.10.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|96<br />
| style="padding: 5px;"|256<br />
| style="padding: 5px;"|3<br />
|-<br />
| style="padding: 5px;"|'''SDS IO6 ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS TTCPRO ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS MINI ST'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (SDS-C)<br />
| style="padding: 5px;"|26.6.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
!colspan="9" style="text-align: center;"|<br>SDS: Druhá Produktová Řada<br><br><br />
|-<br />
| style="padding: 5px;"|'''SDS BIG 512'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|20<br />
|-<br />
| style="padding: 5px;"|'''SDS BIG 64/128'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS SMALL 64/128'''<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
| style="padding: 5px;"|'''SDS STSW''' (OEM)<br />
| style="padding: 5px; background-color:#55ee55;"|ano (FULL-C)<br />
| style="padding: 5px;"|9.8.2020<br>a novější<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|64<br />
| style="padding: 5px;"|128<br />
| style="padding: 5px;"|384<br />
| style="padding: 5px;"|7<br />
|-<br />
|}</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_BIG:_MBUS&diff=982SDS BIG: MBUS2026-10-26T19:37:31Z<p>Adamn: </p>
<hr />
<div>Sběrnice M-Bus (MBUS, MBus, MeterBus) je určena pro sběrnicové dvoudrátové připojení měřičů energií a veličin, např. elektroměrů, vodoměrů, měřičů tepla atd.<br />
<br />
Výhodou je že je pouze dvoudrátová a umožňuje obousměrný přenos dat; protokol je standardizován a prakticky všichni výrobci měřidel poskytují možnost použít MBUS.<br />
<br />
SDS může fungovat jako centrální řídící bod (master) pro všechny k němu připojené MBUS prvky.<br />
<br />
__NOTOC__<br />
1. MBUS sběrnici lze připojit v rámci [[SDS_BIG|SDS-BIG]] (nebo jiného SDS) a to osazením doplňující desky LCD-KEY-MBUS.<br />
<br />
2. Lze také alternativě využít samostatný [[SDS_MBGW|SDS-MBGW]], který integruje sběrnici MBUS spolu s SDS-STSW (a řadou dalších prvků) do jednoho výrobku.<br />
<br />
<br />
=== SDS-BIG (BIG2) ===<br />
<br />
Následující informace se týkají rozšiřující "sandwich" desce (modulu) pro SDS-BIG, která tedy umožní SDS-BIG komunikovat rozhraním MBUS.<br />
<br />
<br />
<div class="successbox">'''Jak tento modul koupit ?''' Na oficiálním eShopu '''www.onlinetechnology.cz'''</div><br />
<br />
Sandwich modul pro BIG / BIG2:<br />
[[Soubor:foto-BIG-sandwich-MBUS.jpg]]<br />
<br />
<br />
== Zapojení sandwich desky z hlediska uživatele ==<br />
<br />
Display a klávesnici na sandwich desce řídí kontrolér, který je na sandwich desce umístěn. Tento kontrolér má v sobě svůj program (firmware), který je připraven od výrobce a uživatel jej nemá důvod měnit (vše je dodáno hotové a funkční).<br />
<br />
Kontrolér interně komunikuje se základní deskou (SDS-BIG) přes vyhrazené sériové rozhraní (SDS-BIG má několik samostatných sériových rozhraní pro různé účely).<br />
<br />
Protokol, který je zde použit, je do detailu popsán a je určen pro uživatele, kteří si pomocí tohoto protokolu celou sandwich desku ovládají, ze svého FULL-C programu.<br />
<br />
Pokud není v SDS-BIG nahrán uživatelský FULL-C program, jeho úlohu zastoupí SDS-BIG sám, a do sandwich desky posílá své vlastní údaje (takže na LCD se zobrazují hodnoty ze všech měřených vstupů) - tím je v takovém připadě ale pouze ošetřeno zobrazení informací na displayi, nic víc.<br />
<br />
<br />
<u>Deska LCD-KEY-MBUS poskytuje tyto funkce:</u><br />
<br />
* Grafické LCD - výpis textu, grafika<br />
* Tlačítka - dvě samostatná tlačítka<br />
* MBUS master - viz popis dále<br />
<br />
<br />
== MBUS master - deska LCD-KEY-MBUS ==<br />
<br />
Sběrnice MBUS je průmyslový standard pro komunikaci mezi MASTER (zde SDS) a SLAVEs (měřiče energií, veličin, atd.). Prakticky je to univerzální sběrnice pro obousměrný přenos dat.<br />
<br />
Sběrnice má jednoho řídícího (master), což je SDS-BIG, a řadu podřízených (slave).<br />
<br />
Nejčastěji je sběrnice MBUS využita pro odečet měřičů energií.<br />
<br />
Délka kabelu sběrnice a počet podřízených na sběrnici je omezen především průřezem propojovacích vodičů v rámci rozvodu MBUS signálu, a také především jejich počtem (každý slave prvek má určitý odběr, a součet odběru všech připojených slave prvků nesmí přesáhnout maximální hodnotu napájecího zdroje - master).<br />
<br />
Potřebné jsou dva vodiče (pro MBUS signál), často se vede i třetí vodič navíc jako společné PE (uzemnění - z bezpečnostních a ochranných důvodů).<br />
<br />
MBUS master může na sběrnici vysílat příkazy, a přijímat odpovědi od jednotlivých připojených zařízení. <br />
<br />
<br />
== Napájení ==<br />
<br />
Napájení celého MBUS rozhraní musí být provedeno napětím 24V stejnosměrných - nelze použít jiné napětí !<br />
<br />
Napájení pro MBUS rozhraní SDS je zcela izolováno od zbytku SDS, a musí se tedy přivést na samostatné svorky.<br />
<br />
Celá část rozhraní MBUS je galvanicky izolována od SDS-BIG.<br />
<br />
<br />
== Ovládání ==<br />
<br />
MBUS je v rámci SDS reprezentován jako sériové rozhraní (RX+TX), ke kterému máte plný přístup jako k rozhraní COM6 (na SDS-BIG), pomocí vašeho FULL-C programu.<br />
<br />
Váš FULL-C program tak přimo posílá příkazy do slaves a zpracovává jejich odpovědi.<br />
<br />
Vzorový FULL-C program je k dispozici (napište si o něj).<br />
<br />
<br />
== Zatížitelnost ==<br />
<br />
Ve výchozím stavu lze např. společně na MBUS sběrnici připojit 1x PRO380-Mb a k tomu ještě 1x PRO1-Mb. V okamžiku, kdy se připojí více MBUS slave zařízení (stoupne klidová proudová zátěź sběrnice), trvale se rozsvítí LED "MBUS" na modulu. Tím poznáte přetížení.<br />
<br />
Jak rozšířit zatížitelnost: je potřeba snížit hodnotu R28, což je rezistor zapájený zespodu na desce, o výchozí hodnotě 100 ohmů. Paralelním připojením vhodného dalšího rezistoru se dosáhne zmenšeí celkového odporu v tomto místě, a tím zvýšení hranice, kde modul detekuje data na sběrnici (tzn. posun bodu indikace přetížení sběrnice). Přidávejte postupně rezistory cca 470 až 220 ohmů, podle toho, jakou zátěž očekáváte. Princip je v tom, že napětí na R28 musí být menší než cca 0.8V, ale v podstatě je to potřeba určit experimentálně na míru vaší konkrétní sběrnice a připojených zařízení. Lze dosáhnout úpravy, která umožňuje připojit i desítky MBUS slaves.<br />
<br />
<br />
== Dostupnost ==<br />
<br />
Sandwich desku LCD-KEY-MBUS získáte zakoupením specifické varianty zařízení SDS-BIG (dodáno je celé sestavené zařízení) v eshopu.<br />
<br />
Lze také zakoupit alternativní samostatné řešení, tedy SDS-MBGW, které může být pro některé instalace vhodnější (především z rozsahu a možnosti napájení).<br />
<br />
<br />
== MBUS slave (měřící) zařízení ==<br />
<br />
Nejčastěji je u nás používán MBUS elektroměr '''PRO-1Mb'''. <br />
<br />
Pozor na omezení maximálního počtu připojených zařízení na sběrnici MBus. Omezení je dáno schopností master (SDS) napájet jen určitý počet zařízení (cca 48 zařízení).<br />
<br />
Na MBUS sběrnici není nutné připojovat pouze vstupní (měřící) zařízení. Lze totiž připojit i výstupní prvky (např. reléové výstupy) - pro více informací kontaktujte výrobce. Takto lze elegantně vyřešit vzdálené vstupy (měření) i výstupy, přičemž vše je řízeno jedním SDS.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=S%C3%AD%C5%A5ov%C3%BD_Dohledov%C3%BD_Syst%C3%A9m&diff=981Síťový Dohledový Systém2025-12-23T17:54:44Z<p>Adamn: </p>
<hr />
<div><div class="warningbox">Výrobky SDS jsou navrženy a vyrobeny v EU, děkujeme za jejich nákup a využívání.<br>Pomáháte tak i správné věci, jakou je finanční a morální pomoc napadené Ukraině při její obraně.<br> Přispět můžete ještě více, přímo na [https://u24.gov.ua u24.gov.ua] nebo [https://www.zbraneproukrajinu.cz České nadaci].</div><br />
<br />
<div class="row"><br />
<br />
<div class="small-2 large-4 columns"><br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
Řada '''ST''': ''aktuální''<br />
<ul><br />
<li> [[SDS MICRO: ST]] / [[SDS MICRO: ST DP|ST-DP]]</li><br />
<li> [[SDS IO6: ST]]</li><br />
<li> [[SDS MACRO: ST]]</li><br />
<li> [[SDS TTCPRO: ST]] (+[[SDS TTCPRO: GSM|GSM]], +[[SDS TTCPRO: 8in2out|8in2out]])</li><br />
<li> [[SDS MINI: ST]] ([[SDS MINI: LoRa|+ LoRA]])</li></ul><br />
</ul><br />
<div><br></div><br />
Řada '''LM''':<br />
<ul><br />
<li> [[SDS MICRO: LM]] <br>varianty: LIGHT / E (DIN)</li><br />
<li> [[SDS IO6: LM]]</li><br />
<li> [[SDS MACRO: LM]]</li><br />
<li> [[SDS UPS: LM]] varianta: ONEDPS</li><br />
</ul><br />
<br />
<div><br></div><br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<ul><br />
<li> [[SDS BIG|SDS BIG / BIG2]] (DP, DS84) : 64 / 128 / 512</li><br />
<li> &nbsp;&nbsp; [[SDS BIG: DALI|+DALI]] [[SDS BIG: MBUS|+MBUS]] [[SDS BIG: LoRA|+LoRA]] [[SDS_BIG:_SW-RELE6|+RELE6]] [[SDS_BIG:_SW-RTC-COM-O6|+RTC/O6]] [[SDS_BIG:_SW-IN24S7AI2|+IN24S7AI2]]</li><br />
<li> [[SDS SMALL]] : 64 / 128 / 512</li><br />
<li> [[SDS STSW]] : 64 / 128 / 512</li><br />
<li> [[SDS MBGW|SDS ENERGO MBGW]] : 512</li><br />
</ul><br />
<div><br></div><br />
<br />
<div class="successbox">SDS Doplňkové Moduly</div><br />
<ul><br />
<div><li> [[SDS 1W T-RH]]</div><br />
<div><li> [[SDS ANALOG RH]]</div><br />
<div><li> [[SDS PWM10]]</div><br />
</ul><br />
<div><br></div><br />
<br />
</div><br />
<br />
<div class="small-4 large-4 columns"><br />
<br />
<div class="successbox">SDS-C</div><br />
<ul><br />
<li> [[SDS-C: intro|úvod]] a [[SDS-C: popis jazyka|popis jazyka]]</li><br />
<li> [[SDS-C: sdsc_sysp|systémové proměnné]]</li><br />
<li> [[SDS-C: sdsc_rsvdf|vyhrazené funkce]]</li><br />
<li> [[SDS-C: sdsc_sysf|systémové funkce]]</li><br />
<li> [[OSI7 status code|OSI stavové hodnoty]]</li><br />
<li> [[SDS-C: examples|příklady]]</li><br />
<li> [[SDS-C: DataFlash|paměť DataFlash]]</li><br />
<li> [[SDS-C: rychlost|rychlost]]</li><br />
<li> [[SDS-C: sharing|sdílené proměnné]]</li><br />
<li> [[SDS-C: program upload|způsoby nahrání SDS-C do SDS]]</li><br />
</ul><br />
<div><br></div><br />
<div class="successbox">FULL-C</div><br />
<ul><br />
<li> [[FULL-C: intro|úvod]] a [[FULL-C: popis jazyka|popis jazyka]]</li><br />
<li> [[FULL-C: tips and tricks|důležité postupy, triky, tipy]]</li><br />
<li> [[FULL-C: set and get|systémové proměnné]]</li><br />
<li> [[FULL-C: functions|systémové funkce]]</li><br />
<li> [[FULL-C: examples|příklady]]</li><br />
<li> [[FULL-C: sharing|sdílené proměnné]]</li><br />
<li> [[FULL-C: SD card|použití SD karty]]</li><br />
<li> [[FULL-C: 64 bit|64-bitové proměnné a programování]]</li><br />
<li> [[FULL-C: program upload|způsoby nahrání FC do SDS]]</li><br />
</ul><br />
<div><br></div><br />
<br />
<div class="successbox">Webové Rozhraní</div><br />
<ul><br />
<li> [[HTTPS, TLS]]</li><br />
<li> 1PŘ [[Webové Rozhraní: První Produktová Řada|web]], 2PŘ [[Webové Rozhraní: Druhá Produktová Řada|web]]</li><br />
<li> 1PŘ [[M2M: První Produktová Řada|M2M]], 2PŘ [[M2M: Druhá Produktová Řada|M2M]]</li><br />
<li> [[User Web Page]]</li><br />
<li> [[SDS Audit Log]]</li><br />
<li> [[Config Status]]</li><br />
</ul><br />
</div><br />
<br />
<div class="small-6 large-4 columns"><br />
<div class="successbox">Aktualizace</div><br />
<ul><br />
<li> [[Seznam Všech SDS]] - co si vybrat</li><br />
<li> '''[[Firmware|> > > Nový Firmware < < <]]'''</li><br />
<li> [[Konfigurace Zařízení SDS]]</li><br />
</ul><br />
<div><br></div><br />
<div class="successbox">Kontakty</div><br />
<ul><br />
<li> [http://forum.merenienergie.cz Live Podpora: Fórum] </li><br />
<li> [[Přímý kontakt na vývojáře SDS]] </li><br />
<li> [http://www.onlinetechnology.cz E-SHOP OnlineTechnology.cz] </li><br />
<li> [http://energycloud.merenienergie.cz Portál Měření Energií] </li><br />
<li> [https://vati.cz/zakazkove-programovani Zakázková tvorba programů pro SDS]</li><br />
</ul><br />
<div><br></div><br />
<div class="successbox">Technologie</div><br />
<ul><br />
<li> [[SDS v síti: tipy, příklady, nastavení]]</li><br />
<li> [[HW Vstupy]] a [[HW Výstupy]]</li><br />
<li> [[SDS: Měření energie]]</li><br />
<li> [[S0|Odečet rozhraní S0]], a [[S0 Algoritmus]]</li><br />
<li> [[MQTT]]</li><br />
<li> [[MODBUS-TCP]]</li><br />
<li> [[SNMP]] + [[SNMP: TRAP|TRAP]] , [[SNMP:_OIDs|seznam OID]]</li><br />
<li> [[SMTP]] (email)</li><br />
<li> SDS: 1PŘ [[M2M: UDP protocol|UDP]], 2PŘ [[M2M: S-UDP protocol|S-UDP]]</li><br />
<li> GET/POST:<br>1PŘ [[HTTP Klient: První Produktová Řada|HTTP klient]], 2PŘ [[FULL-C:_http_client_functions|HTTP klient]]</li><br />
<li> [[SD karta]]</li><br />
<li> [[LoRA]]</li><br />
<li> [[OneWire]]</li><br />
<li> [[DALI]]</li><br />
<li> [[I2C]], [[CAN]], [[RS485, RS422, RS232]], [[MODBUS-RTU]]</li><br />
<li> [[MBUS]]</li><br />
</ul><br />
</div><br />
<br />
</div><br />
<br />
</div><br />
<br />
<br><br><br />
=== Síťový Dohledový Systém - OnlineTechnology.cz ===<br />
<br />
Vítejte v aktualizované wiki pro výrobky SDS, vyvíjené a vyráběné v České Republice.<br />
<br />
Tento web poskytuje dokumentaci k jednotlivým výrobkům řady SDS (Síťový Dohledový Systém): návody, výkresy, odkazy na nový firmware, a řada dalších důležitých informací.<br />
<br />
PROČ KOUPIT PRÁVĚ NAŠE VÝROBKY SDS?<br />
* vynikající poměr cena / výkon<br />
* nejlepší poměr přepočítané ceny na jeden vstup/výstup, bez kompromisu v návrhu a realizaci výrobku<br />
* plná uživatelská programovatelnost, žádná omezení<br />
* trvalá osobní technická podpora, bez ohledu na datum prodeje nebo typ či počet zařízeni<br />
* trvalá podpora naprosto všech prodaných výrobků (stále vydáváme nový firmware, a to i pro ty nejstarší výrobky)<br />
* trvalá aktualizace hardware (vydáváme nové lepší moduly, a stále podporujeme i ty předchozí)<br />
* integrace i do systémů jako je Node-RED a další<br />
* živé diskusní fórum a návody na wiki<br />
<br />
PLC/PAC SDS<br />
* Programmable Logic Controller / Programmable Automation Controller - to je SDS<br />
* Programování v jazyce SDS-C nebo FULL-C bez omezení, možnost sledování a změna parametrů za běhu<br />
* Velké množství I/O a komunikačních rozhraní<br />
* SDS je bezpečné a stabilní - nezaloženo na Linuxu, naopak: SDS běží na profesionálně napsaném a testovaném firmware<br />
<br />
AN-D označuje skupinu odpovědnou za vývoj a design výrobku - prodej je v režii výrobce. <br />
Designed in Czech Republic, Europe. Made in Czech Republic, Europe.<br />
<br />
VAROVÁNÍ - POZOR NA KLONY NAŠEHO VÝROBKU (např. LK3) - klony nejsou oficiální, mají chyby a nemají od nás podporu ! nenechte se podvést !<br />
<br />
Chcete integrovat SDS do svého výrobku ? Nabízíme možnost OEM zástavby.<br />
<br />
=== Prodej ===<br />
<br />
SDS okamžitě zakoupíte na oficiálním eshopu: www.onlinetechnology.cz<br />
<br />
Pro přeprodej a velkobchod nabízíme (nejen množstevní) slevy. Pro OEM a partnery (integrátoři SDS do projektů) také nabízíme ceny dohodou.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=Firmware&diff=980Firmware2025-11-23T10:25:07Z<p>Adamn: </p>
<hr />
<div>== Nový Firmware ==<br />
<br />
Aktualizujte si své SDS - nahrejte do něj nový firmware, který získáte na této stránce - '''naskrolujte dolů''' kde naleznete odkaz na BIN soubor pro vaše zařízení.<br />
<br />
Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].<br />
<br />
Důležité první kroky, které je nutné provést s každým novým zakoupeným modulem: [[New_Device_First_Setup_Steps|První nutné kroky pro nově zakoupené zařízení SDS]].<br />
<br />
<br />
=== Odkazy ke stáhnutí ===<br />
<br><br />
Pro aktualizaci firmware ve vašem zařízení (nebo pro zápis SDS-C respektive FULL-C programu), potřebujete jednu z následujících aplikací (Win32 EXE program), vyberte ten správný podle typu zařízení.<br>Následně si pak stáhnete soubor se samotným novým firmware, který přes tuto aplikaci do připojeného zařízení pošlete. Úplný návod je na jiné stránce na této wiki.<br>Vybraná aplikace současně slouží pro vývoj a nahrání SDS-C respektive FULL-C programu (a webu, a dalších) do zařízení SDS.<br />
<div class="successbox">PC Software</div><br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')<br />
|-<br />
| style="padding: 15px;"| <li> stáhnout WinEXE pro SDS-C [https://sds.an-d.cz/firmware/SDSC_310123.exe zápis/simulace/upload SDS-C (SDS-C '''verze 09''') a UWEB, ze dne 31.1.2023]<br>SHA-256: daf1095f206404e33223f675f5d0bc09d4fc5dfd7d9f79f4f735af88f5ff1e6a<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> (FC verze '''0x12''' - '''aktuální'''): stáhnout WinEXE pro FULL-C [https://sds.an-d.cz/firmware/FULLC_220724.exe zápis/upload FULL-C a UWEB, ze dne 22.7.2024],<br> určeno pro Firmware od 9.3.2023 včetně, pro všechny varianty SDS (64kB a 128kB a 512kB)<br>SHA-256: b4cb95d8ec8a6e844a3a4c9a2e9fc50ece60ccf44e8043f8c10f46b2294cae0b<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program SDSLOAD.exe''' ("jednokrokový" upload .FC souborů a aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> ('''aktuální''' verze, pro FW od 10.7.2017 včetně a dále) stáhnout WinEXE [https://sds.an-d.cz/firmware/SDSLOAD_220724.exe program SDSLOAD ze dne 22.7.2024],<br> určeno pro všechny SDS varianty 64kB a 128kB a 512kB, (subvarianty DP a DS84)<br>SHA-256: ded5bf1aca2e04e22c33899a0976deccc8ff76eb88f53ecd9769788b7daa25a7<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''<br />
|-<br />
| style="padding: 15px;"| <li> Program '''[[SDS LOG: intro|SDS LOG]]''' - verze 0.1 ze dne 26.8.2011 - [https://sds.an-d.cz/firmware/SDS_LOG.exe stáhnout EXE program]<br />
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]<br />
<li> [[SDS LOG: changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
|}<br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_151125_CZ.bin SDS-MICRO-LM-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_151125_EN.bin SDS-MICRO-LM-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MICRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_151125_CZ.bin SDS-MICRO-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_151125_EN.bin SDS-MICRO-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_151125_CZ.bin SDS-MICRO-ST-DP-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_151125_EN.bin SDS-MICRO-ST-DP-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MINI_151125_CZ.bin SDS-MINI-ST-CZ ze dne 15.11.2025]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MINI_151125_EN.bin SDS-MINI-ST-EN released on 15-Nov-2025]<br />
<li><br />
[[SDS MINI: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].<br />
<li>Výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_151125_CZ.bin SDS-MACRO-LM-CZ ze dne 15.11.2025]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_151125_EN.bin SDS-MACRO-LM-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MACRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_151125_CZ.bin SDS-MACRO-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_151125_EN.bin SDS-MACRO-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MACRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_151125_CZ.bin SDS-TTCPRO-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_151125_EN.bin SDS-TTCPRO-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_151125_CZ.bin SDS-IO6-LM-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_151125_EN.bin SDS-IO6-LM-EN released on 15-Nov-2025]<br />
<li><br />
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_151125_CZ.bin SDS-IO6-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_151125_EN.bin SDS-IO6-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.<br />
<li><br />
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.<br />
<li> <br />
<li>[[SDS FTP: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).<br />
<li><br />
<li>Stáhnout firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_CZ.bin (Česká lokalizace) SDS-UPS-ONEDPS-LM ze dne 1.7.2022]<br />
<li>Download firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_EN.bin (English language version) SDS-UPS-ONEDPS-LM released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.<br />
<li><br />
<li>Firmware je zaslán na požádání (pošlete email), aktuální verze je z 1.3.2011 (dále aktualizováno na specifické požádání, raději proto přejděte na nový HW).<br />
<li><br />
<li>Každá deska má svou kalibraci, proto každá deska má svůj vlastní FW, proto musíte uvést S/N svého výrobku.<br />
<li><br />
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW<br />
|-<br />
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]<br />
<li><br />
<li>Firmware je jednotný pro všechny varianty '''SDS Druhé Produktové Řady''', nutné je rozlišení dle varianty 64kB/128kB/512kB. Rozlišení podle dalších subvariant (DP, DS84) se neprovádí.<br />
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.<br />
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.<br />
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu. <br />
<li><br />
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_251025_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_251025_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 512kB) [[firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 12.4.2022|informace pokud máte SDS512 s FW <b>starším</b> než 12.4.2022]]<br />
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_251025_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.<br />
|-<br />
| style="padding: 15px;"| POZOR<br />
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<br><br />
Aktualizaci lze provést jen fyzicky u výrobce, ten ji provede bezplatně (zašlete výrobci vaše SDS pro jeho aktualizaci). Se starým FW nebude tento HW plně fungovat.<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
=== Informace ===<br />
<br />
VŽDY MĚJTE VE SVÉM ZAŘÍZENÍ NEJNOVĚJŠÍ FIRMWARE, A POUŽÍVEJTE TAKÉ NEJNOVĚJŠÍ SDS-C EXE / FULL-C EXE PROGRAM.<br />
V opačném případě vám budou chybět nové funkce, které neustále přidáváme, a také nebudete mít opravené nalezené chyby.<br />
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.<br />
<br />
<br />
=== Historický Software ===<br />
<br />
Za účelem aktualizace takových SDS, kde už dlouho nebyl aktualizován firmware, je potřeba použít odpovídající EXE program pro aktualizaci takovéhoto zařízení.<br />
<br />
<br />
==== První Produktová Řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_151119.exe ze dne '''15.11.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 08, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020118.exe ze dne '''2.1.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 07, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020317.exe ze dne '''2.3.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 8.8.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_060216.exe ze dne '''6.2.2016''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které nemají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 24.1.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_231111.exe ze dne '''23.11.2011''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 04<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_170211.exe ze dne '''17.2.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''února 2011''')<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro ''SDS-C verze č. 03'' (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_140511.exe ze dne '''14.5.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''konce května 2011''')<br />
<br />
<br />
==== Druhá Produktová řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_070323.exe ze dne '''7.3.2023''']<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_311222.exe ze dne '''31.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 11, (firmware od 9.1.2023 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_071222.exe ze dne '''7.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 10, (firmware od 18.11.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_161022.exe ze dne '''16.10.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0F, (firmware od 16.10.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_110722.exe ze dne '''11.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0E, (firmware od 11.7.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010722.exe ze dne '''1.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0D, (firmware od 6.8.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030422.exe ze dne '''3.4.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0C, (firmware od 23.3.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010322.exe ze dne '''1.3.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0B, (firmware od 6.8.2020 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030119.exe ze dne '''3.1.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0A, (firmware od 3.1.2019 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010718.exe ze dne '''1.7.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 09, (firmware od 27.6.2018 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_100717.exe ze dne '''10.7.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 08, (firmware od 10.7.2017 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_080617.exe ze dne '''8.6.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 06, (firmware starší než Červenec-2017, a pouze pro variantu SDS 64kB)<br />
<br />
* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_120417.exe ze dne 12.4.2017],<br> určeno pouze pro SDS variantu 64kB která používá ''starý'' firmware (2017 nebo starší)<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_100717.exe ze dne 10.7.2017],<br> určeno pouze pro SDS variantu 64kB a 128kB (nepodporuje variantu 512kB tak jako aktuální stáhnutelná verze aplikace)<br />
<br />
<br />
== Beta Testing ==<br />
<br />
Než vydáme novou verzi, je potřeba změny a novinky otestovat.<br />
<br />
Pokud jste ochotní se testu zúčastnit, pak se podívejte [https://forum.sds.an-d.cz/viewtopic.php?id=129 na tento odkaz]. Zde jsou uveřejněny vždy nejnovější beta verze firmware.<br />
<br />
Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_MACRO:_ST:_firmware_changelog&diff=979SDS MACRO: ST: firmware changelog2025-11-15T14:25:10Z<p>Adamn: </p>
<hr />
<div>== SDS-MACRO ST ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-MACRO ST.<br />
<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
<br />
== 15.11.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* SDS-C: přidány indexy 303 a 304 a 305<br />
* SDS-C: přidán index 2198<br />
<br />
== 2.11.2023 ==<br />
* oprava SNMP (způsob předávání chybových hodnot)<br />
* opraveno: LOGIC-S0 lze použít pro výběr Tarifu<br />
<br />
== 29.11.2022 ==<br />
* SDS-C: přidán index 137<br />
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve<br />
* oprava možného problému na sériové lince, kdy mohlo dojít k náhodnému malému zpoždění odeslání dat<br />
<br />
== 26.11.2022 ==<br />
* SDS-C: oprava možného teoretického problému u funkce serialX_write při odesílání z pole ram[] (ostatní zdroje dat/pole problém neměly)<br />
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)<br />
<br />
== 4.8.2022 ==<br />
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla<br />
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti<br />
* zlepšení funkce OneWire - širší prohledávání sběrnice (velká saturace neznámými čidly nevyčerpá počet kroků při hledání)<br />
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce<br />
* malá bezpečnostní aktualizace<br />
<br />
== 1.7.2022 ==<br />
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)<br />
* opravena chyba při výpisu teplot na webu (jinde to bylo OK), kdy v rozmezí -0.99 degC až 0.00 degC chyběl znak mínus<br />
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných<br />
* další drobné úpravy a opravy<br />
<br />
== 27.12.2021 ==<br />
* opraveno: nastavení názvu relé 2 až 6 se teď správně ukládá (funguje)<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
<br />
== 3.5.2021 ==<br />
* oprava nastavování frekvence PWM1 přes webové rozhraní<br />
<br />
== 14.4.2021 ==<br />
* oprava hodnot v sys 39 (0 vyp, 3 zap)<br />
<br />
== 13.4.2021 ==<br />
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP<br />
<br />
== 11.4.2021 ==<br />
* možnost uživatelsky vypnout NTP klient a nastavovat čas přes SDS-C (sys 38 nebo sys 4), vhodné pro jiné zdroje času (LoRA, GSM, sběrnice, atd.).<br />
<br />
== 26.3.2021 ==<br />
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)<br />
<br />
== 12.3.2021 ==<br />
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno<br />
<br />
== 9.2.2021 ==<br />
* SDS-C: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* SDS-C: drobná úspora heap (více dostupného místa)<br />
* SDS-C: dns resolv drobný fix<br />
* SDS-C: http_get a http_post důležitý fix<br />
* SDS-C: nová funkce http_close<br />
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)<br />
<br />
== 10.1.2021 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "SDS-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off) <br />
<br />
== 5.1.2021 ==<br />
* SDS-C: oprava textcmp()<br />
* bezpečnostní oprava<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení <br />
<br />
== 20.11.2020 ==<br />
* changelog založen</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_MACRO:_LM:_firmware_changelog&diff=978SDS MACRO: LM: firmware changelog2025-11-15T14:24:59Z<p>Adamn: </p>
<hr />
<div>== SDS-MACRO LM ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-MACRO LM.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
<br />
<br />
== 15.11.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* SDS-C: přidány indexy 303 a 304 a 305<br />
* SDS-C: přidán index 2198<br />
<br />
== 1.7.2022 ==<br />
* opravena chyba při výpisu teplot na webu (jinde to bylo OK), kdy v rozmezí -0.99 degC až 0.00 degC chyběl znak mínus<br />
* obsluha času: možnost zápisu do sys[4], sys[39]<br />
* doplněny další možné vstupní typy do funkcí itoa/itoh<br />
* možnost zakázat NTP<br />
<br />
== 26.3.2021 ==<br />
* zásadní změna: <b>zrušen systém virtuálních S0 vstupů a zaveden systém mapování 1:1 (optovstupy na S0 vstupy)</b><br />
* zaveden inovovaný algoritmus detekce S0 impulsů (stejný jako pro řadu ST), tedy s možností bohaté uživatelské konfigurace detektoru<br />
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)<br />
<br />
== 9.2.2021 ==<br />
* SDS-C: dns resolv drobný fix<br />
* SDS-C: http_get a http_post drobný fix<br />
* SDS-C: nová funkce http_close<br />
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT<br />
<br />
== 5.1.2021 ==<br />
* SDS-C: oprava textcmp()<br />
* bezpečnostní oprava<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení <br />
<br />
== 23.10.2020 ==<br />
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST<br />
<br />
== 4.8.2020 ==<br />
* SNMP fix - správná hodnota ve .5.13 až .5.16<br />
* drobné opravy a optimalizace<br />
<br />
== 18.7.2020 ==<br />
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu<br />
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)<br />
<br />
== 26.6.2020 ==<br />
* různé drobky/opravy dle hlášení uživatelů a testů<br />
<br />
== 15.5.2020 ==<br />
* SDS-C 09: přidáno http_post()<br />
<br />
== 14.5.2020 ==<br />
* oprava pro některé sys[] pro S0 vstupy (které se automaticky neaktualizovaly)<br />
<br />
== 11.5.2020 ==<br />
* oprava Content-Length pro CSS soubor (problém s Chrome)<br />
* oprava chování při odpojeném SDS-1W-T-RH<br />
<br />
== 20.4.2020 ==<br />
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)<br />
* implementován SDS Audit Log<br />
* zvýšená ochrana proti brute-force hledání vstupního hesla<br />
<br />
== 14.11.2019 ==<br />
* oprava chyby v zobrazování výkonu u S0 vstupů (mohlo se stát při více logických vstupech, které měli navíc jiné logické pořadí vůči fyzickému vstupu)<br />
* relé lze z webového rozhraní aktivovat i v režimu OneShot <br />
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas)<br />
<br />
== 5.3.2019 ==<br />
* oprava chyby v konfiguraci S0 vstupů (webová administrace), dále jsou tam také doplněny lepší popisy aktuálního obsazení optovstupů (mapování na tarif a virtuální S0)<br />
<br />
== 12.1.2019 ==<br />
* optimalizace webového serveru (množství přenášenyćh dat sníženo až o polovinu, bez změny funkce) - ocení se to zejména při přenosu po úzkých linkách (např. gprs, modemy) <br />
<br />
== 4.1.2019 ==<br />
* překlopena beta do oficiálního vydání<br />
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)<br />
* watchdog sds-c programu<br />
<br />
== 1.7.2018 ==<br />
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS <br />
* M2M: hodnota okamžitého výkonu pro S0 vstupy je vždy číslo+jednotka, zatímco text 'čekám...' je už jen pouze na s0.htm <br />
<br />
== 27.3.2018 ==<br />
* oprava funkce zápisu prázdného řetězce do názvu 1-Wire teploměru ("smazání názvu" uživatelem)<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím)<br />
* oprava někdy vynechaného načtení konfigurace (okrajové případy, ale přece)<br />
<br />
== 12.3.2018 ==<br />
* oprava měření na S0 vstupech (některé vstupy se starším FW nemusely být, v určitých okrajových situacích, plně funkční)<br />
<br />
== 8.3.2018 ==<br />
* oprava používání zámku (lock) v administraci 1-Wire sběrnice BUS-B<br />
* oprava echo.htm - zobrazuje se<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 18.12.2017 ==<br />
* možnost automického přepínání "letní/zimní" čas (CEST/CET time) byla při "změně času" ověřena a je funkční jak má být<br />
* SDS-C: přidán sys[4], sys[11], sys[38], sys[39]<br />
* SDS-C: sys[4] = local-time<br />
* SDS-C: sys[11] = vždy "správné" číslo dne v týdnu<br />
* SDS-C: sys[38] = utc-time<br />
* SDS-C: sys[39] = stav automatiky přepínání CEST/CET času <br />
* správný zápis pouze do T0 pro všechny S0 vstupy, které nemají aktivované tarifní rozdělení (bez ohledu na stav tarifního vstupu)<br />
* zámek 1-W pozice se ukládá do pevné paměti (při stisku tlačítka na webovém rozhraní)<br />
* vylepšení v oblasti VCP (telnet pro sériovou linku) - spolehlivější<br />
* zpřesněny prvky ochrany S0 stránek heslem (SDS lépe volí kdy a jak blokovat přístup na jednotlivé eX a S0 stránky)<br />
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)<br />
<br />
== 10.8.2017 ==<br />
* SDS-C: zvýšena verze na hodnotu 07<br />
* SDS-C: přidány nové sys[] položky (indexy 1792 až 2047)<br />
* SDS-C: optimalizovaná cache pro velké programy<br />
* SDS-C: maximální počet proměnných zvýšen na 144<br />
* SDS-C: maximální počet procesů (procedur) zvýšen na 96<br />
* SDS-C: hloubka zásobníku (stacku) zvýšena na 24<br />
* vydán nový odpovídající SDSC.exe<br />
<br />
== 3.8.2017 ==<br />
* oprava chyby kdy se po každém spuštění systému mohla ztratit část S0 konfigurace (nastavení tarifního vstupu)<br />
<br />
== 18.4.2017 ==<br />
* (nová funkčnost) použití UserWEB Projektu<br />
* oprava v echo() pro zápis do sériové linky (uart)<br />
* drobné ale důležité fixy v html stránkách (texty, vzhled)<br />
* nové NTP dotazy lze aktivovat i z SDS-C programu (viz aktualizovaný seznam sys)<br />
<br />
== 24.11.2016 ==<br />
* opraven chybně zpracovaný vstup při zadávání nastavení parametrů S0 vstupu (hodnota "minimální délka impulsu" byla špatně zpracována a uložena)<br />
* SDS-C: přidán přímý přístup do LCD Frame Bufferu přes sys[1024] až sys[1551]<br />
<br />
== 28.3.2016 ==<br />
* impulse counter lze z webu zadat do plných 32 bitů, původně jen 31 bitů<br />
* další drobné opravy<br />
* oprava zpracování nastavení baudrate při komunikaci RFC2217<br />
<br />
== 23.2.2016 ==<br />
* oprava nefunkčního zápisu pomocí SNMP (několik předchozích verzí, teď opraveno)<br />
<br />
== 5.2.2016 ==<br />
* oprava funkce RSTD - rozšíření funkce RSTD: krátký zkrat (approx 1 sec) po zapnutí spustí BL (zařízení čeká na nový firmware), zatímco dlouhý zkrat (déle než 3 sec) spustí aplikaci a současně vymaže nastavení (set to Factory Defaults)<br />
* možnost vyhledávat všechny zařízení SDS na subnetu pomocí rozšířené funkce (Find a SDS) v EXE aplikaci (např. když ztratíte IP adresu do webového rozhraní a potřebujete se na SDS připojit)<br />
<br />
== 15.11.2015 ==<br />
* důležité opravy<br />
<br />
== 3.7.2015 ==<br />
* vylepšený DHCP client<br />
* řada oprav podle průběžného testování<br />
<br />
== 2.4.2015 ==<br />
* srovnáno s SDS-MICRO 2.4.2015 (opravy chyb a nové funkce)<br />
<br />
== 9.9.2014 ==<br />
* opravena chyba pro sys[64]==1 (vnitřním zaokrouhlením to skočilo na nulu)<br />
<br />
== 17.8.2014 ==<br />
* srovnáno se stejnou verzí firmware SDS-MICRO<br />
<br />
== 8.7.2014 ==<br />
* opravy v oblasti obsluhy sériového rozhraní (RS485)<br />
* do webové administrace přidána možnost vzájemného přehození pozic dvou 1-Wire záznamů<br />
* další drobné opravy z průběžných beta testů<br />
<br />
== 1.3.2014 ==<br />
* SDS-C: nová funkce serial_write()<br />
* SDS-C: nový timeout pro smtp_send() - zamezí specifickému možnému zaseknutí programu, když SMTP server přestane odpovída uprostřed transkace po více než 50sec<br />
* SDS-C: lcd_setpixel() má nové možné parametry, které umožní změnu jen RAM bufferu bez překlopení do LCD (významné zrychlení, při kreslení více pixelů stačí překlopit buffer do LCD jen jednou nakonec)<br />
* SDS-C: opravena funkce snmp_send_trap() - horní část seznamu trapů byla předtím chybně neodeslatená (teď už je vše OK)<br />
* vylepšení odolnosti při výpadku a při obnovení připojení k Ethernetu<br />
* různé drobné důležité opravy (viz beta testy)<br />
<br />
== 25.1.2014 ==<br />
* opravy a nové funkce, srovnáno s firmware SDS MICRO<br />
<br />
== 30.11.2013 ==<br />
* opravy a nové funkce, srovnáno s firmware SDS MICRO<br />
<br />
== 3.10.2013 ==<br />
* celá řada drobných oprav<br />
* login html stránka upravena (w3c valid)<br />
* možnost nastavit MTD pro S0 měření<br />
* nový SDSC.exe program<br />
* SDS-C: přidána funkce lcd_setpixel()<br />
<br />
== 24.3.2013 ==<br />
* opravena chyba kdy nebylo možné ručně zadat více než hodnotu 32767 do impulsního počítadla z webového rozhraní<br />
<br />
== 16.3.2013 ==<br />
Všechny změny ze všech vydaných BETA firmware verzí, od června do března, tj. především následující položky:<br />
* zápis výpadku a znovu-připojení Ethernetu do logu historie<br />
* při odpojení a následném znovu-připojení Ethernetu dojde od teď záměrně ke smazání celé ARP tabulky, takže všechny MAC-IP páry jsou vyžádány znovu (pro případ že se např. vyměnil router atd.)<br />
* SDS-C: get_txt[xxx] (vypíše pole text od indexu xxx až do znaku 0x00 na některém z následujících indexů v tomto poli)<br />
* get_sys[xxx] vrací i text pro textové položky (vyzkoušejte všechny sys[] které jsou textové)<br />
* SDS-C: přidáno sys[900] až sys[931] (text ROM CODE pro 1-W čidla)<br />
* upraveno zpracování ARP tabulky (více bezpečné pro dlouhodobý provoz)<br />
* možnost řízení tarifního signálu pro S0 prostřednictvím SDS-C programu<br />
* funkce "odečet" pro S0 (viz nastavení S0 vstupů ve webové administraci)<br />
* SDS-C: funkce smtp_send() akceptuje text[] nejen pro obsah zprávy, ale i pro adresu příjemce a subject<br />
* SDS-C: funkce http_get() akceptuje text[] nejen pro obsah zprávy, ale i pro nastavení HTTP HOST parametru<br />
<br />
== 29.5.2012 ==<br />
* funkce http_get() nuluje svou interní položku "host" před zapsáním nové hodnoty do této položky, takže pokud se funkce volá opakovaně s kratším textem, je použit právě jen ten kratší text<br />
<br />
== 7.5.2012 ==<br />
* opravena funkčnost PWM výstupu - lze správné nastavit střídu v rozmezí 0 až 100% viz návod na WiKi<br />
<br />
== 18.3.2012 ==<br />
* finální podoba SNMP MIB (stáhněte si aktualizovaný MIB soubor)<br />
<br />
== 12.3.2012 ==<br />
* řada důležitých oprav, aktualizujte !<br />
* všechny nové funkce dostupné v SDS MICRO jsou dostupné i pro SDS MACRO (srovnání firmware)<br />
<br />
== 22.1.2012 ==<br />
* všechny nové funkce z BETA testu přidány do dostupného firmware (pozn. podpora pro čtyři S0 vstupy)<br />
<br />
== 27.10.2011 ==<br />
* do webového rozhraní přidáno tlačítko: možnost nastavení střídy PWM "na zkoušku" (bez uložení do pevné paměti)<br />
* web: funkce /get_sys a /get_ram může vrátit řadu proměnných za sebou<br />
<br />
== 2.10.2011 ==<br />
* přidán sys[26]<br />
* přidán sys[63]<br />
* přidán sys[78]<br />
* doplněn UDP protokol o čtyři nové funkce (čtení / zápis polí sys[] a ram[])<br />
<br />
== 6.9.2011 ==<br />
* pouze úpravy pro RS485 výstup - přepracovaný kód pro výstup dat (serial_text_out nepřevádí konstanty na text)<br />
<br />
== 31.7.2011 ==<br />
* opraven problém s UDP protokolem - příkaz '''write''' (už funguje vždy ok)<br />
* nový SDSC.exe program - doplňuje správnou HTML serverovou hlavičku pro uživatelskou stránku<br />
<br />
== 29.7.2011 ==<br />
* možnost zápis z SDS-C programu do systémových proměnných sys[559] až sys[561]<br />
* nová funkce pro UDP protokol - funkce '''write''' umožňuje hromadný zápis do sys[] systémových proměnných<br />
<br />
== 25.7.2011 ==<br />
* IP watchdog už umí ovládat i zbylé dvě relé (původně jen RE1 a RE2, teď RE1 až RE4)<br />
<br />
== 24.7.2011 ==<br />
* opravena chyba v telnet připojení, kdy se při pokusu odeslat znak na sériovou linku zařízení resetovalo, teď už je to ok<br />
<br />
== 10.7.2011 ==<br />
* možnost změnit číslo TCP portu webového serveru webového rozhraní výrobku (změna stejným způsobem jako je změna IP nebo MAC adresy...) <br />
* přidán IP Watchdog do hlavní nabídky ve webovém rozhraní<br />
<br />
* doplněny funkce, které jsou v SDS MICRO (viz changelog MICRO ze dne 16.6.2011)<br />
** řada doplňků v SDS-C, webovém rozhraní, atd.<br />
<br />
== 21.5.2011 ==<br />
* od této verze jsou k dispozici dvě jazykové varianty - plně Česká varianta a plně Anglická varianta<br />
* varianty se liší pouze texty ve webovém rozhraní, jejich funkčnost je ale zcela shodná (bez rozdílů)<br />
<br />
== 14.5.2011 ==<br />
* vydána pouze nová EXE aplikace pro nahrávání SDS-C<br />
* od této verze umožňuje použít složité kostrukce s IF, např.: if (test) { kus programu; } else { kus programu; };<br />
<br />
== 1.5.2011 ==<br />
* stránka /usys.xml<br />
<br />
== 17.3.2011 ==<br />
* možnost nahrát si vlastní webovou stránku (pomocí stejného EXE jakým se nahrává SDS-C)<br />
* možnost změnit port HTTP klienta (funkce http_get)<br />
<br />
== 6.3.2011 ==<br />
* přechod na novou verzi SDS-C (verze 03)<br />
<br />
== 17.2.2011 ==<br />
* SDS-C doplněno o funkce: lcd_echo, lcd_clear, lcd_newline (použijte nový EXE pro SDS-C)<br />
<br />
== 6.2.2011 ==<br />
* přemístěn výpis teplot z teplotních čidel na konec status stránky<br />
* dalši úvodní drobnosti...<br />
<br />
== 11.1.2011 ==<br />
* založena tato stránka<br />
<br />
== starší verze ==<br />
* changelog pro verze starší než 2011 není k dispozici</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_MICRO:_LM:_firmware_changelog&diff=977SDS MICRO: LM: firmware changelog2025-11-15T14:24:49Z<p>Adamn: </p>
<hr />
<div>== SDS-MICRO LM / SDS-IO6 LM ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS MICRO LM (všechny jeho varianty) a SDS IO6 LM.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
== 15.11.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* SDS-C: přidány indexy 303 a 304 a 305<br />
* SDS-C: přidán index 2198<br />
<br />
== 1.7.2022 ==<br />
* opravena chyba při výpisu teplot na webu (jinde to bylo OK), kdy v rozmezí -0.99 degC až 0.00 degC chyběl znak mínus<br />
* obsluha času: možnost zápisu do sys[4], sys[39]<br />
* IO6: doplněny další možné vstupní typy do funkcí itoa/itoh (MICRO už to mělo)<br />
* IO6: možnost zakázat NTP (MICRO už to mělo)<br />
<br />
== 28.6.2021 ==<br />
* IO6: web: oprava oneshotreset<br />
* IO6: web: přepnutí relé (CBY) na SDS-C ponechá stav relé (zap/vyp) (předtím to natvrdo dalo vyp, což nebylo správně)<br />
<br />
== 26.3.2021 ==<br />
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)<br />
<br />
== 9.2.2021 ==<br />
* SDS-C: dns resolv drobný fix<br />
* SDS-C: http_get a http_post drobný fix<br />
* SDS-C: nová funkce http_close<br />
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT<br />
<br />
== 5.1.2021 ==<br />
* SDS-C: oprava textcmp()<br />
* bezpečnostní oprava<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení <br />
<br />
== 23.10.2020 ==<br />
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST<br />
<br />
== 4.8.2020 ==<br />
* SNMP fix - správná hodnota ve .5.13 až .5.16<br />
* drobné opravy a optimalizace<br />
<br />
== 18.7.2020 ==<br />
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu<br />
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)<br />
<br />
== 27.6.2020 (jen MICRO) ==<br />
* oprava nestartování předchozí verze FW na některých specifických typech HW varianty SDS-MICRO-x<br />
<br />
== 26.6.2020 ==<br />
* SDS-C 09: http_post()<br />
* MQTT klient<br />
* různé drobky/opravy dle hlášení uživatelů a testů<br />
<br />
== 11.5.2020 ==<br />
* oprava Content-Length pro CSS soubor (problém s Chrome)<br />
* oprava chování při odpojeném SDS-1W-T-RH<br />
<br />
== 20.4.2020 ==<br />
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)<br />
<br />
== 15.4.2020 ==<br />
* implementován SDS Audit Log<br />
* zvýšená ochrana proti brute-force hledání vstupního hesla<br />
<br />
== 14.11.2019 ==<br />
* drobný bugfix pro S0 (způsob zobrazování aktuálního výkonu)<br />
* relé lze z webového rozhraní aktivovat i v režimu OneShot<br />
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas) <br />
<br />
== 17.1.2019 ==<br />
* bugfix SDS-C watchdogu<br />
<br />
== 12.1.2019 ==<br />
* optimalizace webového serveru (množství přenášenyćh dat sníženo až o polovinu, bez změny funkce) - ocení se to zejména při přenosu po úzkých linkách (např. gprs, modemy) <br />
<br />
== 4.1.2019 ==<br />
* překlopena beta do oficiálního vydání<br />
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)<br />
* watchdog sds-c programu<br />
<br />
== 1.7.2018 ==<br />
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS<br />
<br />
== 30.3.2018 ==<br />
* oprava funkce zápisu prázdného řetězce do názvu 1-Wire teploměru ("smazání názvu" uživatelem) <br />
* M2M: hodnota okamžitého výkonu pro S0 vstupy je vždy číslo+jednotka, zatímco text 'čekám...' je už jen pouze na s0.htm<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím)<br />
* drobná oprava při změně nastavení S0, teď se to ihned provede (v okrajových případech bylo někdy potřeba pro načtení změn SDS restartovat, teď už ne).<br />
<br />
== 12.3.2018 ==<br />
* oprava měření na S0 vstupech (některé vstupy se starším FW nemusely být, v určitých okrajových situacích, plně funkční)<br />
<br />
== 8.3.2018 ==<br />
* oprava echo.htm - zobrazuje se<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 18.12.2017 ==<br />
* možnost automického přepínání "letní/zimní" čas (CEST/CET time) byla při "změně času" ověřena a je funkční jak má být<br />
* správný zápis pouze do T0 pro všechny S0 vstupy, které nemají aktivované tarifní rozdělení (bez ohledu na stav tarifního vstupu)<br />
* zámek 1-W pozice se ukládá do pevné paměti (při stisku tlačítka na webovém rozhraní)<br />
* vylepšení v oblasti VCP (telnet pro sériovou linku) - spolehlivější<br />
* zpřesněny prvky ochrany S0 stránek heslem (SDS lépe volí kdy a jak blokovat přístup na jednotlivé eX a S0 stránky)<br />
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)<br />
<br />
== 23.10.2017 ==<br />
* hlavní nová funkce: přidána volitelná funkce (checkbox ve webovém rozhraní) pro plně automatickou volbu Letního Času (SELČ - aplikovatelné napříč Evropou)<br />
* další podstatná úprava: doplnění dalších testů na timeout při OSI7 funkcích (např. http_get) - tzn. test na více místech, který má zabránít zablokování funkce (1029) když selže spojení na server (vyhlásí novou chybu 1030 a odblokuje se).<br />
* přidány SNMP položky (OID) pro text "ADC jednotka" (pro každý AD vstup).<br />
* drobné bugfixy a zvýšení spolehlivosti, podle průběžných hlášení uživatelů (např. mírně zvětšeny RX a TX vyrovnávací paměti pro COM1 sériový port, atd.).<br />
* SDS-C: přidán sys[4], sys[11], sys[38], sys[39]<br />
* SDS-C: sys[4] = local-time<br />
* SDS-C: sys[11] = vždy "správné" číslo dne v týdnu<br />
* SDS-C: sys[38] = utc-time<br />
* SDS-C: sys[39] = stav automatiky přepínání CEST/CET času<br />
<br />
== 10.8.2017 ==<br />
* SDS-C: zvýšena verze na hodnotu 07 (funguje i pro výrobky s EEPROM tak pro výrobky s NVM-DF)<br />
* SDS-C: přidány nové sys[] položky (indexy 1792 až 2047)<br />
* SDS-C: optimalizovaná cache pro velké programy<br />
* SDS-C: maximální počet proměnných zvýšen na 144<br />
* SDS-C: maximální počet procesů (procedur) zvýšen na 96<br />
* SDS-C: hloubka zásobníku (stacku) zvýšena na 24<br />
* vydán nový odpovídající SDSC.exe<br />
<br />
== 3.8.2017 ==<br />
* oprava chyby kdy se po každém spuštění systému mohla ztratit část S0 konfigurace (nastavení tarifního vstupu)<br />
<br />
== 18.4.2017 ==<br />
* (nová funkčnost) použití UserWEB Projektu<br />
* oprava v echo() pro zápis do sériové linky (uart)<br />
* drobné ale důležité fixy v html stránkách (texty, vzhled)<br />
* nové NTP dotazy lze aktivovat i z SDS-C programu (viz aktualizovaný seznam sys)<br />
<br />
== 24.11.2016 ==<br />
* opraven chybně zpracovaný vstup při zadávání nastavení parametrů S0 vstupu (hodnota "minimální délka impulsu" byla špatně zpracována a uložena)<br />
<br />
== 28.3.2016 ==<br />
* impulse counter lze z webu zadat do plných 32 bitů, původně jen 31 bitů<br />
* další drobné opravy<br />
<br />
== 26.3.2016 ==<br />
* oprava chybného zpracování RFC2217 příkazu pro změnu BaudRate (zpracoval se jen poslední byte místo celého dwordu, teď opraveno)<br />
<br />
== 23.2.2016 ==<br />
* oprava nefunkčního zápisu pomocí SNMP (několik předchozích verzí, teď opraveno)<br />
<br />
== 5.2.2016 ==<br />
* oprava funkce RSTD - rozšíření funkce RSTD: krátký zkrat (approx 1 sec) po zapnutí spustí BL (zařízení čeká na nový firmware), zatímco dlouhý zkrat (déle než 3 sec) spustí aplikaci a současně vymaže nastavení (set to Factory Defaults)<br />
* možnost vyhledávat všechny zařízení SDS na subnetu pomocí rozšířené funkce (Find a SDS) v EXE aplikaci (např. když ztratíte IP adresu do webového rozhraní a potřebujete se na SDS připojit)<br />
<br />
== 15.11.2015 ==<br />
* důležité opravy<br />
<br />
== 3.7.2015 ==<br />
* vylepšený DHCP client<br />
* řada oprav podle průběžného testování<br />
<br />
== 2.4.2015 ==<br />
* veškeré opravy od posledního vydání (viz průběh BETA testů)<br />
* významně zvýšena spolehlivost a stabilita při síťové zátěži (Eth. komunikace)<br />
* SDS-C: přidáno sys[193]<br />
* SDS-C: přidáno sys[37]<br />
* SDS-C: přidáno sys[139]<br />
* SDS-C: možnost zápisu do sys[4]<br />
* SNMP TRAP předává plný OID (dosud dával jen OID useknutný za E.ID)<br />
<br />
== 9.9.2014 ==<br />
* opravena chyba pro sys[64]==1 (vnitřním zaokrouhlením to skočilo na nulu)<br />
<br />
== 17.8.2014 ==<br />
* přidána možnost použít get_var[index] pro čtení vnitřních proměnných v SDS-C přes web<br />
* SNMP: umožňuje zápis do všech položek přes "Counter32" (nová záležitost) a původní "Integer" typ<br />
* SNMP: přidána možnost zápisu do položek S0-impulse-counter (T0 a T1)<br />
* RS485: při vysílání je budič aktivní max 1msec (nebo méně) od posledního znaku<br />
<br />
== 8.7.2014 ==<br />
* opravy v oblasti obsluhy sériového rozhraní (RS485)<br />
* do webové administrace přidána možnost vzájemného přehození pozic dvou 1-Wire záznamů<br />
* další drobné opravy z průběžných beta testů<br />
<br />
== 8.3.2014 ==<br />
* SDS-C: opraveno chyba omezující možný rozsah sys[78] (bylo omezeno na 0xFF, už není - teď správně vezme max velikost pole ram[] nebo text[])<br />
<br />
== 1.3.2014 ==<br />
* SDS-C: nová funkce serial_write()<br />
* SDS-C: nový timeout pro smtp_send() - zamezí specifickému možnému zaseknutí programu, když SMTP server přestane odpovídat uprostřed transkace po více než 50sec<br />
* SDS-C: opravena funkce snmp_send_trap() - horní část seznamu trapů byla předtím chybně neodeslatená (teď už je vše OK)<br />
* vylepšení odolnosti při výpadku a při obnovení připojení k Ethernetu<br />
* různé drobné důležité opravy (viz beta testy)<br />
<br />
== 23.1.2014 ==<br />
* překlopená beta-verze (po ukončené ověřovací sérii testů)<br />
* SDS-C: úpravy (spolehlivost) v http_get(), dns_resolve()<br />
* rozšířena 1-W funkcionality (další chipy)<br />
* možnost "zrušit odečet" tlačítkem ve webovém rozhraní<br />
* možnost nastavit minimální akceptovanou délku S0 impulsu pro každý vstup samostatně<br />
* maximální velikost user.htm je zvětšena (teď lze vyplnit celou DF)<br />
<br />
== 30.11.2013 ==<br />
* celá řada drobných oprav (nalezené v rámci testování od poslední verze)<br />
* S0.htm: všechny hodnoty zobrazují údaje od posledního odpočtu (chybělo pro T0/T1 kWh)<br />
* web: /get_dfi[x]<br />
* SDS-C: čtení a zápis celé stránky z/do paměti DataFlash<br />
<br />
== 3.10.2013 ==<br />
* celá řada drobných oprav<br />
* login html stránka upravena (w3c valid)<br />
* možnost nastavit MTD pro S0 měření<br />
* nový SDSC.exe program<br />
<br />
== 16.3.2013 ==<br />
* zápis výpadku a znovu-připojení Ethernetu do logu historie<br />
* při odpojení a následném znovu-připojení Ethernetu dojde od teď záměrně ke smazání celé ARP tabulky, takže všechny MAC-IP páry jsou vyžádány znovu (pro případ že se např. vyměnil router atd.)<br />
* SDS-C: get_txt[xxx] (vypíše pole text od indexu xxx až do znaku 0x00 na některém z následujících indexů v tomto poli)<br />
* get_sys[xxx] vrací i text pro textové položky (vyzkoušejte všechny sys[] které jsou textové)<br />
* SDS-C: přidáno sys[900] až sys[931] (text ROM CODE pro 1-W čidla)<br />
* upraveno zpracování ARP tabulky (více bezpečné pro dlouhodobý provoz)<br />
* možnost řízení tarifního signálu pro S0 prostřednictvím SDS-C programu<br />
* funkce "odečet" pro S0 (viz nastavení S0 vstupů ve webové administraci)<br />
* SDS-C: funkce smtp_send() akceptuje text[] nejen pro obsah zprávy, ale i pro adresu příjemce a subject<br />
* SDS-C: funkce http_get() akceptuje text[] nejen pro obsah zprávy, ale i pro nastavení HTTP HOST parametru<br />
<br />
== 4.2.2013 ==<br />
* při zobrazení echo.htm, když je konzole plná textu, nedojde k resetu zařízení<br />
* opraveno časování pro 1-Wire sběrnici (vráceno na původní stav před úpravou v 20.12), uptime počítá také správně<br />
* SDS-C: přidáno sys[45]<br />
* SDS-C: přidáno sys[46]<br />
* SDS-C: přidáno sys[98]<br />
* SDS-C: echoinline() funguje správně<br />
<br />
== 20.12.2012 ==<br />
Významné vydání, oprava řady drobných chyb průběžně hlášených od uživatelů, celá řada nových funkcí<br />
* DHCP CLIENT<br />
* SNMP write<br />
* rychlejší boot loader<br />
* rychlejší webová administrace<br />
* přesnější udržování aktuálního času v zařízení (dvojnásobná kontrola přesnosti a korekce)<br />
* přepracované úložiště v pevné paměti - SDS s eeprom ukládá všech 16 názvů pro teploměry<br />
* možnost změny portu "UDP protokolu" (výchozí port 280)<br />
* SDS-C: konzole zvětšena o zhruba 400 znaků<br />
* délky textů pro (názvy) S0 jsou 32 bajtů, což je až 32 znaků (české znaky v UTF-8 berou 2 bajty), nicméně vše se v defaultu už vleze<br />
* pro každý S0 vstup lze nastavit rozdílnou cenu pro T0 a T1 (stav tarifu)<br />
* SDS-C: funkce send_udp()<br />
* SDS-C: přidáno sys[61]<br />
* SDS-C: přidáno sys[27]<br />
* SDS-C: funkce echoinline()<br />
* správné zpracování LOGIC S0 u zařízení SDS MICRO, které tento vstup nemají<br />
* upraven CSV soubor (vypisuje detaily pro S0)<br />
* upraven xml.xml a s0.xml (vše funguje jak má i při plném osazení, typicky pro SDS MACRO 8)<br />
* SDS-C: sprintf dává 0x00 na konec textu (tohle chybělo)<br />
* SDS-C: http_get() zapisuje 0x00 na "konec" text[], když se do text[] ukládá přijatá odpověď.<br />
* SDS-C: oprava která má zajistit nevyvolání chyby 1029 pro http_get() funkci <br />
* rozšířený MIB (položky pro S0 hodnoty)<br />
* SDS-C: SNMP TRAP (odesílání TRAPů z SDS-C programu)<br />
* a řada drobných obrav a vylepšení<br />
<br />
== 7.5.2012 ==<br />
* opravena funkčnost PWM výstupu - lze správné nastavit střídu v rozmezí 0 až 100% viz návod na WiKi<br />
<br />
== 29.3.2012 ==<br />
* firmware funguje správně i v historických zařízeních SDS MICRO LIGHT (1) používajících 24C16/24C256<br />
<br />
== 27.3.2012 ==<br />
* spolehlivé načítání prvních osmi uložených pozic teploměrů z pevné paměti po resetu<br />
* automaticky umístí nadbývající připojené teploměr na pozice 9 až 16<br />
* zamykání pozic teploměrů funguje správně<br />
* předělaná SDS-C funkce smtp_send() - má větší pracovní buffer, zvládne náročnější SMTP servery<br />
<br />
== 18.3.2012 ==<br />
* finální podoba SNMP MIB (stáhněte si aktualizovaný MIB soubor)<br />
<br />
== 11.3.2012 ==<br />
* malá změna v SNMP MIB (srovnání MIBů mezi MICRO/MACRO)<br />
* další drobné opravy nahlášené po testování firmware z 8.3.<br />
<br />
== 8.3.2012 ==<br />
* odstraněno zpoždění v převodníku Ethernet-Serial (Virtual COM port)<br />
<br />
== 4.3.2012 ==<br />
Řada oprav a vylepšení, pocházející z BETA testování (viz forum)<br />
* správný výpočet data od 29.2.2012<br />
* možnost uzamknout pozice 1-Wire zařízení (teploměry)<br />
* rozšířené SNMP<br />
* SDS-C verze č. 06<br />
* pole text[] a funkce atoi(), sprintf()<br />
* uživatelská stránka může být i jako přímo indexová stránka webového rozhraní<br />
* všechny fyzické vstupy a výstupy jsou počítány od jedničky<br />
* další drobné úpravy a opravy, viz soupis u BETA testů<br />
<br />
== 17.1.2012 ==<br />
* oprava indexů v "temp" tagech v xml.xml a temp.xml<br />
<br />
== 16.1.2012 ==<br />
* opravy v přenosu hodnot teplot jednotlivými protokoly (v případě teploty menší než 0 stupňů Celsia byl špatně umístěn znak minus)<br />
<br />
== 15.1.2011 ==<br />
* opravena chyba s user-dataflash (oprava má význam pouze pro výrobky osazené DF, nikoliv EE, tam chyba nebyla)<br />
<br />
== 21.12.2011 ==<br />
* zapracovány všechny nové funkce, testované v rámci BETA testování nového firmware (probíhalo od 27.10.)<br />
<br />
== 27.10.2011 ==<br />
* do webového rozhraní přidáno tlačítko: možnost nastavení střídy PWM "na zkoušku" (bez uložení do pevné paměti)<br />
* web: funkce /get_sys a /get_ram může vrátit řadu proměnných za sebou<br />
<br />
== 2.10.2011 ==<br />
* přidán sys[26]<br />
* přidán sys[63]<br />
* přidán sys[78]<br />
* doplněn UDP protokol o čtyři nové funkce (čtení / zápis polí sys[] a ram[])<br />
<br />
== 31.7.2011 ==<br />
* opraven problém s UDP protokolem - příkaz '''write''' (už funguje vždy ok)<br />
* nový SDSC.exe program - doplňuje správnou HTML serverovou hlavičku pro uživatelskou stránku<br />
<br />
== 29.7.2011 ==<br />
* možnost zápis z SDS-C programu do systémových proměnných sys[559] až sys[561]<br />
* nová funkce pro UDP protokol - funkce '''write''' umožňuje hromadný zápis do sys[] systémových proměnných<br />
<br />
== 25.6.2011 ==<br />
* možnost změnit číslo TCP portu webového serveru webového rozhraní výrobku (změna stejným způsobem jako je změna IP nebo MAC adresy...)<br />
<br />
== 16.6.2011 ==<br />
* verze SDS-C č. 04<br />
* SDS-C: plně funkční funkce ping()<br />
* rozšíření maximální velikosti SDS-C programu ve všech verzích SDS MICRO (light, light2, DIN)<br />
** DATAFLASH maximální velikost programu je 65472 bajtů<br />
** 24C16 maximální velikost programu je 900 bajtů<br />
** 24C256 maximální velikost programu je 31416 bajtů<br />
<br />
* web: nastavení uživatelské proměnné pomocí volání sdscep pracuje s doplňkovými parametry (např. vrací hodnotu)<br />
* upravena obsluha eeprom paměti (jiný I2C driver) - tzn. větší spolehlivost a větší rychlost<br />
* sys[25] po každém zavolání čte hodnotu z PHY HW a vrací skutečný stav v daný okamžik<br />
* čtení ze sériové linky je teď dostupné pro program v SDS-C (viz sys[48] a sys[49])<br />
* změna řízení PWM výstupu, lze teď plynule regulovat poměr log0 a log1 v celém rozsahu<br />
* všechny stránky předělány na UTF-8, vstupy textů berou i České znaky atd.<br />
* výpis MAC adresy pro SDS-C program (viz sys[31] až sys[36])<br />
* SDS-C: http_get může uložit získaná data webové stranky do pole ram[]<br />
* zcela změněn ARP algoritmus, měl by teď bez problémů pracovat i na větších podsítích než je /24<br />
* web: informační stránka /arp.htm<br />
* SDS-C: zvětšena velikost pole ram[] na 512 záznamů<br />
* web: výpis hodnot sys[] a ram[] pomocí dynamicky generované webové stránky (např. /get_ram[123] )<br />
* web: čtení výpisu sys[] a ram[] lze zakázat v nastavení (SDS-C parametr)<br />
* SDS-C: možnost zápisu do S0 impulsních počítadel (nulování, úpravy hodnot, atd.)<br />
* pokud je konkrétní relé ve webovém rozhraní nastaveno na něco jiného, než na "ovládáno z SDS-C", tak jeho stav SDS-C program nezmění<br />
<br />
== 21.5.2011 ==<br />
* opravy v českém a anglickém překladu webového rozhraní<br />
<br />
== 14.5.2011 ==<br />
* vydána pouze nová EXE aplikace pro nahrávání SDS-C<br />
* od této verze umožňuje použít složité kostrukce s IF, např.: if (test) { kus programu; } else { kus programu; };<br />
<br />
== 13.5.2011 ==<br />
* od této verze jsou k dispozici dvě jazykové varianty - plně Česká varianta a plně Anglická varianta<br />
* varianty se liší pouze texty ve webovém rozhraní, jejich funkčnost je ale zcela shodná (bez rozdílů)<br />
<br />
== 20.3.2011 ==<br />
* funkční nahrávání uživatelské webové stránky<br />
<br />
== 3.3.2011 ==<br />
* pouze nový simulační WinEXE program pro SDS-C<br />
** funkční simulátor LCD (SDS MACRO)<br />
** vylepšení v hlášení chyb při kontrole programu SDS-C<br />
<br />
== 27.2.2011 ==<br />
* změněn výpis UpTime v Actual Status webové stránce na dny/hod/min/sec/msec<br />
* doplněna generovaná webová stránka: echo.htm (obsahuje pouze výpis konzole SDS-C, vhodné pro embedding do jiného webu)<br />
* nový XML soubor - usys.xml - výpis vzdálených proměnných SDS-C<br />
* možnost volby nezasílání http dat pro volání sdscep (umožnujě tzv. tichou aktualizaci hodnoty sys)<br />
* do SNMP doplněna hodnota teploty SoC (vyčtená z HW, bez převodu na °C)<br />
* příprava pro nahrání uživatelské webové stránky (plná podpora bude v následující verzi fw)<br />
* nová verze SDS-C, nové možnosti, nový simulátor<br />
** SDS-C: možnost použít #define v programu<br />
** SDS-C: možnost použít uživatelské proměnné jako indexy do pole (sys, ram)<br />
** SDS-C: k dispozici je univerzální pole ram[]<br />
** SDS-C: nová WinEXE aplikace, řada drobností...<br />
<br />
== 30.1.2011 ==<br />
* úpravy specifické pro verzi LIGHT s EEPROM (restart zařízení)<br />
<br />
== 29.1.2011 ==<br />
* v SNMP doplněn výpis celé hodnoty (x100) pro 1-W teploměry 2 až 16<br />
<br />
== 28.1.2011 ==<br />
* dvě nové funkce v SDS-C, pro zápis do sériového portu <br />
* zpřesněný interní čítač reálného času<br />
<br />
== 26.1.2011 ==<br />
* změněna minimální akceptovaná délka S0 impulsu, bylo původně 16 msec jako minimum, od této verze je to 5 msec (z důvodů připojení speciálních nepřímých elektroměrů).<br />
* doplňky v simulátoru SDS-C, zejména ohledně času, korekce optovstupů, atd.<br />
<br />
== 9.1.2011 ==<br />
* nová položka v SNMP - pro každé teplotní čidlo je poskytována plná hodnota násobena 100 (např. 12.35°C je předáno jako 1235)<br />
* pouze SDS MICRO LIGHT: v SDS-C doplněny čtyři sys[], umožňující přímé ovládání vývodů A1, B1, M4, M5 (CMOS 3V3 logika, pájecí plošky)<br />
<br />
== 7.12.2010 ==<br />
* upraven způsob výpočtu a prezentace okamžitého výkonu (S0), zejména v případě přerušení dodávky S0 impulsů<br />
<br />
== 1.12.2010 ==<br />
* firmware podporuje i jiné osazené dataflash (menší velikosti) paměti<br />
<br />
== 29.11.2010 ==<br />
* oprava v chování SDS-C, kdy pokud byl program právě ve funkci wait(), tzn. čekal, a v tu chvíli byl nahrán nový program, tak nebylo čekání zrušeno, a nový program byl spuštěn až po dokončení čekání<br />
* úpravy odkazů na www.merenienergie.cz, portal.merenienergie.cz<br />
<br />
== 20.10.2010 ==<br />
* upraven UDP protokol - doplněno ROMCODE pro teplotní čidla<br />
* upraveno zadávání uživatelských sys[] proměnných z webu (už lze zadávat i záporné čísla)<br />
* opravena ztráta nastavení GMT offset po resetu zařízení<br />
<br />
== 8.10.2010 ==<br />
* opraven SNMP který měl od verze 10.9. problémy<br />
* tento a novější firmware je vhodný pro spolupráci se službou portal.merenienergie.cz<br />
<br />
== 6.10.2010 ==<br />
* oprava výpisu přepočtené spotřeby (kW) - doplněno vždy na tři desetinná místa<br />
* funkční nulování převodu peněz<br />
* SMTP konfigurace se správně načte po zapnutí zařízení<br />
<br />
== 26.9.2010 ==<br />
* SDS-C: stránka "control", uživatelsky editovatelné proměnné<br />
* SDS-C: do sys[] doplněna informace pro S0 (čas od posledního impulsu)<br />
* drobné doplňky do XML, příprava pro SDSMON.exe<br />
* UDP protokol, popis viz wiki<br />
<br />
== 17.9.2010 ==<br />
* oprava v SDS-C: funkce http_get a smtp_send, od teď umožnují vkládat proměnné až na pozici do maximální délky zprávy (1024 znaků)<br />
* výstup /temp.txt je doplněn na dvojici: romcode : teplota<br />
* výstup /temp.xml je doplněn o tagy s romcode<br />
<br />
== 15.9.2010 ==<br />
* doplněn výstup teplot ze všech čidel, do textové formy, /temp.txt<br />
* odečet teplotních web-snippet tempX.htm akceptuje hex znaky (tj. 0-9, a-f)<br />
<br />
== 14.9.2010 ==<br />
* opraven výpis teploty v csv.csv<br />
* nový xml soubor: temp.xml - pouze s údaji o teplotě<br />
<br />
== 10.9.2010 ==<br />
* opraveno zobrazení kWh na webových stránkách (špatný číselný text u vyšších hodnot kWh)<br />
<br />
== 8.9.2010 ==<br />
* ve firmware byl zvýšen maximální počet obsluhovaných teplotních sensorů z 8 na 16<br />
<br />
== 14.8.2010 ==<br />
* opraveno SDS-C - správnost předávání konstantních číselných parametrů funkcím<br />
* doplněna nová funkce do SDS-C - funkce http_get<br />
* nový Win32 program pro práci s SDS-C (doplněna funkčnost vzdálených labelů)<br />
* zobrazení názvů tarifů na celkové stránce pro S0 (předtím bylo jen na detailních stránkách)<br />
<br />
== 9.8.2010 ==<br />
* firmware funguje i pro HW rev2,3 (SDS MICRO light), předchozí verze 3.8. nenašla externí flash paměť<br />
<br />
== 3.8.2010 ==<br />
* opravena chyba kdy nedošlo k přečtení konfigurace pro S0 vstupy z pevné paměti, už je to ok<br />
* upraven výpočet okamžitého výkonu, aby při nepřipojeném měřiči ukazoval nulu<br />
<br />
== 2.8.2010 ==<br />
* zcela přepracováno webové rozhraní pro měřiče energie<br />
* rozšířené snmp/xml/csv pro měřiče energie<br />
* možnost připojít více samostatnyćh měřičů energie najednou<br />
* vstup pro tarifní rozlišení (denní/noční proud, výroba/dodávka, atd.)<br />
* vylepšený Windows&reg; program pro nahrávání firmware<br />
<br />
== 26.7.2010 ==<br />
<br />
* nový firmware pro převodník Ethernet/Serial<br />
* samostatná stránka ve webovém rozhraní pro zobrazení stavu převodníku Ethernet/Serial<br />
<br />
== 23.7.2010 ==<br />
<br />
* úprava chování pinu RSTD - pokud se zkratuje a zapne se zařízení, je kromě původní funkce (reset konfigurace) spuštěn i bootloader, tzn. bootloader lze odteď pouštět jak z webového rozhraní (původní stav), tak odteď i přes RSTD - toto má výhodu, pokud se nepovede nahrát celý nový firmware, tak lze znovu spustit bootloader a opakovat nahrávání znovu<br />
* drobná oprava v SMTP klientu<br />
* byl vydán nový Windows&reg; program pro nahrávání programů v SDS-C<br />
<br />
== 18.7.2010 ==<br />
<br />
* maximální počet znaků v přihlašovacích údajích pro SMTP je rozšířen na 32 znaků<br />
* drobné opravy ve webovém rozhraní<br />
<br />
== 15.7.2010 ==<br />
<br />
* ošetřena funkčnost SMTP při použití přihlašovacích údajů pro SNMP o maximálním počtu znaků (navíc v budoucnu to bude prodlouženo)<br />
<br />
== 10.7.2010 ==<br />
<br />
* opravy drobností tak jak byly nahlášeny od uživatelů<br />
* tři desetinné místa na ose grafu spotřeby energie<br />
* oprava hodnoty dne u data v grafu spotřeby energie<br />
* doplňky v http serveru, úprava hlavičky pro CSV<br />
* přihlašovací stránka se už zobrazí všude a vždy (předtím někdy neprošlo např. nod32)<br />
* příprava pro centrální sběrný program SDSMON.exe<br />
<br />
== 2.6.2010 ==<br />
<br />
* oficiální verze SDS-C k dispozici<br />
* celá řada nových funkcí, především pro SDS-C<br />
* SMTP - odesílání emailů (z programu SDS-C)<br />
* výstup dat i ve formě CSV souboru (středníkový oddělovač pro Excel&reg;)<br />
<br />
== 17.5.2010 ==<br />
<br />
* opraven výpis LOGu pro IP adresy<br />
* záznam nepovedených přístupů (když to někdo zkouší se špatným heslem)<br />
* drobnosti v http serveru<br />
* graf S0 má místo +1kWh jen +0.1kWh<br />
* oprava detekce EEPROM (aktualizujte FW !)<br />
<br />
== 15.5.2010 ==<br />
<br />
* změna výchozího NTP serveru (default config)<br />
* kratší odpočet při změně NTP serveru<br />
* stránka S0 i z hlavního menu<br />
<br />
== 12.5.2010 ==<br />
<br />
* drobné úpravy<br />
* informace o datové paměti (bude důležité pro SDS-C)<br />
* volba NTP serveru<br />
<br />
== 4.5.2010 ==<br />
<br />
* řada doplňků pro S0 vstup (přepočty, kreslení grafu, xml)<br />
<br />
== 23.4.2010 ==<br />
<br />
* počítáni S0 impulsů (opto 3), speciální webové zobrazení a přepočty<br />
* doplňky v SNMP, doplněný MIB<br />
* nepřipojené teploměry hlásí teplotu 32767<br />
* příprava stránky pro řízení relé pomocí teploměrů<br />
<br />
== 25.1.2010 ==<br />
<br />
* možnost pojmenovat si všechny analogové vstupy<br />
* doplněno: název analogového vstupu lze přečíst přes SNMP<br />
* doplněno: název relátka lze přečíst přes SNMP<br />
<br />
== 15.1.2010 ==<br />
<br />
* opraveno chybějící tlačítko u přihlašovací stránky (šlo pouze stiskem klávesy Enter)<br />
* doplněno chybějící čtvrté nastavovací tlačítko u ADC konstant<br />
<br />
== 11.1.2010 ==<br />
<br />
* opraveno (doplňeno) chybějící záporné znaménko u výpisu teploty (web, SNMP)<br />
<br />
== 31.10.2009 ==<br />
<br />
* navýšení maximálního počtu současně přihlášených uživatelů do webového rozhraní<br />
<br />
== 30.10.2009 ==<br />
<br />
* zvýšení max počtu 1-Wire&reg; teploměrů na 8 kusů na jedné sběrnici<br />
* doplněn výstup SNMP o údaje desetinných hodnot pro všechny teploměry<br />
* doplněno uživatelské nastavení přepočítavacích hodnot pro A/D převod, použité pro zobrazení ve webovém rozhraní a pro xml výstup<br />
* zobrazení sysLocation také v přehledové stránce (actual status)<br />
* možnost pojmenovat si všechny teploměry (16 znaků pro každý)<br />
* možnost pojmenovat si ovládané relé (16 znaků pro každé)<br />
<br />
== 29.10.2009 ==<br />
<br />
* drobnosti před vydáním 30.10.2009<br />
<br />
== 10.10.2009 ==<br />
<br />
* NTP klient - synchronizace času a data protokolem NTP<br />
* nastavení NTP serveru a GMT prostřednictvím "Admin config" webové stránky<br />
* zobrazení NTP času a data v "actual status" webové stránce<br />
* zobrazení času a data v "Log" webové stránce u všech položek<br />
<br />
== 20.09.2009 ==<br />
<br />
* webová stránka "aktuální stav" - upraveno pro správné zobrazování v IE<br />
* v nadpisu webové stránky (tag title) se zobrazuje název zařízení a navíc celý obsah textu ''sysLocation''<br />
<br />
== 07.09.2009 ==<br />
<br />
* 1-Wire&reg; měří na 1/16 stupně Celsia, upraveno časování (větší spolehlivost), lze připojit více čidel<br />
* možnost změny MAC adresy (přímo z webového rozhraní)<br />
* zobrazení informační (potvrzovací) stránky před změnou IP, MAC<br />
<br />
== výchozí firmware ==<br />
<br />
* výchozí firmware</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_MICRO:_ST:_firmware_changelog&diff=976SDS MICRO: ST: firmware changelog2025-11-15T14:24:43Z<p>Adamn: </p>
<hr />
<div>== SDS-MICRO ST / SDS-MICRO ST DP / SDS-IO6 ST ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek '''SDS MICRO ST''' a '''SDS MICRO ST DP''' a '''SDS IO6 ST'''.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
== 15.11.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* SDS-C: přidány indexy 303 a 304 a 305<br />
* SDS-C: přidán index 2198<br />
<br />
== 2.11.2023 ==<br />
* oprava SNMP (způsob předávání chybových hodnot)<br />
<br />
== 6.2.2023 ==<br />
* pouze SDS MICRO ST DP : nový výchozí firmware<br />
<br />
== 29.11.2022 ==<br />
* SDS-C: přidán index 137<br />
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve<br />
* oprava možného problému na sériové lince, kdy mohlo dojít k náhodnému malému zpoždění odeslání dat<br />
<br />
== 26.11.2022 ==<br />
* SDS-C: oprava možného teoretického problému u funkce serialX_write při odesílání z pole ram[] (ostatní zdroje dat/pole problém neměly)<br />
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)<br />
<br />
== 4.8.2022 ==<br />
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla<br />
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti<br />
* zlepšení funkce OneWire - širší prohledávání sběrnice (velká saturace neznámými čidly nevyčerpá počet kroků při hledání)<br />
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce<br />
* malá bezpečnostní aktualizace<br />
<br />
== 1.7.2022 ==<br />
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)<br />
* opravena chyba při výpisu teplot na webu (jinde to bylo OK), kdy v rozmezí -0.99 degC až 0.00 degC chyběl znak mínus<br />
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných<br />
* další drobné úpravy a opravy<br />
<br />
== 27.12.2021 ==<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
<br />
== 14.4.2021 ==<br />
* oprava hodnot v sys 39 (0 vyp, 3 zap) <br />
<br />
== 13.4.2021 ==<br />
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP <br />
<br />
== 11.4.2021 ==<br />
* možnost uživatelsky vypnout NTP klient a nastavovat čas přes SDS-C (sys 38 nebo sys 4), vhodné pro jiné zdroje času (LoRA, GSM, sběrnice, atd.). <br />
<br />
== 26.3.2021 ==<br />
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší) <br />
<br />
== 12.3.2021 ==<br />
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno <br />
<br />
== 9.2.2021 ==<br />
* SDS-C: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* SDS-C: drobná úspora heap (více dostupného místa)<br />
* SDS-C: dns resolv drobný fix<br />
* SDS-C: http_get a http_post důležitý fix<br />
* SDS-C: nová funkce http_close<br />
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní) <br />
<br />
== 10.1.2021 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "SDS-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off) <br />
<br />
== 5.1.2021 ==<br />
* SDS-C: oprava textcmp()<br />
* bezpečnostní oprava<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení <br />
<br />
== 23.10.2020 ==<br />
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST<br />
* web: oprava tempX.htm<br />
* oprava ovládání PDx (při změně z webu se nesáhne na ostatní bity nastavené např. ze SDS-C) <br />
<br />
== 20.9.2020 ==<br />
* zvýšení odolnosti na výpadky komunkace (crc chyby) na OneWire sběrnici <br />
<br />
== 4.8.2020 ==<br />
* drobné opravy a optimalizace<br />
* IO6-ST: oprava detekce eth <br />
<br />
== 18.7.2020 ==<br />
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu<br />
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty) <br />
<br />
== 27.6.2020 (jen MICRO-ST) ==<br />
* oprava možného okrajového problému s nečitelnými AD vstupy <br />
<br />
== 26.6.2020 ==<br />
* různé drobky/opravy dle hlášení uživatelů a testů<br />
* plně otestovaný MODBUS klient a MQTT klient<br />
* audit log <br />
<br />
== 20.6.2020 ==<br />
* SDS-C verze 09: přidáno http_post()<br />
* MODBUS-TCP klient<br />
* doladění MQTT klienta <br />
<br />
== 14.6.2020 ==<br />
* SDS-C verze 09<br />
* MQTT klient<br />
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)<br />
* různé opravy (podle ostatních SDS) <br />
<br />
== 15.11.2019 ==<br />
* oprava přehozených AD3 a AD4 <br />
<br />
== 14.11.2019 ==<br />
* první vydání FW pro SDS MICRO ST</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_MINI:_ST:_firmware_changelog&diff=975SDS MINI: ST: firmware changelog2025-11-15T14:24:34Z<p>Adamn: </p>
<hr />
<div>== SDS-MINI ST a SDS-TTCPRO ST ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-MINI ST a pro SDS-TTCPRO ST.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
<br />
== 15.11.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* SDS-C: přidány indexy 303 a 304 a 305<br />
* SDS-C: přidán index 2198<br />
<br />
== 2.11.2023 ==<br />
* oprava SNMP (způsob předávání chybových hodnot)<br />
<br />
== 29.11.2022 ==<br />
* SDS-C: přidán index 137<br />
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve<br />
* oprava možného problému na sériové lince, kdy mohlo dojít k náhodnému malému zpoždění odeslání dat<br />
<br />
== 26.11.2022 ==<br />
* SDS-C: oprava možného teoretického problému u funkce serialX_write při odesílání z pole ram[] (ostatní zdroje dat/pole problém neměly)<br />
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)<br />
<br />
== 4.8.2022 ==<br />
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla<br />
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti<br />
* zlepšení funkce OneWire - širší prohledávání sběrnice (velká saturace neznámými čidly nevyčerpá počet kroků při hledání)<br />
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce<br />
* malá bezpečnostní aktualizace<br />
<br />
== 1.7.2022 ==<br />
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)<br />
* opravena chyba při výpisu teplot na webu (jinde to bylo OK), kdy v rozmezí -0.99 degC až 0.00 degC chyběl znak mínus<br />
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných<br />
* další drobné úpravy a opravy<br />
<br />
== 27.12.2021 ==<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
<br />
== 14.4.2021 ==<br />
* oprava hodnot v sys 39 (0 vyp, 3 zap)<br />
<br />
== 13.4.2021 ==<br />
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP<br />
<br />
== 11.4.2021 ==<br />
* možnost uživatelsky vypnout NTP klient a nastavovat čas přes SDS-C (sys 38 nebo sys 4), vhodné pro jiné zdroje času (LoRA, GSM, sběrnice, atd.).<br />
<br />
== 26.3.2021 ==<br />
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)<br />
<br />
== 12.3.2021 ==<br />
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno<br />
<br />
== 9.2.2021 ==<br />
* SDS-C: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* SDS-C: drobná úspora heap (více dostupného místa)<br />
* SDS-C: dns resolv drobný fix<br />
* SDS-C: http_get a http_post důležitý fix<br />
* SDS-C: nová funkce http_close<br />
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)<br />
<br />
== 10.1.2021 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "SDS-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off) <br />
<br />
== 5.1.2021 ==<br />
* SDS-C: oprava textcmp()<br />
* bezpečnostní oprava<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení <br />
<br />
== 23.10.2020 ==<br />
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST<br />
* web: oprava tempX.htm<br />
* oprava ovládání PDx (při změně z webu se nesáhne na ostatní bity nastavené např. ze SDS-C)<br />
<br />
== 20.9.2020 ==<br />
* zvýšení odolnosti na výpadky komunikace (crc chyby) na OneWire sběrnici<br />
<br />
== 4.8.2020 ==<br />
* drobné opravy a optimalizace<br />
<br />
== 18.7.2020 ==<br />
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu<br />
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)<br />
<br />
== 27.6.2020 (jen MINI) == <br />
* oprava možného okrajového problému s nečitelnými AD vstupy<br />
<br />
== 26.6.2020 ==<br />
* různé drobky/opravy dle hlášení uživatelů a testů<br />
* plně otestovaný MODBUS klient a MQTT klient<br />
* audit log<br />
<br />
== 20.6.2020 ==<br />
* SDS-C verze 09: přidáno http_post()<br />
* MODBUS-TCP klient<br />
* doladění MQTT klienta<br />
<br />
== 14.6.2020 ==<br />
* SDS-C verze 09<br />
* MQTT klient<br />
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031) <br />
* různé opravy (podle ostatních SDS)<br />
<br />
== 14.11.2019 ==<br />
* relé lze z webového rozhraní aktivovat i v režimu OneShot<br />
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas) <br />
<br />
== 17.2.2019 ==<br />
* oprava v ovládání PDx GPIO ze SDS-C (je to teď zcela shodné s TTCPRO)<br />
<br />
== 12.1.2019 ==<br />
* optimalizace webového serveru (množství přenášenyćh dat sníženo až o polovinu, bez změny funkce) - ocení se to zejména při přenosu po úzkých linkách (např. gprs, modemy)<br />
<br />
== 4.1.2019 ==<br />
* překlopena beta do oficiálního vydání<br />
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)<br />
* watchdog sds-c programu<br />
* COM6 je k dispozici<br />
<br />
== 1.7.2018 ==<br />
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS <br />
* opraven možný výpadek vysílání na ETH (opraveno stejně jako pro TTCPRO)<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím) <br />
<br />
== 8.3.2018 ==<br />
* oprava echo.htm - zobrazuje se<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktualizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 18.1.2018 ==<br />
<br />
* měření AD vstupů funguje<br />
<br />
== 18.12.2017 ==<br />
<br />
* zvýšena stabilita spuštění po zapnutí<br />
<br />
== 18.12.2017 ==<br />
<br />
* výchozí firmware (MINI odpovídá obsahem TTCPRO 18.12.2017)<br />
* měření AD vstupů je v tomto vydání vypnuto (použijte novější FW)<br />
* COM6 je vypnut (bude zapnut v příštím vydání)</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_MICRO:_ST:_firmware_changelog&diff=974SDS MICRO: ST: firmware changelog2025-11-15T14:23:40Z<p>Adamn: </p>
<hr />
<div>== SDS-MICRO ST / SDS-MICRO ST DP / SDS-IO6 ST ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek '''SDS MICRO ST''' a '''SDS MICRO ST DP''' a '''SDS IO6 ST'''.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
== 15.11.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* SDS-C: přidány indexy 303 a 304 a 305<br />
* SDS-C: přidán indexy 2198<br />
<br />
== 2.11.2023 ==<br />
* oprava SNMP (způsob předávání chybových hodnot)<br />
<br />
== 6.2.2023 ==<br />
* pouze SDS MICRO ST DP : nový výchozí firmware<br />
<br />
== 29.11.2022 ==<br />
* SDS-C: přidán index 137<br />
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve<br />
* oprava možného problému na sériové lince, kdy mohlo dojít k náhodnému malému zpoždění odeslání dat<br />
<br />
== 26.11.2022 ==<br />
* SDS-C: oprava možného teoretického problému u funkce serialX_write při odesílání z pole ram[] (ostatní zdroje dat/pole problém neměly)<br />
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)<br />
<br />
== 4.8.2022 ==<br />
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla<br />
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti<br />
* zlepšení funkce OneWire - širší prohledávání sběrnice (velká saturace neznámými čidly nevyčerpá počet kroků při hledání)<br />
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce<br />
* malá bezpečnostní aktualizace<br />
<br />
== 1.7.2022 ==<br />
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)<br />
* opravena chyba při výpisu teplot na webu (jinde to bylo OK), kdy v rozmezí -0.99 degC až 0.00 degC chyběl znak mínus<br />
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných<br />
* další drobné úpravy a opravy<br />
<br />
== 27.12.2021 ==<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
<br />
== 14.4.2021 ==<br />
* oprava hodnot v sys 39 (0 vyp, 3 zap) <br />
<br />
== 13.4.2021 ==<br />
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP <br />
<br />
== 11.4.2021 ==<br />
* možnost uživatelsky vypnout NTP klient a nastavovat čas přes SDS-C (sys 38 nebo sys 4), vhodné pro jiné zdroje času (LoRA, GSM, sběrnice, atd.). <br />
<br />
== 26.3.2021 ==<br />
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší) <br />
<br />
== 12.3.2021 ==<br />
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno <br />
<br />
== 9.2.2021 ==<br />
* SDS-C: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* SDS-C: drobná úspora heap (více dostupného místa)<br />
* SDS-C: dns resolv drobný fix<br />
* SDS-C: http_get a http_post důležitý fix<br />
* SDS-C: nová funkce http_close<br />
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní) <br />
<br />
== 10.1.2021 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "SDS-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off) <br />
<br />
== 5.1.2021 ==<br />
* SDS-C: oprava textcmp()<br />
* bezpečnostní oprava<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení <br />
<br />
== 23.10.2020 ==<br />
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST<br />
* web: oprava tempX.htm<br />
* oprava ovládání PDx (při změně z webu se nesáhne na ostatní bity nastavené např. ze SDS-C) <br />
<br />
== 20.9.2020 ==<br />
* zvýšení odolnosti na výpadky komunkace (crc chyby) na OneWire sběrnici <br />
<br />
== 4.8.2020 ==<br />
* drobné opravy a optimalizace<br />
* IO6-ST: oprava detekce eth <br />
<br />
== 18.7.2020 ==<br />
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu<br />
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty) <br />
<br />
== 27.6.2020 (jen MICRO-ST) ==<br />
* oprava možného okrajového problému s nečitelnými AD vstupy <br />
<br />
== 26.6.2020 ==<br />
* různé drobky/opravy dle hlášení uživatelů a testů<br />
* plně otestovaný MODBUS klient a MQTT klient<br />
* audit log <br />
<br />
== 20.6.2020 ==<br />
* SDS-C verze 09: přidáno http_post()<br />
* MODBUS-TCP klient<br />
* doladění MQTT klienta <br />
<br />
== 14.6.2020 ==<br />
* SDS-C verze 09<br />
* MQTT klient<br />
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)<br />
* různé opravy (podle ostatních SDS) <br />
<br />
== 15.11.2019 ==<br />
* oprava přehozených AD3 a AD4 <br />
<br />
== 14.11.2019 ==<br />
* první vydání FW pro SDS MICRO ST</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_MICRO:_LM:_firmware_changelog&diff=973SDS MICRO: LM: firmware changelog2025-11-15T14:23:05Z<p>Adamn: </p>
<hr />
<div>== SDS-MICRO LM / SDS-IO6 LM ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS MICRO LM (všechny jeho varianty) a SDS IO6 LM.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
== 15.11.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* SDS-C: přidány indexy 303 a 304 a 305<br />
* SDS-C: přidán indexy 2198<br />
<br />
== 1.7.2022 ==<br />
* opravena chyba při výpisu teplot na webu (jinde to bylo OK), kdy v rozmezí -0.99 degC až 0.00 degC chyběl znak mínus<br />
* obsluha času: možnost zápisu do sys[4], sys[39]<br />
* IO6: doplněny další možné vstupní typy do funkcí itoa/itoh (MICRO už to mělo)<br />
* IO6: možnost zakázat NTP (MICRO už to mělo)<br />
<br />
== 28.6.2021 ==<br />
* IO6: web: oprava oneshotreset<br />
* IO6: web: přepnutí relé (CBY) na SDS-C ponechá stav relé (zap/vyp) (předtím to natvrdo dalo vyp, což nebylo správně)<br />
<br />
== 26.3.2021 ==<br />
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)<br />
<br />
== 9.2.2021 ==<br />
* SDS-C: dns resolv drobný fix<br />
* SDS-C: http_get a http_post drobný fix<br />
* SDS-C: nová funkce http_close<br />
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT<br />
<br />
== 5.1.2021 ==<br />
* SDS-C: oprava textcmp()<br />
* bezpečnostní oprava<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení <br />
<br />
== 23.10.2020 ==<br />
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST<br />
<br />
== 4.8.2020 ==<br />
* SNMP fix - správná hodnota ve .5.13 až .5.16<br />
* drobné opravy a optimalizace<br />
<br />
== 18.7.2020 ==<br />
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu<br />
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)<br />
<br />
== 27.6.2020 (jen MICRO) ==<br />
* oprava nestartování předchozí verze FW na některých specifických typech HW varianty SDS-MICRO-x<br />
<br />
== 26.6.2020 ==<br />
* SDS-C 09: http_post()<br />
* MQTT klient<br />
* různé drobky/opravy dle hlášení uživatelů a testů<br />
<br />
== 11.5.2020 ==<br />
* oprava Content-Length pro CSS soubor (problém s Chrome)<br />
* oprava chování při odpojeném SDS-1W-T-RH<br />
<br />
== 20.4.2020 ==<br />
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)<br />
<br />
== 15.4.2020 ==<br />
* implementován SDS Audit Log<br />
* zvýšená ochrana proti brute-force hledání vstupního hesla<br />
<br />
== 14.11.2019 ==<br />
* drobný bugfix pro S0 (způsob zobrazování aktuálního výkonu)<br />
* relé lze z webového rozhraní aktivovat i v režimu OneShot<br />
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas) <br />
<br />
== 17.1.2019 ==<br />
* bugfix SDS-C watchdogu<br />
<br />
== 12.1.2019 ==<br />
* optimalizace webového serveru (množství přenášenyćh dat sníženo až o polovinu, bez změny funkce) - ocení se to zejména při přenosu po úzkých linkách (např. gprs, modemy) <br />
<br />
== 4.1.2019 ==<br />
* překlopena beta do oficiálního vydání<br />
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)<br />
* watchdog sds-c programu<br />
<br />
== 1.7.2018 ==<br />
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS<br />
<br />
== 30.3.2018 ==<br />
* oprava funkce zápisu prázdného řetězce do názvu 1-Wire teploměru ("smazání názvu" uživatelem) <br />
* M2M: hodnota okamžitého výkonu pro S0 vstupy je vždy číslo+jednotka, zatímco text 'čekám...' je už jen pouze na s0.htm<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím)<br />
* drobná oprava při změně nastavení S0, teď se to ihned provede (v okrajových případech bylo někdy potřeba pro načtení změn SDS restartovat, teď už ne).<br />
<br />
== 12.3.2018 ==<br />
* oprava měření na S0 vstupech (některé vstupy se starším FW nemusely být, v určitých okrajových situacích, plně funkční)<br />
<br />
== 8.3.2018 ==<br />
* oprava echo.htm - zobrazuje se<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 18.12.2017 ==<br />
* možnost automického přepínání "letní/zimní" čas (CEST/CET time) byla při "změně času" ověřena a je funkční jak má být<br />
* správný zápis pouze do T0 pro všechny S0 vstupy, které nemají aktivované tarifní rozdělení (bez ohledu na stav tarifního vstupu)<br />
* zámek 1-W pozice se ukládá do pevné paměti (při stisku tlačítka na webovém rozhraní)<br />
* vylepšení v oblasti VCP (telnet pro sériovou linku) - spolehlivější<br />
* zpřesněny prvky ochrany S0 stránek heslem (SDS lépe volí kdy a jak blokovat přístup na jednotlivé eX a S0 stránky)<br />
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)<br />
<br />
== 23.10.2017 ==<br />
* hlavní nová funkce: přidána volitelná funkce (checkbox ve webovém rozhraní) pro plně automatickou volbu Letního Času (SELČ - aplikovatelné napříč Evropou)<br />
* další podstatná úprava: doplnění dalších testů na timeout při OSI7 funkcích (např. http_get) - tzn. test na více místech, který má zabránít zablokování funkce (1029) když selže spojení na server (vyhlásí novou chybu 1030 a odblokuje se).<br />
* přidány SNMP položky (OID) pro text "ADC jednotka" (pro každý AD vstup).<br />
* drobné bugfixy a zvýšení spolehlivosti, podle průběžných hlášení uživatelů (např. mírně zvětšeny RX a TX vyrovnávací paměti pro COM1 sériový port, atd.).<br />
* SDS-C: přidán sys[4], sys[11], sys[38], sys[39]<br />
* SDS-C: sys[4] = local-time<br />
* SDS-C: sys[11] = vždy "správné" číslo dne v týdnu<br />
* SDS-C: sys[38] = utc-time<br />
* SDS-C: sys[39] = stav automatiky přepínání CEST/CET času<br />
<br />
== 10.8.2017 ==<br />
* SDS-C: zvýšena verze na hodnotu 07 (funguje i pro výrobky s EEPROM tak pro výrobky s NVM-DF)<br />
* SDS-C: přidány nové sys[] položky (indexy 1792 až 2047)<br />
* SDS-C: optimalizovaná cache pro velké programy<br />
* SDS-C: maximální počet proměnných zvýšen na 144<br />
* SDS-C: maximální počet procesů (procedur) zvýšen na 96<br />
* SDS-C: hloubka zásobníku (stacku) zvýšena na 24<br />
* vydán nový odpovídající SDSC.exe<br />
<br />
== 3.8.2017 ==<br />
* oprava chyby kdy se po každém spuštění systému mohla ztratit část S0 konfigurace (nastavení tarifního vstupu)<br />
<br />
== 18.4.2017 ==<br />
* (nová funkčnost) použití UserWEB Projektu<br />
* oprava v echo() pro zápis do sériové linky (uart)<br />
* drobné ale důležité fixy v html stránkách (texty, vzhled)<br />
* nové NTP dotazy lze aktivovat i z SDS-C programu (viz aktualizovaný seznam sys)<br />
<br />
== 24.11.2016 ==<br />
* opraven chybně zpracovaný vstup při zadávání nastavení parametrů S0 vstupu (hodnota "minimální délka impulsu" byla špatně zpracována a uložena)<br />
<br />
== 28.3.2016 ==<br />
* impulse counter lze z webu zadat do plných 32 bitů, původně jen 31 bitů<br />
* další drobné opravy<br />
<br />
== 26.3.2016 ==<br />
* oprava chybného zpracování RFC2217 příkazu pro změnu BaudRate (zpracoval se jen poslední byte místo celého dwordu, teď opraveno)<br />
<br />
== 23.2.2016 ==<br />
* oprava nefunkčního zápisu pomocí SNMP (několik předchozích verzí, teď opraveno)<br />
<br />
== 5.2.2016 ==<br />
* oprava funkce RSTD - rozšíření funkce RSTD: krátký zkrat (approx 1 sec) po zapnutí spustí BL (zařízení čeká na nový firmware), zatímco dlouhý zkrat (déle než 3 sec) spustí aplikaci a současně vymaže nastavení (set to Factory Defaults)<br />
* možnost vyhledávat všechny zařízení SDS na subnetu pomocí rozšířené funkce (Find a SDS) v EXE aplikaci (např. když ztratíte IP adresu do webového rozhraní a potřebujete se na SDS připojit)<br />
<br />
== 15.11.2015 ==<br />
* důležité opravy<br />
<br />
== 3.7.2015 ==<br />
* vylepšený DHCP client<br />
* řada oprav podle průběžného testování<br />
<br />
== 2.4.2015 ==<br />
* veškeré opravy od posledního vydání (viz průběh BETA testů)<br />
* významně zvýšena spolehlivost a stabilita při síťové zátěži (Eth. komunikace)<br />
* SDS-C: přidáno sys[193]<br />
* SDS-C: přidáno sys[37]<br />
* SDS-C: přidáno sys[139]<br />
* SDS-C: možnost zápisu do sys[4]<br />
* SNMP TRAP předává plný OID (dosud dával jen OID useknutný za E.ID)<br />
<br />
== 9.9.2014 ==<br />
* opravena chyba pro sys[64]==1 (vnitřním zaokrouhlením to skočilo na nulu)<br />
<br />
== 17.8.2014 ==<br />
* přidána možnost použít get_var[index] pro čtení vnitřních proměnných v SDS-C přes web<br />
* SNMP: umožňuje zápis do všech položek přes "Counter32" (nová záležitost) a původní "Integer" typ<br />
* SNMP: přidána možnost zápisu do položek S0-impulse-counter (T0 a T1)<br />
* RS485: při vysílání je budič aktivní max 1msec (nebo méně) od posledního znaku<br />
<br />
== 8.7.2014 ==<br />
* opravy v oblasti obsluhy sériového rozhraní (RS485)<br />
* do webové administrace přidána možnost vzájemného přehození pozic dvou 1-Wire záznamů<br />
* další drobné opravy z průběžných beta testů<br />
<br />
== 8.3.2014 ==<br />
* SDS-C: opraveno chyba omezující možný rozsah sys[78] (bylo omezeno na 0xFF, už není - teď správně vezme max velikost pole ram[] nebo text[])<br />
<br />
== 1.3.2014 ==<br />
* SDS-C: nová funkce serial_write()<br />
* SDS-C: nový timeout pro smtp_send() - zamezí specifickému možnému zaseknutí programu, když SMTP server přestane odpovídat uprostřed transkace po více než 50sec<br />
* SDS-C: opravena funkce snmp_send_trap() - horní část seznamu trapů byla předtím chybně neodeslatená (teď už je vše OK)<br />
* vylepšení odolnosti při výpadku a při obnovení připojení k Ethernetu<br />
* různé drobné důležité opravy (viz beta testy)<br />
<br />
== 23.1.2014 ==<br />
* překlopená beta-verze (po ukončené ověřovací sérii testů)<br />
* SDS-C: úpravy (spolehlivost) v http_get(), dns_resolve()<br />
* rozšířena 1-W funkcionality (další chipy)<br />
* možnost "zrušit odečet" tlačítkem ve webovém rozhraní<br />
* možnost nastavit minimální akceptovanou délku S0 impulsu pro každý vstup samostatně<br />
* maximální velikost user.htm je zvětšena (teď lze vyplnit celou DF)<br />
<br />
== 30.11.2013 ==<br />
* celá řada drobných oprav (nalezené v rámci testování od poslední verze)<br />
* S0.htm: všechny hodnoty zobrazují údaje od posledního odpočtu (chybělo pro T0/T1 kWh)<br />
* web: /get_dfi[x]<br />
* SDS-C: čtení a zápis celé stránky z/do paměti DataFlash<br />
<br />
== 3.10.2013 ==<br />
* celá řada drobných oprav<br />
* login html stránka upravena (w3c valid)<br />
* možnost nastavit MTD pro S0 měření<br />
* nový SDSC.exe program<br />
<br />
== 16.3.2013 ==<br />
* zápis výpadku a znovu-připojení Ethernetu do logu historie<br />
* při odpojení a následném znovu-připojení Ethernetu dojde od teď záměrně ke smazání celé ARP tabulky, takže všechny MAC-IP páry jsou vyžádány znovu (pro případ že se např. vyměnil router atd.)<br />
* SDS-C: get_txt[xxx] (vypíše pole text od indexu xxx až do znaku 0x00 na některém z následujících indexů v tomto poli)<br />
* get_sys[xxx] vrací i text pro textové položky (vyzkoušejte všechny sys[] které jsou textové)<br />
* SDS-C: přidáno sys[900] až sys[931] (text ROM CODE pro 1-W čidla)<br />
* upraveno zpracování ARP tabulky (více bezpečné pro dlouhodobý provoz)<br />
* možnost řízení tarifního signálu pro S0 prostřednictvím SDS-C programu<br />
* funkce "odečet" pro S0 (viz nastavení S0 vstupů ve webové administraci)<br />
* SDS-C: funkce smtp_send() akceptuje text[] nejen pro obsah zprávy, ale i pro adresu příjemce a subject<br />
* SDS-C: funkce http_get() akceptuje text[] nejen pro obsah zprávy, ale i pro nastavení HTTP HOST parametru<br />
<br />
== 4.2.2013 ==<br />
* při zobrazení echo.htm, když je konzole plná textu, nedojde k resetu zařízení<br />
* opraveno časování pro 1-Wire sběrnici (vráceno na původní stav před úpravou v 20.12), uptime počítá také správně<br />
* SDS-C: přidáno sys[45]<br />
* SDS-C: přidáno sys[46]<br />
* SDS-C: přidáno sys[98]<br />
* SDS-C: echoinline() funguje správně<br />
<br />
== 20.12.2012 ==<br />
Významné vydání, oprava řady drobných chyb průběžně hlášených od uživatelů, celá řada nových funkcí<br />
* DHCP CLIENT<br />
* SNMP write<br />
* rychlejší boot loader<br />
* rychlejší webová administrace<br />
* přesnější udržování aktuálního času v zařízení (dvojnásobná kontrola přesnosti a korekce)<br />
* přepracované úložiště v pevné paměti - SDS s eeprom ukládá všech 16 názvů pro teploměry<br />
* možnost změny portu "UDP protokolu" (výchozí port 280)<br />
* SDS-C: konzole zvětšena o zhruba 400 znaků<br />
* délky textů pro (názvy) S0 jsou 32 bajtů, což je až 32 znaků (české znaky v UTF-8 berou 2 bajty), nicméně vše se v defaultu už vleze<br />
* pro každý S0 vstup lze nastavit rozdílnou cenu pro T0 a T1 (stav tarifu)<br />
* SDS-C: funkce send_udp()<br />
* SDS-C: přidáno sys[61]<br />
* SDS-C: přidáno sys[27]<br />
* SDS-C: funkce echoinline()<br />
* správné zpracování LOGIC S0 u zařízení SDS MICRO, které tento vstup nemají<br />
* upraven CSV soubor (vypisuje detaily pro S0)<br />
* upraven xml.xml a s0.xml (vše funguje jak má i při plném osazení, typicky pro SDS MACRO 8)<br />
* SDS-C: sprintf dává 0x00 na konec textu (tohle chybělo)<br />
* SDS-C: http_get() zapisuje 0x00 na "konec" text[], když se do text[] ukládá přijatá odpověď.<br />
* SDS-C: oprava která má zajistit nevyvolání chyby 1029 pro http_get() funkci <br />
* rozšířený MIB (položky pro S0 hodnoty)<br />
* SDS-C: SNMP TRAP (odesílání TRAPů z SDS-C programu)<br />
* a řada drobných obrav a vylepšení<br />
<br />
== 7.5.2012 ==<br />
* opravena funkčnost PWM výstupu - lze správné nastavit střídu v rozmezí 0 až 100% viz návod na WiKi<br />
<br />
== 29.3.2012 ==<br />
* firmware funguje správně i v historických zařízeních SDS MICRO LIGHT (1) používajících 24C16/24C256<br />
<br />
== 27.3.2012 ==<br />
* spolehlivé načítání prvních osmi uložených pozic teploměrů z pevné paměti po resetu<br />
* automaticky umístí nadbývající připojené teploměr na pozice 9 až 16<br />
* zamykání pozic teploměrů funguje správně<br />
* předělaná SDS-C funkce smtp_send() - má větší pracovní buffer, zvládne náročnější SMTP servery<br />
<br />
== 18.3.2012 ==<br />
* finální podoba SNMP MIB (stáhněte si aktualizovaný MIB soubor)<br />
<br />
== 11.3.2012 ==<br />
* malá změna v SNMP MIB (srovnání MIBů mezi MICRO/MACRO)<br />
* další drobné opravy nahlášené po testování firmware z 8.3.<br />
<br />
== 8.3.2012 ==<br />
* odstraněno zpoždění v převodníku Ethernet-Serial (Virtual COM port)<br />
<br />
== 4.3.2012 ==<br />
Řada oprav a vylepšení, pocházející z BETA testování (viz forum)<br />
* správný výpočet data od 29.2.2012<br />
* možnost uzamknout pozice 1-Wire zařízení (teploměry)<br />
* rozšířené SNMP<br />
* SDS-C verze č. 06<br />
* pole text[] a funkce atoi(), sprintf()<br />
* uživatelská stránka může být i jako přímo indexová stránka webového rozhraní<br />
* všechny fyzické vstupy a výstupy jsou počítány od jedničky<br />
* další drobné úpravy a opravy, viz soupis u BETA testů<br />
<br />
== 17.1.2012 ==<br />
* oprava indexů v "temp" tagech v xml.xml a temp.xml<br />
<br />
== 16.1.2012 ==<br />
* opravy v přenosu hodnot teplot jednotlivými protokoly (v případě teploty menší než 0 stupňů Celsia byl špatně umístěn znak minus)<br />
<br />
== 15.1.2011 ==<br />
* opravena chyba s user-dataflash (oprava má význam pouze pro výrobky osazené DF, nikoliv EE, tam chyba nebyla)<br />
<br />
== 21.12.2011 ==<br />
* zapracovány všechny nové funkce, testované v rámci BETA testování nového firmware (probíhalo od 27.10.)<br />
<br />
== 27.10.2011 ==<br />
* do webového rozhraní přidáno tlačítko: možnost nastavení střídy PWM "na zkoušku" (bez uložení do pevné paměti)<br />
* web: funkce /get_sys a /get_ram může vrátit řadu proměnných za sebou<br />
<br />
== 2.10.2011 ==<br />
* přidán sys[26]<br />
* přidán sys[63]<br />
* přidán sys[78]<br />
* doplněn UDP protokol o čtyři nové funkce (čtení / zápis polí sys[] a ram[])<br />
<br />
== 31.7.2011 ==<br />
* opraven problém s UDP protokolem - příkaz '''write''' (už funguje vždy ok)<br />
* nový SDSC.exe program - doplňuje správnou HTML serverovou hlavičku pro uživatelskou stránku<br />
<br />
== 29.7.2011 ==<br />
* možnost zápis z SDS-C programu do systémových proměnných sys[559] až sys[561]<br />
* nová funkce pro UDP protokol - funkce '''write''' umožňuje hromadný zápis do sys[] systémových proměnných<br />
<br />
== 25.6.2011 ==<br />
* možnost změnit číslo TCP portu webového serveru webového rozhraní výrobku (změna stejným způsobem jako je změna IP nebo MAC adresy...)<br />
<br />
== 16.6.2011 ==<br />
* verze SDS-C č. 04<br />
* SDS-C: plně funkční funkce ping()<br />
* rozšíření maximální velikosti SDS-C programu ve všech verzích SDS MICRO (light, light2, DIN)<br />
** DATAFLASH maximální velikost programu je 65472 bajtů<br />
** 24C16 maximální velikost programu je 900 bajtů<br />
** 24C256 maximální velikost programu je 31416 bajtů<br />
<br />
* web: nastavení uživatelské proměnné pomocí volání sdscep pracuje s doplňkovými parametry (např. vrací hodnotu)<br />
* upravena obsluha eeprom paměti (jiný I2C driver) - tzn. větší spolehlivost a větší rychlost<br />
* sys[25] po každém zavolání čte hodnotu z PHY HW a vrací skutečný stav v daný okamžik<br />
* čtení ze sériové linky je teď dostupné pro program v SDS-C (viz sys[48] a sys[49])<br />
* změna řízení PWM výstupu, lze teď plynule regulovat poměr log0 a log1 v celém rozsahu<br />
* všechny stránky předělány na UTF-8, vstupy textů berou i České znaky atd.<br />
* výpis MAC adresy pro SDS-C program (viz sys[31] až sys[36])<br />
* SDS-C: http_get může uložit získaná data webové stranky do pole ram[]<br />
* zcela změněn ARP algoritmus, měl by teď bez problémů pracovat i na větších podsítích než je /24<br />
* web: informační stránka /arp.htm<br />
* SDS-C: zvětšena velikost pole ram[] na 512 záznamů<br />
* web: výpis hodnot sys[] a ram[] pomocí dynamicky generované webové stránky (např. /get_ram[123] )<br />
* web: čtení výpisu sys[] a ram[] lze zakázat v nastavení (SDS-C parametr)<br />
* SDS-C: možnost zápisu do S0 impulsních počítadel (nulování, úpravy hodnot, atd.)<br />
* pokud je konkrétní relé ve webovém rozhraní nastaveno na něco jiného, než na "ovládáno z SDS-C", tak jeho stav SDS-C program nezmění<br />
<br />
== 21.5.2011 ==<br />
* opravy v českém a anglickém překladu webového rozhraní<br />
<br />
== 14.5.2011 ==<br />
* vydána pouze nová EXE aplikace pro nahrávání SDS-C<br />
* od této verze umožňuje použít složité kostrukce s IF, např.: if (test) { kus programu; } else { kus programu; };<br />
<br />
== 13.5.2011 ==<br />
* od této verze jsou k dispozici dvě jazykové varianty - plně Česká varianta a plně Anglická varianta<br />
* varianty se liší pouze texty ve webovém rozhraní, jejich funkčnost je ale zcela shodná (bez rozdílů)<br />
<br />
== 20.3.2011 ==<br />
* funkční nahrávání uživatelské webové stránky<br />
<br />
== 3.3.2011 ==<br />
* pouze nový simulační WinEXE program pro SDS-C<br />
** funkční simulátor LCD (SDS MACRO)<br />
** vylepšení v hlášení chyb při kontrole programu SDS-C<br />
<br />
== 27.2.2011 ==<br />
* změněn výpis UpTime v Actual Status webové stránce na dny/hod/min/sec/msec<br />
* doplněna generovaná webová stránka: echo.htm (obsahuje pouze výpis konzole SDS-C, vhodné pro embedding do jiného webu)<br />
* nový XML soubor - usys.xml - výpis vzdálených proměnných SDS-C<br />
* možnost volby nezasílání http dat pro volání sdscep (umožnujě tzv. tichou aktualizaci hodnoty sys)<br />
* do SNMP doplněna hodnota teploty SoC (vyčtená z HW, bez převodu na °C)<br />
* příprava pro nahrání uživatelské webové stránky (plná podpora bude v následující verzi fw)<br />
* nová verze SDS-C, nové možnosti, nový simulátor<br />
** SDS-C: možnost použít #define v programu<br />
** SDS-C: možnost použít uživatelské proměnné jako indexy do pole (sys, ram)<br />
** SDS-C: k dispozici je univerzální pole ram[]<br />
** SDS-C: nová WinEXE aplikace, řada drobností...<br />
<br />
== 30.1.2011 ==<br />
* úpravy specifické pro verzi LIGHT s EEPROM (restart zařízení)<br />
<br />
== 29.1.2011 ==<br />
* v SNMP doplněn výpis celé hodnoty (x100) pro 1-W teploměry 2 až 16<br />
<br />
== 28.1.2011 ==<br />
* dvě nové funkce v SDS-C, pro zápis do sériového portu <br />
* zpřesněný interní čítač reálného času<br />
<br />
== 26.1.2011 ==<br />
* změněna minimální akceptovaná délka S0 impulsu, bylo původně 16 msec jako minimum, od této verze je to 5 msec (z důvodů připojení speciálních nepřímých elektroměrů).<br />
* doplňky v simulátoru SDS-C, zejména ohledně času, korekce optovstupů, atd.<br />
<br />
== 9.1.2011 ==<br />
* nová položka v SNMP - pro každé teplotní čidlo je poskytována plná hodnota násobena 100 (např. 12.35°C je předáno jako 1235)<br />
* pouze SDS MICRO LIGHT: v SDS-C doplněny čtyři sys[], umožňující přímé ovládání vývodů A1, B1, M4, M5 (CMOS 3V3 logika, pájecí plošky)<br />
<br />
== 7.12.2010 ==<br />
* upraven způsob výpočtu a prezentace okamžitého výkonu (S0), zejména v případě přerušení dodávky S0 impulsů<br />
<br />
== 1.12.2010 ==<br />
* firmware podporuje i jiné osazené dataflash (menší velikosti) paměti<br />
<br />
== 29.11.2010 ==<br />
* oprava v chování SDS-C, kdy pokud byl program právě ve funkci wait(), tzn. čekal, a v tu chvíli byl nahrán nový program, tak nebylo čekání zrušeno, a nový program byl spuštěn až po dokončení čekání<br />
* úpravy odkazů na www.merenienergie.cz, portal.merenienergie.cz<br />
<br />
== 20.10.2010 ==<br />
* upraven UDP protokol - doplněno ROMCODE pro teplotní čidla<br />
* upraveno zadávání uživatelských sys[] proměnných z webu (už lze zadávat i záporné čísla)<br />
* opravena ztráta nastavení GMT offset po resetu zařízení<br />
<br />
== 8.10.2010 ==<br />
* opraven SNMP který měl od verze 10.9. problémy<br />
* tento a novější firmware je vhodný pro spolupráci se službou portal.merenienergie.cz<br />
<br />
== 6.10.2010 ==<br />
* oprava výpisu přepočtené spotřeby (kW) - doplněno vždy na tři desetinná místa<br />
* funkční nulování převodu peněz<br />
* SMTP konfigurace se správně načte po zapnutí zařízení<br />
<br />
== 26.9.2010 ==<br />
* SDS-C: stránka "control", uživatelsky editovatelné proměnné<br />
* SDS-C: do sys[] doplněna informace pro S0 (čas od posledního impulsu)<br />
* drobné doplňky do XML, příprava pro SDSMON.exe<br />
* UDP protokol, popis viz wiki<br />
<br />
== 17.9.2010 ==<br />
* oprava v SDS-C: funkce http_get a smtp_send, od teď umožnují vkládat proměnné až na pozici do maximální délky zprávy (1024 znaků)<br />
* výstup /temp.txt je doplněn na dvojici: romcode : teplota<br />
* výstup /temp.xml je doplněn o tagy s romcode<br />
<br />
== 15.9.2010 ==<br />
* doplněn výstup teplot ze všech čidel, do textové formy, /temp.txt<br />
* odečet teplotních web-snippet tempX.htm akceptuje hex znaky (tj. 0-9, a-f)<br />
<br />
== 14.9.2010 ==<br />
* opraven výpis teploty v csv.csv<br />
* nový xml soubor: temp.xml - pouze s údaji o teplotě<br />
<br />
== 10.9.2010 ==<br />
* opraveno zobrazení kWh na webových stránkách (špatný číselný text u vyšších hodnot kWh)<br />
<br />
== 8.9.2010 ==<br />
* ve firmware byl zvýšen maximální počet obsluhovaných teplotních sensorů z 8 na 16<br />
<br />
== 14.8.2010 ==<br />
* opraveno SDS-C - správnost předávání konstantních číselných parametrů funkcím<br />
* doplněna nová funkce do SDS-C - funkce http_get<br />
* nový Win32 program pro práci s SDS-C (doplněna funkčnost vzdálených labelů)<br />
* zobrazení názvů tarifů na celkové stránce pro S0 (předtím bylo jen na detailních stránkách)<br />
<br />
== 9.8.2010 ==<br />
* firmware funguje i pro HW rev2,3 (SDS MICRO light), předchozí verze 3.8. nenašla externí flash paměť<br />
<br />
== 3.8.2010 ==<br />
* opravena chyba kdy nedošlo k přečtení konfigurace pro S0 vstupy z pevné paměti, už je to ok<br />
* upraven výpočet okamžitého výkonu, aby při nepřipojeném měřiči ukazoval nulu<br />
<br />
== 2.8.2010 ==<br />
* zcela přepracováno webové rozhraní pro měřiče energie<br />
* rozšířené snmp/xml/csv pro měřiče energie<br />
* možnost připojít více samostatnyćh měřičů energie najednou<br />
* vstup pro tarifní rozlišení (denní/noční proud, výroba/dodávka, atd.)<br />
* vylepšený Windows&reg; program pro nahrávání firmware<br />
<br />
== 26.7.2010 ==<br />
<br />
* nový firmware pro převodník Ethernet/Serial<br />
* samostatná stránka ve webovém rozhraní pro zobrazení stavu převodníku Ethernet/Serial<br />
<br />
== 23.7.2010 ==<br />
<br />
* úprava chování pinu RSTD - pokud se zkratuje a zapne se zařízení, je kromě původní funkce (reset konfigurace) spuštěn i bootloader, tzn. bootloader lze odteď pouštět jak z webového rozhraní (původní stav), tak odteď i přes RSTD - toto má výhodu, pokud se nepovede nahrát celý nový firmware, tak lze znovu spustit bootloader a opakovat nahrávání znovu<br />
* drobná oprava v SMTP klientu<br />
* byl vydán nový Windows&reg; program pro nahrávání programů v SDS-C<br />
<br />
== 18.7.2010 ==<br />
<br />
* maximální počet znaků v přihlašovacích údajích pro SMTP je rozšířen na 32 znaků<br />
* drobné opravy ve webovém rozhraní<br />
<br />
== 15.7.2010 ==<br />
<br />
* ošetřena funkčnost SMTP při použití přihlašovacích údajů pro SNMP o maximálním počtu znaků (navíc v budoucnu to bude prodlouženo)<br />
<br />
== 10.7.2010 ==<br />
<br />
* opravy drobností tak jak byly nahlášeny od uživatelů<br />
* tři desetinné místa na ose grafu spotřeby energie<br />
* oprava hodnoty dne u data v grafu spotřeby energie<br />
* doplňky v http serveru, úprava hlavičky pro CSV<br />
* přihlašovací stránka se už zobrazí všude a vždy (předtím někdy neprošlo např. nod32)<br />
* příprava pro centrální sběrný program SDSMON.exe<br />
<br />
== 2.6.2010 ==<br />
<br />
* oficiální verze SDS-C k dispozici<br />
* celá řada nových funkcí, především pro SDS-C<br />
* SMTP - odesílání emailů (z programu SDS-C)<br />
* výstup dat i ve formě CSV souboru (středníkový oddělovač pro Excel&reg;)<br />
<br />
== 17.5.2010 ==<br />
<br />
* opraven výpis LOGu pro IP adresy<br />
* záznam nepovedených přístupů (když to někdo zkouší se špatným heslem)<br />
* drobnosti v http serveru<br />
* graf S0 má místo +1kWh jen +0.1kWh<br />
* oprava detekce EEPROM (aktualizujte FW !)<br />
<br />
== 15.5.2010 ==<br />
<br />
* změna výchozího NTP serveru (default config)<br />
* kratší odpočet při změně NTP serveru<br />
* stránka S0 i z hlavního menu<br />
<br />
== 12.5.2010 ==<br />
<br />
* drobné úpravy<br />
* informace o datové paměti (bude důležité pro SDS-C)<br />
* volba NTP serveru<br />
<br />
== 4.5.2010 ==<br />
<br />
* řada doplňků pro S0 vstup (přepočty, kreslení grafu, xml)<br />
<br />
== 23.4.2010 ==<br />
<br />
* počítáni S0 impulsů (opto 3), speciální webové zobrazení a přepočty<br />
* doplňky v SNMP, doplněný MIB<br />
* nepřipojené teploměry hlásí teplotu 32767<br />
* příprava stránky pro řízení relé pomocí teploměrů<br />
<br />
== 25.1.2010 ==<br />
<br />
* možnost pojmenovat si všechny analogové vstupy<br />
* doplněno: název analogového vstupu lze přečíst přes SNMP<br />
* doplněno: název relátka lze přečíst přes SNMP<br />
<br />
== 15.1.2010 ==<br />
<br />
* opraveno chybějící tlačítko u přihlašovací stránky (šlo pouze stiskem klávesy Enter)<br />
* doplněno chybějící čtvrté nastavovací tlačítko u ADC konstant<br />
<br />
== 11.1.2010 ==<br />
<br />
* opraveno (doplňeno) chybějící záporné znaménko u výpisu teploty (web, SNMP)<br />
<br />
== 31.10.2009 ==<br />
<br />
* navýšení maximálního počtu současně přihlášených uživatelů do webového rozhraní<br />
<br />
== 30.10.2009 ==<br />
<br />
* zvýšení max počtu 1-Wire&reg; teploměrů na 8 kusů na jedné sběrnici<br />
* doplněn výstup SNMP o údaje desetinných hodnot pro všechny teploměry<br />
* doplněno uživatelské nastavení přepočítavacích hodnot pro A/D převod, použité pro zobrazení ve webovém rozhraní a pro xml výstup<br />
* zobrazení sysLocation také v přehledové stránce (actual status)<br />
* možnost pojmenovat si všechny teploměry (16 znaků pro každý)<br />
* možnost pojmenovat si ovládané relé (16 znaků pro každé)<br />
<br />
== 29.10.2009 ==<br />
<br />
* drobnosti před vydáním 30.10.2009<br />
<br />
== 10.10.2009 ==<br />
<br />
* NTP klient - synchronizace času a data protokolem NTP<br />
* nastavení NTP serveru a GMT prostřednictvím "Admin config" webové stránky<br />
* zobrazení NTP času a data v "actual status" webové stránce<br />
* zobrazení času a data v "Log" webové stránce u všech položek<br />
<br />
== 20.09.2009 ==<br />
<br />
* webová stránka "aktuální stav" - upraveno pro správné zobrazování v IE<br />
* v nadpisu webové stránky (tag title) se zobrazuje název zařízení a navíc celý obsah textu ''sysLocation''<br />
<br />
== 07.09.2009 ==<br />
<br />
* 1-Wire&reg; měří na 1/16 stupně Celsia, upraveno časování (větší spolehlivost), lze připojit více čidel<br />
* možnost změny MAC adresy (přímo z webového rozhraní)<br />
* zobrazení informační (potvrzovací) stránky před změnou IP, MAC<br />
<br />
== výchozí firmware ==<br />
<br />
* výchozí firmware</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS-C:_sdsc_sysp&diff=972SDS-C: sdsc sysp2025-11-15T14:22:50Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS. <br />
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).<br />
<br />
== Definice systémových proměnných SDS-C : pole sys[] ==<br />
<br />
Tzv. "systémová proměnná" je prvek v programovacím jazyku SDS-C, který má textový název, a se kterým se dá pracovat - číst hodnotu z proměnné a zapisovat hodnotu do proměnné. Často je čtení a zápis svázáno s fyzickou akcí (např. zápis do konkrétní systémové proměnné změní stav relé).<br />
<br />
SDS-C obsahuje celou řadu vyhrazených, předem pevně definovaných systémových proměnných. Tyto proměnné obsahují aktuální online informace a údaje, vzhledem ke stavu zařízení. Dá se jimi také zařízení (resp. periférie) přímo ovládat. Úplný seznam je právě na této stránce.<br />
<br />
Proměnné poskytované SDS-C a navázané na HW zařízení, jsou označeny jako '''sys[x]''', kde index '''x''' je číslo do 0 do 1023 (popřípadě až do 2048 ale to jen na určitých typech zařízení).<br />
<br />
Tyto proměnné lze číst, popř. do nich zapsat novou hodnotu. To vše můžete provést ve svém SDS-C programu, nebo přes některou z komunikačních funkcí (např. UDP protokolem, nebo přes webové rozhraní).<br />
<br />
<br />
''Legenda k tabulce:''<br />
<br />
Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).<br />
<br />
Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.<br />
<br />
Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW'''). <br />
<br />
Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.<br />
'''Význam hodnot:'''<br />
* '''01''' - první verze, výchozí firmware ze začátku roku 2010<br />
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011<br />
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011 <br />
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější<br />
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější<br />
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější<br />
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější<br />
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější<br />
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější<br />
<br />
Všechny proměnné označené jako rezerva mohou být v budoucích verzích firmware nějak využity. Pokud jsou však pro tuto verzi firmware označeny jako rezerva, pak se nesmí používat (zapisovat do nich, kvůli budoucí kompatibilitě). Při čtení obvykle vrací hodnotu nula, ovšem jakmile budou v novém firmware využity, už budou vracet konkrétní hodnotu.<br />
<br />
Pokud máte starší verzi firmware, je možné, že některé později přidané položky nebudou k dispozici. Řešením je udržovat firmware ve vašem zařízení vždy aktuální.<br />
<br />
Jazyk SDS-C indexuje všechny pole od čísla 0 (nula) - všechna pole, tj. "sys[]", "ram[]", "text[]", začínají se svým obsahem od indexu nula.<br />
<br />
'''Pozor''' však na číslování hardware vstupů a výstupů, ty jsou číslovány dle "elektrikářských" zvyklostí, to znamená že číslování začíná od čísla '''1''' ('''jednička''') - toto ale nemá hlubší vliv na SDS-C.<br />
<br />
Pokud narazíte na takové zařízení SDS, které má ještě velmi starou verzí webového rozhraní, kde byly ještě některé vstupy číslovány od nuly, aktualizujte si toto zařízení aby používalo nejnovější firmware.<br />
<br />
<br />
'''Důležité upozornění'''<br />
<br />
Protože SDS-C ''umí pracovat pouze a jen'' s '''32-bit signed''' integer čísly (tj. 1-bit znaménko a 31-bitů číslo, typ int32_t), tak dochází k (očekávané) konverzi '''32-bit unsigned''' čísel (tj. bez znaménka 32-bitů číslo, typ uint32_t) mezi vnitřními hodnotami v SDS a reprezentací v SDS-C (například když takové unsigned číslo je dotazováno například přes čtení "sys[]" hodnot).<br />
<br />
Jinýmy slovy - uvnitř SDS jsou drženy některé hodnoty jako 32-bit unsigned. Ale protože SDS-C pracuje pouze s 32-bit signed čísly, pak při čtení takových čísel zevnitř SDS jsou tyto čísla prezentovány v SDS-C jako 32-bit signed. Bitově se nezmění, jen se "mění" pohled na to, co který bit znamená, viz text dále.<br />
<br />
''Příklad:'' <br />
Hodnota "sys[625]" reprezentuje "uplynulý čas od posledního zachyceného S0 impulsu na daném S0 vstupu". Tato hodnota je udržována uvnitř SDS a program SDS-C k ní má přístup.<br />
Tento čas je udán v milisekundách a začína na nule, a s každou milisekundou ze zvýší o jedničku. Protože SDS udržuje toto počítadlo (uvnitř své paměti) jako '''32-bit unsigned''', tak jakmile dojde k dopočítání do 31-bitů (tj. 2147483647) a překlopí se tedy 32. bit (tj. na 2147483648), tak SDS-C při čtení "sys[625]" vrátí zápornou hodnotu (tj. -2147483648). Toto je v pořádku - pokud si vypíšete jednotlivé bity, tak budou stále přesně odpovídat, ale tím že SDS-C interpetuje všechny čísla jako '''32-bit signed''', tak vzorovou hodnotu použije a zobrazí jako zápornou.<br />
<br />
<pre><br />
skutečná binární hodnota | 32-bit signed | 32-bit unsigned<br />
(32-bit) | SDS-C integer | (internal SDS)<br />
----------------------------------+---------------+-----------------<br />
00000000000000000000000000000000 | 0 | 0<br />
00000000000000000000000000000001 | 1 | 1<br />
00000000000000001111111111111111 | 65535 | 65535<br />
01111111111111111111111111111111 | 2147483647 | 2147483647<br />
10000000000000000000000000000000 | -2147483648 | 2147483648<br />
10000000000000000000000000000001 | -2147483647 | 2147483649<br />
10000000000000001111111111111111 | -2147418113 | 2147549183<br />
11111111111111111111111111111111 | -1 | 4294967295<br />
11111111111111111111111111111110 | -2 | 4294967294<br />
11111111111111111111111111111101 | -3 | 4294967293<br />
</pre><br />
<br />
Jak lze vidět, SDS vždy (ať ve svém firmware, tak v SDS-C kódu a proměnných) udržuje hodnoty ve stejném ''binárním'' obsahu. Jen interpretace a další práce s čísly je jiná. SDS samo vnitřně pracuje s '''32-bit unsigned''' hodnotami, a díky tomu na webu a všech M2M stránkách můžete vidět hodnoty v rozsahu od 0 do 4294967295. Zato SDS-C pracuje pouze se '''32-bit signed''' hodnotami, a proto stejné číslo je reprezentováno v rozsahu -2147483648 až 2147483647. Toto je vlastnost daná omezením implementace, zkrátka v SDS-C to nelze jinak udělat (pokud to je problém, což ale není, tak můžete přejít na zařízení s FULL-C které tyto omezení nemá).<br />
<br />
To lze snadno ve vašem SDS-C kódu ošetřit, a pokud pouze přenášíte hodnoty z SDS na server (přes HTTP-GET), tak se to dá snadno a ihned zpracovat na serveru "zpět" na '''32-bit unsigned''' hodnotu. Jednoduše na serveru přijmete '''signed''' číslo, a převedete ho například přetypování na '''unsigned''' číslo. Bity v paměti totiž jsou pro oba typy stejné.<br />
<br />
V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''<br />
<br />
<br />
'''Použítí v SDS-C programu'''<br />
<br />
Zápis a čtení z/do systémových proměnných má okamžitý přímý vliv na hardware, se kterým jsou konkrétní proměnné svázány.<br />
<br />
Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)? <br />
<syntaxhighlight lang="c"><br />
teplota0_ve_stupnich_C = sys[310] / 100;<br />
</syntaxhighlight><br />
<br />
Ne vždy je potřeba provádět převody. Pokud např. chcete porovnat dvě hodnoty z různých teplotních čidel, můžete to udělat přímo (bez dělení 100 jako v předchozím příkladu) - samozřejmě toto platí pouze tehdy, pokud porovnáváte hodnoty ve stejných jednotkách:<br />
<syntaxhighlight lang="c"><br />
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };<br />
</syntaxhighlight><br />
<br />
Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):<br />
<syntaxhighlight lang="c"><br />
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)<br />
</syntaxhighlight><br />
<br />
Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:<br />
<syntaxhighlight lang="c"><br />
#define RELE1 sys[231]<br />
<br />
#define TEPLOTA sys[310]<br />
<br />
// ...<br />
<br />
RELE1 = 255;<br />
<br />
if (TEPLOTA > 3200) goto x;<br />
</syntaxhighlight><br />
<br />
<br />
== Pole ram[] ==<br />
<br />
Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).<br />
<br />
Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.<br />
<br />
Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).<br />
<br />
Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:<br />
<syntaxhighlight lang="c"><br />
hodnota = ram[10];<br />
<br />
index = 23;<br />
ram[index] = 15 * 2;<br />
<br />
index = sys[1023];<br />
ram[index] = 30;<br />
</syntaxhighlight><br />
<br />
Pole ram[] je indexováno od indexu nula (tj.: ram[0]). Celková velikost (maximální index) je dán verzí SDS-C a konkrétního firmware v zařízení. <br />
<br />
Verze SDS-C č. 03 má maximální velikost pole ram[] nastavenou na 128 položek. '''Novější verze už mají počet zvýšený ''' - verze č. 06 má velikost ram[] nastavenou na 512 položek (každá o velikosti int32_t).<br />
<br />
Pole ram[] můžete využít k čemukoliv co potřebujete. Také i pro některé SDS-C funkce, jako je ''http_get()'', která může do pole ram[] ukládat obsah textu obdrženého ze serveru (toto chování se nastavuje příslušnými sys[]), nebo při přenosu stránek z/do paměti DF.<br />
<br />
<br />
== Ukládání trvalých dat ==<br />
<br />
Všechny verze SDS-C mají od k dispozi prostor v oblasti sys[100] až sys[115]. Toto je výchozí oblast pro uchovávání trvanlivých dat (tyto údaje se neztratí při výpadku napájení). Přímým zápisem, do těchto sys[] položek, dojde k zápisu do pevné paměti. Čtení se provádí opět přímým přístupem do těchto sys[].<br />
<br />
Od verze SDS-C č. 05 je možno, navíc k tomuto základu, zapisovat a přečíst mnohem větší množství údajů v externím paměťovém chipu DATAFLASH (NVM = Non-Volatile Memory), osazeném na desce zařízení SDS, a to prostřednictvím čtyř SDS-C funkcí.<br />
<br />
Pozn. historické verze zařízení SDS-MICRO LIGHT, kde se používá paměť EEPROM (na místo novější DataFlash), poskytuje vždy pouze základní rozsah indexů: 100 až 115, a neposkytuje rozšířený rozsah pevné paměti (tak jako zařízení s pamětí DataFlash).<br />
<br />
Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].<br />
<br />
Další možnost:<br><br />
Zařízení SDS řady ST mají k dispozici, kromě podpory pro DataFlash, i možnost využít Zálohovanou paměť RAM (ta drží obsah i při vypnutém napájení SDS, pokud je v SDS vložena nabitá zálohovací baterie).<br />
<br />
<br />
== Pole text[] ==<br />
<br />
Od verze SDS-C č. '''06''' je možné v určité míře pracovat s texty. Toto má především využití v komunikaci přes sériovou linku (RS232/RS485) a při odesílání a příjmu dat (email, http) či práci s komunikačními moduly (GSM, LTE, LoRA).<br />
<br />
Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].<br />
<br />
SDS-C je omezený programovací jazyk z hlediska "práce s textem". Pokud potřebujete intenzivně s textem pracovat, použijte zařízení SDS které má FULL-C jazyk.<br />
<br />
I přes omezení SDS-C je možné připojit různé komunikační moduly (GSM, LTE, LoRA), které komunikují prostřednictvím textových příkazů (viz vzorové programy).<br />
<br />
<br />
== Pole share[] ==<br />
<br />
<br />
Od verze SDS-C č. '''08''' je možné použít pole '''share[]''', určené primárně pro sdílení textové informace mezi SDS-C programem a webovým rozhraním (tedy jako [[SDS-C:_sharing|sdílené proměnné]]).<br />
<br />
Práce s polem share[] je prakticky zcela shodná jako práce s polem text[]. Prakticky tak získává programátor dvě nezávislé pole pro uchování textu. Nicméně, některé SDS-C funkce vyhrazeně fungují jen s polem text[], ale to je vždy uvedeno v jejich popisu. <br />
<br />
<br />
== Vyhrazené funkce ==<br />
<br />
Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].<br />
<br />
<br />
== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==<br />
<br />
'''STAV SYSTÉMU'''<br />
<br />
sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)<br />
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program<br />
<br />
sys[1] 01 i R počet přihlášených uživatelů do webového rozhraní (v okamžiku čtení této proměnné)<br />
<br />
sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci<br />
<br />
sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)<br />
- počítá se od nuly (0) od každého zapnutí zařízení<br />
- pouze 31 bitové počítadlo<br />
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně<br />
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule<br />
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času <br />
<br />
sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)<br />
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem<br />
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)<br />
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)<br />
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně, <br />
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
<br />
sys[5] 01 i R rozpad LOCAL času: den (1 až 31)<br />
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)<br />
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)<br />
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)<br />
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)<br />
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)<br />
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)<br />
<br />
'''Upozornění''': hodnota LOCAL času je platná až po úspěšném získání informací z NTP serveru. Po zapnutí (restartu) zařízení je NTP čas (sys[38], sys[4]) nastaven na nulu. Čas je automaticky v SDS aktualizován co jednu sekundu pomocí vnitřních hodin v SDS, a dále je hodnota času pravidelně (v delším intervalu) upřesněna dotazem na NTP server.<br />
<br />
V případě, že není zapnuta automatika DST (letní čas) a GMT offset je nastaven na nulu, tak je hodnota LOCAL času identická s NTP časem (UTC). Jakmile se ale nastaví offset nebo aktivuje posun letního času, už jsou tyto hodnoty odlišné (NTP je UTC, a LOCAL je místní (posunutý) čas). Pro různé použití je potřeba různých časů (často je potřeba UTC pro časové známkování údajů, a zase někdy je vhodný LOCAL pro interakci s uživatelem a pro různé výpisy).<br />
<br />
<br />
== Ethernet, Internet ==<br />
<br />
sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)<br />
sys[13] 01 i R IP[1] adresa zařízení<br />
sys[14] 01 i R IP[2] adresa zařízení<br />
sys[15] 01 i R IP[3] adresa zařízení<br />
<br />
sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)<br />
sys[17] 01 i R GW_IP[1] adresa brány<br />
sys[18] 01 i R GW_IP[2] adresa brány<br />
sys[19] 01 i R GW_IP[3] adresa brány<br />
<br />
sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)<br />
sys[21] 01 i R NETMASK[1] síťová maska<br />
sys[22] 01 i R NETMASK[2] síťová maska<br />
sys[23] 01 i R NETMASK[3] síťová maska<br />
<br />
sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)<br />
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)<br />
!= 0 : Ethernetová komunikace je funkční (LINK OK)<br />
<br />
sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)<br />
== 0 : neznámá rychlost (není k dispozici Ethernet)<br />
== 10 : 10 MBit per sec<br />
== 100 : 100 MBit per sec<br />
<br />
sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)<br />
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)<br />
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti <br />
(po resetu zařízení se vráti na poslední uloženou hodnotu)<br />
<br />
sys[27] 06 i R platnost přidělené IP adresy zařízení SDS<br />
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)<br />
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet<br />
<br />
sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,<br />
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)<br />
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik<br />
<br />
sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)<br />
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)<br />
== 1 : odesláno DHCP DISCOVER<br />
== 2 : obdrženo DHCP OFFER<br />
== 3 : odesláno DHCP REQUEST<br />
== 4 : obdrženo DHCP ACK<br />
== 5 : IP adresa je přidělena (BOUND)<br />
== 6,7,8,9,10,11 : zpracování DHCP RENEW<br />
<br />
sys[30] 06 i R aktuální hodnota "DHCP Lease Time"<br />
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)<br />
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)<br />
- údaj je uveden v jednotkách [sec]<br />
<br />
sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)<br />
sys[32] 04 i R MAC[1] <br />
sys[33] 04 i R MAC[2] <br />
sys[34] 04 i R MAC[3] <br />
sys[35] 04 i R MAC[4] <br />
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)<br />
<br />
sys[37] 06 i R NTP Client Status (synchronizace času)<br />
== 0 : nesynchronizováno<br />
== 1 : úspěšně přijal paket od NTP Serveru<br />
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz <br />
(dotaz se odešle za 10sec od takovéhoto zápisu)<br />
<br />
sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)<br />
- není zde aplikován offset, ani automatika letního času<br />
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď), <br />
uvnitř SDS je sice udržována jako 32bit, <br />
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).<br />
<br />
sys[39] 07 i R stav automatiky přepínání Letního Času<br />
== 0 : automatika zakázána, lokální čas není ovlivněn<br />
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").<br />
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").<br />
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).<br />
09 i W pouze pro případ vypnutého NTP: ruční ovládání automatiky (tzn. povolena nebo nepovolena) (SELČ pak automatika sama rozhodne, je-li povolena)<br />
zápis 0 : vypnout automatiku (nebude pracovat = nebude aplikoval posun pro SELČ pro nastavený rozsah v roce), sys[39] pak vrátí 0 při čtení<br />
zapis 3 : zapnout automatiku (automatika aplikuje posun pro SELČ podle toho jaký je aktuální čas a datum), sys[39] pak vrátí 1 nebo 2 dle stavu <br />
<br />
sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)<br />
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)<br />
<br />
sys[139] 09 i R vyhrazeno<br />
<br />
Princip funkce automatiky letního času je popsán jinde na této wiki. Funkce automatiky je samozřejmě volitelná (viz: ruční nastavení ve webovém rozhraní).<br />
<br />
sys[40] až sys[44] RESERVED vyhrazeno<br />
<br />
<br />
== Provozní údaje ==<br />
<br />
sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)<br />
- po resetu zařízení začíná vždy počítat od nuly<br />
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);<br />
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!<br />
- pro sys[45] je k dispozici 31 bitů,<br />
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru<br />
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).<br />
<br />
sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),<br />
význam hodnot závisí na typu konkrétního zařízení SDS. <br />
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.<br />
<br />
SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM): <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]<br />
<br />
SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST: <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]<br />
<br />
Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.<br />
<br />
sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu <br />
(při přetečení 2^31 počítá opět od nuly, pořád dokola)<br />
<br />
Hodnota v indexu 137 je nejjemnější možný "časovač", dostupný pro program. Délka kroku jednotky odpovídá frekvenci jádra (ta je různá pro jednotlivá SDS, pro řadu ST typicky 120MHz, tedy 1 krok je 8.3nsec). <br />
Tento index vyžaduje aktuální FW (11/2022 nebo novější).<br />
<br />
<br />
== Rozhraní sériové komunikace ==<br />
<br />
SDS-C poskytuje přístup k sériovému rozhraní COM1 a COM6. Pouze rozhraní COM1 je také současně přístupno přes převodník Eth/UART (VCP). Program v SDS-C může přistupovat jak ke COM1, tak ke COM6.<br />
<br />
Pomocí SDS-C lze zapisovat do sériového rozhraní, a číst data ze sériového rozhraní. Data, přicházející z venku do zařízení SDS, jsou ukládána do příslušného bufferu (RX FIFO), takže lze pomocí SDS-C programu číst i pomaleji, než je rychlost příchozích dat. Buffery jsou malé (zhruba 1kB), proto je potřeba data zpracovávat rychle a včas, ať nedojde k jejich ztrátě.<br />
<br />
Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše. <br />
Poznámka: UART buffery (pro obě sériové rozhraní) jsou neustále aktivní a příjem dat z UARTu probíhá po celou dobu zapnutí zařízení.<br />
<br />
Rozhraní COM1:<br />
<br />
sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1<br />
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici), <br />
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není ! <br />
(Toto může způsobit nezkušenému programátorovi potíže). <br />
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné, <br />
a s tou pak dále dle libosti pracovat.<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!<br />
<br />
sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?<br />
== 0 : není připojen klient<br />
!= 0 : je připojen klient (přes TELNET port)<br />
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)<br />
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)<br />
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Poznámka: parametry sériového rozhraní UART COM1 lze nastavit v rámci převodníku Ethernet/UART (přes RFC příkazy), nebo pomocí k tomu určené SDS-C funkce. Pozor, nastavení '''nelze''' změnit přímým zápisem hodnoty do sys[50] až sys[54] (ty jsou pouze pro čtení).<br />
<br />
Rozhraní COM6:<br />
<br />
sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6<br />
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
sys[57] 02 i R rychlost [bps] rozhraní UART - COM6 <br />
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)<br />
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Rozhraní UART - COM6 je k dispozici jen na SDS-MINI, SDS-MICRO-ST a SDS-MACRO-ST, a je přístupné jen z SDS-C programu.<br />
<br />
Doplňující statistiky (počty rx/tx bajtů atd.) jsou k dispozici na indexu 2800+, viz dále na této stránce (dostupnost těchto údajů je závislá na instalovaném aktuálním FW ve vašem SDS).<br />
<br />
<br />
== Generátor náhodných čísel ==<br />
<br />
sys[61] 06 i R generátor náhodných čísel<br />
- při každém přečtení sys[61] je poskytnuto náhodné číslo<br />
<br />
<br />
== Výsledek převodu textu na číslo ==<br />
<br />
Pro převod textu (z určené pozice pole ''text'' či ''share'') na číslo se používá funkce SDS-C: ''atoi''. Aby bylo možné výsledek převodu získat, musíte si jej přečíst ze ''sys[62]''.<br />
<br />
sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''<br />
<br />
Pro více informací se podívejte přímo na návod k této funkci.<br />
<br />
<br />
== Nastavení rychlosti provádění SDS-C programu ==<br />
<br />
SDS-C program může ovlivnit rychlost svého vykonávání. Buď se každá instrukce provede právě s minimálním krokem co 1 msec, nebo se dá tato (často žádoucí) vlastnost snadno vypnout. Pozor, hodnota 1 msec není vždy garantována, např. při zavolání funkce která pracuje s pomalou periférií dojde k čekání, dokud se požadovaná funkce nedokončí.<br />
<br />
sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:<br />
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''<br />
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku) <br />
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )<br />
<br />
Poznámka: všechny SDS-C programy jsou ve výchozím stavu spouštěny se sys[63] = '''0''' (tzn. jeden celý příkaz programu je vykonán právě co 1 msec).<br />
<br />
Tohoto faktu (krok 1 msec) některé programy využívají k realizaci čekacích smyček, když se předpokládá jeden vykonaný příkaz za 1 msec. Není to však vhodné, protože SDS nedává garanci že se vždy bude jednat přesně o 1 msec (může docházet k náhodnému zdržení až o několik msec, v záležitosti na ostatní činnost systému). Pokud však vypnete toto rychlostní omezení, tak takové případné čekací smyčky přestanou plnit svou funkci (prakticky skončí mnohem dříve): proto ve svých programech používejte pouze k realizaci "čekání" pouze k tomu určené funkce, nebo případně sys[64] nebo některý z UpTime indexů či sys[137] atd.<br />
<br />
<br />
== Časování ==<br />
<br />
Pro přesnější časování programu, popř. pro spuštění nějaké události po přesně daném intervalu, lze s výhodou využít následující proměnnou:<br />
<br />
sys[64] 01 i RW sekundový odpočítávač <br />
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1, <br />
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)<br />
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)<br />
<br />
Samozřejmě lze využít i jiné způsoby, ale tento je k tomu explicitně určen, vyhovuje-li hrubý krok 1 sekunda. Pro jemnější časování jsou pak vhodnější indexy s UpTime hodnotou, nebo sys[137] pro nejvíce jemné čekání - tyto indexy ale nemají funkci odpočítávání (jsou jen pro čtení), takže hlídání obsahu si už musíte řešit sami ve svém programu.<br />
<br />
<br />
== OSI7 funkce ==<br />
<br />
OSI7 funkce jsou určeny pro komunikaci mezi SDS a vnějším světem připojeným přes Ethernet (např. se servery v Internetu).<br />
<br />
Všechny funkce OSI7 poskytují průběžný stav své činnosti:<br />
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)<br />
- význam hodnot viz [[OSI7_status_code|popis zde]]<br />
<br />
Poznámka: vždy je doporučeno, po zavolání kterékoliv OSI7 funkce, provést v programu čekání na skončení této funkce. Čekání má kontrolovat právě hodnotu v sys[65], a dokud se tato proměnná nenaplní výsledkem, nevolejte další OSI7 funkci.<br />
<br />
DNS resolv: sestavením IP[0].IP[1].IP[2].IP[3] získáte IP adresu (napr. 10.0.0.8) z DNS po úspěšném návratu z funkce DNS resolveru. Tato získaná IP adresa pak může sloužit pro různé účely, např. pro kontrolu DNS serveru jestli žije atd.<br />
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
<br />
Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).<br />
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)<br />
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru<br />
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru<br />
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru<br />
<br />
sys[74] 01 s R text, reserved (v této verzi nepoužito)<br />
<br />
Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):<br />
<br />
sys[303] 09 i R DNS RESOLV - (read:) actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
sys[303] 09 i W DNS RESOLV - write value 0xD65 (3429dec) to clear the DNS cache<br />
sys[304] 09 i R DNS RESOLV - (read:) timestamp (UTC) of the latest DNS server response (packet) as requested by dns_resolv() function (if 0 then no response received, or cache has expired)<br />
sys[305] 09 i R DNS RESOLV - (read:) get the last set hard TTL limit (0 = invalid (will use 1209600 as default), otherwise 1..MAX = time in seconds)<br />
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)<br />
<br />
<br />
HTTP GET:<br />
<br />
sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)<br />
- nastaveno po dokončení práce funkce '''http_get()'''<br />
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.<br />
<br />
sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')<br />
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',<br />
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.<br />
<br />
sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek<br />
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu. <br />
Nastavte na:<br />
<br />
== 0 : jakékoliv přijaté data jsou '''zahozena''', <br />
neuloží se (nedojde ke změně obsahu ram[] nebo text[])<br />
<br />
== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole ram[] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !<br />
<br />
sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi<br />
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])<br />
- maximální hodnota je omezena velikostí pole ram[] nebo text[]<br />
- pozor! pokud zapíšete '''0''', budou všechna data zahozena, <br />
ale i v takovém případě dojde k přepisu ram[0] (viz výše)<br />
<br />
sys[79] až sys[80] RESERVED vyhrazeno<br />
<br />
Pozor, v případě nenulového sys[77] HTTP klient čeká tak dlouho, dokud nedostane všech sys[78] bajtů odpovědi z protistrany. To je častou příčinou "problémů" kdy protistrana neodpoví dostatečně dlouhou odpovědí, a klient má stále otevřené spojení a stále čeká a čeká... až dojde na timeout. Což je pak potřeba důsledně a správně ošetřit ve vašem SDS-C programu.<br />
<br />
Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):<br />
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')<br />
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru<br />
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru<br />
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru<br />
<br />
sys[85] až sys[88] RESERVED vyhrazeno<br />
<br />
Informace z ('''interní''') ICMP PING funkcionality "IP Watchdog" (konfigurace a ovládání přes webové rozhraní SDS) (nemá souvislost s SDS-C funkcí "ping()" ) :<br />
<br />
sys[89] 06 i R IP-Watchdog: stav<br />
== 0 : není v provozu (neaktivováno ve webovém rozhraní)<br />
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)<br />
<br />
sys[90] 06 i R IP-Watchdog: poslední známé RTT<br />
== 0 .. 65533 : hodnota RTT v msec<br />
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)<br />
<br />
sys[91] 06 i R IP-Watchdog: stav výstupu<br />
== 0 : výstup není aktivován<br />
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)<br />
<br />
Informace z (SDC-C) ICMP PING funkce - '''ping()''' :<br />
<br />
sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92] <br />
== 0 : klid (není odeslán paket, nečekám na odpověď), <br />
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle<br />
== 1 : funkce '''ping()''' byla právě zavolána, <br />
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání<br />
== 2 : čeká se na odpověď od ARP <br />
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket, <br />
protože v ARP tabulce nebyl příslušný záznam)<br />
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY <br />
(požadovaný stav, funkce '''ping()''' funguje ok)<br />
== 8 : právě obdržel ECHO REPLY <br />
(byla přijata odpověď od vzdáleného zařízení)<br />
<br />
sys[93] 04 i R PING SEQ number <br />
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE <br />
na ICMP PING REQUEST odeslaný funkcí '''ping()'''<br />
<br />
sys[94] 04 i R Round Trip Time, v milisekundách<br />
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''<br />
- čas je zvyšován po pěti milisekundách (údaj v sys[94] je přímo v msec, např. hodnota 55 znamená 55 msec)<br />
<br />
Pozn.: ICMP Quench (32bit) je sestaven z "identifier" (16bit) a z "sequence number". Pomocí sys[93] můžete nastavit '''číslo sekvence''' na libovolnou hodnotu, přičemž hodnota "identifier" je napevno nastavena na "'''0x0280'''" .<br />
<br />
<br />
Funkce '''send_udp()''':<br />
<br />
sys[95] 06 i R výsledek posledního volání '''send_udp()'''<br />
Hodnoty:<br />
== 0 : nic neprovedeno<br />
Hodnota '''0''' je nastavena po startu SDS-C programu<br />
== 1 : právě bylo zahájeno odesílání paketu (provádí se)<br />
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.<br />
== 2 : byl odeslán UDP paket, úspěšně<br />
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu<br />
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz <br />
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP <br />
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz<br />
== 4 : zavolali jste funkci '''send_udp()''' dříve, <br />
než byla dokočena činnost předchozího požadavku <br />
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)<br />
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)<br />
<br />
<br />
Funkce '''snmp_send_trap()''':<br />
<br />
sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''<br />
Hodnoty:<br />
== 0 : odesílání neprobíhá<br />
== 1 : probíhá odesílání, výsledek ještě není znám<br />
== 2 : odeslání se povedlo <br />
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)<br />
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)<br />
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)<br />
<br />
sys[97] RESERVED vyhrazeno<br />
<br />
<br />
== Zápis textu do pole, Porovnání textů ==<br />
<br />
Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.<br />
<br />
sys[98] i R společné využití viz (1) a (2)<br />
<br />
06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,<br />
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'', <br />
což je hodnota užitečná pro navázání textu (zápis více textů přesně za sebou), popř. určení délky posledního zápisu:<br />
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''<br />
- kam byla zapsána terminační 0x00 funkcí '''itoh()''' <br />
- kam byla zapsána terminační 0x00 funkcí '''itoa()''' <br />
<br />
08 i R (2) výsledek porovnání textů<br />
- hodnota výsledku zavolání funkce '''textcmp()'''<br />
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci<br />
X == 0 : oba texty jsou identické<br />
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''<br />
<br />
Význam "nižší vlastní hodnoty": znak 'a' má nižší hodnotu než 'b', a to o 1; nebo např. '1' má nižší hodnotu než '4' a to o 3.<br />
<br />
Doporučeno je si to vše vyzkoušet (zavolat si každou uvedenout funkci a srovnat hodnotu v sys[98] s obsahem pole ''text[]'').<br />
<br />
<br />
== Uživatelské pozice v pevné paměti == <br />
<br />
sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]<br />
<br />
sys[100] až sys[115] <br />
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,<br />
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),<br />
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF <br />
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !<br />
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti <br />
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti <br />
<br />
Paměť EEPROM a paměť DATAFLASH (podle verze HW který máte) je permanentní (NVM), tzn. její obsah zůstane i po vypnutí zařízení nezměněn (na rozdíl od <u>ne</u>zálohované paměti RAM, do které se přistupuje pomocí pole ''ram[]'').<br />
<br />
''' Reserved '''<br />
<br />
sys[116] až sys[136] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné nastavitelné uživatelem z webového rozhraní ==<br />
<br />
Pomocí "uživatelských proměnných" (někdy taky "sdílených proměnných") lze snadno ovlivnit chod vašeho SDS-C programu, ale jen tak, jak si do něj sami naprogramujete - uživatelské proměnné neovlivňují samotný program, ale program je může číst a následně zpracovat.<br />
<br />
sys[140] až sys[149] <br />
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)<br />
(vždy 32-bit signed integer)<br />
<br />
sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu<br />
Nastavení:<br />
== 0 : stránka "control" je přístupná bez hesla, <br />
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)<br />
<br />
Uživatel, který má přístup k webové stránce, může zapsat nový obsah do těchto osmi proměnných (změnit jejich hodnotu), kdykoliv chce. Dvě doplňkové proměnné nejsou na výchozí webové stránce dostupné, ale jinak s nimi lze bez jiných omezení pracovat (SDS-C, M2M).<br />
<br />
Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.<br />
<br />
Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).<br />
<br />
Samozřejmě lze využít i přímého URL pro zápis do proměnných, což je výhodné např. při vzájemné komunikaci dvou zařízení.<br />
<br />
<br />
== Proměnné vstupů a výstupů pro všechny výrobky SDS ==<br />
<br />
'''POZOR'''<br />
<br />
'''Podle HW verze výrobku, jsou dostupné jen určité vstupy a výstupy.''' Zde je uveden plný seznam pro maximální konfiguraci, ale ne všechny HW verze mají všechno. Např. SDS-MICRO-LM má pouze dva reléové výstupy, kdežto SDS-MACRO-LM má čtyři.<br />
<br />
Vždy máme vyhrazeno 32 indexů pro vstupy a výstupy. Tyto indexy jsou tedy naplánovány pro (budoucí) maximální konfiguraci, ale většina SDS k nim nemá odpovídající HW (např. nemá všech 32 relé). Zápis a čtení do/z indexů, které nemají odpovídající fyzický protějšek, je zakázán (bude SDS ignorován, a hodnota nebude uložena pro pozdější čtení).<br />
<br />
'''Pokračování výpisu:'''<br />
<br />
sys[151] až sys[182] <br />
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)<br />
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)<br />
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu<br />
Hodnoty:<br />
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)<br />
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)<br />
<br />
Pozor, pokud u vašeho SDS (např. historické kousky SDS-MICRO-LIGHT) má číslované OPTO vstupy od nuly (né od jedničky), musíte si aktualizovate firmware v tomto zařízení, a případně upravit potisk (popis) na desce nebo krabičce.<br />
<br />
'''Důležité info:'''<br />
<br />
Pokud je (uvnitŘ SDS) na LED vstupního optočlenu signál, hodnota '''sys[]''' pro dané OPTOx dává '''0''' (nulu), naopak při nepřítomnosti signálu je přítomna '''nenulová''' hodnota (vždy testujte na nulovou a nenulovou hodnotu, jediné co je zaručeno je totiž ta nula, kdežto nenulová hodnotu může být jakákoliv - ve skutečnosti každý opto vstup má přidělenou konstantu, podle které lze tento vstup identifikovat). <br />
<br />
Pozor - "logika" optických vstupů je tedy na první pohled "obrácená" (avšak dává to přesný smysl). Jen je to potřeba vědět při psaní SDS-C programu.<br />
<br />
<br />
== Stav SDS-C programu ==<br />
<br />
Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).<br />
<br />
sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu<br />
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)<br />
<br />
Příklad: FW v SDS je (pro příklad) ze dne 24.12.2018, takže v ''sys[183]'' bude zakódováno jako 0x00180C12, tedy hodnoty 24dec 12dec 18dec zapsány jako 0x18 0x0C 0x12, což je 0x18C0C12 což je 1575954dec.<br />
<br />
Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:<br />
<br />
sys[184] 08 i RW způsob spuštění SDS-C programu<br />
== 0 : bez informace<br />
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS<br />
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)<br />
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace<br />
<br />
Stav SDS-C watchdogu:<br />
<br />
sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec<br />
== -1 : wdg není aktivní<br />
== 0 : odpočet vypršel, dojde k resetu SDS-C programu<br />
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)<br />
<br />
<br />
== Pulse-Width Modulation výstupy ==<br />
<br />
Některá SDS mají pouze jeden PWM výstup (PWM1), některá mají čtyři výstupy (rozdělené po dvou do dvou skupin: PWM1 a PWM2, pak PWM3 a PWM4).<br />
<br />
''Příklad pro PWM1:'' Konfigurace PWM1 výstupu nejprve vyžaduje zápis do sys[191], aby se nejprve nastavila provozní základní frekvence generátoru.<br />
Následně lze PWM1 výstup řídit zápisem do sys[192], kdy se podle zapsané hodnoty nastaví střída PWM výstupu (poměr log0 a log1).<br />
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.<br />
Zápis do sys[191] je potřeba jen jednou (tedy jen tehdy, když je potřeba PWM1 výstup zapnout nebo vypnout, a kdy je potřeba změnit frekvenci generátoru). <br />
Zápisy do sys[192] a nebo sys[193] se pak mohou dít samostatně (tj. není potřeba pokaždé opakovat zápis do sys[191]).<br />
<br />
Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !<br />
<br />
Pozor, pro tyto typy SDS:<br />
<br />
SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO''' <br />
<br />
Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).<br />
<br />
<br />
Podle typu SDS:<br />
<br />
SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)<br />
<br />
sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).<br />
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)<br />
<br />
sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)<br />
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).<br />
<br />
sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru <br />
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]<br />
- tato hodnota není aktualizována vůči sys[192], ani není archivována<br />
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.<br />
<br />
Hodnoty Fm větší než 1MHz prakticky nemají smysl, snažte se navrhnout svůj systém tak, aby dokázal pracovat ideálně nejvýše ve stovkách kHz.<br />
<br />
<br />
Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.<br />
<br />
SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)<br />
<br />
sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[192] až sys[195])<br />
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)<br />
<br />
sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)<br />
<br />
sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)<br />
<br />
sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[187] až sys[190])<br />
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[187] 09 i RW duty-cycle '''PWM3''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)<br />
<br />
sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[189] 09 i RW duty-cycle '''PWM4''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)<br />
<br />
sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.<br />
<br />
<br />
== Ovládání výstupů - Relé ==<br />
<br />
Zápisem do následujících systémových proměnných přímo ovládáte fyzické relé (výstupy) zařízení SDS. Pozor, protože hodnoty zapsané z SDS-C programu se záměrně neukládají do pevné paměti (tzn. nejsou načteny po resetu zařízení SDS). Je to z důvodu bezpečnosti (aby se např. neseplo relé po dlouhém výpadku napájení). Váš program si s tím musí umět poradit - vždy po zapnutí SDS musí vyhodnotit aktuální situaci a až podle toho zapínat relé.<br />
<br />
sys[196] až sys[228] <br />
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''<br />
- lze nastavit i z webového rozhraní<br />
Hodnoty:<br />
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)<br />
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)<br />
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)<br />
<br />
sys[229] až sys[230] RESERVED vyhrazeno<br />
<br />
sys[231] až sys[262] <br />
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)<br />
Hodnoty:<br />
== 0 : relé není aktivní <br />
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)<br />
!= 0 : relé je aktivní <br />
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)<br />
<br />
sys[263] až sys[265] RESERVED vyhrazeno<br />
<br />
sys[266] až sys[298] <br />
01 s R uživatelský textový název pro '''RE1''' až '''RE32''' <br />
- nastaveno ve webovém rozhraní<br />
<br />
sys[264] až sys[300] RESERVED vyhrazeno<br />
<br />
<br />
== Ovládání PDx ==<br />
<br />
Jednotlivé moduly SDS mají k dispozici dodatečné vstupy a výstupy, označené jako PDx respektive TOPB. Přesný seznam viz návod ke konkrétním modulům.<br />
<br />
Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):<br />
<br />
sys[301] 01 i RW SDS '''MICRO LM LIGHT''': stav i/o pinu D0 (0 = log0 ; nenulová hodnota v sys = log1 přítomna na pinu)<br />
SDS '''MICRO LM DIN''' a SDS '''MACRO LM''': stav výstupu D0 - MOSFET spínač na GND. Při jakékoliv nenulové hodnotě v sys[301] je MOSFET sepnutý (=D0 na GND), jinak je D0 otevřený (HiZ)<br />
SDS '''TTCPRO''': stav všech osmi pinů v portu PDx (nastavením/čtením sys[301] se přistupuje k jednotlivých osmi bitům v bajtu, kde: bit0=PD0 až bit7=PD7)<br />
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = stav PD0 MOSFET spínače (spíná na GND), bit1 = stav i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''IO6-ST''': nepoužito<br />
SDS '''MACRO-ST''': bit0 = stav PD0, bit1 = stav PD1, bit2 = stav i/o pinu TOPB, bit3 = TL-1, bit4 = stav TL-2, ostatní bity (5..7) nepoužity<br />
<br />
Řízení směru pro jednotlivé PDx resp. TOPB:<br />
<br />
sys[302] 06 i RW SDS '''MICRO LM LIGHT''': směr i/o pinu D0 (zápisem bit0 do 1 se nastaví pin D0 jako výstup) (zápisem log1 se nastaví jako vstup)<br />
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)<br />
SDS '''TTCPRO''': směr jednotlivých pinů v portu PDx (nastavením jednotlivých osmi bitů, bit0=PD0 až bit7=PD7, nastav log1 pro výstup)<br />
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = vždy v log1 (PD0 jako výstup), bit1 = směr i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''MACRO-ST''': bit0 = vždy v log1 (výstup), bit1 = vždy v log1 (výstup), bit2 = směr i/o pinu TOPB, bit3 = vždy v log0 (vstup), bit4 = vždy v log0 (vstup), ostatní bity (5..7) nepoužity<br />
<br />
TOPB: vždy typicky CMOS 3V3 pin, s možností funkce jako vstup nebo výstup (dle sys[302]), a je přímo připojený na pin SoC, pozor tedy na jeho další HW připojení.<br />
<br />
TTCPRO: Mapování je vždy od nejnižšího (LSB - bit0) bitu (PD0 = bit0, PD1 = bit1, atd. PD7 = bit7). Pro TTCPRO jsou PDx jako CMOS 3V3 piny s volbou vstupu nebo výstupu pro každý jednotlivý pin.<br />
<br />
MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).<br />
<br />
sys[306] až sys[309] RESERVED vyhrazeno<br />
<br />
== Tlačítka na desce display pro SDS-MACRO-ST ==<br />
<br />
Čtení stavu tlačítek na desce display (SDS-MST-DISP-rev1) se provádí čtením sys[301] a vyhodnocením bitu 3 (=8dec, první tlačítko) a/nebo bitu 4 (=16dec, druhé tlačítko).<br />
<br />
Ošetření na případné zákmity při stisku a uvolnění tlačítek, je potřeba provést ve vašem SDS-C programu.<br />
<br />
<br />
== Vstupy - teploměry na externí sběrnici 1-Wire&reg; ==<br />
<br />
Čidla teploty (1-W chipy pro měření teploty připojené na sběrnici; tak také údaj o teplotě z připojených modulů SDS-1W-T-RH) jsou řízena (čtena) plně automaticky zařízením SDS. Program v SDS-C má přímo přístup k výsledným hodnotám teplot.<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici<br />
<br />
Teploměry mají hodnotu uloženou v násobku '''100''' (takže např. 24.5°C je uloženo jako číslo 2450, nebo -120.65°C je -12065). Pokud není k dispozici hodnota z čidla, '''není v záznamu číslo nula (pozor !), ale záměrně tam je číslo 16777216 (2^24)'''.<br />
<br />
Pozn.: pouze SDS-MACRO-LM a SDS-MACRO-ST mají teploměry č. 17 až 32, protože má dvě samostatné sběrnice (konektory). Sběrnice A má teploměry 1 až 16, sběrnice B má teploměry 17 až 32. '''Sběrnice B je k dispozici jen pro SDS-MACRO-XX'''.<br />
<br />
sys[342] až [345] RESERVED vyhrazeno<br />
<br />
sys[346] 01 i R číslo čidla, které je právě převáděno na sběrnici '''B''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''<br />
<br />
sys[348] 01 i R číslo čidla, které je právě převáděno na sběrnici '''A''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''<br />
<br />
sys[350] až sys[381] <br />
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]<br />
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)<br />
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek<br />
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)<br />
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)<br />
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)<br />
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)<br />
<br />
sys[382] až [389] RESERVED vyhrazeno<br />
<br />
sys[391] až sys[422] <br />
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)<br />
<br />
''' Reserved ''' <br />
<br />
sys[423] až sys[430] RESERVED vyhrazeno<br />
<br />
<br />
== Vstupy: analogové vstupy pro měření napětí ==<br />
<br />
Všechny vstupy měří napětí vůči společné svorce (GND). Změřená hodnota je vždy k dispozici nejprve jako surová (raw) digitální hodnota, a poté ji SDS přepočítá dle uživatelského nastavení a také dá k dispozici.<br />
<br />
sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1<br />
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2<br />
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3<br />
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4<br />
<br />
RAW (surová) hodnota je digitální číslo, poskytnuté z interního A/D převodníku, s tím, že mu už SDS současně (pouze a jenom) odečetl uživatelem nastavený offset.<br />
<br />
Rozsah hodnoty RAW je: <br />
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)<br />
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)<br />
<br />
Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):<br />
<br />
sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[436] 01 i R Div pro A/D 1<br />
sys[437] 01 s R textový název A/D 1<br />
sys[438] 01 s R jednotka A/D 1<br />
<br />
sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[440] 01 i R Div pro A/D 2<br />
sys[441] 01 s R textový název A/D 2<br />
sys[442] 01 s R jednotka A/D 2<br />
<br />
sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[444] 01 i R Div pro A/D 3<br />
sys[445] 01 s R textový název A/D 3<br />
sys[446] 01 s R jednotka A/D 3<br />
<br />
sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[448] 01 i R Div pro A/D 4<br />
sys[449] 01 s R textový název A/D 4<br />
sys[450] 01 s R jednotka A/D 4<br />
<br />
'''Pozor!''' Hodnoty pro jednotlivé A/D vstupy (tj. Raw Hodnoty v sys[431 až 434]) '''už mají odečtený Offset''' (je to provedeno uvnitř firmware už při zpracovávání A/D převodu) ! <br />
Proto Offset už ve svém SDS-C programu z Raw hodnot neodečítejte (bylo by to odečítáno podruhé). Pro přepočet z Raw na finální hodnotu vám zbývá (správně) použít jen "Div".<br />
<br />
Poznámka: zařízení SDS-MINI (a další z řady SDS ST) už mohou mít text v položce "jednotka A/D x" delší než jeden znak (na rozdíl od původního SDS-MICRO-LM atd., kde to bylo omezeno na jeden jediný znak).<br />
<br />
''' Reserved '''<br />
<br />
sys[451] až sys[458] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné pro S0 impulsní vstup ==<br />
<br />
sys[459] 01 i RW stav tarifu <br />
== 0 : T0 (vysoký tarif)<br />
== 1 : T1 (nízký tarif)<br />
<br />
sys[460] až sys[492] <br />
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],<br />
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )<br />
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60<br />
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh<br />
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty, <br />
pak sem v takovém případě nastavte číslo 1<br />
- platné hodnoty: 1 až 65280 (včetně)<br />
<br />
sys[493] až sys[525] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[526] až sys[558] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[559] až sys[591] <br />
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)<br />
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD<br />
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající<br />
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).<br />
<br />
sys[592] až sys[624] <br />
01 i R změřená časová vzdálenost mezi dvěmi nejposlednějšími zachycenými impulsy na S0 vstupu (aktuální impuls a předchozí impuls)<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
sys[625] až sys[657] <br />
01 i R změřený čas od úplně posledního impulsu zachyceného na S0 vstupu, tzn. "doba bez impulsu" nebo také "doba od posledního impulsu"<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
poznámka: tarif T0 a tarif T1 závisí na uživatelem zvoleném externím signálu (přeneseno do sys[459]), viz informace na stránce ohledně [[S0]]. Celková hodnota impulsů je samozřejmě součtem těchto dvou impulsních akumulátorů. Pokud není tarifní rozlišení využito, je vše zapisováno do akumulátoru pro T0. <br />
<br />
poznámka: časová vzdálenost mezi impulsy se používá pro výpočet aktuálního výkonu (popř. průtoku atd. dle použitého měřiče) - můžete toho využít ve svém SDS-C programu.<br />
<br />
poznámka: "Poměr MTD" zahrnuje všechny měřící transformátory (MTD), předřazené elektroměru (pouze pokud to už není započítáno v impulsní konstantě). Pokud je S0 vstup využit pro jiný typ měřiče (vodoměr a podobné), kde je připojení MTD nesmysl, tak se v konfiguraci musí do této položky nastavit hodnota 1. Samozřejmě jde s určitou výhodou použít i jinou konfiguraci, protože tato hodnota je použita jako "druhý dělitel" u výpočtu počtu S0 impulsů na velikost kroku energetické jednotky. Určení této hodnoty pro jiné měřiče sleduje stejné matematické postupy jako určení této hodnoty pro elektroměr s předřazeným MTD, jen jednotky budou samozřejmě jiné.<br />
<br />
sys[658] až sys[670] reserved for future use<br />
<br />
poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).<br />
<br />
<br />
== Speciální vstupy a výstupy ==<br />
<br />
Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.<br />
<br />
'''Pouze pro SDS MICRO (LM) LIGHT:'''<br />
<br />
sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
<br />
Tyto zmíněné čtyři ''sys[]'' jsou dostupné '''pouze''' na modulu SDS MICRO '''LIGHT''' popř. '''DIN''', a to jen s verzí firmware 9.1.2011 nebo novější.<br />
<br />
SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.<br />
<br />
SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MACRO LM, SDS MICRO ST, SDS MACRO ST, SDS UPS, SDS IO6, SDS IO6 ST, SDS TTCPRO, SDS MINI: tyto výstupy '''nejsou k dispozici'''.<br />
<br />
Vše to jsou logické výstupy, s CMOS 3V3 logickými úrovněmi (pro obecné použití je externí pull-up 47kOhm nutný). Lze to použít především pro ovládání BSS138 MOSFETů, např. pro spínání dalších relé (v případě použití BSS138 nedávejte externí pull-up, ale naopak dejte pull-down na GND o hodnotě 47kOhm).<br />
<br />
'''Pouze pro SDS MACRO ST:'''<br />
<br />
Alternativa k sys[301]. Hodnota odpovídá logické úrovni na daném vstupu TL1 (TL2). Při osazené desce MACRO-ST-LCD jsou na tyto vstupy připojeny tlačítka (pak při stisku TL1, TL2 je zde hodnota 0, v klidu 1).<br />
<br />
sys[671] 02 i R čtení stavu TL1<br />
sys[672] 02 i R čtení stavu TL2<br />
<br />
'''Pájecí plošky CFG:'''<br />
<br />
Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.<br />
<br />
V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.<br />
Ploška CFG1 je vyhrazena pro vnitřní použítí samotného firmware SDS, a ploška CFG2 bude eventuálně uvolněna pro libovolné použití uživatelem (čtení z SDS-C).<br />
Takový firmware se teprve chystá (SDS TTCPRO).<br />
<br />
sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)<br />
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)<br />
<br />
<br />
== Speciální proměnné pro SDS-UPS ==<br />
<br />
SDS UPS nabízí, kromě již zmíněných proměnných (viz výpis výše), i doplňkové proměnné, specifické pro tento výrobek. Tyto rozšířené systémové proměnné jsou k dispozici ve firmware od 25.4.2011 .<br />
<br />
SDS-UPS má všechny sys[0] až sys[699] shodné s SDS-MICRO. Rozdíl je samozřejmě v počtu a osazení periférií.<br />
<br />
Pokud nejste spokojeni s originálním nabíjecím algoritmem, máte možnost si ho celý naprogramovat sami v SDS-C: všechny potřebné vstupní a výstupní údaje (proměnné) jsou vám k dispozici. Popřípadě, pokud chcete jen sledovat situaci, můžete je také využít (např. pro logování nabíjecího a vybíjecího proudu akumulátoru a tak dále).<br />
<br />
sys[700] 02 i R reserved<br />
sys[701] 02 i R reserved<br />
sys[702] 02 i R reserved<br />
sys[703] 02 i R reserved<br />
<br />
'''Přepínač algoritmů:'''<br />
<br />
sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:<br />
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)<br />
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)<br />
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C<br />
<br />
Pokud zvolíte vlastní (ruční) řízení, musíte trvale řídit nabíjení sami pomocí programu v SDS-C. Vlastní ovládání vejde v platnost zápisem čísla 345 nebo 824 do sys[704]. Tento zápis provedete pouze jednou na začátku programu, a dále pak musí trvale následovat váš algoritmus. <br />
<br />
Pokud zvolíte 345, jediné co má váš program za úkol, je řídit samotný nabíjecí proces - toto je výhodné, když se nechcete zatěžovat hlídáním provozních stavů (tj. výpadek napájení atd.), což za vás v tomto režimu udělá původní firmware.<br />
<br />
Pokud zvolíte 824, musíte sami kompletně řídit všechno chování UPS, tj. nejenom nabíjecí algoritmus, ale i detekce výpadku napájení, přepínání mezi stavy, indikační LED, a tak dále.<br />
<br />
sys[705] až sys[731] reserved<br />
<br />
Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.<br />
<br />
Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.<br />
<br />
'''Vstupy a konfigurace:'''<br />
<br />
sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A<br />
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru<br />
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu<br />
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru<br />
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu<br />
<br />
Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě. <br />
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu. <br />
Měření proudu je specifické, protože měření ukazuje kladný i záporný proud, takže 0A je na hodnotě sys[732] (typicky 2047), všechno co je pod touto hodnotu je záporný proud, všechno nad je kladný proud. Znaménko proudu ukazuje, kam proud teče (např. záporný = vybíjení akumulátoru, atd.).<br />
<br />
sys[737] až sys[739] reserved<br />
<br />
Následuje konfigurace provedená uživatelem ve webovém rozhraní.<br />
Hodnoty jsou přímo v rozmezí 0 až 4095, takže je lze PŘÍMO použít se surovými hodnotami z A/D převodu (tzn. zařízení se už postaralo o převod údajů zadaných uživatelem ve webovém rozhraní na tento formát). V důsledku je pak realizace algoritmu velmi snadná.<br />
<br />
sys[740] 02 i R primary voltage to say target is ok (pri_pvts)<br />
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)<br />
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)<br />
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)<br />
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)<br />
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)<br />
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)<br />
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)<br />
sys[748] 02 i R flag: do not switch accu off (aku_dach)<br />
<br />
Hodnoty sys[740] až sys[748] jsou konfigurační údaje (uživatel je změnil přes webové rozhraní, a tím se uložili do pevné paměti, takže vydrží reset nebo vypnutí zařízení). Pokud do nich v SDS-C programu zapíšete, tato nová zapsaná hodnota zůstane platná až do resetu nebo vypnutí, nebo do ručního přepsání uživatelem (ve webovém rozhraní). Zápis do těchto konkrétních sys[] nezpůsobí uložení nových hodnot do pevné paměti.<br />
<br />
sys[749] až sys[760] reserved<br />
<br />
'''Výstupy:'''<br />
<br />
Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !<br />
<br />
<br />
sys[761] 02 i RW ovládání vypínání nabíječe<br />
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])<br />
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)<br />
<br />
sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe <br />
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)<br />
!= 0 : zásah do zpětné vazby (posun rozsahu)<br />
(vhodné pro skokové zvýšení výstupního napětí nabíječe, <br />
když už nereaguje v původním rozsahu)<br />
<br />
sys[763] 02 i RW ovládání odpojovače baterie <br />
== 0 : spínač vypnutý (baterie odpojena od zátěže)<br />
!= 0 : spínač sepnutý (baterie připojena)<br />
<br />
sys[764] 02 i RW indikační LED - nabíjení akumulátoru<br />
== 0 : LED svítí (informace: akumulátor je nabíjen)<br />
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)<br />
<br />
sys[765] 02 i RW indikační LED - výpadek primárního vstupu<br />
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)<br />
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)<br />
<br />
'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:<br />
<br />
sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)<br />
- minimální hodnota = 1<br />
- maximální hodnota = 2497<br />
<br />
sys[767] až sys[769] RESERVED vyhrazeno<br />
<br />
Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':<br />
<br />
sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx<br />
<br />
sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx<br />
<br />
sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx<br />
<br />
Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):<br />
<br />
UPS_PROVOZ_START 0<br />
UPS_PROVOZ_PRIOK 1<br />
UPS_PROVOZ_PRIOK_CHARGING 2<br />
UPS_PROVOZ_ONLY_BATT 4<br />
UPS_PROVOZ_NO_BATT 8<br />
<br />
UPS_NABREZIM_CC 0<br />
UPS_NABREZIM_CV 2<br />
UPS_NABREZIM_PAUZA 4<br />
UPS_NABREZIM_URCENI_REZIMU 8<br />
<br />
UPS_BATERIE_ODHAD_NEZNAM 0<br />
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1<br />
UPS_BATERIE_ODHAD_OK_NABIJIM 2<br />
UPS_BATERIE_ODHAD_PLNE_NABITO 4<br />
<br />
<br />
== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==<br />
<br />
Připojené moduly [[SDS_1W_T-RH]] jsou připojeny na 1-W sběrnici, a mají v sobě chip, který měří hodnotu ze sensoru vlhkosti (který je současně umístěn na modulu SDS-1W-T-RH) a současně měří i teplotu a napájecí napětí pro sensor vlhkosti. <br />
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.<br />
<br />
K dispozici jsou jak surové hodnoty (změřené v rámci modulu SDS-1W-T-RH), tak i hodnota kompenzované (skutečné) relativní vlhkosti v místě umístění modulu.<br />
<br />
<br />
Změřená teplota je uložena na standardních indexech:<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 degC<br />
<br />
Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):<br />
<br />
sys[800] až sys[831] <br />
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
sys[832] až sys[863] <br />
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
SDS provádí přepočet na údaj RH v procentech (0 až 100):<br />
<br />
sys[864] až sys[895] <br />
08 i R hodnota RH (0 až 100, v procentech RH) kompenzovaná podle rovnice pro čidlo HIH-503x (výpočet z Vad, kompenzace na Vdd a Temp).<br />
<br />
Rezerva (zatím nepoužito):<br />
<br />
sys[896] až sys[899] RESERVED vyhrazeno<br />
<br />
<br />
== Doplňující informace pro 1-Wire zařízení ==<br />
<br />
1-Wire sběrnice u zařízení SDS umožňuje komunikaci s celou řadů 1-W chipů: [[OneWire|seznam je zde]]. Přístup k chipům na 1-W sběrnici se liší na dva typy: chipy (čidla) které si SDS interně zpracuje (např. měření teploty), a všechny ostatní chipy (které SDS jen umí vyhledat a oznámit, ale dále s nimi nekomunikuje).<br />
<br />
<br />
'''1-Wire chipy interně zpracovávané SDS'''<br />
<br />
Tyto chipy jsou plně automaticky obsluhovány prostřednictvím firmware SDS - není potřebná opakovaná intervence uživatele, ten si pouze čte stále aktuální výsledky měření teplot z jednotlivých čidel.<br />
<br />
Poznámka: Pro změřené hodnoty z 1-W čidel teplot, jsou k dispozici tyto indexy: '''sys[310]''' až '''sys[430]''', a '''sys[900]''' až '''sys[931]'''.<br />
<br />
K dispozici je textové vyjádření (hex znaky) ROM CODE hodnoty načtené pro danou pozici zpracovávaného chipu na 1-W sběrnici.<br />
<br />
Zařízení SDS mohou mít jednu [A] nebo dvě ( nezávislé, [A] a [B] ) 1-Wire sběrnice, a každá sběrnice má maximálně 16 připojených chipů.<br />
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:<br />
<br />
sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále až<br />
<br />
sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):<br />
<br />
sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále . . . až<br />
<br />
sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.<br />
<br />
Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.<br />
<br />
Poznámka: ROM CODE pro 1-W chipy jsou k dispozici pouze jako ucelené texty (string). Bajtový rozpad jednotlivých položek není k dispozici.<br />
<br />
sys[931] až sys[939] reserved<br />
<br />
<br />
<br />
'''Ostatní 1-Wire chipy'''<br />
<br />
Pro ostatní 1-W chipy, které SDS "nezná" (tzn. nekomunikuje s nimi, jen je umí na sběrnici vyhledat), jsou jejich ROM CODE odděleny do samostatných '''sys[]''' položek.<br />
<br />
Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci. <br />
Na základě zavolání této funkce dojde k vynulování všech příslušných '''sys[]''' (od indexu 940 resp. 970) pro danou sběrnici, a provede se pokus o přečtení připojeného chipu.<br />
Pokud se to povede, bude nalezený ROM CODE (spolu s časovou značkou okamžiku přečtení) vložen do příslušných '''sys[]''', <br />
nebo bude nastaven chybový kód.<br />
<br />
Pozor, k SDS lze připojit více různých "ostatních" chipů, ale zdejší funkce najde jenom ten první z nich a ostatní už ignoruje. <br />
Ostatní chipy lze samozřejmě připojit na kteroukoliv sběrnici, i když na ní jsou připojeny i chipy se kterými SDS komunikuje (např. teploměrné chipy).<br />
<br />
Jednotlivé chipy se rozlišují pomocí hodnoty ''ID family-code'' (jeden bajt). Pro chip DS1990A je ''0x01'', hodnoty pro jiné chipy viz datasheet výrobce pro konkrétní chip.<br />
<br />
Obecný stav sběrnic:<br />
<br />
sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů<br />
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů<br />
:<br />
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici<br />
<br />
== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice<br />
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)<br />
<br />
== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu<br />
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)<br />
<br />
== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)<br />
<br />
== 8 : byl přečten ROM CODE z připojeného ostatního chipu<br />
(už lze také požádat o další nové čtení 1-W sběrnice)<br />
<br />
== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici <br />
(zkuste provést rescan/čtení znovu)<br />
<br />
sys[942] až sys[949] reserved<br />
<br />
'''Pro sběrnici [A]:'''<br />
<br />
sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[951] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire<br />
:<br />
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[953] 06 i R romcode[1] (1-W: serial code)<br />
sys[954] 06 i R romcode[2] (1-W: serial code)<br />
sys[955] 06 i R romcode[3] (1-W: serial code)<br />
sys[956] 06 i R romcode[4] (1-W: serial code)<br />
sys[957] 06 i R romcode[5] (1-W: serial code)<br />
sys[958] 06 i R romcode[6] (1-W: serial code)<br />
sys[959] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[960] až sys[969] reserved<br />
<br />
'''Pro sběrnici [B]:'''<br />
<br />
sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[971] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire<br />
:<br />
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[973] 06 i R romcode[1] (1-W: serial code)<br />
sys[974] 06 i R romcode[2] (1-W: serial code)<br />
sys[975] 06 i R romcode[3] (1-W: serial code)<br />
sys[976] 06 i R romcode[4] (1-W: serial code)<br />
sys[977] 06 i R romcode[5] (1-W: serial code)<br />
sys[978] 06 i R romcode[6] (1-W: serial code)<br />
sys[979] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[980] až sys[989] reserved<br />
<br />
Všimněte si, že SDS v tuto chvíli umožňuje pouze rescan 1-W sběrnice, kdy hledá pouze '''jeden''' připojený "ostatní 1-W chip" (ten první na který narazí, ten ohlásí, a nehledá dále). <br />
<br />
'''Pozor''':<br />
<br />
Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy, <br />
bude při tomto rescanu uveden pouze první nalezený ostatní chip (tj. ten, který má nejnižší ROM-CODE ze všech připojených ostatních chipů).<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[990] až sys[1023] reserved<br />
<br />
<br />
== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==<br />
<br />
'''Přímý přístup do LCD Frame Buffer paměti:'''<br />
<br />
sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)<br />
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst<br />
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)<br />
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye<br />
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)<br />
<br />
Tyto položky jsou dosupné '''pouze a jenom''' na SDS-MACRO-LM kde je vyžadován firmware od 24.11.2016 nebo novější, a na SDS-MACRO-ST (všechny FW verze).<br />
<br />
Jakékoliv změny (zápis) se promítnou pouze do frame bufferu (tedy v paměti SDS) - ale aby se následně tento frame buffer (jeho změněný obsah) eventuálně vykreslil na LCD, je potřeba zavolat příslušnou SDS-C funkci !<br />
<br />
Čtení ze sys poskytuje přímý přístup do frame bufferu (jeho aktuální obsah, tedy opět ne nutně to co je právě vidět na LCD).<br />
<br />
Pokud nepoužíváte LCD (sandwich desku), můžete tuto oblast 528 bajtů využít pro jakékoliv své účely. V podstatě se pak jedná o rozšiřující RAM pamět pro váš SDS-C program.<br />
<br />
'''Pozor''' SDS-MACRO-ST<br />
<br />
SDS MACRO ST provádí automatické aktualizace (zápis) do LCD bufferu, pokud se o tento buffer nepřihlásí SDS-C program. Proto, pokud na MACRO-ST chcete využít LCD buffer pro jiné své účely, musíte to nejprve SDS říct. Znovu, toto platí jen pro MACRO-ST - ''není to potřeba pro MACRO-LM (které tam po zapnutí nahraje logo a pak už na buffer za běhu nesáhne)''. Pro MACRO-ST zavolejte kteroukoliv SDS-C funkci pro přístup na display (např. clear) a je to - tím se přepne vlastnictví LCD bufferu pro SDS-C program.<br />
<br />
== Vyhrazená oblast ==<br />
<br />
'''Zbytek:'''<br />
<br />
sys[1552] až sys[1663] reserved<br />
<br />
<br />
== Bateriově Zálohovaná Paměť ==<br />
<br />
'''POUZE PRO: SDS-TTCPRO a SDS-MINI a SDS-MICRO-ST a SDS-MACRO-sT a SDS-IO6-ST !''' (tedy ty s baterií) - všechny jiné SDS První Řady tyto specifické indexy v sys[] nemají k dispozici!<br />
<br />
Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější. <br />
<br />
sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)<br />
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot<br />
- každý index má k dispozici 32 bitů (tj. celý signed integer)<br />
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)<br />
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")<br />
<br />
Pozor! Oblast záložní paměti je k dispozici pouze na vybraných zařízeních SDS (ty, které mají osazenu baterii pro tyto účely). Údaje se nesmazají změnou programu (nahráním nového programu), ani se nesmazají resetem zařízení (kromě aktivace RSTD - pozor!), tzn. vydrží a zůstanou, a to dokonce i po celou dobu výpadku externího napájení (tak dlouho, dokud se nevybije záložní baterie).<br />
<br />
''(Pouze) pokud baterie v daném SDS není'': tak jsou údaje ztraceny po výpadku napájení (ale po dobu přítomnosti externího napájení jsou k dispozici). Při takové situaci není zaručen obsah těchto dat po zapnutí (měl by být nulový, ale bez záruky).<br />
<br />
<br />
== Další informace ze S0 vstupů ==<br />
<br />
Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.<br />
<br />
Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:<br />
<br />
sys[1792] až sys[1823] <br />
07 i R cena za jednotku v režimu T0<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1824] až sys[1855] <br />
07 i R cena za jednotku v režimu T1<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1856] až sys[1887] <br />
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")<br />
- text<br />
<br />
sys[1888] až sys[1919]<br />
07 s R název měny, podle nastavení (např. text "CZK")<br />
- text<br />
<br />
sys[1920] až sys[1951] <br />
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")<br />
- text<br />
<br />
sys[1952] až sys[1983] <br />
07 s R název činnosti, podle nastavení (např. text "spotřeba")<br />
- text<br />
<br />
sys[1984] až sys[2015] <br />
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")<br />
- text<br />
<br />
sys[2016] až sys[2047] <br />
07 i R konfigurační detaily pro daný S0 vstup<br />
- bit 0 nastaven = je to aktivní S0 vstup<br />
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)<br />
<br />
Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2048] až sys[2197] reserved<br />
<br />
<br />
== MQTT klient ==<br />
<br />
Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:<br />
<br />
sys[2199] 09 i R podpora MQTT<br />
0 = NE<br />
1 = ANO, verze MQTT 3.1.1, SDS první část implementace<br />
2..max = (reserved)<br />
<br />
Každé nové připojení k Brokeru:<br />
<br />
sys[2200] 09 i R stav průběhu mqtt_connect()<br />
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno a odeslán CONNECT požadavek<br />
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )<br />
8 = probíhá odpojování, čekáme na výsledek (na odpojení)<br />
<br />
Po zavolání mqtt_connect(...) je nutné testovat sys[2200] na výslednou hodnotu. Funkci mqtt_connect(...) nelze volat, je-li sys[2200] na hodnotě 1, 2, 8 nebo 16 (nejprve je v takových případech potřeba provést odpojení pomocí mqtt_disconnect() funkce). Pro úplný test, je-li připojení z SDS do Brokeru úplné, je potřeba ověřit i hodnotu v sys[2201]. Teprve pokud oba tyto sys jsou na správné hodnotě, lze s Brokerem komunikovat.<br />
<br />
sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"<br />
-7 = nepoužito<br />
-6 = timeout při čekání na CONNACK, nepřipojeno<br />
-5 = nepoužito<br />
-4 = nepoužito<br />
-3 = nepoužito<br />
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)<br />
-1 = idle, nepřipojeno<br />
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)<br />
1 = MQTT 0x01: Connection Refused, unacceptable protocol version<br />
2 = MQTT 0x02: Connection Refused, identifier rejected<br />
3 = MQTT 0x03: Connection Refused, Server unavailable<br />
4 = MQTT 0x04: Connection Refused, bad user name or password<br />
5 = MQTT 0x05: Connection Refused, not authorized<br />
<br />
Hodnotu v sys[2201] lze číst a zpracovat pouze pokud je sys[2200] na hodnotě 16 (to znamená, pouze pokud SDS obdrží odpověď CONNACK od MQTT brokera).<br />
<br />
Před a po každém volání mqtt_publish() a nebo mqtt_subscribe() funkcí je potřeba sledovat obsah následují položky:<br />
<br />
sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci<br />
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat<br />
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu<br />
-4 = nespravne parametry (počet parametrů)<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity<br />
0 = nepoužito<br />
1 = mqtt_publish() probíhá<br />
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci<br />
4 = mqtt_subscribe() probíhá - čekám na SUBACK<br />
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci<br />
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)<br />
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce<br />
<br />
Informativní položka:<br />
<br />
sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru<br />
(objeví-li se chyba, dojde k okamžitému odpojení)<br />
<br />
Nastavení (položka 2198 je k dispzoici až od FW 11/2025):<br />
<br />
sys[2198] 09 i R mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ) <br />
sys[2198] 09 i W write ( default: 0b00110001 )<br />
<br />
Zatím nepoužité pozice:<br />
<br />
sys[2204] až sys[2208] reserved<br />
<br />
Pro každou příchozí datovou zprávu z Brokeru, je tato zpráva uložena do následujících sys: (pozor, každá nová příchozí zpráva přepíše předchozí údaje)<br />
<br />
sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)<br />
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)<br />
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)<br />
<br />
SDS umí přijaté datové zprávy uchovat, v rámci následující tabulky. Toto je důležité zejména pokud různé zprávy přicházejí velice rychle za sebou, aby se pro SDS-C program neztratili.<br />
<br />
Nejvíce lze mít až 32 položek (řádků) v tabulce, nicméně některá SDS nemají ve své paměti dostatečné místo a počet je tedy omezen. Pozor na to při psaní programu !<br />
<br />
sys[2209] 09 i R počet řádků v tabulce pro dané SDS (různé SDS mají různě volnou paměť, proto je v nich i různý počet použitelných Subscribe položek)<br />
<br />
Jednotlivé položky v tabulce příchozích zpráv:<br />
<br />
sys[2211] až sys[2241] <br />
09 s R název položky (Topic Name) pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2242] až sys[2249] reserved<br />
<br />
sys[2251] až sys[2281] <br />
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2282] až sys[2289] reserved<br />
<br />
sys[2291] až sys[2321] <br />
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru<br />
(pro detekci změny - příchozí zprávy z Brokeru)<br />
0 = zatím nic nepřišlo<br />
1..MAX = hodnota uptime v okamžiku poslední změny<br />
<br />
Nastavení Topic názvů každé položky (tedy "zápis" do sys[2211] až sys[2241]) se provede funkcí mqtt_subscribe(), které zadáváte pozici v této tabulce a název Topicu. Pokud se Subscribe nepovede, zůstane pozice v tabulce prázdná. Po připojení k Brokeru je tabulka vždy zcela prázdná, a SDS-C program si ji vždy musí dle potřeby naplnit. Pokud Broker pošle aktualizaci obsahu (value) na některou z přihlášených Topic položek, které SDS v této tabulce má, tak SDS automaticky přepíše patřičný řádek tabulky (tj. obsah jednoho ze sys[2251] až sys[2281]) a patřičně aktualizuje časovou známku změny.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2322] až sys[2398] reserved<br />
<br />
<br />
== MODBUS-TCP klient ==<br />
<br />
Ověření FW v SDS:<br />
<br />
sys[2399] 09 i R podpora pro MODBUS TCP<br />
0 = NE<br />
1 = ANO (první verze implementace v SDS)<br />
<br />
Každé nové TCP spojení na server:<br />
<br />
sys[2400] 09 i R stav průběhu modbus_tcp_connect()<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno, můžete komunikovat <br />
<br />
MODBUS funkce - každá má svůj nezávislý stavový údaj:<br />
<br />
sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
pro všechny tyto stavy platí následující hodnoty:<br />
-6 = timeout (neprovedeno), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty), můžete volat další funkci<br />
-4 = nespravne parametry (počet parametrů), můžete volat další funkci<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity, lze volat funkci<br />
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci<br />
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci<br />
256 = pracuji, čekejte na aktualizovanou hodnotu<br />
<br />
sys[2417] až sys[2462] reserved<br />
<br />
sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
Přijatá data (funkce _read) - obsah je aktualizován pro každou novou přijatou MODBUS zprávu. Výsledky (přijatá data) jsou vždy uloženy do následujících sys (bez ohledu na typ MODBUS funkce).<br />
<br />
sys[2465] 09 i R timestamp poslední přijaté zprávy<br />
(vhodné pro detekci nové přijaté zprávy)<br />
<br />
sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu<br />
(počet celých položek)<br />
<br />
sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy)<br />
<br />
sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy) <br />
<br />
sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])<br />
(MODBUS způsob číslování položek - adresa 1..n)<br />
<br />
sys[2470] až sys[2719]<br />
09 i R přijaté hodnoty pro poslední přijatou zprávu<br />
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input<br />
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr<br />
<br />
Pro funkce 0x01 a 0x02 jsou přijatá data kódována v jednobitovém tvaru, vždy po osmi bitech na jeden sys[]. Takže prvních osm bitů naleznete v sys[2465], dalších osm bitů v sys[2466] a tak dále.<br />
<br />
Pro funkce 0x03 a 0x04 jsou přijaté hodnoty registrů (MODBUS: vždy int16_t) uloženy postupně zasebou (tak jak přišli ve zprávě) do jednotlivých sys[], takže první registr je v sys[2465], druhý ve sys[2466] atd.<br />
<br />
<br />
Rezerva<br />
<br />
sys[2715] až sys[2809] reserved<br />
<br />
<br />
== Statistiky COMx ==<br />
<br />
COM1:<br />
<br />
sys[2810] 09 i R reserved<br />
<br />
sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1<br />
<br />
sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1 <br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1<br />
<br />
sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1<br />
<br />
sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1 <br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1<br />
<br />
<br />
Rezerva<br />
<br />
sys[2817] až sys[2860] reserved<br />
<br />
<br />
COM6:<br />
<br />
sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6<br />
<br />
sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6<br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6<br />
<br />
sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6<br />
<br />
sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6<br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6<br />
<br />
Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).<br />
<br />
<br />
== Konec dokumentu ==<br />
<br />
'''Konec dokumentu.'''</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=Firmware&diff=971Firmware2025-11-15T14:20:15Z<p>Adamn: </p>
<hr />
<div>== Nový Firmware ==<br />
<br />
Aktualizujte si své SDS - nahrejte do něj nový firmware, který získáte na této stránce - '''naskrolujte dolů''' kde naleznete odkaz na BIN soubor pro vaše zařízení.<br />
<br />
Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].<br />
<br />
Důležité první kroky, které je nutné provést s každým novým zakoupeným modulem: [[New_Device_First_Setup_Steps|První nutné kroky pro nově zakoupené zařízení SDS]].<br />
<br />
<br />
=== Odkazy ke stáhnutí ===<br />
<br><br />
Pro aktualizaci firmware ve vašem zařízení (nebo pro zápis SDS-C respektive FULL-C programu), potřebujete jeden z následujících programů:<br />
<div class="successbox">PC Software</div><br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')<br />
|-<br />
| style="padding: 15px;"| <li> stáhnout WinEXE pro SDS-C [https://sds.an-d.cz/firmware/SDSC_310123.exe zápis/simulace/upload SDS-C (SDS-C '''verze 09''') a UWEB, ze dne 31.1.2023]<br>SHA-256: daf1095f206404e33223f675f5d0bc09d4fc5dfd7d9f79f4f735af88f5ff1e6a<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> (FC verze '''0x12''' - '''aktuální'''): stáhnout WinEXE pro FULL-C [https://sds.an-d.cz/firmware/FULLC_220724.exe zápis/upload FULL-C a UWEB, ze dne 22.7.2024],<br> určeno pro Firmware od 9.3.2023 včetně, pro všechny varianty SDS (64kB a 128kB a 512kB)<br>SHA-256: b4cb95d8ec8a6e844a3a4c9a2e9fc50ece60ccf44e8043f8c10f46b2294cae0b<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program SDSLOAD.exe''' ("jednokrokový" upload .FC souborů a aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> ('''aktuální''' verze, pro FW od 10.7.2017 včetně a dále) stáhnout WinEXE [https://sds.an-d.cz/firmware/SDSLOAD_220724.exe program SDSLOAD ze dne 22.7.2024],<br> určeno pro všechny SDS varianty 64kB a 128kB a 512kB, (subvarianty DP a DS84)<br>SHA-256: ded5bf1aca2e04e22c33899a0976deccc8ff76eb88f53ecd9769788b7daa25a7<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''<br />
|-<br />
| style="padding: 15px;"| <li> Program '''[[SDS LOG: intro|SDS LOG]]''' - verze 0.1 ze dne 26.8.2011 - [https://sds.an-d.cz/firmware/SDS_LOG.exe stáhnout EXE program]<br />
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]<br />
<li> [[SDS LOG: changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
|}<br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_151125_CZ.bin SDS-MICRO-LM-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_151125_EN.bin SDS-MICRO-LM-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MICRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_151125_CZ.bin SDS-MICRO-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_151125_EN.bin SDS-MICRO-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_151125_CZ.bin SDS-MICRO-ST-DP-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_151125_EN.bin SDS-MICRO-ST-DP-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MINI_151125_CZ.bin SDS-MINI-ST-CZ ze dne 15.11.2025]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MINI_151125_EN.bin SDS-MINI-ST-EN released on 15-Nov-2025]<br />
<li><br />
[[SDS MINI: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].<br />
<li>Výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_151125_CZ.bin SDS-MACRO-LM-CZ ze dne 15.11.2025]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_151125_EN.bin SDS-MACRO-LM-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MACRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_151125_CZ.bin SDS-MACRO-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_151125_EN.bin SDS-MACRO-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>[[SDS MACRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_151125_CZ.bin SDS-TTCPRO-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_151125_EN.bin SDS-TTCPRO-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_151125_CZ.bin SDS-IO6-LM-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_151125_EN.bin SDS-IO6-LM-EN released on 15-Nov-2025]<br />
<li><br />
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_151125_CZ.bin SDS-IO6-ST-CZ ze dne 15.11.2025]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_151125_EN.bin SDS-IO6-ST-EN released on 15-Nov-2025]<br />
<li><br />
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.<br />
<li><br />
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.<br />
<li> <br />
<li>[[SDS FTP: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).<br />
<li><br />
<li>Stáhnout firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_CZ.bin (Česká lokalizace) SDS-UPS-ONEDPS-LM ze dne 1.7.2022]<br />
<li>Download firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_EN.bin (English language version) SDS-UPS-ONEDPS-LM released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.<br />
<li><br />
<li>Firmware je zaslán na požádání (pošlete email), aktuální verze je z 1.3.2011 (dále aktualizováno na specifické požádání, raději proto přejděte na nový HW).<br />
<li><br />
<li>Každá deska má svou kalibraci, proto každá deska má svůj vlastní FW, proto musíte uvést S/N svého výrobku.<br />
<li><br />
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW<br />
|-<br />
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]<br />
<li><br />
<li>Firmware je jednotný pro všechny varianty '''SDS Druhé Produktové Řady''', nutné je rozlišení dle varianty 64kB/128kB/512kB. Rozlišení podle dalších subvariant (DP, DS84) se neprovádí.<br />
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.<br />
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.<br />
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu. <br />
<li><br />
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_251025_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_251025_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 512kB) [[firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 12.4.2022|informace pokud máte SDS512 s FW <b>starším</b> než 12.4.2022]]<br />
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_251025_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.<br />
|-<br />
| style="padding: 15px;"| POZOR<br />
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<br><br />
Aktualizaci lze provést jen fyzicky u výrobce, ten ji provede bezplatně (zašlete výrobci vaše SDS pro jeho aktualizaci). Se starým FW nebude tento HW plně fungovat.<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
=== Informace ===<br />
<br />
VŽDY MĚJTE VE SVÉM ZAŘÍZENÍ NEJNOVĚJŠÍ FIRMWARE, A POUŽÍVEJTE TAKÉ NEJNOVĚJŠÍ SDS-C EXE / FULL-C EXE PROGRAM.<br />
V opačném případě vám budou chybět nové funkce, které neustále přidáváme, a také nebudete mít opravené nalezené chyby.<br />
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.<br />
<br />
<br />
=== Historický Software ===<br />
<br />
Za účelem aktualizace takových SDS, kde už dlouho nebyl aktualizován firmware, je potřeba použít odpovídající EXE program pro aktualizaci takovéhoto zařízení.<br />
<br />
<br />
==== První Produktová Řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_151119.exe ze dne '''15.11.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 08, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020118.exe ze dne '''2.1.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 07, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020317.exe ze dne '''2.3.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 8.8.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_060216.exe ze dne '''6.2.2016''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které nemají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 24.1.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_231111.exe ze dne '''23.11.2011''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 04<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_170211.exe ze dne '''17.2.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''února 2011''')<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro ''SDS-C verze č. 03'' (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_140511.exe ze dne '''14.5.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''konce května 2011''')<br />
<br />
<br />
==== Druhá Produktová řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_070323.exe ze dne '''7.3.2023''']<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_311222.exe ze dne '''31.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 11, (firmware od 9.1.2023 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_071222.exe ze dne '''7.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 10, (firmware od 18.11.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_161022.exe ze dne '''16.10.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0F, (firmware od 16.10.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_110722.exe ze dne '''11.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0E, (firmware od 11.7.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010722.exe ze dne '''1.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0D, (firmware od 6.8.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030422.exe ze dne '''3.4.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0C, (firmware od 23.3.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010322.exe ze dne '''1.3.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0B, (firmware od 6.8.2020 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030119.exe ze dne '''3.1.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0A, (firmware od 3.1.2019 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010718.exe ze dne '''1.7.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 09, (firmware od 27.6.2018 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_100717.exe ze dne '''10.7.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 08, (firmware od 10.7.2017 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_080617.exe ze dne '''8.6.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 06, (firmware starší než Červenec-2017, a pouze pro variantu SDS 64kB)<br />
<br />
* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_120417.exe ze dne 12.4.2017],<br> určeno pouze pro SDS variantu 64kB která používá ''starý'' firmware (2017 nebo starší)<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_100717.exe ze dne 10.7.2017],<br> určeno pouze pro SDS variantu 64kB a 128kB (nepodporuje variantu 512kB tak jako aktuální stáhnutelná verze aplikace)<br />
<br />
<br />
== Beta Testing ==<br />
<br />
Než vydáme novou verzi, je potřeba změny a novinky otestovat.<br />
<br />
Pokud jste ochotní se testu zúčastnit, pak se podívejte [https://forum.sds.an-d.cz/viewtopic.php?id=129 na tento odkaz]. Zde jsou uveřejněny vždy nejnovější beta verze firmware.<br />
<br />
Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS-C:_sdsc_sysp&diff=970SDS-C: sdsc sysp2025-11-15T11:19:56Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS. <br />
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).<br />
<br />
== Definice systémových proměnných SDS-C : pole sys[] ==<br />
<br />
Tzv. "systémová proměnná" je prvek v programovacím jazyku SDS-C, který má textový název, a se kterým se dá pracovat - číst hodnotu z proměnné a zapisovat hodnotu do proměnné. Často je čtení a zápis svázáno s fyzickou akcí (např. zápis do konkrétní systémové proměnné změní stav relé).<br />
<br />
SDS-C obsahuje celou řadu vyhrazených, předem pevně definovaných systémových proměnných. Tyto proměnné obsahují aktuální online informace a údaje, vzhledem ke stavu zařízení. Dá se jimi také zařízení (resp. periférie) přímo ovládat. Úplný seznam je právě na této stránce.<br />
<br />
Proměnné poskytované SDS-C a navázané na HW zařízení, jsou označeny jako '''sys[x]''', kde index '''x''' je číslo do 0 do 1023 (popřípadě až do 2048 ale to jen na určitých typech zařízení).<br />
<br />
Tyto proměnné lze číst, popř. do nich zapsat novou hodnotu. To vše můžete provést ve svém SDS-C programu, nebo přes některou z komunikačních funkcí (např. UDP protokolem, nebo přes webové rozhraní).<br />
<br />
<br />
''Legenda k tabulce:''<br />
<br />
Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).<br />
<br />
Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.<br />
<br />
Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW'''). <br />
<br />
Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.<br />
'''Význam hodnot:'''<br />
* '''01''' - první verze, výchozí firmware ze začátku roku 2010<br />
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011<br />
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011 <br />
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější<br />
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější<br />
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější<br />
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější<br />
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější<br />
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější<br />
<br />
Všechny proměnné označené jako rezerva mohou být v budoucích verzích firmware nějak využity. Pokud jsou však pro tuto verzi firmware označeny jako rezerva, pak se nesmí používat (zapisovat do nich, kvůli budoucí kompatibilitě). Při čtení obvykle vrací hodnotu nula, ovšem jakmile budou v novém firmware využity, už budou vracet konkrétní hodnotu.<br />
<br />
Pokud máte starší verzi firmware, je možné, že některé později přidané položky nebudou k dispozici. Řešením je udržovat firmware ve vašem zařízení vždy aktuální.<br />
<br />
Jazyk SDS-C indexuje všechny pole od čísla 0 (nula) - všechna pole, tj. "sys[]", "ram[]", "text[]", začínají se svým obsahem od indexu nula.<br />
<br />
'''Pozor''' však na číslování hardware vstupů a výstupů, ty jsou číslovány dle "elektrikářských" zvyklostí, to znamená že číslování začíná od čísla '''1''' ('''jednička''') - toto ale nemá hlubší vliv na SDS-C.<br />
<br />
Pokud narazíte na takové zařízení SDS, které má ještě velmi starou verzí webového rozhraní, kde byly ještě některé vstupy číslovány od nuly, aktualizujte si toto zařízení aby používalo nejnovější firmware.<br />
<br />
<br />
'''Důležité upozornění'''<br />
<br />
Protože SDS-C ''umí pracovat pouze a jen'' s '''32-bit signed''' integer čísly (tj. 1-bit znaménko a 31-bitů číslo, typ int32_t), tak dochází k (očekávané) konverzi '''32-bit unsigned''' čísel (tj. bez znaménka 32-bitů číslo, typ uint32_t) mezi vnitřními hodnotami v SDS a reprezentací v SDS-C (například když takové unsigned číslo je dotazováno například přes čtení "sys[]" hodnot).<br />
<br />
Jinýmy slovy - uvnitř SDS jsou drženy některé hodnoty jako 32-bit unsigned. Ale protože SDS-C pracuje pouze s 32-bit signed čísly, pak při čtení takových čísel zevnitř SDS jsou tyto čísla prezentovány v SDS-C jako 32-bit signed. Bitově se nezmění, jen se "mění" pohled na to, co který bit znamená, viz text dále.<br />
<br />
''Příklad:'' <br />
Hodnota "sys[625]" reprezentuje "uplynulý čas od posledního zachyceného S0 impulsu na daném S0 vstupu". Tato hodnota je udržována uvnitř SDS a program SDS-C k ní má přístup.<br />
Tento čas je udán v milisekundách a začína na nule, a s každou milisekundou ze zvýší o jedničku. Protože SDS udržuje toto počítadlo (uvnitř své paměti) jako '''32-bit unsigned''', tak jakmile dojde k dopočítání do 31-bitů (tj. 2147483647) a překlopí se tedy 32. bit (tj. na 2147483648), tak SDS-C při čtení "sys[625]" vrátí zápornou hodnotu (tj. -2147483648). Toto je v pořádku - pokud si vypíšete jednotlivé bity, tak budou stále přesně odpovídat, ale tím že SDS-C interpetuje všechny čísla jako '''32-bit signed''', tak vzorovou hodnotu použije a zobrazí jako zápornou.<br />
<br />
<pre><br />
skutečná binární hodnota | 32-bit signed | 32-bit unsigned<br />
(32-bit) | SDS-C integer | (internal SDS)<br />
----------------------------------+---------------+-----------------<br />
00000000000000000000000000000000 | 0 | 0<br />
00000000000000000000000000000001 | 1 | 1<br />
00000000000000001111111111111111 | 65535 | 65535<br />
01111111111111111111111111111111 | 2147483647 | 2147483647<br />
10000000000000000000000000000000 | -2147483648 | 2147483648<br />
10000000000000000000000000000001 | -2147483647 | 2147483649<br />
10000000000000001111111111111111 | -2147418113 | 2147549183<br />
11111111111111111111111111111111 | -1 | 4294967295<br />
11111111111111111111111111111110 | -2 | 4294967294<br />
11111111111111111111111111111101 | -3 | 4294967293<br />
</pre><br />
<br />
Jak lze vidět, SDS vždy (ať ve svém firmware, tak v SDS-C kódu a proměnných) udržuje hodnoty ve stejném ''binárním'' obsahu. Jen interpretace a další práce s čísly je jiná. SDS samo vnitřně pracuje s '''32-bit unsigned''' hodnotami, a díky tomu na webu a všech M2M stránkách můžete vidět hodnoty v rozsahu od 0 do 4294967295. Zato SDS-C pracuje pouze se '''32-bit signed''' hodnotami, a proto stejné číslo je reprezentováno v rozsahu -2147483648 až 2147483647. Toto je vlastnost daná omezením implementace, zkrátka v SDS-C to nelze jinak udělat (pokud to je problém, což ale není, tak můžete přejít na zařízení s FULL-C které tyto omezení nemá).<br />
<br />
To lze snadno ve vašem SDS-C kódu ošetřit, a pokud pouze přenášíte hodnoty z SDS na server (přes HTTP-GET), tak se to dá snadno a ihned zpracovat na serveru "zpět" na '''32-bit unsigned''' hodnotu. Jednoduše na serveru přijmete '''signed''' číslo, a převedete ho například přetypování na '''unsigned''' číslo. Bity v paměti totiž jsou pro oba typy stejné.<br />
<br />
V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''<br />
<br />
<br />
'''Použítí v SDS-C programu'''<br />
<br />
Zápis a čtení z/do systémových proměnných má okamžitý přímý vliv na hardware, se kterým jsou konkrétní proměnné svázány.<br />
<br />
Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)? <br />
<syntaxhighlight lang="c"><br />
teplota0_ve_stupnich_C = sys[310] / 100;<br />
</syntaxhighlight><br />
<br />
Ne vždy je potřeba provádět převody. Pokud např. chcete porovnat dvě hodnoty z různých teplotních čidel, můžete to udělat přímo (bez dělení 100 jako v předchozím příkladu) - samozřejmě toto platí pouze tehdy, pokud porovnáváte hodnoty ve stejných jednotkách:<br />
<syntaxhighlight lang="c"><br />
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };<br />
</syntaxhighlight><br />
<br />
Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):<br />
<syntaxhighlight lang="c"><br />
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)<br />
</syntaxhighlight><br />
<br />
Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:<br />
<syntaxhighlight lang="c"><br />
#define RELE1 sys[231]<br />
<br />
#define TEPLOTA sys[310]<br />
<br />
// ...<br />
<br />
RELE1 = 255;<br />
<br />
if (TEPLOTA > 3200) goto x;<br />
</syntaxhighlight><br />
<br />
<br />
== Pole ram[] ==<br />
<br />
Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).<br />
<br />
Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.<br />
<br />
Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).<br />
<br />
Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:<br />
<syntaxhighlight lang="c"><br />
hodnota = ram[10];<br />
<br />
index = 23;<br />
ram[index] = 15 * 2;<br />
<br />
index = sys[1023];<br />
ram[index] = 30;<br />
</syntaxhighlight><br />
<br />
Pole ram[] je indexováno od indexu nula (tj.: ram[0]). Celková velikost (maximální index) je dán verzí SDS-C a konkrétního firmware v zařízení. <br />
<br />
Verze SDS-C č. 03 má maximální velikost pole ram[] nastavenou na 128 položek. '''Novější verze už mají počet zvýšený ''' - verze č. 06 má velikost ram[] nastavenou na 512 položek (každá o velikosti int32_t).<br />
<br />
Pole ram[] můžete využít k čemukoliv co potřebujete. Také i pro některé SDS-C funkce, jako je ''http_get()'', která může do pole ram[] ukládat obsah textu obdrženého ze serveru (toto chování se nastavuje příslušnými sys[]), nebo při přenosu stránek z/do paměti DF.<br />
<br />
<br />
== Ukládání trvalých dat ==<br />
<br />
Všechny verze SDS-C mají od k dispozi prostor v oblasti sys[100] až sys[115]. Toto je výchozí oblast pro uchovávání trvanlivých dat (tyto údaje se neztratí při výpadku napájení). Přímým zápisem, do těchto sys[] položek, dojde k zápisu do pevné paměti. Čtení se provádí opět přímým přístupem do těchto sys[].<br />
<br />
Od verze SDS-C č. 05 je možno, navíc k tomuto základu, zapisovat a přečíst mnohem větší množství údajů v externím paměťovém chipu DATAFLASH (NVM = Non-Volatile Memory), osazeném na desce zařízení SDS, a to prostřednictvím čtyř SDS-C funkcí.<br />
<br />
Pozn. historické verze zařízení SDS-MICRO LIGHT, kde se používá paměť EEPROM (na místo novější DataFlash), poskytuje vždy pouze základní rozsah indexů: 100 až 115, a neposkytuje rozšířený rozsah pevné paměti (tak jako zařízení s pamětí DataFlash).<br />
<br />
Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].<br />
<br />
Další možnost:<br><br />
Zařízení SDS řady ST mají k dispozici, kromě podpory pro DataFlash, i možnost využít Zálohovanou paměť RAM (ta drží obsah i při vypnutém napájení SDS, pokud je v SDS vložena nabitá zálohovací baterie).<br />
<br />
<br />
== Pole text[] ==<br />
<br />
Od verze SDS-C č. '''06''' je možné v určité míře pracovat s texty. Toto má především využití v komunikaci přes sériovou linku (RS232/RS485) a při odesílání a příjmu dat (email, http) či práci s komunikačními moduly (GSM, LTE, LoRA).<br />
<br />
Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].<br />
<br />
SDS-C je omezený programovací jazyk z hlediska "práce s textem". Pokud potřebujete intenzivně s textem pracovat, použijte zařízení SDS které má FULL-C jazyk.<br />
<br />
I přes omezení SDS-C je možné připojit různé komunikační moduly (GSM, LTE, LoRA), které komunikují prostřednictvím textových příkazů (viz vzorové programy).<br />
<br />
<br />
== Pole share[] ==<br />
<br />
<br />
Od verze SDS-C č. '''08''' je možné použít pole '''share[]''', určené primárně pro sdílení textové informace mezi SDS-C programem a webovým rozhraním (tedy jako [[SDS-C:_sharing|sdílené proměnné]]).<br />
<br />
Práce s polem share[] je prakticky zcela shodná jako práce s polem text[]. Prakticky tak získává programátor dvě nezávislé pole pro uchování textu. Nicméně, některé SDS-C funkce vyhrazeně fungují jen s polem text[], ale to je vždy uvedeno v jejich popisu. <br />
<br />
<br />
== Vyhrazené funkce ==<br />
<br />
Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].<br />
<br />
<br />
== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==<br />
<br />
'''STAV SYSTÉMU'''<br />
<br />
sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)<br />
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program<br />
<br />
sys[1] 01 i R počet přihlášených uživatelů do webového rozhraní (v okamžiku čtení této proměnné)<br />
<br />
sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci<br />
<br />
sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)<br />
- počítá se od nuly (0) od každého zapnutí zařízení<br />
- pouze 31 bitové počítadlo<br />
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně<br />
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule<br />
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času <br />
<br />
sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)<br />
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem<br />
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)<br />
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)<br />
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně, <br />
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
<br />
sys[5] 01 i R rozpad LOCAL času: den (1 až 31)<br />
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)<br />
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)<br />
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)<br />
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)<br />
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)<br />
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)<br />
<br />
'''Upozornění''': hodnota LOCAL času je platná až po úspěšném získání informací z NTP serveru. Po zapnutí (restartu) zařízení je NTP čas (sys[38], sys[4]) nastaven na nulu. Čas je automaticky v SDS aktualizován co jednu sekundu pomocí vnitřních hodin v SDS, a dále je hodnota času pravidelně (v delším intervalu) upřesněna dotazem na NTP server.<br />
<br />
V případě, že není zapnuta automatika DST (letní čas) a GMT offset je nastaven na nulu, tak je hodnota LOCAL času identická s NTP časem (UTC). Jakmile se ale nastaví offset nebo aktivuje posun letního času, už jsou tyto hodnoty odlišné (NTP je UTC, a LOCAL je místní (posunutý) čas). Pro různé použití je potřeba různých časů (často je potřeba UTC pro časové známkování údajů, a zase někdy je vhodný LOCAL pro interakci s uživatelem a pro různé výpisy).<br />
<br />
<br />
== Ethernet, Internet ==<br />
<br />
sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)<br />
sys[13] 01 i R IP[1] adresa zařízení<br />
sys[14] 01 i R IP[2] adresa zařízení<br />
sys[15] 01 i R IP[3] adresa zařízení<br />
<br />
sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)<br />
sys[17] 01 i R GW_IP[1] adresa brány<br />
sys[18] 01 i R GW_IP[2] adresa brány<br />
sys[19] 01 i R GW_IP[3] adresa brány<br />
<br />
sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)<br />
sys[21] 01 i R NETMASK[1] síťová maska<br />
sys[22] 01 i R NETMASK[2] síťová maska<br />
sys[23] 01 i R NETMASK[3] síťová maska<br />
<br />
sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)<br />
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)<br />
!= 0 : Ethernetová komunikace je funkční (LINK OK)<br />
<br />
sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)<br />
== 0 : neznámá rychlost (není k dispozici Ethernet)<br />
== 10 : 10 MBit per sec<br />
== 100 : 100 MBit per sec<br />
<br />
sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)<br />
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)<br />
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti <br />
(po resetu zařízení se vráti na poslední uloženou hodnotu)<br />
<br />
sys[27] 06 i R platnost přidělené IP adresy zařízení SDS<br />
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)<br />
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet<br />
<br />
sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,<br />
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)<br />
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik<br />
<br />
sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)<br />
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)<br />
== 1 : odesláno DHCP DISCOVER<br />
== 2 : obdrženo DHCP OFFER<br />
== 3 : odesláno DHCP REQUEST<br />
== 4 : obdrženo DHCP ACK<br />
== 5 : IP adresa je přidělena (BOUND)<br />
== 6,7,8,9,10,11 : zpracování DHCP RENEW<br />
<br />
sys[30] 06 i R aktuální hodnota "DHCP Lease Time"<br />
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)<br />
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)<br />
- údaj je uveden v jednotkách [sec]<br />
<br />
sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)<br />
sys[32] 04 i R MAC[1] <br />
sys[33] 04 i R MAC[2] <br />
sys[34] 04 i R MAC[3] <br />
sys[35] 04 i R MAC[4] <br />
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)<br />
<br />
sys[37] 06 i R NTP Client Status (synchronizace času)<br />
== 0 : nesynchronizováno<br />
== 1 : úspěšně přijal paket od NTP Serveru<br />
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz <br />
(dotaz se odešle za 10sec od takovéhoto zápisu)<br />
<br />
sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)<br />
- není zde aplikován offset, ani automatika letního času<br />
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď), <br />
uvnitř SDS je sice udržována jako 32bit, <br />
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).<br />
<br />
sys[39] 07 i R stav automatiky přepínání Letního Času<br />
== 0 : automatika zakázána, lokální čas není ovlivněn<br />
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").<br />
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").<br />
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).<br />
09 i W pouze pro případ vypnutého NTP: ruční ovládání automatiky (tzn. povolena nebo nepovolena) (SELČ pak automatika sama rozhodne, je-li povolena)<br />
zápis 0 : vypnout automatiku (nebude pracovat = nebude aplikoval posun pro SELČ pro nastavený rozsah v roce), sys[39] pak vrátí 0 při čtení<br />
zapis 3 : zapnout automatiku (automatika aplikuje posun pro SELČ podle toho jaký je aktuální čas a datum), sys[39] pak vrátí 1 nebo 2 dle stavu <br />
<br />
sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)<br />
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)<br />
<br />
sys[139] 09 i R vyhrazeno<br />
<br />
Princip funkce automatiky letního času je popsán jinde na této wiki. Funkce automatiky je samozřejmě volitelná (viz: ruční nastavení ve webovém rozhraní).<br />
<br />
sys[40] až sys[44] RESERVED vyhrazeno<br />
<br />
<br />
== Provozní údaje ==<br />
<br />
sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)<br />
- po resetu zařízení začíná vždy počítat od nuly<br />
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);<br />
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!<br />
- pro sys[45] je k dispozici 31 bitů,<br />
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru<br />
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).<br />
<br />
sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),<br />
význam hodnot závisí na typu konkrétního zařízení SDS. <br />
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.<br />
<br />
SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM): <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]<br />
<br />
SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST: <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]<br />
<br />
Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.<br />
<br />
sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu <br />
(při přetečení 2^31 počítá opět od nuly, pořád dokola)<br />
<br />
Hodnota v indexu 137 je nejjemnější možný "časovač", dostupný pro program. Délka kroku jednotky odpovídá frekvenci jádra (ta je různá pro jednotlivá SDS, pro řadu ST typicky 120MHz, tedy 1 krok je 8.3nsec). <br />
Tento index vyžaduje aktuální FW (11/2022 nebo novější).<br />
<br />
<br />
== Rozhraní sériové komunikace ==<br />
<br />
SDS-C poskytuje přístup k sériovému rozhraní COM1 a COM6. Pouze rozhraní COM1 je také současně přístupno přes převodník Eth/UART (VCP). Program v SDS-C může přistupovat jak ke COM1, tak ke COM6.<br />
<br />
Pomocí SDS-C lze zapisovat do sériového rozhraní, a číst data ze sériového rozhraní. Data, přicházející z venku do zařízení SDS, jsou ukládána do příslušného bufferu (RX FIFO), takže lze pomocí SDS-C programu číst i pomaleji, než je rychlost příchozích dat. Buffery jsou malé (zhruba 1kB), proto je potřeba data zpracovávat rychle a včas, ať nedojde k jejich ztrátě.<br />
<br />
Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše. <br />
Poznámka: UART buffery (pro obě sériové rozhraní) jsou neustále aktivní a příjem dat z UARTu probíhá po celou dobu zapnutí zařízení.<br />
<br />
Rozhraní COM1:<br />
<br />
sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1<br />
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici), <br />
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není ! <br />
(Toto může způsobit nezkušenému programátorovi potíže). <br />
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné, <br />
a s tou pak dále dle libosti pracovat.<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!<br />
<br />
sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?<br />
== 0 : není připojen klient<br />
!= 0 : je připojen klient (přes TELNET port)<br />
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)<br />
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)<br />
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Poznámka: parametry sériového rozhraní UART COM1 lze nastavit v rámci převodníku Ethernet/UART (přes RFC příkazy), nebo pomocí k tomu určené SDS-C funkce. Pozor, nastavení '''nelze''' změnit přímým zápisem hodnoty do sys[50] až sys[54] (ty jsou pouze pro čtení).<br />
<br />
Rozhraní COM6:<br />
<br />
sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6<br />
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
sys[57] 02 i R rychlost [bps] rozhraní UART - COM6 <br />
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)<br />
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Rozhraní UART - COM6 je k dispozici jen na SDS-MINI, SDS-MICRO-ST a SDS-MACRO-ST, a je přístupné jen z SDS-C programu.<br />
<br />
Doplňující statistiky (počty rx/tx bajtů atd.) jsou k dispozici na indexu 2800+, viz dále na této stránce (dostupnost těchto údajů je závislá na instalovaném aktuálním FW ve vašem SDS).<br />
<br />
<br />
== Generátor náhodných čísel ==<br />
<br />
sys[61] 06 i R generátor náhodných čísel<br />
- při každém přečtení sys[61] je poskytnuto náhodné číslo<br />
<br />
<br />
== Výsledek převodu textu na číslo ==<br />
<br />
Pro převod textu (z určené pozice pole ''text'' či ''share'') na číslo se používá funkce SDS-C: ''atoi''. Aby bylo možné výsledek převodu získat, musíte si jej přečíst ze ''sys[62]''.<br />
<br />
sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''<br />
<br />
Pro více informací se podívejte přímo na návod k této funkci.<br />
<br />
<br />
== Nastavení rychlosti provádění SDS-C programu ==<br />
<br />
SDS-C program může ovlivnit rychlost svého vykonávání. Buď se každá instrukce provede právě s minimálním krokem co 1 msec, nebo se dá tato (často žádoucí) vlastnost snadno vypnout. Pozor, hodnota 1 msec není vždy garantována, např. při zavolání funkce která pracuje s pomalou periférií dojde k čekání, dokud se požadovaná funkce nedokončí.<br />
<br />
sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:<br />
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''<br />
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku) <br />
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )<br />
<br />
Poznámka: všechny SDS-C programy jsou ve výchozím stavu spouštěny se sys[63] = '''0''' (tzn. jeden celý příkaz programu je vykonán právě co 1 msec).<br />
<br />
Tohoto faktu (krok 1 msec) některé programy využívají k realizaci čekacích smyček, když se předpokládá jeden vykonaný příkaz za 1 msec. Není to však vhodné, protože SDS nedává garanci že se vždy bude jednat přesně o 1 msec (může docházet k náhodnému zdržení až o několik msec, v záležitosti na ostatní činnost systému). Pokud však vypnete toto rychlostní omezení, tak takové případné čekací smyčky přestanou plnit svou funkci (prakticky skončí mnohem dříve): proto ve svých programech používejte pouze k realizaci "čekání" pouze k tomu určené funkce, nebo případně sys[64] nebo některý z UpTime indexů či sys[137] atd.<br />
<br />
<br />
== Časování ==<br />
<br />
Pro přesnější časování programu, popř. pro spuštění nějaké události po přesně daném intervalu, lze s výhodou využít následující proměnnou:<br />
<br />
sys[64] 01 i RW sekundový odpočítávač <br />
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1, <br />
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)<br />
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)<br />
<br />
Samozřejmě lze využít i jiné způsoby, ale tento je k tomu explicitně určen, vyhovuje-li hrubý krok 1 sekunda. Pro jemnější časování jsou pak vhodnější indexy s UpTime hodnotou, nebo sys[137] pro nejvíce jemné čekání - tyto indexy ale nemají funkci odpočítávání (jsou jen pro čtení), takže hlídání obsahu si už musíte řešit sami ve svém programu.<br />
<br />
<br />
== OSI7 funkce ==<br />
<br />
OSI7 funkce jsou určeny pro komunikaci mezi SDS a vnějším světem připojeným přes Ethernet (např. se servery v Internetu).<br />
<br />
Všechny funkce OSI7 poskytují průběžný stav své činnosti:<br />
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)<br />
- význam hodnot viz [[OSI7_status_code|popis zde]]<br />
<br />
Poznámka: vždy je doporučeno, po zavolání kterékoliv OSI7 funkce, provést v programu čekání na skončení této funkce. Čekání má kontrolovat právě hodnotu v sys[65], a dokud se tato proměnná nenaplní výsledkem, nevolejte další OSI7 funkci.<br />
<br />
DNS resolv: sestavením IP[0].IP[1].IP[2].IP[3] získáte IP adresu (napr. 10.0.0.8) z DNS po úspěšném návratu z funkce DNS resolveru. Tato získaná IP adresa pak může sloužit pro různé účely, např. pro kontrolu DNS serveru jestli žije atd.<br />
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
<br />
Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).<br />
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)<br />
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru<br />
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru<br />
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru<br />
<br />
sys[74] 01 s R text, reserved (v této verzi nepoužito)<br />
<br />
Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):<br />
<br />
sys[303] 09 i R DNS RESOLV - (read:) actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
sys[303] 09 i W DNS RESOLV - write value 0xD65 (3429dec) to clear the DNS cache<br />
sys[304] 09 i R DNS RESOLV - (read:) timestamp (UTC) of the latest DNS server response (packet) as requested by dns_resolv() function (if 0 then no response received, or cache has expired)<br />
sys[305] 09 i R DNS RESOLV - (read:) get the last set hard TTL limit (0 = invalid (will use 1209600 as default), otherwise 1..MAX = time in seconds)<br />
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)<br />
<br />
<br />
HTTP GET:<br />
<br />
sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)<br />
- nastaveno po dokončení práce funkce '''http_get()'''<br />
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.<br />
<br />
sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')<br />
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',<br />
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.<br />
<br />
sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek<br />
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu. <br />
Nastavte na:<br />
<br />
== 0 : jakékoliv přijaté data jsou '''zahozena''', <br />
neuloží se (nedojde ke změně obsahu ram[] nebo text[])<br />
<br />
== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole ram[] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !<br />
<br />
sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi<br />
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])<br />
- maximální hodnota je omezena velikostí pole ram[] nebo text[]<br />
- pozor! pokud zapíšete '''0''', budou všechna data zahozena, <br />
ale i v takovém případě dojde k přepisu ram[0] (viz výše)<br />
<br />
sys[79] až sys[80] RESERVED vyhrazeno<br />
<br />
Pozor, v případě nenulového sys[77] HTTP klient čeká tak dlouho, dokud nedostane všech sys[78] bajtů odpovědi z protistrany. To je častou příčinou "problémů" kdy protistrana neodpoví dostatečně dlouhou odpovědí, a klient má stále otevřené spojení a stále čeká a čeká... až dojde na timeout. Což je pak potřeba důsledně a správně ošetřit ve vašem SDS-C programu.<br />
<br />
Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):<br />
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')<br />
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru<br />
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru<br />
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru<br />
<br />
sys[85] až sys[88] RESERVED vyhrazeno<br />
<br />
Informace z ('''interní''') ICMP PING funkcionality "IP Watchdog" (konfigurace a ovládání přes webové rozhraní SDS) (nemá souvislost s SDS-C funkcí "ping()" ) :<br />
<br />
sys[89] 06 i R IP-Watchdog: stav<br />
== 0 : není v provozu (neaktivováno ve webovém rozhraní)<br />
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)<br />
<br />
sys[90] 06 i R IP-Watchdog: poslední známé RTT<br />
== 0 .. 65533 : hodnota RTT v msec<br />
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)<br />
<br />
sys[91] 06 i R IP-Watchdog: stav výstupu<br />
== 0 : výstup není aktivován<br />
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)<br />
<br />
Informace z (SDC-C) ICMP PING funkce - '''ping()''' :<br />
<br />
sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92] <br />
== 0 : klid (není odeslán paket, nečekám na odpověď), <br />
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle<br />
== 1 : funkce '''ping()''' byla právě zavolána, <br />
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání<br />
== 2 : čeká se na odpověď od ARP <br />
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket, <br />
protože v ARP tabulce nebyl příslušný záznam)<br />
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY <br />
(požadovaný stav, funkce '''ping()''' funguje ok)<br />
== 8 : právě obdržel ECHO REPLY <br />
(byla přijata odpověď od vzdáleného zařízení)<br />
<br />
sys[93] 04 i R PING SEQ number <br />
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE <br />
na ICMP PING REQUEST odeslaný funkcí '''ping()'''<br />
<br />
sys[94] 04 i R Round Trip Time, v milisekundách<br />
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''<br />
- čas je zvyšován po pěti milisekundách (údaj v sys[94] je přímo v msec, např. hodnota 55 znamená 55 msec)<br />
<br />
Pozn.: ICMP Quench (32bit) je sestaven z "identifier" (16bit) a z "sequence number". Pomocí sys[93] můžete nastavit '''číslo sekvence''' na libovolnou hodnotu, přičemž hodnota "identifier" je napevno nastavena na "'''0x0280'''" .<br />
<br />
<br />
Funkce '''send_udp()''':<br />
<br />
sys[95] 06 i R výsledek posledního volání '''send_udp()'''<br />
Hodnoty:<br />
== 0 : nic neprovedeno<br />
Hodnota '''0''' je nastavena po startu SDS-C programu<br />
== 1 : právě bylo zahájeno odesílání paketu (provádí se)<br />
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.<br />
== 2 : byl odeslán UDP paket, úspěšně<br />
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu<br />
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz <br />
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP <br />
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz<br />
== 4 : zavolali jste funkci '''send_udp()''' dříve, <br />
než byla dokočena činnost předchozího požadavku <br />
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)<br />
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)<br />
<br />
<br />
Funkce '''snmp_send_trap()''':<br />
<br />
sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''<br />
Hodnoty:<br />
== 0 : odesílání neprobíhá<br />
== 1 : probíhá odesílání, výsledek ještě není znám<br />
== 2 : odeslání se povedlo <br />
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)<br />
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)<br />
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)<br />
<br />
sys[97] RESERVED vyhrazeno<br />
<br />
<br />
== Zápis textu do pole, Porovnání textů ==<br />
<br />
Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.<br />
<br />
sys[98] i R společné využití viz (1) a (2)<br />
<br />
06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,<br />
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'', <br />
což je hodnota užitečná pro navázání textu (zápis více textů přesně za sebou), popř. určení délky posledního zápisu:<br />
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''<br />
- kam byla zapsána terminační 0x00 funkcí '''itoh()''' <br />
- kam byla zapsána terminační 0x00 funkcí '''itoa()''' <br />
<br />
08 i R (2) výsledek porovnání textů<br />
- hodnota výsledku zavolání funkce '''textcmp()'''<br />
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci<br />
X == 0 : oba texty jsou identické<br />
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''<br />
<br />
Význam "nižší vlastní hodnoty": znak 'a' má nižší hodnotu než 'b', a to o 1; nebo např. '1' má nižší hodnotu než '4' a to o 3.<br />
<br />
Doporučeno je si to vše vyzkoušet (zavolat si každou uvedenout funkci a srovnat hodnotu v sys[98] s obsahem pole ''text[]'').<br />
<br />
<br />
== Uživatelské pozice v pevné paměti == <br />
<br />
sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]<br />
<br />
sys[100] až sys[115] <br />
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,<br />
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),<br />
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF <br />
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !<br />
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti <br />
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti <br />
<br />
Paměť EEPROM a paměť DATAFLASH (podle verze HW který máte) je permanentní (NVM), tzn. její obsah zůstane i po vypnutí zařízení nezměněn (na rozdíl od <u>ne</u>zálohované paměti RAM, do které se přistupuje pomocí pole ''ram[]'').<br />
<br />
''' Reserved '''<br />
<br />
sys[116] až sys[136] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné nastavitelné uživatelem z webového rozhraní ==<br />
<br />
Pomocí "uživatelských proměnných" (někdy taky "sdílených proměnných") lze snadno ovlivnit chod vašeho SDS-C programu, ale jen tak, jak si do něj sami naprogramujete - uživatelské proměnné neovlivňují samotný program, ale program je může číst a následně zpracovat.<br />
<br />
sys[140] až sys[149] <br />
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)<br />
(vždy 32-bit signed integer)<br />
<br />
sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu<br />
Nastavení:<br />
== 0 : stránka "control" je přístupná bez hesla, <br />
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)<br />
<br />
Uživatel, který má přístup k webové stránce, může zapsat nový obsah do těchto osmi proměnných (změnit jejich hodnotu), kdykoliv chce. Dvě doplňkové proměnné nejsou na výchozí webové stránce dostupné, ale jinak s nimi lze bez jiných omezení pracovat (SDS-C, M2M).<br />
<br />
Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.<br />
<br />
Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).<br />
<br />
Samozřejmě lze využít i přímého URL pro zápis do proměnných, což je výhodné např. při vzájemné komunikaci dvou zařízení.<br />
<br />
<br />
== Proměnné vstupů a výstupů pro všechny výrobky SDS ==<br />
<br />
'''POZOR'''<br />
<br />
'''Podle HW verze výrobku, jsou dostupné jen určité vstupy a výstupy.''' Zde je uveden plný seznam pro maximální konfiguraci, ale ne všechny HW verze mají všechno. Např. SDS-MICRO-LM má pouze dva reléové výstupy, kdežto SDS-MACRO-LM má čtyři.<br />
<br />
Vždy máme vyhrazeno 32 indexů pro vstupy a výstupy. Tyto indexy jsou tedy naplánovány pro (budoucí) maximální konfiguraci, ale většina SDS k nim nemá odpovídající HW (např. nemá všech 32 relé). Zápis a čtení do/z indexů, které nemají odpovídající fyzický protějšek, je zakázán (bude SDS ignorován, a hodnota nebude uložena pro pozdější čtení).<br />
<br />
'''Pokračování výpisu:'''<br />
<br />
sys[151] až sys[182] <br />
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)<br />
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)<br />
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu<br />
Hodnoty:<br />
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)<br />
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)<br />
<br />
Pozor, pokud u vašeho SDS (např. historické kousky SDS-MICRO-LIGHT) má číslované OPTO vstupy od nuly (né od jedničky), musíte si aktualizovate firmware v tomto zařízení, a případně upravit potisk (popis) na desce nebo krabičce.<br />
<br />
'''Důležité info:'''<br />
<br />
Pokud je (uvnitŘ SDS) na LED vstupního optočlenu signál, hodnota '''sys[]''' pro dané OPTOx dává '''0''' (nulu), naopak při nepřítomnosti signálu je přítomna '''nenulová''' hodnota (vždy testujte na nulovou a nenulovou hodnotu, jediné co je zaručeno je totiž ta nula, kdežto nenulová hodnotu může být jakákoliv - ve skutečnosti každý opto vstup má přidělenou konstantu, podle které lze tento vstup identifikovat). <br />
<br />
Pozor - "logika" optických vstupů je tedy na první pohled "obrácená" (avšak dává to přesný smysl). Jen je to potřeba vědět při psaní SDS-C programu.<br />
<br />
<br />
== Stav SDS-C programu ==<br />
<br />
Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).<br />
<br />
sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu<br />
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)<br />
<br />
Příklad: FW v SDS je (pro příklad) ze dne 24.12.2018, takže v ''sys[183]'' bude zakódováno jako 0x00180C12, tedy hodnoty 24dec 12dec 18dec zapsány jako 0x18 0x0C 0x12, což je 0x18C0C12 což je 1575954dec.<br />
<br />
Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:<br />
<br />
sys[184] 08 i RW způsob spuštění SDS-C programu<br />
== 0 : bez informace<br />
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS<br />
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)<br />
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace<br />
<br />
Stav SDS-C watchdogu:<br />
<br />
sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec<br />
== -1 : wdg není aktivní<br />
== 0 : odpočet vypršel, dojde k resetu SDS-C programu<br />
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)<br />
<br />
<br />
== Pulse-Width Modulation výstupy ==<br />
<br />
Některá SDS mají pouze jeden PWM výstup (PWM1), některá mají čtyři výstupy (rozdělené po dvou do dvou skupin: PWM1 a PWM2, pak PWM3 a PWM4).<br />
<br />
''Příklad pro PWM1:'' Konfigurace PWM1 výstupu nejprve vyžaduje zápis do sys[191], aby se nejprve nastavila provozní základní frekvence generátoru.<br />
Následně lze PWM1 výstup řídit zápisem do sys[192], kdy se podle zapsané hodnoty nastaví střída PWM výstupu (poměr log0 a log1).<br />
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.<br />
Zápis do sys[191] je potřeba jen jednou (tedy jen tehdy, když je potřeba PWM1 výstup zapnout nebo vypnout, a kdy je potřeba změnit frekvenci generátoru). <br />
Zápisy do sys[192] a nebo sys[193] se pak mohou dít samostatně (tj. není potřeba pokaždé opakovat zápis do sys[191]).<br />
<br />
Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !<br />
<br />
Pozor, pro tyto typy SDS:<br />
<br />
SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO''' <br />
<br />
Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).<br />
<br />
<br />
Podle typu SDS:<br />
<br />
SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)<br />
<br />
sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).<br />
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)<br />
<br />
sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)<br />
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).<br />
<br />
sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru <br />
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]<br />
- tato hodnota není aktualizována vůči sys[192], ani není archivována<br />
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.<br />
<br />
Hodnoty Fm větší než 1MHz prakticky nemají smysl, snažte se navrhnout svůj systém tak, aby dokázal pracovat ideálně nejvýše ve stovkách kHz.<br />
<br />
<br />
Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.<br />
<br />
SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)<br />
<br />
sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[192] až sys[195])<br />
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)<br />
<br />
sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)<br />
<br />
sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)<br />
<br />
sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[187] až sys[190])<br />
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[187] 09 i RW duty-cycle '''PWM3''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)<br />
<br />
sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[189] 09 i RW duty-cycle '''PWM4''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)<br />
<br />
sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.<br />
<br />
<br />
== Ovládání výstupů - Relé ==<br />
<br />
Zápisem do následujících systémových proměnných přímo ovládáte fyzické relé (výstupy) zařízení SDS. Pozor, protože hodnoty zapsané z SDS-C programu se záměrně neukládají do pevné paměti (tzn. nejsou načteny po resetu zařízení SDS). Je to z důvodu bezpečnosti (aby se např. neseplo relé po dlouhém výpadku napájení). Váš program si s tím musí umět poradit - vždy po zapnutí SDS musí vyhodnotit aktuální situaci a až podle toho zapínat relé.<br />
<br />
sys[196] až sys[228] <br />
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''<br />
- lze nastavit i z webového rozhraní<br />
Hodnoty:<br />
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)<br />
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)<br />
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)<br />
<br />
sys[229] až sys[230] RESERVED vyhrazeno<br />
<br />
sys[231] až sys[262] <br />
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)<br />
Hodnoty:<br />
== 0 : relé není aktivní <br />
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)<br />
!= 0 : relé je aktivní <br />
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)<br />
<br />
sys[263] až sys[265] RESERVED vyhrazeno<br />
<br />
sys[266] až sys[298] <br />
01 s R uživatelský textový název pro '''RE1''' až '''RE32''' <br />
- nastaveno ve webovém rozhraní<br />
<br />
sys[264] až sys[300] RESERVED vyhrazeno<br />
<br />
<br />
== Ovládání PDx ==<br />
<br />
Jednotlivé moduly SDS mají k dispozici dodatečné vstupy a výstupy, označené jako PDx respektive TOPB. Přesný seznam viz návod ke konkrétním modulům.<br />
<br />
Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):<br />
<br />
sys[301] 01 i RW SDS '''MICRO LM LIGHT''': stav i/o pinu D0 (0 = log0 ; nenulová hodnota v sys = log1 přítomna na pinu)<br />
SDS '''MICRO LM DIN''' a SDS '''MACRO LM''': stav výstupu D0 - MOSFET spínač na GND. Při jakékoliv nenulové hodnotě v sys[301] je MOSFET sepnutý (=D0 na GND), jinak je D0 otevřený (HiZ)<br />
SDS '''TTCPRO''': stav všech osmi pinů v portu PDx (nastavením/čtením sys[301] se přistupuje k jednotlivých osmi bitům v bajtu, kde: bit0=PD0 až bit7=PD7)<br />
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = stav PD0 MOSFET spínače (spíná na GND), bit1 = stav i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''IO6-ST''': nepoužito<br />
SDS '''MACRO-ST''': bit0 = stav PD0, bit1 = stav PD1, bit2 = stav i/o pinu TOPB, bit3 = TL-1, bit4 = stav TL-2, ostatní bity (5..7) nepoužity<br />
<br />
Řízení směru pro jednotlivé PDx resp. TOPB:<br />
<br />
sys[302] 06 i RW SDS '''MICRO LM LIGHT''': směr i/o pinu D0 (zápisem bit0 do 1 se nastaví pin D0 jako výstup) (zápisem log1 se nastaví jako vstup)<br />
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)<br />
SDS '''TTCPRO''': směr jednotlivých pinů v portu PDx (nastavením jednotlivých osmi bitů, bit0=PD0 až bit7=PD7, nastav log1 pro výstup)<br />
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = vždy v log1 (PD0 jako výstup), bit1 = směr i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''MACRO-ST''': bit0 = vždy v log1 (výstup), bit1 = vždy v log1 (výstup), bit2 = směr i/o pinu TOPB, bit3 = vždy v log0 (vstup), bit4 = vždy v log0 (vstup), ostatní bity (5..7) nepoužity<br />
<br />
TOPB: vždy typicky CMOS 3V3 pin, s možností funkce jako vstup nebo výstup (dle sys[302]), a je přímo připojený na pin SoC, pozor tedy na jeho další HW připojení.<br />
<br />
TTCPRO: Mapování je vždy od nejnižšího (LSB - bit0) bitu (PD0 = bit0, PD1 = bit1, atd. PD7 = bit7). Pro TTCPRO jsou PDx jako CMOS 3V3 piny s volbou vstupu nebo výstupu pro každý jednotlivý pin.<br />
<br />
MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).<br />
<br />
sys[306] až sys[309] RESERVED vyhrazeno<br />
<br />
== Tlačítka na desce display pro SDS-MACRO-ST ==<br />
<br />
Čtení stavu tlačítek na desce display (SDS-MST-DISP-rev1) se provádí čtením sys[301] a vyhodnocením bitu 3 (=8dec, první tlačítko) a/nebo bitu 4 (=16dec, druhé tlačítko).<br />
<br />
Ošetření na případné zákmity při stisku a uvolnění tlačítek, je potřeba provést ve vašem SDS-C programu.<br />
<br />
<br />
== Vstupy - teploměry na externí sběrnici 1-Wire&reg; ==<br />
<br />
Čidla teploty (1-W chipy pro měření teploty připojené na sběrnici; tak také údaj o teplotě z připojených modulů SDS-1W-T-RH) jsou řízena (čtena) plně automaticky zařízením SDS. Program v SDS-C má přímo přístup k výsledným hodnotám teplot.<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici<br />
<br />
Teploměry mají hodnotu uloženou v násobku '''100''' (takže např. 24.5°C je uloženo jako číslo 2450, nebo -120.65°C je -12065). Pokud není k dispozici hodnota z čidla, '''není v záznamu číslo nula (pozor !), ale záměrně tam je číslo 16777216 (2^24)'''.<br />
<br />
Pozn.: pouze SDS-MACRO-LM a SDS-MACRO-ST mají teploměry č. 17 až 32, protože má dvě samostatné sběrnice (konektory). Sběrnice A má teploměry 1 až 16, sběrnice B má teploměry 17 až 32. '''Sběrnice B je k dispozici jen pro SDS-MACRO-XX'''.<br />
<br />
sys[342] až [345] RESERVED vyhrazeno<br />
<br />
sys[346] 01 i R číslo čidla, které je právě převáděno na sběrnici '''B''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''<br />
<br />
sys[348] 01 i R číslo čidla, které je právě převáděno na sběrnici '''A''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''<br />
<br />
sys[350] až sys[381] <br />
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]<br />
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)<br />
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek<br />
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)<br />
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)<br />
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)<br />
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)<br />
<br />
sys[382] až [389] RESERVED vyhrazeno<br />
<br />
sys[391] až sys[422] <br />
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)<br />
<br />
''' Reserved ''' <br />
<br />
sys[423] až sys[430] RESERVED vyhrazeno<br />
<br />
<br />
== Vstupy: analogové vstupy pro měření napětí ==<br />
<br />
Všechny vstupy měří napětí vůči společné svorce (GND). Změřená hodnota je vždy k dispozici nejprve jako surová (raw) digitální hodnota, a poté ji SDS přepočítá dle uživatelského nastavení a také dá k dispozici.<br />
<br />
sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1<br />
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2<br />
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3<br />
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4<br />
<br />
RAW (surová) hodnota je digitální číslo, poskytnuté z interního A/D převodníku, s tím, že mu už SDS současně (pouze a jenom) odečetl uživatelem nastavený offset.<br />
<br />
Rozsah hodnoty RAW je: <br />
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)<br />
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)<br />
<br />
Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):<br />
<br />
sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[436] 01 i R Div pro A/D 1<br />
sys[437] 01 s R textový název A/D 1<br />
sys[438] 01 s R jednotka A/D 1<br />
<br />
sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[440] 01 i R Div pro A/D 2<br />
sys[441] 01 s R textový název A/D 2<br />
sys[442] 01 s R jednotka A/D 2<br />
<br />
sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[444] 01 i R Div pro A/D 3<br />
sys[445] 01 s R textový název A/D 3<br />
sys[446] 01 s R jednotka A/D 3<br />
<br />
sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[448] 01 i R Div pro A/D 4<br />
sys[449] 01 s R textový název A/D 4<br />
sys[450] 01 s R jednotka A/D 4<br />
<br />
'''Pozor!''' Hodnoty pro jednotlivé A/D vstupy (tj. Raw Hodnoty v sys[431 až 434]) '''už mají odečtený Offset''' (je to provedeno uvnitř firmware už při zpracovávání A/D převodu) ! <br />
Proto Offset už ve svém SDS-C programu z Raw hodnot neodečítejte (bylo by to odečítáno podruhé). Pro přepočet z Raw na finální hodnotu vám zbývá (správně) použít jen "Div".<br />
<br />
Poznámka: zařízení SDS-MINI (a další z řady SDS ST) už mohou mít text v položce "jednotka A/D x" delší než jeden znak (na rozdíl od původního SDS-MICRO-LM atd., kde to bylo omezeno na jeden jediný znak).<br />
<br />
''' Reserved '''<br />
<br />
sys[451] až sys[458] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné pro S0 impulsní vstup ==<br />
<br />
sys[459] 01 i RW stav tarifu <br />
== 0 : T0 (vysoký tarif)<br />
== 1 : T1 (nízký tarif)<br />
<br />
sys[460] až sys[492] <br />
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],<br />
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )<br />
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60<br />
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh<br />
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty, <br />
pak sem v takovém případě nastavte číslo 1<br />
- platné hodnoty: 1 až 65280 (včetně)<br />
<br />
sys[493] až sys[525] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[526] až sys[558] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[559] až sys[591] <br />
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)<br />
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD<br />
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající<br />
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).<br />
<br />
sys[592] až sys[624] <br />
01 i R změřená časová vzdálenost mezi dvěmi nejposlednějšími zachycenými impulsy na S0 vstupu (aktuální impuls a předchozí impuls)<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
sys[625] až sys[657] <br />
01 i R změřený čas od úplně posledního impulsu zachyceného na S0 vstupu, tzn. "doba bez impulsu" nebo také "doba od posledního impulsu"<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
poznámka: tarif T0 a tarif T1 závisí na uživatelem zvoleném externím signálu (přeneseno do sys[459]), viz informace na stránce ohledně [[S0]]. Celková hodnota impulsů je samozřejmě součtem těchto dvou impulsních akumulátorů. Pokud není tarifní rozlišení využito, je vše zapisováno do akumulátoru pro T0. <br />
<br />
poznámka: časová vzdálenost mezi impulsy se používá pro výpočet aktuálního výkonu (popř. průtoku atd. dle použitého měřiče) - můžete toho využít ve svém SDS-C programu.<br />
<br />
poznámka: "Poměr MTD" zahrnuje všechny měřící transformátory (MTD), předřazené elektroměru (pouze pokud to už není započítáno v impulsní konstantě). Pokud je S0 vstup využit pro jiný typ měřiče (vodoměr a podobné), kde je připojení MTD nesmysl, tak se v konfiguraci musí do této položky nastavit hodnota 1. Samozřejmě jde s určitou výhodou použít i jinou konfiguraci, protože tato hodnota je použita jako "druhý dělitel" u výpočtu počtu S0 impulsů na velikost kroku energetické jednotky. Určení této hodnoty pro jiné měřiče sleduje stejné matematické postupy jako určení této hodnoty pro elektroměr s předřazeným MTD, jen jednotky budou samozřejmě jiné.<br />
<br />
sys[658] až sys[670] reserved for future use<br />
<br />
poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).<br />
<br />
<br />
== Speciální vstupy a výstupy ==<br />
<br />
Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.<br />
<br />
'''Pouze pro SDS MICRO (LM) LIGHT:'''<br />
<br />
sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
<br />
Tyto zmíněné čtyři ''sys[]'' jsou dostupné '''pouze''' na modulu SDS MICRO '''LIGHT''' popř. '''DIN''', a to jen s verzí firmware 9.1.2011 nebo novější.<br />
<br />
SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.<br />
<br />
SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MACRO LM, SDS MICRO ST, SDS MACRO ST, SDS UPS, SDS IO6, SDS IO6 ST, SDS TTCPRO, SDS MINI: tyto výstupy '''nejsou k dispozici'''.<br />
<br />
Vše to jsou logické výstupy, s CMOS 3V3 logickými úrovněmi (pro obecné použití je externí pull-up 47kOhm nutný). Lze to použít především pro ovládání BSS138 MOSFETů, např. pro spínání dalších relé (v případě použití BSS138 nedávejte externí pull-up, ale naopak dejte pull-down na GND o hodnotě 47kOhm).<br />
<br />
'''Pouze pro SDS MACRO ST:'''<br />
<br />
Alternativa k sys[301]. Hodnota odpovídá logické úrovni na daném vstupu TL1 (TL2). Při osazené desce MACRO-ST-LCD jsou na tyto vstupy připojeny tlačítka (pak při stisku TL1, TL2 je zde hodnota 0, v klidu 1).<br />
<br />
sys[671] 02 i R čtení stavu TL1<br />
sys[672] 02 i R čtení stavu TL2<br />
<br />
'''Pájecí plošky CFG:'''<br />
<br />
Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.<br />
<br />
V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.<br />
Ploška CFG1 je vyhrazena pro vnitřní použítí samotného firmware SDS, a ploška CFG2 bude eventuálně uvolněna pro libovolné použití uživatelem (čtení z SDS-C).<br />
Takový firmware se teprve chystá (SDS TTCPRO).<br />
<br />
sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)<br />
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)<br />
<br />
<br />
== Speciální proměnné pro SDS-UPS ==<br />
<br />
SDS UPS nabízí, kromě již zmíněných proměnných (viz výpis výše), i doplňkové proměnné, specifické pro tento výrobek. Tyto rozšířené systémové proměnné jsou k dispozici ve firmware od 25.4.2011 .<br />
<br />
SDS-UPS má všechny sys[0] až sys[699] shodné s SDS-MICRO. Rozdíl je samozřejmě v počtu a osazení periférií.<br />
<br />
Pokud nejste spokojeni s originálním nabíjecím algoritmem, máte možnost si ho celý naprogramovat sami v SDS-C: všechny potřebné vstupní a výstupní údaje (proměnné) jsou vám k dispozici. Popřípadě, pokud chcete jen sledovat situaci, můžete je také využít (např. pro logování nabíjecího a vybíjecího proudu akumulátoru a tak dále).<br />
<br />
sys[700] 02 i R reserved<br />
sys[701] 02 i R reserved<br />
sys[702] 02 i R reserved<br />
sys[703] 02 i R reserved<br />
<br />
'''Přepínač algoritmů:'''<br />
<br />
sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:<br />
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)<br />
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)<br />
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C<br />
<br />
Pokud zvolíte vlastní (ruční) řízení, musíte trvale řídit nabíjení sami pomocí programu v SDS-C. Vlastní ovládání vejde v platnost zápisem čísla 345 nebo 824 do sys[704]. Tento zápis provedete pouze jednou na začátku programu, a dále pak musí trvale následovat váš algoritmus. <br />
<br />
Pokud zvolíte 345, jediné co má váš program za úkol, je řídit samotný nabíjecí proces - toto je výhodné, když se nechcete zatěžovat hlídáním provozních stavů (tj. výpadek napájení atd.), což za vás v tomto režimu udělá původní firmware.<br />
<br />
Pokud zvolíte 824, musíte sami kompletně řídit všechno chování UPS, tj. nejenom nabíjecí algoritmus, ale i detekce výpadku napájení, přepínání mezi stavy, indikační LED, a tak dále.<br />
<br />
sys[705] až sys[731] reserved<br />
<br />
Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.<br />
<br />
Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.<br />
<br />
'''Vstupy a konfigurace:'''<br />
<br />
sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A<br />
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru<br />
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu<br />
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru<br />
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu<br />
<br />
Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě. <br />
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu. <br />
Měření proudu je specifické, protože měření ukazuje kladný i záporný proud, takže 0A je na hodnotě sys[732] (typicky 2047), všechno co je pod touto hodnotu je záporný proud, všechno nad je kladný proud. Znaménko proudu ukazuje, kam proud teče (např. záporný = vybíjení akumulátoru, atd.).<br />
<br />
sys[737] až sys[739] reserved<br />
<br />
Následuje konfigurace provedená uživatelem ve webovém rozhraní.<br />
Hodnoty jsou přímo v rozmezí 0 až 4095, takže je lze PŘÍMO použít se surovými hodnotami z A/D převodu (tzn. zařízení se už postaralo o převod údajů zadaných uživatelem ve webovém rozhraní na tento formát). V důsledku je pak realizace algoritmu velmi snadná.<br />
<br />
sys[740] 02 i R primary voltage to say target is ok (pri_pvts)<br />
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)<br />
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)<br />
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)<br />
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)<br />
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)<br />
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)<br />
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)<br />
sys[748] 02 i R flag: do not switch accu off (aku_dach)<br />
<br />
Hodnoty sys[740] až sys[748] jsou konfigurační údaje (uživatel je změnil přes webové rozhraní, a tím se uložili do pevné paměti, takže vydrží reset nebo vypnutí zařízení). Pokud do nich v SDS-C programu zapíšete, tato nová zapsaná hodnota zůstane platná až do resetu nebo vypnutí, nebo do ručního přepsání uživatelem (ve webovém rozhraní). Zápis do těchto konkrétních sys[] nezpůsobí uložení nových hodnot do pevné paměti.<br />
<br />
sys[749] až sys[760] reserved<br />
<br />
'''Výstupy:'''<br />
<br />
Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !<br />
<br />
<br />
sys[761] 02 i RW ovládání vypínání nabíječe<br />
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])<br />
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)<br />
<br />
sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe <br />
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)<br />
!= 0 : zásah do zpětné vazby (posun rozsahu)<br />
(vhodné pro skokové zvýšení výstupního napětí nabíječe, <br />
když už nereaguje v původním rozsahu)<br />
<br />
sys[763] 02 i RW ovládání odpojovače baterie <br />
== 0 : spínač vypnutý (baterie odpojena od zátěže)<br />
!= 0 : spínač sepnutý (baterie připojena)<br />
<br />
sys[764] 02 i RW indikační LED - nabíjení akumulátoru<br />
== 0 : LED svítí (informace: akumulátor je nabíjen)<br />
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)<br />
<br />
sys[765] 02 i RW indikační LED - výpadek primárního vstupu<br />
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)<br />
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)<br />
<br />
'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:<br />
<br />
sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)<br />
- minimální hodnota = 1<br />
- maximální hodnota = 2497<br />
<br />
sys[767] až sys[769] RESERVED vyhrazeno<br />
<br />
Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':<br />
<br />
sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx<br />
<br />
sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx<br />
<br />
sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx<br />
<br />
Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):<br />
<br />
UPS_PROVOZ_START 0<br />
UPS_PROVOZ_PRIOK 1<br />
UPS_PROVOZ_PRIOK_CHARGING 2<br />
UPS_PROVOZ_ONLY_BATT 4<br />
UPS_PROVOZ_NO_BATT 8<br />
<br />
UPS_NABREZIM_CC 0<br />
UPS_NABREZIM_CV 2<br />
UPS_NABREZIM_PAUZA 4<br />
UPS_NABREZIM_URCENI_REZIMU 8<br />
<br />
UPS_BATERIE_ODHAD_NEZNAM 0<br />
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1<br />
UPS_BATERIE_ODHAD_OK_NABIJIM 2<br />
UPS_BATERIE_ODHAD_PLNE_NABITO 4<br />
<br />
<br />
== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==<br />
<br />
Připojené moduly [[SDS_1W_T-RH]] jsou připojeny na 1-W sběrnici, a mají v sobě chip, který měří hodnotu ze sensoru vlhkosti (který je současně umístěn na modulu SDS-1W-T-RH) a současně měří i teplotu a napájecí napětí pro sensor vlhkosti. <br />
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.<br />
<br />
K dispozici jsou jak surové hodnoty (změřené v rámci modulu SDS-1W-T-RH), tak i hodnota kompenzované (skutečné) relativní vlhkosti v místě umístění modulu.<br />
<br />
<br />
Změřená teplota je uložena na standardních indexech:<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 degC<br />
<br />
Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):<br />
<br />
sys[800] až sys[831] <br />
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
sys[832] až sys[863] <br />
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
SDS provádí přepočet na údaj RH v procentech (0 až 100):<br />
<br />
sys[864] až sys[895] <br />
08 i R hodnota RH (0 až 100, v procentech RH) kompenzovaná podle rovnice pro čidlo HIH-503x (výpočet z Vad, kompenzace na Vdd a Temp).<br />
<br />
Rezerva (zatím nepoužito):<br />
<br />
sys[896] až sys[899] RESERVED vyhrazeno<br />
<br />
<br />
== Doplňující informace pro 1-Wire zařízení ==<br />
<br />
1-Wire sběrnice u zařízení SDS umožňuje komunikaci s celou řadů 1-W chipů: [[OneWire|seznam je zde]]. Přístup k chipům na 1-W sběrnici se liší na dva typy: chipy (čidla) které si SDS interně zpracuje (např. měření teploty), a všechny ostatní chipy (které SDS jen umí vyhledat a oznámit, ale dále s nimi nekomunikuje).<br />
<br />
<br />
'''1-Wire chipy interně zpracovávané SDS'''<br />
<br />
Tyto chipy jsou plně automaticky obsluhovány prostřednictvím firmware SDS - není potřebná opakovaná intervence uživatele, ten si pouze čte stále aktuální výsledky měření teplot z jednotlivých čidel.<br />
<br />
Poznámka: Pro změřené hodnoty z 1-W čidel teplot, jsou k dispozici tyto indexy: '''sys[310]''' až '''sys[430]''', a '''sys[900]''' až '''sys[931]'''.<br />
<br />
K dispozici je textové vyjádření (hex znaky) ROM CODE hodnoty načtené pro danou pozici zpracovávaného chipu na 1-W sběrnici.<br />
<br />
Zařízení SDS mohou mít jednu [A] nebo dvě ( nezávislé, [A] a [B] ) 1-Wire sběrnice, a každá sběrnice má maximálně 16 připojených chipů.<br />
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:<br />
<br />
sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále až<br />
<br />
sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):<br />
<br />
sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále . . . až<br />
<br />
sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.<br />
<br />
Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.<br />
<br />
Poznámka: ROM CODE pro 1-W chipy jsou k dispozici pouze jako ucelené texty (string). Bajtový rozpad jednotlivých položek není k dispozici.<br />
<br />
sys[931] až sys[939] reserved<br />
<br />
<br />
<br />
'''Ostatní 1-Wire chipy'''<br />
<br />
Pro ostatní 1-W chipy, které SDS "nezná" (tzn. nekomunikuje s nimi, jen je umí na sběrnici vyhledat), jsou jejich ROM CODE odděleny do samostatných '''sys[]''' položek.<br />
<br />
Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci. <br />
Na základě zavolání této funkce dojde k vynulování všech příslušných '''sys[]''' (od indexu 940 resp. 970) pro danou sběrnici, a provede se pokus o přečtení připojeného chipu.<br />
Pokud se to povede, bude nalezený ROM CODE (spolu s časovou značkou okamžiku přečtení) vložen do příslušných '''sys[]''', <br />
nebo bude nastaven chybový kód.<br />
<br />
Pozor, k SDS lze připojit více různých "ostatních" chipů, ale zdejší funkce najde jenom ten první z nich a ostatní už ignoruje. <br />
Ostatní chipy lze samozřejmě připojit na kteroukoliv sběrnici, i když na ní jsou připojeny i chipy se kterými SDS komunikuje (např. teploměrné chipy).<br />
<br />
Jednotlivé chipy se rozlišují pomocí hodnoty ''ID family-code'' (jeden bajt). Pro chip DS1990A je ''0x01'', hodnoty pro jiné chipy viz datasheet výrobce pro konkrétní chip.<br />
<br />
Obecný stav sběrnic:<br />
<br />
sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů<br />
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů<br />
:<br />
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici<br />
<br />
== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice<br />
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)<br />
<br />
== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu<br />
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)<br />
<br />
== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)<br />
<br />
== 8 : byl přečten ROM CODE z připojeného ostatního chipu<br />
(už lze také požádat o další nové čtení 1-W sběrnice)<br />
<br />
== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici <br />
(zkuste provést rescan/čtení znovu)<br />
<br />
sys[942] až sys[949] reserved<br />
<br />
'''Pro sběrnici [A]:'''<br />
<br />
sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[951] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire<br />
:<br />
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[953] 06 i R romcode[1] (1-W: serial code)<br />
sys[954] 06 i R romcode[2] (1-W: serial code)<br />
sys[955] 06 i R romcode[3] (1-W: serial code)<br />
sys[956] 06 i R romcode[4] (1-W: serial code)<br />
sys[957] 06 i R romcode[5] (1-W: serial code)<br />
sys[958] 06 i R romcode[6] (1-W: serial code)<br />
sys[959] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[960] až sys[969] reserved<br />
<br />
'''Pro sběrnici [B]:'''<br />
<br />
sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[971] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire<br />
:<br />
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[973] 06 i R romcode[1] (1-W: serial code)<br />
sys[974] 06 i R romcode[2] (1-W: serial code)<br />
sys[975] 06 i R romcode[3] (1-W: serial code)<br />
sys[976] 06 i R romcode[4] (1-W: serial code)<br />
sys[977] 06 i R romcode[5] (1-W: serial code)<br />
sys[978] 06 i R romcode[6] (1-W: serial code)<br />
sys[979] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[980] až sys[989] reserved<br />
<br />
Všimněte si, že SDS v tuto chvíli umožňuje pouze rescan 1-W sběrnice, kdy hledá pouze '''jeden''' připojený "ostatní 1-W chip" (ten první na který narazí, ten ohlásí, a nehledá dále). <br />
<br />
'''Pozor''':<br />
<br />
Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy, <br />
bude při tomto rescanu uveden pouze první nalezený ostatní chip (tj. ten, který má nejnižší ROM-CODE ze všech připojených ostatních chipů).<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[990] až sys[1023] reserved<br />
<br />
<br />
== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==<br />
<br />
'''Přímý přístup do LCD Frame Buffer paměti:'''<br />
<br />
sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)<br />
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst<br />
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)<br />
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye<br />
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)<br />
<br />
Tyto položky jsou dosupné '''pouze a jenom''' na SDS-MACRO-LM kde je vyžadován firmware od 24.11.2016 nebo novější, a na SDS-MACRO-ST (všechny FW verze).<br />
<br />
Jakékoliv změny (zápis) se promítnou pouze do frame bufferu (tedy v paměti SDS) - ale aby se následně tento frame buffer (jeho změněný obsah) eventuálně vykreslil na LCD, je potřeba zavolat příslušnou SDS-C funkci !<br />
<br />
Čtení ze sys poskytuje přímý přístup do frame bufferu (jeho aktuální obsah, tedy opět ne nutně to co je právě vidět na LCD).<br />
<br />
Pokud nepoužíváte LCD (sandwich desku), můžete tuto oblast 528 bajtů využít pro jakékoliv své účely. V podstatě se pak jedná o rozšiřující RAM pamět pro váš SDS-C program.<br />
<br />
'''Pozor''' SDS-MACRO-ST<br />
<br />
SDS MACRO ST provádí automatické aktualizace (zápis) do LCD bufferu, pokud se o tento buffer nepřihlásí SDS-C program. Proto, pokud na MACRO-ST chcete využít LCD buffer pro jiné své účely, musíte to nejprve SDS říct. Znovu, toto platí jen pro MACRO-ST - ''není to potřeba pro MACRO-LM (které tam po zapnutí nahraje logo a pak už na buffer za běhu nesáhne)''. Pro MACRO-ST zavolejte kteroukoliv SDS-C funkci pro přístup na display (např. clear) a je to - tím se přepne vlastnictví LCD bufferu pro SDS-C program.<br />
<br />
== Vyhrazená oblast ==<br />
<br />
'''Zbytek:'''<br />
<br />
sys[1552] až sys[1663] reserved<br />
<br />
<br />
== Bateriově Zálohovaná Paměť ==<br />
<br />
'''POUZE PRO: SDS-TTCPRO a SDS-MINI a SDS-MICRO-ST a SDS-MACRO-sT a SDS-IO6-ST !''' (tedy ty s baterií) - všechny jiné SDS První Řady tyto specifické indexy v sys[] nemají k dispozici!<br />
<br />
Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější. <br />
<br />
sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)<br />
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot<br />
- každý index má k dispozici 32 bitů (tj. celý signed integer)<br />
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)<br />
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")<br />
<br />
Pozor! Oblast záložní paměti je k dispozici pouze na vybraných zařízeních SDS (ty, které mají osazenu baterii pro tyto účely). Údaje se nesmazají změnou programu (nahráním nového programu), ani se nesmazají resetem zařízení (kromě aktivace RSTD - pozor!), tzn. vydrží a zůstanou, a to dokonce i po celou dobu výpadku externího napájení (tak dlouho, dokud se nevybije záložní baterie).<br />
<br />
''(Pouze) pokud baterie v daném SDS není'': tak jsou údaje ztraceny po výpadku napájení (ale po dobu přítomnosti externího napájení jsou k dispozici). Při takové situaci není zaručen obsah těchto dat po zapnutí (měl by být nulový, ale bez záruky).<br />
<br />
<br />
== Další informace ze S0 vstupů ==<br />
<br />
Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.<br />
<br />
Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:<br />
<br />
sys[1792] až sys[1823] <br />
07 i R cena za jednotku v režimu T0<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1824] až sys[1855] <br />
07 i R cena za jednotku v režimu T1<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1856] až sys[1887] <br />
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")<br />
- text<br />
<br />
sys[1888] až sys[1919]<br />
07 s R název měny, podle nastavení (např. text "CZK")<br />
- text<br />
<br />
sys[1920] až sys[1951] <br />
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")<br />
- text<br />
<br />
sys[1952] až sys[1983] <br />
07 s R název činnosti, podle nastavení (např. text "spotřeba")<br />
- text<br />
<br />
sys[1984] až sys[2015] <br />
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")<br />
- text<br />
<br />
sys[2016] až sys[2047] <br />
07 i R konfigurační detaily pro daný S0 vstup<br />
- bit 0 nastaven = je to aktivní S0 vstup<br />
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)<br />
<br />
Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2048] až sys[2198] reserved<br />
<br />
<br />
== MQTT klient ==<br />
<br />
Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:<br />
<br />
sys[2199] 09 i R podpora MQTT<br />
0 = NE<br />
1 = ANO, verze MQTT 3.1.1, SDS první část implementace<br />
2..max = (reserved)<br />
<br />
Každé nové připojení k Brokeru:<br />
<br />
sys[2200] 09 i R stav průběhu mqtt_connect()<br />
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno a odeslán CONNECT požadavek<br />
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )<br />
8 = probíhá odpojování, čekáme na výsledek (na odpojení)<br />
<br />
Po zavolání mqtt_connect(...) je nutné testovat sys[2200] na výslednou hodnotu. Funkci mqtt_connect(...) nelze volat, je-li sys[2200] na hodnotě 1, 2, 8 nebo 16 (nejprve je v takových případech potřeba provést odpojení pomocí mqtt_disconnect() funkce). Pro úplný test, je-li připojení z SDS do Brokeru úplné, je potřeba ověřit i hodnotu v sys[2201]. Teprve pokud oba tyto sys jsou na správné hodnotě, lze s Brokerem komunikovat.<br />
<br />
sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"<br />
-7 = nepoužito<br />
-6 = timeout při čekání na CONNACK, nepřipojeno<br />
-5 = nepoužito<br />
-4 = nepoužito<br />
-3 = nepoužito<br />
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)<br />
-1 = idle, nepřipojeno<br />
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)<br />
1 = MQTT 0x01: Connection Refused, unacceptable protocol version<br />
2 = MQTT 0x02: Connection Refused, identifier rejected<br />
3 = MQTT 0x03: Connection Refused, Server unavailable<br />
4 = MQTT 0x04: Connection Refused, bad user name or password<br />
5 = MQTT 0x05: Connection Refused, not authorized<br />
<br />
Hodnotu v sys[2201] lze číst a zpracovat pouze pokud je sys[2200] na hodnotě 16 (to znamená, pouze pokud SDS obdrží odpověď CONNACK od MQTT brokera).<br />
<br />
Před a po každém volání mqtt_publish() a nebo mqtt_subscribe() funkcí je potřeba sledovat obsah následují položky:<br />
<br />
sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci<br />
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat<br />
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu<br />
-4 = nespravne parametry (počet parametrů)<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity<br />
0 = nepoužito<br />
1 = mqtt_publish() probíhá<br />
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci<br />
4 = mqtt_subscribe() probíhá - čekám na SUBACK<br />
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci<br />
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)<br />
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce<br />
<br />
Informativní položka:<br />
<br />
sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru<br />
(objeví-li se chyba, dojde k okamžitému odpojení)<br />
<br />
Nastavení (položka 2198 je k dispzoici až od FW 11/2025):<br />
<br />
sys[2198] 09 i R mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ) <br />
sys[2198] 09 i W write ( default: 0b00110001 )<br />
<br />
Zatím nepoužité pozice:<br />
<br />
sys[2204] až sys[2208] reserved<br />
<br />
Pro každou příchozí datovou zprávu z Brokeru, je tato zpráva uložena do následujících sys: (pozor, každá nová příchozí zpráva přepíše předchozí údaje)<br />
<br />
sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)<br />
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)<br />
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)<br />
<br />
SDS umí přijaté datové zprávy uchovat, v rámci následující tabulky. Toto je důležité zejména pokud různé zprávy přicházejí velice rychle za sebou, aby se pro SDS-C program neztratili.<br />
<br />
Nejvíce lze mít až 32 položek (řádků) v tabulce, nicméně některá SDS nemají ve své paměti dostatečné místo a počet je tedy omezen. Pozor na to při psaní programu !<br />
<br />
sys[2209] 09 i R počet řádků v tabulce pro dané SDS (různé SDS mají různě volnou paměť, proto je v nich i různý počet použitelných Subscribe položek)<br />
<br />
Jednotlivé položky v tabulce příchozích zpráv:<br />
<br />
sys[2211] až sys[2241] <br />
09 s R název položky (Topic Name) pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2242] až sys[2249] reserved<br />
<br />
sys[2251] až sys[2281] <br />
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2282] až sys[2289] reserved<br />
<br />
sys[2291] až sys[2321] <br />
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru<br />
(pro detekci změny - příchozí zprávy z Brokeru)<br />
0 = zatím nic nepřišlo<br />
1..MAX = hodnota uptime v okamžiku poslední změny<br />
<br />
Nastavení Topic názvů každé položky (tedy "zápis" do sys[2211] až sys[2241]) se provede funkcí mqtt_subscribe(), které zadáváte pozici v této tabulce a název Topicu. Pokud se Subscribe nepovede, zůstane pozice v tabulce prázdná. Po připojení k Brokeru je tabulka vždy zcela prázdná, a SDS-C program si ji vždy musí dle potřeby naplnit. Pokud Broker pošle aktualizaci obsahu (value) na některou z přihlášených Topic položek, které SDS v této tabulce má, tak SDS automaticky přepíše patřičný řádek tabulky (tj. obsah jednoho ze sys[2251] až sys[2281]) a patřičně aktualizuje časovou známku změny.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2322] až sys[2398] reserved<br />
<br />
<br />
== MODBUS-TCP klient ==<br />
<br />
Ověření FW v SDS:<br />
<br />
sys[2399] 09 i R podpora pro MODBUS TCP<br />
0 = NE<br />
1 = ANO (první verze implementace v SDS)<br />
<br />
Každé nové TCP spojení na server:<br />
<br />
sys[2400] 09 i R stav průběhu modbus_tcp_connect()<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno, můžete komunikovat <br />
<br />
MODBUS funkce - každá má svůj nezávislý stavový údaj:<br />
<br />
sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
pro všechny tyto stavy platí následující hodnoty:<br />
-6 = timeout (neprovedeno), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty), můžete volat další funkci<br />
-4 = nespravne parametry (počet parametrů), můžete volat další funkci<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity, lze volat funkci<br />
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci<br />
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci<br />
256 = pracuji, čekejte na aktualizovanou hodnotu<br />
<br />
sys[2417] až sys[2462] reserved<br />
<br />
sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
Přijatá data (funkce _read) - obsah je aktualizován pro každou novou přijatou MODBUS zprávu. Výsledky (přijatá data) jsou vždy uloženy do následujících sys (bez ohledu na typ MODBUS funkce).<br />
<br />
sys[2465] 09 i R timestamp poslední přijaté zprávy<br />
(vhodné pro detekci nové přijaté zprávy)<br />
<br />
sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu<br />
(počet celých položek)<br />
<br />
sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy)<br />
<br />
sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy) <br />
<br />
sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])<br />
(MODBUS způsob číslování položek - adresa 1..n)<br />
<br />
sys[2470] až sys[2719]<br />
09 i R přijaté hodnoty pro poslední přijatou zprávu<br />
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input<br />
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr<br />
<br />
Pro funkce 0x01 a 0x02 jsou přijatá data kódována v jednobitovém tvaru, vždy po osmi bitech na jeden sys[]. Takže prvních osm bitů naleznete v sys[2465], dalších osm bitů v sys[2466] a tak dále.<br />
<br />
Pro funkce 0x03 a 0x04 jsou přijaté hodnoty registrů (MODBUS: vždy int16_t) uloženy postupně zasebou (tak jak přišli ve zprávě) do jednotlivých sys[], takže první registr je v sys[2465], druhý ve sys[2466] atd.<br />
<br />
<br />
Rezerva<br />
<br />
sys[2715] až sys[2809] reserved<br />
<br />
<br />
== Statistiky COMx ==<br />
<br />
COM1:<br />
<br />
sys[2810] 09 i R reserved<br />
<br />
sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1<br />
<br />
sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1 <br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1<br />
<br />
sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1<br />
<br />
sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1 <br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1<br />
<br />
<br />
Rezerva<br />
<br />
sys[2817] až sys[2860] reserved<br />
<br />
<br />
COM6:<br />
<br />
sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6<br />
<br />
sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6<br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6<br />
<br />
sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6<br />
<br />
sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6<br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6<br />
<br />
Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).<br />
<br />
<br />
== Konec dokumentu ==<br />
<br />
'''Konec dokumentu.'''</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS-C:_sdsc_sysp&diff=969SDS-C: sdsc sysp2025-11-15T11:11:23Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS. <br />
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).<br />
<br />
== Definice systémových proměnných SDS-C : pole sys[] ==<br />
<br />
Tzv. "systémová proměnná" je prvek v programovacím jazyku SDS-C, který má textový název, a se kterým se dá pracovat - číst hodnotu z proměnné a zapisovat hodnotu do proměnné. Často je čtení a zápis svázáno s fyzickou akcí (např. zápis do konkrétní systémové proměnné změní stav relé).<br />
<br />
SDS-C obsahuje celou řadu vyhrazených, předem pevně definovaných systémových proměnných. Tyto proměnné obsahují aktuální online informace a údaje, vzhledem ke stavu zařízení. Dá se jimi také zařízení (resp. periférie) přímo ovládat. Úplný seznam je právě na této stránce.<br />
<br />
Proměnné poskytované SDS-C a navázané na HW zařízení, jsou označeny jako '''sys[x]''', kde index '''x''' je číslo do 0 do 1023 (popřípadě až do 2048 ale to jen na určitých typech zařízení).<br />
<br />
Tyto proměnné lze číst, popř. do nich zapsat novou hodnotu. To vše můžete provést ve svém SDS-C programu, nebo přes některou z komunikačních funkcí (např. UDP protokolem, nebo přes webové rozhraní).<br />
<br />
<br />
''Legenda k tabulce:''<br />
<br />
Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).<br />
<br />
Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.<br />
<br />
Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW'''). <br />
<br />
Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.<br />
'''Význam hodnot:'''<br />
* '''01''' - první verze, výchozí firmware ze začátku roku 2010<br />
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011<br />
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011 <br />
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější<br />
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější<br />
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější<br />
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější<br />
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější<br />
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější<br />
<br />
Všechny proměnné označené jako rezerva mohou být v budoucích verzích firmware nějak využity. Pokud jsou však pro tuto verzi firmware označeny jako rezerva, pak se nesmí používat (zapisovat do nich, kvůli budoucí kompatibilitě). Při čtení obvykle vrací hodnotu nula, ovšem jakmile budou v novém firmware využity, už budou vracet konkrétní hodnotu.<br />
<br />
Pokud máte starší verzi firmware, je možné, že některé později přidané položky nebudou k dispozici. Řešením je udržovat firmware ve vašem zařízení vždy aktuální.<br />
<br />
Jazyk SDS-C indexuje všechny pole od čísla 0 (nula) - všechna pole, tj. "sys[]", "ram[]", "text[]", začínají se svým obsahem od indexu nula.<br />
<br />
'''Pozor''' však na číslování hardware vstupů a výstupů, ty jsou číslovány dle "elektrikářských" zvyklostí, to znamená že číslování začíná od čísla '''1''' ('''jednička''') - toto ale nemá hlubší vliv na SDS-C.<br />
<br />
Pokud narazíte na takové zařízení SDS, které má ještě velmi starou verzí webového rozhraní, kde byly ještě některé vstupy číslovány od nuly, aktualizujte si toto zařízení aby používalo nejnovější firmware.<br />
<br />
<br />
'''Důležité upozornění'''<br />
<br />
Protože SDS-C ''umí pracovat pouze a jen'' s '''32-bit signed''' integer čísly (tj. 1-bit znaménko a 31-bitů číslo, typ int32_t), tak dochází k (očekávané) konverzi '''32-bit unsigned''' čísel (tj. bez znaménka 32-bitů číslo, typ uint32_t) mezi vnitřními hodnotami v SDS a reprezentací v SDS-C (například když takové unsigned číslo je dotazováno například přes čtení "sys[]" hodnot).<br />
<br />
Jinýmy slovy - uvnitř SDS jsou drženy některé hodnoty jako 32-bit unsigned. Ale protože SDS-C pracuje pouze s 32-bit signed čísly, pak při čtení takových čísel zevnitř SDS jsou tyto čísla prezentovány v SDS-C jako 32-bit signed. Bitově se nezmění, jen se "mění" pohled na to, co který bit znamená, viz text dále.<br />
<br />
''Příklad:'' <br />
Hodnota "sys[625]" reprezentuje "uplynulý čas od posledního zachyceného S0 impulsu na daném S0 vstupu". Tato hodnota je udržována uvnitř SDS a program SDS-C k ní má přístup.<br />
Tento čas je udán v milisekundách a začína na nule, a s každou milisekundou ze zvýší o jedničku. Protože SDS udržuje toto počítadlo (uvnitř své paměti) jako '''32-bit unsigned''', tak jakmile dojde k dopočítání do 31-bitů (tj. 2147483647) a překlopí se tedy 32. bit (tj. na 2147483648), tak SDS-C při čtení "sys[625]" vrátí zápornou hodnotu (tj. -2147483648). Toto je v pořádku - pokud si vypíšete jednotlivé bity, tak budou stále přesně odpovídat, ale tím že SDS-C interpetuje všechny čísla jako '''32-bit signed''', tak vzorovou hodnotu použije a zobrazí jako zápornou.<br />
<br />
<pre><br />
skutečná binární hodnota | 32-bit signed | 32-bit unsigned<br />
(32-bit) | SDS-C integer | (internal SDS)<br />
----------------------------------+---------------+-----------------<br />
00000000000000000000000000000000 | 0 | 0<br />
00000000000000000000000000000001 | 1 | 1<br />
00000000000000001111111111111111 | 65535 | 65535<br />
01111111111111111111111111111111 | 2147483647 | 2147483647<br />
10000000000000000000000000000000 | -2147483648 | 2147483648<br />
10000000000000000000000000000001 | -2147483647 | 2147483649<br />
10000000000000001111111111111111 | -2147418113 | 2147549183<br />
11111111111111111111111111111111 | -1 | 4294967295<br />
11111111111111111111111111111110 | -2 | 4294967294<br />
11111111111111111111111111111101 | -3 | 4294967293<br />
</pre><br />
<br />
Jak lze vidět, SDS vždy (ať ve svém firmware, tak v SDS-C kódu a proměnných) udržuje hodnoty ve stejném ''binárním'' obsahu. Jen interpretace a další práce s čísly je jiná. SDS samo vnitřně pracuje s '''32-bit unsigned''' hodnotami, a díky tomu na webu a všech M2M stránkách můžete vidět hodnoty v rozsahu od 0 do 4294967295. Zato SDS-C pracuje pouze se '''32-bit signed''' hodnotami, a proto stejné číslo je reprezentováno v rozsahu -2147483648 až 2147483647. Toto je vlastnost daná omezením implementace, zkrátka v SDS-C to nelze jinak udělat (pokud to je problém, což ale není, tak můžete přejít na zařízení s FULL-C které tyto omezení nemá).<br />
<br />
To lze snadno ve vašem SDS-C kódu ošetřit, a pokud pouze přenášíte hodnoty z SDS na server (přes HTTP-GET), tak se to dá snadno a ihned zpracovat na serveru "zpět" na '''32-bit unsigned''' hodnotu. Jednoduše na serveru přijmete '''signed''' číslo, a převedete ho například přetypování na '''unsigned''' číslo. Bity v paměti totiž jsou pro oba typy stejné.<br />
<br />
V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''<br />
<br />
<br />
'''Použítí v SDS-C programu'''<br />
<br />
Zápis a čtení z/do systémových proměnných má okamžitý přímý vliv na hardware, se kterým jsou konkrétní proměnné svázány.<br />
<br />
Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)? <br />
<syntaxhighlight lang="c"><br />
teplota0_ve_stupnich_C = sys[310] / 100;<br />
</syntaxhighlight><br />
<br />
Ne vždy je potřeba provádět převody. Pokud např. chcete porovnat dvě hodnoty z různých teplotních čidel, můžete to udělat přímo (bez dělení 100 jako v předchozím příkladu) - samozřejmě toto platí pouze tehdy, pokud porovnáváte hodnoty ve stejných jednotkách:<br />
<syntaxhighlight lang="c"><br />
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };<br />
</syntaxhighlight><br />
<br />
Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):<br />
<syntaxhighlight lang="c"><br />
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)<br />
</syntaxhighlight><br />
<br />
Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:<br />
<syntaxhighlight lang="c"><br />
#define RELE1 sys[231]<br />
<br />
#define TEPLOTA sys[310]<br />
<br />
// ...<br />
<br />
RELE1 = 255;<br />
<br />
if (TEPLOTA > 3200) goto x;<br />
</syntaxhighlight><br />
<br />
<br />
== Pole ram[] ==<br />
<br />
Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).<br />
<br />
Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.<br />
<br />
Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).<br />
<br />
Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:<br />
<syntaxhighlight lang="c"><br />
hodnota = ram[10];<br />
<br />
index = 23;<br />
ram[index] = 15 * 2;<br />
<br />
index = sys[1023];<br />
ram[index] = 30;<br />
</syntaxhighlight><br />
<br />
Pole ram[] je indexováno od indexu nula (tj.: ram[0]). Celková velikost (maximální index) je dán verzí SDS-C a konkrétního firmware v zařízení. <br />
<br />
Verze SDS-C č. 03 má maximální velikost pole ram[] nastavenou na 128 položek. '''Novější verze už mají počet zvýšený ''' - verze č. 06 má velikost ram[] nastavenou na 512 položek (každá o velikosti int32_t).<br />
<br />
Pole ram[] můžete využít k čemukoliv co potřebujete. Také i pro některé SDS-C funkce, jako je ''http_get()'', která může do pole ram[] ukládat obsah textu obdrženého ze serveru (toto chování se nastavuje příslušnými sys[]), nebo při přenosu stránek z/do paměti DF.<br />
<br />
<br />
== Ukládání trvalých dat ==<br />
<br />
Všechny verze SDS-C mají od k dispozi prostor v oblasti sys[100] až sys[115]. Toto je výchozí oblast pro uchovávání trvanlivých dat (tyto údaje se neztratí při výpadku napájení). Přímým zápisem, do těchto sys[] položek, dojde k zápisu do pevné paměti. Čtení se provádí opět přímým přístupem do těchto sys[].<br />
<br />
Od verze SDS-C č. 05 je možno, navíc k tomuto základu, zapisovat a přečíst mnohem větší množství údajů v externím paměťovém chipu DATAFLASH (NVM = Non-Volatile Memory), osazeném na desce zařízení SDS, a to prostřednictvím čtyř SDS-C funkcí.<br />
<br />
Pozn. historické verze zařízení SDS-MICRO LIGHT, kde se používá paměť EEPROM (na místo novější DataFlash), poskytuje vždy pouze základní rozsah indexů: 100 až 115, a neposkytuje rozšířený rozsah pevné paměti (tak jako zařízení s pamětí DataFlash).<br />
<br />
Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].<br />
<br />
Další možnost:<br><br />
Zařízení SDS řady ST mají k dispozici, kromě podpory pro DataFlash, i možnost využít Zálohovanou paměť RAM (ta drží obsah i při vypnutém napájení SDS, pokud je v SDS vložena nabitá zálohovací baterie).<br />
<br />
<br />
== Pole text[] ==<br />
<br />
Od verze SDS-C č. '''06''' je možné v určité míře pracovat s texty. Toto má především využití v komunikaci přes sériovou linku (RS232/RS485) a při odesílání a příjmu dat (email, http) či práci s komunikačními moduly (GSM, LTE, LoRA).<br />
<br />
Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].<br />
<br />
SDS-C je omezený programovací jazyk z hlediska "práce s textem". Pokud potřebujete intenzivně s textem pracovat, použijte zařízení SDS které má FULL-C jazyk.<br />
<br />
I přes omezení SDS-C je možné připojit různé komunikační moduly (GSM, LTE, LoRA), které komunikují prostřednictvím textových příkazů (viz vzorové programy).<br />
<br />
<br />
== Pole share[] ==<br />
<br />
<br />
Od verze SDS-C č. '''08''' je možné použít pole '''share[]''', určené primárně pro sdílení textové informace mezi SDS-C programem a webovým rozhraním (tedy jako [[SDS-C:_sharing|sdílené proměnné]]).<br />
<br />
Práce s polem share[] je prakticky zcela shodná jako práce s polem text[]. Prakticky tak získává programátor dvě nezávislé pole pro uchování textu. Nicméně, některé SDS-C funkce vyhrazeně fungují jen s polem text[], ale to je vždy uvedeno v jejich popisu. <br />
<br />
<br />
== Vyhrazené funkce ==<br />
<br />
Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].<br />
<br />
<br />
== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==<br />
<br />
'''STAV SYSTÉMU'''<br />
<br />
sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)<br />
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program<br />
<br />
sys[1] 01 i R počet přihlášených uživatelů do webového rozhraní (v okamžiku čtení této proměnné)<br />
<br />
sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci<br />
<br />
sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)<br />
- počítá se od nuly (0) od každého zapnutí zařízení<br />
- pouze 31 bitové počítadlo<br />
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně<br />
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule<br />
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času <br />
<br />
sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)<br />
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem<br />
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)<br />
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)<br />
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně, <br />
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
<br />
sys[5] 01 i R rozpad LOCAL času: den (1 až 31)<br />
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)<br />
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)<br />
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)<br />
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)<br />
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)<br />
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)<br />
<br />
'''Upozornění''': hodnota LOCAL času je platná až po úspěšném získání informací z NTP serveru. Po zapnutí (restartu) zařízení je NTP čas (sys[38], sys[4]) nastaven na nulu. Čas je automaticky v SDS aktualizován co jednu sekundu pomocí vnitřních hodin v SDS, a dále je hodnota času pravidelně (v delším intervalu) upřesněna dotazem na NTP server.<br />
<br />
V případě, že není zapnuta automatika DST (letní čas) a GMT offset je nastaven na nulu, tak je hodnota LOCAL času identická s NTP časem (UTC). Jakmile se ale nastaví offset nebo aktivuje posun letního času, už jsou tyto hodnoty odlišné (NTP je UTC, a LOCAL je místní (posunutý) čas). Pro různé použití je potřeba různých časů (často je potřeba UTC pro časové známkování údajů, a zase někdy je vhodný LOCAL pro interakci s uživatelem a pro různé výpisy).<br />
<br />
<br />
== Ethernet, Internet ==<br />
<br />
sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)<br />
sys[13] 01 i R IP[1] adresa zařízení<br />
sys[14] 01 i R IP[2] adresa zařízení<br />
sys[15] 01 i R IP[3] adresa zařízení<br />
<br />
sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)<br />
sys[17] 01 i R GW_IP[1] adresa brány<br />
sys[18] 01 i R GW_IP[2] adresa brány<br />
sys[19] 01 i R GW_IP[3] adresa brány<br />
<br />
sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)<br />
sys[21] 01 i R NETMASK[1] síťová maska<br />
sys[22] 01 i R NETMASK[2] síťová maska<br />
sys[23] 01 i R NETMASK[3] síťová maska<br />
<br />
sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)<br />
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)<br />
!= 0 : Ethernetová komunikace je funkční (LINK OK)<br />
<br />
sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)<br />
== 0 : neznámá rychlost (není k dispozici Ethernet)<br />
== 10 : 10 MBit per sec<br />
== 100 : 100 MBit per sec<br />
<br />
sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)<br />
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)<br />
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti <br />
(po resetu zařízení se vráti na poslední uloženou hodnotu)<br />
<br />
sys[27] 06 i R platnost přidělené IP adresy zařízení SDS<br />
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)<br />
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet<br />
<br />
sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,<br />
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)<br />
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik<br />
<br />
sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)<br />
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)<br />
== 1 : odesláno DHCP DISCOVER<br />
== 2 : obdrženo DHCP OFFER<br />
== 3 : odesláno DHCP REQUEST<br />
== 4 : obdrženo DHCP ACK<br />
== 5 : IP adresa je přidělena (BOUND)<br />
== 6,7,8,9,10,11 : zpracování DHCP RENEW<br />
<br />
sys[30] 06 i R aktuální hodnota "DHCP Lease Time"<br />
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)<br />
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)<br />
- údaj je uveden v jednotkách [sec]<br />
<br />
sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)<br />
sys[32] 04 i R MAC[1] <br />
sys[33] 04 i R MAC[2] <br />
sys[34] 04 i R MAC[3] <br />
sys[35] 04 i R MAC[4] <br />
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)<br />
<br />
sys[37] 06 i R NTP Client Status (synchronizace času)<br />
== 0 : nesynchronizováno<br />
== 1 : úspěšně přijal paket od NTP Serveru<br />
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz <br />
(dotaz se odešle za 10sec od takovéhoto zápisu)<br />
<br />
sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)<br />
- není zde aplikován offset, ani automatika letního času<br />
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď), <br />
uvnitř SDS je sice udržována jako 32bit, <br />
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).<br />
<br />
sys[39] 07 i R stav automatiky přepínání Letního Času<br />
== 0 : automatika zakázána, lokální čas není ovlivněn<br />
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").<br />
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").<br />
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).<br />
09 i W pouze pro případ vypnutého NTP: ruční ovládání automatiky (tzn. povolena nebo nepovolena) (SELČ pak automatika sama rozhodne, je-li povolena)<br />
zápis 0 : vypnout automatiku (nebude pracovat = nebude aplikoval posun pro SELČ pro nastavený rozsah v roce), sys[39] pak vrátí 0 při čtení<br />
zapis 3 : zapnout automatiku (automatika aplikuje posun pro SELČ podle toho jaký je aktuální čas a datum), sys[39] pak vrátí 1 nebo 2 dle stavu <br />
<br />
sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)<br />
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)<br />
<br />
sys[139] 09 i R vyhrazeno<br />
<br />
Princip funkce automatiky letního času je popsán jinde na této wiki. Funkce automatiky je samozřejmě volitelná (viz: ruční nastavení ve webovém rozhraní).<br />
<br />
sys[40] až sys[44] RESERVED vyhrazeno<br />
<br />
<br />
== Provozní údaje ==<br />
<br />
sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)<br />
- po resetu zařízení začíná vždy počítat od nuly<br />
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);<br />
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!<br />
- pro sys[45] je k dispozici 31 bitů,<br />
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru<br />
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).<br />
<br />
sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),<br />
význam hodnot závisí na typu konkrétního zařízení SDS. <br />
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.<br />
<br />
SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM): <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]<br />
<br />
SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST: <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]<br />
<br />
Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.<br />
<br />
sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu <br />
(při přetečení 2^31 počítá opět od nuly, pořád dokola)<br />
<br />
Hodnota v indexu 137 je nejjemnější možný "časovač", dostupný pro program. Délka kroku jednotky odpovídá frekvenci jádra (ta je různá pro jednotlivá SDS, pro řadu ST typicky 120MHz, tedy 1 krok je 8.3nsec). <br />
Tento index vyžaduje aktuální FW (11/2022 nebo novější).<br />
<br />
<br />
== Rozhraní sériové komunikace ==<br />
<br />
SDS-C poskytuje přístup k sériovému rozhraní COM1 a COM6. Pouze rozhraní COM1 je také současně přístupno přes převodník Eth/UART (VCP). Program v SDS-C může přistupovat jak ke COM1, tak ke COM6.<br />
<br />
Pomocí SDS-C lze zapisovat do sériového rozhraní, a číst data ze sériového rozhraní. Data, přicházející z venku do zařízení SDS, jsou ukládána do příslušného bufferu (RX FIFO), takže lze pomocí SDS-C programu číst i pomaleji, než je rychlost příchozích dat. Buffery jsou malé (zhruba 1kB), proto je potřeba data zpracovávat rychle a včas, ať nedojde k jejich ztrátě.<br />
<br />
Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše. <br />
Poznámka: UART buffery (pro obě sériové rozhraní) jsou neustále aktivní a příjem dat z UARTu probíhá po celou dobu zapnutí zařízení.<br />
<br />
Rozhraní COM1:<br />
<br />
sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1<br />
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici), <br />
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není ! <br />
(Toto může způsobit nezkušenému programátorovi potíže). <br />
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné, <br />
a s tou pak dále dle libosti pracovat.<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!<br />
<br />
sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?<br />
== 0 : není připojen klient<br />
!= 0 : je připojen klient (přes TELNET port)<br />
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)<br />
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)<br />
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Poznámka: parametry sériového rozhraní UART COM1 lze nastavit v rámci převodníku Ethernet/UART (přes RFC příkazy), nebo pomocí k tomu určené SDS-C funkce. Pozor, nastavení '''nelze''' změnit přímým zápisem hodnoty do sys[50] až sys[54] (ty jsou pouze pro čtení).<br />
<br />
Rozhraní COM6:<br />
<br />
sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6<br />
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
sys[57] 02 i R rychlost [bps] rozhraní UART - COM6 <br />
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)<br />
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Rozhraní UART - COM6 je k dispozici jen na SDS-MINI, SDS-MICRO-ST a SDS-MACRO-ST, a je přístupné jen z SDS-C programu.<br />
<br />
Doplňující statistiky (počty rx/tx bajtů atd.) jsou k dispozici na indexu 2800+, viz dále na této stránce (dostupnost těchto údajů je závislá na instalovaném aktuálním FW ve vašem SDS).<br />
<br />
<br />
== Generátor náhodných čísel ==<br />
<br />
sys[61] 06 i R generátor náhodných čísel<br />
- při každém přečtení sys[61] je poskytnuto náhodné číslo<br />
<br />
<br />
== Výsledek převodu textu na číslo ==<br />
<br />
Pro převod textu (z určené pozice pole ''text'' či ''share'') na číslo se používá funkce SDS-C: ''atoi''. Aby bylo možné výsledek převodu získat, musíte si jej přečíst ze ''sys[62]''.<br />
<br />
sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''<br />
<br />
Pro více informací se podívejte přímo na návod k této funkci.<br />
<br />
<br />
== Nastavení rychlosti provádění SDS-C programu ==<br />
<br />
SDS-C program může ovlivnit rychlost svého vykonávání. Buď se každá instrukce provede právě s minimálním krokem co 1 msec, nebo se dá tato (často žádoucí) vlastnost snadno vypnout. Pozor, hodnota 1 msec není vždy garantována, např. při zavolání funkce která pracuje s pomalou periférií dojde k čekání, dokud se požadovaná funkce nedokončí.<br />
<br />
sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:<br />
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''<br />
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku) <br />
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )<br />
<br />
Poznámka: všechny SDS-C programy jsou ve výchozím stavu spouštěny se sys[63] = '''0''' (tzn. jeden celý příkaz programu je vykonán právě co 1 msec).<br />
<br />
Tohoto faktu (krok 1 msec) některé programy využívají k realizaci čekacích smyček, když se předpokládá jeden vykonaný příkaz za 1 msec. Není to však vhodné, protože SDS nedává garanci že se vždy bude jednat přesně o 1 msec (může docházet k náhodnému zdržení až o několik msec, v záležitosti na ostatní činnost systému). Pokud však vypnete toto rychlostní omezení, tak takové případné čekací smyčky přestanou plnit svou funkci (prakticky skončí mnohem dříve): proto ve svých programech používejte pouze k realizaci "čekání" pouze k tomu určené funkce, nebo případně sys[64] nebo některý z UpTime indexů či sys[137] atd.<br />
<br />
<br />
== Časování ==<br />
<br />
Pro přesnější časování programu, popř. pro spuštění nějaké události po přesně daném intervalu, lze s výhodou využít následující proměnnou:<br />
<br />
sys[64] 01 i RW sekundový odpočítávač <br />
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1, <br />
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)<br />
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)<br />
<br />
Samozřejmě lze využít i jiné způsoby, ale tento je k tomu explicitně určen, vyhovuje-li hrubý krok 1 sekunda. Pro jemnější časování jsou pak vhodnější indexy s UpTime hodnotou, nebo sys[137] pro nejvíce jemné čekání - tyto indexy ale nemají funkci odpočítávání (jsou jen pro čtení), takže hlídání obsahu si už musíte řešit sami ve svém programu.<br />
<br />
<br />
== OSI7 funkce ==<br />
<br />
OSI7 funkce jsou určeny pro komunikaci mezi SDS a vnějším světem připojeným přes Ethernet (např. se servery v Internetu).<br />
<br />
Všechny funkce OSI7 poskytují průběžný stav své činnosti:<br />
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)<br />
- význam hodnot viz [[OSI7_status_code|popis zde]]<br />
<br />
Poznámka: vždy je doporučeno, po zavolání kterékoliv OSI7 funkce, provést v programu čekání na skončení této funkce. Čekání má kontrolovat právě hodnotu v sys[65], a dokud se tato proměnná nenaplní výsledkem, nevolejte další OSI7 funkci.<br />
<br />
DNS resolv: sestavením IP[0].IP[1].IP[2].IP[3] získáte IP adresu (napr. 10.0.0.8) z DNS po úspěšném návratu z funkce DNS resolveru. Tato získaná IP adresa pak může sloužit pro různé účely, např. pro kontrolu DNS serveru jestli žije atd.<br />
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
<br />
Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).<br />
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)<br />
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru<br />
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru<br />
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru<br />
<br />
sys[74] 01 s R text, reserved (v této verzi nepoužito)<br />
<br />
Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):<br />
<br />
sys[303] 09 i R DNS RESOLV - (read:) actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
sys[303] 09 i W DNS RESOLV - write value 0xD65 (3429dec) to clear the DNS cache<br />
sys[304] 09 i R DNS RESOLV - (read:) timestamp (UTC) of the latest DNS server response (packet) as requested by dns_resolv() function (if 0 then no response received, or cache has expired)<br />
sys[305] 09 i R DNS RESOLV - (read:) get the last set hard TTL limit (0 = invalid (will use 1209600 as default), otherwise 1..MAX = time in seconds)<br />
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)<br />
<br />
<br />
HTTP GET:<br />
<br />
sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)<br />
- nastaveno po dokončení práce funkce '''http_get()'''<br />
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.<br />
<br />
sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')<br />
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',<br />
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.<br />
<br />
sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek<br />
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu. <br />
Nastavte na:<br />
<br />
== 0 : jakékoliv přijaté data jsou '''zahozena''', <br />
neuloží se (nedojde ke změně obsahu ram[] nebo text[])<br />
<br />
== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole ram[] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !<br />
<br />
sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi<br />
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])<br />
- maximální hodnota je omezena velikostí pole ram[] nebo text[]<br />
- pozor! pokud zapíšete '''0''', budou všechna data zahozena, <br />
ale i v takovém případě dojde k přepisu ram[0] (viz výše)<br />
<br />
sys[79] až sys[80] RESERVED vyhrazeno<br />
<br />
Pozor, v případě nenulového sys[77] HTTP klient čeká tak dlouho, dokud nedostane všech sys[78] bajtů odpovědi z protistrany. To je častou příčinou "problémů" kdy protistrana neodpoví dostatečně dlouhou odpovědí, a klient má stále otevřené spojení a stále čeká a čeká... až dojde na timeout. Což je pak potřeba důsledně a správně ošetřit ve vašem SDS-C programu.<br />
<br />
Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):<br />
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')<br />
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru<br />
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru<br />
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru<br />
<br />
sys[85] až sys[88] RESERVED vyhrazeno<br />
<br />
Informace z ('''interní''') ICMP PING funkcionality "IP Watchdog" (konfigurace a ovládání přes webové rozhraní SDS) (nemá souvislost s SDS-C funkcí "ping()" ) :<br />
<br />
sys[89] 06 i R IP-Watchdog: stav<br />
== 0 : není v provozu (neaktivováno ve webovém rozhraní)<br />
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)<br />
<br />
sys[90] 06 i R IP-Watchdog: poslední známé RTT<br />
== 0 .. 65533 : hodnota RTT v msec<br />
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)<br />
<br />
sys[91] 06 i R IP-Watchdog: stav výstupu<br />
== 0 : výstup není aktivován<br />
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)<br />
<br />
Informace z (SDC-C) ICMP PING funkce - '''ping()''' :<br />
<br />
sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92] <br />
== 0 : klid (není odeslán paket, nečekám na odpověď), <br />
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle<br />
== 1 : funkce '''ping()''' byla právě zavolána, <br />
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání<br />
== 2 : čeká se na odpověď od ARP <br />
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket, <br />
protože v ARP tabulce nebyl příslušný záznam)<br />
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY <br />
(požadovaný stav, funkce '''ping()''' funguje ok)<br />
== 8 : právě obdržel ECHO REPLY <br />
(byla přijata odpověď od vzdáleného zařízení)<br />
<br />
sys[93] 04 i R PING SEQ number <br />
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE <br />
na ICMP PING REQUEST odeslaný funkcí '''ping()'''<br />
<br />
sys[94] 04 i R Round Trip Time, v milisekundách<br />
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''<br />
- čas je zvyšován po pěti milisekundách (údaj v sys[94] je přímo v msec, např. hodnota 55 znamená 55 msec)<br />
<br />
Pozn.: ICMP Quench (32bit) je sestaven z "identifier" (16bit) a z "sequence number". Pomocí sys[93] můžete nastavit '''číslo sekvence''' na libovolnou hodnotu, přičemž hodnota "identifier" je napevno nastavena na "'''0x0280'''" .<br />
<br />
<br />
Funkce '''send_udp()''':<br />
<br />
sys[95] 06 i R výsledek posledního volání '''send_udp()'''<br />
Hodnoty:<br />
== 0 : nic neprovedeno<br />
Hodnota '''0''' je nastavena po startu SDS-C programu<br />
== 1 : právě bylo zahájeno odesílání paketu (provádí se)<br />
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.<br />
== 2 : byl odeslán UDP paket, úspěšně<br />
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu<br />
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz <br />
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP <br />
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz<br />
== 4 : zavolali jste funkci '''send_udp()''' dříve, <br />
než byla dokočena činnost předchozího požadavku <br />
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)<br />
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)<br />
<br />
<br />
Funkce '''snmp_send_trap()''':<br />
<br />
sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''<br />
Hodnoty:<br />
== 0 : odesílání neprobíhá<br />
== 1 : probíhá odesílání, výsledek ještě není znám<br />
== 2 : odeslání se povedlo <br />
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)<br />
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)<br />
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)<br />
<br />
sys[97] RESERVED vyhrazeno<br />
<br />
<br />
== Zápis textu do pole, Porovnání textů ==<br />
<br />
Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.<br />
<br />
sys[98] i R společné využití viz (1) a (2)<br />
<br />
06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,<br />
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'', <br />
což je hodnota užitečná pro navázání textu (zápis více textů přesně za sebou), popř. určení délky posledního zápisu:<br />
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''<br />
- kam byla zapsána terminační 0x00 funkcí '''itoh()''' <br />
- kam byla zapsána terminační 0x00 funkcí '''itoa()''' <br />
<br />
08 i R (2) výsledek porovnání textů<br />
- hodnota výsledku zavolání funkce '''textcmp()'''<br />
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci<br />
X == 0 : oba texty jsou identické<br />
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''<br />
<br />
Význam "nižší vlastní hodnoty": znak 'a' má nižší hodnotu než 'b', a to o 1; nebo např. '1' má nižší hodnotu než '4' a to o 3.<br />
<br />
Doporučeno je si to vše vyzkoušet (zavolat si každou uvedenout funkci a srovnat hodnotu v sys[98] s obsahem pole ''text[]'').<br />
<br />
<br />
== Uživatelské pozice v pevné paměti == <br />
<br />
sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]<br />
<br />
sys[100] až sys[115] <br />
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,<br />
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),<br />
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF <br />
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !<br />
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti <br />
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti <br />
<br />
Paměť EEPROM a paměť DATAFLASH (podle verze HW který máte) je permanentní (NVM), tzn. její obsah zůstane i po vypnutí zařízení nezměněn (na rozdíl od <u>ne</u>zálohované paměti RAM, do které se přistupuje pomocí pole ''ram[]'').<br />
<br />
''' Reserved '''<br />
<br />
sys[116] až sys[136] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné nastavitelné uživatelem z webového rozhraní ==<br />
<br />
Pomocí "uživatelských proměnných" (někdy taky "sdílených proměnných") lze snadno ovlivnit chod vašeho SDS-C programu, ale jen tak, jak si do něj sami naprogramujete - uživatelské proměnné neovlivňují samotný program, ale program je může číst a následně zpracovat.<br />
<br />
sys[140] až sys[149] <br />
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)<br />
(vždy 32-bit signed integer)<br />
<br />
sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu<br />
Nastavení:<br />
== 0 : stránka "control" je přístupná bez hesla, <br />
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)<br />
<br />
Uživatel, který má přístup k webové stránce, může zapsat nový obsah do těchto osmi proměnných (změnit jejich hodnotu), kdykoliv chce. Dvě doplňkové proměnné nejsou na výchozí webové stránce dostupné, ale jinak s nimi lze bez jiných omezení pracovat (SDS-C, M2M).<br />
<br />
Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.<br />
<br />
Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).<br />
<br />
Samozřejmě lze využít i přímého URL pro zápis do proměnných, což je výhodné např. při vzájemné komunikaci dvou zařízení.<br />
<br />
<br />
== Proměnné vstupů a výstupů pro všechny výrobky SDS ==<br />
<br />
'''POZOR'''<br />
<br />
'''Podle HW verze výrobku, jsou dostupné jen určité vstupy a výstupy.''' Zde je uveden plný seznam pro maximální konfiguraci, ale ne všechny HW verze mají všechno. Např. SDS-MICRO-LM má pouze dva reléové výstupy, kdežto SDS-MACRO-LM má čtyři.<br />
<br />
Vždy máme vyhrazeno 32 indexů pro vstupy a výstupy. Tyto indexy jsou tedy naplánovány pro (budoucí) maximální konfiguraci, ale většina SDS k nim nemá odpovídající HW (např. nemá všech 32 relé). Zápis a čtení do/z indexů, které nemají odpovídající fyzický protějšek, je zakázán (bude SDS ignorován, a hodnota nebude uložena pro pozdější čtení).<br />
<br />
'''Pokračování výpisu:'''<br />
<br />
sys[151] až sys[182] <br />
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)<br />
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)<br />
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu<br />
Hodnoty:<br />
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)<br />
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)<br />
<br />
Pozor, pokud u vašeho SDS (např. historické kousky SDS-MICRO-LIGHT) má číslované OPTO vstupy od nuly (né od jedničky), musíte si aktualizovate firmware v tomto zařízení, a případně upravit potisk (popis) na desce nebo krabičce.<br />
<br />
'''Důležité info:'''<br />
<br />
Pokud je (uvnitŘ SDS) na LED vstupního optočlenu signál, hodnota '''sys[]''' pro dané OPTOx dává '''0''' (nulu), naopak při nepřítomnosti signálu je přítomna '''nenulová''' hodnota (vždy testujte na nulovou a nenulovou hodnotu, jediné co je zaručeno je totiž ta nula, kdežto nenulová hodnotu může být jakákoliv - ve skutečnosti každý opto vstup má přidělenou konstantu, podle které lze tento vstup identifikovat). <br />
<br />
Pozor - "logika" optických vstupů je tedy na první pohled "obrácená" (avšak dává to přesný smysl). Jen je to potřeba vědět při psaní SDS-C programu.<br />
<br />
<br />
== Stav SDS-C programu ==<br />
<br />
Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).<br />
<br />
sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu<br />
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)<br />
<br />
Příklad: FW v SDS je (pro příklad) ze dne 24.12.2018, takže v ''sys[183]'' bude zakódováno jako 0x00180C12, tedy hodnoty 24dec 12dec 18dec zapsány jako 0x18 0x0C 0x12, což je 0x18C0C12 což je 1575954dec.<br />
<br />
Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:<br />
<br />
sys[184] 08 i RW způsob spuštění SDS-C programu<br />
== 0 : bez informace<br />
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS<br />
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)<br />
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace<br />
<br />
Stav SDS-C watchdogu:<br />
<br />
sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec<br />
== -1 : wdg není aktivní<br />
== 0 : odpočet vypršel, dojde k resetu SDS-C programu<br />
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)<br />
<br />
<br />
== Pulse-Width Modulation výstupy ==<br />
<br />
Některá SDS mají pouze jeden PWM výstup (PWM1), některá mají čtyři výstupy (rozdělené po dvou do dvou skupin: PWM1 a PWM2, pak PWM3 a PWM4).<br />
<br />
''Příklad pro PWM1:'' Konfigurace PWM1 výstupu nejprve vyžaduje zápis do sys[191], aby se nejprve nastavila provozní základní frekvence generátoru.<br />
Následně lze PWM1 výstup řídit zápisem do sys[192], kdy se podle zapsané hodnoty nastaví střída PWM výstupu (poměr log0 a log1).<br />
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.<br />
Zápis do sys[191] je potřeba jen jednou (tedy jen tehdy, když je potřeba PWM1 výstup zapnout nebo vypnout, a kdy je potřeba změnit frekvenci generátoru). <br />
Zápisy do sys[192] a nebo sys[193] se pak mohou dít samostatně (tj. není potřeba pokaždé opakovat zápis do sys[191]).<br />
<br />
Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !<br />
<br />
Pozor, pro tyto typy SDS:<br />
<br />
SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO''' <br />
<br />
Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).<br />
<br />
<br />
Podle typu SDS:<br />
<br />
SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)<br />
<br />
sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).<br />
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)<br />
<br />
sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)<br />
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).<br />
<br />
sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru <br />
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]<br />
- tato hodnota není aktualizována vůči sys[192], ani není archivována<br />
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.<br />
<br />
Hodnoty Fm větší než 1MHz prakticky nemají smysl, snažte se navrhnout svůj systém tak, aby dokázal pracovat ideálně nejvýše ve stovkách kHz.<br />
<br />
<br />
Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.<br />
<br />
SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)<br />
<br />
sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[192] až sys[195])<br />
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)<br />
<br />
sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)<br />
<br />
sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)<br />
<br />
sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[187] až sys[190])<br />
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[187] 09 i RW duty-cycle '''PWM3''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)<br />
<br />
sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[189] 09 i RW duty-cycle '''PWM4''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)<br />
<br />
sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.<br />
<br />
<br />
== Ovládání výstupů - Relé ==<br />
<br />
Zápisem do následujících systémových proměnných přímo ovládáte fyzické relé (výstupy) zařízení SDS. Pozor, protože hodnoty zapsané z SDS-C programu se záměrně neukládají do pevné paměti (tzn. nejsou načteny po resetu zařízení SDS). Je to z důvodu bezpečnosti (aby se např. neseplo relé po dlouhém výpadku napájení). Váš program si s tím musí umět poradit - vždy po zapnutí SDS musí vyhodnotit aktuální situaci a až podle toho zapínat relé.<br />
<br />
sys[196] až sys[228] <br />
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''<br />
- lze nastavit i z webového rozhraní<br />
Hodnoty:<br />
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)<br />
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)<br />
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)<br />
<br />
sys[229] až sys[230] RESERVED vyhrazeno<br />
<br />
sys[231] až sys[262] <br />
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)<br />
Hodnoty:<br />
== 0 : relé není aktivní <br />
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)<br />
!= 0 : relé je aktivní <br />
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)<br />
<br />
sys[263] až sys[265] RESERVED vyhrazeno<br />
<br />
sys[266] až sys[298] <br />
01 s R uživatelský textový název pro '''RE1''' až '''RE32''' <br />
- nastaveno ve webovém rozhraní<br />
<br />
sys[264] až sys[300] RESERVED vyhrazeno<br />
<br />
<br />
== Ovládání PDx ==<br />
<br />
Jednotlivé moduly SDS mají k dispozici dodatečné vstupy a výstupy, označené jako PDx respektive TOPB. Přesný seznam viz návod ke konkrétním modulům.<br />
<br />
Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):<br />
<br />
sys[301] 01 i RW SDS '''MICRO LM LIGHT''': stav i/o pinu D0 (0 = log0 ; nenulová hodnota v sys = log1 přítomna na pinu)<br />
SDS '''MICRO LM DIN''' a SDS '''MACRO LM''': stav výstupu D0 - MOSFET spínač na GND. Při jakékoliv nenulové hodnotě v sys[301] je MOSFET sepnutý (=D0 na GND), jinak je D0 otevřený (HiZ)<br />
SDS '''TTCPRO''': stav všech osmi pinů v portu PDx (nastavením/čtením sys[301] se přistupuje k jednotlivých osmi bitům v bajtu, kde: bit0=PD0 až bit7=PD7)<br />
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = stav PD0 MOSFET spínače (spíná na GND), bit1 = stav i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''IO6-ST''': nepoužito<br />
SDS '''MACRO-ST''': bit0 = stav PD0, bit1 = stav PD1, bit2 = stav i/o pinu TOPB, bit3 = TL-1, bit4 = stav TL-2, ostatní bity (5..7) nepoužity<br />
<br />
Řízení směru pro jednotlivé PDx resp. TOPB:<br />
<br />
sys[302] 06 i RW SDS '''MICRO LM LIGHT''': směr i/o pinu D0 (zápisem bit0 do 1 se nastaví pin D0 jako výstup) (zápisem log1 se nastaví jako vstup)<br />
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)<br />
SDS '''TTCPRO''': směr jednotlivých pinů v portu PDx (nastavením jednotlivých osmi bitů, bit0=PD0 až bit7=PD7, nastav log1 pro výstup)<br />
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = vždy v log1 (PD0 jako výstup), bit1 = směr i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''MACRO-ST''': bit0 = vždy v log1 (výstup), bit1 = vždy v log1 (výstup), bit2 = směr i/o pinu TOPB, bit3 = vždy v log0 (vstup), bit4 = vždy v log0 (vstup), ostatní bity (5..7) nepoužity<br />
<br />
TOPB: vždy typicky CMOS 3V3 pin, s možností funkce jako vstup nebo výstup (dle sys[302]), a je přímo připojený na pin SoC, pozor tedy na jeho další HW připojení.<br />
<br />
TTCPRO: Mapování je vždy od nejnižšího (LSB - bit0) bitu (PD0 = bit0, PD1 = bit1, atd. PD7 = bit7). Pro TTCPRO jsou PDx jako CMOS 3V3 piny s volbou vstupu nebo výstupu pro každý jednotlivý pin.<br />
<br />
MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).<br />
<br />
sys[306] až sys[309] RESERVED vyhrazeno<br />
<br />
== Tlačítka na desce display pro SDS-MACRO-ST ==<br />
<br />
Čtení stavu tlačítek na desce display (SDS-MST-DISP-rev1) se provádí čtením sys[301] a vyhodnocením bitu 3 (=8dec, první tlačítko) a/nebo bitu 4 (=16dec, druhé tlačítko).<br />
<br />
Ošetření na případné zákmity při stisku a uvolnění tlačítek, je potřeba provést ve vašem SDS-C programu.<br />
<br />
<br />
== Vstupy - teploměry na externí sběrnici 1-Wire&reg; ==<br />
<br />
Čidla teploty (1-W chipy pro měření teploty připojené na sběrnici; tak také údaj o teplotě z připojených modulů SDS-1W-T-RH) jsou řízena (čtena) plně automaticky zařízením SDS. Program v SDS-C má přímo přístup k výsledným hodnotám teplot.<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici<br />
<br />
Teploměry mají hodnotu uloženou v násobku '''100''' (takže např. 24.5°C je uloženo jako číslo 2450, nebo -120.65°C je -12065). Pokud není k dispozici hodnota z čidla, '''není v záznamu číslo nula (pozor !), ale záměrně tam je číslo 16777216 (2^24)'''.<br />
<br />
Pozn.: pouze SDS-MACRO-LM a SDS-MACRO-ST mají teploměry č. 17 až 32, protože má dvě samostatné sběrnice (konektory). Sběrnice A má teploměry 1 až 16, sběrnice B má teploměry 17 až 32. '''Sběrnice B je k dispozici jen pro SDS-MACRO-XX'''.<br />
<br />
sys[342] až [345] RESERVED vyhrazeno<br />
<br />
sys[346] 01 i R číslo čidla, které je právě převáděno na sběrnici '''B''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''<br />
<br />
sys[348] 01 i R číslo čidla, které je právě převáděno na sběrnici '''A''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''<br />
<br />
sys[350] až sys[381] <br />
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]<br />
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)<br />
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek<br />
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)<br />
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)<br />
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)<br />
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)<br />
<br />
sys[382] až [389] RESERVED vyhrazeno<br />
<br />
sys[391] až sys[422] <br />
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)<br />
<br />
''' Reserved ''' <br />
<br />
sys[423] až sys[430] RESERVED vyhrazeno<br />
<br />
<br />
== Vstupy: analogové vstupy pro měření napětí ==<br />
<br />
Všechny vstupy měří napětí vůči společné svorce (GND). Změřená hodnota je vždy k dispozici nejprve jako surová (raw) digitální hodnota, a poté ji SDS přepočítá dle uživatelského nastavení a také dá k dispozici.<br />
<br />
sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1<br />
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2<br />
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3<br />
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4<br />
<br />
RAW (surová) hodnota je digitální číslo, poskytnuté z interního A/D převodníku, s tím, že mu už SDS současně (pouze a jenom) odečetl uživatelem nastavený offset.<br />
<br />
Rozsah hodnoty RAW je: <br />
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)<br />
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)<br />
<br />
Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):<br />
<br />
sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[436] 01 i R Div pro A/D 1<br />
sys[437] 01 s R textový název A/D 1<br />
sys[438] 01 s R jednotka A/D 1<br />
<br />
sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[440] 01 i R Div pro A/D 2<br />
sys[441] 01 s R textový název A/D 2<br />
sys[442] 01 s R jednotka A/D 2<br />
<br />
sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[444] 01 i R Div pro A/D 3<br />
sys[445] 01 s R textový název A/D 3<br />
sys[446] 01 s R jednotka A/D 3<br />
<br />
sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[448] 01 i R Div pro A/D 4<br />
sys[449] 01 s R textový název A/D 4<br />
sys[450] 01 s R jednotka A/D 4<br />
<br />
'''Pozor!''' Hodnoty pro jednotlivé A/D vstupy (tj. Raw Hodnoty v sys[431 až 434]) '''už mají odečtený Offset''' (je to provedeno uvnitř firmware už při zpracovávání A/D převodu) ! <br />
Proto Offset už ve svém SDS-C programu z Raw hodnot neodečítejte (bylo by to odečítáno podruhé). Pro přepočet z Raw na finální hodnotu vám zbývá (správně) použít jen "Div".<br />
<br />
Poznámka: zařízení SDS-MINI (a další z řady SDS ST) už mohou mít text v položce "jednotka A/D x" delší než jeden znak (na rozdíl od původního SDS-MICRO-LM atd., kde to bylo omezeno na jeden jediný znak).<br />
<br />
''' Reserved '''<br />
<br />
sys[451] až sys[458] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné pro S0 impulsní vstup ==<br />
<br />
sys[459] 01 i RW stav tarifu <br />
== 0 : T0 (vysoký tarif)<br />
== 1 : T1 (nízký tarif)<br />
<br />
sys[460] až sys[492] <br />
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],<br />
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )<br />
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60<br />
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh<br />
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty, <br />
pak sem v takovém případě nastavte číslo 1<br />
- platné hodnoty: 1 až 65280 (včetně)<br />
<br />
sys[493] až sys[525] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[526] až sys[558] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[559] až sys[591] <br />
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)<br />
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD<br />
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající<br />
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).<br />
<br />
sys[592] až sys[624] <br />
01 i R změřená časová vzdálenost mezi dvěmi nejposlednějšími zachycenými impulsy na S0 vstupu (aktuální impuls a předchozí impuls)<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
sys[625] až sys[657] <br />
01 i R změřený čas od úplně posledního impulsu zachyceného na S0 vstupu, tzn. "doba bez impulsu" nebo také "doba od posledního impulsu"<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
poznámka: tarif T0 a tarif T1 závisí na uživatelem zvoleném externím signálu (přeneseno do sys[459]), viz informace na stránce ohledně [[S0]]. Celková hodnota impulsů je samozřejmě součtem těchto dvou impulsních akumulátorů. Pokud není tarifní rozlišení využito, je vše zapisováno do akumulátoru pro T0. <br />
<br />
poznámka: časová vzdálenost mezi impulsy se používá pro výpočet aktuálního výkonu (popř. průtoku atd. dle použitého měřiče) - můžete toho využít ve svém SDS-C programu.<br />
<br />
poznámka: "Poměr MTD" zahrnuje všechny měřící transformátory (MTD), předřazené elektroměru (pouze pokud to už není započítáno v impulsní konstantě). Pokud je S0 vstup využit pro jiný typ měřiče (vodoměr a podobné), kde je připojení MTD nesmysl, tak se v konfiguraci musí do této položky nastavit hodnota 1. Samozřejmě jde s určitou výhodou použít i jinou konfiguraci, protože tato hodnota je použita jako "druhý dělitel" u výpočtu počtu S0 impulsů na velikost kroku energetické jednotky. Určení této hodnoty pro jiné měřiče sleduje stejné matematické postupy jako určení této hodnoty pro elektroměr s předřazeným MTD, jen jednotky budou samozřejmě jiné.<br />
<br />
sys[658] až sys[670] reserved for future use<br />
<br />
poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).<br />
<br />
<br />
== Speciální vstupy a výstupy ==<br />
<br />
Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.<br />
<br />
'''Pouze pro SDS MICRO (LM) LIGHT:'''<br />
<br />
sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
<br />
Tyto zmíněné čtyři ''sys[]'' jsou dostupné '''pouze''' na modulu SDS MICRO '''LIGHT''' popř. '''DIN''', a to jen s verzí firmware 9.1.2011 nebo novější.<br />
<br />
SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.<br />
<br />
SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MACRO LM, SDS MICRO ST, SDS MACRO ST, SDS UPS, SDS IO6, SDS IO6 ST, SDS TTCPRO, SDS MINI: tyto výstupy '''nejsou k dispozici'''.<br />
<br />
Vše to jsou logické výstupy, s CMOS 3V3 logickými úrovněmi (pro obecné použití je externí pull-up 47kOhm nutný). Lze to použít především pro ovládání BSS138 MOSFETů, např. pro spínání dalších relé (v případě použití BSS138 nedávejte externí pull-up, ale naopak dejte pull-down na GND o hodnotě 47kOhm).<br />
<br />
'''Pouze pro SDS MACRO ST:'''<br />
<br />
Alternativa k sys[301]. Hodnota odpovídá logické úrovni na daném vstupu TL1 (TL2). Při osazené desce MACRO-ST-LCD jsou na tyto vstupy připojeny tlačítka (pak při stisku TL1, TL2 je zde hodnota 0, v klidu 1).<br />
<br />
sys[671] 02 i R čtení stavu TL1<br />
sys[672] 02 i R čtení stavu TL2<br />
<br />
'''Pájecí plošky CFG:'''<br />
<br />
Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.<br />
<br />
V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.<br />
Ploška CFG1 je vyhrazena pro vnitřní použítí samotného firmware SDS, a ploška CFG2 bude eventuálně uvolněna pro libovolné použití uživatelem (čtení z SDS-C).<br />
Takový firmware se teprve chystá (SDS TTCPRO).<br />
<br />
sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)<br />
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)<br />
<br />
<br />
== Speciální proměnné pro SDS-UPS ==<br />
<br />
SDS UPS nabízí, kromě již zmíněných proměnných (viz výpis výše), i doplňkové proměnné, specifické pro tento výrobek. Tyto rozšířené systémové proměnné jsou k dispozici ve firmware od 25.4.2011 .<br />
<br />
SDS-UPS má všechny sys[0] až sys[699] shodné s SDS-MICRO. Rozdíl je samozřejmě v počtu a osazení periférií.<br />
<br />
Pokud nejste spokojeni s originálním nabíjecím algoritmem, máte možnost si ho celý naprogramovat sami v SDS-C: všechny potřebné vstupní a výstupní údaje (proměnné) jsou vám k dispozici. Popřípadě, pokud chcete jen sledovat situaci, můžete je také využít (např. pro logování nabíjecího a vybíjecího proudu akumulátoru a tak dále).<br />
<br />
sys[700] 02 i R reserved<br />
sys[701] 02 i R reserved<br />
sys[702] 02 i R reserved<br />
sys[703] 02 i R reserved<br />
<br />
'''Přepínač algoritmů:'''<br />
<br />
sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:<br />
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)<br />
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)<br />
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C<br />
<br />
Pokud zvolíte vlastní (ruční) řízení, musíte trvale řídit nabíjení sami pomocí programu v SDS-C. Vlastní ovládání vejde v platnost zápisem čísla 345 nebo 824 do sys[704]. Tento zápis provedete pouze jednou na začátku programu, a dále pak musí trvale následovat váš algoritmus. <br />
<br />
Pokud zvolíte 345, jediné co má váš program za úkol, je řídit samotný nabíjecí proces - toto je výhodné, když se nechcete zatěžovat hlídáním provozních stavů (tj. výpadek napájení atd.), což za vás v tomto režimu udělá původní firmware.<br />
<br />
Pokud zvolíte 824, musíte sami kompletně řídit všechno chování UPS, tj. nejenom nabíjecí algoritmus, ale i detekce výpadku napájení, přepínání mezi stavy, indikační LED, a tak dále.<br />
<br />
sys[705] až sys[731] reserved<br />
<br />
Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.<br />
<br />
Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.<br />
<br />
'''Vstupy a konfigurace:'''<br />
<br />
sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A<br />
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru<br />
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu<br />
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru<br />
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu<br />
<br />
Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě. <br />
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu. <br />
Měření proudu je specifické, protože měření ukazuje kladný i záporný proud, takže 0A je na hodnotě sys[732] (typicky 2047), všechno co je pod touto hodnotu je záporný proud, všechno nad je kladný proud. Znaménko proudu ukazuje, kam proud teče (např. záporný = vybíjení akumulátoru, atd.).<br />
<br />
sys[737] až sys[739] reserved<br />
<br />
Následuje konfigurace provedená uživatelem ve webovém rozhraní.<br />
Hodnoty jsou přímo v rozmezí 0 až 4095, takže je lze PŘÍMO použít se surovými hodnotami z A/D převodu (tzn. zařízení se už postaralo o převod údajů zadaných uživatelem ve webovém rozhraní na tento formát). V důsledku je pak realizace algoritmu velmi snadná.<br />
<br />
sys[740] 02 i R primary voltage to say target is ok (pri_pvts)<br />
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)<br />
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)<br />
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)<br />
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)<br />
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)<br />
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)<br />
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)<br />
sys[748] 02 i R flag: do not switch accu off (aku_dach)<br />
<br />
Hodnoty sys[740] až sys[748] jsou konfigurační údaje (uživatel je změnil přes webové rozhraní, a tím se uložili do pevné paměti, takže vydrží reset nebo vypnutí zařízení). Pokud do nich v SDS-C programu zapíšete, tato nová zapsaná hodnota zůstane platná až do resetu nebo vypnutí, nebo do ručního přepsání uživatelem (ve webovém rozhraní). Zápis do těchto konkrétních sys[] nezpůsobí uložení nových hodnot do pevné paměti.<br />
<br />
sys[749] až sys[760] reserved<br />
<br />
'''Výstupy:'''<br />
<br />
Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !<br />
<br />
<br />
sys[761] 02 i RW ovládání vypínání nabíječe<br />
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])<br />
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)<br />
<br />
sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe <br />
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)<br />
!= 0 : zásah do zpětné vazby (posun rozsahu)<br />
(vhodné pro skokové zvýšení výstupního napětí nabíječe, <br />
když už nereaguje v původním rozsahu)<br />
<br />
sys[763] 02 i RW ovládání odpojovače baterie <br />
== 0 : spínač vypnutý (baterie odpojena od zátěže)<br />
!= 0 : spínač sepnutý (baterie připojena)<br />
<br />
sys[764] 02 i RW indikační LED - nabíjení akumulátoru<br />
== 0 : LED svítí (informace: akumulátor je nabíjen)<br />
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)<br />
<br />
sys[765] 02 i RW indikační LED - výpadek primárního vstupu<br />
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)<br />
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)<br />
<br />
'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:<br />
<br />
sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)<br />
- minimální hodnota = 1<br />
- maximální hodnota = 2497<br />
<br />
sys[767] až sys[769] RESERVED vyhrazeno<br />
<br />
Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':<br />
<br />
sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx<br />
<br />
sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx<br />
<br />
sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx<br />
<br />
Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):<br />
<br />
UPS_PROVOZ_START 0<br />
UPS_PROVOZ_PRIOK 1<br />
UPS_PROVOZ_PRIOK_CHARGING 2<br />
UPS_PROVOZ_ONLY_BATT 4<br />
UPS_PROVOZ_NO_BATT 8<br />
<br />
UPS_NABREZIM_CC 0<br />
UPS_NABREZIM_CV 2<br />
UPS_NABREZIM_PAUZA 4<br />
UPS_NABREZIM_URCENI_REZIMU 8<br />
<br />
UPS_BATERIE_ODHAD_NEZNAM 0<br />
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1<br />
UPS_BATERIE_ODHAD_OK_NABIJIM 2<br />
UPS_BATERIE_ODHAD_PLNE_NABITO 4<br />
<br />
<br />
== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==<br />
<br />
Připojené moduly [[SDS_1W_T-RH]] jsou připojeny na 1-W sběrnici, a mají v sobě chip, který měří hodnotu ze sensoru vlhkosti (který je současně umístěn na modulu SDS-1W-T-RH) a současně měří i teplotu a napájecí napětí pro sensor vlhkosti. <br />
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.<br />
<br />
K dispozici jsou jak surové hodnoty (změřené v rámci modulu SDS-1W-T-RH), tak i hodnota kompenzované (skutečné) relativní vlhkosti v místě umístění modulu.<br />
<br />
<br />
Změřená teplota je uložena na standardních indexech:<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 degC<br />
<br />
Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):<br />
<br />
sys[800] až sys[831] <br />
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
sys[832] až sys[863] <br />
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
SDS provádí přepočet na údaj RH v procentech (0 až 100):<br />
<br />
sys[864] až sys[895] <br />
08 i R hodnota RH (0 až 100, v procentech RH) kompenzovaná podle rovnice pro čidlo HIH-503x (výpočet z Vad, kompenzace na Vdd a Temp).<br />
<br />
Rezerva (zatím nepoužito):<br />
<br />
sys[896] až sys[899] RESERVED vyhrazeno<br />
<br />
<br />
== Doplňující informace pro 1-Wire zařízení ==<br />
<br />
1-Wire sběrnice u zařízení SDS umožňuje komunikaci s celou řadů 1-W chipů: [[OneWire|seznam je zde]]. Přístup k chipům na 1-W sběrnici se liší na dva typy: chipy (čidla) které si SDS interně zpracuje (např. měření teploty), a všechny ostatní chipy (které SDS jen umí vyhledat a oznámit, ale dále s nimi nekomunikuje).<br />
<br />
<br />
'''1-Wire chipy interně zpracovávané SDS'''<br />
<br />
Tyto chipy jsou plně automaticky obsluhovány prostřednictvím firmware SDS - není potřebná opakovaná intervence uživatele, ten si pouze čte stále aktuální výsledky měření teplot z jednotlivých čidel.<br />
<br />
Poznámka: Pro změřené hodnoty z 1-W čidel teplot, jsou k dispozici tyto indexy: '''sys[310]''' až '''sys[430]''', a '''sys[900]''' až '''sys[931]'''.<br />
<br />
K dispozici je textové vyjádření (hex znaky) ROM CODE hodnoty načtené pro danou pozici zpracovávaného chipu na 1-W sběrnici.<br />
<br />
Zařízení SDS mohou mít jednu [A] nebo dvě ( nezávislé, [A] a [B] ) 1-Wire sběrnice, a každá sběrnice má maximálně 16 připojených chipů.<br />
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:<br />
<br />
sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále až<br />
<br />
sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):<br />
<br />
sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále . . . až<br />
<br />
sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.<br />
<br />
Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.<br />
<br />
Poznámka: ROM CODE pro 1-W chipy jsou k dispozici pouze jako ucelené texty (string). Bajtový rozpad jednotlivých položek není k dispozici.<br />
<br />
sys[931] až sys[939] reserved<br />
<br />
<br />
<br />
'''Ostatní 1-Wire chipy'''<br />
<br />
Pro ostatní 1-W chipy, které SDS "nezná" (tzn. nekomunikuje s nimi, jen je umí na sběrnici vyhledat), jsou jejich ROM CODE odděleny do samostatných '''sys[]''' položek.<br />
<br />
Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci. <br />
Na základě zavolání této funkce dojde k vynulování všech příslušných '''sys[]''' (od indexu 940 resp. 970) pro danou sběrnici, a provede se pokus o přečtení připojeného chipu.<br />
Pokud se to povede, bude nalezený ROM CODE (spolu s časovou značkou okamžiku přečtení) vložen do příslušných '''sys[]''', <br />
nebo bude nastaven chybový kód.<br />
<br />
Pozor, k SDS lze připojit více různých "ostatních" chipů, ale zdejší funkce najde jenom ten první z nich a ostatní už ignoruje. <br />
Ostatní chipy lze samozřejmě připojit na kteroukoliv sběrnici, i když na ní jsou připojeny i chipy se kterými SDS komunikuje (např. teploměrné chipy).<br />
<br />
Jednotlivé chipy se rozlišují pomocí hodnoty ''ID family-code'' (jeden bajt). Pro chip DS1990A je ''0x01'', hodnoty pro jiné chipy viz datasheet výrobce pro konkrétní chip.<br />
<br />
Obecný stav sběrnic:<br />
<br />
sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů<br />
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů<br />
:<br />
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici<br />
<br />
== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice<br />
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)<br />
<br />
== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu<br />
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)<br />
<br />
== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)<br />
<br />
== 8 : byl přečten ROM CODE z připojeného ostatního chipu<br />
(už lze také požádat o další nové čtení 1-W sběrnice)<br />
<br />
== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici <br />
(zkuste provést rescan/čtení znovu)<br />
<br />
sys[942] až sys[949] reserved<br />
<br />
'''Pro sběrnici [A]:'''<br />
<br />
sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[951] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire<br />
:<br />
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[953] 06 i R romcode[1] (1-W: serial code)<br />
sys[954] 06 i R romcode[2] (1-W: serial code)<br />
sys[955] 06 i R romcode[3] (1-W: serial code)<br />
sys[956] 06 i R romcode[4] (1-W: serial code)<br />
sys[957] 06 i R romcode[5] (1-W: serial code)<br />
sys[958] 06 i R romcode[6] (1-W: serial code)<br />
sys[959] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[960] až sys[969] reserved<br />
<br />
'''Pro sběrnici [B]:'''<br />
<br />
sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[971] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire<br />
:<br />
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[973] 06 i R romcode[1] (1-W: serial code)<br />
sys[974] 06 i R romcode[2] (1-W: serial code)<br />
sys[975] 06 i R romcode[3] (1-W: serial code)<br />
sys[976] 06 i R romcode[4] (1-W: serial code)<br />
sys[977] 06 i R romcode[5] (1-W: serial code)<br />
sys[978] 06 i R romcode[6] (1-W: serial code)<br />
sys[979] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[980] až sys[989] reserved<br />
<br />
Všimněte si, že SDS v tuto chvíli umožňuje pouze rescan 1-W sběrnice, kdy hledá pouze '''jeden''' připojený "ostatní 1-W chip" (ten první na který narazí, ten ohlásí, a nehledá dále). <br />
<br />
'''Pozor''':<br />
<br />
Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy, <br />
bude při tomto rescanu uveden pouze první nalezený ostatní chip (tj. ten, který má nejnižší ROM-CODE ze všech připojených ostatních chipů).<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[990] až sys[1023] reserved<br />
<br />
<br />
== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==<br />
<br />
'''Přímý přístup do LCD Frame Buffer paměti:'''<br />
<br />
sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)<br />
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst<br />
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)<br />
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye<br />
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)<br />
<br />
Tyto položky jsou dosupné '''pouze a jenom''' na SDS-MACRO-LM kde je vyžadován firmware od 24.11.2016 nebo novější, a na SDS-MACRO-ST (všechny FW verze).<br />
<br />
Jakékoliv změny (zápis) se promítnou pouze do frame bufferu (tedy v paměti SDS) - ale aby se následně tento frame buffer (jeho změněný obsah) eventuálně vykreslil na LCD, je potřeba zavolat příslušnou SDS-C funkci !<br />
<br />
Čtení ze sys poskytuje přímý přístup do frame bufferu (jeho aktuální obsah, tedy opět ne nutně to co je právě vidět na LCD).<br />
<br />
Pokud nepoužíváte LCD (sandwich desku), můžete tuto oblast 528 bajtů využít pro jakékoliv své účely. V podstatě se pak jedná o rozšiřující RAM pamět pro váš SDS-C program.<br />
<br />
'''Pozor''' SDS-MACRO-ST<br />
<br />
SDS MACRO ST provádí automatické aktualizace (zápis) do LCD bufferu, pokud se o tento buffer nepřihlásí SDS-C program. Proto, pokud na MACRO-ST chcete využít LCD buffer pro jiné své účely, musíte to nejprve SDS říct. Znovu, toto platí jen pro MACRO-ST - ''není to potřeba pro MACRO-LM (které tam po zapnutí nahraje logo a pak už na buffer za běhu nesáhne)''. Pro MACRO-ST zavolejte kteroukoliv SDS-C funkci pro přístup na display (např. clear) a je to - tím se přepne vlastnictví LCD bufferu pro SDS-C program.<br />
<br />
== Vyhrazená oblast ==<br />
<br />
'''Zbytek:'''<br />
<br />
sys[1552] až sys[1663] reserved<br />
<br />
<br />
== Bateriově Zálohovaná Paměť ==<br />
<br />
'''POUZE PRO: SDS-TTCPRO a SDS-MINI a SDS-MICRO-ST a SDS-MACRO-sT a SDS-IO6-ST !''' (tedy ty s baterií) - všechny jiné SDS První Řady tyto specifické indexy v sys[] nemají k dispozici!<br />
<br />
Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější. <br />
<br />
sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)<br />
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot<br />
- každý index má k dispozici 32 bitů (tj. celý signed integer)<br />
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)<br />
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")<br />
<br />
Pozor! Oblast záložní paměti je k dispozici pouze na vybraných zařízeních SDS (ty, které mají osazenu baterii pro tyto účely). Údaje se nesmazají změnou programu (nahráním nového programu), ani se nesmazají resetem zařízení (kromě aktivace RSTD - pozor!), tzn. vydrží a zůstanou, a to dokonce i po celou dobu výpadku externího napájení (tak dlouho, dokud se nevybije záložní baterie).<br />
<br />
''(Pouze) pokud baterie v daném SDS není'': tak jsou údaje ztraceny po výpadku napájení (ale po dobu přítomnosti externího napájení jsou k dispozici). Při takové situaci není zaručen obsah těchto dat po zapnutí (měl by být nulový, ale bez záruky).<br />
<br />
<br />
== Další informace ze S0 vstupů ==<br />
<br />
Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.<br />
<br />
Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:<br />
<br />
sys[1792] až sys[1823] <br />
07 i R cena za jednotku v režimu T0<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1824] až sys[1855] <br />
07 i R cena za jednotku v režimu T1<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1856] až sys[1887] <br />
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")<br />
- text<br />
<br />
sys[1888] až sys[1919]<br />
07 s R název měny, podle nastavení (např. text "CZK")<br />
- text<br />
<br />
sys[1920] až sys[1951] <br />
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")<br />
- text<br />
<br />
sys[1952] až sys[1983] <br />
07 s R název činnosti, podle nastavení (např. text "spotřeba")<br />
- text<br />
<br />
sys[1984] až sys[2015] <br />
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")<br />
- text<br />
<br />
sys[2016] až sys[2047] <br />
07 i R konfigurační detaily pro daný S0 vstup<br />
- bit 0 nastaven = je to aktivní S0 vstup<br />
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)<br />
<br />
Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2048] až sys[2198] reserved<br />
<br />
<br />
== MQTT klient ==<br />
<br />
Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:<br />
<br />
sys[2199] 09 i R podpora MQTT<br />
0 = NE<br />
1 = ANO, verze MQTT 3.1.1, SDS první část implementace<br />
2..max = (reserved)<br />
<br />
Každé nové připojení k Brokeru:<br />
<br />
sys[2200] 09 i R stav průběhu mqtt_connect()<br />
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno a odeslán CONNECT požadavek<br />
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )<br />
8 = probíhá odpojování, čekáme na výsledek (na odpojení)<br />
<br />
Po zavolání mqtt_connect(...) je nutné testovat sys[2200] na výslednou hodnotu. Funkci mqtt_connect(...) nelze volat, je-li sys[2200] na hodnotě 1, 2, 8 nebo 16 (nejprve je v takových případech potřeba provést odpojení pomocí mqtt_disconnect() funkce). Pro úplný test, je-li připojení z SDS do Brokeru úplné, je potřeba ověřit i hodnotu v sys[2201]. Teprve pokud oba tyto sys jsou na správné hodnotě, lze s Brokerem komunikovat.<br />
<br />
sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"<br />
-7 = nepoužito<br />
-6 = timeout při čekání na CONNACK, nepřipojeno<br />
-5 = nepoužito<br />
-4 = nepoužito<br />
-3 = nepoužito<br />
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)<br />
-1 = idle, nepřipojeno<br />
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)<br />
1 = MQTT 0x01: Connection Refused, unacceptable protocol version<br />
2 = MQTT 0x02: Connection Refused, identifier rejected<br />
3 = MQTT 0x03: Connection Refused, Server unavailable<br />
4 = MQTT 0x04: Connection Refused, bad user name or password<br />
5 = MQTT 0x05: Connection Refused, not authorized<br />
<br />
Hodnotu v sys[2201] lze číst a zpracovat pouze pokud je sys[2200] na hodnotě 16 (to znamená, pouze pokud SDS obdrží odpověď CONNACK od MQTT brokera).<br />
<br />
Před a po každém volání mqtt_publish() a nebo mqtt_subscribe() funkcí je potřeba sledovat obsah následují položky:<br />
<br />
sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci<br />
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat<br />
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu<br />
-4 = nespravne parametry (počet parametrů)<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity<br />
0 = nepoužito<br />
1 = mqtt_publish() probíhá<br />
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci<br />
4 = mqtt_subscribe() probíhá - čekám na SUBACK<br />
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci<br />
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)<br />
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce<br />
<br />
Informativní položka:<br />
<br />
sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru<br />
(objeví-li se chyba, dojde k okamžitému odpojení)<br />
<br />
Zatím nepoužité pozice:<br />
<br />
sys[2204] až sys[2208] reserved<br />
<br />
Pro každou příchozí datovou zprávu z Brokeru, je tato zpráva uložena do následujících sys: (pozor, každá nová příchozí zpráva přepíše předchozí údaje)<br />
<br />
sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)<br />
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)<br />
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)<br />
<br />
SDS umí přijaté datové zprávy uchovat, v rámci následující tabulky. Toto je důležité zejména pokud různé zprávy přicházejí velice rychle za sebou, aby se pro SDS-C program neztratili.<br />
<br />
Nejvíce lze mít až 32 položek (řádků) v tabulce, nicméně některá SDS nemají ve své paměti dostatečné místo a počet je tedy omezen. Pozor na to při psaní programu !<br />
<br />
sys[2209] 09 i R počet řádků v tabulce pro dané SDS (různé SDS mají různě volnou paměť, proto je v nich i různý počet použitelných Subscribe položek)<br />
<br />
Jednotlivé položky v tabulce příchozích zpráv:<br />
<br />
sys[2211] až sys[2241] <br />
09 s R název položky (Topic Name) pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2242] až sys[2249] reserved<br />
<br />
sys[2251] až sys[2281] <br />
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2282] až sys[2289] reserved<br />
<br />
sys[2291] až sys[2321] <br />
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru<br />
(pro detekci změny - příchozí zprávy z Brokeru)<br />
0 = zatím nic nepřišlo<br />
1..MAX = hodnota uptime v okamžiku poslední změny<br />
<br />
Nastavení Topic názvů každé položky (tedy "zápis" do sys[2211] až sys[2241]) se provede funkcí mqtt_subscribe(), které zadáváte pozici v této tabulce a název Topicu. Pokud se Subscribe nepovede, zůstane pozice v tabulce prázdná. Po připojení k Brokeru je tabulka vždy zcela prázdná, a SDS-C program si ji vždy musí dle potřeby naplnit. Pokud Broker pošle aktualizaci obsahu (value) na některou z přihlášených Topic položek, které SDS v této tabulce má, tak SDS automaticky přepíše patřičný řádek tabulky (tj. obsah jednoho ze sys[2251] až sys[2281]) a patřičně aktualizuje časovou známku změny.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2322] až sys[2398] reserved<br />
<br />
<br />
== MODBUS-TCP klient ==<br />
<br />
Ověření FW v SDS:<br />
<br />
sys[2399] 09 i R podpora pro MODBUS TCP<br />
0 = NE<br />
1 = ANO (první verze implementace v SDS)<br />
<br />
Každé nové TCP spojení na server:<br />
<br />
sys[2400] 09 i R stav průběhu modbus_tcp_connect()<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno, můžete komunikovat <br />
<br />
MODBUS funkce - každá má svůj nezávislý stavový údaj:<br />
<br />
sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
pro všechny tyto stavy platí následující hodnoty:<br />
-6 = timeout (neprovedeno), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty), můžete volat další funkci<br />
-4 = nespravne parametry (počet parametrů), můžete volat další funkci<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity, lze volat funkci<br />
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci<br />
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci<br />
256 = pracuji, čekejte na aktualizovanou hodnotu<br />
<br />
sys[2417] až sys[2462] reserved<br />
<br />
sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
Přijatá data (funkce _read) - obsah je aktualizován pro každou novou přijatou MODBUS zprávu. Výsledky (přijatá data) jsou vždy uloženy do následujících sys (bez ohledu na typ MODBUS funkce).<br />
<br />
sys[2465] 09 i R timestamp poslední přijaté zprávy<br />
(vhodné pro detekci nové přijaté zprávy)<br />
<br />
sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu<br />
(počet celých položek)<br />
<br />
sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy)<br />
<br />
sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy) <br />
<br />
sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])<br />
(MODBUS způsob číslování položek - adresa 1..n)<br />
<br />
sys[2470] až sys[2719]<br />
09 i R přijaté hodnoty pro poslední přijatou zprávu<br />
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input<br />
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr<br />
<br />
Pro funkce 0x01 a 0x02 jsou přijatá data kódována v jednobitovém tvaru, vždy po osmi bitech na jeden sys[]. Takže prvních osm bitů naleznete v sys[2465], dalších osm bitů v sys[2466] a tak dále.<br />
<br />
Pro funkce 0x03 a 0x04 jsou přijaté hodnoty registrů (MODBUS: vždy int16_t) uloženy postupně zasebou (tak jak přišli ve zprávě) do jednotlivých sys[], takže první registr je v sys[2465], druhý ve sys[2466] atd.<br />
<br />
<br />
Rezerva<br />
<br />
sys[2715] až sys[2809] reserved<br />
<br />
<br />
== Statistiky COMx ==<br />
<br />
COM1:<br />
<br />
sys[2810] 09 i R reserved<br />
<br />
sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1<br />
<br />
sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1 <br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1<br />
<br />
sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1<br />
<br />
sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1 <br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1<br />
<br />
<br />
Rezerva<br />
<br />
sys[2817] až sys[2860] reserved<br />
<br />
<br />
COM6:<br />
<br />
sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6<br />
<br />
sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6<br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6<br />
<br />
sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6<br />
<br />
sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6<br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6<br />
<br />
Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).<br />
<br />
<br />
== Konec dokumentu ==<br />
<br />
'''Konec dokumentu.'''</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS-C:_sdsc_sysp&diff=968SDS-C: sdsc sysp2025-11-15T11:06:13Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS. <br />
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).<br />
<br />
== Definice systémových proměnných SDS-C : pole sys[] ==<br />
<br />
Tzv. "systémová proměnná" je prvek v programovacím jazyku SDS-C, který má textový název, a se kterým se dá pracovat - číst hodnotu z proměnné a zapisovat hodnotu do proměnné. Často je čtení a zápis svázáno s fyzickou akcí (např. zápis do konkrétní systémové proměnné změní stav relé).<br />
<br />
SDS-C obsahuje celou řadu vyhrazených, předem pevně definovaných systémových proměnných. Tyto proměnné obsahují aktuální online informace a údaje, vzhledem ke stavu zařízení. Dá se jimi také zařízení (resp. periférie) přímo ovládat. Úplný seznam je právě na této stránce.<br />
<br />
Proměnné poskytované SDS-C a navázané na HW zařízení, jsou označeny jako '''sys[x]''', kde index '''x''' je číslo do 0 do 1023 (popřípadě až do 2048 ale to jen na určitých typech zařízení).<br />
<br />
Tyto proměnné lze číst, popř. do nich zapsat novou hodnotu. To vše můžete provést ve svém SDS-C programu, nebo přes některou z komunikačních funkcí (např. UDP protokolem, nebo přes webové rozhraní).<br />
<br />
<br />
''Legenda k tabulce:''<br />
<br />
Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).<br />
<br />
Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.<br />
<br />
Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW'''). <br />
<br />
Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.<br />
'''Význam hodnot:'''<br />
* '''01''' - první verze, výchozí firmware ze začátku roku 2010<br />
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011<br />
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011 <br />
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější<br />
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější<br />
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější<br />
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější<br />
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější<br />
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější<br />
<br />
Všechny proměnné označené jako rezerva mohou být v budoucích verzích firmware nějak využity. Pokud jsou však pro tuto verzi firmware označeny jako rezerva, pak se nesmí používat (zapisovat do nich, kvůli budoucí kompatibilitě). Při čtení obvykle vrací hodnotu nula, ovšem jakmile budou v novém firmware využity, už budou vracet konkrétní hodnotu.<br />
<br />
Pokud máte starší verzi firmware, je možné, že některé později přidané položky nebudou k dispozici. Řešením je udržovat firmware ve vašem zařízení vždy aktuální.<br />
<br />
Jazyk SDS-C indexuje všechny pole od čísla 0 (nula) - všechna pole, tj. "sys[]", "ram[]", "text[]", začínají se svým obsahem od indexu nula.<br />
<br />
'''Pozor''' však na číslování hardware vstupů a výstupů, ty jsou číslovány dle "elektrikářských" zvyklostí, to znamená že číslování začíná od čísla '''1''' ('''jednička''') - toto ale nemá hlubší vliv na SDS-C.<br />
<br />
Pokud narazíte na takové zařízení SDS, které má ještě velmi starou verzí webového rozhraní, kde byly ještě některé vstupy číslovány od nuly, aktualizujte si toto zařízení aby používalo nejnovější firmware.<br />
<br />
<br />
'''Důležité upozornění'''<br />
<br />
Protože SDS-C ''umí pracovat pouze a jen'' s '''32-bit signed''' integer čísly (tj. 1-bit znaménko a 31-bitů číslo, typ int32_t), tak dochází k (očekávané) konverzi '''32-bit unsigned''' čísel (tj. bez znaménka 32-bitů číslo, typ uint32_t) mezi vnitřními hodnotami v SDS a reprezentací v SDS-C (například když takové unsigned číslo je dotazováno například přes čtení "sys[]" hodnot).<br />
<br />
Jinýmy slovy - uvnitř SDS jsou drženy některé hodnoty jako 32-bit unsigned. Ale protože SDS-C pracuje pouze s 32-bit signed čísly, pak při čtení takových čísel zevnitř SDS jsou tyto čísla prezentovány v SDS-C jako 32-bit signed. Bitově se nezmění, jen se "mění" pohled na to, co který bit znamená, viz text dále.<br />
<br />
''Příklad:'' <br />
Hodnota "sys[625]" reprezentuje "uplynulý čas od posledního zachyceného S0 impulsu na daném S0 vstupu". Tato hodnota je udržována uvnitř SDS a program SDS-C k ní má přístup.<br />
Tento čas je udán v milisekundách a začína na nule, a s každou milisekundou ze zvýší o jedničku. Protože SDS udržuje toto počítadlo (uvnitř své paměti) jako '''32-bit unsigned''', tak jakmile dojde k dopočítání do 31-bitů (tj. 2147483647) a překlopí se tedy 32. bit (tj. na 2147483648), tak SDS-C při čtení "sys[625]" vrátí zápornou hodnotu (tj. -2147483648). Toto je v pořádku - pokud si vypíšete jednotlivé bity, tak budou stále přesně odpovídat, ale tím že SDS-C interpetuje všechny čísla jako '''32-bit signed''', tak vzorovou hodnotu použije a zobrazí jako zápornou.<br />
<br />
<pre><br />
skutečná binární hodnota | 32-bit signed | 32-bit unsigned<br />
(32-bit) | SDS-C integer | (internal SDS)<br />
----------------------------------+---------------+-----------------<br />
00000000000000000000000000000000 | 0 | 0<br />
00000000000000000000000000000001 | 1 | 1<br />
00000000000000001111111111111111 | 65535 | 65535<br />
01111111111111111111111111111111 | 2147483647 | 2147483647<br />
10000000000000000000000000000000 | -2147483648 | 2147483648<br />
10000000000000000000000000000001 | -2147483647 | 2147483649<br />
10000000000000001111111111111111 | -2147418113 | 2147549183<br />
11111111111111111111111111111111 | -1 | 4294967295<br />
11111111111111111111111111111110 | -2 | 4294967294<br />
11111111111111111111111111111101 | -3 | 4294967293<br />
</pre><br />
<br />
Jak lze vidět, SDS vždy (ať ve svém firmware, tak v SDS-C kódu a proměnných) udržuje hodnoty ve stejném ''binárním'' obsahu. Jen interpretace a další práce s čísly je jiná. SDS samo vnitřně pracuje s '''32-bit unsigned''' hodnotami, a díky tomu na webu a všech M2M stránkách můžete vidět hodnoty v rozsahu od 0 do 4294967295. Zato SDS-C pracuje pouze se '''32-bit signed''' hodnotami, a proto stejné číslo je reprezentováno v rozsahu -2147483648 až 2147483647. Toto je vlastnost daná omezením implementace, zkrátka v SDS-C to nelze jinak udělat (pokud to je problém, což ale není, tak můžete přejít na zařízení s FULL-C které tyto omezení nemá).<br />
<br />
To lze snadno ve vašem SDS-C kódu ošetřit, a pokud pouze přenášíte hodnoty z SDS na server (přes HTTP-GET), tak se to dá snadno a ihned zpracovat na serveru "zpět" na '''32-bit unsigned''' hodnotu. Jednoduše na serveru přijmete '''signed''' číslo, a převedete ho například přetypování na '''unsigned''' číslo. Bity v paměti totiž jsou pro oba typy stejné.<br />
<br />
V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''<br />
<br />
<br />
'''Použítí v SDS-C programu'''<br />
<br />
Zápis a čtení z/do systémových proměnných má okamžitý přímý vliv na hardware, se kterým jsou konkrétní proměnné svázány.<br />
<br />
Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)? <br />
<syntaxhighlight lang="c"><br />
teplota0_ve_stupnich_C = sys[310] / 100;<br />
</syntaxhighlight><br />
<br />
Ne vždy je potřeba provádět převody. Pokud např. chcete porovnat dvě hodnoty z různých teplotních čidel, můžete to udělat přímo (bez dělení 100 jako v předchozím příkladu) - samozřejmě toto platí pouze tehdy, pokud porovnáváte hodnoty ve stejných jednotkách:<br />
<syntaxhighlight lang="c"><br />
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };<br />
</syntaxhighlight><br />
<br />
Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):<br />
<syntaxhighlight lang="c"><br />
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)<br />
</syntaxhighlight><br />
<br />
Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:<br />
<syntaxhighlight lang="c"><br />
#define RELE1 sys[231]<br />
<br />
#define TEPLOTA sys[310]<br />
<br />
// ...<br />
<br />
RELE1 = 255;<br />
<br />
if (TEPLOTA > 3200) goto x;<br />
</syntaxhighlight><br />
<br />
<br />
== Pole ram[] ==<br />
<br />
Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).<br />
<br />
Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.<br />
<br />
Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).<br />
<br />
Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:<br />
<syntaxhighlight lang="c"><br />
hodnota = ram[10];<br />
<br />
index = 23;<br />
ram[index] = 15 * 2;<br />
<br />
index = sys[1023];<br />
ram[index] = 30;<br />
</syntaxhighlight><br />
<br />
Pole ram[] je indexováno od indexu nula (tj.: ram[0]). Celková velikost (maximální index) je dán verzí SDS-C a konkrétního firmware v zařízení. <br />
<br />
Verze SDS-C č. 03 má maximální velikost pole ram[] nastavenou na 128 položek. '''Novější verze už mají počet zvýšený ''' - verze č. 06 má velikost ram[] nastavenou na 512 položek (každá o velikosti int32_t).<br />
<br />
Pole ram[] můžete využít k čemukoliv co potřebujete. Také i pro některé SDS-C funkce, jako je ''http_get()'', která může do pole ram[] ukládat obsah textu obdrženého ze serveru (toto chování se nastavuje příslušnými sys[]), nebo při přenosu stránek z/do paměti DF.<br />
<br />
<br />
== Ukládání trvalých dat ==<br />
<br />
Všechny verze SDS-C mají od k dispozi prostor v oblasti sys[100] až sys[115]. Toto je výchozí oblast pro uchovávání trvanlivých dat (tyto údaje se neztratí při výpadku napájení). Přímým zápisem, do těchto sys[] položek, dojde k zápisu do pevné paměti. Čtení se provádí opět přímým přístupem do těchto sys[].<br />
<br />
Od verze SDS-C č. 05 je možno, navíc k tomuto základu, zapisovat a přečíst mnohem větší množství údajů v externím paměťovém chipu DATAFLASH (NVM = Non-Volatile Memory), osazeném na desce zařízení SDS, a to prostřednictvím čtyř SDS-C funkcí.<br />
<br />
Pozn. historické verze zařízení SDS-MICRO LIGHT, kde se používá paměť EEPROM (na místo novější DataFlash), poskytuje vždy pouze základní rozsah indexů: 100 až 115, a neposkytuje rozšířený rozsah pevné paměti (tak jako zařízení s pamětí DataFlash).<br />
<br />
Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].<br />
<br />
Další možnost:<br><br />
Zařízení SDS řady ST mají k dispozici, kromě podpory pro DataFlash, i možnost využít Zálohovanou paměť RAM (ta drží obsah i při vypnutém napájení SDS, pokud je v SDS vložena nabitá zálohovací baterie).<br />
<br />
<br />
== Pole text[] ==<br />
<br />
Od verze SDS-C č. '''06''' je možné v určité míře pracovat s texty. Toto má především využití v komunikaci přes sériovou linku (RS232/RS485) a při odesílání a příjmu dat (email, http) či práci s komunikačními moduly (GSM, LTE, LoRA).<br />
<br />
Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].<br />
<br />
SDS-C je omezený programovací jazyk z hlediska "práce s textem". Pokud potřebujete intenzivně s textem pracovat, použijte zařízení SDS které má FULL-C jazyk.<br />
<br />
I přes omezení SDS-C je možné připojit různé komunikační moduly (GSM, LTE, LoRA), které komunikují prostřednictvím textových příkazů (viz vzorové programy).<br />
<br />
<br />
== Pole share[] ==<br />
<br />
<br />
Od verze SDS-C č. '''08''' je možné použít pole '''share[]''', určené primárně pro sdílení textové informace mezi SDS-C programem a webovým rozhraním (tedy jako [[SDS-C:_sharing|sdílené proměnné]]).<br />
<br />
Práce s polem share[] je prakticky zcela shodná jako práce s polem text[]. Prakticky tak získává programátor dvě nezávislé pole pro uchování textu. Nicméně, některé SDS-C funkce vyhrazeně fungují jen s polem text[], ale to je vždy uvedeno v jejich popisu. <br />
<br />
<br />
== Vyhrazené funkce ==<br />
<br />
Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].<br />
<br />
<br />
== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==<br />
<br />
'''STAV SYSTÉMU'''<br />
<br />
sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)<br />
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program<br />
<br />
sys[1] 01 i R počet přihlášených uživatelů do webového rozhraní (v okamžiku čtení této proměnné)<br />
<br />
sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci<br />
<br />
sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)<br />
- počítá se od nuly (0) od každého zapnutí zařízení<br />
- pouze 31 bitové počítadlo<br />
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně<br />
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule<br />
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času <br />
<br />
sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)<br />
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem<br />
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)<br />
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)<br />
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně, <br />
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)<br />
- platné hodnoty: 0 až 2147483647 (včetně)<br />
<br />
sys[5] 01 i R rozpad LOCAL času: den (1 až 31)<br />
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)<br />
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)<br />
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)<br />
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)<br />
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)<br />
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)<br />
<br />
'''Upozornění''': hodnota LOCAL času je platná až po úspěšném získání informací z NTP serveru. Po zapnutí (restartu) zařízení je NTP čas (sys[38], sys[4]) nastaven na nulu. Čas je automaticky v SDS aktualizován co jednu sekundu pomocí vnitřních hodin v SDS, a dále je hodnota času pravidelně (v delším intervalu) upřesněna dotazem na NTP server.<br />
<br />
V případě, že není zapnuta automatika DST (letní čas) a GMT offset je nastaven na nulu, tak je hodnota LOCAL času identická s NTP časem (UTC). Jakmile se ale nastaví offset nebo aktivuje posun letního času, už jsou tyto hodnoty odlišné (NTP je UTC, a LOCAL je místní (posunutý) čas). Pro různé použití je potřeba různých časů (často je potřeba UTC pro časové známkování údajů, a zase někdy je vhodný LOCAL pro interakci s uživatelem a pro různé výpisy).<br />
<br />
<br />
== Ethernet, Internet ==<br />
<br />
sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)<br />
sys[13] 01 i R IP[1] adresa zařízení<br />
sys[14] 01 i R IP[2] adresa zařízení<br />
sys[15] 01 i R IP[3] adresa zařízení<br />
<br />
sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)<br />
sys[17] 01 i R GW_IP[1] adresa brány<br />
sys[18] 01 i R GW_IP[2] adresa brány<br />
sys[19] 01 i R GW_IP[3] adresa brány<br />
<br />
sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)<br />
sys[21] 01 i R NETMASK[1] síťová maska<br />
sys[22] 01 i R NETMASK[2] síťová maska<br />
sys[23] 01 i R NETMASK[3] síťová maska<br />
<br />
sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)<br />
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)<br />
!= 0 : Ethernetová komunikace je funkční (LINK OK)<br />
<br />
sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)<br />
== 0 : neznámá rychlost (není k dispozici Ethernet)<br />
== 10 : 10 MBit per sec<br />
== 100 : 100 MBit per sec<br />
<br />
sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)<br />
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)<br />
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti <br />
(po resetu zařízení se vráti na poslední uloženou hodnotu)<br />
<br />
sys[27] 06 i R platnost přidělené IP adresy zařízení SDS<br />
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)<br />
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet<br />
<br />
sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,<br />
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)<br />
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik<br />
<br />
sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)<br />
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)<br />
== 1 : odesláno DHCP DISCOVER<br />
== 2 : obdrženo DHCP OFFER<br />
== 3 : odesláno DHCP REQUEST<br />
== 4 : obdrženo DHCP ACK<br />
== 5 : IP adresa je přidělena (BOUND)<br />
== 6,7,8,9,10,11 : zpracování DHCP RENEW<br />
<br />
sys[30] 06 i R aktuální hodnota "DHCP Lease Time"<br />
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)<br />
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)<br />
- údaj je uveden v jednotkách [sec]<br />
<br />
sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)<br />
sys[32] 04 i R MAC[1] <br />
sys[33] 04 i R MAC[2] <br />
sys[34] 04 i R MAC[3] <br />
sys[35] 04 i R MAC[4] <br />
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)<br />
<br />
sys[37] 06 i R NTP Client Status (synchronizace času)<br />
== 0 : nesynchronizováno<br />
== 1 : úspěšně přijal paket od NTP Serveru<br />
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz <br />
(dotaz se odešle za 10sec od takovéhoto zápisu)<br />
<br />
sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)<br />
- není zde aplikován offset, ani automatika letního času<br />
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď), <br />
uvnitř SDS je sice udržována jako 32bit, <br />
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).<br />
<br />
sys[39] 07 i R stav automatiky přepínání Letního Času<br />
== 0 : automatika zakázána, lokální čas není ovlivněn<br />
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").<br />
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").<br />
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).<br />
09 i W pouze pro případ vypnutého NTP: ruční ovládání automatiky (tzn. povolena nebo nepovolena) (SELČ pak automatika sama rozhodne, je-li povolena)<br />
zápis 0 : vypnout automatiku (nebude pracovat = nebude aplikoval posun pro SELČ pro nastavený rozsah v roce), sys[39] pak vrátí 0 při čtení<br />
zapis 3 : zapnout automatiku (automatika aplikuje posun pro SELČ podle toho jaký je aktuální čas a datum), sys[39] pak vrátí 1 nebo 2 dle stavu <br />
<br />
sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)<br />
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)<br />
<br />
sys[139] 09 i R vyhrazeno<br />
<br />
Princip funkce automatiky letního času je popsán jinde na této wiki. Funkce automatiky je samozřejmě volitelná (viz: ruční nastavení ve webovém rozhraní).<br />
<br />
sys[40] až sys[44] RESERVED vyhrazeno<br />
<br />
<br />
== Provozní údaje ==<br />
<br />
sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)<br />
- po resetu zařízení začíná vždy počítat od nuly<br />
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);<br />
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!<br />
- pro sys[45] je k dispozici 31 bitů,<br />
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru<br />
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).<br />
<br />
sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),<br />
význam hodnot závisí na typu konkrétního zařízení SDS. <br />
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.<br />
<br />
SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM): <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]<br />
<br />
SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST: <br />
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]<br />
<br />
Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.<br />
<br />
sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu <br />
(při přetečení 2^31 počítá opět od nuly, pořád dokola)<br />
<br />
Hodnota v indexu 137 je nejjemnější možný "časovač", dostupný pro program. Délka kroku jednotky odpovídá frekvenci jádra (ta je různá pro jednotlivá SDS, pro řadu ST typicky 120MHz, tedy 1 krok je 8.3nsec). <br />
Tento index vyžaduje aktuální FW (11/2022 nebo novější).<br />
<br />
<br />
== Rozhraní sériové komunikace ==<br />
<br />
SDS-C poskytuje přístup k sériovému rozhraní COM1 a COM6. Pouze rozhraní COM1 je také současně přístupno přes převodník Eth/UART (VCP). Program v SDS-C může přistupovat jak ke COM1, tak ke COM6.<br />
<br />
Pomocí SDS-C lze zapisovat do sériového rozhraní, a číst data ze sériového rozhraní. Data, přicházející z venku do zařízení SDS, jsou ukládána do příslušného bufferu (RX FIFO), takže lze pomocí SDS-C programu číst i pomaleji, než je rychlost příchozích dat. Buffery jsou malé (zhruba 1kB), proto je potřeba data zpracovávat rychle a včas, ať nedojde k jejich ztrátě.<br />
<br />
Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše. <br />
Poznámka: UART buffery (pro obě sériové rozhraní) jsou neustále aktivní a příjem dat z UARTu probíhá po celou dobu zapnutí zařízení.<br />
<br />
Rozhraní COM1:<br />
<br />
sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1<br />
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici), <br />
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není ! <br />
(Toto může způsobit nezkušenému programátorovi potíže). <br />
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné, <br />
a s tou pak dále dle libosti pracovat.<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!<br />
<br />
sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?<br />
== 0 : není připojen klient<br />
!= 0 : je připojen klient (přes TELNET port)<br />
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)<br />
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)<br />
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Poznámka: parametry sériového rozhraní UART COM1 lze nastavit v rámci převodníku Ethernet/UART (přes RFC příkazy), nebo pomocí k tomu určené SDS-C funkce. Pozor, nastavení '''nelze''' změnit přímým zápisem hodnoty do sys[50] až sys[54] (ty jsou pouze pro čtení).<br />
<br />
Rozhraní COM6:<br />
<br />
sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:<br />
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)<br />
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)<br />
<br />
sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6<br />
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)<br />
Možné hodnoty: <br />
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)<br />
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)<br />
<br />
sys[57] 02 i R rychlost [bps] rozhraní UART - COM6 <br />
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)<br />
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)<br />
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)<br />
<br />
Rozhraní UART - COM6 je k dispozici jen na SDS-MINI, SDS-MICRO-ST a SDS-MACRO-ST, a je přístupné jen z SDS-C programu.<br />
<br />
Doplňující statistiky (počty rx/tx bajtů atd.) jsou k dispozici na indexu 2800+, viz dále na této stránce (dostupnost těchto údajů je závislá na instalovaném aktuálním FW ve vašem SDS).<br />
<br />
<br />
== Generátor náhodných čísel ==<br />
<br />
sys[61] 06 i R generátor náhodných čísel<br />
- při každém přečtení sys[61] je poskytnuto náhodné číslo<br />
<br />
<br />
== Výsledek převodu textu na číslo ==<br />
<br />
Pro převod textu (z určené pozice pole ''text'' či ''share'') na číslo se používá funkce SDS-C: ''atoi''. Aby bylo možné výsledek převodu získat, musíte si jej přečíst ze ''sys[62]''.<br />
<br />
sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''<br />
<br />
Pro více informací se podívejte přímo na návod k této funkci.<br />
<br />
<br />
== Nastavení rychlosti provádění SDS-C programu ==<br />
<br />
SDS-C program může ovlivnit rychlost svého vykonávání. Buď se každá instrukce provede právě s minimálním krokem co 1 msec, nebo se dá tato (často žádoucí) vlastnost snadno vypnout. Pozor, hodnota 1 msec není vždy garantována, např. při zavolání funkce která pracuje s pomalou periférií dojde k čekání, dokud se požadovaná funkce nedokončí.<br />
<br />
sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:<br />
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''<br />
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku) <br />
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )<br />
<br />
Poznámka: všechny SDS-C programy jsou ve výchozím stavu spouštěny se sys[63] = '''0''' (tzn. jeden celý příkaz programu je vykonán právě co 1 msec).<br />
<br />
Tohoto faktu (krok 1 msec) některé programy využívají k realizaci čekacích smyček, když se předpokládá jeden vykonaný příkaz za 1 msec. Není to však vhodné, protože SDS nedává garanci že se vždy bude jednat přesně o 1 msec (může docházet k náhodnému zdržení až o několik msec, v záležitosti na ostatní činnost systému). Pokud však vypnete toto rychlostní omezení, tak takové případné čekací smyčky přestanou plnit svou funkci (prakticky skončí mnohem dříve): proto ve svých programech používejte pouze k realizaci "čekání" pouze k tomu určené funkce, nebo případně sys[64] nebo některý z UpTime indexů či sys[137] atd.<br />
<br />
<br />
== Časování ==<br />
<br />
Pro přesnější časování programu, popř. pro spuštění nějaké události po přesně daném intervalu, lze s výhodou využít následující proměnnou:<br />
<br />
sys[64] 01 i RW sekundový odpočítávač <br />
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1, <br />
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)<br />
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)<br />
<br />
Samozřejmě lze využít i jiné způsoby, ale tento je k tomu explicitně určen, vyhovuje-li hrubý krok 1 sekunda. Pro jemnější časování jsou pak vhodnější indexy s UpTime hodnotou, nebo sys[137] pro nejvíce jemné čekání - tyto indexy ale nemají funkci odpočítávání (jsou jen pro čtení), takže hlídání obsahu si už musíte řešit sami ve svém programu.<br />
<br />
<br />
== OSI7 funkce ==<br />
<br />
OSI7 funkce jsou určeny pro komunikaci mezi SDS a vnějším světem připojeným přes Ethernet (např. se servery v Internetu).<br />
<br />
Všechny funkce OSI7 poskytují průběžný stav své činnosti:<br />
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)<br />
- význam hodnot viz [[OSI7_status_code|popis zde]]<br />
<br />
Poznámka: vždy je doporučeno, po zavolání kterékoliv OSI7 funkce, provést v programu čekání na skončení této funkce. Čekání má kontrolovat právě hodnotu v sys[65], a dokud se tato proměnná nenaplní výsledkem, nevolejte další OSI7 funkci.<br />
<br />
DNS resolv: sestavením IP[0].IP[1].IP[2].IP[3] získáte IP adresu (napr. 10.0.0.8) z DNS po úspěšném návratu z funkce DNS resolveru. Tato získaná IP adresa pak může sloužit pro různé účely, např. pro kontrolu DNS serveru jestli žije atd.<br />
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''<br />
<br />
Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).<br />
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)<br />
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru<br />
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru<br />
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru<br />
<br />
sys[74] 01 s R text, reserved (v této verzi nepoužito)<br />
<br />
Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):<br />
<br />
sys[303] 09 i R DNS RESOLV - (read:) actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
sys[303] 09 i W DNS RESOLV - write anything to clear the DNS cache<br />
sys[304] 09 i R DNS RESOLV - (read:) timestamp (UTC) of the latest DNS server response (packet) as requested by dns_resolv() function (if 0 then no response received, or cache has expired)<br />
sys[305] 09 i R DNS RESOLV - (read:) get the last set hard TTL limit (0 = invalid (will use 1209600 as default), otherwise 1..MAX = time in seconds)<br />
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)<br />
<br />
<br />
HTTP GET:<br />
<br />
sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)<br />
- nastaveno po dokončení práce funkce '''http_get()'''<br />
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.<br />
<br />
sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')<br />
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',<br />
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.<br />
<br />
sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek<br />
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu. <br />
Nastavte na:<br />
<br />
== 0 : jakékoliv přijaté data jsou '''zahozena''', <br />
neuloží se (nedojde ke změně obsahu ram[] nebo text[])<br />
<br />
== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole ram[] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]<br />
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).<br />
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)<br />
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[], <br />
bude zápis přerušen a přijatý 0x00 nebude uložen)<br />
<br />
Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !<br />
<br />
sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi<br />
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])<br />
- maximální hodnota je omezena velikostí pole ram[] nebo text[]<br />
- pozor! pokud zapíšete '''0''', budou všechna data zahozena, <br />
ale i v takovém případě dojde k přepisu ram[0] (viz výše)<br />
<br />
sys[79] až sys[80] RESERVED vyhrazeno<br />
<br />
Pozor, v případě nenulového sys[77] HTTP klient čeká tak dlouho, dokud nedostane všech sys[78] bajtů odpovědi z protistrany. To je častou příčinou "problémů" kdy protistrana neodpoví dostatečně dlouhou odpovědí, a klient má stále otevřené spojení a stále čeká a čeká... až dojde na timeout. Což je pak potřeba důsledně a správně ošetřit ve vašem SDS-C programu.<br />
<br />
Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):<br />
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')<br />
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru<br />
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru<br />
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru<br />
<br />
sys[85] až sys[88] RESERVED vyhrazeno<br />
<br />
Informace z ('''interní''') ICMP PING funkcionality "IP Watchdog" (konfigurace a ovládání přes webové rozhraní SDS) (nemá souvislost s SDS-C funkcí "ping()" ) :<br />
<br />
sys[89] 06 i R IP-Watchdog: stav<br />
== 0 : není v provozu (neaktivováno ve webovém rozhraní)<br />
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)<br />
<br />
sys[90] 06 i R IP-Watchdog: poslední známé RTT<br />
== 0 .. 65533 : hodnota RTT v msec<br />
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)<br />
<br />
sys[91] 06 i R IP-Watchdog: stav výstupu<br />
== 0 : výstup není aktivován<br />
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)<br />
<br />
Informace z (SDC-C) ICMP PING funkce - '''ping()''' :<br />
<br />
sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92] <br />
== 0 : klid (není odeslán paket, nečekám na odpověď), <br />
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle<br />
== 1 : funkce '''ping()''' byla právě zavolána, <br />
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání<br />
== 2 : čeká se na odpověď od ARP <br />
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket, <br />
protože v ARP tabulce nebyl příslušný záznam)<br />
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY <br />
(požadovaný stav, funkce '''ping()''' funguje ok)<br />
== 8 : právě obdržel ECHO REPLY <br />
(byla přijata odpověď od vzdáleného zařízení)<br />
<br />
sys[93] 04 i R PING SEQ number <br />
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE <br />
na ICMP PING REQUEST odeslaný funkcí '''ping()'''<br />
<br />
sys[94] 04 i R Round Trip Time, v milisekundách<br />
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''<br />
- čas je zvyšován po pěti milisekundách (údaj v sys[94] je přímo v msec, např. hodnota 55 znamená 55 msec)<br />
<br />
Pozn.: ICMP Quench (32bit) je sestaven z "identifier" (16bit) a z "sequence number". Pomocí sys[93] můžete nastavit '''číslo sekvence''' na libovolnou hodnotu, přičemž hodnota "identifier" je napevno nastavena na "'''0x0280'''" .<br />
<br />
<br />
Funkce '''send_udp()''':<br />
<br />
sys[95] 06 i R výsledek posledního volání '''send_udp()'''<br />
Hodnoty:<br />
== 0 : nic neprovedeno<br />
Hodnota '''0''' je nastavena po startu SDS-C programu<br />
== 1 : právě bylo zahájeno odesílání paketu (provádí se)<br />
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.<br />
== 2 : byl odeslán UDP paket, úspěšně<br />
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu<br />
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz <br />
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP <br />
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz<br />
== 4 : zavolali jste funkci '''send_udp()''' dříve, <br />
než byla dokočena činnost předchozího požadavku <br />
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)<br />
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)<br />
<br />
<br />
Funkce '''snmp_send_trap()''':<br />
<br />
sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''<br />
Hodnoty:<br />
== 0 : odesílání neprobíhá<br />
== 1 : probíhá odesílání, výsledek ještě není znám<br />
== 2 : odeslání se povedlo <br />
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)<br />
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)<br />
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)<br />
<br />
sys[97] RESERVED vyhrazeno<br />
<br />
<br />
== Zápis textu do pole, Porovnání textů ==<br />
<br />
Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.<br />
<br />
sys[98] i R společné využití viz (1) a (2)<br />
<br />
06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,<br />
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'', <br />
což je hodnota užitečná pro navázání textu (zápis více textů přesně za sebou), popř. určení délky posledního zápisu:<br />
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''<br />
- kam byla zapsána terminační 0x00 funkcí '''itoh()''' <br />
- kam byla zapsána terminační 0x00 funkcí '''itoa()''' <br />
<br />
08 i R (2) výsledek porovnání textů<br />
- hodnota výsledku zavolání funkce '''textcmp()'''<br />
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci<br />
X == 0 : oba texty jsou identické<br />
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''<br />
<br />
Význam "nižší vlastní hodnoty": znak 'a' má nižší hodnotu než 'b', a to o 1; nebo např. '1' má nižší hodnotu než '4' a to o 3.<br />
<br />
Doporučeno je si to vše vyzkoušet (zavolat si každou uvedenout funkci a srovnat hodnotu v sys[98] s obsahem pole ''text[]'').<br />
<br />
<br />
== Uživatelské pozice v pevné paměti == <br />
<br />
sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]<br />
<br />
sys[100] až sys[115] <br />
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,<br />
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),<br />
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF <br />
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !<br />
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti <br />
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti <br />
<br />
Paměť EEPROM a paměť DATAFLASH (podle verze HW který máte) je permanentní (NVM), tzn. její obsah zůstane i po vypnutí zařízení nezměněn (na rozdíl od <u>ne</u>zálohované paměti RAM, do které se přistupuje pomocí pole ''ram[]'').<br />
<br />
''' Reserved '''<br />
<br />
sys[116] až sys[136] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné nastavitelné uživatelem z webového rozhraní ==<br />
<br />
Pomocí "uživatelských proměnných" (někdy taky "sdílených proměnných") lze snadno ovlivnit chod vašeho SDS-C programu, ale jen tak, jak si do něj sami naprogramujete - uživatelské proměnné neovlivňují samotný program, ale program je může číst a následně zpracovat.<br />
<br />
sys[140] až sys[149] <br />
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)<br />
(vždy 32-bit signed integer)<br />
<br />
sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu<br />
Nastavení:<br />
== 0 : stránka "control" je přístupná bez hesla, <br />
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)<br />
<br />
Uživatel, který má přístup k webové stránce, může zapsat nový obsah do těchto osmi proměnných (změnit jejich hodnotu), kdykoliv chce. Dvě doplňkové proměnné nejsou na výchozí webové stránce dostupné, ale jinak s nimi lze bez jiných omezení pracovat (SDS-C, M2M).<br />
<br />
Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.<br />
<br />
Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).<br />
<br />
Samozřejmě lze využít i přímého URL pro zápis do proměnných, což je výhodné např. při vzájemné komunikaci dvou zařízení.<br />
<br />
<br />
== Proměnné vstupů a výstupů pro všechny výrobky SDS ==<br />
<br />
'''POZOR'''<br />
<br />
'''Podle HW verze výrobku, jsou dostupné jen určité vstupy a výstupy.''' Zde je uveden plný seznam pro maximální konfiguraci, ale ne všechny HW verze mají všechno. Např. SDS-MICRO-LM má pouze dva reléové výstupy, kdežto SDS-MACRO-LM má čtyři.<br />
<br />
Vždy máme vyhrazeno 32 indexů pro vstupy a výstupy. Tyto indexy jsou tedy naplánovány pro (budoucí) maximální konfiguraci, ale většina SDS k nim nemá odpovídající HW (např. nemá všech 32 relé). Zápis a čtení do/z indexů, které nemají odpovídající fyzický protějšek, je zakázán (bude SDS ignorován, a hodnota nebude uložena pro pozdější čtení).<br />
<br />
'''Pokračování výpisu:'''<br />
<br />
sys[151] až sys[182] <br />
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)<br />
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)<br />
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu<br />
Hodnoty:<br />
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)<br />
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)<br />
<br />
Pozor, pokud u vašeho SDS (např. historické kousky SDS-MICRO-LIGHT) má číslované OPTO vstupy od nuly (né od jedničky), musíte si aktualizovate firmware v tomto zařízení, a případně upravit potisk (popis) na desce nebo krabičce.<br />
<br />
'''Důležité info:'''<br />
<br />
Pokud je (uvnitŘ SDS) na LED vstupního optočlenu signál, hodnota '''sys[]''' pro dané OPTOx dává '''0''' (nulu), naopak při nepřítomnosti signálu je přítomna '''nenulová''' hodnota (vždy testujte na nulovou a nenulovou hodnotu, jediné co je zaručeno je totiž ta nula, kdežto nenulová hodnotu může být jakákoliv - ve skutečnosti každý opto vstup má přidělenou konstantu, podle které lze tento vstup identifikovat). <br />
<br />
Pozor - "logika" optických vstupů je tedy na první pohled "obrácená" (avšak dává to přesný smysl). Jen je to potřeba vědět při psaní SDS-C programu.<br />
<br />
<br />
== Stav SDS-C programu ==<br />
<br />
Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).<br />
<br />
sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu<br />
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)<br />
<br />
Příklad: FW v SDS je (pro příklad) ze dne 24.12.2018, takže v ''sys[183]'' bude zakódováno jako 0x00180C12, tedy hodnoty 24dec 12dec 18dec zapsány jako 0x18 0x0C 0x12, což je 0x18C0C12 což je 1575954dec.<br />
<br />
Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:<br />
<br />
sys[184] 08 i RW způsob spuštění SDS-C programu<br />
== 0 : bez informace<br />
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS<br />
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)<br />
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace<br />
<br />
Stav SDS-C watchdogu:<br />
<br />
sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec<br />
== -1 : wdg není aktivní<br />
== 0 : odpočet vypršel, dojde k resetu SDS-C programu<br />
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)<br />
<br />
<br />
== Pulse-Width Modulation výstupy ==<br />
<br />
Některá SDS mají pouze jeden PWM výstup (PWM1), některá mají čtyři výstupy (rozdělené po dvou do dvou skupin: PWM1 a PWM2, pak PWM3 a PWM4).<br />
<br />
''Příklad pro PWM1:'' Konfigurace PWM1 výstupu nejprve vyžaduje zápis do sys[191], aby se nejprve nastavila provozní základní frekvence generátoru.<br />
Následně lze PWM1 výstup řídit zápisem do sys[192], kdy se podle zapsané hodnoty nastaví střída PWM výstupu (poměr log0 a log1).<br />
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.<br />
Zápis do sys[191] je potřeba jen jednou (tedy jen tehdy, když je potřeba PWM1 výstup zapnout nebo vypnout, a kdy je potřeba změnit frekvenci generátoru). <br />
Zápisy do sys[192] a nebo sys[193] se pak mohou dít samostatně (tj. není potřeba pokaždé opakovat zápis do sys[191]).<br />
<br />
Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !<br />
<br />
Pozor, pro tyto typy SDS:<br />
<br />
SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO''' <br />
<br />
Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).<br />
<br />
<br />
Podle typu SDS:<br />
<br />
SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)<br />
<br />
sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).<br />
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)<br />
<br />
sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)<br />
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)<br />
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).<br />
<br />
sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru <br />
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]<br />
- tato hodnota není aktualizována vůči sys[192], ani není archivována<br />
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.<br />
<br />
Hodnoty Fm větší než 1MHz prakticky nemají smysl, snažte se navrhnout svůj systém tak, aby dokázal pracovat ideálně nejvýše ve stovkách kHz.<br />
<br />
<br />
Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.<br />
<br />
SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)<br />
<br />
sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[192] až sys[195])<br />
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)<br />
<br />
sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)<br />
<br />
sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)<br />
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])<br />
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)<br />
<br />
sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]<br />
- zápis hodnot: 1 až 1000000 (odpovídá 1Hz až 1MHz) aktivuje PWM výstupy (lze dále řídit podle sys[187] až sys[190])<br />
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu<br />
<br />
sys[187] 09 i RW duty-cycle '''PWM3''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)<br />
<br />
sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
sys[189] 09 i RW duty-cycle '''PWM4''' v procentech<br />
- povolené rozmezí 0 až 100 (0% až 100%)<br />
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)<br />
<br />
sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách<br />
- pouze pro zápis, pozor !<br />
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)<br />
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])<br />
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)<br />
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru<br />
<br />
Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.<br />
<br />
<br />
== Ovládání výstupů - Relé ==<br />
<br />
Zápisem do následujících systémových proměnných přímo ovládáte fyzické relé (výstupy) zařízení SDS. Pozor, protože hodnoty zapsané z SDS-C programu se záměrně neukládají do pevné paměti (tzn. nejsou načteny po resetu zařízení SDS). Je to z důvodu bezpečnosti (aby se např. neseplo relé po dlouhém výpadku napájení). Váš program si s tím musí umět poradit - vždy po zapnutí SDS musí vyhodnotit aktuální situaci a až podle toho zapínat relé.<br />
<br />
sys[196] až sys[228] <br />
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''<br />
- lze nastavit i z webového rozhraní<br />
Hodnoty:<br />
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)<br />
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)<br />
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)<br />
<br />
sys[229] až sys[230] RESERVED vyhrazeno<br />
<br />
sys[231] až sys[262] <br />
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)<br />
Hodnoty:<br />
== 0 : relé není aktivní <br />
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)<br />
!= 0 : relé je aktivní <br />
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)<br />
<br />
sys[263] až sys[265] RESERVED vyhrazeno<br />
<br />
sys[266] až sys[298] <br />
01 s R uživatelský textový název pro '''RE1''' až '''RE32''' <br />
- nastaveno ve webovém rozhraní<br />
<br />
sys[264] až sys[300] RESERVED vyhrazeno<br />
<br />
<br />
== Ovládání PDx ==<br />
<br />
Jednotlivé moduly SDS mají k dispozici dodatečné vstupy a výstupy, označené jako PDx respektive TOPB. Přesný seznam viz návod ke konkrétním modulům.<br />
<br />
Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):<br />
<br />
sys[301] 01 i RW SDS '''MICRO LM LIGHT''': stav i/o pinu D0 (0 = log0 ; nenulová hodnota v sys = log1 přítomna na pinu)<br />
SDS '''MICRO LM DIN''' a SDS '''MACRO LM''': stav výstupu D0 - MOSFET spínač na GND. Při jakékoliv nenulové hodnotě v sys[301] je MOSFET sepnutý (=D0 na GND), jinak je D0 otevřený (HiZ)<br />
SDS '''TTCPRO''': stav všech osmi pinů v portu PDx (nastavením/čtením sys[301] se přistupuje k jednotlivých osmi bitům v bajtu, kde: bit0=PD0 až bit7=PD7)<br />
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = stav PD0 MOSFET spínače (spíná na GND), bit1 = stav i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''IO6-ST''': nepoužito<br />
SDS '''MACRO-ST''': bit0 = stav PD0, bit1 = stav PD1, bit2 = stav i/o pinu TOPB, bit3 = TL-1, bit4 = stav TL-2, ostatní bity (5..7) nepoužity<br />
<br />
Řízení směru pro jednotlivé PDx resp. TOPB:<br />
<br />
sys[302] 06 i RW SDS '''MICRO LM LIGHT''': směr i/o pinu D0 (zápisem bit0 do 1 se nastaví pin D0 jako výstup) (zápisem log1 se nastaví jako vstup)<br />
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)<br />
SDS '''TTCPRO''': směr jednotlivých pinů v portu PDx (nastavením jednotlivých osmi bitů, bit0=PD0 až bit7=PD7, nastav log1 pro výstup)<br />
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity<br />
SDS '''UPS''': nepoužito<br />
SDS '''IO6''': nepoužito<br />
SDS '''MICRO-ST''': bit0 = vždy v log1 (PD0 jako výstup), bit1 = směr i/o pinu TOPB, ostatní bity (2..7) nepoužity<br />
SDS '''MACRO-ST''': bit0 = vždy v log1 (výstup), bit1 = vždy v log1 (výstup), bit2 = směr i/o pinu TOPB, bit3 = vždy v log0 (vstup), bit4 = vždy v log0 (vstup), ostatní bity (5..7) nepoužity<br />
<br />
TOPB: vždy typicky CMOS 3V3 pin, s možností funkce jako vstup nebo výstup (dle sys[302]), a je přímo připojený na pin SoC, pozor tedy na jeho další HW připojení.<br />
<br />
TTCPRO: Mapování je vždy od nejnižšího (LSB - bit0) bitu (PD0 = bit0, PD1 = bit1, atd. PD7 = bit7). Pro TTCPRO jsou PDx jako CMOS 3V3 piny s volbou vstupu nebo výstupu pro každý jednotlivý pin.<br />
<br />
MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).<br />
<br />
Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).<br />
<br />
sys[306] až sys[309] RESERVED vyhrazeno<br />
<br />
== Tlačítka na desce display pro SDS-MACRO-ST ==<br />
<br />
Čtení stavu tlačítek na desce display (SDS-MST-DISP-rev1) se provádí čtením sys[301] a vyhodnocením bitu 3 (=8dec, první tlačítko) a/nebo bitu 4 (=16dec, druhé tlačítko).<br />
<br />
Ošetření na případné zákmity při stisku a uvolnění tlačítek, je potřeba provést ve vašem SDS-C programu.<br />
<br />
<br />
== Vstupy - teploměry na externí sběrnici 1-Wire&reg; ==<br />
<br />
Čidla teploty (1-W chipy pro měření teploty připojené na sběrnici; tak také údaj o teplotě z připojených modulů SDS-1W-T-RH) jsou řízena (čtena) plně automaticky zařízením SDS. Program v SDS-C má přímo přístup k výsledným hodnotám teplot.<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici<br />
<br />
Teploměry mají hodnotu uloženou v násobku '''100''' (takže např. 24.5°C je uloženo jako číslo 2450, nebo -120.65°C je -12065). Pokud není k dispozici hodnota z čidla, '''není v záznamu číslo nula (pozor !), ale záměrně tam je číslo 16777216 (2^24)'''.<br />
<br />
Pozn.: pouze SDS-MACRO-LM a SDS-MACRO-ST mají teploměry č. 17 až 32, protože má dvě samostatné sběrnice (konektory). Sběrnice A má teploměry 1 až 16, sběrnice B má teploměry 17 až 32. '''Sběrnice B je k dispozici jen pro SDS-MACRO-XX'''.<br />
<br />
sys[342] až [345] RESERVED vyhrazeno<br />
<br />
sys[346] 01 i R číslo čidla, které je právě převáděno na sběrnici '''B''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''<br />
<br />
sys[348] 01 i R číslo čidla, které je právě převáděno na sběrnici '''A''' (čteno přes 1-W, tj. je mu aktualizována hodnota)<br />
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''<br />
<br />
sys[350] až sys[381] <br />
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]<br />
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)<br />
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek<br />
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)<br />
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)<br />
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)<br />
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)<br />
<br />
sys[382] až [389] RESERVED vyhrazeno<br />
<br />
sys[391] až sys[422] <br />
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)<br />
<br />
''' Reserved ''' <br />
<br />
sys[423] až sys[430] RESERVED vyhrazeno<br />
<br />
<br />
== Vstupy: analogové vstupy pro měření napětí ==<br />
<br />
Všechny vstupy měří napětí vůči společné svorce (GND). Změřená hodnota je vždy k dispozici nejprve jako surová (raw) digitální hodnota, a poté ji SDS přepočítá dle uživatelského nastavení a také dá k dispozici.<br />
<br />
sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1<br />
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2<br />
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3<br />
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4<br />
<br />
RAW (surová) hodnota je digitální číslo, poskytnuté z interního A/D převodníku, s tím, že mu už SDS současně (pouze a jenom) odečetl uživatelem nastavený offset.<br />
<br />
Rozsah hodnoty RAW je: <br />
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)<br />
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)<br />
<br />
Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):<br />
<br />
sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[436] 01 i R Div pro A/D 1<br />
sys[437] 01 s R textový název A/D 1<br />
sys[438] 01 s R jednotka A/D 1<br />
<br />
sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[440] 01 i R Div pro A/D 2<br />
sys[441] 01 s R textový název A/D 2<br />
sys[442] 01 s R jednotka A/D 2<br />
<br />
sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[444] 01 i R Div pro A/D 3<br />
sys[445] 01 s R textový název A/D 3<br />
sys[446] 01 s R jednotka A/D 3<br />
<br />
sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]<br />
sys[448] 01 i R Div pro A/D 4<br />
sys[449] 01 s R textový název A/D 4<br />
sys[450] 01 s R jednotka A/D 4<br />
<br />
'''Pozor!''' Hodnoty pro jednotlivé A/D vstupy (tj. Raw Hodnoty v sys[431 až 434]) '''už mají odečtený Offset''' (je to provedeno uvnitř firmware už při zpracovávání A/D převodu) ! <br />
Proto Offset už ve svém SDS-C programu z Raw hodnot neodečítejte (bylo by to odečítáno podruhé). Pro přepočet z Raw na finální hodnotu vám zbývá (správně) použít jen "Div".<br />
<br />
Poznámka: zařízení SDS-MINI (a další z řady SDS ST) už mohou mít text v položce "jednotka A/D x" delší než jeden znak (na rozdíl od původního SDS-MICRO-LM atd., kde to bylo omezeno na jeden jediný znak).<br />
<br />
''' Reserved '''<br />
<br />
sys[451] až sys[458] RESERVED vyhrazeno<br />
<br />
<br />
== Proměnné pro S0 impulsní vstup ==<br />
<br />
sys[459] 01 i RW stav tarifu <br />
== 0 : T0 (vysoký tarif)<br />
== 1 : T1 (nízký tarif)<br />
<br />
sys[460] až sys[492] <br />
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],<br />
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )<br />
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60<br />
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh<br />
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty, <br />
pak sem v takovém případě nastavte číslo 1<br />
- platné hodnoty: 1 až 65280 (včetně)<br />
<br />
sys[493] až sys[525] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[526] až sys[558] <br />
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).<br />
<br />
sys[559] až sys[591] <br />
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)<br />
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD<br />
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající<br />
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).<br />
<br />
sys[592] až sys[624] <br />
01 i R změřená časová vzdálenost mezi dvěmi nejposlednějšími zachycenými impulsy na S0 vstupu (aktuální impuls a předchozí impuls)<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
sys[625] až sys[657] <br />
01 i R změřený čas od úplně posledního impulsu zachyceného na S0 vstupu, tzn. "doba bez impulsu" nebo také "doba od posledního impulsu"<br />
- měřeno v msec<br />
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)<br />
ale SDS-C čte sys[] jako 32-bit signed hodnoty;<br />
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).<br />
<br />
poznámka: tarif T0 a tarif T1 závisí na uživatelem zvoleném externím signálu (přeneseno do sys[459]), viz informace na stránce ohledně [[S0]]. Celková hodnota impulsů je samozřejmě součtem těchto dvou impulsních akumulátorů. Pokud není tarifní rozlišení využito, je vše zapisováno do akumulátoru pro T0. <br />
<br />
poznámka: časová vzdálenost mezi impulsy se používá pro výpočet aktuálního výkonu (popř. průtoku atd. dle použitého měřiče) - můžete toho využít ve svém SDS-C programu.<br />
<br />
poznámka: "Poměr MTD" zahrnuje všechny měřící transformátory (MTD), předřazené elektroměru (pouze pokud to už není započítáno v impulsní konstantě). Pokud je S0 vstup využit pro jiný typ měřiče (vodoměr a podobné), kde je připojení MTD nesmysl, tak se v konfiguraci musí do této položky nastavit hodnota 1. Samozřejmě jde s určitou výhodou použít i jinou konfiguraci, protože tato hodnota je použita jako "druhý dělitel" u výpočtu počtu S0 impulsů na velikost kroku energetické jednotky. Určení této hodnoty pro jiné měřiče sleduje stejné matematické postupy jako určení této hodnoty pro elektroměr s předřazeným MTD, jen jednotky budou samozřejmě jiné.<br />
<br />
sys[658] až sys[670] reserved for future use<br />
<br />
poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).<br />
<br />
<br />
== Speciální vstupy a výstupy ==<br />
<br />
Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.<br />
<br />
'''Pouze pro SDS MICRO (LM) LIGHT:'''<br />
<br />
sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)<br />
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)<br />
<br />
Tyto zmíněné čtyři ''sys[]'' jsou dostupné '''pouze''' na modulu SDS MICRO '''LIGHT''' popř. '''DIN''', a to jen s verzí firmware 9.1.2011 nebo novější.<br />
<br />
SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.<br />
<br />
SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).<br />
<br />
SDS MACRO LM, SDS MICRO ST, SDS MACRO ST, SDS UPS, SDS IO6, SDS IO6 ST, SDS TTCPRO, SDS MINI: tyto výstupy '''nejsou k dispozici'''.<br />
<br />
Vše to jsou logické výstupy, s CMOS 3V3 logickými úrovněmi (pro obecné použití je externí pull-up 47kOhm nutný). Lze to použít především pro ovládání BSS138 MOSFETů, např. pro spínání dalších relé (v případě použití BSS138 nedávejte externí pull-up, ale naopak dejte pull-down na GND o hodnotě 47kOhm).<br />
<br />
'''Pouze pro SDS MACRO ST:'''<br />
<br />
Alternativa k sys[301]. Hodnota odpovídá logické úrovni na daném vstupu TL1 (TL2). Při osazené desce MACRO-ST-LCD jsou na tyto vstupy připojeny tlačítka (pak při stisku TL1, TL2 je zde hodnota 0, v klidu 1).<br />
<br />
sys[671] 02 i R čtení stavu TL1<br />
sys[672] 02 i R čtení stavu TL2<br />
<br />
'''Pájecí plošky CFG:'''<br />
<br />
Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.<br />
<br />
V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.<br />
Ploška CFG1 je vyhrazena pro vnitřní použítí samotného firmware SDS, a ploška CFG2 bude eventuálně uvolněna pro libovolné použití uživatelem (čtení z SDS-C).<br />
Takový firmware se teprve chystá (SDS TTCPRO).<br />
<br />
sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)<br />
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)<br />
<br />
<br />
== Speciální proměnné pro SDS-UPS ==<br />
<br />
SDS UPS nabízí, kromě již zmíněných proměnných (viz výpis výše), i doplňkové proměnné, specifické pro tento výrobek. Tyto rozšířené systémové proměnné jsou k dispozici ve firmware od 25.4.2011 .<br />
<br />
SDS-UPS má všechny sys[0] až sys[699] shodné s SDS-MICRO. Rozdíl je samozřejmě v počtu a osazení periférií.<br />
<br />
Pokud nejste spokojeni s originálním nabíjecím algoritmem, máte možnost si ho celý naprogramovat sami v SDS-C: všechny potřebné vstupní a výstupní údaje (proměnné) jsou vám k dispozici. Popřípadě, pokud chcete jen sledovat situaci, můžete je také využít (např. pro logování nabíjecího a vybíjecího proudu akumulátoru a tak dále).<br />
<br />
sys[700] 02 i R reserved<br />
sys[701] 02 i R reserved<br />
sys[702] 02 i R reserved<br />
sys[703] 02 i R reserved<br />
<br />
'''Přepínač algoritmů:'''<br />
<br />
sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:<br />
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)<br />
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)<br />
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C<br />
<br />
Pokud zvolíte vlastní (ruční) řízení, musíte trvale řídit nabíjení sami pomocí programu v SDS-C. Vlastní ovládání vejde v platnost zápisem čísla 345 nebo 824 do sys[704]. Tento zápis provedete pouze jednou na začátku programu, a dále pak musí trvale následovat váš algoritmus. <br />
<br />
Pokud zvolíte 345, jediné co má váš program za úkol, je řídit samotný nabíjecí proces - toto je výhodné, když se nechcete zatěžovat hlídáním provozních stavů (tj. výpadek napájení atd.), což za vás v tomto režimu udělá původní firmware.<br />
<br />
Pokud zvolíte 824, musíte sami kompletně řídit všechno chování UPS, tj. nejenom nabíjecí algoritmus, ale i detekce výpadku napájení, přepínání mezi stavy, indikační LED, a tak dále.<br />
<br />
sys[705] až sys[731] reserved<br />
<br />
Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.<br />
<br />
Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.<br />
<br />
'''Vstupy a konfigurace:'''<br />
<br />
sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A<br />
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru<br />
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu<br />
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru<br />
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu<br />
<br />
Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě. <br />
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu. <br />
Měření proudu je specifické, protože měření ukazuje kladný i záporný proud, takže 0A je na hodnotě sys[732] (typicky 2047), všechno co je pod touto hodnotu je záporný proud, všechno nad je kladný proud. Znaménko proudu ukazuje, kam proud teče (např. záporný = vybíjení akumulátoru, atd.).<br />
<br />
sys[737] až sys[739] reserved<br />
<br />
Následuje konfigurace provedená uživatelem ve webovém rozhraní.<br />
Hodnoty jsou přímo v rozmezí 0 až 4095, takže je lze PŘÍMO použít se surovými hodnotami z A/D převodu (tzn. zařízení se už postaralo o převod údajů zadaných uživatelem ve webovém rozhraní na tento formát). V důsledku je pak realizace algoritmu velmi snadná.<br />
<br />
sys[740] 02 i R primary voltage to say target is ok (pri_pvts)<br />
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)<br />
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)<br />
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)<br />
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)<br />
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)<br />
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)<br />
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)<br />
sys[748] 02 i R flag: do not switch accu off (aku_dach)<br />
<br />
Hodnoty sys[740] až sys[748] jsou konfigurační údaje (uživatel je změnil přes webové rozhraní, a tím se uložili do pevné paměti, takže vydrží reset nebo vypnutí zařízení). Pokud do nich v SDS-C programu zapíšete, tato nová zapsaná hodnota zůstane platná až do resetu nebo vypnutí, nebo do ručního přepsání uživatelem (ve webovém rozhraní). Zápis do těchto konkrétních sys[] nezpůsobí uložení nových hodnot do pevné paměti.<br />
<br />
sys[749] až sys[760] reserved<br />
<br />
'''Výstupy:'''<br />
<br />
Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !<br />
<br />
<br />
sys[761] 02 i RW ovládání vypínání nabíječe<br />
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])<br />
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)<br />
<br />
sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe <br />
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)<br />
!= 0 : zásah do zpětné vazby (posun rozsahu)<br />
(vhodné pro skokové zvýšení výstupního napětí nabíječe, <br />
když už nereaguje v původním rozsahu)<br />
<br />
sys[763] 02 i RW ovládání odpojovače baterie <br />
== 0 : spínač vypnutý (baterie odpojena od zátěže)<br />
!= 0 : spínač sepnutý (baterie připojena)<br />
<br />
sys[764] 02 i RW indikační LED - nabíjení akumulátoru<br />
== 0 : LED svítí (informace: akumulátor je nabíjen)<br />
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)<br />
<br />
sys[765] 02 i RW indikační LED - výpadek primárního vstupu<br />
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)<br />
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)<br />
<br />
'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:<br />
<br />
sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)<br />
- minimální hodnota = 1<br />
- maximální hodnota = 2497<br />
<br />
sys[767] až sys[769] RESERVED vyhrazeno<br />
<br />
Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':<br />
<br />
sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx<br />
<br />
sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx<br />
<br />
sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx<br />
<br />
Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):<br />
<br />
UPS_PROVOZ_START 0<br />
UPS_PROVOZ_PRIOK 1<br />
UPS_PROVOZ_PRIOK_CHARGING 2<br />
UPS_PROVOZ_ONLY_BATT 4<br />
UPS_PROVOZ_NO_BATT 8<br />
<br />
UPS_NABREZIM_CC 0<br />
UPS_NABREZIM_CV 2<br />
UPS_NABREZIM_PAUZA 4<br />
UPS_NABREZIM_URCENI_REZIMU 8<br />
<br />
UPS_BATERIE_ODHAD_NEZNAM 0<br />
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1<br />
UPS_BATERIE_ODHAD_OK_NABIJIM 2<br />
UPS_BATERIE_ODHAD_PLNE_NABITO 4<br />
<br />
<br />
== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==<br />
<br />
Připojené moduly [[SDS_1W_T-RH]] jsou připojeny na 1-W sběrnici, a mají v sobě chip, který měří hodnotu ze sensoru vlhkosti (který je současně umístěn na modulu SDS-1W-T-RH) a současně měří i teplotu a napájecí napětí pro sensor vlhkosti. <br />
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.<br />
<br />
K dispozici jsou jak surové hodnoty (změřené v rámci modulu SDS-1W-T-RH), tak i hodnota kompenzované (skutečné) relativní vlhkosti v místě umístění modulu.<br />
<br />
<br />
Změřená teplota je uložena na standardních indexech:<br />
<br />
sys[310] až sys[341] <br />
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 degC<br />
<br />
Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):<br />
<br />
sys[800] až sys[831] <br />
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
sys[832] až sys[863] <br />
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire&reg; sběrnici, hodnota v násobku 0.01 V<br />
<br />
SDS provádí přepočet na údaj RH v procentech (0 až 100):<br />
<br />
sys[864] až sys[895] <br />
08 i R hodnota RH (0 až 100, v procentech RH) kompenzovaná podle rovnice pro čidlo HIH-503x (výpočet z Vad, kompenzace na Vdd a Temp).<br />
<br />
Rezerva (zatím nepoužito):<br />
<br />
sys[896] až sys[899] RESERVED vyhrazeno<br />
<br />
<br />
== Doplňující informace pro 1-Wire zařízení ==<br />
<br />
1-Wire sběrnice u zařízení SDS umožňuje komunikaci s celou řadů 1-W chipů: [[OneWire|seznam je zde]]. Přístup k chipům na 1-W sběrnici se liší na dva typy: chipy (čidla) které si SDS interně zpracuje (např. měření teploty), a všechny ostatní chipy (které SDS jen umí vyhledat a oznámit, ale dále s nimi nekomunikuje).<br />
<br />
<br />
'''1-Wire chipy interně zpracovávané SDS'''<br />
<br />
Tyto chipy jsou plně automaticky obsluhovány prostřednictvím firmware SDS - není potřebná opakovaná intervence uživatele, ten si pouze čte stále aktuální výsledky měření teplot z jednotlivých čidel.<br />
<br />
Poznámka: Pro změřené hodnoty z 1-W čidel teplot, jsou k dispozici tyto indexy: '''sys[310]''' až '''sys[430]''', a '''sys[900]''' až '''sys[931]'''.<br />
<br />
K dispozici je textové vyjádření (hex znaky) ROM CODE hodnoty načtené pro danou pozici zpracovávaného chipu na 1-W sběrnici.<br />
<br />
Zařízení SDS mohou mít jednu [A] nebo dvě ( nezávislé, [A] a [B] ) 1-Wire sběrnice, a každá sběrnice má maximálně 16 připojených chipů.<br />
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:<br />
<br />
sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále až<br />
<br />
sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):<br />
<br />
sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
A tak dále . . . až<br />
<br />
sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.<br />
<br />
Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.<br />
<br />
Poznámka: ROM CODE pro 1-W chipy jsou k dispozici pouze jako ucelené texty (string). Bajtový rozpad jednotlivých položek není k dispozici.<br />
<br />
sys[931] až sys[939] reserved<br />
<br />
<br />
<br />
'''Ostatní 1-Wire chipy'''<br />
<br />
Pro ostatní 1-W chipy, které SDS "nezná" (tzn. nekomunikuje s nimi, jen je umí na sběrnici vyhledat), jsou jejich ROM CODE odděleny do samostatných '''sys[]''' položek.<br />
<br />
Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci. <br />
Na základě zavolání této funkce dojde k vynulování všech příslušných '''sys[]''' (od indexu 940 resp. 970) pro danou sběrnici, a provede se pokus o přečtení připojeného chipu.<br />
Pokud se to povede, bude nalezený ROM CODE (spolu s časovou značkou okamžiku přečtení) vložen do příslušných '''sys[]''', <br />
nebo bude nastaven chybový kód.<br />
<br />
Pozor, k SDS lze připojit více různých "ostatních" chipů, ale zdejší funkce najde jenom ten první z nich a ostatní už ignoruje. <br />
Ostatní chipy lze samozřejmě připojit na kteroukoliv sběrnici, i když na ní jsou připojeny i chipy se kterými SDS komunikuje (např. teploměrné chipy).<br />
<br />
Jednotlivé chipy se rozlišují pomocí hodnoty ''ID family-code'' (jeden bajt). Pro chip DS1990A je ''0x01'', hodnoty pro jiné chipy viz datasheet výrobce pro konkrétní chip.<br />
<br />
Obecný stav sběrnic:<br />
<br />
sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů<br />
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů<br />
:<br />
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici<br />
<br />
== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice<br />
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)<br />
<br />
== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu<br />
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)<br />
<br />
== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)<br />
<br />
== 8 : byl přečten ROM CODE z připojeného ostatního chipu<br />
(už lze také požádat o další nové čtení 1-W sběrnice)<br />
<br />
== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici <br />
(zkuste provést rescan/čtení znovu)<br />
<br />
sys[942] až sys[949] reserved<br />
<br />
'''Pro sběrnici [A]:'''<br />
<br />
sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[951] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [A] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire<br />
:<br />
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[953] 06 i R romcode[1] (1-W: serial code)<br />
sys[954] 06 i R romcode[2] (1-W: serial code)<br />
sys[955] 06 i R romcode[3] (1-W: serial code)<br />
sys[956] 06 i R romcode[4] (1-W: serial code)<br />
sys[957] 06 i R romcode[5] (1-W: serial code)<br />
sys[958] 06 i R romcode[6] (1-W: serial code)<br />
sys[959] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[960] až sys[969] reserved<br />
<br />
'''Pro sběrnici [B]:'''<br />
<br />
sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire<br />
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).<br />
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),<br />
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''<br />
<br />
sys[971] 06 s R celý text ROM CODE:<br />
- ROM CODE pro chip na [B] sběrnici 1-Wire<br />
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)<br />
<br />
sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire<br />
:<br />
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)<br />
sys[973] 06 i R romcode[1] (1-W: serial code)<br />
sys[974] 06 i R romcode[2] (1-W: serial code)<br />
sys[975] 06 i R romcode[3] (1-W: serial code)<br />
sys[976] 06 i R romcode[4] (1-W: serial code)<br />
sys[977] 06 i R romcode[5] (1-W: serial code)<br />
sys[978] 06 i R romcode[6] (1-W: serial code)<br />
sys[979] 06 i R romcode[7] (1-W: CRC byte)<br />
<br />
sys[980] až sys[989] reserved<br />
<br />
Všimněte si, že SDS v tuto chvíli umožňuje pouze rescan 1-W sběrnice, kdy hledá pouze '''jeden''' připojený "ostatní 1-W chip" (ten první na který narazí, ten ohlásí, a nehledá dále). <br />
<br />
'''Pozor''':<br />
<br />
Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy, <br />
bude při tomto rescanu uveden pouze první nalezený ostatní chip (tj. ten, který má nejnižší ROM-CODE ze všech připojených ostatních chipů).<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[990] až sys[1023] reserved<br />
<br />
<br />
== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==<br />
<br />
'''Přímý přístup do LCD Frame Buffer paměti:'''<br />
<br />
sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)<br />
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst<br />
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)<br />
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye<br />
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)<br />
<br />
Tyto položky jsou dosupné '''pouze a jenom''' na SDS-MACRO-LM kde je vyžadován firmware od 24.11.2016 nebo novější, a na SDS-MACRO-ST (všechny FW verze).<br />
<br />
Jakékoliv změny (zápis) se promítnou pouze do frame bufferu (tedy v paměti SDS) - ale aby se následně tento frame buffer (jeho změněný obsah) eventuálně vykreslil na LCD, je potřeba zavolat příslušnou SDS-C funkci !<br />
<br />
Čtení ze sys poskytuje přímý přístup do frame bufferu (jeho aktuální obsah, tedy opět ne nutně to co je právě vidět na LCD).<br />
<br />
Pokud nepoužíváte LCD (sandwich desku), můžete tuto oblast 528 bajtů využít pro jakékoliv své účely. V podstatě se pak jedná o rozšiřující RAM pamět pro váš SDS-C program.<br />
<br />
'''Pozor''' SDS-MACRO-ST<br />
<br />
SDS MACRO ST provádí automatické aktualizace (zápis) do LCD bufferu, pokud se o tento buffer nepřihlásí SDS-C program. Proto, pokud na MACRO-ST chcete využít LCD buffer pro jiné své účely, musíte to nejprve SDS říct. Znovu, toto platí jen pro MACRO-ST - ''není to potřeba pro MACRO-LM (které tam po zapnutí nahraje logo a pak už na buffer za běhu nesáhne)''. Pro MACRO-ST zavolejte kteroukoliv SDS-C funkci pro přístup na display (např. clear) a je to - tím se přepne vlastnictví LCD bufferu pro SDS-C program.<br />
<br />
== Vyhrazená oblast ==<br />
<br />
'''Zbytek:'''<br />
<br />
sys[1552] až sys[1663] reserved<br />
<br />
<br />
== Bateriově Zálohovaná Paměť ==<br />
<br />
'''POUZE PRO: SDS-TTCPRO a SDS-MINI a SDS-MICRO-ST a SDS-MACRO-sT a SDS-IO6-ST !''' (tedy ty s baterií) - všechny jiné SDS První Řady tyto specifické indexy v sys[] nemají k dispozici!<br />
<br />
Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější. <br />
<br />
sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)<br />
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot<br />
- každý index má k dispozici 32 bitů (tj. celý signed integer)<br />
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)<br />
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")<br />
<br />
Pozor! Oblast záložní paměti je k dispozici pouze na vybraných zařízeních SDS (ty, které mají osazenu baterii pro tyto účely). Údaje se nesmazají změnou programu (nahráním nového programu), ani se nesmazají resetem zařízení (kromě aktivace RSTD - pozor!), tzn. vydrží a zůstanou, a to dokonce i po celou dobu výpadku externího napájení (tak dlouho, dokud se nevybije záložní baterie).<br />
<br />
''(Pouze) pokud baterie v daném SDS není'': tak jsou údaje ztraceny po výpadku napájení (ale po dobu přítomnosti externího napájení jsou k dispozici). Při takové situaci není zaručen obsah těchto dat po zapnutí (měl by být nulový, ale bez záruky).<br />
<br />
<br />
== Další informace ze S0 vstupů ==<br />
<br />
Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.<br />
<br />
Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:<br />
<br />
sys[1792] až sys[1823] <br />
07 i R cena za jednotku v režimu T0<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1824] až sys[1855] <br />
07 i R cena za jednotku v režimu T1<br />
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)<br />
<br />
sys[1856] až sys[1887] <br />
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")<br />
- text<br />
<br />
sys[1888] až sys[1919]<br />
07 s R název měny, podle nastavení (např. text "CZK")<br />
- text<br />
<br />
sys[1920] až sys[1951] <br />
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")<br />
- text<br />
<br />
sys[1952] až sys[1983] <br />
07 s R název činnosti, podle nastavení (např. text "spotřeba")<br />
- text<br />
<br />
sys[1984] až sys[2015] <br />
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")<br />
- text<br />
<br />
sys[2016] až sys[2047] <br />
07 i R konfigurační detaily pro daný S0 vstup<br />
- bit 0 nastaven = je to aktivní S0 vstup<br />
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)<br />
<br />
Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2048] až sys[2198] reserved<br />
<br />
<br />
== MQTT klient ==<br />
<br />
Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:<br />
<br />
sys[2199] 09 i R podpora MQTT<br />
0 = NE<br />
1 = ANO, verze MQTT 3.1.1, SDS první část implementace<br />
2..max = (reserved)<br />
<br />
Každé nové připojení k Brokeru:<br />
<br />
sys[2200] 09 i R stav průběhu mqtt_connect()<br />
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno a odeslán CONNECT požadavek<br />
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )<br />
8 = probíhá odpojování, čekáme na výsledek (na odpojení)<br />
<br />
Po zavolání mqtt_connect(...) je nutné testovat sys[2200] na výslednou hodnotu. Funkci mqtt_connect(...) nelze volat, je-li sys[2200] na hodnotě 1, 2, 8 nebo 16 (nejprve je v takových případech potřeba provést odpojení pomocí mqtt_disconnect() funkce). Pro úplný test, je-li připojení z SDS do Brokeru úplné, je potřeba ověřit i hodnotu v sys[2201]. Teprve pokud oba tyto sys jsou na správné hodnotě, lze s Brokerem komunikovat.<br />
<br />
sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"<br />
-7 = nepoužito<br />
-6 = timeout při čekání na CONNACK, nepřipojeno<br />
-5 = nepoužito<br />
-4 = nepoužito<br />
-3 = nepoužito<br />
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)<br />
-1 = idle, nepřipojeno<br />
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)<br />
1 = MQTT 0x01: Connection Refused, unacceptable protocol version<br />
2 = MQTT 0x02: Connection Refused, identifier rejected<br />
3 = MQTT 0x03: Connection Refused, Server unavailable<br />
4 = MQTT 0x04: Connection Refused, bad user name or password<br />
5 = MQTT 0x05: Connection Refused, not authorized<br />
<br />
Hodnotu v sys[2201] lze číst a zpracovat pouze pokud je sys[2200] na hodnotě 16 (to znamená, pouze pokud SDS obdrží odpověď CONNACK od MQTT brokera).<br />
<br />
Před a po každém volání mqtt_publish() a nebo mqtt_subscribe() funkcí je potřeba sledovat obsah následují položky:<br />
<br />
sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci<br />
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat<br />
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu<br />
-4 = nespravne parametry (počet parametrů)<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity<br />
0 = nepoužito<br />
1 = mqtt_publish() probíhá<br />
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci<br />
4 = mqtt_subscribe() probíhá - čekám na SUBACK<br />
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci<br />
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)<br />
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce<br />
<br />
Informativní položka:<br />
<br />
sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru<br />
(objeví-li se chyba, dojde k okamžitému odpojení)<br />
<br />
Zatím nepoužité pozice:<br />
<br />
sys[2204] až sys[2208] reserved<br />
<br />
Pro každou příchozí datovou zprávu z Brokeru, je tato zpráva uložena do následujících sys: (pozor, každá nová příchozí zpráva přepíše předchozí údaje)<br />
<br />
sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)<br />
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)<br />
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)<br />
<br />
SDS umí přijaté datové zprávy uchovat, v rámci následující tabulky. Toto je důležité zejména pokud různé zprávy přicházejí velice rychle za sebou, aby se pro SDS-C program neztratili.<br />
<br />
Nejvíce lze mít až 32 položek (řádků) v tabulce, nicméně některá SDS nemají ve své paměti dostatečné místo a počet je tedy omezen. Pozor na to při psaní programu !<br />
<br />
sys[2209] 09 i R počet řádků v tabulce pro dané SDS (různé SDS mají různě volnou paměť, proto je v nich i různý počet použitelných Subscribe položek)<br />
<br />
Jednotlivé položky v tabulce příchozích zpráv:<br />
<br />
sys[2211] až sys[2241] <br />
09 s R název položky (Topic Name) pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2242] až sys[2249] reserved<br />
<br />
sys[2251] až sys[2281] <br />
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31<br />
(max délka záznamu dle SDS)<br />
<br />
sys[2282] až sys[2289] reserved<br />
<br />
sys[2291] až sys[2321] <br />
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru<br />
(pro detekci změny - příchozí zprávy z Brokeru)<br />
0 = zatím nic nepřišlo<br />
1..MAX = hodnota uptime v okamžiku poslední změny<br />
<br />
Nastavení Topic názvů každé položky (tedy "zápis" do sys[2211] až sys[2241]) se provede funkcí mqtt_subscribe(), které zadáváte pozici v této tabulce a název Topicu. Pokud se Subscribe nepovede, zůstane pozice v tabulce prázdná. Po připojení k Brokeru je tabulka vždy zcela prázdná, a SDS-C program si ji vždy musí dle potřeby naplnit. Pokud Broker pošle aktualizaci obsahu (value) na některou z přihlášených Topic položek, které SDS v této tabulce má, tak SDS automaticky přepíše patřičný řádek tabulky (tj. obsah jednoho ze sys[2251] až sys[2281]) a patřičně aktualizuje časovou známku změny.<br />
<br />
<br />
== Reserved ==<br />
<br />
sys[2322] až sys[2398] reserved<br />
<br />
<br />
== MODBUS-TCP klient ==<br />
<br />
Ověření FW v SDS:<br />
<br />
sys[2399] 09 i R podpora pro MODBUS TCP<br />
0 = NE<br />
1 = ANO (první verze implementace v SDS)<br />
<br />
Každé nové TCP spojení na server:<br />
<br />
sys[2400] 09 i R stav průběhu modbus_tcp_connect()<br />
-6 = timeout při čekání na připojení, nepřipojeno<br />
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno<br />
-4 = nespravne parametry (počet parametrů), nepřipojeno<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = pokus o TCP připojení selhal<br />
-1 = nepoužito<br />
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)<br />
1 = bylo zahájeno připojování (otevírá se TCP spojení)<br />
2 = TCP připojeno, můžete komunikovat <br />
<br />
MODBUS funkce - každá má svůj nezávislý stavový údaj:<br />
<br />
sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
pro všechny tyto stavy platí následující hodnoty:<br />
-6 = timeout (neprovedeno), můžete volat další funkci<br />
-5 = nespravne parametry (hodnoty), můžete volat další funkci<br />
-4 = nespravne parametry (počet parametrů), můžete volat další funkci<br />
-3 = funkce zavolána dříve (nebo opakovaně) než bylo dokončeno předchozí volání funkce, takže toto volání je ignorováno<br />
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)<br />
-1 = bez aktivity, lze volat funkci<br />
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci<br />
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci<br />
256 = pracuji, čekejte na aktualizovanou hodnotu<br />
<br />
sys[2417] až sys[2462] reserved<br />
<br />
sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy<br />
<br />
Přijatá data (funkce _read) - obsah je aktualizován pro každou novou přijatou MODBUS zprávu. Výsledky (přijatá data) jsou vždy uloženy do následujících sys (bez ohledu na typ MODBUS funkce).<br />
<br />
sys[2465] 09 i R timestamp poslední přijaté zprávy<br />
(vhodné pro detekci nové přijaté zprávy)<br />
<br />
sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu<br />
(počet celých položek)<br />
<br />
sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy)<br />
<br />
sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky<br />
(hodnota adresy je převzata z příchozí zprávy) <br />
<br />
sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])<br />
(MODBUS způsob číslování položek - adresa 1..n)<br />
<br />
sys[2470] až sys[2719]<br />
09 i R přijaté hodnoty pro poslední přijatou zprávu<br />
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input<br />
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr<br />
<br />
Pro funkce 0x01 a 0x02 jsou přijatá data kódována v jednobitovém tvaru, vždy po osmi bitech na jeden sys[]. Takže prvních osm bitů naleznete v sys[2465], dalších osm bitů v sys[2466] a tak dále.<br />
<br />
Pro funkce 0x03 a 0x04 jsou přijaté hodnoty registrů (MODBUS: vždy int16_t) uloženy postupně zasebou (tak jak přišli ve zprávě) do jednotlivých sys[], takže první registr je v sys[2465], druhý ve sys[2466] atd.<br />
<br />
<br />
Rezerva<br />
<br />
sys[2715] až sys[2809] reserved<br />
<br />
<br />
== Statistiky COMx ==<br />
<br />
COM1:<br />
<br />
sys[2810] 09 i R reserved<br />
<br />
sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1<br />
<br />
sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1 <br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1<br />
<br />
sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1<br />
<br />
sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1 <br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1<br />
<br />
<br />
Rezerva<br />
<br />
sys[2817] až sys[2860] reserved<br />
<br />
<br />
COM6:<br />
<br />
sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6<br />
<br />
sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6<br />
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)<br />
<br />
sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6<br />
<br />
sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6<br />
<br />
sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6<br />
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)<br />
<br />
sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6<br />
<br />
Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).<br />
<br />
<br />
== Konec dokumentu ==<br />
<br />
'''Konec dokumentu.'''</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_BIG:_firmware_changelog&diff=967SDS BIG: firmware changelog2025-10-25T13:13:23Z<p>Adamn: </p>
<hr />
<div>== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-BIG a SDS-SMALL a SDS-STSW.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
== 25.10.2025 ==<br />
* doplněna položka do M2M stránky onewire.csv - uživatelský název každého 1W prvku<br />
* FC: doplněna nová funkcionalita do funkce SDS_reset_program() - viz popis této funkce na wiki<br />
<br />
== 11.8.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* FC: přidány indexy 70 a 71 a 72<br />
<br />
== 28.3.2025 ==<br />
* oprava odpovědi pro S-UDP příkaz 0x04 (Read FC)<br />
<br />
== 15.3.2025 ==<br />
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)<br />
<br />
== 27.2.2025 ==<br />
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)<br />
* 512: oprava nefunkčního čtení ze sériové linky COM6<br />
<br />
== 8.2.2025 ==<br />
* oprava některých payloadů v protokolu SUDP <br />
<br />
== 22.7.2024 ==<br />
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB<br />
* možnost volby klidového stavu pro každý S0 vstup (umožňuje počítat impulsy i pro NC spínače v měřiči energie)<br />
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli<br />
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)<br />
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou<br />
<br />
== 24.2.2024 ==<br />
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)<br />
* RSTD nesmaže (nanastaví na tovární hodnoty) vaše nastavení pro všechny AD vstupy (to lze teď udělat ručně, nově přidaným tlačítkem ve webovém rozhraní)<br />
<br />
== 31.10.2023 ==<br />
* SNMP - oprava způsobu předání chyby v odpovědi<br />
* SNMP v1 - možnost nastavit dvě nezávislé komunity<br />
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)<br />
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)<br />
* FC: indexy 66, 67, 68, 4990..4999<br />
<br />
== 19.8.2023 ==<br />
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)<br />
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)<br />
<br />
== 14.7.2023 ==<br />
* HTTP POST: oprava sekundární chyby (objevila se ve FW 6.6.2023), kdy FW akceptoval jen rozdělený krok č. 2 (teď už opět umí jak rozdělený, tak i nerozdělený krok č. 2)<br />
* FC: umožněn přímý zápisu do indexu 193 (přímo zapíše do registru PWM - určeno pro nejjemnější uživatelskou přímo konfiguraci generátoru PWM)<br />
<br />
== 6.6.2023 ==<br />
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků<br />
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20<br />
* 512: další zvětšení FC konzole<br />
* webový admin: úprava (oprava) použití timerů v javascriptu <br />
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)<br />
* HTTP POST: poradí si i s ne-oddělenou komunikací (když klient pošle úvodní konverzační data najednou, neodděleně, tzn. nečeká na odpověď ze serveru)<br />
<br />
== 9.3.2023 ==<br />
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()<br />
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci<br />
<br />
== 28.2.2023 ==<br />
* POST: přidán příkaz /wrdf<br />
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip<br />
* malá bezpečnostní aktualizace<br />
<br />
== 9.1.2023 ==<br />
* FC verze 0x11 (+ odpovídající FULLC.EXE)<br />
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84<br />
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení <br />
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84<br />
* FC: doplněna funkčnost FC WatchDog (pro situaci, pokud spadne program na chybu a je zastaven, tak FC Watchdog pokračuje a provede restart FC programu)<br />
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)<br />
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)<br />
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení<br />
* HW BIG2 DS84: RTC běží na baterii na všech HW variantách DS84 - udržuje běžící aktuální čas i při vypnutém napájení<br />
* FC: přidána funkce SDS_onewire_search_bus()<br />
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997<br />
<br />
== 1.12.2022 ==<br />
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)<br />
* trvalé zobrazení archivovaného HW faultu v Logu (pokud dojde k faultu, je hned před restartem zařízení archivován a trvale zobrazován ve výpisu, i po libovolném novém spuštění)<br />
* odstraněno eventuální čekání (a následný WDG restart) při komunikaci s externími I2C zařízeními (specifické chipy na sandwich deskách uživatelů)<br />
<br />
== 30.11.2022 ==<br />
* FC: zvýšena výkonnost (512: optimalizace pro až několika-násobné celkové zrychlení vykonávání programu) (64,128: byť jen menší zrychlení, ale přece + zvětšená konzole echo.htm) <br />
* zrychleno webové rozhraní (zpomaleno zřejmě o dvě verze zpět, byť to bylo bez vlivu na funkci, je vhodnější když to nezdržuje při zobrazování v prohlížeči)<br />
* FC: přidán index 137<br />
* zlepšena interní obsluha sériových linek (COMx/RS485), odstraněno možné náhodné zpoždění (byť jen ve specifickém případě a jen o několik msec, ale i tak se toto vyřešilo)<br />
<br />
== 22.11.2022 ==<br />
* FC (64/128/512): verze 0x10 <br />
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu<br />
<br />
== 18.11.2022 ==<br />
* FC (64/128): verze 0x10 <br />
* FC: nová funkce SDS_set_RTC<br />
* FC: nové funkce pro práci s float<br />
* oprava pro mounting některých typů SD karet<br />
<br />
== 14.11.2022 ==<br />
* FC: oprava výpočtů v 64-bit doméně<br />
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot<br />
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty<br />
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem<br />
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki<br />
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm<br />
<br />
== 16.10.2022 ==<br />
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP<br />
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)<br />
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat<br />
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)<br />
* FC: zápis do indexu 999 funguje jak má<br />
* FC: verze 0x0F (nové funkce PWMx)<br />
<br />
== 5.10.2022 ==<br />
* pouze vše řady 512 (ostatní bez tohoto problému) - důležitá oprava situace kdy někdy chybně došlo ke smazání nahraného FC programu při nahrání nového UWEB projektu do SDS<br />
<br />
== 30.9.2022 ==<br />
* FC: oprava běhu programu v situaci kdy v kódu je vnořený (nested) switch() v rámci jiného switch() (původně chybné chování, teď opraveno)<br />
<br />
== 28.9.2022 ==<br />
* FC: oprava výsledků maker (define), kdy chybně docházelo k pevnému přetypování na int32_t, což je teď opraveno (odstraněno)<br />
<br />
== 1.8.2022 ==<br />
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace<br />
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)<br />
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)<br />
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)<br />
<br />
== 11.7.2022 ==<br />
* FC: verze 0x0E<br />
* FC: přidána funkce mktime()<br />
* FC: přidána funkce gmtime()<br />
* FC: přidána funkce localtime()<br />
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg<br />
<br />
== 1.7.2022 ==<br />
* FC: verze 0x0D<br />
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky<br />
* FC: přidána funkce SDS_TOPB_keyboard_updn()<br />
* FC: přidána funkce SDS_rescan_onewire()<br />
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE<br />
* BIG 64/128 prodloužen čas pro sestavení Ethernetového spojení, což řeší problém s některými USB síťovými kartami atd.<br />
* opraveno HTTP POST nastavení položek NTP<br />
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho<br />
<br />
== 12.4.2022 ==<br />
* doplněna informační stránka o vnitřním stavu OneWire Master (pro snazší identifikaci problémů při používání sběrnice)<br />
* oprava v bootloaderu pro řadu 512 - vyžaduje přeprogramování u výrobce pro všechna SDS řady 512 s FW starším než 14.2.2022<br />
<br />
== 3.4.2022 ==<br />
* FC verze 0x0C<br />
* FC: přidána funkce SDS_I2C_rw<br />
* OneWire stabilnější<br />
<br />
== 21.1.2022 ==<br />
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí<br />
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])<br />
<br />
== 18.1.2022 ==<br />
* RSTD zapíše do NVM všechny konfigurační položky (i to co nenuluje), pro jistotu že v NVM bude vše skutečně zapsáno<br />
* načítání konfigurace upraveno (větší spolehlivost)<br />
<br />
== 15.1.2022 ==<br />
* přidána stránka cfgstatus.htm - pro možnost kontroly stavu uložené konfigurace v pevné paměti (např. co nemáte uloženo)<br />
* přidán M2M výstup ip.xml<br />
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()<br />
* FC: každý program má unikátní identifikátor, podle kterého lze např. kontrolovat či zpětně poznat co máte v SDS nahráno<br />
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace<br />
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech<br />
* SNMP: nové položky .8.90 , .8.91 , .8.99<br />
* FC: nové get(u32) položky 2 a 87<br />
<br />
== 31.12.2021 ==<br />
* možnost vyřadit NTP z činnosti zadáním adresy 127.0.0.1 (vhodné pro uživatele kteří získávají čas odjinud, např. přes LoRA)<br />
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)<br />
* web: opraven zámek zvětšené konzole (echo)<br />
* důslednější kontrola platnosti konfigurace při startu<br />
<br />
== 27.12.2021 ==<br />
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)<br />
* FC: několikanásobně zvětšena konzole (echo.htm)<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (aktualizace bootloaderu jen prostřednictvím přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
* vydána varianta 512 - vlastní soubor s firmware<br />
<br />
== 25.12.2021 ==<br />
* pouze interní vydání<br />
<br />
== 26.3.2021 ==<br />
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)<br />
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C<br />
<br />
== 9.2.2021 ==<br />
* FC: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* FC: drobná úspora heap (více dostupného místa)<br />
* FC: dns resolv drobný fix<br />
* FC: http_get a http_post důležitý fix<br />
* FC: nová funkce http_close<br />
* FC: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)<br />
<br />
== 22.12.2020 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "FULL-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off)<br />
* security fix<br />
<br />
== 10.12.2020 ==<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení<br />
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci<br />
* počítání délky aktivace tarifního vstupu (doba T0 a T1 v sekundách za den) viz nové sys, pozor pro funkci vyžaduje NTP<br />
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP<br />
<br />
== 23.11.2020 ==<br />
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou<br />
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)<br />
* FC: detekce nesprávné dereference ukazatele<br />
<br />
== 14.11.2020 ==<br />
* webová administrace: stránka p=42: index ck03 se propíše i do nastavení (chybělo od 23.10.2020, web byl aktualizován, nastavení ale přebíralo ck00)<br />
<br />
== 4.11.2020 ==<br />
* FC + FULLC.exe: odstraněn problém při načtení nahraného FULL-C programu v SDS, kdy dříve mohlo u jedné specifické velikosti nahraného programu, dojít k jeho nespuštění kvůli neodpovídajícímu crc<br />
<br />
== 3.11.2020 ==<br />
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)<br />
* FULLC.exe: odstraněno omezení na 255 znaků na řádek<br />
* FULLC.exe: zrychlení nahrávání do SDS<br />
<br />
== 23.10.2020 ==<br />
* webová administrace: stránka p=42: změna indexu ck00 na ck03 ať se dají uživatelským skriptem všechny prvky samostatně rozlišit<br />
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST<br />
<br />
== 14.10.2020 ==<br />
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)<br />
<br />
== 13.10.2020 ==<br />
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)<br />
<br />
== 13.9.2020 ==<br />
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)<br />
<br />
== 9.8.2020 ==<br />
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)<br />
* různé drobné opravy a zabezpečení<br />
* zobrazení auditlogu (webové rozhraní SDS)<br />
* FC: http_post<br />
* FC: MQTT klient<br />
* FC: MODBUS-TCP klient<br />
<br />
== 4.8.2020 ==<br />
* úprava obsluhy relé<br />
* podpora OneWire modulu SDS-1W-T-RH<br />
<br />
== 3.10.2019 ==<br />
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)<br />
* RSTD při zapnutí zařízení, ve kterém není záložní baterie (nebo je vybitá), zachová původně nastavenou MAC adresu (vše ostatní ale už jde do defaultu, což je správně)<br />
* SUDP: rozšířen NOP příkaz <br />
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)<br />
<br />
== 23.9.2019 ==<br />
* oprava GUI (S0 Inputs)<br />
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)<br />
* opraven nefunkční RSTD na modulu STSW-rev3<br />
<br />
== 23.6.2019 ==<br />
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy<br />
<br />
== 28.5.2019 ==<br />
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)<br />
<br />
== 5.5.2019 ==<br />
* dořešeno hlídání stavu (načtení, atd.) SD karty i v případě provozu náročného FULL-C programu (tedy i pro hluboce vnořené smyčky)<br />
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"<br />
<br />
== 24.2.2019 ==<br />
* překlopení z BETA do oficiálního FW<br />
* automatika zimní/letní čas<br />
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.) <br />
* přístup na SD kartu: web server zobrazuje soubory ze SD karty (vše ve složce \web\ a podsložkách této složky)<br />
* oprava čtení napětí baterie pro variantu 128K<br />
* shared.xml<br />
* odstraněno omezení délky ve shared.txt<br />
* zprovozněno getsv<br />
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: nová možnost způsobu čtení teploty SoC<br />
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.<br />
* FULL-C: doplněné set/get funkce pro sdílené proměnné<br />
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float<br />
* FULL-C: funkce pro reset FC programu<br />
* FULL-C: funkce pro watchdog FC programu<br />
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)<br />
<br />
== 1.7.2018 ==<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím) <br />
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS<br />
<br />
== 27.6.2018 ==<br />
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: přidána podpora pro int64_t a uint64_t<br />
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)<br />
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)<br />
* drobné opravy<br />
* drobná oprava v odchozím TCP-SYN a v generátoru ISN<br />
<br />
== 8.3.2018 ==<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 11.2.2017 ==<br />
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)<br />
<br />
== 21.12.2017 ==<br />
* zvýšena stabilita spuštění po zapnutí<br />
<br />
== 20.12.2017 ==<br />
* dočasná změna ve FULL-C (bude zrušena): funkce snprintf() má interně posunutý limit délky zápisu o 1 (toto je záměrný rozdíl proti C99). Změna v SDS je provedena z důvodu neznalosti programátorů FC v tom, že do snprintf() limitu je potřeba započítat i jeden byte pro ukončující nulu. Ve výsledku tedy zápis "snprintf(buf, limit, ...);" je v FC interně vykonán jako "snprintf(buf, limit+1, ...);".<br />
* oprava ve FULL-C: výpočet platné délky bufferu funguje i pro ukazatele vytvořené offsetem ze základní alokované adresy (příklad takového bufferu je: buf=malloc(x)+offset;)<br />
* stav všech relé je načten z paměti vždy po zapnutí modulu, a ty relé které jsou ručně ovládány (manual control) a které byly před vypnutím v zapnutém (ON) stavu, jsou po zapnutí modulu aktivovány (zatímco relé ovládané z IP-W a FC jsou vždy po zapnutí modulu uvedeny do OFF stavu)<br />
<br />
== 18.12.2017 ==<br />
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů) <br />
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)<br />
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje<br />
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")<br />
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")<br />
<br />
== 18.9.2017 ==<br />
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)<br />
* FULL-C: snprint() opraven (když je 'from' kratší než 'to' tak je 'to' doplněn 0x00 - je to zvláštnost, nemá se to používat, ale C99 to předepisuje, tak to dodržíme)<br />
<br />
== 9.9.2017 ==<br />
* vnitřní bezpečnostní aktualizace<br />
<br />
== 29.8.2017 ==<br />
* oprava chování RSTD - pokud je zapojen před zapnutím, nepřejde do automatického resetu po 10sec, ale RSTD je použit a SDS pracuje dále; přitom funkce "zapoj RSTD za běhu" je zachována správně<br />
* zásadní zlepšení odolnosti FULL-C proti chybám programátora - vnitřní hlídání rozsahů bufferu a stringů, zamezující zápisu za hranice pole (typicky chybné použití sprintf() funkce, ale toto hlídání je aplikováno obecně všude)<br />
<br />
== 8.8.2017 ==<br />
* oprava: FC teď správně převádí URL kód "sv?xxxx=yyyy...", na text (vypadlo 31.3. při rozšíření počtu znaků pro sdílené proměnné Txx) <br />
<br />
== 10.7.2017 ==<br />
* vydán firmware pro variantu "128kB" (od teď vychází dva typy firmware, pro variantu "64kB" a variantu "128kB", vyberete si tu svou dle HW který máte)<br />
* velká optimalizace využití paměti pro uložení a běh FULL-C programu (komprese, a zmenšení vyžadovaného heapu pro běh programu) - významně zvětšuje možnou velikost FC programu<br />
* pin RSTD lze teď také použít i bez vypnutí a zapnutí SDS, stačí jej na 10 vteřin za běhu zkratovat (pak se provede RSTD a SDS se rebootuje) - výhodné pro zařízení kde vypnutí nelze provést<br />
* drobné užitečné opravy dle hlášení uživatelů<br />
* verze FC zvýšena na 0x08, a přidána možnost uložit 128 proměnných do baterií zálohované pamětí (tzn. obsah přežije výpadek napájení a FC program po restartu o tyto údaje nepřijde)<br />
<br />
== 2.6.2017 ==<br />
* návratová hodnota funkce DF_read_page() je nastavena správně i v případě, kdy tato funkce čte data z cache (opakované čtení stejné stránky DF)<br />
<br />
== 6.4.2017 ==<br />
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);<br />
<br />
== 31.3.2017 ==<br />
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)<br />
* oprava čtení konfigurace 1-W, pomocí sds_get_a()<br />
* přidán index 139<br />
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)<br />
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)<br />
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)<br />
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)<br />
<br />
<br />
== starší záznamy ==<br />
<br />
Nejsou k dispozici.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=Firmware&diff=966Firmware2025-10-25T13:10:59Z<p>Adamn: </p>
<hr />
<div>== Nový Firmware ==<br />
<br />
Aktualizujte si své SDS - nahrejte do něj nový firmware, který získáte na této stránce - '''naskrolujte dolů''' kde naleznete odkaz na BIN soubor pro vaše zařízení.<br />
<br />
Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].<br />
<br />
Důležité první kroky, které je nutné provést s každým novým zakoupeným modulem: [[New_Device_First_Setup_Steps|První nutné kroky pro nově zakoupené zařízení SDS]].<br />
<br />
<br />
=== Odkazy ke stáhnutí ===<br />
<br><br />
<br />
<div class="successbox">PC Software</div><br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')<br />
|-<br />
| style="padding: 15px;"| <li> stáhnout WinEXE pro SDS-C [https://sds.an-d.cz/firmware/SDSC_310123.exe zápis/simulace/upload SDS-C (SDS-C '''verze 09''') a UWEB, ze dne 31.1.2023]<br>SHA-256: daf1095f206404e33223f675f5d0bc09d4fc5dfd7d9f79f4f735af88f5ff1e6a<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> (FC verze '''0x12''' - '''aktuální'''): stáhnout WinEXE pro FULL-C [https://sds.an-d.cz/firmware/FULLC_220724.exe zápis/upload FULL-C a UWEB, ze dne 22.7.2024],<br> určeno pro Firmware od 9.3.2023 včetně, pro všechny varianty SDS (64kB a 128kB a 512kB)<br>SHA-256: b4cb95d8ec8a6e844a3a4c9a2e9fc50ece60ccf44e8043f8c10f46b2294cae0b<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program SDSLOAD.exe''' ("jednokrokový" upload .FC souborů a aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> ('''aktuální''' verze, pro FW od 10.7.2017 včetně a dále) stáhnout WinEXE [https://sds.an-d.cz/firmware/SDSLOAD_220724.exe program SDSLOAD ze dne 22.7.2024],<br> určeno pro všechny SDS varianty 64kB a 128kB a 512kB, (subvarianty DP a DS84)<br>SHA-256: ded5bf1aca2e04e22c33899a0976deccc8ff76eb88f53ecd9769788b7daa25a7<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''<br />
|-<br />
| style="padding: 15px;"| <li> Program '''[[SDS LOG: intro|SDS LOG]]''' - verze 0.1 ze dne 26.8.2011 - [https://sds.an-d.cz/firmware/SDS_LOG.exe stáhnout EXE program]<br />
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]<br />
<li> [[SDS LOG: changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
|}<br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_CZ.bin SDS-MICRO-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_EN.bin SDS-MICRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MICRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_CZ.bin SDS-MICRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_EN.bin SDS-MICRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_CZ.bin SDS-MICRO-ST-DP-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_EN.bin SDS-MICRO-ST-DP-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_CZ.bin SDS-MINI-ST-CZ ze dne 2.11.2023]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_EN.bin SDS-MINI-ST-EN released on 2-Nov-2023]<br />
<li><br />
[[SDS MINI: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].<br />
<li>Výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_CZ.bin SDS-MACRO-LM-CZ ze dne 1.7.2022]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_EN.bin SDS-MACRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MACRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_CZ.bin SDS-MACRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_EN.bin SDS-MACRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MACRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_CZ.bin SDS-TTCPRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_EN.bin SDS-TTCPRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_CZ.bin SDS-IO6-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_EN.bin SDS-IO6-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_CZ.bin SDS-IO6-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_EN.bin SDS-IO6-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.<br />
<li><br />
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.<br />
<li> <br />
<li>[[SDS FTP: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).<br />
<li><br />
<li>Stáhnout firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_CZ.bin (Česká lokalizace) SDS-UPS-ONEDPS-LM ze dne 1.7.2022]<br />
<li>Download firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_EN.bin (English language version) SDS-UPS-ONEDPS-LM released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.<br />
<li><br />
<li>Firmware je zaslán na požádání (pošlete email), aktuální verze je z 1.3.2011 (dále aktualizováno na specifické požádání, raději proto přejděte na nový HW).<br />
<li><br />
<li>Každá deska má svou kalibraci, proto každá deska má svůj vlastní FW, proto musíte uvést S/N svého výrobku.<br />
<li><br />
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW<br />
|-<br />
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]<br />
<li><br />
<li>Firmware je jednotný pro všechny varianty '''SDS Druhé Produktové Řady''', nutné je rozlišení dle varianty 64kB/128kB/512kB. Rozlišení podle dalších subvariant (DP, DS84) se neprovádí.<br />
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.<br />
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.<br />
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu. <br />
<li><br />
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_251025_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_251025_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 512kB) [[firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 12.4.2022|informace pokud máte SDS512 s FW <b>starším</b> než 12.4.2022]]<br />
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_251025_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 25.10.2025]<br />
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.<br />
|-<br />
| style="padding: 15px;"| POZOR<br />
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<br><br />
Aktualizaci lze provést jen fyzicky u výrobce, ten ji provede bezplatně (zašlete výrobci vaše SDS pro jeho aktualizaci). Se starým FW nebude tento HW plně fungovat.<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
=== Informace ===<br />
<br />
VŽDY MĚJTE VE SVÉM ZAŘÍZENÍ NEJNOVĚJŠÍ FIRMWARE, A POUŽÍVEJTE TAKÉ NEJNOVĚJŠÍ SDS-C EXE / FULL-C EXE PROGRAM.<br />
V opačném případě vám budou chybět nové funkce, které neustále přidáváme, a také nebudete mít opravené nalezené chyby.<br />
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.<br />
<br />
<br />
=== Historický Software ===<br />
<br />
Za účelem aktualizace takových SDS, kde už dlouho nebyl aktualizován firmware, je potřeba použít odpovídající EXE program pro aktualizaci takovéhoto zařízení.<br />
<br />
<br />
==== První Produktová Řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_151119.exe ze dne '''15.11.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 08, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020118.exe ze dne '''2.1.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 07, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020317.exe ze dne '''2.3.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 8.8.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_060216.exe ze dne '''6.2.2016''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které nemají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 24.1.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_231111.exe ze dne '''23.11.2011''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 04<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_170211.exe ze dne '''17.2.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''února 2011''')<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro ''SDS-C verze č. 03'' (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_140511.exe ze dne '''14.5.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''konce května 2011''')<br />
<br />
<br />
==== Druhá Produktová řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_070323.exe ze dne '''7.3.2023''']<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_311222.exe ze dne '''31.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 11, (firmware od 9.1.2023 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_071222.exe ze dne '''7.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 10, (firmware od 18.11.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_161022.exe ze dne '''16.10.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0F, (firmware od 16.10.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_110722.exe ze dne '''11.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0E, (firmware od 11.7.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010722.exe ze dne '''1.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0D, (firmware od 6.8.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030422.exe ze dne '''3.4.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0C, (firmware od 23.3.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010322.exe ze dne '''1.3.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0B, (firmware od 6.8.2020 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030119.exe ze dne '''3.1.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0A, (firmware od 3.1.2019 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010718.exe ze dne '''1.7.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 09, (firmware od 27.6.2018 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_100717.exe ze dne '''10.7.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 08, (firmware od 10.7.2017 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_080617.exe ze dne '''8.6.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 06, (firmware starší než Červenec-2017, a pouze pro variantu SDS 64kB)<br />
<br />
* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_120417.exe ze dne 12.4.2017],<br> určeno pouze pro SDS variantu 64kB která používá ''starý'' firmware (2017 nebo starší)<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_100717.exe ze dne 10.7.2017],<br> určeno pouze pro SDS variantu 64kB a 128kB (nepodporuje variantu 512kB tak jako aktuální stáhnutelná verze aplikace)<br />
<br />
<br />
== Beta Testing ==<br />
<br />
Než vydáme novou verzi, je potřeba změny a novinky otestovat.<br />
<br />
Pokud jste ochotní se testu zúčastnit, pak se podívejte [https://forum.sds.an-d.cz/viewtopic.php?id=129 na tento odkaz]. Zde jsou uveřejněny vždy nejnovější beta verze firmware.<br />
<br />
Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_general_functions&diff=965FULL-C: general functions2025-10-25T08:59:04Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Nezařazené funkce FULL-C ==<br />
__NOTOC__<br />
<br />
Zde je seznam různých funkcí, které FULL-C poskytuje a které nejsou blíže popsány na specifické tématické stránce:<br />
<pre><br />
void SDS_reset_program(unsigned int key);<br />
void SDS_set_wdg(unsigned int newTimeOut);<br />
void SDS_kick_wdg(unsigned int key);<br />
<br />
void SDS_heap_stats(unsigned int *currentAllocatedBytes, <br />
unsigned int *totalFreeBytes, unsigned int *biggestFreeBlockAvailable);<br />
</pre><br />
<br />
<br />
== Účel ==<br />
<br />
Vždy se má předpokládat, že v programu, který chcete spustit a provozovat, je nějaká (skrytá) chyba. I když je program napsán "dokonalým" způsobem, nikdy nemůžete mít jistotu, že tomu tak skutečně je. Toto je základní princip tzv. SAFETY vývoje, kdy automaticky VŽDY očekáváme že v programu může být chyba (respektive víme, že nejsme dokonalí, a dokonalosti se můžeme vždy jen přiblížit, ale z principu ji nelze dosáhnout). Dále je potřeba očekávat i vnější vlivy, kdy dojde k ovlivnění nebo dokonce snad i změně programu, neočekávaným a nechtěným vnějším vlivem. Ať je to uživatelům zásah, měřená fyzikální veličina mimo očekávaný rozsah, útok hackera a nebo snad kosmická částice která změní bit v paměti - úplný seznam nelze nikdy vytvořit. <br />
<br />
Toto vše však má řadu řešení, které byly dlouho zkoumány a připravovány. Jako vhodný základ je vývoj programů podle safety normy 61508, tedy minimálně si z ní vzít ty kritické požadavky.<br />
<br />
SDS nabízí funkci speciálního hlídače vašeho FC programu - tedy FC WATCHDOG. Tato funkce se musí aktivovat ve vašem FC programu, a následně se musí FC program periodicky hlásit, že stále správně funguje. Pokud se nepřihlásí v nastaveném čase, dojde ze strany SDS k zastavení a novému spuštění programu. Toto vše může váš FC program sledovat přes vybrané systémové indexy, a také konfigurovat přes určené FC funkce. <br />
<br />
Samozřejmě FC-Watchdog je jen jedním z mnoha prvků, které je potřeba využít, aby váš systém byl celkově odolný a vydržel chybu-vzdorně pracovat.<br />
<br />
Další prvky jsou:<br />
* úvodní analýza programu a způsob psaní kódu programu<br />
* detailně sepsané požadavky na všech úrovních, a jejich provázání na kód a test<br />
* sledování využití paměti<br />
* úvodní diagnostika<br />
* průběžná diagnostika<br />
* telemetrie (logování, informace předávané uživateli, historie, záchyt chybových stavů tak aby šla chyba plně identifikovat)<br />
* statická a dynamická analýza kódu programu<br />
* SiL a HiL testování<br />
* Unit Testy<br />
* schopnost programu pracovat v režimu snížené kapacity systému (např. při poškozené části systému)<br />
* odolnost programu a jeho vnitřních prvků a funkcí (především proti integer a buffer overflow)<br />
* zabezpečená komunikační rozhraní (safety a security)<br />
* zabezpečená datová úložiště (safety a security)<br />
<br />
Většina těchto prvků je "na vás", tedy SDS poskytuje prostor a možnosti k jejich realizaci.<br />
<br />
<br />
=== SDS_reset_program(): okamžité nové spuštění FC programu ===<br />
<br />
Zavoláním této funkce, se správně vyplněným parametrem ''key'', dojde k okamžitému znovu-spuštění aktuálního FULL-C programu. Tedy prakticky totéž, jako by došlo k resetu zařízení (ale to se nestane, SDS pokračuje v práci a nic se s ním při zavolání této funkce nestane; dojde pouze a jenom k ukončení a okamžitému novému spuštění nahraného FC programu).<br />
<br />
Podmínkou je předání hodnoty ''key'' jako čísla 1.<br />
<br />
<pre><br />
// <br />
SDS_reset_program(1); // reset programu se provede jen a pouze, pokud je parametr == 1<br />
<br />
// nebo takto:<br />
<br />
unsigned int k;<br />
k = 1234;<br />
SDS_reset_program(k); // protoze "k" neni 1, program bude pokracovat (nestane se restart programu)<br />
<br />
k = 1;<br />
SDS_reset_program(k); // a ted uz se program spusti odznova, protoze klic je 1 <br />
</pre><br />
<br />
<br />
=== SDS_reset_program(): restartování celého SDS modulu ===<br />
<br />
Druhá použitelná funkcionalita funkce SDS_reset_program() je provedení soft-resetu hlavního procesoru v SDS modulu. Soft-reset je programově vyvolaný RESET, kdy dojde k ukončení činnosti programu a celému novému startu (tedy prakticky to samé, jako by došlo k odpojení napájení modulu SDS, a znovu připojení napájení).<br />
<br />
Aby nedošlo k vyvolání této funkce omylem, je potřeba zadat správný dynamický parametr. Tento parametr je potřeba připravit v daný okamźik, a je platný jen 320 milisekund. To znamená, že od momentu kdy je nová hodnota parametru určena (spočtena) po zavolání funkce SDS_reset_program(), musí uplynout méně než 320 msec. Pokud to bude více, program bude pokračovat a k žádnému resetu nedojde. Toto si musíte ve svém programu ohlídat !<br />
<br />
<pre><br />
unsigned int dynamic_reset_value;<br />
<br />
// calculate<br />
dynamic_reset_value = SDS_get_u(3); // ziskame aktualni cas <br />
dynamic_reset_value = 0xF0000000 | (dynamic_reset_value >> 5); // specialni doplnujici vypocet<br />
<br />
// go<br />
SDS_reset_program(dynamic_reset_value); // reset SDS se provede jen tehdy, pokud hodnota odpovida<br />
<br />
// ted se bud provedl reset SDS, a proto se sem program uz nedostane (a vse zacne od zacatku),<br />
// nebo se neprovedl (protoze byla neplatna hodnota v dynamic_reset_value)<br />
<br />
printf("chyba, neprovedl se reset, zkusim to znovu ?\n");<br />
<br />
</pre><br />
<br />
<br />
=== SDS_set_wdg(): spuštění dohledu správněhu běhu FC programu ===<br />
<br />
Funkce nastaví a okamžitě spustí Watchdog pro FULL-C program - cílem je hlídat "nezaseknutí" vašeho FULL-C programu.<br />
<br />
Stanovíte si, jak často se váš FULL-C program musí "hlásit" že je v pořádku (nezaseknutý), a pokud se váš program do té doby neohlásí (např. zůstane "zaseknutý" v nějaké smyčce), tak SDS okamžitě provede jeho ukončení a následně spustí FC program znovu.<br />
<br />
Tato funkce tedy spustí odpočet, a pokud se tento dopočítá (z vámi nastavenou hodnotu) na nulu, dojde k popsanému restartu FC programu.<br />
<br />
Parametr '''newTimeOut''' nastavuje cílovou hodnotu odpočtu, a je uveden v sekundách. Příklad: SDS_set_wdg(10) spustí hlídání FC programu a pokud do 10 sekund není zavolána funkce SDS_kick_wdg, tak dojde k znovu-spuštění FC programu.<br />
<br />
Jakmile je jednou hlídač spuštěn, nelze jej deaktivovat - to se stane pouze při fyzickém restartu zařízení SDS, při nahrání nového FC programu, nebo při jeho novém spuštění. Při každém spuštění FC programu (nezávisle na důvodu, jestli to bylo nahráním nového programu, nebo jeho restartem), tak je hlídač vypnut - a FC program jej musí nastavit a spustit zavoláním funkce SDS_set_wdg().<br />
<br />
FC program si může zjistit, že jeho aktuální spuštění bylo vyvoláno právě z tohoto důvodu (zaseknutí) a podle toho se "zařídit" (např. poslat zprávu, přejít do nouzového režimu, atd. podle toho jak si to sami vymyslíte pro svou aplikaci).<br />
<br />
<br />
=== SDS_kick_wdg(): průběžná aktualizace dohledu běhu FC programu ===<br />
<br />
Funkce se volá opakovaně a musí se vždy stihnout zavolat (od svého posledního zavolání) v rámci nastaveného intervalu (viz funkce SDS_set_wdg).<br />
<br />
Zavolání SDS_kick_wdg dojde k nastavení odpočtu hlídače běhu FC programu, a odpočet tedy začne znovu klesat (může klesat až do nuly, kdy dojde k restartu programu - není-li odpočet včas znovu nastaven nahoru).<br />
<br />
Pokud tedy včas nezavoláte tuto funkci, dojde k restartování FC programu. Toto je záměr, kdy se vám např. program zasekne, tak s tím je potřeba něco udělat - a tento hlídač se o to postará.<br />
<br />
Je na vás, správně rozmístit volání SDS_kick_wdg do vašeho FC programu - není to jednoduché, a může se stát, že přehlédnete místo, kam to ještě bylo potřeba vložit. Důsledné testování vašeho FC programu je tedy na místě !<br />
<br />
Parametr ''key'' při volání SDS_kick_wdg() musí mít přesně stejnou číselnou hodnotu, jakou jste předali v parametru '''newTimeOut''' při prvním volání funkce SDS_set_wdg(). Pokud zavoláte funkci SDS_kick_wdg() s jinou hodnotou, je to jako by jste tuto funkci nezavolali - a hlídací odpočet dále pokračuje k nule.<br />
<br />
=== Příklad obsluhy FC-watchdogu ===<br />
<br />
<pre><br />
void main(void)<br />
{<br />
// start programu<br />
SDS_set_wdg(16); // nastav watchdog na 16 sekund<br />
<br />
// . . .<br />
<br />
for (;;)<br />
{<br />
<br />
// . . .<br />
<br />
if (vse_je_ok)<br />
{<br />
SDS_kick_wdg(16); // znovunastavení hlídače, od teď máme zase až 16 sekund . . .<br />
}<br />
<br />
// . . .<br />
<br />
}<br />
</pre><br />
<br />
=== SDS_heap_stats(): zjištění stavu dynamické paměti ===<br />
<br />
Celý FULL-C program, včetně všech proměnných, je umístěn v jednom 64kB nebo 128kB nebo 512kB bloku paměti RAM (viz stránka s popisem detailu využití paměti RAM v SDS). Všechna paměť, kterou program z těchto celkových kB RAM nevyužije, je k dispozici programu pomocí funkce '''malloc()'''.<br />
<br />
Některé další funkce (zejména funkce pro práci se sítí, jako je například '''snmp_send_trap()''' ), vyžadují chvilkově část této volné paměti pro svou činnost. Pokud tato paměť není k dispozici (buď je do zařízení nahrán tak velký program, že ji vyčerpá už při svém úvodním spuštění) (nebo program použil malloc() natolik, že volný heap vyčerpal), tak se tyto FULL-C funkce nepovede provést (bude vrácen příslušný chybový kód = nedostatek paměti).<br />
<br />
Pro aktuální zjištění situace (tj. kolik je volné paměti a jaký největší blok paměti (v kuse) lze alokovat), je zde k dispozici funkce '''SDS_heap_stats()'''.<br />
<br />
<br />
=== SDS_heap_stats(): příklad ===<br />
<br />
Příklad vypíše stav paměti heap, potom alokuje 2kB paměti, a potom znovu vypíše stav, potom alokovanou paměť uvolní a naposledy vypíše stav. Sledujte text který tento program napíše do konzole.<br />
<br />
<pre><br />
void main(void)<br />
{<br />
unsigned int currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable;<br />
void * ptr;<br />
<br />
printf("START\n");<br />
<br />
SDS_heap_stats(&currentAllocatedBytes, &totalFreeBytes, &biggestFreeBlockAvailable);<br />
printf("currentAllocatedBytes: %uB, totalFreeBytes: %uB, biggestFreeBlockAvailable:%uB \n\n",<br />
currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable);<br />
<br />
printf("ALLOC 2048 BYTES\n");<br />
ptr = malloc(2048);<br />
<br />
SDS_heap_stats(&currentAllocatedBytes, &totalFreeBytes, &biggestFreeBlockAvailable);<br />
printf("currentAllocatedBytes: %uB, totalFreeBytes: %uB, biggestFreeBlockAvailable:%uB \n\n",<br />
currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable);<br />
<br />
printf("FREE PTR\n");<br />
free(ptr); ptr = 0;<br />
<br />
SDS_heap_stats(&currentAllocatedBytes, &totalFreeBytes, &biggestFreeBlockAvailable);<br />
printf("currentAllocatedBytes: %uB, totalFreeBytes: %uB, biggestFreeBlockAvailable:%uB \n\n",<br />
currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable);<br />
<br />
}<br />
</pre><br />
<br />
<br />
== Důležité systémové indexy ==<br />
<br />
* '''40''': SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)<br />
Využijte pro analýzu jakým způsobem bylo SDS zapnuto - jestli se jedná o normální zapnutí (Power On Reset) nebo o (re)start firmware z důvodu nečekané chyby (např. watchdog)<br />
<br />
* '''86''': FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)<br />
Využijte pro vzdálené sledování stavu programu (je-li spuštěn a běží, nebo je-li pozastaven či vůbec neběží).<br />
<br />
* '''87''': FC: unique identifier of the actually uploaded FULL-C program<br />
Každý FC program má svůj odpovídající unikátní 32bit identifikátor, pomocí kterého lze jednotlivé programy od sebe rozpoznat. Tento identifikátor je hashem celého programového kódu, a tím je zaručena jeho vysoká unikátnost (která nebude dokonalá, ale pro tento primární účel, vhodná a použitelná je).<br />
<br />
* '''132''': FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
Informace - časová známka UTC, kdy došlo k poslednímu restartu tohoto FC programu, z důvodu aktivace FC-Watchdogu. Pokud k restartu nedošlo, je zde nula. Pokud UTC čas nebyl v době restartu k dispozici, je zde neplatný údaj. Tento údaj je vždy vynulován, pokud dojde k nahrání jiného programu do SDS.<br />
<br />
* '''133''': FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
Informace - hodnota UpTime, kdy došlo k poslednímu restartu tohoto FC programu, z důvodu aktivace FC-Watchdogu. Pokud k restartu nedošlo, je zde nula. Tento údaj je vždy vynulován, pokud dojde k nahrání jiného programu do SDS.<br />
<br />
* '''134''': FC: archived text of the last FC error<br />
Došlo-li k chybě, která způsobila pád nebo restart vašeho FC programu, je tato chyba archivována a je k dispozici zde - můžete ji tak sami zobrazit ve svém programu, nebo poslat dále v rámci logování. Tento údaj je nulován (prázdný text) jakmile je nahrán nový program do SDS.<br />
<br />
* '''135''': FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)<br />
Každý FC-Watchdog restart, pro aktuální nahraný FC program, způsobí zvýšení tohoto počítadla. Jakmile je nahrán nový FC program do SDS, je počítadlo vynulováno.<br />
<br />
* '''136''': FC: total count of all FC program starts, since the SDS boot<br />
Počítadlo úplně všech spuštění (libovolných) FC programů, od zapnutí SDS (respektive tedy: od posledního bootu SDS). Počítadlo se nuluje jen restartem SDS.<br />
<br />
* '''137''': read an actual SDS CPU cycle counter (number of executed instructions since power-up/reboot), continuously wraps around, (1 step = approx. 2 nsec)<br />
Vysokorychlostní automatický čítač, svázaný s vykonáváním CPU instrukcí v hlavním SoC chipu. Vhodné pro sledování rychlosti programu, pro logování atd.<br />
<br />
* '''183''': SDS FW date stamp (or just 0x00000000 for a very old firmware)<br />
Důležitý údaj, určuje datum nainstalované verze firmware v SDS. Díky tomuto údaji máte informaci o možnostech, které dané SDS s daným firmware poskytuje, a které ne (pokud je tam nainstalován starý firmware). Váš program může tento údaj zkontrolovat, a pokud zjistí že je v SDS nainstalován starý firmware (se kterým váš FC program není kompatibilní, nebo mu tam chybí nějaká funkce která je až v novější verzi firmware), může se tomu přizpůsobit, a nebo informovat uživatele a vynutit si aktualizace firmware v SDS.<br />
<br />
* '''184''': FC: information about how this actual running program was started (0 = none) (1 = normal) (2 = fc-wdg or manual restart) (4 = freshly loaded)<br />
Informace, jakým způsobem byl aktuální běžící FC program spuštěn. <br />
<br />
* '''185''': FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec<br />
Zde lze kontrolovat aktuální stav odpočtu čítače FC-Watchdogu. Pokud se počítadlo dostane na nulu, tedy nedojde-li včas k refreshi počítadla vhodným zavoláním funkce, je FC-Watchdog aktivován a dojde k restartu FC programu.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=New_Device_First_Setup_Steps&diff=964New Device First Setup Steps2025-08-11T10:44:58Z<p>Adamn: </p>
<hr />
<div>== Nově zakoupené zařízení SDS ==<br />
<br><br><br />
<br />
1. VŽDY AKTUALIZUJTE NA NOVÝ FIRMWARE - který získáte na stránce [[Firmware]].<br />
<br />
2. NÁSLEDNĚ PROVEĎTE FACTORY RESET (aktivace RSTD) - a to i v případě, že jste firmware neaktualizovali (tzn. že už v zařízení byl nejnovější FW)<br />
<br />
<br />
'''Pouze takto připravené zařízení lze dále provozovat.'''<br />
<br />
Pokud Vám zařízení SDS nefunguje atd. tak to je z 99% tím, že jste neprovedli výše uvedené dva důležité kroky.<br />
<br />
Zařízení SDS, které jste čerstvě zakoupili, může mít starší firmware (který si pak musíte sami aktualizovat), a může mít nesprávnou konfiguraci (např. po výrobních testech).<br> Proto je vždy nutné provést jak krok č. 1, tak především krok č. 2 !!!<br />
<br />
<br />
== Důsledky neprovedení výše uvedených kroků ==<br />
<br />
Pokud dostanete do rukou jakékoliv nové nebo použité zařízení SDS, musíte provést vždy oba výše uvedené kroky (ověřit verzi FW a provést RSTD).<br />
<br />
Zejména to, pokud neprovedete RSTD, může mít v důsledku symptom zpomaleného zařízení, kdy se celková odezva a rychlost zařízení SDS násobně sníží (to co má být okamžitě hotové trvá i několik sekund), včetně i zpomaleného vykonávání FULLC programu. Toto je čistě a pouze a přesně důsledek neprovedeného factory resetu konfigurace (aktivace RSTD dle návodu). Proto to vždy automaticky proveďte, bez ohledu na to, v jakém stavu si myslíte, že vaše zařízení SDS je - je potřeba mít úplnou jistotu, a jen toto ji dodá.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=New_Device_First_Setup_Steps&diff=963New Device First Setup Steps2025-08-11T10:44:48Z<p>Adamn: </p>
<hr />
<div>== Nově zakoupené zařízení SDS ==<br />
<br><br><br />
<br />
1. VŽDY AKTUALIZUJTE NA NOVÝ FIRMWARE - který získáte na stránce [[Firmware]].<br />
<br />
2. NÁSLEDNĚ PROVEĎTE FACTORY RESET (aktivace RSTD) - a to i v případě, že jste firmware neaktualizovali (tzn. že už v zařízení byl nejnovější FW)<br />
<br />
<br />
'''Pouze takto připravené zařízení lze dále provozovat.'''<br />
<br />
Pokud Vám zařízení SDS nefunguje atd. tak to je z 99% tím, že jste neprovedli výše uvedené dva důležité kroky.<br />
<br />
Zařízení SDS, které jste čerstvě zakoupili, může mít starší firmware (který si pak musíte sami aktualizovat), a může mít nesprávnou konfiguraci (např. po výrobních testech).<br> Proto je vždy nutné provést jak krok č. 1, tak především krok č. 2 !!!<br />
<br />
<br />
== Důsledky neprovedení výše uvedených kroků ==<br />
<br />
Pokud dostanete do rukou jakékoliv nové nebo použité zařízení SDS, musíte provést vždy oba výše uvedené kroky (ověřit verzi FW a provést RSTD).<br />
<br />
Zejména to, pokud neprovedete RSTD, může mít v důsledku symptom zpomaleného zařízení, kdy se celková odezva a rychlost zařízení SDS násobně sníží (to co má být okamžitě hotové trvá i několik sekund), včetně i zpomaleného vykonávání FULLC programu. Toto je čistě a pouze a přesně důsledek neprovedeného factory resetu konfigurace (aktivace RSTD dle návodu). Proto to vždy automaticky proveďte, bez ohledu na to, v jakém stavu si myslíte, že váše zařízení SDS je - je potřeba mít úplnou jistotu, a jen toto ji dodá.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_BIG:_firmware_changelog&diff=962SDS BIG: firmware changelog2025-08-11T10:38:49Z<p>Adamn: </p>
<hr />
<div>== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-BIG a SDS-SMALL a SDS-STSW.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
== 11.8.2025 ==<br />
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL<br />
* FC: přidány indexy 70 a 71 a 72<br />
<br />
== 28.3.2025 ==<br />
* oprava odpovědi pro S-UDP příkaz 0x04 (Read FC)<br />
<br />
== 15.3.2025 ==<br />
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)<br />
<br />
== 27.2.2025 ==<br />
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)<br />
* 512: oprava nefunkčního čtení ze sériové linky COM6<br />
<br />
== 8.2.2025 ==<br />
* oprava některých payloadů v protokolu SUDP <br />
<br />
== 22.7.2024 ==<br />
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB<br />
* možnost volby klidového stavu pro každý S0 vstup (umožňuje počítat impulsy i pro NC spínače v měřiči energie)<br />
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli<br />
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)<br />
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou<br />
<br />
== 24.2.2024 ==<br />
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)<br />
* RSTD nesmaže (nanastaví na tovární hodnoty) vaše nastavení pro všechny AD vstupy (to lze teď udělat ručně, nově přidaným tlačítkem ve webovém rozhraní)<br />
<br />
== 31.10.2023 ==<br />
* SNMP - oprava způsobu předání chyby v odpovědi<br />
* SNMP v1 - možnost nastavit dvě nezávislé komunity<br />
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)<br />
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)<br />
* FC: indexy 66, 67, 68, 4990..4999<br />
<br />
== 19.8.2023 ==<br />
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)<br />
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)<br />
<br />
== 14.7.2023 ==<br />
* HTTP POST: oprava sekundární chyby (objevila se ve FW 6.6.2023), kdy FW akceptoval jen rozdělený krok č. 2 (teď už opět umí jak rozdělený, tak i nerozdělený krok č. 2)<br />
* FC: umožněn přímý zápisu do indexu 193 (přímo zapíše do registru PWM - určeno pro nejjemnější uživatelskou přímo konfiguraci generátoru PWM)<br />
<br />
== 6.6.2023 ==<br />
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků<br />
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20<br />
* 512: další zvětšení FC konzole<br />
* webový admin: úprava (oprava) použití timerů v javascriptu <br />
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)<br />
* HTTP POST: poradí si i s ne-oddělenou komunikací (když klient pošle úvodní konverzační data najednou, neodděleně, tzn. nečeká na odpověď ze serveru)<br />
<br />
== 9.3.2023 ==<br />
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()<br />
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci<br />
<br />
== 28.2.2023 ==<br />
* POST: přidán příkaz /wrdf<br />
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip<br />
* malá bezpečnostní aktualizace<br />
<br />
== 9.1.2023 ==<br />
* FC verze 0x11 (+ odpovídající FULLC.EXE)<br />
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84<br />
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení <br />
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84<br />
* FC: doplněna funkčnost FC WatchDog (pro situaci, pokud spadne program na chybu a je zastaven, tak FC Watchdog pokračuje a provede restart FC programu)<br />
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)<br />
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)<br />
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení<br />
* HW BIG2 DS84: RTC běží na baterii na všech HW variantách DS84 - udržuje běžící aktuální čas i při vypnutém napájení<br />
* FC: přidána funkce SDS_onewire_search_bus()<br />
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997<br />
<br />
== 1.12.2022 ==<br />
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)<br />
* trvalé zobrazení archivovaného HW faultu v Logu (pokud dojde k faultu, je hned před restartem zařízení archivován a trvale zobrazován ve výpisu, i po libovolném novém spuštění)<br />
* odstraněno eventuální čekání (a následný WDG restart) při komunikaci s externími I2C zařízeními (specifické chipy na sandwich deskách uživatelů)<br />
<br />
== 30.11.2022 ==<br />
* FC: zvýšena výkonnost (512: optimalizace pro až několika-násobné celkové zrychlení vykonávání programu) (64,128: byť jen menší zrychlení, ale přece + zvětšená konzole echo.htm) <br />
* zrychleno webové rozhraní (zpomaleno zřejmě o dvě verze zpět, byť to bylo bez vlivu na funkci, je vhodnější když to nezdržuje při zobrazování v prohlížeči)<br />
* FC: přidán index 137<br />
* zlepšena interní obsluha sériových linek (COMx/RS485), odstraněno možné náhodné zpoždění (byť jen ve specifickém případě a jen o několik msec, ale i tak se toto vyřešilo)<br />
<br />
== 22.11.2022 ==<br />
* FC (64/128/512): verze 0x10 <br />
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu<br />
<br />
== 18.11.2022 ==<br />
* FC (64/128): verze 0x10 <br />
* FC: nová funkce SDS_set_RTC<br />
* FC: nové funkce pro práci s float<br />
* oprava pro mounting některých typů SD karet<br />
<br />
== 14.11.2022 ==<br />
* FC: oprava výpočtů v 64-bit doméně<br />
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot<br />
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty<br />
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem<br />
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki<br />
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm<br />
<br />
== 16.10.2022 ==<br />
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP<br />
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)<br />
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat<br />
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)<br />
* FC: zápis do indexu 999 funguje jak má<br />
* FC: verze 0x0F (nové funkce PWMx)<br />
<br />
== 5.10.2022 ==<br />
* pouze vše řady 512 (ostatní bez tohoto problému) - důležitá oprava situace kdy někdy chybně došlo ke smazání nahraného FC programu při nahrání nového UWEB projektu do SDS<br />
<br />
== 30.9.2022 ==<br />
* FC: oprava běhu programu v situaci kdy v kódu je vnořený (nested) switch() v rámci jiného switch() (původně chybné chování, teď opraveno)<br />
<br />
== 28.9.2022 ==<br />
* FC: oprava výsledků maker (define), kdy chybně docházelo k pevnému přetypování na int32_t, což je teď opraveno (odstraněno)<br />
<br />
== 1.8.2022 ==<br />
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace<br />
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)<br />
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)<br />
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)<br />
<br />
== 11.7.2022 ==<br />
* FC: verze 0x0E<br />
* FC: přidána funkce mktime()<br />
* FC: přidána funkce gmtime()<br />
* FC: přidána funkce localtime()<br />
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg<br />
<br />
== 1.7.2022 ==<br />
* FC: verze 0x0D<br />
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky<br />
* FC: přidána funkce SDS_TOPB_keyboard_updn()<br />
* FC: přidána funkce SDS_rescan_onewire()<br />
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE<br />
* BIG 64/128 prodloužen čas pro sestavení Ethernetového spojení, což řeší problém s některými USB síťovými kartami atd.<br />
* opraveno HTTP POST nastavení položek NTP<br />
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho<br />
<br />
== 12.4.2022 ==<br />
* doplněna informační stránka o vnitřním stavu OneWire Master (pro snazší identifikaci problémů při používání sběrnice)<br />
* oprava v bootloaderu pro řadu 512 - vyžaduje přeprogramování u výrobce pro všechna SDS řady 512 s FW starším než 14.2.2022<br />
<br />
== 3.4.2022 ==<br />
* FC verze 0x0C<br />
* FC: přidána funkce SDS_I2C_rw<br />
* OneWire stabilnější<br />
<br />
== 21.1.2022 ==<br />
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí<br />
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])<br />
<br />
== 18.1.2022 ==<br />
* RSTD zapíše do NVM všechny konfigurační položky (i to co nenuluje), pro jistotu že v NVM bude vše skutečně zapsáno<br />
* načítání konfigurace upraveno (větší spolehlivost)<br />
<br />
== 15.1.2022 ==<br />
* přidána stránka cfgstatus.htm - pro možnost kontroly stavu uložené konfigurace v pevné paměti (např. co nemáte uloženo)<br />
* přidán M2M výstup ip.xml<br />
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()<br />
* FC: každý program má unikátní identifikátor, podle kterého lze např. kontrolovat či zpětně poznat co máte v SDS nahráno<br />
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace<br />
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech<br />
* SNMP: nové položky .8.90 , .8.91 , .8.99<br />
* FC: nové get(u32) položky 2 a 87<br />
<br />
== 31.12.2021 ==<br />
* možnost vyřadit NTP z činnosti zadáním adresy 127.0.0.1 (vhodné pro uživatele kteří získávají čas odjinud, např. přes LoRA)<br />
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)<br />
* web: opraven zámek zvětšené konzole (echo)<br />
* důslednější kontrola platnosti konfigurace při startu<br />
<br />
== 27.12.2021 ==<br />
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)<br />
* FC: několikanásobně zvětšena konzole (echo.htm)<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (aktualizace bootloaderu jen prostřednictvím přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
* vydána varianta 512 - vlastní soubor s firmware<br />
<br />
== 25.12.2021 ==<br />
* pouze interní vydání<br />
<br />
== 26.3.2021 ==<br />
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)<br />
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C<br />
<br />
== 9.2.2021 ==<br />
* FC: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* FC: drobná úspora heap (více dostupného místa)<br />
* FC: dns resolv drobný fix<br />
* FC: http_get a http_post důležitý fix<br />
* FC: nová funkce http_close<br />
* FC: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)<br />
<br />
== 22.12.2020 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "FULL-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off)<br />
* security fix<br />
<br />
== 10.12.2020 ==<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení<br />
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci<br />
* počítání délky aktivace tarifního vstupu (doba T0 a T1 v sekundách za den) viz nové sys, pozor pro funkci vyžaduje NTP<br />
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP<br />
<br />
== 23.11.2020 ==<br />
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou<br />
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)<br />
* FC: detekce nesprávné dereference ukazatele<br />
<br />
== 14.11.2020 ==<br />
* webová administrace: stránka p=42: index ck03 se propíše i do nastavení (chybělo od 23.10.2020, web byl aktualizován, nastavení ale přebíralo ck00)<br />
<br />
== 4.11.2020 ==<br />
* FC + FULLC.exe: odstraněn problém při načtení nahraného FULL-C programu v SDS, kdy dříve mohlo u jedné specifické velikosti nahraného programu, dojít k jeho nespuštění kvůli neodpovídajícímu crc<br />
<br />
== 3.11.2020 ==<br />
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)<br />
* FULLC.exe: odstraněno omezení na 255 znaků na řádek<br />
* FULLC.exe: zrychlení nahrávání do SDS<br />
<br />
== 23.10.2020 ==<br />
* webová administrace: stránka p=42: změna indexu ck00 na ck03 ať se dají uživatelským skriptem všechny prvky samostatně rozlišit<br />
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST<br />
<br />
== 14.10.2020 ==<br />
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)<br />
<br />
== 13.10.2020 ==<br />
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)<br />
<br />
== 13.9.2020 ==<br />
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)<br />
<br />
== 9.8.2020 ==<br />
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)<br />
* různé drobné opravy a zabezpečení<br />
* zobrazení auditlogu (webové rozhraní SDS)<br />
* FC: http_post<br />
* FC: MQTT klient<br />
* FC: MODBUS-TCP klient<br />
<br />
== 4.8.2020 ==<br />
* úprava obsluhy relé<br />
* podpora OneWire modulu SDS-1W-T-RH<br />
<br />
== 3.10.2019 ==<br />
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)<br />
* RSTD při zapnutí zařízení, ve kterém není záložní baterie (nebo je vybitá), zachová původně nastavenou MAC adresu (vše ostatní ale už jde do defaultu, což je správně)<br />
* SUDP: rozšířen NOP příkaz <br />
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)<br />
<br />
== 23.9.2019 ==<br />
* oprava GUI (S0 Inputs)<br />
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)<br />
* opraven nefunkční RSTD na modulu STSW-rev3<br />
<br />
== 23.6.2019 ==<br />
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy<br />
<br />
== 28.5.2019 ==<br />
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)<br />
<br />
== 5.5.2019 ==<br />
* dořešeno hlídání stavu (načtení, atd.) SD karty i v případě provozu náročného FULL-C programu (tedy i pro hluboce vnořené smyčky)<br />
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"<br />
<br />
== 24.2.2019 ==<br />
* překlopení z BETA do oficiálního FW<br />
* automatika zimní/letní čas<br />
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.) <br />
* přístup na SD kartu: web server zobrazuje soubory ze SD karty (vše ve složce \web\ a podsložkách této složky)<br />
* oprava čtení napětí baterie pro variantu 128K<br />
* shared.xml<br />
* odstraněno omezení délky ve shared.txt<br />
* zprovozněno getsv<br />
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: nová možnost způsobu čtení teploty SoC<br />
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.<br />
* FULL-C: doplněné set/get funkce pro sdílené proměnné<br />
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float<br />
* FULL-C: funkce pro reset FC programu<br />
* FULL-C: funkce pro watchdog FC programu<br />
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)<br />
<br />
== 1.7.2018 ==<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím) <br />
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS<br />
<br />
== 27.6.2018 ==<br />
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: přidána podpora pro int64_t a uint64_t<br />
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)<br />
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)<br />
* drobné opravy<br />
* drobná oprava v odchozím TCP-SYN a v generátoru ISN<br />
<br />
== 8.3.2018 ==<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 11.2.2017 ==<br />
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)<br />
<br />
== 21.12.2017 ==<br />
* zvýšena stabilita spuštění po zapnutí<br />
<br />
== 20.12.2017 ==<br />
* dočasná změna ve FULL-C (bude zrušena): funkce snprintf() má interně posunutý limit délky zápisu o 1 (toto je záměrný rozdíl proti C99). Změna v SDS je provedena z důvodu neznalosti programátorů FC v tom, že do snprintf() limitu je potřeba započítat i jeden byte pro ukončující nulu. Ve výsledku tedy zápis "snprintf(buf, limit, ...);" je v FC interně vykonán jako "snprintf(buf, limit+1, ...);".<br />
* oprava ve FULL-C: výpočet platné délky bufferu funguje i pro ukazatele vytvořené offsetem ze základní alokované adresy (příklad takového bufferu je: buf=malloc(x)+offset;)<br />
* stav všech relé je načten z paměti vždy po zapnutí modulu, a ty relé které jsou ručně ovládány (manual control) a které byly před vypnutím v zapnutém (ON) stavu, jsou po zapnutí modulu aktivovány (zatímco relé ovládané z IP-W a FC jsou vždy po zapnutí modulu uvedeny do OFF stavu)<br />
<br />
== 18.12.2017 ==<br />
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů) <br />
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)<br />
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje<br />
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")<br />
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")<br />
<br />
== 18.9.2017 ==<br />
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)<br />
* FULL-C: snprint() opraven (když je 'from' kratší než 'to' tak je 'to' doplněn 0x00 - je to zvláštnost, nemá se to používat, ale C99 to předepisuje, tak to dodržíme)<br />
<br />
== 9.9.2017 ==<br />
* vnitřní bezpečnostní aktualizace<br />
<br />
== 29.8.2017 ==<br />
* oprava chování RSTD - pokud je zapojen před zapnutím, nepřejde do automatického resetu po 10sec, ale RSTD je použit a SDS pracuje dále; přitom funkce "zapoj RSTD za běhu" je zachována správně<br />
* zásadní zlepšení odolnosti FULL-C proti chybám programátora - vnitřní hlídání rozsahů bufferu a stringů, zamezující zápisu za hranice pole (typicky chybné použití sprintf() funkce, ale toto hlídání je aplikováno obecně všude)<br />
<br />
== 8.8.2017 ==<br />
* oprava: FC teď správně převádí URL kód "sv?xxxx=yyyy...", na text (vypadlo 31.3. při rozšíření počtu znaků pro sdílené proměnné Txx) <br />
<br />
== 10.7.2017 ==<br />
* vydán firmware pro variantu "128kB" (od teď vychází dva typy firmware, pro variantu "64kB" a variantu "128kB", vyberete si tu svou dle HW který máte)<br />
* velká optimalizace využití paměti pro uložení a běh FULL-C programu (komprese, a zmenšení vyžadovaného heapu pro běh programu) - významně zvětšuje možnou velikost FC programu<br />
* pin RSTD lze teď také použít i bez vypnutí a zapnutí SDS, stačí jej na 10 vteřin za běhu zkratovat (pak se provede RSTD a SDS se rebootuje) - výhodné pro zařízení kde vypnutí nelze provést<br />
* drobné užitečné opravy dle hlášení uživatelů<br />
* verze FC zvýšena na 0x08, a přidána možnost uložit 128 proměnných do baterií zálohované pamětí (tzn. obsah přežije výpadek napájení a FC program po restartu o tyto údaje nepřijde)<br />
<br />
== 2.6.2017 ==<br />
* návratová hodnota funkce DF_read_page() je nastavena správně i v případě, kdy tato funkce čte data z cache (opakované čtení stejné stránky DF)<br />
<br />
== 6.4.2017 ==<br />
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);<br />
<br />
== 31.3.2017 ==<br />
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)<br />
* oprava čtení konfigurace 1-W, pomocí sds_get_a()<br />
* přidán index 139<br />
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)<br />
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)<br />
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)<br />
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)<br />
<br />
<br />
== starší záznamy ==<br />
<br />
Nejsou k dispozici.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=Firmware&diff=961Firmware2025-08-11T10:37:16Z<p>Adamn: </p>
<hr />
<div>== Nový Firmware ==<br />
<br />
Aktualizujte si své SDS - nahrejte do něj nový firmware, který získáte na této stránce - '''naskrolujte dolů''' kde naleznete odkaz na BIN soubor pro vaše zařízení.<br />
<br />
Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].<br />
<br />
Důležité první kroky, které je nutné provést s každým novým zakoupeným modulem: [[New_Device_First_Setup_Steps|První nutné kroky pro nově zakoupené zařízení SDS]].<br />
<br />
<br />
=== Odkazy ke stáhnutí ===<br />
<br><br />
<br />
<div class="successbox">PC Software</div><br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')<br />
|-<br />
| style="padding: 15px;"| <li> stáhnout WinEXE pro SDS-C [https://sds.an-d.cz/firmware/SDSC_310123.exe zápis/simulace/upload SDS-C (SDS-C '''verze 09''') a UWEB, ze dne 31.1.2023]<br>SHA-256: daf1095f206404e33223f675f5d0bc09d4fc5dfd7d9f79f4f735af88f5ff1e6a<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> (FC verze '''0x12''' - '''aktuální'''): stáhnout WinEXE pro FULL-C [https://sds.an-d.cz/firmware/FULLC_220724.exe zápis/upload FULL-C a UWEB, ze dne 22.7.2024],<br> určeno pro Firmware od 9.3.2023 včetně, pro všechny varianty SDS (64kB a 128kB a 512kB)<br>SHA-256: b4cb95d8ec8a6e844a3a4c9a2e9fc50ece60ccf44e8043f8c10f46b2294cae0b<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program SDSLOAD.exe''' ("jednokrokový" upload .FC souborů a aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> ('''aktuální''' verze, pro FW od 10.7.2017 včetně a dále) stáhnout WinEXE [https://sds.an-d.cz/firmware/SDSLOAD_220724.exe program SDSLOAD ze dne 22.7.2024],<br> určeno pro všechny SDS varianty 64kB a 128kB a 512kB, (subvarianty DP a DS84)<br>SHA-256: ded5bf1aca2e04e22c33899a0976deccc8ff76eb88f53ecd9769788b7daa25a7<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''<br />
|-<br />
| style="padding: 15px;"| <li> Program '''[[SDS LOG: intro|SDS LOG]]''' - verze 0.1 ze dne 26.8.2011 - [https://sds.an-d.cz/firmware/SDS_LOG.exe stáhnout EXE program]<br />
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]<br />
<li> [[SDS LOG: changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
|}<br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_CZ.bin SDS-MICRO-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_EN.bin SDS-MICRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MICRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_CZ.bin SDS-MICRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_EN.bin SDS-MICRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_CZ.bin SDS-MICRO-ST-DP-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_EN.bin SDS-MICRO-ST-DP-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_CZ.bin SDS-MINI-ST-CZ ze dne 2.11.2023]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_EN.bin SDS-MINI-ST-EN released on 2-Nov-2023]<br />
<li><br />
[[SDS MINI: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].<br />
<li>Výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_CZ.bin SDS-MACRO-LM-CZ ze dne 1.7.2022]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_EN.bin SDS-MACRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MACRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_CZ.bin SDS-MACRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_EN.bin SDS-MACRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MACRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_CZ.bin SDS-TTCPRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_EN.bin SDS-TTCPRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_CZ.bin SDS-IO6-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_EN.bin SDS-IO6-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_CZ.bin SDS-IO6-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_EN.bin SDS-IO6-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.<br />
<li><br />
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.<br />
<li> <br />
<li>[[SDS FTP: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).<br />
<li><br />
<li>Stáhnout firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_CZ.bin (Česká lokalizace) SDS-UPS-ONEDPS-LM ze dne 1.7.2022]<br />
<li>Download firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_EN.bin (English language version) SDS-UPS-ONEDPS-LM released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.<br />
<li><br />
<li>Firmware je zaslán na požádání (pošlete email), aktuální verze je z 1.3.2011 (dále aktualizováno na specifické požádání, raději proto přejděte na nový HW).<br />
<li><br />
<li>Každá deska má svou kalibraci, proto každá deska má svůj vlastní FW, proto musíte uvést S/N svého výrobku.<br />
<li><br />
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW<br />
|-<br />
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]<br />
<li><br />
<li>Firmware je jednotný pro všechny varianty '''SDS Druhé Produktové Řady''', nutné je rozlišení dle varianty 64kB/128kB/512kB. Rozlišení podle dalších subvariant (DP, DS84) se neprovádí.<br />
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.<br />
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.<br />
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu. <br />
<li><br />
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_110825_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 11.8.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_110825_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 11.8.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 512kB) [[firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 12.4.2022|informace pokud máte SDS512 s FW <b>starším</b> než 12.4.2022]]<br />
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_110825_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 11.8.2025]<br />
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.<br />
|-<br />
| style="padding: 15px;"| POZOR<br />
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<br><br />
Aktualizaci lze provést jen fyzicky u výrobce, ten ji provede bezplatně (zašlete výrobci vaše SDS pro jeho aktualizaci). Se starým FW nebude tento HW plně fungovat.<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
=== Informace ===<br />
<br />
VŽDY MĚJTE VE SVÉM ZAŘÍZENÍ NEJNOVĚJŠÍ FIRMWARE, A POUŽÍVEJTE TAKÉ NEJNOVĚJŠÍ SDS-C EXE / FULL-C EXE PROGRAM.<br />
V opačném případě vám budou chybět nové funkce, které neustále přidáváme, a také nebudete mít opravené nalezené chyby.<br />
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.<br />
<br />
<br />
=== Historický Software ===<br />
<br />
Za účelem aktualizace takových SDS, kde už dlouho nebyl aktualizován firmware, je potřeba použít odpovídající EXE program pro aktualizaci takovéhoto zařízení.<br />
<br />
<br />
==== První Produktová Řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_151119.exe ze dne '''15.11.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 08, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020118.exe ze dne '''2.1.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 07, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020317.exe ze dne '''2.3.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 8.8.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_060216.exe ze dne '''6.2.2016''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které nemají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 24.1.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_231111.exe ze dne '''23.11.2011''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 04<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_170211.exe ze dne '''17.2.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''února 2011''')<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro ''SDS-C verze č. 03'' (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_140511.exe ze dne '''14.5.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''konce května 2011''')<br />
<br />
<br />
==== Druhá Produktová řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_070323.exe ze dne '''7.3.2023''']<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_311222.exe ze dne '''31.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 11, (firmware od 9.1.2023 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_071222.exe ze dne '''7.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 10, (firmware od 18.11.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_161022.exe ze dne '''16.10.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0F, (firmware od 16.10.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_110722.exe ze dne '''11.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0E, (firmware od 11.7.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010722.exe ze dne '''1.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0D, (firmware od 6.8.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030422.exe ze dne '''3.4.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0C, (firmware od 23.3.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010322.exe ze dne '''1.3.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0B, (firmware od 6.8.2020 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030119.exe ze dne '''3.1.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0A, (firmware od 3.1.2019 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010718.exe ze dne '''1.7.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 09, (firmware od 27.6.2018 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_100717.exe ze dne '''10.7.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 08, (firmware od 10.7.2017 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_080617.exe ze dne '''8.6.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 06, (firmware starší než Červenec-2017, a pouze pro variantu SDS 64kB)<br />
<br />
* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_120417.exe ze dne 12.4.2017],<br> určeno pouze pro SDS variantu 64kB která používá ''starý'' firmware (2017 nebo starší)<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_100717.exe ze dne 10.7.2017],<br> určeno pouze pro SDS variantu 64kB a 128kB (nepodporuje variantu 512kB tak jako aktuální stáhnutelná verze aplikace)<br />
<br />
<br />
== Beta Testing ==<br />
<br />
Než vydáme novou verzi, je potřeba změny a novinky otestovat.<br />
<br />
Pokud jste ochotní se testu zúčastnit, pak se podívejte [https://forum.sds.an-d.cz/viewtopic.php?id=129 na tento odkaz]. Zde jsou uveřejněny vždy nejnovější beta verze firmware.<br />
<br />
Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=New_Device_First_Setup_Steps&diff=960New Device First Setup Steps2025-08-11T08:00:05Z<p>Adamn: </p>
<hr />
<div>== Nově zakoupené zařízení SDS ==<br />
<br><br><br />
<br />
1. VŽDY AKTUALIZUJTE NA NOVÝ FIRMWARE - který získáte na stránce [[Firmware]].<br />
<br />
2. NÁSLEDNĚ PROVEĎTE FACTORY RESET (aktivace RSTD) - a to i v případě, že jste firmware neaktualizovali (tzn. že už v zařízení byl nejnovější FW)<br />
<br />
<br />
'''Pouze takto připravené zařízení lze dále provozovat.'''<br />
<br />
Pokud Vám zařízení SDS nefunguje atd. tak to je z 99% tím, že jste neprovedli výše uvedené dva důležité kroky.<br />
<br />
Zařízení SDS, které jste čerstvě zakoupili, může mít starší firmware (který si pak musíte sami aktualizovat), a může mít nesprávnou konfiguraci (např. po výrobních testech). Proto je vždy nutné provést jak krok č. 1, tak především krok č. 2 !!!</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=New_Device_First_Setup_Steps&diff=959New Device First Setup Steps2025-08-11T07:58:44Z<p>Adamn: Založena nová stránka s textem „== Nově zakoupené zařízení SDS == 1. VŽDY AKTUALIZUJTE NA NOVÝ FIRMWARE - který získáte na stránce Firmware. 2. NÁSLEDNĚ PROVEĎTE FACT…“</p>
<hr />
<div>== Nově zakoupené zařízení SDS ==<br />
<br />
<br />
1. VŽDY AKTUALIZUJTE NA NOVÝ FIRMWARE - který získáte na stránce [[Firmware]].<br />
<br />
2. NÁSLEDNĚ PROVEĎTE FACTORY RESET (aktivace RSTD) - a to i v případě, že jste firmware neaktualizovali (tzn. že už v zařízení byl nejnovější FW)<br />
<br />
<br />
Pouze takto připravené zařízení lze dále provozovat.<br />
<br />
Pokud Vám zařízení SDS nefunguje atd. tak to je z 99% tím, že jste neprovedli výše uvedené dva důležité kroky.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=Firmware&diff=958Firmware2025-08-11T07:56:15Z<p>Adamn: </p>
<hr />
<div>== Nový Firmware ==<br />
<br />
Aktualizujte si své SDS - nahrejte do něj nový firmware, který získáte na této stránce - '''naskrolujte dolů''' kde naleznete odkaz na BIN soubor pro vaše zařízení.<br />
<br />
Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].<br />
<br />
Důležité první kroky, které je nutné provést s každým novým zakoupeným modulem: [[New_Device_First_Setup_Steps|První nutné kroky pro nově zakoupené zařízení SDS]].<br />
<br />
<br />
=== Odkazy ke stáhnutí ===<br />
<br><br />
<br />
<div class="successbox">PC Software</div><br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')<br />
|-<br />
| style="padding: 15px;"| <li> stáhnout WinEXE pro SDS-C [https://sds.an-d.cz/firmware/SDSC_310123.exe zápis/simulace/upload SDS-C (SDS-C '''verze 09''') a UWEB, ze dne 31.1.2023]<br>SHA-256: daf1095f206404e33223f675f5d0bc09d4fc5dfd7d9f79f4f735af88f5ff1e6a<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> (FC verze '''0x12''' - '''aktuální'''): stáhnout WinEXE pro FULL-C [https://sds.an-d.cz/firmware/FULLC_220724.exe zápis/upload FULL-C a UWEB, ze dne 22.7.2024],<br> určeno pro Firmware od 9.3.2023 včetně, pro všechny varianty SDS (64kB a 128kB a 512kB)<br>SHA-256: b4cb95d8ec8a6e844a3a4c9a2e9fc50ece60ccf44e8043f8c10f46b2294cae0b<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program SDSLOAD.exe''' ("jednokrokový" upload .FC souborů a aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> ('''aktuální''' verze, pro FW od 10.7.2017 včetně a dále) stáhnout WinEXE [https://sds.an-d.cz/firmware/SDSLOAD_220724.exe program SDSLOAD ze dne 22.7.2024],<br> určeno pro všechny SDS varianty 64kB a 128kB a 512kB, (subvarianty DP a DS84)<br>SHA-256: ded5bf1aca2e04e22c33899a0976deccc8ff76eb88f53ecd9769788b7daa25a7<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''<br />
|-<br />
| style="padding: 15px;"| <li> Program '''[[SDS LOG: intro|SDS LOG]]''' - verze 0.1 ze dne 26.8.2011 - [https://sds.an-d.cz/firmware/SDS_LOG.exe stáhnout EXE program]<br />
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]<br />
<li> [[SDS LOG: changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
|}<br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_CZ.bin SDS-MICRO-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_EN.bin SDS-MICRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MICRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_CZ.bin SDS-MICRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_EN.bin SDS-MICRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_CZ.bin SDS-MICRO-ST-DP-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_EN.bin SDS-MICRO-ST-DP-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_CZ.bin SDS-MINI-ST-CZ ze dne 2.11.2023]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_EN.bin SDS-MINI-ST-EN released on 2-Nov-2023]<br />
<li><br />
[[SDS MINI: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].<br />
<li>Výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_CZ.bin SDS-MACRO-LM-CZ ze dne 1.7.2022]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_EN.bin SDS-MACRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MACRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_CZ.bin SDS-MACRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_EN.bin SDS-MACRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MACRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_CZ.bin SDS-TTCPRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_EN.bin SDS-TTCPRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_CZ.bin SDS-IO6-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_EN.bin SDS-IO6-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_CZ.bin SDS-IO6-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_EN.bin SDS-IO6-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.<br />
<li><br />
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.<br />
<li> <br />
<li>[[SDS FTP: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).<br />
<li><br />
<li>Stáhnout firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_CZ.bin (Česká lokalizace) SDS-UPS-ONEDPS-LM ze dne 1.7.2022]<br />
<li>Download firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_EN.bin (English language version) SDS-UPS-ONEDPS-LM released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.<br />
<li><br />
<li>Firmware je zaslán na požádání (pošlete email), aktuální verze je z 1.3.2011 (dále aktualizováno na specifické požádání, raději proto přejděte na nový HW).<br />
<li><br />
<li>Každá deska má svou kalibraci, proto každá deska má svůj vlastní FW, proto musíte uvést S/N svého výrobku.<br />
<li><br />
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW<br />
|-<br />
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]<br />
<li><br />
<li>Firmware je jednotný pro všechny varianty '''SDS Druhé Produktové Řady''', nutné je rozlišení dle varianty 64kB/128kB/512kB. Rozlišení podle dalších subvariant (DP, DS84) se neprovádí.<br />
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.<br />
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.<br />
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu. <br />
<li><br />
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_280325_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 28.3.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_280325_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 28.3.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 512kB) [[firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 12.4.2022|informace pokud máte SDS512 s FW <b>starším</b> než 12.4.2022]]<br />
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_280325_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 28.3.2025]<br />
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.<br />
|-<br />
| style="padding: 15px;"| POZOR<br />
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<br><br />
Aktualizaci lze provést jen fyzicky u výrobce, ten ji provede bezplatně (zašlete výrobci vaše SDS pro jeho aktualizaci). Se starým FW nebude tento HW plně fungovat.<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
=== Informace ===<br />
<br />
VŽDY MĚJTE VE SVÉM ZAŘÍZENÍ NEJNOVĚJŠÍ FIRMWARE, A POUŽÍVEJTE TAKÉ NEJNOVĚJŠÍ SDS-C EXE / FULL-C EXE PROGRAM.<br />
V opačném případě vám budou chybět nové funkce, které neustále přidáváme, a také nebudete mít opravené nalezené chyby.<br />
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.<br />
<br />
<br />
=== Historický Software ===<br />
<br />
Za účelem aktualizace takových SDS, kde už dlouho nebyl aktualizován firmware, je potřeba použít odpovídající EXE program pro aktualizaci takovéhoto zařízení.<br />
<br />
<br />
==== První Produktová Řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_151119.exe ze dne '''15.11.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 08, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020118.exe ze dne '''2.1.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 07, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020317.exe ze dne '''2.3.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 8.8.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_060216.exe ze dne '''6.2.2016''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které nemají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 24.1.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_231111.exe ze dne '''23.11.2011''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 04<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_170211.exe ze dne '''17.2.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''února 2011''')<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro ''SDS-C verze č. 03'' (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_140511.exe ze dne '''14.5.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''konce května 2011''')<br />
<br />
<br />
==== Druhá Produktová řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_070323.exe ze dne '''7.3.2023''']<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_311222.exe ze dne '''31.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 11, (firmware od 9.1.2023 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_071222.exe ze dne '''7.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 10, (firmware od 18.11.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_161022.exe ze dne '''16.10.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0F, (firmware od 16.10.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_110722.exe ze dne '''11.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0E, (firmware od 11.7.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010722.exe ze dne '''1.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0D, (firmware od 6.8.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030422.exe ze dne '''3.4.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0C, (firmware od 23.3.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010322.exe ze dne '''1.3.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0B, (firmware od 6.8.2020 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030119.exe ze dne '''3.1.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0A, (firmware od 3.1.2019 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010718.exe ze dne '''1.7.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 09, (firmware od 27.6.2018 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_100717.exe ze dne '''10.7.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 08, (firmware od 10.7.2017 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_080617.exe ze dne '''8.6.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 06, (firmware starší než Červenec-2017, a pouze pro variantu SDS 64kB)<br />
<br />
* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_120417.exe ze dne 12.4.2017],<br> určeno pouze pro SDS variantu 64kB která používá ''starý'' firmware (2017 nebo starší)<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_100717.exe ze dne 10.7.2017],<br> určeno pouze pro SDS variantu 64kB a 128kB (nepodporuje variantu 512kB tak jako aktuální stáhnutelná verze aplikace)<br />
<br />
<br />
== Beta Testing ==<br />
<br />
Než vydáme novou verzi, je potřeba změny a novinky otestovat.<br />
<br />
Pokud jste ochotní se testu zúčastnit, pak se podívejte [https://forum.sds.an-d.cz/viewtopic.php?id=129 na tento odkaz]. Zde jsou uveřejněny vždy nejnovější beta verze firmware.<br />
<br />
Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C_dns_resolv_functions&diff=957FULL-C dns resolv functions2025-08-10T16:32:01Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==<br />
__NOTOC__<br />
<br />
Zařízení SDS umožňuje odeslat dotaz na DNS server, za účelem zjištění IP adresy přidělené k DNS názvu, který je obsahem právě takového dotazu.<br />
<br />
Za tímto účelem jsou k dispozici tyto dvě funkce:<br />
<pre><br />
void dns_resolv(char *domainNameInput);<br />
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);<br />
</pre><br />
<br />
== Princip ==<br />
<br />
SDS odesílá dotaz na DNS server, který je nastaven uživatelem SDS ve webové administraci zařízení (popř. je adresa DNS serveru získána z DHCP serveru, opět záleží na konfiguraci).<br />
<br />
Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.<br />
<br />
<br />
'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''<br />
<br />
<br />
== Příklad ==<br />
<br />
V tomto příkladu odesílá SDS dotaz (textový název domény) na DNS server a zobrazuje případnou získanou odpověď (IP adresu).<br />
<br />
<pre><br />
void main(void)<br />
{<br />
char DNSname[96];<br />
unsigned int status;<br />
unsigned int IP0, IP1, IP2, IP3;<br />
<br />
sprintf((char *)DNSname, "www.google.com");<br />
<br />
printf("RESOLVING %s \n", DNSname);<br />
<br />
// start - select the new DNSname for all the subsequent status function calls<br />
dns_resolv(DNSname);<br />
<br />
// get the first status value<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
// only if truly working, keep waiting<br />
while (512 == status)<br />
{<br />
// keep getting a new status, until it is different than 512<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
}<br />
<br />
// check the final status value<br />
if (513 == status)<br />
{<br />
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);<br />
// only in this case, we can use the IPx address<br />
// ... OK<br />
<br />
// we can print the additional internal DNS cache status, for this particular domain<br />
// note. the value is valid only if the status is 512, otherwise not<br />
unsigned int ttl;<br />
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item <br />
printf("REMAINING DNS-CACHE TTL-VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);<br />
} else<br />
{<br />
printf("DNS RESOLV FAILED (error %u) \n", status);<br />
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again<br />
}<br />
<br />
}<br />
</pre><br />
<br />
== Interní DNS cache ==<br />
<br />
Po úspěšném provedení získání DNS překladu, kdy SDS odešle dotaz na určený DNS server, a získá z něj odpověď, <br />
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).<br />
<br />
Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().<br />
<br />
Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS, přičemž z odpovědi je převzata i položka TTL pro danou položku.<br />
<br />
Pokud je (v interní cache) existující položka, se svou zbývající hodnotou TTL větší než 0, bude ihned k dispozici odpověď z interní cache.<br />
<br />
Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.<br />
<br />
Toto si řídí SDS interně.<br />
<br />
Každou 1 sekundu dojde ke snížení zbývajících hodnot TTL u všech záznamů v interní cache.<br />
<br />
Systémová proměnná na indexu [72] umožňuje limitovat počáteční hodnotu TTL, která přijde v odpovědi z DNS serveru. Nastavte si to při startu svého FULLC programu dle své potřeby. Poznámka: v případě, že přijde odpověď s položkou s TTL=0, pak je v SDS zapsána tato položka do interní DNS cache s výchozí dobou platnosti dva týdny (TTL nastaveno na 1209600 sekund).<br />
<br />
<br />
Váš program tedy vždy, když potřebuje IP adresu pro jakoukoliv doménu, tak vždy musí nejprve zavolat dns_resolv(). Tím se jednak vybere aktuální doména, pro kterou chcete získat platnou aktuální IP adresu (a lze ji tedy přečíst pomocí dns_resolv_status() funkce), a také se zkontroluje platnost položky v interní cache pro danou doménu a eventuálního odeslání nového dotazu (pokud záznam v cache není, nebo už je neplatný).<br />
<br />
Nový dotaz není odeslán automaticky (tedy SDS neodešle nový dotazy na server), pokud položka v interní DNS cache je stále platná. Toto máte pod kontrolou vy, a to tak, že voláte funkci dns_resolv(), která se teprve v ten moment (kdy ji ze svého programu zavoláte) rozhodne, jestli tedy bude nový dotaz posílat, nebo ne (čistě dle stavu obsahu interní DNS cache). Pokud v cache není záznam pro danou doménu, nebo je - ale už vypršel (TTL na nule), tak dojde k odeslání dotazu, a váš program pak musí čekat na odpověď (viz příklad výše, periodickým voláním dns_resolv_status(), kdy se průběžně zařídí dle vrácené hodnoty od této funkce).<br />
<br />
Hodnota na indexu [71] ukazuje, kdy dorazila platná a očekávaná odpověď (paket) z DNS serveru. Pokud nedorazila, je hodnota na 0. Pokud odpověď dorazila (pro daný dotaz, položený posledním voláním funkce dns_resolv), tak je do indexu [71] zapsána časová známka (UTC čas) momentu, kdy byla odpověď přijata (kdy byl paket ze serveru akceptován). Pomocí sledování indexu [71] můžete nezávisle kontrolovat činnost DNS resolveru v zařízení SDS. Např. při výpadku síťové komunikace (např. odpojení kabelu, porucha sítě atd.), kdy současně časem dojde k vypršení položek v interní cache (to lze sledovat pomocí indexu [70]), pak pokud nový dotaz nebude zodpovězen (protože nebude možná komunikace s DNS serverem), tak se hodnota v [71] ukáže jako nulová. Samozřejmě vždy jsou ve všech zde zmíněných indexech k dispozici hodnoty pouze pro ten doménový název, který jste jako poslední použili při zavolání funkce dns_resolv(), a ostatní jsou uchovány v interní cache (pokud už byly dříve přeloženy).<br />
<br />
<br />
== Upozornění ==<br />
<br />
Starší FW mělo bug, kdy při vypršení TTL v interní cache nedošlo ke smazání položky v interni cache. Toto je samozřejmě problém, který je vyřešen v novém firmware, všechny verze od 08/2025.<br />
<br />
DNS cache je (záměrně) vymazána při:<br />
* nahrání nového FULLC programu<br />
* restartu zařízení SDS<br />
<br />
DNS cache není vymazána při výpadku Ethernetového připojení.<br />
<br />
DNS cache lze ručně vymazat zapsáním hodnoty 0xE4A5ECAC do systémové proměnné na indexu [70]. Zápis této speciální hodnoty kompletně smaže interní DNS cache. Tato specifická funkcionalita vyžaduje aktuální firmware (bylo to přidáno až 08/2025).<br />
<br />
To, že je DNS cache vymazána, znamená pouze jedinou záležitost - a to, že při novém dotazu přes dns_resolv() dojde k nové komunikaci s DNS serverem, a SDS (resp. váš FULLC program) bude čekat na jeho novou, čerstvou odpověď. Ta jak přijde (a pokud bude platná), tak se uloží do interní DNS cache, a to po dobu hodnoty TTL (tuto dobu určuje DNS server ! a omezuje ji hodnota v indexu [72]). Další volání dns_resolv(), pak (dokud TTL pro danou doménu v interní cache nevyprší) jsou pak vyřízeny okamžitě, protože SDS nečeká na odpověď ze serveru, a váš FULLC program dostane odpověď ihned z interní cache (dokud té nevyprší TTL).<br />
<br />
GOOD PRACTICE: před každým opakovaným použitím IP adresy, která byla získána z DNS resolveru, je vhodné zavolat dns_resolv() pro danou doménu znovu. Pokud je výsledná adresa (výsledek překladu domény na IP adresu) stejná, je to také okamžitě potvrzeno. Pokud však mezitím došlo ke změně (DNS záznamu), tak se jedině takto dokáže tato změna projevit ! Pokud tedy periodicky voláte např. funkci http_get(), tak vždy před každým tímto voláním, musíte provést i celé kolečko s dns_resolv() pro danou doménu, se kterou takto chcete komunikovat. Pokud to neuděláte, časem se dostanete do obtížného problému, kdy daný cílový server už může být dávno na jiné IP adrese, ale váš program bude stále chodit na starou, neplatnou, a přestane fungovat.<br />
<br />
<br />
== Stavové hodnoty ==<br />
<br />
Program musí použít volání funkce '''dns_resolv_status''' pro zjištění okamžitého stavu. Dokud nezískáte finální stavovou hodnotu, musíte tuto funkci volat opakovaně (nezapomeňte na vlastní bezpečnostní timeout).<br />
<br />
dns_resolv_status() význam<br />
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------<br />
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)<br />
512 | pracuje, dotaz odeslán (překlad nenalezen v interní cache), čekejte (funkce současně nevrací platnou IP adresu, ta bude až po dokončení překladu)<br />
513 | hotovo OK, do *resolvedIPaddressOutput byla zapsána IP adresa (4 bajty), a záznam v interní cache je platný a živý (zbývající TTL větší než 0)<br />
514 | odpověď nebyla získána (chyba) a současně nemáme záznam v interní DNS cache, takže funkce nevrací platnou IP adresu (musíte znovu začít s dotazem)<br />
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu<br />
516 | dotaz selhal, protože došlo k odpojení Ethernetu<br />
517 | dotaz selhal, protože došlo ke ztrátě vlastní přidělené IP adresy zařízení SDS (typicky když vyprší IP z DHCP a není ještě obnovena)<br />
<br />
<br />
Pokud funkce dns_resolv_status() vrátila hodnotu 513, je možné číst systémovou proměnnou z indexu [70] (uint32_t), která ukáže hodnotu TTL v momentu, kdy tuto hodnotu právě čtete. Lze takto sledovat, jak se postupně TTL snižuje (o 1 každou sekundu). Hodnota TTL odpovídá dané položce v interní cache, která byla určena právě posledním voláním funkce dns_resolv().</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_set_and_get&diff=956FULL-C: set and get2025-08-10T16:22:06Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Jak je FULL-C program připojen k hardware ==<br />
<br />
Základním důvodem pro existenci FULL-C programu na zařízení SDS je možnost číst stav hardware (např. opto-vstupy) a také hardware řídit (např. spínat relé).<br />
<br />
Za tímto účelem je k dispozici sada C funkcí, které může program volat a které buď navrátí aktuální stav ("get" funkce), nebo stav změní ("set" funkce).<br />
<br />
Zde je seznam těchto funkcí:<br />
<pre><br />
void SDS_set_i32(unsigned int index, signed int value);<br />
signed int SDS_get_i32(unsigned int index);<br />
<br />
void SDS_set_i64(unsigned int index, int64_t value);<br />
signed int SDS_get_i64(unsigned int index);<br />
<br />
void SDS_set_u32(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u32(unsigned int index);<br />
<br />
void SDS_set_u64(unsigned int index, uint64_t value);<br />
unsigned int SDS_get_u64(unsigned int index);<br />
<br />
void SDS_set_f32(unsigned int index, float value);<br />
float SDS_get_f32(unsigned int index);<br />
<br />
void SDS_set_a(unsigned int index, void *ptr, unsigned int len);<br />
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);<br />
</pre><br />
<br />
Historicky zde původně byly i tyto funkce:<br />
<pre><br />
void SDS_set_i(unsigned int index, signed int value);<br />
signed int SDS_get_i(unsigned int index);<br />
<br />
void SDS_set_u(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u(unsigned int index);<br />
</pre><br />
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32). <br />
Pokud je váš program používá, vše vám bude fungovat i nadále, ale co nejdříve jejich název ve svém programu přepište na nový.<br />
<br />
<br />
=== Detailní Příklady ===<br />
<br />
Přečtěte si nejprve celou tuto stránku, ať pochopíte princip. Následně se podívejte na [[FULL-C:_set_and_get:_detailed|jednotlivé příklady zde]].<br />
<br />
<br />
== Princip ==<br />
<br />
Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.<br />
<br />
Pod každou položkou (číselným '''index'''em) je schována odpovídající činnost nebo hodnota (např. '''index = 3''' vrátí přes "get" funkci aktuální hodnotu "UpTime", viz tabulka).<br />
<br />
Každá položka však může mít jiný obsah (číslo nebo text): podle toho je potřeba zvolit správný přístup (správnou set\get funkci):<br />
<br />
typ položky | rozsah | typ proměnné | postfix set\get funkce<br />
--------------------------+----------------+-----------------+-------------------------<br />
signed 32-bit integer | -2^31..+2^31 | int | _i32<br />
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32<br />
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64<br />
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64<br />
IP address | uchar[4] | unsigned int | _u32<br />
float | IEEE-754 | float | _f32<br />
string (text) | len\maxlen | void* \ char* | _a<br />
binary array | len\maxlen | void* \ char* | _a<br />
<br />
Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.<br />
<br />
Příklad: chceme zapsat desetinné číslo "numf", v tom případě se jedná o typ "float numf;" a musíme použít ''SDS_set_f(index, numf);''.<br />
<br />
<br />
Varování: ačkoliv je většina indexů podobných jako u SDS (pro pole ''sys[]''), nemají všechny indexy stejný význam mezi SDS-C a FULL-C. Vždy používejte tu správnou tabulku pro každý programovací jazyk.<br />
<br />
<br />
== Funkce _u32 \ _i32 \ _f32 ==<br />
<br />
Základní funkce určené pro získání číselné hodnoty "z" SDS, popř. zápisu číselné hodnoty "do" SDS. Vždy se jedná o kombinaci ''index''u (který určuje o co máme zájem) a hodnoty (která je vždy 32 bitová, tj. 4 bajty, ale obsah těchto 4 bajtů už je různý - buď celočíselná hodnota bez nebo se znaménkem (nejvyšší bit), nebo desetinné číslo - floating point).<br />
<br />
Čtení hodnoty je potřeba pro zjištění aktuálního stavu (např. stav optického vstupu, nebo poslední známá teplota z čidla). Zápis se pak používá pro ovládání (např. sepnutí relé).<br />
<br />
<br />
První příklad: ''čtení'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
unsigned int NTPtime;<br />
NTPtime = SDS_get_u32(4);<br />
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);<br />
</syntaxhighlight><br />
<br />
Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem<br />
<syntaxhighlight lang="c"><br />
int NTPoffset;<br />
NTPoffset = SDS_get_i32(26);<br />
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);<br />
</syntaxhighlight><br />
<br />
Třetí příklad: ''čtení'' float hodnoty<br />
<syntaxhighlight lang="c"><br />
float AD_Rinput__in_user_units;<br />
AD_Rinput__in_user_units = SDS_get_f32(311);<br />
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);<br />
</syntaxhighlight><br />
<br />
Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)<br />
SDS_set_u32(231, 0xFF); <br />
</syntaxhighlight><br />
<br />
Samozřejmě musíte pro každý index použít správný typ hodnoty (tzn.: ''unsigned int'' \ ''int'' \ ''float''). Přesné přiřazení naleznete v tabulce na konci této stránky.<br />
<br />
Pozn.: i když například víte, že hodnota může být například jenom 0 nebo 1 (příklad), tak vždy se zapisuje nebo čte všech 32bitů (unsigned int \ int \ float). Nepoužité bity jsou vždy nastaveny na nulu.<br />
<br />
<br />
== Funkce _u64 \ _i64 ==<br />
<br />
Princip je identický jako pro _u32 a _i32 funkce. <br />
<br />
Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.<br />
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.<br />
<br />
<br />
== Funkce _a ==<br />
<br />
Funkce pracující s polem dat (''SDS_get_a'', ''SDS_set_a'') vyžadují oproti ostatním set+get funkcím specifické parametry. Vždy se jedná o ukazatel na pole dat, a o informaci o velikosti tohoto pole.<br />
<br />
<br />
První příklad: čtení textového parametru<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00<br />
char sysLoc[32];<br />
<br />
// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů<br />
SDS_get_a(2, (void *)sysLoc, 32);<br />
<br />
// a můžeme se podívat na výsledek (výpis do konzole)<br />
printf("Nastavená system location: %s \n", sysLoc);<br />
</syntaxhighlight><br />
<br />
<br />
Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)<br />
unsigned int OPTOvalues[8];<br />
<br />
// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues<br />
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech<br />
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);<br />
<br />
// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)<br />
if (0 == OPTOvalues[0]) ...<br />
</syntaxhighlight><br />
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.<br />
<br />
<br />
Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.<br />
<br />
<br />
<br />
== Úplné detaily a všechny příklady ==<br />
<br />
<br />
<br />
'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.<br />
<br />
<br />
<br />
== Tabulka ==<br />
<br />
Podle typu každé položky lze použít jen právě tu danou specifickou funkci (_i32\_u32\_f32\_a\_i64\_u64), viz následující tabulka. <br />
<br />
Je li také uveden klíč "(a)", lze mimo přístup k jedinému indexu využít blokový přístup pomocí funkce SDS_get_a(), která přečte určený počet indexů za sebou a uloží je do připraveného pole (toho se využívá při blokovém čtení většího počtu za-sebou ležících položek, např. blokové čtení stavu všech optovstupů atd.).<br />
<br />
<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
index | i\u\f\a | dir | comment<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)<br />
0 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)<br />
1 | | SET | n/a<br />
-----------+---------+------+--<br />
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)<br />
2 | a | GET | sysLocation (user configured text)<br />
2 | | SET | n/a<br />
-----------+---------+------+--<br />
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)<br />
3 | | SET | n/a<br />
-----------+---------+------+--<br />
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds<br />
4 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)<br />
5 | | SET | n/a<br />
-----------+---------+------+--<br />
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)<br />
6 | | SET | n/a<br />
-----------+---------+------+--<br />
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)<br />
7 | | SET | n/a<br />
-----------+---------+------+--<br />
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)<br />
8 | | SET | n/a<br />
-----------+---------+------+--<br />
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)<br />
9 | | SET | n/a<br />
-----------+---------+------+--<br />
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)<br />
10 | | SET | n/a<br />
-----------+---------+------+--<br />
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)<br />
11 | | SET | n/a<br />
-----------+---------+------+--<br />
12 | u32 | GET | SDS device IP address (web admin IP)<br />
12 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
13..15 | | GET | n/a (reserved)<br />
13..15 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
16 | u32 | GET | network gateway IP address<br />
16 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
17..19 | | GET | n/a (reserved)<br />
17..19 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
20 | u32 | GET | network IP MASK<br />
20 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)<br />
21 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
22 | u32 | GET | SNMPv3 - Engine Boots <br />
22 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
23 | u32 | GET | SNMPv3 - Engine Time <br />
23 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
24 | u32 | GET | Ethernet Link Status<br />
24 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)<br />
25 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time<br />
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)<br />
-----------+---------+------+--<br />
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)<br />
27 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
28 | u32 | GET | timestamp of last change (assignment) of IP address <br />
28 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)<br />
29 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
30 | u32 | GET | DHCP lease time (secs) value<br />
30 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)<br />
31 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
32 | u32 | GET | MAC[1]<br />
32 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
33 | u32 | GET | MAC[2]<br />
33 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
34 | u32 | GET | MAC[3]<br />
34 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
35 | u32 | GET | MAC[4]<br />
35 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
36 | u32 | GET | MAC[5]<br />
36 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
37..39 | | GET | n/a (reserved)<br />
37..39 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)<br />
40 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
41 | a | GET | OEM branding (login web page) [32 chars]<br />
41 | a | SET | set custom OEM branding (login web page) [32 chars]<br />
-----------+---------+------+--<br />
42 | a | GET | OEM branding (welcome web page) [128 chars]<br />
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]<br />
-----------+---------+------+--<br />
43 | u32 | GET | NTP-server IP address<br />
43 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
44 | u32 | GET | NTP-client status (0 = NOT synchronized)<br />
44 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)<br />
45 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)<br />
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)<br />
46 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
48..60 | | GET | n/a (reserved)<br />
48..60 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)<br />
61 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
62..63 | | GET | n/a (reserved)<br />
62..63 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
64 | u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #0 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0<br />
-----------+---------+------+--<br />
65 | u32 | GET | get state of the DST automatic (0 = not used) (1 = DST used and DST shift is applied) (2 = DST used but NO shift applied)<br />
65 | u32 | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
66 | u32 | GET | DNS-server IP address<br />
66 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)<br />
67 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)<br />
68 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
69 | | GET | n/a (reserved) <br />
69 | | SET | n/a (reserved) <br />
-----------+---------+------+--<br />
70 | u32 | GET | DNS RESOLV - actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
70 | u32 | SET | write 0xE4A5ECAC to manually clear the WHOLE internal DNS cache (will force fresh DNS requests once dns_resolv() is again called by your program)<br />
-----------+---------+------+--<br />
71 | u32 | GET | DNS RESOLV - timestamp (UTC) of the latest DNS server response (packet) as requested by dns_resolv() function (if 0 then no response received, or cache has expired)<br />
71 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
72 | u32 | GET | DNS RESOLV - get the last set hard TTL limit (0 = invalid (will use 1209600 as default), otherwise 1..MAX = time in seconds)<br />
72 | u32 | SET | DNS RESOLV - set the hard TTL value limit (in seconds)<br />
-----------+---------+------+--<br />
73..77 | | GET | n/a (reserved) <br />
73..77 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs<br />
78 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)<br />
79 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84<br />
80 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
81..84 | | GET | n/a (reserved) <br />
81..84 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2<br />
85 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)<br />
86 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program<br />
87 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
88 | | GET | n/a (reserved) <br />
88 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)<br />
89 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)<br />
90 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
91 | u32 | GET | SDS IP-WatchDog: logical output status<br />
91 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
92..131 | | GET | n/a (reserved)<br />
92..131 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
132 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
133 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
134 | a | GET | FC: archived text of the last FC error<br />
134 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)<br />
135 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot<br />
136 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
137 | u32 | GET | read an actual SDS CPU cycle counter (number of executed instructions since power-up/reboot), continuously wraps around, (1 step = approx. 2 nsec)<br />
137 | | SET | n/a<br />
-----------+---------+------+--<br />
138 | u32 | GET | get SDS internal RTC power-on status (0 = invalid data after powerup in RTC) (1 = RTC data OK and were used on powerup) <br />
138 | | SET | n/a<br />
-----------+---------+------+--<br />
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied<br />
139 | | SET | n/a<br />
-----------+---------+------+--<br />
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)<br />
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)<br />
-----------+---------+------+--<br />
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)<br />
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)<br />
-----------+---------+------+--<br />
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)<br />
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)<br />
-----------+---------+------+--<br />
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)<br />
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)<br />
-----------+---------+------+--<br />
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)<br />
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)<br />
-----------+---------+------+--<br />
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)<br />
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)<br />
-----------+---------+------+--<br />
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)<br />
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)<br />
-----------+---------+------+--<br />
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)<br />
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)<br />
-----------+---------+------+--<br />
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)<br />
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)<br />
-----------+---------+------+--<br />
149 | | GET | n/a (reserved)<br />
149 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
150 | | GET | FC: shared-variables access control - read state of the access control<br />
150 | | SET | FC: shared-variables access control - use this to force a user-login in order to access the shared variables (0 = access without login is enabled)<br />
-----------+---------+------+--<br />
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)<br />
151..182 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
183 | u32 | GET | SDS FW date stamp (or just 0x00000000 for a very old firmware) - use this to verify the features or to ask user to update the firmware to a required newer version<br />
183 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
184 | u32 | GET | FC: information about how this actual running program was started (0 = none) (1 = normal) (2 = fc-wdg or manual restart) (4 = freshly loaded)<br />
184 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec<br />
185 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)<br />
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])<br />
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
188 | u32 | GET | PWM3 HW: direct "pulse" register value<br />
188 | | SET | n/a<br />
-----------+---------+------+--<br />
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])<br />
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
190 | u32 | GET | PWM4 HW: direct "pulse" register value<br />
190 | | SET | n/a<br />
-----------+---------+------+--<br />
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)<br />
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])<br />
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value<br />
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value <br />
-----------+---------+------+--<br />
194 | u32 | GET | reserved<br />
194 | | SET | N/A<br />
-----------+---------+------+--<br />
195 | u32 | GET | reserved<br />
195 | | SET | N/A<br />
-----------+---------+------+--<br />
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output<br />
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)<br />
-----------+---------+------+--<br />
229..230 | | GET | n/a (reserved)<br />
229..230 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)<br />
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)<br />
-----------+---------+------+--<br />
263..265 | | GET | n/a (reserved)<br />
263..265 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)<br />
266..297 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
298..300 | | GET | n/a (reserved)<br />
298..300 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin<br />
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)<br />
-----------+---------+------+--<br />
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin<br />
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)<br />
-----------+---------+------+--<br />
303..310 | | GET | n/a (reserved)<br />
303..310 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input<br />
311..342 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
343..374 | a | GET | AD: input identification / name (text)<br />
343..374 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
375..406 | a | GET | AD: input unit name (text)<br />
375..406 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
407..427 | | GET | n/a (reserved)<br />
407..427 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV) <br />
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW<br />
-----------+---------+------+--<br />
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)<br />
429 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)<br />
430 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)<br />
431..438 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant<br />
439..446 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
447..462 | | GET | n/a (reserved)<br />
447..462 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]<br />
463..469 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]<br />
470..476 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]<br />
477..483 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]<br />
484..490 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]<br />
491..497 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]<br />
498..504 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]<br />
505..511 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]<br />
512..518 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
519..991 | | GET | n/a (reserved)<br />
519..991 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)<br />
992 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
993 | u32 | GET | UTC timestamp (localtime) marking a start of yesterday (as a moment since when we capture a new record) (or 0 = if there is no record for yesterday)<br />
993 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
994 | u32 | GET | UTC timestamp (localtime) marking a start of today (or a moment of SDS power on), since when a today's record is captured<br />
994 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])<br />
995 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])<br />
996 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active<br />
997 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active<br />
998 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)<br />
999 | u32 | SET | "manual" control of the global Tariff Input (write/control enabled only if the feature is set in web admin - control set to FULL-C)<br />
-----------+---------+------+--<br />
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff<br />
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff<br />
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses<br />
1064..1095| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse<br />
1096..1127| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1128..1159| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1160..1191| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1192..1223| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1224..1255| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1256..1499| | GET | n/a (reserved)<br />
1256..1499| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1500..1531| a | GET | [S0-input] master configuration struct for this input<br />
1500..1531| a | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1532..1999| | GET | n/a (reserved)<br />
1532..1999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status<br />
2000..2063| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device<br />
2100..2163| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)<br />
2200..2263| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)<br />
2300..2363| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2364..2487| | GET | n/a (reserved)<br />
2364..2487| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)<br />
2488..2495| | SET | n/a <br />
-----------+---------+------+--<br />
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)<br />
2496 | | SET | n/a<br />
-----------+---------+------+--<br />
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)<br />
2497 | | SET | n/a<br />
-----------+---------+------+--<br />
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)<br />
2498 | | SET | n/a<br />
-----------+---------+------+--<br />
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)<br />
2499 | | SET | n/a<br />
-----------+---------+------+--<br />
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status<br />
2500..2563| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device<br />
2600..2663| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)<br />
2700..2763| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)<br />
2800..2863| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2864..2986| | GET | n/a (reserved)<br />
2864..2986| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)<br />
2986..2993| | SET | n/a <br />
-----------+---------+------+--<br />
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)<br />
2994 | | SET | n/a<br />
-----------+---------+------+--<br />
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)<br />
2995 | | SET | n/a<br />
-----------+---------+------+--<br />
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)<br />
2996 | | SET | n/a<br />
-----------+---------+------+--<br />
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)<br />
2997 | | SET | n/a<br />
-----------+---------+------+--<br />
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user<br />
2998 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)<br />
2999 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3000 | | GET | n/a (reserved)<br />
3000 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)<br />
3001 | a | SET | write<br />
-----------+---------+------+--<br />
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)<br />
3002 | a | SET | write<br />
-----------+---------+------+--<br />
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)<br />
3003 | a | SET | write<br />
-----------+---------+------+--<br />
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)<br />
3004 | a | SET | write<br />
-----------+---------+------+--<br />
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)<br />
3005 | a | SET | write<br />
-----------+---------+------+--<br />
3006..3799| | GET | n/a (reserved)<br />
3006..3799| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected<br />
3800 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801<br />
3801 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3802..3849| | GET | n/a (reserved)<br />
3802..3849| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3850 | u32 | GET | SD Card - fully mounted and useable<br />
3850 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3851 | i32 | GET | latest file i/o error code<br />
3851 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)<br />
3852 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3853 | u32 | GET | SD Card - CardType<br />
3853 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3854 | u32 | GET | SD Card - CID - ProductSN<br />
3854 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)<br />
3855 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3856 | u32 | GET | statistic counter: SDcard: failed init attempts<br />
3856 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)<br />
3857 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3858 | u32 | GET | statistic counter: SDcard: sector reads<br />
3858 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3859 | u32 | GET | statistic counter: SDcard: sector writes<br />
3859 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures<br />
3860 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3861 | u32 | GET | statistic counter: number of opened files<br />
3861 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3862..3999| | GET | n/a (reserved)<br />
3862..3999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read<br />
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write<br />
-----------+---------+------+--<br />
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read<br />
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write<br />
-----------+---------+------+--<br />
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read<br />
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write<br />
-----------+---------+------+--<br />
4300..4399| a | GET | Shared Variables: T00 through T99 - read<br />
4300..4399| a | SET | Shared Variables: T00 through T99 - write<br />
-----------+---------+------+--<br />
4400..4989| | GET | n/a (reserved)<br />
4400..4989| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4990..4999| u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #1..#10 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10<br />
-----------+---------+------+--<br />
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write<br />
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read<br />
-----------+-+-------+------+--<br />
5128..11197 | | GET | n/a (reserved)<br />
5128..11197 | | SET | n/a (reserved)<br />
-----------+-+-------+------+--<br />
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ) <br />
11198 | u32 | SET | write ( default: 0b00110001 )<br />
-----------+---------+------+--<br />
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)<br />
11199 | | SET | n/a<br />
-----------+---------+------+--<br />
12200 | i32 | GET | work progress (and result) of mqtt_connect()<br />
12200 | | SET | n/a <br />
-----------+---------+------+--<br />
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()<br />
12201 | | SET | n/a <br />
-----------+---------+------+--<br />
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
12202 | | SET | n/a <br />
-----------+---------+------+--<br />
12203 | i32 | GET | MQTT protocol error counter (informative)<br />
12203 | | SET | n/a <br />
-----------+--+------+------+--<br />
12204..12208 | | GET | n/a (reserved)<br />
12204..12208 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12209 | i32 | GET | Subscribe Table - total number of available rows<br />
12209 | | SET | n/a <br />
-----------+---------+------+--<br />
12210 | a | GET | latest received Topic Name (sent from broker)<br />
12210 | | SET | n/a <br />
-----------+--+------+------+--<br />
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row<br />
12211..12241 | | SET | n/a<br />
--------------+------+------+--<br />
12242..12249 | | GET | n/a (reserved)<br />
12242..12249 | | SET | n/a<br />
-----------+--+------+------+--<br />
12250 | a | GET | latest received Value (sent from broker)<br />
12250 | | SET | n/a <br />
-----------+--+------+------+--<br />
12251..12281 | a | GET | Subscribe Table: actual Value for each table row<br />
12251..12281 | | SET | n/a<br />
--------------+------+------+--<br />
12282..12289 | | GET | n/a (reserved)<br />
12282..12289 | | SET | n/a<br />
-----------+--+------+------+--<br />
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker<br />
12290 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row<br />
12291..12321 | | SET | n/a<br />
--------------+------+--+---+--+--<br />
12322..12398 | | GET | n/a (reserved)<br />
12322..12398 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)<br />
12399 | | SET | n/a <br />
-----------+---------+------+--<br />
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()<br />
12400 | | SET | n/a <br />
-----------+---------+------+--<br />
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
12401 | | SET | n/a <br />
-----------+---------+------+--<br />
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
12402 | | SET | n/a <br />
-----------+---------+------+--<br />
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
12403 | | SET | n/a <br />
-----------+---------+------+--<br />
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
12404 | | SET | n/a <br />
-----------+---------+------+--<br />
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
12405 | | SET | n/a <br />
-----------+---------+------+--<br />
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
12406 | | SET | n/a <br />
-----------+--+------+------+--<br />
12407..12414 | | GET | n/a (reserved)<br />
12407..12414 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
12415 | | SET | n/a <br />
-----------+---------+------+--<br />
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
12416 | | SET | n/a <br />
-----------+--+------+------+--<br />
12417..12462 | | GET | n/a (reserved)<br />
12417..12462 | | SET | n/a (reserved) <br />
-----------+--+------+------+--<br />
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)<br />
12463 | | SET | n/a <br />
-----------+---------+------+--<br />
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)<br />
12464 | | SET | n/a <br />
-----------+---------+------+--<br />
12465 | u/i 32 | GET | timestamp of the latest received message<br />
12465 | | SET | n/a <br />
-----------+---------+------+--<br />
12466 | u/i 32 | GET | a count of received items inside the latest received message<br />
12466 | | SET | n/a <br />
-----------+---------+------+--<br />
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)<br />
12467 | | SET | n/a <br />
-----------+---------+------+--<br />
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)<br />
12468 | | SET | n/a <br />
-----------+---------+------+--<br />
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)<br />
12469 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12470..12719 | i32 (a) | GET | received values (latest received message contents)<br />
12470..12719 | | SET | n/a <br />
--------------+---------+------+--<br />
<br />
<br />
<br />
'''Poznámky''' <br />
<br />
Položky obsahující: "konfigurační struktura" vyžadují dostatečně velký prostor pro uložení výsledku (při zavolání SDS_get_a() funkce). V takovém případě se do vámi určené cílové oblasti ukládá celý "struct" který obsahuje všechny potřebné údaje patřící pod danou položku (názvy, hodnoty, atd.). Pro detaily je nejlépe podívat se přímo na aktuální [[FULL-C:_set_and_get:_detailed|příklady]], které přesně popisují postup pro každý typ takové struktury - a vysvětlují tuto poznámku svým kódem.<br />
<br />
Indexy označené jako '''(a)''' lze ''blokově číst'' (pozor, označené specificky jako "a v závorce"). Vždy ale lze ''blokové čtení'' (tj. čtení více indexů najednou, za sebou, v rámci povoleného rozsahu) provést pouze od prvního indexu v bloku (ne od dalších v bloku).<br />
Příklad: indexy 1000 až 1031 lze přečíst jako jeden souvislý blok, když se začne číst od prvního indexu v bloku (tj. 1000). Počet následně čtených indexů se udává dalším parametrem při volání SDS_get_a() funkce.<br />
Pokud se pokusíte číst blok indexů ne od začátku bloku, čtení selže - pokud blok indexů začíná na 1000 tak musíte požádat o čtení od indexu 1000, přičemž začátek od 1001 a výše selže.<br />
<br />
BackUp-RAM funkce je dostupná je pro firmware který poskytuje verzi FULL-C o hodnotě 0x08 nebo novější. BackUp-RAM je sada 32-bit hodnot, které lze zapisovat a číst, a které jsou (především) uchovány v paměti, která je zálohovaná baterií (tzn. drží hodnotu i po výpadku napájení, tak dlouho než se baterie vybije). Výhodou BackUp-RAM oproti DF je možnost přímého přístupu a rychlosti (naopak DF vyžaduje čtení a zápis celých stránek).<br />
<br />
Sdílené proměnné je potřeba nejprve definovat, aby je šlo použít, a aby k nim šlo přistupovat přes set/get funkce - viz specifická stránka na této wiki.<br />
<br />
Detaily (významy hodnot) pro položky ''MQTT klient'' a ''MODBUS-TCP klient'' jsou rozepsány na příslušných odpovídajících stránkách na této wiki.<br />
<br />
<br />
'''Vysvětlení položek'''<br />
<br />
V tabulce výše jsou uvedeny informace, které naleznete na jednotlivých indexech. Nicméně popisy uvedené v této tabulce jsou velmi zkrácené, a je k nim tedy potřeba mnohem širší vysvětlení.<br />
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).<br />
<br />
<br />
'''Vstupy pro měření napětí'''<br />
<br />
Detaily k A/D vstupům jsou uvedeny [[SDS_2PR:_ADC_vstupy_a_kalibrace|zde]]. Pro psaní programu je důležité mapování '''index'''u na jednotlivé vstupy, viz [[SDS_2PR:_ADC_vstupy_a_kalibrace|tabulka]].<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C_dns_resolv_functions&diff=955FULL-C dns resolv functions2025-08-10T09:55:51Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==<br />
__NOTOC__<br />
<br />
Zařízení SDS umožňuje odeslat dotaz na DNS server, za účelem zjištění IP adresy přidělené k DNS názvu, který je obsahem právě takového dotazu.<br />
<br />
Za tímto účelem jsou k dispozici tyto dvě funkce:<br />
<pre><br />
void dns_resolv(char *domainNameInput);<br />
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);<br />
</pre><br />
<br />
== Princip ==<br />
<br />
SDS odesílá dotaz na DNS server, který je nastaven uživatelem SDS ve webové administraci zařízení (popř. je adresa DNS serveru získána z DHCP serveru, opět záleží na konfiguraci).<br />
<br />
Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.<br />
<br />
<br />
'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''<br />
<br />
<br />
== Příklad ==<br />
<br />
V tomto příkladu odesílá SDS dotaz (textový název domény) na DNS server a zobrazuje případnou získanou odpověď (IP adresu).<br />
<br />
<pre><br />
void main(void)<br />
{<br />
char DNSname[96];<br />
unsigned int status;<br />
unsigned int IP0, IP1, IP2, IP3;<br />
<br />
sprintf((char *)DNSname, "www.google.com");<br />
<br />
printf("RESOLVING %s \n", DNSname);<br />
<br />
// start - select the new DNSname for all the subsequent status function calls<br />
dns_resolv(DNSname);<br />
<br />
// get the first status value<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
// only if truly working, keep waiting<br />
while (512 == status)<br />
{<br />
// keep getting a new status, until it is different than 512<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
}<br />
<br />
// check the final status value<br />
if (513 == status)<br />
{<br />
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);<br />
// only in this case, we can use the IPx address<br />
// ... OK<br />
<br />
// we can print the additional internal DNS cache status, for this particular domain<br />
// note. the value is valid only if the status is 512, otherwise not<br />
unsigned int ttl;<br />
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item <br />
printf("REMAINING DNS-CACHE TTL-VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);<br />
} else<br />
{<br />
printf("DNS RESOLV FAILED (error %u) \n", status);<br />
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again<br />
}<br />
<br />
}<br />
</pre><br />
<br />
== Interní DNS cache ==<br />
<br />
Po úspěšném provedení získání DNS překladu, kdy SDS odešle dotaz na určený DNS server, a získá z něj odpověď, <br />
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).<br />
<br />
Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().<br />
<br />
Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS. <br />
<br />
Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.<br />
<br />
Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.<br />
<br />
Toto si řídí SDS interně.<br />
<br />
Váš program tedy vždy, když potřebuje IP adresu pro jakoukoliv doménu, tak vždy musí nejprve zavolat dns_resolv(). Tím se jednak vybere aktuální doména, pro kterou chcete získat platnou aktuální IP adresu (a lze ji tedy přečíst pomocí dns_resolv_status() funkce), a také se spustí mechanismus kontroly interní cache a eventuálního odeslání nového dotazu.<br />
<br />
Nový dotaz není odeslán automaticky, tedy SDS samo neodesílá nové dotazy, když položka v interní DNS cache vyprší. Toto máte plně pod kontrolou vy, a to tak, že voláte funkci dns_resolv(), která se teprve v ten moment (kdy ji ze svého programu zavoláte) rozhodne, jestli bude nový dotaz posílat, nebo ne (čistě dle stavu obsahu interní DNS cache). Pokud v cache není záznam pro danou doménu, nebo je ale už vypršel (TTL na nule), tak dojde k odeslání dotazu, a váš program pak musí čekat na odpověď (viz příklad výše, periodickým voláním dns_resolv_status(), kdy se průběžně zařídí dle vrácené hodnoty od této funkce).<br />
<br />
Hodnota na indexu [71] ukazuje, kdy dorazila platná a očekávaná odpověď (paket) z DNS serveru. Pokud nedorazila, je hodnota na 0. Pokud odpověď dorazila (pro daný dotaz, položený posledním voláním funkce dns_resolv), tak je do indexu [71] zapsána časová známka (UTC čas) momentu, kdy byla odpověď přijata (paket ze serveru akceptován). Pomocí sledování indexu [71] můžete nezávisle kontrolovat činnost DNS resolveru v zařízení SDS. Např. při výpadku síťové komunikace (např. odpojení kabelu, porucha sítě atd.), dojde k vypršení položek v interní cache (to lze sledovat pomocí indexu [70]) a pokud nový dotaz nebude zodpovězen (nebude komunikace s DNS serverem), tak se hodnota v [71] ukáže jako nulová. Samozřejmě vždy jsou v těchto indexech k dispozici hodnoty pouze pro ten doménový název, který jste jako poslední použili při zavolání funkce dns_resolv().<br />
<br />
<br />
== Upozornění ==<br />
<br />
Starší FW mělo bug, kdy při vypršení TTL v interní cache nedošlo ke smazání položky v interni cache. Toto je samozřejmě problém, který je vyřešen v novém firmware, všechny verze od 08/2025.<br />
<br />
DNS cache je (záměrně) vymazána při:<br />
* nahrání nového FULLC programu<br />
* restartu zařízení SDS<br />
<br />
DNS cache není vymazána při výpadku Ethernetového připojení.<br />
<br />
DNS cache lze ručně vymazat zapsáním hodnoty 0xE4A5ECAC do systémové proměnné na indexu [70]. Zápis této speciální hodnoty kompletně smaže interní DNS cache. Tato specifická funkcionalita vyžaduje aktuální firmware (bylo to přidáno až 08/2025).<br />
<br />
To, že je DNS cache vymazána, znamená pouze jedinou záležitost - a to, že při novém dotazu přes dns_resolv() dojde ke komunikace s DNS serverem, a bude se čekat na jeho novou, čerstvou odpověď. Ta jak přijde (a bude platná), tak je uložena do cache, po dobu hodnoty TTL (tuto dobu určuje DNS server!). Další volání dns_resolv(), dokud TTL pro danou doménu v interní cache nevyprší, jsou pak vyřízeny okamžitě, protože se nečeká na odpověď ze serveru, ale FULLC program dostane odpověď ihned z interní cache.<br />
<br />
GOOD PRACTICE: před každým opakovaným použitím IP adresy, která byla získána z DNS resolveru, je vhodné zavolat dns_resolv() pro danou doménu znovu. Pokud je výsledná adresa (výsledek překladu domény na IP adresu) stejná, je to také okamžitě potvrzeno. Pokud však mezitím došlo ke změně (DNS záznamu), tak se jedině takto dokáže tato změna projevit ! Pokud tedy periodicky voláte např. funkci http_get(), tak vždy před každým tímto voláním, musíte provést i celé kolečko s dns_resolv() pro danou doménu, se kterou takto chcete komunikovat. Pokud to neuděláte, časem se dostanete do obtížného problému, kdy daný cílový server už může být dávno na jiné IP adrese, ale váš program bude stále chodit na starou, neplatnou, a přestane fungovat.<br />
<br />
<br />
== Stavové hodnoty ==<br />
<br />
Program musí použít volání funkce '''dns_resolv_status''' pro zjištění okamžitého stavu. Dokud nezískáte finální stavovou hodnotu, musíte tuto funkci volat opakovaně (nezapomeňte na vlastní bezpečnostní timeout).<br />
<br />
dns_resolv_status() význam<br />
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------<br />
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)<br />
512 | pracuje, dotaz odeslán (překlad nenalezen v interní cache), čekejte (funkce současně nevrací platnou IP adresu, ta bude až po dokončení překladu)<br />
513 | hotovo OK, do *resolvedIPaddressOutput byla zapsána IP adresa (4 bajty), a záznam v interní cache je platný a živý (zbývající TTL větší než 0)<br />
514 | odpověď nebyla získána (chyba) a současně nemáme záznam v interní DNS cache, takže funkce nevrací platnou IP adresu (musíte znovu začít s dotazem)<br />
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu<br />
516 | dotaz selhal, protože došlo k odpojení Ethernetu<br />
517 | dotaz selhal, protože došlo ke ztrátě vlastní přidělené IP adresy zařízení SDS (typicky když vyprší IP z DHCP a není ještě obnovena)<br />
<br />
<br />
Pokud funkce dns_resolv_status() vrátila hodnotu 513, je možné číst systémovou proměnnou z indexu [70] (uint32_t), která ukáže hodnotu TTL v momentu, kdy tuto hodnotu právě čtete. Lze takto sledovat, jak se postupně TTL snižuje (o 1 každou sekundu). Hodnota TTL odpovídá dané položce v interní cache, která byla určena právě posledním voláním funkce dns_resolv().</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C_dns_resolv_functions&diff=954FULL-C dns resolv functions2025-08-10T09:52:15Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==<br />
__NOTOC__<br />
<br />
Zařízení SDS umožňuje odeslat dotaz na DNS server, za účelem zjištění IP adresy přidělené k DNS názvu, který je obsahem právě takového dotazu.<br />
<br />
Za tímto účelem jsou k dispozici tyto dvě funkce:<br />
<pre><br />
void dns_resolv(char *domainNameInput);<br />
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);<br />
</pre><br />
<br />
== Princip ==<br />
<br />
SDS odesílá dotaz na DNS server, který je nastaven uživatelem SDS ve webové administraci zařízení (popř. je adresa DNS serveru získána z DHCP serveru, opět záleží na konfiguraci).<br />
<br />
Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.<br />
<br />
<br />
'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''<br />
<br />
<br />
== Příklad ==<br />
<br />
V tomto příkladu odesílá SDS dotaz (textový název domény) na DNS server a zobrazuje případnou získanou odpověď (IP adresu).<br />
<br />
<pre><br />
void main(void)<br />
{<br />
char DNSname[96];<br />
unsigned int status;<br />
unsigned int IP0, IP1, IP2, IP3;<br />
<br />
sprintf((char *)DNSname, "www.google.com");<br />
<br />
printf("RESOLVING %s \n", DNSname);<br />
<br />
// start - select the new DNSname for all the subsequent status function calls<br />
dns_resolv(DNSname);<br />
<br />
// get the first status value<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
// only if truly working, keep waiting<br />
while (512 == status)<br />
{<br />
// keep getting a new status, until it is different than 512<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
}<br />
<br />
// check the final status value<br />
if (513 == status)<br />
{<br />
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);<br />
// only in this case, we can use the IPx address<br />
// ... OK<br />
<br />
// we can print the additional internal DNS cache status, for this particular domain<br />
// note. the value is valid only if the status is 512, otherwise not<br />
unsigned int ttl;<br />
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item <br />
printf("DNS CACHE TTL VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);<br />
} else<br />
{<br />
printf("DNS RESOLV FAILED (error %u) \n", status);<br />
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again<br />
}<br />
<br />
}<br />
</pre><br />
<br />
== Interní DNS cache ==<br />
<br />
Po úspěšném provedení získání DNS překladu, kdy SDS odešle dotaz na určený DNS server, a získá z něj odpověď, <br />
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).<br />
<br />
Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().<br />
<br />
Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS. <br />
<br />
Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.<br />
<br />
Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.<br />
<br />
Toto si řídí SDS interně.<br />
<br />
Váš program tedy vždy, když potřebuje IP adresu pro jakoukoliv doménu, tak vždy musí nejprve zavolat dns_resolv(). Tím se jednak vybere aktuální doména, pro kterou chcete získat platnou aktuální IP adresu (a lze ji tedy přečíst pomocí dns_resolv_status() funkce), a také se spustí mechanismus kontroly interní cache a eventuálního odeslání nového dotazu.<br />
<br />
Nový dotaz není odeslán automaticky, tedy SDS samo neodesílá nové dotazy, když položka v interní DNS cache vyprší. Toto máte plně pod kontrolou vy, a to tak, že voláte funkci dns_resolv(), která se teprve v ten moment (kdy ji ze svého programu zavoláte) rozhodne, jestli bude nový dotaz posílat, nebo ne (čistě dle stavu obsahu interní DNS cache). Pokud v cache není záznam pro danou doménu, nebo je ale už vypršel (TTL na nule), tak dojde k odeslání dotazu, a váš program pak musí čekat na odpověď (viz příklad výše, periodickým voláním dns_resolv_status(), kdy se průběžně zařídí dle vrácené hodnoty od této funkce).<br />
<br />
Hodnota na indexu [71] ukazuje, kdy dorazila platná a očekávaná odpověď (paket) z DNS serveru. Pokud nedorazila, je hodnota na 0. Pokud odpověď dorazila (pro daný dotaz, položený posledním voláním funkce dns_resolv), tak je do indexu [71] zapsána časová známka (UTC čas) momentu, kdy byla odpověď přijata (paket ze serveru akceptován). Pomocí sledování indexu [71] můžete nezávisle kontrolovat činnost DNS resolveru v zařízení SDS. Např. při výpadku síťové komunikace (např. odpojení kabelu, porucha sítě atd.), dojde k vypršení položek v interní cache (to lze sledovat pomocí indexu [70]) a pokud nový dotaz nebude zodpovězen (nebude komunikace s DNS serverem), tak se hodnota v [71] ukáže jako nulová. Samozřejmě vždy jsou v těchto indexech k dispozici hodnoty pouze pro ten doménový název, který jste jako poslední použili při zavolání funkce dns_resolv().<br />
<br />
<br />
== Upozornění ==<br />
<br />
Starší FW mělo bug, kdy při vypršení TTL v interní cache nedošlo ke smazání položky v interni cache. Toto je samozřejmě problém, který je vyřešen v novém firmware, všechny verze od 08/2025.<br />
<br />
DNS cache je (záměrně) vymazána při:<br />
* nahrání nového FULLC programu<br />
* restartu zařízení SDS<br />
<br />
DNS cache není vymazána při výpadku Ethernetového připojení.<br />
<br />
DNS cache lze ručně vymazat zapsáním hodnoty 0xE4A5ECAC do systémové proměnné na indexu [70]. Zápis této speciální hodnoty kompletně smaže interní DNS cache. Tato specifická funkcionalita vyžaduje aktuální firmware (bylo to přidáno až 08/2025).<br />
<br />
To, že je DNS cache vymazána, znamená pouze jedinou záležitost - a to, že při novém dotazu přes dns_resolv() dojde ke komunikace s DNS serverem, a bude se čekat na jeho novou, čerstvou odpověď. Ta jak přijde (a bude platná), tak je uložena do cache, po dobu hodnoty TTL (tuto dobu určuje DNS server!). Další volání dns_resolv(), dokud TTL pro danou doménu v interní cache nevyprší, jsou pak vyřízeny okamžitě, protože se nečeká na odpověď ze serveru, ale FULLC program dostane odpověď ihned z interní cache.<br />
<br />
GOOD PRACTICE: před každým opakovaným použitím IP adresy, která byla získána z DNS resolveru, je vhodné zavolat dns_resolv() pro danou doménu znovu. Pokud je výsledná adresa (výsledek překladu domény na IP adresu) stejná, je to také okamžitě potvrzeno. Pokud však mezitím došlo ke změně (DNS záznamu), tak se jedině takto dokáže tato změna projevit ! Pokud tedy periodicky voláte např. funkci http_get(), tak vždy před každým tímto voláním, musíte provést i celé kolečko s dns_resolv() pro danou doménu, se kterou takto chcete komunikovat. Pokud to neuděláte, časem se dostanete do obtížného problému, kdy daný cílový server už může být dávno na jiné IP adrese, ale váš program bude stále chodit na starou, neplatnou, a přestane fungovat.<br />
<br />
<br />
== Stavové hodnoty ==<br />
<br />
Program musí použít volání funkce '''dns_resolv_status''' pro zjištění okamžitého stavu. Dokud nezískáte finální stavovou hodnotu, musíte tuto funkci volat opakovaně (nezapomeňte na vlastní bezpečnostní timeout).<br />
<br />
dns_resolv_status() význam<br />
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------<br />
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)<br />
512 | pracuje, dotaz odeslán (překlad nenalezen v interní cache), čekejte (funkce současně nevrací platnou IP adresu, ta bude až po dokončení překladu)<br />
513 | hotovo OK, do *resolvedIPaddressOutput byla zapsána IP adresa (4 bajty), a záznam v interní cache je platný a živý (zbývající TTL větší než 0)<br />
514 | odpověď nebyla získána (chyba) a současně nemáme záznam v interní DNS cache, takže funkce nevrací platnou IP adresu (musíte znovu začít s dotazem)<br />
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu<br />
516 | dotaz selhal, protože došlo k odpojení Ethernetu<br />
517 | dotaz selhal, protože došlo ke ztrátě vlastní přidělené IP adresy zařízení SDS (typicky když vyprší IP z DHCP a není ještě obnovena)<br />
<br />
<br />
Pokud funkce dns_resolv_status() vrátila hodnotu 513, je možné číst systémovou proměnnou z indexu [70] (uint32_t), která ukáže hodnotu TTL v momentu, kdy tuto hodnotu právě čtete. Lze takto sledovat, jak se postupně TTL snižuje (o 1 každou sekundu). Hodnota TTL odpovídá dané položce v interní cache, která byla určena právě posledním voláním funkce dns_resolv().</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_set_and_get&diff=953FULL-C: set and get2025-08-10T09:39:15Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Jak je FULL-C program připojen k hardware ==<br />
<br />
Základním důvodem pro existenci FULL-C programu na zařízení SDS je možnost číst stav hardware (např. opto-vstupy) a také hardware řídit (např. spínat relé).<br />
<br />
Za tímto účelem je k dispozici sada C funkcí, které může program volat a které buď navrátí aktuální stav ("get" funkce), nebo stav změní ("set" funkce).<br />
<br />
Zde je seznam těchto funkcí:<br />
<pre><br />
void SDS_set_i32(unsigned int index, signed int value);<br />
signed int SDS_get_i32(unsigned int index);<br />
<br />
void SDS_set_i64(unsigned int index, int64_t value);<br />
signed int SDS_get_i64(unsigned int index);<br />
<br />
void SDS_set_u32(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u32(unsigned int index);<br />
<br />
void SDS_set_u64(unsigned int index, uint64_t value);<br />
unsigned int SDS_get_u64(unsigned int index);<br />
<br />
void SDS_set_f32(unsigned int index, float value);<br />
float SDS_get_f32(unsigned int index);<br />
<br />
void SDS_set_a(unsigned int index, void *ptr, unsigned int len);<br />
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);<br />
</pre><br />
<br />
Historicky zde původně byly i tyto funkce:<br />
<pre><br />
void SDS_set_i(unsigned int index, signed int value);<br />
signed int SDS_get_i(unsigned int index);<br />
<br />
void SDS_set_u(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u(unsigned int index);<br />
</pre><br />
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32). <br />
Pokud je váš program používá, vše vám bude fungovat i nadále, ale co nejdříve jejich název ve svém programu přepište na nový.<br />
<br />
<br />
=== Detailní Příklady ===<br />
<br />
Přečtěte si nejprve celou tuto stránku, ať pochopíte princip. Následně se podívejte na [[FULL-C:_set_and_get:_detailed|jednotlivé příklady zde]].<br />
<br />
<br />
== Princip ==<br />
<br />
Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.<br />
<br />
Pod každou položkou (číselným '''index'''em) je schována odpovídající činnost nebo hodnota (např. '''index = 3''' vrátí přes "get" funkci aktuální hodnotu "UpTime", viz tabulka).<br />
<br />
Každá položka však může mít jiný obsah (číslo nebo text): podle toho je potřeba zvolit správný přístup (správnou set\get funkci):<br />
<br />
typ položky | rozsah | typ proměnné | postfix set\get funkce<br />
--------------------------+----------------+-----------------+-------------------------<br />
signed 32-bit integer | -2^31..+2^31 | int | _i32<br />
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32<br />
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64<br />
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64<br />
IP address | uchar[4] | unsigned int | _u32<br />
float | IEEE-754 | float | _f32<br />
string (text) | len\maxlen | void* \ char* | _a<br />
binary array | len\maxlen | void* \ char* | _a<br />
<br />
Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.<br />
<br />
Příklad: chceme zapsat desetinné číslo "numf", v tom případě se jedná o typ "float numf;" a musíme použít ''SDS_set_f(index, numf);''.<br />
<br />
<br />
Varování: ačkoliv je většina indexů podobných jako u SDS (pro pole ''sys[]''), nemají všechny indexy stejný význam mezi SDS-C a FULL-C. Vždy používejte tu správnou tabulku pro každý programovací jazyk.<br />
<br />
<br />
== Funkce _u32 \ _i32 \ _f32 ==<br />
<br />
Základní funkce určené pro získání číselné hodnoty "z" SDS, popř. zápisu číselné hodnoty "do" SDS. Vždy se jedná o kombinaci ''index''u (který určuje o co máme zájem) a hodnoty (která je vždy 32 bitová, tj. 4 bajty, ale obsah těchto 4 bajtů už je různý - buď celočíselná hodnota bez nebo se znaménkem (nejvyšší bit), nebo desetinné číslo - floating point).<br />
<br />
Čtení hodnoty je potřeba pro zjištění aktuálního stavu (např. stav optického vstupu, nebo poslední známá teplota z čidla). Zápis se pak používá pro ovládání (např. sepnutí relé).<br />
<br />
<br />
První příklad: ''čtení'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
unsigned int NTPtime;<br />
NTPtime = SDS_get_u32(4);<br />
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);<br />
</syntaxhighlight><br />
<br />
Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem<br />
<syntaxhighlight lang="c"><br />
int NTPoffset;<br />
NTPoffset = SDS_get_i32(26);<br />
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);<br />
</syntaxhighlight><br />
<br />
Třetí příklad: ''čtení'' float hodnoty<br />
<syntaxhighlight lang="c"><br />
float AD_Rinput__in_user_units;<br />
AD_Rinput__in_user_units = SDS_get_f32(311);<br />
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);<br />
</syntaxhighlight><br />
<br />
Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)<br />
SDS_set_u32(231, 0xFF); <br />
</syntaxhighlight><br />
<br />
Samozřejmě musíte pro každý index použít správný typ hodnoty (tzn.: ''unsigned int'' \ ''int'' \ ''float''). Přesné přiřazení naleznete v tabulce na konci této stránky.<br />
<br />
Pozn.: i když například víte, že hodnota může být například jenom 0 nebo 1 (příklad), tak vždy se zapisuje nebo čte všech 32bitů (unsigned int \ int \ float). Nepoužité bity jsou vždy nastaveny na nulu.<br />
<br />
<br />
== Funkce _u64 \ _i64 ==<br />
<br />
Princip je identický jako pro _u32 a _i32 funkce. <br />
<br />
Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.<br />
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.<br />
<br />
<br />
== Funkce _a ==<br />
<br />
Funkce pracující s polem dat (''SDS_get_a'', ''SDS_set_a'') vyžadují oproti ostatním set+get funkcím specifické parametry. Vždy se jedná o ukazatel na pole dat, a o informaci o velikosti tohoto pole.<br />
<br />
<br />
První příklad: čtení textového parametru<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00<br />
char sysLoc[32];<br />
<br />
// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů<br />
SDS_get_a(2, (void *)sysLoc, 32);<br />
<br />
// a můžeme se podívat na výsledek (výpis do konzole)<br />
printf("Nastavená system location: %s \n", sysLoc);<br />
</syntaxhighlight><br />
<br />
<br />
Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)<br />
unsigned int OPTOvalues[8];<br />
<br />
// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues<br />
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech<br />
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);<br />
<br />
// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)<br />
if (0 == OPTOvalues[0]) ...<br />
</syntaxhighlight><br />
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.<br />
<br />
<br />
Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.<br />
<br />
<br />
<br />
== Úplné detaily a všechny příklady ==<br />
<br />
<br />
<br />
'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.<br />
<br />
<br />
<br />
== Tabulka ==<br />
<br />
Podle typu každé položky lze použít jen právě tu danou specifickou funkci (_i32\_u32\_f32\_a\_i64\_u64), viz následující tabulka. <br />
<br />
Je li také uveden klíč "(a)", lze mimo přístup k jedinému indexu využít blokový přístup pomocí funkce SDS_get_a(), která přečte určený počet indexů za sebou a uloží je do připraveného pole (toho se využívá při blokovém čtení většího počtu za-sebou ležících položek, např. blokové čtení stavu všech optovstupů atd.).<br />
<br />
<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
index | i\u\f\a | dir | comment<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)<br />
0 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)<br />
1 | | SET | n/a<br />
-----------+---------+------+--<br />
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)<br />
2 | a | GET | sysLocation (user configured text)<br />
2 | | SET | n/a<br />
-----------+---------+------+--<br />
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)<br />
3 | | SET | n/a<br />
-----------+---------+------+--<br />
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds<br />
4 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)<br />
5 | | SET | n/a<br />
-----------+---------+------+--<br />
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)<br />
6 | | SET | n/a<br />
-----------+---------+------+--<br />
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)<br />
7 | | SET | n/a<br />
-----------+---------+------+--<br />
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)<br />
8 | | SET | n/a<br />
-----------+---------+------+--<br />
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)<br />
9 | | SET | n/a<br />
-----------+---------+------+--<br />
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)<br />
10 | | SET | n/a<br />
-----------+---------+------+--<br />
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)<br />
11 | | SET | n/a<br />
-----------+---------+------+--<br />
12 | u32 | GET | SDS device IP address (web admin IP)<br />
12 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
13..15 | | GET | n/a (reserved)<br />
13..15 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
16 | u32 | GET | network gateway IP address<br />
16 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
17..19 | | GET | n/a (reserved)<br />
17..19 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
20 | u32 | GET | network IP MASK<br />
20 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)<br />
21 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
22 | u32 | GET | SNMPv3 - Engine Boots <br />
22 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
23 | u32 | GET | SNMPv3 - Engine Time <br />
23 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
24 | u32 | GET | Ethernet Link Status<br />
24 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)<br />
25 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time<br />
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)<br />
-----------+---------+------+--<br />
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)<br />
27 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
28 | u32 | GET | timestamp of last change (assignment) of IP address <br />
28 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)<br />
29 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
30 | u32 | GET | DHCP lease time (secs) value<br />
30 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)<br />
31 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
32 | u32 | GET | MAC[1]<br />
32 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
33 | u32 | GET | MAC[2]<br />
33 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
34 | u32 | GET | MAC[3]<br />
34 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
35 | u32 | GET | MAC[4]<br />
35 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
36 | u32 | GET | MAC[5]<br />
36 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
37..39 | | GET | n/a (reserved)<br />
37..39 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)<br />
40 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
41 | a | GET | OEM branding (login web page) [32 chars]<br />
41 | a | SET | set custom OEM branding (login web page) [32 chars]<br />
-----------+---------+------+--<br />
42 | a | GET | OEM branding (welcome web page) [128 chars]<br />
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]<br />
-----------+---------+------+--<br />
43 | u32 | GET | NTP-server IP address<br />
43 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
44 | u32 | GET | NTP-client status (0 = NOT synchronized)<br />
44 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)<br />
45 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)<br />
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)<br />
46 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
48..60 | | GET | n/a (reserved)<br />
48..60 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)<br />
61 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
62..63 | | GET | n/a (reserved)<br />
62..63 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
64 | u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #0 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0<br />
-----------+---------+------+--<br />
65 | u32 | GET | get state of the DST automatic (0 = not used) (1 = DST used and DST shift is applied) (2 = DST used but NO shift applied)<br />
65 | u32 | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
66 | u32 | GET | DNS-server IP address<br />
66 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)<br />
67 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)<br />
68 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
69 | | GET | n/a (reserved) <br />
69 | | SET | n/a (reserved) <br />
-----------+---------+------+--<br />
70 | u32 | GET | DNS RESOLV - actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
70 | u32 | SET | write 0xE4A5ECAC to manually clear the WHOLE internal DNS cache (will force fresh DNS requests once dns_resolv() is again called by your program)<br />
-----------+---------+------+--<br />
71 | u32 | GET | DNS RESOLV - timestamp (UTC) of the latest DNS server response (packet) as requested by dns_resolv() function (if 0 then no response received, or cache has expired)<br />
71 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
72..77 | | GET | n/a (reserved) <br />
72..77 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs<br />
78 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)<br />
79 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84<br />
80 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
81..84 | | GET | n/a (reserved) <br />
81..84 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2<br />
85 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)<br />
86 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program<br />
87 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
88 | | GET | n/a (reserved) <br />
88 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)<br />
89 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)<br />
90 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
91 | u32 | GET | SDS IP-WatchDog: logical output status<br />
91 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
92..131 | | GET | n/a (reserved)<br />
92..131 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
132 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
133 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
134 | a | GET | FC: archived text of the last FC error<br />
134 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)<br />
135 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot<br />
136 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
137 | u32 | GET | read an actual SDS CPU cycle counter (number of executed instructions since power-up/reboot), continuously wraps around, (1 step = approx. 2 nsec)<br />
137 | | SET | n/a<br />
-----------+---------+------+--<br />
138 | u32 | GET | get SDS internal RTC power-on status (0 = invalid data after powerup in RTC) (1 = RTC data OK and were used on powerup) <br />
138 | | SET | n/a<br />
-----------+---------+------+--<br />
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied<br />
139 | | SET | n/a<br />
-----------+---------+------+--<br />
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)<br />
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)<br />
-----------+---------+------+--<br />
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)<br />
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)<br />
-----------+---------+------+--<br />
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)<br />
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)<br />
-----------+---------+------+--<br />
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)<br />
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)<br />
-----------+---------+------+--<br />
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)<br />
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)<br />
-----------+---------+------+--<br />
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)<br />
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)<br />
-----------+---------+------+--<br />
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)<br />
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)<br />
-----------+---------+------+--<br />
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)<br />
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)<br />
-----------+---------+------+--<br />
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)<br />
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)<br />
-----------+---------+------+--<br />
149 | | GET | n/a (reserved)<br />
149 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
150 | | GET | FC: shared-variables access control - read state of the access control<br />
150 | | SET | FC: shared-variables access control - use this to force a user-login in order to access the shared variables (0 = access without login is enabled)<br />
-----------+---------+------+--<br />
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)<br />
151..182 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
183 | u32 | GET | SDS FW date stamp (or just 0x00000000 for a very old firmware) - use this to verify the features or to ask user to update the firmware to a required newer version<br />
183 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
184 | u32 | GET | FC: information about how this actual running program was started (0 = none) (1 = normal) (2 = fc-wdg or manual restart) (4 = freshly loaded)<br />
184 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec<br />
185 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)<br />
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])<br />
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
188 | u32 | GET | PWM3 HW: direct "pulse" register value<br />
188 | | SET | n/a<br />
-----------+---------+------+--<br />
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])<br />
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
190 | u32 | GET | PWM4 HW: direct "pulse" register value<br />
190 | | SET | n/a<br />
-----------+---------+------+--<br />
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)<br />
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])<br />
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value<br />
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value <br />
-----------+---------+------+--<br />
194 | u32 | GET | reserved<br />
194 | | SET | N/A<br />
-----------+---------+------+--<br />
195 | u32 | GET | reserved<br />
195 | | SET | N/A<br />
-----------+---------+------+--<br />
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output<br />
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)<br />
-----------+---------+------+--<br />
229..230 | | GET | n/a (reserved)<br />
229..230 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)<br />
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)<br />
-----------+---------+------+--<br />
263..265 | | GET | n/a (reserved)<br />
263..265 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)<br />
266..297 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
298..300 | | GET | n/a (reserved)<br />
298..300 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin<br />
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)<br />
-----------+---------+------+--<br />
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin<br />
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)<br />
-----------+---------+------+--<br />
303..310 | | GET | n/a (reserved)<br />
303..310 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input<br />
311..342 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
343..374 | a | GET | AD: input identification / name (text)<br />
343..374 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
375..406 | a | GET | AD: input unit name (text)<br />
375..406 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
407..427 | | GET | n/a (reserved)<br />
407..427 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV) <br />
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW<br />
-----------+---------+------+--<br />
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)<br />
429 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)<br />
430 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)<br />
431..438 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant<br />
439..446 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
447..462 | | GET | n/a (reserved)<br />
447..462 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]<br />
463..469 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]<br />
470..476 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]<br />
477..483 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]<br />
484..490 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]<br />
491..497 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]<br />
498..504 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]<br />
505..511 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]<br />
512..518 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
519..991 | | GET | n/a (reserved)<br />
519..991 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)<br />
992 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
993 | u32 | GET | UTC timestamp (localtime) marking a start of yesterday (as a moment since when we capture a new record) (or 0 = if there is no record for yesterday)<br />
993 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
994 | u32 | GET | UTC timestamp (localtime) marking a start of today (or a moment of SDS power on), since when a today's record is captured<br />
994 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])<br />
995 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])<br />
996 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active<br />
997 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active<br />
998 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)<br />
999 | u32 | SET | "manual" control of the global Tariff Input (write/control enabled only if the feature is set in web admin - control set to FULL-C)<br />
-----------+---------+------+--<br />
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff<br />
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff<br />
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses<br />
1064..1095| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse<br />
1096..1127| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1128..1159| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1160..1191| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1192..1223| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1224..1255| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1256..1499| | GET | n/a (reserved)<br />
1256..1499| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1500..1531| a | GET | [S0-input] master configuration struct for this input<br />
1500..1531| a | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1532..1999| | GET | n/a (reserved)<br />
1532..1999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status<br />
2000..2063| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device<br />
2100..2163| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)<br />
2200..2263| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)<br />
2300..2363| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2364..2487| | GET | n/a (reserved)<br />
2364..2487| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)<br />
2488..2495| | SET | n/a <br />
-----------+---------+------+--<br />
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)<br />
2496 | | SET | n/a<br />
-----------+---------+------+--<br />
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)<br />
2497 | | SET | n/a<br />
-----------+---------+------+--<br />
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)<br />
2498 | | SET | n/a<br />
-----------+---------+------+--<br />
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)<br />
2499 | | SET | n/a<br />
-----------+---------+------+--<br />
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status<br />
2500..2563| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device<br />
2600..2663| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)<br />
2700..2763| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)<br />
2800..2863| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2864..2986| | GET | n/a (reserved)<br />
2864..2986| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)<br />
2986..2993| | SET | n/a <br />
-----------+---------+------+--<br />
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)<br />
2994 | | SET | n/a<br />
-----------+---------+------+--<br />
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)<br />
2995 | | SET | n/a<br />
-----------+---------+------+--<br />
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)<br />
2996 | | SET | n/a<br />
-----------+---------+------+--<br />
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)<br />
2997 | | SET | n/a<br />
-----------+---------+------+--<br />
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user<br />
2998 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)<br />
2999 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3000 | | GET | n/a (reserved)<br />
3000 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)<br />
3001 | a | SET | write<br />
-----------+---------+------+--<br />
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)<br />
3002 | a | SET | write<br />
-----------+---------+------+--<br />
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)<br />
3003 | a | SET | write<br />
-----------+---------+------+--<br />
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)<br />
3004 | a | SET | write<br />
-----------+---------+------+--<br />
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)<br />
3005 | a | SET | write<br />
-----------+---------+------+--<br />
3006..3799| | GET | n/a (reserved)<br />
3006..3799| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected<br />
3800 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801<br />
3801 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3802..3849| | GET | n/a (reserved)<br />
3802..3849| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3850 | u32 | GET | SD Card - fully mounted and useable<br />
3850 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3851 | i32 | GET | latest file i/o error code<br />
3851 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)<br />
3852 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3853 | u32 | GET | SD Card - CardType<br />
3853 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3854 | u32 | GET | SD Card - CID - ProductSN<br />
3854 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)<br />
3855 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3856 | u32 | GET | statistic counter: SDcard: failed init attempts<br />
3856 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)<br />
3857 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3858 | u32 | GET | statistic counter: SDcard: sector reads<br />
3858 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3859 | u32 | GET | statistic counter: SDcard: sector writes<br />
3859 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures<br />
3860 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3861 | u32 | GET | statistic counter: number of opened files<br />
3861 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3862..3999| | GET | n/a (reserved)<br />
3862..3999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read<br />
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write<br />
-----------+---------+------+--<br />
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read<br />
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write<br />
-----------+---------+------+--<br />
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read<br />
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write<br />
-----------+---------+------+--<br />
4300..4399| a | GET | Shared Variables: T00 through T99 - read<br />
4300..4399| a | SET | Shared Variables: T00 through T99 - write<br />
-----------+---------+------+--<br />
4400..4989| | GET | n/a (reserved)<br />
4400..4989| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4990..4999| u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #1..#10 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10<br />
-----------+---------+------+--<br />
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write<br />
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read<br />
-----------+-+-------+------+--<br />
5128..11197 | | GET | n/a (reserved)<br />
5128..11197 | | SET | n/a (reserved)<br />
-----------+-+-------+------+--<br />
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ) <br />
11198 | u32 | SET | write ( default: 0b00110001 )<br />
-----------+---------+------+--<br />
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)<br />
11199 | | SET | n/a<br />
-----------+---------+------+--<br />
12200 | i32 | GET | work progress (and result) of mqtt_connect()<br />
12200 | | SET | n/a <br />
-----------+---------+------+--<br />
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()<br />
12201 | | SET | n/a <br />
-----------+---------+------+--<br />
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
12202 | | SET | n/a <br />
-----------+---------+------+--<br />
12203 | i32 | GET | MQTT protocol error counter (informative)<br />
12203 | | SET | n/a <br />
-----------+--+------+------+--<br />
12204..12208 | | GET | n/a (reserved)<br />
12204..12208 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12209 | i32 | GET | Subscribe Table - total number of available rows<br />
12209 | | SET | n/a <br />
-----------+---------+------+--<br />
12210 | a | GET | latest received Topic Name (sent from broker)<br />
12210 | | SET | n/a <br />
-----------+--+------+------+--<br />
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row<br />
12211..12241 | | SET | n/a<br />
--------------+------+------+--<br />
12242..12249 | | GET | n/a (reserved)<br />
12242..12249 | | SET | n/a<br />
-----------+--+------+------+--<br />
12250 | a | GET | latest received Value (sent from broker)<br />
12250 | | SET | n/a <br />
-----------+--+------+------+--<br />
12251..12281 | a | GET | Subscribe Table: actual Value for each table row<br />
12251..12281 | | SET | n/a<br />
--------------+------+------+--<br />
12282..12289 | | GET | n/a (reserved)<br />
12282..12289 | | SET | n/a<br />
-----------+--+------+------+--<br />
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker<br />
12290 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row<br />
12291..12321 | | SET | n/a<br />
--------------+------+--+---+--+--<br />
12322..12398 | | GET | n/a (reserved)<br />
12322..12398 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)<br />
12399 | | SET | n/a <br />
-----------+---------+------+--<br />
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()<br />
12400 | | SET | n/a <br />
-----------+---------+------+--<br />
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
12401 | | SET | n/a <br />
-----------+---------+------+--<br />
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
12402 | | SET | n/a <br />
-----------+---------+------+--<br />
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
12403 | | SET | n/a <br />
-----------+---------+------+--<br />
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
12404 | | SET | n/a <br />
-----------+---------+------+--<br />
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
12405 | | SET | n/a <br />
-----------+---------+------+--<br />
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
12406 | | SET | n/a <br />
-----------+--+------+------+--<br />
12407..12414 | | GET | n/a (reserved)<br />
12407..12414 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
12415 | | SET | n/a <br />
-----------+---------+------+--<br />
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
12416 | | SET | n/a <br />
-----------+--+------+------+--<br />
12417..12462 | | GET | n/a (reserved)<br />
12417..12462 | | SET | n/a (reserved) <br />
-----------+--+------+------+--<br />
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)<br />
12463 | | SET | n/a <br />
-----------+---------+------+--<br />
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)<br />
12464 | | SET | n/a <br />
-----------+---------+------+--<br />
12465 | u/i 32 | GET | timestamp of the latest received message<br />
12465 | | SET | n/a <br />
-----------+---------+------+--<br />
12466 | u/i 32 | GET | a count of received items inside the latest received message<br />
12466 | | SET | n/a <br />
-----------+---------+------+--<br />
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)<br />
12467 | | SET | n/a <br />
-----------+---------+------+--<br />
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)<br />
12468 | | SET | n/a <br />
-----------+---------+------+--<br />
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)<br />
12469 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12470..12719 | i32 (a) | GET | received values (latest received message contents)<br />
12470..12719 | | SET | n/a <br />
--------------+---------+------+--<br />
<br />
<br />
<br />
'''Poznámky''' <br />
<br />
Položky obsahující: "konfigurační struktura" vyžadují dostatečně velký prostor pro uložení výsledku (při zavolání SDS_get_a() funkce). V takovém případě se do vámi určené cílové oblasti ukládá celý "struct" který obsahuje všechny potřebné údaje patřící pod danou položku (názvy, hodnoty, atd.). Pro detaily je nejlépe podívat se přímo na aktuální [[FULL-C:_set_and_get:_detailed|příklady]], které přesně popisují postup pro každý typ takové struktury - a vysvětlují tuto poznámku svým kódem.<br />
<br />
Indexy označené jako '''(a)''' lze ''blokově číst'' (pozor, označené specificky jako "a v závorce"). Vždy ale lze ''blokové čtení'' (tj. čtení více indexů najednou, za sebou, v rámci povoleného rozsahu) provést pouze od prvního indexu v bloku (ne od dalších v bloku).<br />
Příklad: indexy 1000 až 1031 lze přečíst jako jeden souvislý blok, když se začne číst od prvního indexu v bloku (tj. 1000). Počet následně čtených indexů se udává dalším parametrem při volání SDS_get_a() funkce.<br />
Pokud se pokusíte číst blok indexů ne od začátku bloku, čtení selže - pokud blok indexů začíná na 1000 tak musíte požádat o čtení od indexu 1000, přičemž začátek od 1001 a výše selže.<br />
<br />
BackUp-RAM funkce je dostupná je pro firmware který poskytuje verzi FULL-C o hodnotě 0x08 nebo novější. BackUp-RAM je sada 32-bit hodnot, které lze zapisovat a číst, a které jsou (především) uchovány v paměti, která je zálohovaná baterií (tzn. drží hodnotu i po výpadku napájení, tak dlouho než se baterie vybije). Výhodou BackUp-RAM oproti DF je možnost přímého přístupu a rychlosti (naopak DF vyžaduje čtení a zápis celých stránek).<br />
<br />
Sdílené proměnné je potřeba nejprve definovat, aby je šlo použít, a aby k nim šlo přistupovat přes set/get funkce - viz specifická stránka na této wiki.<br />
<br />
Detaily (významy hodnot) pro položky ''MQTT klient'' a ''MODBUS-TCP klient'' jsou rozepsány na příslušných odpovídajících stránkách na této wiki.<br />
<br />
<br />
'''Vysvětlení položek'''<br />
<br />
V tabulce výše jsou uvedeny informace, které naleznete na jednotlivých indexech. Nicméně popisy uvedené v této tabulce jsou velmi zkrácené, a je k nim tedy potřeba mnohem širší vysvětlení.<br />
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).<br />
<br />
<br />
'''Vstupy pro měření napětí'''<br />
<br />
Detaily k A/D vstupům jsou uvedeny [[SDS_2PR:_ADC_vstupy_a_kalibrace|zde]]. Pro psaní programu je důležité mapování '''index'''u na jednotlivé vstupy, viz [[SDS_2PR:_ADC_vstupy_a_kalibrace|tabulka]].<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_set_and_get&diff=952FULL-C: set and get2025-08-10T09:34:38Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Jak je FULL-C program připojen k hardware ==<br />
<br />
Základním důvodem pro existenci FULL-C programu na zařízení SDS je možnost číst stav hardware (např. opto-vstupy) a také hardware řídit (např. spínat relé).<br />
<br />
Za tímto účelem je k dispozici sada C funkcí, které může program volat a které buď navrátí aktuální stav ("get" funkce), nebo stav změní ("set" funkce).<br />
<br />
Zde je seznam těchto funkcí:<br />
<pre><br />
void SDS_set_i32(unsigned int index, signed int value);<br />
signed int SDS_get_i32(unsigned int index);<br />
<br />
void SDS_set_i64(unsigned int index, int64_t value);<br />
signed int SDS_get_i64(unsigned int index);<br />
<br />
void SDS_set_u32(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u32(unsigned int index);<br />
<br />
void SDS_set_u64(unsigned int index, uint64_t value);<br />
unsigned int SDS_get_u64(unsigned int index);<br />
<br />
void SDS_set_f32(unsigned int index, float value);<br />
float SDS_get_f32(unsigned int index);<br />
<br />
void SDS_set_a(unsigned int index, void *ptr, unsigned int len);<br />
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);<br />
</pre><br />
<br />
Historicky zde původně byly i tyto funkce:<br />
<pre><br />
void SDS_set_i(unsigned int index, signed int value);<br />
signed int SDS_get_i(unsigned int index);<br />
<br />
void SDS_set_u(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u(unsigned int index);<br />
</pre><br />
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32). <br />
Pokud je váš program používá, vše vám bude fungovat i nadále, ale co nejdříve jejich název ve svém programu přepište na nový.<br />
<br />
<br />
=== Detailní Příklady ===<br />
<br />
Přečtěte si nejprve celou tuto stránku, ať pochopíte princip. Následně se podívejte na [[FULL-C:_set_and_get:_detailed|jednotlivé příklady zde]].<br />
<br />
<br />
== Princip ==<br />
<br />
Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.<br />
<br />
Pod každou položkou (číselným '''index'''em) je schována odpovídající činnost nebo hodnota (např. '''index = 3''' vrátí přes "get" funkci aktuální hodnotu "UpTime", viz tabulka).<br />
<br />
Každá položka však může mít jiný obsah (číslo nebo text): podle toho je potřeba zvolit správný přístup (správnou set\get funkci):<br />
<br />
typ položky | rozsah | typ proměnné | postfix set\get funkce<br />
--------------------------+----------------+-----------------+-------------------------<br />
signed 32-bit integer | -2^31..+2^31 | int | _i32<br />
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32<br />
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64<br />
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64<br />
IP address | uchar[4] | unsigned int | _u32<br />
float | IEEE-754 | float | _f32<br />
string (text) | len\maxlen | void* \ char* | _a<br />
binary array | len\maxlen | void* \ char* | _a<br />
<br />
Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.<br />
<br />
Příklad: chceme zapsat desetinné číslo "numf", v tom případě se jedná o typ "float numf;" a musíme použít ''SDS_set_f(index, numf);''.<br />
<br />
<br />
Varování: ačkoliv je většina indexů podobných jako u SDS (pro pole ''sys[]''), nemají všechny indexy stejný význam mezi SDS-C a FULL-C. Vždy používejte tu správnou tabulku pro každý programovací jazyk.<br />
<br />
<br />
== Funkce _u32 \ _i32 \ _f32 ==<br />
<br />
Základní funkce určené pro získání číselné hodnoty "z" SDS, popř. zápisu číselné hodnoty "do" SDS. Vždy se jedná o kombinaci ''index''u (který určuje o co máme zájem) a hodnoty (která je vždy 32 bitová, tj. 4 bajty, ale obsah těchto 4 bajtů už je různý - buď celočíselná hodnota bez nebo se znaménkem (nejvyšší bit), nebo desetinné číslo - floating point).<br />
<br />
Čtení hodnoty je potřeba pro zjištění aktuálního stavu (např. stav optického vstupu, nebo poslední známá teplota z čidla). Zápis se pak používá pro ovládání (např. sepnutí relé).<br />
<br />
<br />
První příklad: ''čtení'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
unsigned int NTPtime;<br />
NTPtime = SDS_get_u32(4);<br />
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);<br />
</syntaxhighlight><br />
<br />
Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem<br />
<syntaxhighlight lang="c"><br />
int NTPoffset;<br />
NTPoffset = SDS_get_i32(26);<br />
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);<br />
</syntaxhighlight><br />
<br />
Třetí příklad: ''čtení'' float hodnoty<br />
<syntaxhighlight lang="c"><br />
float AD_Rinput__in_user_units;<br />
AD_Rinput__in_user_units = SDS_get_f32(311);<br />
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);<br />
</syntaxhighlight><br />
<br />
Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)<br />
SDS_set_u32(231, 0xFF); <br />
</syntaxhighlight><br />
<br />
Samozřejmě musíte pro každý index použít správný typ hodnoty (tzn.: ''unsigned int'' \ ''int'' \ ''float''). Přesné přiřazení naleznete v tabulce na konci této stránky.<br />
<br />
Pozn.: i když například víte, že hodnota může být například jenom 0 nebo 1 (příklad), tak vždy se zapisuje nebo čte všech 32bitů (unsigned int \ int \ float). Nepoužité bity jsou vždy nastaveny na nulu.<br />
<br />
<br />
== Funkce _u64 \ _i64 ==<br />
<br />
Princip je identický jako pro _u32 a _i32 funkce. <br />
<br />
Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.<br />
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.<br />
<br />
<br />
== Funkce _a ==<br />
<br />
Funkce pracující s polem dat (''SDS_get_a'', ''SDS_set_a'') vyžadují oproti ostatním set+get funkcím specifické parametry. Vždy se jedná o ukazatel na pole dat, a o informaci o velikosti tohoto pole.<br />
<br />
<br />
První příklad: čtení textového parametru<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00<br />
char sysLoc[32];<br />
<br />
// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů<br />
SDS_get_a(2, (void *)sysLoc, 32);<br />
<br />
// a můžeme se podívat na výsledek (výpis do konzole)<br />
printf("Nastavená system location: %s \n", sysLoc);<br />
</syntaxhighlight><br />
<br />
<br />
Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)<br />
unsigned int OPTOvalues[8];<br />
<br />
// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues<br />
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech<br />
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);<br />
<br />
// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)<br />
if (0 == OPTOvalues[0]) ...<br />
</syntaxhighlight><br />
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.<br />
<br />
<br />
Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.<br />
<br />
<br />
<br />
== Úplné detaily a všechny příklady ==<br />
<br />
<br />
<br />
'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.<br />
<br />
<br />
<br />
== Tabulka ==<br />
<br />
Podle typu každé položky lze použít jen právě tu danou specifickou funkci (_i32\_u32\_f32\_a\_i64\_u64), viz následující tabulka. <br />
<br />
Je li také uveden klíč "(a)", lze mimo přístup k jedinému indexu využít blokový přístup pomocí funkce SDS_get_a(), která přečte určený počet indexů za sebou a uloží je do připraveného pole (toho se využívá při blokovém čtení většího počtu za-sebou ležících položek, např. blokové čtení stavu všech optovstupů atd.).<br />
<br />
<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
index | i\u\f\a | dir | comment<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)<br />
0 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)<br />
1 | | SET | n/a<br />
-----------+---------+------+--<br />
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)<br />
2 | a | GET | sysLocation (user configured text)<br />
2 | | SET | n/a<br />
-----------+---------+------+--<br />
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)<br />
3 | | SET | n/a<br />
-----------+---------+------+--<br />
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds<br />
4 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)<br />
5 | | SET | n/a<br />
-----------+---------+------+--<br />
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)<br />
6 | | SET | n/a<br />
-----------+---------+------+--<br />
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)<br />
7 | | SET | n/a<br />
-----------+---------+------+--<br />
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)<br />
8 | | SET | n/a<br />
-----------+---------+------+--<br />
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)<br />
9 | | SET | n/a<br />
-----------+---------+------+--<br />
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)<br />
10 | | SET | n/a<br />
-----------+---------+------+--<br />
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)<br />
11 | | SET | n/a<br />
-----------+---------+------+--<br />
12 | u32 | GET | SDS device IP address (web admin IP)<br />
12 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
13..15 | | GET | n/a (reserved)<br />
13..15 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
16 | u32 | GET | network gateway IP address<br />
16 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
17..19 | | GET | n/a (reserved)<br />
17..19 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
20 | u32 | GET | network IP MASK<br />
20 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)<br />
21 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
22 | u32 | GET | SNMPv3 - Engine Boots <br />
22 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
23 | u32 | GET | SNMPv3 - Engine Time <br />
23 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
24 | u32 | GET | Ethernet Link Status<br />
24 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)<br />
25 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time<br />
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)<br />
-----------+---------+------+--<br />
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)<br />
27 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
28 | u32 | GET | timestamp of last change (assignment) of IP address <br />
28 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)<br />
29 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
30 | u32 | GET | DHCP lease time (secs) value<br />
30 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)<br />
31 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
32 | u32 | GET | MAC[1]<br />
32 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
33 | u32 | GET | MAC[2]<br />
33 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
34 | u32 | GET | MAC[3]<br />
34 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
35 | u32 | GET | MAC[4]<br />
35 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
36 | u32 | GET | MAC[5]<br />
36 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
37..39 | | GET | n/a (reserved)<br />
37..39 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)<br />
40 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
41 | a | GET | OEM branding (login web page) [32 chars]<br />
41 | a | SET | set custom OEM branding (login web page) [32 chars]<br />
-----------+---------+------+--<br />
42 | a | GET | OEM branding (welcome web page) [128 chars]<br />
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]<br />
-----------+---------+------+--<br />
43 | u32 | GET | NTP-server IP address<br />
43 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
44 | u32 | GET | NTP-client status (0 = NOT synchronized)<br />
44 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)<br />
45 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)<br />
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)<br />
46 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
48..60 | | GET | n/a (reserved)<br />
48..60 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)<br />
61 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
62..63 | | GET | n/a (reserved)<br />
62..63 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
64 | u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #0 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0<br />
-----------+---------+------+--<br />
65 | u32 | GET | get state of the DST automatic (0 = not used) (1 = DST used and DST shift is applied) (2 = DST used but NO shift applied)<br />
65 | u32 | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
66 | u32 | GET | DNS-server IP address<br />
66 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)<br />
67 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)<br />
68 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
69 | | GET | n/a (reserved) <br />
69 | | SET | n/a (reserved) <br />
-----------+---------+------+--<br />
70 | u32 | GET | DNS RESOLV - actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
70 | u32 | SET | write 0xE4A5ECAC to manually clear the WHOLE internal DNS cache (will force fresh DNS requests once dns_resolv() is again called by your program)<br />
-----------+---------+------+--<br />
71 | u32 | GET | DNS RESOLV - timestamp (UTC) of the latest DNS server response (packet) as requested by dns_resolv() function (if 0 then no response received)<br />
71 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
72..77 | | GET | n/a (reserved) <br />
72..77 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs<br />
78 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)<br />
79 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84<br />
80 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
81..84 | | GET | n/a (reserved) <br />
81..84 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2<br />
85 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)<br />
86 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program<br />
87 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
88 | | GET | n/a (reserved) <br />
88 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)<br />
89 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)<br />
90 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
91 | u32 | GET | SDS IP-WatchDog: logical output status<br />
91 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
92..131 | | GET | n/a (reserved)<br />
92..131 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
132 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
133 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
134 | a | GET | FC: archived text of the last FC error<br />
134 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)<br />
135 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot<br />
136 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
137 | u32 | GET | read an actual SDS CPU cycle counter (number of executed instructions since power-up/reboot), continuously wraps around, (1 step = approx. 2 nsec)<br />
137 | | SET | n/a<br />
-----------+---------+------+--<br />
138 | u32 | GET | get SDS internal RTC power-on status (0 = invalid data after powerup in RTC) (1 = RTC data OK and were used on powerup) <br />
138 | | SET | n/a<br />
-----------+---------+------+--<br />
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied<br />
139 | | SET | n/a<br />
-----------+---------+------+--<br />
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)<br />
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)<br />
-----------+---------+------+--<br />
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)<br />
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)<br />
-----------+---------+------+--<br />
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)<br />
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)<br />
-----------+---------+------+--<br />
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)<br />
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)<br />
-----------+---------+------+--<br />
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)<br />
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)<br />
-----------+---------+------+--<br />
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)<br />
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)<br />
-----------+---------+------+--<br />
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)<br />
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)<br />
-----------+---------+------+--<br />
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)<br />
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)<br />
-----------+---------+------+--<br />
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)<br />
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)<br />
-----------+---------+------+--<br />
149 | | GET | n/a (reserved)<br />
149 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
150 | | GET | FC: shared-variables access control - read state of the access control<br />
150 | | SET | FC: shared-variables access control - use this to force a user-login in order to access the shared variables (0 = access without login is enabled)<br />
-----------+---------+------+--<br />
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)<br />
151..182 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
183 | u32 | GET | SDS FW date stamp (or just 0x00000000 for a very old firmware) - use this to verify the features or to ask user to update the firmware to a required newer version<br />
183 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
184 | u32 | GET | FC: information about how this actual running program was started (0 = none) (1 = normal) (2 = fc-wdg or manual restart) (4 = freshly loaded)<br />
184 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec<br />
185 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)<br />
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])<br />
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
188 | u32 | GET | PWM3 HW: direct "pulse" register value<br />
188 | | SET | n/a<br />
-----------+---------+------+--<br />
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])<br />
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
190 | u32 | GET | PWM4 HW: direct "pulse" register value<br />
190 | | SET | n/a<br />
-----------+---------+------+--<br />
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)<br />
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])<br />
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value<br />
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value <br />
-----------+---------+------+--<br />
194 | u32 | GET | reserved<br />
194 | | SET | N/A<br />
-----------+---------+------+--<br />
195 | u32 | GET | reserved<br />
195 | | SET | N/A<br />
-----------+---------+------+--<br />
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output<br />
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)<br />
-----------+---------+------+--<br />
229..230 | | GET | n/a (reserved)<br />
229..230 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)<br />
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)<br />
-----------+---------+------+--<br />
263..265 | | GET | n/a (reserved)<br />
263..265 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)<br />
266..297 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
298..300 | | GET | n/a (reserved)<br />
298..300 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin<br />
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)<br />
-----------+---------+------+--<br />
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin<br />
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)<br />
-----------+---------+------+--<br />
303..310 | | GET | n/a (reserved)<br />
303..310 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input<br />
311..342 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
343..374 | a | GET | AD: input identification / name (text)<br />
343..374 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
375..406 | a | GET | AD: input unit name (text)<br />
375..406 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
407..427 | | GET | n/a (reserved)<br />
407..427 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV) <br />
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW<br />
-----------+---------+------+--<br />
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)<br />
429 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)<br />
430 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)<br />
431..438 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant<br />
439..446 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
447..462 | | GET | n/a (reserved)<br />
447..462 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]<br />
463..469 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]<br />
470..476 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]<br />
477..483 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]<br />
484..490 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]<br />
491..497 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]<br />
498..504 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]<br />
505..511 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]<br />
512..518 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
519..991 | | GET | n/a (reserved)<br />
519..991 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)<br />
992 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
993 | u32 | GET | UTC timestamp (localtime) marking a start of yesterday (as a moment since when we capture a new record) (or 0 = if there is no record for yesterday)<br />
993 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
994 | u32 | GET | UTC timestamp (localtime) marking a start of today (or a moment of SDS power on), since when a today's record is captured<br />
994 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])<br />
995 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])<br />
996 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active<br />
997 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active<br />
998 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)<br />
999 | u32 | SET | "manual" control of the global Tariff Input (write/control enabled only if the feature is set in web admin - control set to FULL-C)<br />
-----------+---------+------+--<br />
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff<br />
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff<br />
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses<br />
1064..1095| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse<br />
1096..1127| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1128..1159| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1160..1191| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1192..1223| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1224..1255| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1256..1499| | GET | n/a (reserved)<br />
1256..1499| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1500..1531| a | GET | [S0-input] master configuration struct for this input<br />
1500..1531| a | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1532..1999| | GET | n/a (reserved)<br />
1532..1999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status<br />
2000..2063| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device<br />
2100..2163| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)<br />
2200..2263| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)<br />
2300..2363| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2364..2487| | GET | n/a (reserved)<br />
2364..2487| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)<br />
2488..2495| | SET | n/a <br />
-----------+---------+------+--<br />
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)<br />
2496 | | SET | n/a<br />
-----------+---------+------+--<br />
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)<br />
2497 | | SET | n/a<br />
-----------+---------+------+--<br />
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)<br />
2498 | | SET | n/a<br />
-----------+---------+------+--<br />
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)<br />
2499 | | SET | n/a<br />
-----------+---------+------+--<br />
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status<br />
2500..2563| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device<br />
2600..2663| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)<br />
2700..2763| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)<br />
2800..2863| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2864..2986| | GET | n/a (reserved)<br />
2864..2986| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)<br />
2986..2993| | SET | n/a <br />
-----------+---------+------+--<br />
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)<br />
2994 | | SET | n/a<br />
-----------+---------+------+--<br />
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)<br />
2995 | | SET | n/a<br />
-----------+---------+------+--<br />
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)<br />
2996 | | SET | n/a<br />
-----------+---------+------+--<br />
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)<br />
2997 | | SET | n/a<br />
-----------+---------+------+--<br />
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user<br />
2998 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)<br />
2999 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3000 | | GET | n/a (reserved)<br />
3000 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)<br />
3001 | a | SET | write<br />
-----------+---------+------+--<br />
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)<br />
3002 | a | SET | write<br />
-----------+---------+------+--<br />
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)<br />
3003 | a | SET | write<br />
-----------+---------+------+--<br />
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)<br />
3004 | a | SET | write<br />
-----------+---------+------+--<br />
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)<br />
3005 | a | SET | write<br />
-----------+---------+------+--<br />
3006..3799| | GET | n/a (reserved)<br />
3006..3799| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected<br />
3800 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801<br />
3801 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3802..3849| | GET | n/a (reserved)<br />
3802..3849| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3850 | u32 | GET | SD Card - fully mounted and useable<br />
3850 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3851 | i32 | GET | latest file i/o error code<br />
3851 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)<br />
3852 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3853 | u32 | GET | SD Card - CardType<br />
3853 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3854 | u32 | GET | SD Card - CID - ProductSN<br />
3854 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)<br />
3855 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3856 | u32 | GET | statistic counter: SDcard: failed init attempts<br />
3856 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)<br />
3857 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3858 | u32 | GET | statistic counter: SDcard: sector reads<br />
3858 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3859 | u32 | GET | statistic counter: SDcard: sector writes<br />
3859 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures<br />
3860 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3861 | u32 | GET | statistic counter: number of opened files<br />
3861 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3862..3999| | GET | n/a (reserved)<br />
3862..3999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read<br />
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write<br />
-----------+---------+------+--<br />
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read<br />
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write<br />
-----------+---------+------+--<br />
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read<br />
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write<br />
-----------+---------+------+--<br />
4300..4399| a | GET | Shared Variables: T00 through T99 - read<br />
4300..4399| a | SET | Shared Variables: T00 through T99 - write<br />
-----------+---------+------+--<br />
4400..4989| | GET | n/a (reserved)<br />
4400..4989| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4990..4999| u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #1..#10 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10<br />
-----------+---------+------+--<br />
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write<br />
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read<br />
-----------+-+-------+------+--<br />
5128..11197 | | GET | n/a (reserved)<br />
5128..11197 | | SET | n/a (reserved)<br />
-----------+-+-------+------+--<br />
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ) <br />
11198 | u32 | SET | write ( default: 0b00110001 )<br />
-----------+---------+------+--<br />
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)<br />
11199 | | SET | n/a<br />
-----------+---------+------+--<br />
12200 | i32 | GET | work progress (and result) of mqtt_connect()<br />
12200 | | SET | n/a <br />
-----------+---------+------+--<br />
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()<br />
12201 | | SET | n/a <br />
-----------+---------+------+--<br />
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
12202 | | SET | n/a <br />
-----------+---------+------+--<br />
12203 | i32 | GET | MQTT protocol error counter (informative)<br />
12203 | | SET | n/a <br />
-----------+--+------+------+--<br />
12204..12208 | | GET | n/a (reserved)<br />
12204..12208 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12209 | i32 | GET | Subscribe Table - total number of available rows<br />
12209 | | SET | n/a <br />
-----------+---------+------+--<br />
12210 | a | GET | latest received Topic Name (sent from broker)<br />
12210 | | SET | n/a <br />
-----------+--+------+------+--<br />
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row<br />
12211..12241 | | SET | n/a<br />
--------------+------+------+--<br />
12242..12249 | | GET | n/a (reserved)<br />
12242..12249 | | SET | n/a<br />
-----------+--+------+------+--<br />
12250 | a | GET | latest received Value (sent from broker)<br />
12250 | | SET | n/a <br />
-----------+--+------+------+--<br />
12251..12281 | a | GET | Subscribe Table: actual Value for each table row<br />
12251..12281 | | SET | n/a<br />
--------------+------+------+--<br />
12282..12289 | | GET | n/a (reserved)<br />
12282..12289 | | SET | n/a<br />
-----------+--+------+------+--<br />
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker<br />
12290 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row<br />
12291..12321 | | SET | n/a<br />
--------------+------+--+---+--+--<br />
12322..12398 | | GET | n/a (reserved)<br />
12322..12398 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)<br />
12399 | | SET | n/a <br />
-----------+---------+------+--<br />
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()<br />
12400 | | SET | n/a <br />
-----------+---------+------+--<br />
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
12401 | | SET | n/a <br />
-----------+---------+------+--<br />
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
12402 | | SET | n/a <br />
-----------+---------+------+--<br />
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
12403 | | SET | n/a <br />
-----------+---------+------+--<br />
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
12404 | | SET | n/a <br />
-----------+---------+------+--<br />
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
12405 | | SET | n/a <br />
-----------+---------+------+--<br />
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
12406 | | SET | n/a <br />
-----------+--+------+------+--<br />
12407..12414 | | GET | n/a (reserved)<br />
12407..12414 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
12415 | | SET | n/a <br />
-----------+---------+------+--<br />
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
12416 | | SET | n/a <br />
-----------+--+------+------+--<br />
12417..12462 | | GET | n/a (reserved)<br />
12417..12462 | | SET | n/a (reserved) <br />
-----------+--+------+------+--<br />
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)<br />
12463 | | SET | n/a <br />
-----------+---------+------+--<br />
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)<br />
12464 | | SET | n/a <br />
-----------+---------+------+--<br />
12465 | u/i 32 | GET | timestamp of the latest received message<br />
12465 | | SET | n/a <br />
-----------+---------+------+--<br />
12466 | u/i 32 | GET | a count of received items inside the latest received message<br />
12466 | | SET | n/a <br />
-----------+---------+------+--<br />
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)<br />
12467 | | SET | n/a <br />
-----------+---------+------+--<br />
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)<br />
12468 | | SET | n/a <br />
-----------+---------+------+--<br />
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)<br />
12469 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12470..12719 | i32 (a) | GET | received values (latest received message contents)<br />
12470..12719 | | SET | n/a <br />
--------------+---------+------+--<br />
<br />
<br />
<br />
'''Poznámky''' <br />
<br />
Položky obsahující: "konfigurační struktura" vyžadují dostatečně velký prostor pro uložení výsledku (při zavolání SDS_get_a() funkce). V takovém případě se do vámi určené cílové oblasti ukládá celý "struct" který obsahuje všechny potřebné údaje patřící pod danou položku (názvy, hodnoty, atd.). Pro detaily je nejlépe podívat se přímo na aktuální [[FULL-C:_set_and_get:_detailed|příklady]], které přesně popisují postup pro každý typ takové struktury - a vysvětlují tuto poznámku svým kódem.<br />
<br />
Indexy označené jako '''(a)''' lze ''blokově číst'' (pozor, označené specificky jako "a v závorce"). Vždy ale lze ''blokové čtení'' (tj. čtení více indexů najednou, za sebou, v rámci povoleného rozsahu) provést pouze od prvního indexu v bloku (ne od dalších v bloku).<br />
Příklad: indexy 1000 až 1031 lze přečíst jako jeden souvislý blok, když se začne číst od prvního indexu v bloku (tj. 1000). Počet následně čtených indexů se udává dalším parametrem při volání SDS_get_a() funkce.<br />
Pokud se pokusíte číst blok indexů ne od začátku bloku, čtení selže - pokud blok indexů začíná na 1000 tak musíte požádat o čtení od indexu 1000, přičemž začátek od 1001 a výše selže.<br />
<br />
BackUp-RAM funkce je dostupná je pro firmware který poskytuje verzi FULL-C o hodnotě 0x08 nebo novější. BackUp-RAM je sada 32-bit hodnot, které lze zapisovat a číst, a které jsou (především) uchovány v paměti, která je zálohovaná baterií (tzn. drží hodnotu i po výpadku napájení, tak dlouho než se baterie vybije). Výhodou BackUp-RAM oproti DF je možnost přímého přístupu a rychlosti (naopak DF vyžaduje čtení a zápis celých stránek).<br />
<br />
Sdílené proměnné je potřeba nejprve definovat, aby je šlo použít, a aby k nim šlo přistupovat přes set/get funkce - viz specifická stránka na této wiki.<br />
<br />
Detaily (významy hodnot) pro položky ''MQTT klient'' a ''MODBUS-TCP klient'' jsou rozepsány na příslušných odpovídajících stránkách na této wiki.<br />
<br />
<br />
'''Vysvětlení položek'''<br />
<br />
V tabulce výše jsou uvedeny informace, které naleznete na jednotlivých indexech. Nicméně popisy uvedené v této tabulce jsou velmi zkrácené, a je k nim tedy potřeba mnohem širší vysvětlení.<br />
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).<br />
<br />
<br />
'''Vstupy pro měření napětí'''<br />
<br />
Detaily k A/D vstupům jsou uvedeny [[SDS_2PR:_ADC_vstupy_a_kalibrace|zde]]. Pro psaní programu je důležité mapování '''index'''u na jednotlivé vstupy, viz [[SDS_2PR:_ADC_vstupy_a_kalibrace|tabulka]].<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_set_and_get&diff=951FULL-C: set and get2025-08-10T09:27:29Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Jak je FULL-C program připojen k hardware ==<br />
<br />
Základním důvodem pro existenci FULL-C programu na zařízení SDS je možnost číst stav hardware (např. opto-vstupy) a také hardware řídit (např. spínat relé).<br />
<br />
Za tímto účelem je k dispozici sada C funkcí, které může program volat a které buď navrátí aktuální stav ("get" funkce), nebo stav změní ("set" funkce).<br />
<br />
Zde je seznam těchto funkcí:<br />
<pre><br />
void SDS_set_i32(unsigned int index, signed int value);<br />
signed int SDS_get_i32(unsigned int index);<br />
<br />
void SDS_set_i64(unsigned int index, int64_t value);<br />
signed int SDS_get_i64(unsigned int index);<br />
<br />
void SDS_set_u32(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u32(unsigned int index);<br />
<br />
void SDS_set_u64(unsigned int index, uint64_t value);<br />
unsigned int SDS_get_u64(unsigned int index);<br />
<br />
void SDS_set_f32(unsigned int index, float value);<br />
float SDS_get_f32(unsigned int index);<br />
<br />
void SDS_set_a(unsigned int index, void *ptr, unsigned int len);<br />
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);<br />
</pre><br />
<br />
Historicky zde původně byly i tyto funkce:<br />
<pre><br />
void SDS_set_i(unsigned int index, signed int value);<br />
signed int SDS_get_i(unsigned int index);<br />
<br />
void SDS_set_u(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u(unsigned int index);<br />
</pre><br />
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32). <br />
Pokud je váš program používá, vše vám bude fungovat i nadále, ale co nejdříve jejich název ve svém programu přepište na nový.<br />
<br />
<br />
=== Detailní Příklady ===<br />
<br />
Přečtěte si nejprve celou tuto stránku, ať pochopíte princip. Následně se podívejte na [[FULL-C:_set_and_get:_detailed|jednotlivé příklady zde]].<br />
<br />
<br />
== Princip ==<br />
<br />
Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.<br />
<br />
Pod každou položkou (číselným '''index'''em) je schována odpovídající činnost nebo hodnota (např. '''index = 3''' vrátí přes "get" funkci aktuální hodnotu "UpTime", viz tabulka).<br />
<br />
Každá položka však může mít jiný obsah (číslo nebo text): podle toho je potřeba zvolit správný přístup (správnou set\get funkci):<br />
<br />
typ položky | rozsah | typ proměnné | postfix set\get funkce<br />
--------------------------+----------------+-----------------+-------------------------<br />
signed 32-bit integer | -2^31..+2^31 | int | _i32<br />
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32<br />
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64<br />
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64<br />
IP address | uchar[4] | unsigned int | _u32<br />
float | IEEE-754 | float | _f32<br />
string (text) | len\maxlen | void* \ char* | _a<br />
binary array | len\maxlen | void* \ char* | _a<br />
<br />
Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.<br />
<br />
Příklad: chceme zapsat desetinné číslo "numf", v tom případě se jedná o typ "float numf;" a musíme použít ''SDS_set_f(index, numf);''.<br />
<br />
<br />
Varování: ačkoliv je většina indexů podobných jako u SDS (pro pole ''sys[]''), nemají všechny indexy stejný význam mezi SDS-C a FULL-C. Vždy používejte tu správnou tabulku pro každý programovací jazyk.<br />
<br />
<br />
== Funkce _u32 \ _i32 \ _f32 ==<br />
<br />
Základní funkce určené pro získání číselné hodnoty "z" SDS, popř. zápisu číselné hodnoty "do" SDS. Vždy se jedná o kombinaci ''index''u (který určuje o co máme zájem) a hodnoty (která je vždy 32 bitová, tj. 4 bajty, ale obsah těchto 4 bajtů už je různý - buď celočíselná hodnota bez nebo se znaménkem (nejvyšší bit), nebo desetinné číslo - floating point).<br />
<br />
Čtení hodnoty je potřeba pro zjištění aktuálního stavu (např. stav optického vstupu, nebo poslední známá teplota z čidla). Zápis se pak používá pro ovládání (např. sepnutí relé).<br />
<br />
<br />
První příklad: ''čtení'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
unsigned int NTPtime;<br />
NTPtime = SDS_get_u32(4);<br />
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);<br />
</syntaxhighlight><br />
<br />
Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem<br />
<syntaxhighlight lang="c"><br />
int NTPoffset;<br />
NTPoffset = SDS_get_i32(26);<br />
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);<br />
</syntaxhighlight><br />
<br />
Třetí příklad: ''čtení'' float hodnoty<br />
<syntaxhighlight lang="c"><br />
float AD_Rinput__in_user_units;<br />
AD_Rinput__in_user_units = SDS_get_f32(311);<br />
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);<br />
</syntaxhighlight><br />
<br />
Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)<br />
SDS_set_u32(231, 0xFF); <br />
</syntaxhighlight><br />
<br />
Samozřejmě musíte pro každý index použít správný typ hodnoty (tzn.: ''unsigned int'' \ ''int'' \ ''float''). Přesné přiřazení naleznete v tabulce na konci této stránky.<br />
<br />
Pozn.: i když například víte, že hodnota může být například jenom 0 nebo 1 (příklad), tak vždy se zapisuje nebo čte všech 32bitů (unsigned int \ int \ float). Nepoužité bity jsou vždy nastaveny na nulu.<br />
<br />
<br />
== Funkce _u64 \ _i64 ==<br />
<br />
Princip je identický jako pro _u32 a _i32 funkce. <br />
<br />
Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.<br />
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.<br />
<br />
<br />
== Funkce _a ==<br />
<br />
Funkce pracující s polem dat (''SDS_get_a'', ''SDS_set_a'') vyžadují oproti ostatním set+get funkcím specifické parametry. Vždy se jedná o ukazatel na pole dat, a o informaci o velikosti tohoto pole.<br />
<br />
<br />
První příklad: čtení textového parametru<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00<br />
char sysLoc[32];<br />
<br />
// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů<br />
SDS_get_a(2, (void *)sysLoc, 32);<br />
<br />
// a můžeme se podívat na výsledek (výpis do konzole)<br />
printf("Nastavená system location: %s \n", sysLoc);<br />
</syntaxhighlight><br />
<br />
<br />
Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)<br />
unsigned int OPTOvalues[8];<br />
<br />
// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues<br />
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech<br />
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);<br />
<br />
// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)<br />
if (0 == OPTOvalues[0]) ...<br />
</syntaxhighlight><br />
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.<br />
<br />
<br />
Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.<br />
<br />
<br />
<br />
== Úplné detaily a všechny příklady ==<br />
<br />
<br />
<br />
'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.<br />
<br />
<br />
<br />
== Tabulka ==<br />
<br />
Podle typu každé položky lze použít jen právě tu danou specifickou funkci (_i32\_u32\_f32\_a\_i64\_u64), viz následující tabulka. <br />
<br />
Je li také uveden klíč "(a)", lze mimo přístup k jedinému indexu využít blokový přístup pomocí funkce SDS_get_a(), která přečte určený počet indexů za sebou a uloží je do připraveného pole (toho se využívá při blokovém čtení většího počtu za-sebou ležících položek, např. blokové čtení stavu všech optovstupů atd.).<br />
<br />
<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
index | i\u\f\a | dir | comment<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)<br />
0 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)<br />
1 | | SET | n/a<br />
-----------+---------+------+--<br />
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)<br />
2 | a | GET | sysLocation (user configured text)<br />
2 | | SET | n/a<br />
-----------+---------+------+--<br />
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)<br />
3 | | SET | n/a<br />
-----------+---------+------+--<br />
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds<br />
4 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)<br />
5 | | SET | n/a<br />
-----------+---------+------+--<br />
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)<br />
6 | | SET | n/a<br />
-----------+---------+------+--<br />
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)<br />
7 | | SET | n/a<br />
-----------+---------+------+--<br />
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)<br />
8 | | SET | n/a<br />
-----------+---------+------+--<br />
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)<br />
9 | | SET | n/a<br />
-----------+---------+------+--<br />
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)<br />
10 | | SET | n/a<br />
-----------+---------+------+--<br />
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)<br />
11 | | SET | n/a<br />
-----------+---------+------+--<br />
12 | u32 | GET | SDS device IP address (web admin IP)<br />
12 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
13..15 | | GET | n/a (reserved)<br />
13..15 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
16 | u32 | GET | network gateway IP address<br />
16 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
17..19 | | GET | n/a (reserved)<br />
17..19 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
20 | u32 | GET | network IP MASK<br />
20 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)<br />
21 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
22 | u32 | GET | SNMPv3 - Engine Boots <br />
22 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
23 | u32 | GET | SNMPv3 - Engine Time <br />
23 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
24 | u32 | GET | Ethernet Link Status<br />
24 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)<br />
25 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time<br />
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)<br />
-----------+---------+------+--<br />
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)<br />
27 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
28 | u32 | GET | timestamp of last change (assignment) of IP address <br />
28 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)<br />
29 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
30 | u32 | GET | DHCP lease time (secs) value<br />
30 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)<br />
31 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
32 | u32 | GET | MAC[1]<br />
32 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
33 | u32 | GET | MAC[2]<br />
33 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
34 | u32 | GET | MAC[3]<br />
34 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
35 | u32 | GET | MAC[4]<br />
35 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
36 | u32 | GET | MAC[5]<br />
36 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
37..39 | | GET | n/a (reserved)<br />
37..39 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)<br />
40 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
41 | a | GET | OEM branding (login web page) [32 chars]<br />
41 | a | SET | set custom OEM branding (login web page) [32 chars]<br />
-----------+---------+------+--<br />
42 | a | GET | OEM branding (welcome web page) [128 chars]<br />
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]<br />
-----------+---------+------+--<br />
43 | u32 | GET | NTP-server IP address<br />
43 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
44 | u32 | GET | NTP-client status (0 = NOT synchronized)<br />
44 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)<br />
45 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)<br />
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)<br />
46 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
48..60 | | GET | n/a (reserved)<br />
48..60 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)<br />
61 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
62..63 | | GET | n/a (reserved)<br />
62..63 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
64 | u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #0 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0<br />
-----------+---------+------+--<br />
65 | u32 | GET | get state of the DST automatic (0 = not used) (1 = DST used and DST shift is applied) (2 = DST used but NO shift applied)<br />
65 | u32 | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
66 | u32 | GET | DNS-server IP address<br />
66 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)<br />
67 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)<br />
68 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
69 | | GET | n/a (reserved) <br />
69 | | SET | n/a (reserved) <br />
-----------+---------+------+--<br />
70 | u32 | GET | DNS RESOLV - actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done or finished yet)<br />
70 | u32 | SET | write 0xE4A5ECAC to manually clear the WHOLE internal DNS cache (will force fresh DNS requests once dns_resolv() is again called by your program)<br />
-----------+---------+------+--<br />
71 | u32 | GET | DNS RESOLV - source of the latest IP result, as requested by dns_resolv() function (0 = none, 1 = direct from DNS-server response, 2 = from internal DNS cache)<br />
71 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
72..77 | | GET | n/a (reserved) <br />
72..77 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs<br />
78 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)<br />
79 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84<br />
80 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
81..84 | | GET | n/a (reserved) <br />
81..84 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2<br />
85 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)<br />
86 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program<br />
87 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
88 | | GET | n/a (reserved) <br />
88 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)<br />
89 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)<br />
90 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
91 | u32 | GET | SDS IP-WatchDog: logical output status<br />
91 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
92..131 | | GET | n/a (reserved)<br />
92..131 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
132 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
133 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
134 | a | GET | FC: archived text of the last FC error<br />
134 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)<br />
135 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot<br />
136 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
137 | u32 | GET | read an actual SDS CPU cycle counter (number of executed instructions since power-up/reboot), continuously wraps around, (1 step = approx. 2 nsec)<br />
137 | | SET | n/a<br />
-----------+---------+------+--<br />
138 | u32 | GET | get SDS internal RTC power-on status (0 = invalid data after powerup in RTC) (1 = RTC data OK and were used on powerup) <br />
138 | | SET | n/a<br />
-----------+---------+------+--<br />
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied<br />
139 | | SET | n/a<br />
-----------+---------+------+--<br />
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)<br />
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)<br />
-----------+---------+------+--<br />
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)<br />
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)<br />
-----------+---------+------+--<br />
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)<br />
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)<br />
-----------+---------+------+--<br />
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)<br />
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)<br />
-----------+---------+------+--<br />
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)<br />
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)<br />
-----------+---------+------+--<br />
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)<br />
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)<br />
-----------+---------+------+--<br />
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)<br />
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)<br />
-----------+---------+------+--<br />
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)<br />
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)<br />
-----------+---------+------+--<br />
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)<br />
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)<br />
-----------+---------+------+--<br />
149 | | GET | n/a (reserved)<br />
149 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
150 | | GET | FC: shared-variables access control - read state of the access control<br />
150 | | SET | FC: shared-variables access control - use this to force a user-login in order to access the shared variables (0 = access without login is enabled)<br />
-----------+---------+------+--<br />
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)<br />
151..182 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
183 | u32 | GET | SDS FW date stamp (or just 0x00000000 for a very old firmware) - use this to verify the features or to ask user to update the firmware to a required newer version<br />
183 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
184 | u32 | GET | FC: information about how this actual running program was started (0 = none) (1 = normal) (2 = fc-wdg or manual restart) (4 = freshly loaded)<br />
184 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec<br />
185 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)<br />
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])<br />
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
188 | u32 | GET | PWM3 HW: direct "pulse" register value<br />
188 | | SET | n/a<br />
-----------+---------+------+--<br />
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])<br />
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
190 | u32 | GET | PWM4 HW: direct "pulse" register value<br />
190 | | SET | n/a<br />
-----------+---------+------+--<br />
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)<br />
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])<br />
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value<br />
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value <br />
-----------+---------+------+--<br />
194 | u32 | GET | reserved<br />
194 | | SET | N/A<br />
-----------+---------+------+--<br />
195 | u32 | GET | reserved<br />
195 | | SET | N/A<br />
-----------+---------+------+--<br />
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output<br />
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)<br />
-----------+---------+------+--<br />
229..230 | | GET | n/a (reserved)<br />
229..230 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)<br />
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)<br />
-----------+---------+------+--<br />
263..265 | | GET | n/a (reserved)<br />
263..265 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)<br />
266..297 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
298..300 | | GET | n/a (reserved)<br />
298..300 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin<br />
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)<br />
-----------+---------+------+--<br />
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin<br />
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)<br />
-----------+---------+------+--<br />
303..310 | | GET | n/a (reserved)<br />
303..310 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input<br />
311..342 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
343..374 | a | GET | AD: input identification / name (text)<br />
343..374 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
375..406 | a | GET | AD: input unit name (text)<br />
375..406 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
407..427 | | GET | n/a (reserved)<br />
407..427 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV) <br />
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW<br />
-----------+---------+------+--<br />
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)<br />
429 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)<br />
430 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)<br />
431..438 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant<br />
439..446 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
447..462 | | GET | n/a (reserved)<br />
447..462 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]<br />
463..469 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]<br />
470..476 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]<br />
477..483 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]<br />
484..490 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]<br />
491..497 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]<br />
498..504 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]<br />
505..511 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]<br />
512..518 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
519..991 | | GET | n/a (reserved)<br />
519..991 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)<br />
992 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
993 | u32 | GET | UTC timestamp (localtime) marking a start of yesterday (as a moment since when we capture a new record) (or 0 = if there is no record for yesterday)<br />
993 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
994 | u32 | GET | UTC timestamp (localtime) marking a start of today (or a moment of SDS power on), since when a today's record is captured<br />
994 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])<br />
995 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])<br />
996 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active<br />
997 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active<br />
998 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)<br />
999 | u32 | SET | "manual" control of the global Tariff Input (write/control enabled only if the feature is set in web admin - control set to FULL-C)<br />
-----------+---------+------+--<br />
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff<br />
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff<br />
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses<br />
1064..1095| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse<br />
1096..1127| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1128..1159| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1160..1191| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1192..1223| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1224..1255| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1256..1499| | GET | n/a (reserved)<br />
1256..1499| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1500..1531| a | GET | [S0-input] master configuration struct for this input<br />
1500..1531| a | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1532..1999| | GET | n/a (reserved)<br />
1532..1999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status<br />
2000..2063| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device<br />
2100..2163| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)<br />
2200..2263| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)<br />
2300..2363| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2364..2487| | GET | n/a (reserved)<br />
2364..2487| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)<br />
2488..2495| | SET | n/a <br />
-----------+---------+------+--<br />
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)<br />
2496 | | SET | n/a<br />
-----------+---------+------+--<br />
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)<br />
2497 | | SET | n/a<br />
-----------+---------+------+--<br />
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)<br />
2498 | | SET | n/a<br />
-----------+---------+------+--<br />
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)<br />
2499 | | SET | n/a<br />
-----------+---------+------+--<br />
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status<br />
2500..2563| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device<br />
2600..2663| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)<br />
2700..2763| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)<br />
2800..2863| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2864..2986| | GET | n/a (reserved)<br />
2864..2986| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)<br />
2986..2993| | SET | n/a <br />
-----------+---------+------+--<br />
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)<br />
2994 | | SET | n/a<br />
-----------+---------+------+--<br />
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)<br />
2995 | | SET | n/a<br />
-----------+---------+------+--<br />
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)<br />
2996 | | SET | n/a<br />
-----------+---------+------+--<br />
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)<br />
2997 | | SET | n/a<br />
-----------+---------+------+--<br />
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user<br />
2998 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)<br />
2999 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3000 | | GET | n/a (reserved)<br />
3000 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)<br />
3001 | a | SET | write<br />
-----------+---------+------+--<br />
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)<br />
3002 | a | SET | write<br />
-----------+---------+------+--<br />
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)<br />
3003 | a | SET | write<br />
-----------+---------+------+--<br />
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)<br />
3004 | a | SET | write<br />
-----------+---------+------+--<br />
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)<br />
3005 | a | SET | write<br />
-----------+---------+------+--<br />
3006..3799| | GET | n/a (reserved)<br />
3006..3799| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected<br />
3800 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801<br />
3801 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3802..3849| | GET | n/a (reserved)<br />
3802..3849| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3850 | u32 | GET | SD Card - fully mounted and useable<br />
3850 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3851 | i32 | GET | latest file i/o error code<br />
3851 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)<br />
3852 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3853 | u32 | GET | SD Card - CardType<br />
3853 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3854 | u32 | GET | SD Card - CID - ProductSN<br />
3854 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)<br />
3855 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3856 | u32 | GET | statistic counter: SDcard: failed init attempts<br />
3856 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)<br />
3857 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3858 | u32 | GET | statistic counter: SDcard: sector reads<br />
3858 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3859 | u32 | GET | statistic counter: SDcard: sector writes<br />
3859 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures<br />
3860 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3861 | u32 | GET | statistic counter: number of opened files<br />
3861 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3862..3999| | GET | n/a (reserved)<br />
3862..3999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read<br />
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write<br />
-----------+---------+------+--<br />
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read<br />
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write<br />
-----------+---------+------+--<br />
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read<br />
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write<br />
-----------+---------+------+--<br />
4300..4399| a | GET | Shared Variables: T00 through T99 - read<br />
4300..4399| a | SET | Shared Variables: T00 through T99 - write<br />
-----------+---------+------+--<br />
4400..4989| | GET | n/a (reserved)<br />
4400..4989| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4990..4999| u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #1..#10 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10<br />
-----------+---------+------+--<br />
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write<br />
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read<br />
-----------+-+-------+------+--<br />
5128..11197 | | GET | n/a (reserved)<br />
5128..11197 | | SET | n/a (reserved)<br />
-----------+-+-------+------+--<br />
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ) <br />
11198 | u32 | SET | write ( default: 0b00110001 )<br />
-----------+---------+------+--<br />
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)<br />
11199 | | SET | n/a<br />
-----------+---------+------+--<br />
12200 | i32 | GET | work progress (and result) of mqtt_connect()<br />
12200 | | SET | n/a <br />
-----------+---------+------+--<br />
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()<br />
12201 | | SET | n/a <br />
-----------+---------+------+--<br />
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
12202 | | SET | n/a <br />
-----------+---------+------+--<br />
12203 | i32 | GET | MQTT protocol error counter (informative)<br />
12203 | | SET | n/a <br />
-----------+--+------+------+--<br />
12204..12208 | | GET | n/a (reserved)<br />
12204..12208 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12209 | i32 | GET | Subscribe Table - total number of available rows<br />
12209 | | SET | n/a <br />
-----------+---------+------+--<br />
12210 | a | GET | latest received Topic Name (sent from broker)<br />
12210 | | SET | n/a <br />
-----------+--+------+------+--<br />
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row<br />
12211..12241 | | SET | n/a<br />
--------------+------+------+--<br />
12242..12249 | | GET | n/a (reserved)<br />
12242..12249 | | SET | n/a<br />
-----------+--+------+------+--<br />
12250 | a | GET | latest received Value (sent from broker)<br />
12250 | | SET | n/a <br />
-----------+--+------+------+--<br />
12251..12281 | a | GET | Subscribe Table: actual Value for each table row<br />
12251..12281 | | SET | n/a<br />
--------------+------+------+--<br />
12282..12289 | | GET | n/a (reserved)<br />
12282..12289 | | SET | n/a<br />
-----------+--+------+------+--<br />
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker<br />
12290 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row<br />
12291..12321 | | SET | n/a<br />
--------------+------+--+---+--+--<br />
12322..12398 | | GET | n/a (reserved)<br />
12322..12398 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)<br />
12399 | | SET | n/a <br />
-----------+---------+------+--<br />
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()<br />
12400 | | SET | n/a <br />
-----------+---------+------+--<br />
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
12401 | | SET | n/a <br />
-----------+---------+------+--<br />
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
12402 | | SET | n/a <br />
-----------+---------+------+--<br />
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
12403 | | SET | n/a <br />
-----------+---------+------+--<br />
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
12404 | | SET | n/a <br />
-----------+---------+------+--<br />
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
12405 | | SET | n/a <br />
-----------+---------+------+--<br />
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
12406 | | SET | n/a <br />
-----------+--+------+------+--<br />
12407..12414 | | GET | n/a (reserved)<br />
12407..12414 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
12415 | | SET | n/a <br />
-----------+---------+------+--<br />
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
12416 | | SET | n/a <br />
-----------+--+------+------+--<br />
12417..12462 | | GET | n/a (reserved)<br />
12417..12462 | | SET | n/a (reserved) <br />
-----------+--+------+------+--<br />
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)<br />
12463 | | SET | n/a <br />
-----------+---------+------+--<br />
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)<br />
12464 | | SET | n/a <br />
-----------+---------+------+--<br />
12465 | u/i 32 | GET | timestamp of the latest received message<br />
12465 | | SET | n/a <br />
-----------+---------+------+--<br />
12466 | u/i 32 | GET | a count of received items inside the latest received message<br />
12466 | | SET | n/a <br />
-----------+---------+------+--<br />
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)<br />
12467 | | SET | n/a <br />
-----------+---------+------+--<br />
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)<br />
12468 | | SET | n/a <br />
-----------+---------+------+--<br />
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)<br />
12469 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12470..12719 | i32 (a) | GET | received values (latest received message contents)<br />
12470..12719 | | SET | n/a <br />
--------------+---------+------+--<br />
<br />
<br />
<br />
'''Poznámky''' <br />
<br />
Položky obsahující: "konfigurační struktura" vyžadují dostatečně velký prostor pro uložení výsledku (při zavolání SDS_get_a() funkce). V takovém případě se do vámi určené cílové oblasti ukládá celý "struct" který obsahuje všechny potřebné údaje patřící pod danou položku (názvy, hodnoty, atd.). Pro detaily je nejlépe podívat se přímo na aktuální [[FULL-C:_set_and_get:_detailed|příklady]], které přesně popisují postup pro každý typ takové struktury - a vysvětlují tuto poznámku svým kódem.<br />
<br />
Indexy označené jako '''(a)''' lze ''blokově číst'' (pozor, označené specificky jako "a v závorce"). Vždy ale lze ''blokové čtení'' (tj. čtení více indexů najednou, za sebou, v rámci povoleného rozsahu) provést pouze od prvního indexu v bloku (ne od dalších v bloku).<br />
Příklad: indexy 1000 až 1031 lze přečíst jako jeden souvislý blok, když se začne číst od prvního indexu v bloku (tj. 1000). Počet následně čtených indexů se udává dalším parametrem při volání SDS_get_a() funkce.<br />
Pokud se pokusíte číst blok indexů ne od začátku bloku, čtení selže - pokud blok indexů začíná na 1000 tak musíte požádat o čtení od indexu 1000, přičemž začátek od 1001 a výše selže.<br />
<br />
BackUp-RAM funkce je dostupná je pro firmware který poskytuje verzi FULL-C o hodnotě 0x08 nebo novější. BackUp-RAM je sada 32-bit hodnot, které lze zapisovat a číst, a které jsou (především) uchovány v paměti, která je zálohovaná baterií (tzn. drží hodnotu i po výpadku napájení, tak dlouho než se baterie vybije). Výhodou BackUp-RAM oproti DF je možnost přímého přístupu a rychlosti (naopak DF vyžaduje čtení a zápis celých stránek).<br />
<br />
Sdílené proměnné je potřeba nejprve definovat, aby je šlo použít, a aby k nim šlo přistupovat přes set/get funkce - viz specifická stránka na této wiki.<br />
<br />
Detaily (významy hodnot) pro položky ''MQTT klient'' a ''MODBUS-TCP klient'' jsou rozepsány na příslušných odpovídajících stránkách na této wiki.<br />
<br />
<br />
'''Vysvětlení položek'''<br />
<br />
V tabulce výše jsou uvedeny informace, které naleznete na jednotlivých indexech. Nicméně popisy uvedené v této tabulce jsou velmi zkrácené, a je k nim tedy potřeba mnohem širší vysvětlení.<br />
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).<br />
<br />
<br />
'''Vstupy pro měření napětí'''<br />
<br />
Detaily k A/D vstupům jsou uvedeny [[SDS_2PR:_ADC_vstupy_a_kalibrace|zde]]. Pro psaní programu je důležité mapování '''index'''u na jednotlivé vstupy, viz [[SDS_2PR:_ADC_vstupy_a_kalibrace|tabulka]].<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C_dns_resolv_functions&diff=950FULL-C dns resolv functions2025-08-10T08:19:11Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==<br />
__NOTOC__<br />
<br />
Zařízení SDS umožňuje odeslat dotaz na DNS server, za účelem zjištění IP adresy přidělené k DNS názvu, který je obsahem právě takového dotazu.<br />
<br />
Za tímto účelem jsou k dispozici tyto dvě funkce:<br />
<pre><br />
void dns_resolv(char *domainNameInput);<br />
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);<br />
</pre><br />
<br />
== Princip ==<br />
<br />
SDS odesílá dotaz na DNS server, který je nastaven uživatelem SDS ve webové administraci zařízení (popř. je adresa DNS serveru získána z DHCP serveru, opět záleží na konfiguraci).<br />
<br />
Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.<br />
<br />
<br />
'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''<br />
<br />
<br />
== Příklad ==<br />
<br />
V tomto příkladu odesílá SDS dotaz (textový název domény) na DNS server a zobrazuje případnou získanou odpověď (IP adresu).<br />
<br />
<pre><br />
void main(void)<br />
{<br />
char DNSname[96];<br />
unsigned int status;<br />
unsigned int IP0, IP1, IP2, IP3;<br />
<br />
sprintf((char *)DNSname, "www.google.com");<br />
<br />
printf("RESOLVING %s \n", DNSname);<br />
<br />
// start - select the new DNSname for all the subsequent status function calls<br />
dns_resolv(DNSname);<br />
<br />
// get the first status value<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
// only if truly working, keep waiting<br />
while (512 == status)<br />
{<br />
// keep getting a new status, until it is different than 512<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
}<br />
<br />
// check the final status value<br />
if (513 == status)<br />
{<br />
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);<br />
// only in this case, we can use the IPx address<br />
// ... OK<br />
<br />
// we can print the additional internal DNS cache status, for this particular domain<br />
// note. the value is valid only if the status is 512, otherwise not<br />
unsigned int ttl;<br />
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item <br />
printf("DNS CACHE TTL VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);<br />
} else<br />
{<br />
printf("DNS RESOLV FAILED (error %u) \n", status);<br />
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again<br />
}<br />
<br />
}<br />
</pre><br />
<br />
== Interní DNS cache ==<br />
<br />
Po úspěšném provedení získání DNS překladu, kdy SDS odešle dotaz na určený DNS server, a získá z něj odpověď, <br />
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).<br />
<br />
Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().<br />
<br />
Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS. <br />
<br />
Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.<br />
<br />
Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.<br />
<br />
Toto si řídí SDS interně.<br />
<br />
Váš program tedy vždy, když potřebuje IP adresu pro jakoukoliv doménu, tak vždy musí nejprve zavolat dns_resolv(). Tím se jednak vybere aktuální doména, pro kterou chcete získat platnou aktuální IP adresu (a lze ji tedy přečíst pomocí dns_resolv_status() funkce), a také se spustí mechanismus kontroly interní cache a eventuálního odeslání nového dotazu.<br />
<br />
Nový dotaz není odeslán automaticky, tedy SDS samo neodesílá nové dotazy, když položka v interní DNS cache vyprší. Toto máte plně pod kontrolou vy, a to tak, že voláte funkci dns_resolv(), která se teprve v ten moment (kdy ji ze svého programu zavoláte) rozhodne, jestli bude nový dotaz posílat, nebo ne (čistě dle stavu obsahu interní DNS cache). Pokud v cache není záznam pro danou doménu, nebo je ale už vypršel (TTL na nule), tak dojde k odeslání dotazu, a váš program pak musí čekat na odpověď (viz příklad výše, periodickým voláním dns_resolv_status(), kdy se průběžně zařídí dle vrácené hodnoty od této funkce).<br />
<br />
<br />
== Upozornění ==<br />
<br />
Starší FW mělo bug, kdy při vypršení TTL v interní cache nedošlo ke smazání položky v interni cache. Toto je samozřejmě problém, který je vyřešen v novém firmware.<br />
<br />
DNS cache je (záměrně) vymazána při:<br />
* nahrání nového FULLC programu<br />
* restartu zařízení SDS<br />
<br />
DNS cache není vymazána při výpadku Ethernetového připojení.<br />
<br />
DNS cache lze ručně vymazat zapsáním hodnoty 0xE4A5ECAC do systémové proměnné na indexu [70]. Zápis této speciální hodnoty kompletně smaže interní DNS cache. Tato specifická funkcionalita vyžaduje aktuální firmware (bylo to přidáno až 08/2025).<br />
<br />
<br />
== Stavové hodnoty ==<br />
<br />
Program musí použít volání funkce '''dns_resolv_status''' pro zjištění okamžitého stavu. Dokud nezískáte finální stavovou hodnotu, musíte tuto funkci volat opakovaně (nezapomeňte na vlastní bezpečnostní timeout).<br />
<br />
dns_resolv_status() význam<br />
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------<br />
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)<br />
512 | pracuje, dotaz odeslán (překlad nenalezen v interní cache), čekejte (funkce současně nevrací platnou IP adresu, ta bude až po dokončení překladu)<br />
513 | hotovo OK, do *resolvedIPaddressOutput byla zapsána IP adresa (4 bajty), a záznam v interní cache je platný a živý (zbývající TTL větší než 0)<br />
514 | odpověď nebyla získána (chyba) a současně nemáme záznam v interní DNS cache, takže funkce nevrací platnou IP adresu (musíte znovu začít s dotazem)<br />
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu<br />
516 | dotaz selhal, protože došlo k odpojení Ethernetu<br />
517 | dotaz selhal, protože došlo ke ztrátě vlastní přidělené IP adresy zařízení SDS (typicky když vyprší IP z DHCP a není ještě obnovena)<br />
<br />
<br />
Pokud funkce dns_resolv_status() vrátila hodnotu 513, je možné číst systémovou proměnnou z indexu [70] (uint32_t), která ukáže hodnotu TTL v momentu, kdy tuto hodnotu právě čtete. Lze takto sledovat, jak se postupně TTL snižuje (o 1 každou sekundu). Hodnota TTL odpovídá dané položce v interní cache, která byla určena právě posledním voláním funkce dns_resolv().</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C:_set_and_get&diff=949FULL-C: set and get2025-08-10T08:03:16Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Jak je FULL-C program připojen k hardware ==<br />
<br />
Základním důvodem pro existenci FULL-C programu na zařízení SDS je možnost číst stav hardware (např. opto-vstupy) a také hardware řídit (např. spínat relé).<br />
<br />
Za tímto účelem je k dispozici sada C funkcí, které může program volat a které buď navrátí aktuální stav ("get" funkce), nebo stav změní ("set" funkce).<br />
<br />
Zde je seznam těchto funkcí:<br />
<pre><br />
void SDS_set_i32(unsigned int index, signed int value);<br />
signed int SDS_get_i32(unsigned int index);<br />
<br />
void SDS_set_i64(unsigned int index, int64_t value);<br />
signed int SDS_get_i64(unsigned int index);<br />
<br />
void SDS_set_u32(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u32(unsigned int index);<br />
<br />
void SDS_set_u64(unsigned int index, uint64_t value);<br />
unsigned int SDS_get_u64(unsigned int index);<br />
<br />
void SDS_set_f32(unsigned int index, float value);<br />
float SDS_get_f32(unsigned int index);<br />
<br />
void SDS_set_a(unsigned int index, void *ptr, unsigned int len);<br />
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);<br />
</pre><br />
<br />
Historicky zde původně byly i tyto funkce:<br />
<pre><br />
void SDS_set_i(unsigned int index, signed int value);<br />
signed int SDS_get_i(unsigned int index);<br />
<br />
void SDS_set_u(unsigned int index, unsigned int value);<br />
unsigned int SDS_get_u(unsigned int index);<br />
</pre><br />
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32). <br />
Pokud je váš program používá, vše vám bude fungovat i nadále, ale co nejdříve jejich název ve svém programu přepište na nový.<br />
<br />
<br />
=== Detailní Příklady ===<br />
<br />
Přečtěte si nejprve celou tuto stránku, ať pochopíte princip. Následně se podívejte na [[FULL-C:_set_and_get:_detailed|jednotlivé příklady zde]].<br />
<br />
<br />
== Princip ==<br />
<br />
Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.<br />
<br />
Pod každou položkou (číselným '''index'''em) je schována odpovídající činnost nebo hodnota (např. '''index = 3''' vrátí přes "get" funkci aktuální hodnotu "UpTime", viz tabulka).<br />
<br />
Každá položka však může mít jiný obsah (číslo nebo text): podle toho je potřeba zvolit správný přístup (správnou set\get funkci):<br />
<br />
typ položky | rozsah | typ proměnné | postfix set\get funkce<br />
--------------------------+----------------+-----------------+-------------------------<br />
signed 32-bit integer | -2^31..+2^31 | int | _i32<br />
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32<br />
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64<br />
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64<br />
IP address | uchar[4] | unsigned int | _u32<br />
float | IEEE-754 | float | _f32<br />
string (text) | len\maxlen | void* \ char* | _a<br />
binary array | len\maxlen | void* \ char* | _a<br />
<br />
Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.<br />
<br />
Příklad: chceme zapsat desetinné číslo "numf", v tom případě se jedná o typ "float numf;" a musíme použít ''SDS_set_f(index, numf);''.<br />
<br />
<br />
Varování: ačkoliv je většina indexů podobných jako u SDS (pro pole ''sys[]''), nemají všechny indexy stejný význam mezi SDS-C a FULL-C. Vždy používejte tu správnou tabulku pro každý programovací jazyk.<br />
<br />
<br />
== Funkce _u32 \ _i32 \ _f32 ==<br />
<br />
Základní funkce určené pro získání číselné hodnoty "z" SDS, popř. zápisu číselné hodnoty "do" SDS. Vždy se jedná o kombinaci ''index''u (který určuje o co máme zájem) a hodnoty (která je vždy 32 bitová, tj. 4 bajty, ale obsah těchto 4 bajtů už je různý - buď celočíselná hodnota bez nebo se znaménkem (nejvyšší bit), nebo desetinné číslo - floating point).<br />
<br />
Čtení hodnoty je potřeba pro zjištění aktuálního stavu (např. stav optického vstupu, nebo poslední známá teplota z čidla). Zápis se pak používá pro ovládání (např. sepnutí relé).<br />
<br />
<br />
První příklad: ''čtení'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
unsigned int NTPtime;<br />
NTPtime = SDS_get_u32(4);<br />
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);<br />
</syntaxhighlight><br />
<br />
Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem<br />
<syntaxhighlight lang="c"><br />
int NTPoffset;<br />
NTPoffset = SDS_get_i32(26);<br />
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);<br />
</syntaxhighlight><br />
<br />
Třetí příklad: ''čtení'' float hodnoty<br />
<syntaxhighlight lang="c"><br />
float AD_Rinput__in_user_units;<br />
AD_Rinput__in_user_units = SDS_get_f32(311);<br />
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);<br />
</syntaxhighlight><br />
<br />
Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka<br />
<syntaxhighlight lang="c"><br />
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)<br />
SDS_set_u32(231, 0xFF); <br />
</syntaxhighlight><br />
<br />
Samozřejmě musíte pro každý index použít správný typ hodnoty (tzn.: ''unsigned int'' \ ''int'' \ ''float''). Přesné přiřazení naleznete v tabulce na konci této stránky.<br />
<br />
Pozn.: i když například víte, že hodnota může být například jenom 0 nebo 1 (příklad), tak vždy se zapisuje nebo čte všech 32bitů (unsigned int \ int \ float). Nepoužité bity jsou vždy nastaveny na nulu.<br />
<br />
<br />
== Funkce _u64 \ _i64 ==<br />
<br />
Princip je identický jako pro _u32 a _i32 funkce. <br />
<br />
Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.<br />
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.<br />
<br />
<br />
== Funkce _a ==<br />
<br />
Funkce pracující s polem dat (''SDS_get_a'', ''SDS_set_a'') vyžadují oproti ostatním set+get funkcím specifické parametry. Vždy se jedná o ukazatel na pole dat, a o informaci o velikosti tohoto pole.<br />
<br />
<br />
První příklad: čtení textového parametru<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00<br />
char sysLoc[32];<br />
<br />
// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů<br />
SDS_get_a(2, (void *)sysLoc, 32);<br />
<br />
// a můžeme se podívat na výsledek (výpis do konzole)<br />
printf("Nastavená system location: %s \n", sysLoc);<br />
</syntaxhighlight><br />
<br />
<br />
Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů<br />
<syntaxhighlight lang="c"><br />
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)<br />
unsigned int OPTOvalues[8];<br />
<br />
// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues<br />
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech<br />
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);<br />
<br />
// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)<br />
if (0 == OPTOvalues[0]) ...<br />
</syntaxhighlight><br />
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.<br />
<br />
<br />
Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.<br />
<br />
<br />
<br />
== Úplné detaily a všechny příklady ==<br />
<br />
<br />
<br />
'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.<br />
<br />
<br />
<br />
== Tabulka ==<br />
<br />
Podle typu každé položky lze použít jen právě tu danou specifickou funkci (_i32\_u32\_f32\_a\_i64\_u64), viz následující tabulka. <br />
<br />
Je li také uveden klíč "(a)", lze mimo přístup k jedinému indexu využít blokový přístup pomocí funkce SDS_get_a(), která přečte určený počet indexů za sebou a uloží je do připraveného pole (toho se využívá při blokovém čtení většího počtu za-sebou ležících položek, např. blokové čtení stavu všech optovstupů atd.).<br />
<br />
<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
index | i\u\f\a | dir | comment<br />
-----------+---------+------+--------------------------------------------------------------------------------------------------------<br />
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)<br />
0 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)<br />
1 | | SET | n/a<br />
-----------+---------+------+--<br />
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)<br />
2 | a | GET | sysLocation (user configured text)<br />
2 | | SET | n/a<br />
-----------+---------+------+--<br />
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)<br />
3 | | SET | n/a<br />
-----------+---------+------+--<br />
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds<br />
4 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)<br />
5 | | SET | n/a<br />
-----------+---------+------+--<br />
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)<br />
6 | | SET | n/a<br />
-----------+---------+------+--<br />
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)<br />
7 | | SET | n/a<br />
-----------+---------+------+--<br />
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)<br />
8 | | SET | n/a<br />
-----------+---------+------+--<br />
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)<br />
9 | | SET | n/a<br />
-----------+---------+------+--<br />
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)<br />
10 | | SET | n/a<br />
-----------+---------+------+--<br />
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)<br />
11 | | SET | n/a<br />
-----------+---------+------+--<br />
12 | u32 | GET | SDS device IP address (web admin IP)<br />
12 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
13..15 | | GET | n/a (reserved)<br />
13..15 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
16 | u32 | GET | network gateway IP address<br />
16 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
17..19 | | GET | n/a (reserved)<br />
17..19 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
20 | u32 | GET | network IP MASK<br />
20 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)<br />
21 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
22 | u32 | GET | SNMPv3 - Engine Boots <br />
22 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
23 | u32 | GET | SNMPv3 - Engine Time <br />
23 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
24 | u32 | GET | Ethernet Link Status<br />
24 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)<br />
25 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time<br />
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)<br />
-----------+---------+------+--<br />
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)<br />
27 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
28 | u32 | GET | timestamp of last change (assignment) of IP address <br />
28 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)<br />
29 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
30 | u32 | GET | DHCP lease time (secs) value<br />
30 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)<br />
31 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
32 | u32 | GET | MAC[1]<br />
32 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
33 | u32 | GET | MAC[2]<br />
33 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
34 | u32 | GET | MAC[3]<br />
34 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
35 | u32 | GET | MAC[4]<br />
35 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
36 | u32 | GET | MAC[5]<br />
36 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
37..39 | | GET | n/a (reserved)<br />
37..39 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)<br />
40 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
41 | a | GET | OEM branding (login web page) [32 chars]<br />
41 | a | SET | set custom OEM branding (login web page) [32 chars]<br />
-----------+---------+------+--<br />
42 | a | GET | OEM branding (welcome web page) [128 chars]<br />
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]<br />
-----------+---------+------+--<br />
43 | u32 | GET | NTP-server IP address<br />
43 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
44 | u32 | GET | NTP-client status (0 = NOT synchronized)<br />
44 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)<br />
45 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)<br />
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)<br />
46 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
48..60 | | GET | n/a (reserved)<br />
48..60 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)<br />
61 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
62..63 | | GET | n/a (reserved)<br />
62..63 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
64 | u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #0 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0<br />
-----------+---------+------+--<br />
65 | u32 | GET | get state of the DST automatic (0 = not used) (1 = DST used and DST shift is applied) (2 = DST used but NO shift applied)<br />
65 | u32 | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
66 | u32 | GET | DNS-server IP address<br />
66 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)<br />
67 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)<br />
68 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
69 | | GET | n/a (reserved) <br />
69 | | SET | n/a (reserved) <br />
-----------+---------+------+--<br />
70 | u32 | GET | DNS RESOLV - actual TTL live value (= 1..MAX, in seconds) for the very last resolved DNS name (or 0 = no resolv done/finished yet)<br />
70 | u32 | SET | write 0xE4A5ECAC to manually clear the WHOLE internal DNS cache (will force fresh DNS request once dns_resolv() is called by program)<br />
-----------+---------+------+--<br />
71..77 | | GET | n/a (reserved) <br />
71..77 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs<br />
78 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" / 0 = basic BIG (no DP)<br />
79 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84<br />
80 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
81..84 | | GET | n/a (reserved) <br />
81..84 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2<br />
85 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)<br />
86 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program<br />
87 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
88 | | GET | n/a (reserved) <br />
88 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)<br />
89 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)<br />
90 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
91 | u32 | GET | SDS IP-WatchDog: logical output status<br />
91 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
92..131 | | GET | n/a (reserved)<br />
92..131 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
132 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)<br />
133 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
134 | a | GET | FC: archived text of the last FC error<br />
134 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)<br />
135 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot<br />
136 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
137 | u32 | GET | read an actual SDS CPU cycle counter (number of executed instructions since power-up/reboot), continuously wraps around, (1 step = approx. 2 nsec)<br />
137 | | SET | n/a<br />
-----------+---------+------+--<br />
138 | u32 | GET | get SDS internal RTC power-on status (0 = invalid data after powerup in RTC) (1 = RTC data OK and were used on powerup) <br />
138 | | SET | n/a<br />
-----------+---------+------+--<br />
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied<br />
139 | | SET | n/a<br />
-----------+---------+------+--<br />
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)<br />
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)<br />
-----------+---------+------+--<br />
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)<br />
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)<br />
-----------+---------+------+--<br />
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)<br />
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)<br />
-----------+---------+------+--<br />
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)<br />
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)<br />
-----------+---------+------+--<br />
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)<br />
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)<br />
-----------+---------+------+--<br />
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)<br />
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)<br />
-----------+---------+------+--<br />
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)<br />
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)<br />
-----------+---------+------+--<br />
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)<br />
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)<br />
-----------+---------+------+--<br />
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)<br />
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)<br />
-----------+---------+------+--<br />
149 | | GET | n/a (reserved)<br />
149 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
150 | | GET | FC: shared-variables access control - read state of the access control<br />
150 | | SET | FC: shared-variables access control - use this to force a user-login in order to access the shared variables (0 = access without login is enabled)<br />
-----------+---------+------+--<br />
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)<br />
151..182 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
183 | u32 | GET | SDS FW date stamp (or just 0x00000000 for a very old firmware) - use this to verify the features or to ask user to update the firmware to a required newer version<br />
183 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
184 | u32 | GET | FC: information about how this actual running program was started (0 = none) (1 = normal) (2 = fc-wdg or manual restart) (4 = freshly loaded)<br />
184 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec<br />
185 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)<br />
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])<br />
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
188 | u32 | GET | PWM3 HW: direct "pulse" register value<br />
188 | | SET | n/a<br />
-----------+---------+------+--<br />
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])<br />
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
190 | u32 | GET | PWM4 HW: direct "pulse" register value<br />
190 | | SET | n/a<br />
-----------+---------+------+--<br />
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)<br />
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])<br />
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)<br />
-----------+---------+------+--<br />
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value<br />
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value <br />
-----------+---------+------+--<br />
194 | u32 | GET | reserved<br />
194 | | SET | N/A<br />
-----------+---------+------+--<br />
195 | u32 | GET | reserved<br />
195 | | SET | N/A<br />
-----------+---------+------+--<br />
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output<br />
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)<br />
-----------+---------+------+--<br />
229..230 | | GET | n/a (reserved)<br />
229..230 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)<br />
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)<br />
-----------+---------+------+--<br />
263..265 | | GET | n/a (reserved)<br />
263..265 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)<br />
266..297 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
298..300 | | GET | n/a (reserved)<br />
298..300 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin<br />
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)<br />
-----------+---------+------+--<br />
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin<br />
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)<br />
-----------+---------+------+--<br />
303..310 | | GET | n/a (reserved)<br />
303..310 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input<br />
311..342 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
343..374 | a | GET | AD: input identification / name (text)<br />
343..374 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
375..406 | a | GET | AD: input unit name (text)<br />
375..406 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
407..427 | | GET | n/a (reserved)<br />
407..427 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV) <br />
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW<br />
-----------+---------+------+--<br />
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)<br />
429 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)<br />
430 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)<br />
431..438 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant<br />
439..446 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
447..462 | | GET | n/a (reserved)<br />
447..462 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]<br />
463..469 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]<br />
470..476 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]<br />
477..483 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]<br />
484..490 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]<br />
491..497 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]<br />
498..504 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]<br />
505..511 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]<br />
512..518 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
519..991 | | GET | n/a (reserved)<br />
519..991 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)<br />
992 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
993 | u32 | GET | UTC timestamp (localtime) marking a start of yesterday (as a moment since when we capture a new record) (or 0 = if there is no record for yesterday)<br />
993 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
994 | u32 | GET | UTC timestamp (localtime) marking a start of today (or a moment of SDS power on), since when a today's record is captured<br />
994 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])<br />
995 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])<br />
996 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active<br />
997 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active<br />
998 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)<br />
999 | u32 | SET | "manual" control of the global Tariff Input (write/control enabled only if the feature is set in web admin - control set to FULL-C)<br />
-----------+---------+------+--<br />
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff<br />
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff<br />
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff<br />
-----------+---------+------+--<br />
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses<br />
1064..1095| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse<br />
1096..1127| | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1128..1159| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])<br />
1160..1191| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1192..1223| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now<br />
1224..1255| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1256..1499| | GET | n/a (reserved)<br />
1256..1499| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1500..1531| a | GET | [S0-input] master configuration struct for this input<br />
1500..1531| a | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
1532..1999| | GET | n/a (reserved)<br />
1532..1999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status<br />
2000..2063| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device<br />
2100..2163| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)<br />
2200..2263| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)<br />
2300..2363| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2364..2487| | GET | n/a (reserved)<br />
2364..2487| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)<br />
2488..2495| | SET | n/a <br />
-----------+---------+------+--<br />
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)<br />
2496 | | SET | n/a<br />
-----------+---------+------+--<br />
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)<br />
2497 | | SET | n/a<br />
-----------+---------+------+--<br />
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)<br />
2498 | | SET | n/a<br />
-----------+---------+------+--<br />
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)<br />
2499 | | SET | n/a<br />
-----------+---------+------+--<br />
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status<br />
2500..2563| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device<br />
2600..2663| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)<br />
2700..2763| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)<br />
2800..2863| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2864..2986| | GET | n/a (reserved)<br />
2864..2986| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)<br />
2986..2993| | SET | n/a <br />
-----------+---------+------+--<br />
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)<br />
2994 | | SET | n/a<br />
-----------+---------+------+--<br />
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)<br />
2995 | | SET | n/a<br />
-----------+---------+------+--<br />
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)<br />
2996 | | SET | n/a<br />
-----------+---------+------+--<br />
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)<br />
2997 | | SET | n/a<br />
-----------+---------+------+--<br />
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user<br />
2998 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)<br />
2999 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3000 | | GET | n/a (reserved)<br />
3000 | | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)<br />
3001 | a | SET | write<br />
-----------+---------+------+--<br />
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)<br />
3002 | a | SET | write<br />
-----------+---------+------+--<br />
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)<br />
3003 | a | SET | write<br />
-----------+---------+------+--<br />
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)<br />
3004 | a | SET | write<br />
-----------+---------+------+--<br />
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)<br />
3005 | a | SET | write<br />
-----------+---------+------+--<br />
3006..3799| | GET | n/a (reserved)<br />
3006..3799| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected<br />
3800 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801<br />
3801 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3802..3849| | GET | n/a (reserved)<br />
3802..3849| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
3850 | u32 | GET | SD Card - fully mounted and useable<br />
3850 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3851 | i32 | GET | latest file i/o error code<br />
3851 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)<br />
3852 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3853 | u32 | GET | SD Card - CardType<br />
3853 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3854 | u32 | GET | SD Card - CID - ProductSN<br />
3854 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)<br />
3855 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3856 | u32 | GET | statistic counter: SDcard: failed init attempts<br />
3856 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)<br />
3857 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3858 | u32 | GET | statistic counter: SDcard: sector reads<br />
3858 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3859 | u32 | GET | statistic counter: SDcard: sector writes<br />
3859 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures<br />
3860 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3861 | u32 | GET | statistic counter: number of opened files<br />
3861 | | SET | n/a (read-only)<br />
-----------+---------+------+--<br />
3862..3999| | GET | n/a (reserved)<br />
3862..3999| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read<br />
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write<br />
-----------+---------+------+--<br />
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read<br />
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write<br />
-----------+---------+------+--<br />
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read<br />
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write<br />
-----------+---------+------+--<br />
4300..4399| a | GET | Shared Variables: T00 through T99 - read<br />
4300..4399| a | SET | Shared Variables: T00 through T99 - write<br />
-----------+---------+------+--<br />
4400..4989| | GET | n/a (reserved)<br />
4400..4989| | SET | n/a (reserved)<br />
-----------+---------+------+--<br />
4990..4999| u32 | GET | read this to get a value of an automatic SECOND DOWN-COUNTER #1..#10 (it does decrease its internal value by 1 for each 1 second, down to 0 where it stays, until restarted by writing)<br />
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10<br />
-----------+---------+------+--<br />
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write<br />
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read<br />
-----------+-+-------+------+--<br />
5128..11197 | | GET | n/a (reserved)<br />
5128..11197 | | SET | n/a (reserved)<br />
-----------+-+-------+------+--<br />
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN ) <br />
11198 | u32 | SET | write ( default: 0b00110001 )<br />
-----------+---------+------+--<br />
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)<br />
11199 | | SET | n/a<br />
-----------+---------+------+--<br />
12200 | i32 | GET | work progress (and result) of mqtt_connect()<br />
12200 | | SET | n/a <br />
-----------+---------+------+--<br />
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()<br />
12201 | | SET | n/a <br />
-----------+---------+------+--<br />
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()<br />
12202 | | SET | n/a <br />
-----------+---------+------+--<br />
12203 | i32 | GET | MQTT protocol error counter (informative)<br />
12203 | | SET | n/a <br />
-----------+--+------+------+--<br />
12204..12208 | | GET | n/a (reserved)<br />
12204..12208 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12209 | i32 | GET | Subscribe Table - total number of available rows<br />
12209 | | SET | n/a <br />
-----------+---------+------+--<br />
12210 | a | GET | latest received Topic Name (sent from broker)<br />
12210 | | SET | n/a <br />
-----------+--+------+------+--<br />
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row<br />
12211..12241 | | SET | n/a<br />
--------------+------+------+--<br />
12242..12249 | | GET | n/a (reserved)<br />
12242..12249 | | SET | n/a<br />
-----------+--+------+------+--<br />
12250 | a | GET | latest received Value (sent from broker)<br />
12250 | | SET | n/a <br />
-----------+--+------+------+--<br />
12251..12281 | a | GET | Subscribe Table: actual Value for each table row<br />
12251..12281 | | SET | n/a<br />
--------------+------+------+--<br />
12282..12289 | | GET | n/a (reserved)<br />
12282..12289 | | SET | n/a<br />
-----------+--+------+------+--<br />
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker<br />
12290 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row<br />
12291..12321 | | SET | n/a<br />
--------------+------+--+---+--+--<br />
12322..12398 | | GET | n/a (reserved)<br />
12322..12398 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)<br />
12399 | | SET | n/a <br />
-----------+---------+------+--<br />
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()<br />
12400 | | SET | n/a <br />
-----------+---------+------+--<br />
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);<br />
12401 | | SET | n/a <br />
-----------+---------+------+--<br />
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);<br />
12402 | | SET | n/a <br />
-----------+---------+------+--<br />
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);<br />
12403 | | SET | n/a <br />
-----------+---------+------+--<br />
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);<br />
12404 | | SET | n/a <br />
-----------+---------+------+--<br />
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);<br />
12405 | | SET | n/a <br />
-----------+---------+------+--<br />
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);<br />
12406 | | SET | n/a <br />
-----------+--+------+------+--<br />
12407..12414 | | GET | n/a (reserved)<br />
12407..12414 | | SET | n/a (reserved)<br />
-----------+--+------+------+--<br />
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);<br />
12415 | | SET | n/a <br />
-----------+---------+------+--<br />
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);<br />
12416 | | SET | n/a <br />
-----------+--+------+------+--<br />
12417..12462 | | GET | n/a (reserved)<br />
12417..12462 | | SET | n/a (reserved) <br />
-----------+--+------+------+--<br />
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)<br />
12463 | | SET | n/a <br />
-----------+---------+------+--<br />
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)<br />
12464 | | SET | n/a <br />
-----------+---------+------+--<br />
12465 | u/i 32 | GET | timestamp of the latest received message<br />
12465 | | SET | n/a <br />
-----------+---------+------+--<br />
12466 | u/i 32 | GET | a count of received items inside the latest received message<br />
12466 | | SET | n/a <br />
-----------+---------+------+--<br />
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)<br />
12467 | | SET | n/a <br />
-----------+---------+------+--<br />
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)<br />
12468 | | SET | n/a <br />
-----------+---------+------+--<br />
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)<br />
12469 | | SET | n/a <br />
-----------+--+------+--+---+--+--<br />
12470..12719 | i32 (a) | GET | received values (latest received message contents)<br />
12470..12719 | | SET | n/a <br />
--------------+---------+------+--<br />
<br />
<br />
<br />
'''Poznámky''' <br />
<br />
Položky obsahující: "konfigurační struktura" vyžadují dostatečně velký prostor pro uložení výsledku (při zavolání SDS_get_a() funkce). V takovém případě se do vámi určené cílové oblasti ukládá celý "struct" který obsahuje všechny potřebné údaje patřící pod danou položku (názvy, hodnoty, atd.). Pro detaily je nejlépe podívat se přímo na aktuální [[FULL-C:_set_and_get:_detailed|příklady]], které přesně popisují postup pro každý typ takové struktury - a vysvětlují tuto poznámku svým kódem.<br />
<br />
Indexy označené jako '''(a)''' lze ''blokově číst'' (pozor, označené specificky jako "a v závorce"). Vždy ale lze ''blokové čtení'' (tj. čtení více indexů najednou, za sebou, v rámci povoleného rozsahu) provést pouze od prvního indexu v bloku (ne od dalších v bloku).<br />
Příklad: indexy 1000 až 1031 lze přečíst jako jeden souvislý blok, když se začne číst od prvního indexu v bloku (tj. 1000). Počet následně čtených indexů se udává dalším parametrem při volání SDS_get_a() funkce.<br />
Pokud se pokusíte číst blok indexů ne od začátku bloku, čtení selže - pokud blok indexů začíná na 1000 tak musíte požádat o čtení od indexu 1000, přičemž začátek od 1001 a výše selže.<br />
<br />
BackUp-RAM funkce je dostupná je pro firmware který poskytuje verzi FULL-C o hodnotě 0x08 nebo novější. BackUp-RAM je sada 32-bit hodnot, které lze zapisovat a číst, a které jsou (především) uchovány v paměti, která je zálohovaná baterií (tzn. drží hodnotu i po výpadku napájení, tak dlouho než se baterie vybije). Výhodou BackUp-RAM oproti DF je možnost přímého přístupu a rychlosti (naopak DF vyžaduje čtení a zápis celých stránek).<br />
<br />
Sdílené proměnné je potřeba nejprve definovat, aby je šlo použít, a aby k nim šlo přistupovat přes set/get funkce - viz specifická stránka na této wiki.<br />
<br />
Detaily (významy hodnot) pro položky ''MQTT klient'' a ''MODBUS-TCP klient'' jsou rozepsány na příslušných odpovídajících stránkách na této wiki.<br />
<br />
<br />
'''Vysvětlení položek'''<br />
<br />
V tabulce výše jsou uvedeny informace, které naleznete na jednotlivých indexech. Nicméně popisy uvedené v této tabulce jsou velmi zkrácené, a je k nim tedy potřeba mnohem širší vysvětlení.<br />
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).<br />
<br />
<br />
'''Vstupy pro měření napětí'''<br />
<br />
Detaily k A/D vstupům jsou uvedeny [[SDS_2PR:_ADC_vstupy_a_kalibrace|zde]]. Pro psaní programu je důležité mapování '''index'''u na jednotlivé vstupy, viz [[SDS_2PR:_ADC_vstupy_a_kalibrace|tabulka]].<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=FULL-C_dns_resolv_functions&diff=948FULL-C dns resolv functions2025-08-10T08:01:54Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS. <br />
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.<br />
<br />
== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==<br />
__NOTOC__<br />
<br />
Zařízení SDS umožňuje odeslat dotaz na DNS server, za účelem zjištění IP adresy přidělené k DNS názvu, který je obsahem právě takového dotazu.<br />
<br />
Za tímto účelem jsou k dispozici tyto dvě funkce:<br />
<pre><br />
void dns_resolv(char *domainNameInput);<br />
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);<br />
</pre><br />
<br />
== Princip ==<br />
<br />
SDS odesílá dotaz na DNS server, který je nastaven uživatelem SDS ve webové administraci zařízení (popř. je adresa DNS serveru získána z DHCP serveru, opět záleží na konfiguraci).<br />
<br />
Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.<br />
<br />
<br />
== Příklad ==<br />
<br />
V tomto příkladu odesílá SDS dotaz (textový název domény) na DNS server a zobrazuje případnou získanou odpověď (IP adresu).<br />
<br />
<pre><br />
void main(void)<br />
{<br />
char DNSname[64];<br />
unsigned int status;<br />
unsigned int IP0, IP1, IP2, IP3;<br />
<br />
sprintf((char *)DNSname, "www.google.com");<br />
<br />
printf("RESOLVING %s \n", DNSname);<br />
<br />
// start - select the new DNSname for all the subsequent status function calls<br />
dns_resolv(DNSname);<br />
<br />
// get the first status value<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
// only if truly working, keep waiting<br />
while (512 == status)<br />
{<br />
// keep getting a new status, until it is different than 512<br />
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);<br />
}<br />
<br />
// check the final status value<br />
if (513 == status)<br />
{<br />
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);<br />
// only in this case, we can use the IPx address<br />
// ... OK<br />
<br />
// we can print the additional internal DNS cache status, for this particular domain<br />
// note. the value is valid only if the status is 512, otherwise not<br />
unsigned int ttl;<br />
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item <br />
printf("DNS CACHE TTL VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);<br />
} else<br />
{<br />
printf("DNS RESOLV FAILED (error %u) \n", status);<br />
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again<br />
}<br />
<br />
}<br />
</pre><br />
<br />
== Interní DNS cache ==<br />
<br />
Po úspěšném provedení získání DNS překladu, kdy SDS odešle dotaz na určený DNS server, a získá z něj odpověď, <br />
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).<br />
<br />
Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().<br />
<br />
Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS. <br />
<br />
Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.<br />
<br />
Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.<br />
<br />
Toto si řídí SDS interně.<br />
<br />
Váš program tedy vždy, když potřebuje IP adresu pro jakoukoliv doménu, tak vždy musí nejprve zavolat dns_resolv(). Tím se jednak vybere aktuální doména, pro kterou chcete získat platnou aktuální IP adresu (a lze ji tedy přečíst pomocí dns_resolv_status() funkce), a také se spustí mechanismus kontroly interní cache a eventuálního odeslání nového dotazu.<br />
<br />
Nový dotaz není odeslán automaticky, tedy SDS samo neodesílá nové dotazy, když položka v interní DNS cache vyprší. Toto máte plně pod kontrolou vy, a to tak, že voláte funkci dns_resolv(), která se teprve v ten moment (kdy ji ze svého programu zavoláte) rozhodne, jestli bude nový dotaz posílat, nebo ne (čistě dle stavu obsahu interní DNS cache). Pokud v cache není záznam pro danou doménu, nebo je ale už vypršel (TTL na nule), tak dojde k odeslání dotazu, a váš program pak musí čekat na odpověď (viz příklad výše, periodickým voláním dns_resolv_status(), kdy se průběžně zařídí dle vrácené hodnoty od této funkce).<br />
<br />
<br />
== Upozornění ==<br />
<br />
Starší FW mělo bug, kdy při vypršení TTL v interní cache nedošlo ke smazání položky v interni cache. Toto je samozřejmě problém, který je vyřešen v novém firmware.<br />
<br />
DNS cache je (záměrně) vymazána při:<br />
* nahrání nového FULLC programu<br />
* restartu zařízení SDS<br />
<br />
DNS cache není vymazána při výpadku Ethernetového připojení.<br />
<br />
DNS cache lze ručně vymazat zapsáním hodnoty 0xE4A5ECAC do systémové proměnné na indexu [70]. Zápis této speciální hodnoty kompletně smaže interní DNS cache. Tato specifická funkcionalita vyžaduje aktuální firmware (bylo to přidáno až 08/2025).<br />
<br />
<br />
== Stavové hodnoty ==<br />
<br />
Program musí použít volání funkce '''dns_resolv_status''' pro zjištění okamžitého stavu. Dokud nezískáte finální stavovou hodnotu, musíte tuto funkci volat opakovaně (nezapomeňte na vlastní bezpečnostní timeout).<br />
<br />
dns_resolv_status() význam<br />
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------<br />
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)<br />
512 | pracuje, dotaz odeslán (překlad nenalezen v interní cache), čekejte (funkce současně nevrací platnou IP adresu, ta bude až po dokončení překladu)<br />
513 | hotovo OK, do *resolvedIPaddressOutput byla zapsána IP adresa (4 bajty), a záznam v interní cache je platný a živý (zbývající TTL větší než 0)<br />
514 | odpověď nebyla získána (chyba) a současně nemáme záznam v interní DNS cache, takže funkce nevrací platnou IP adresu (musíte znovu začít s dotazem)<br />
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu<br />
<br />
<br />
Pokud funkce dns_resolv_status() vrátila hodnotu 513, je možné číst systémovou proměnnou z indexu [70] (uint32_t), která ukáže hodnotu TTL v momentu, kdy tuto hodnotu právě čtete. Lze takto sledovat, jak se postupně TTL snižuje (o 1 každou sekundu). Hodnota TTL odpovídá dané položce v interní cache, která byla určena právě posledním voláním funkce dns_resolv().</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_BIG:_firmware_changelog&diff=947SDS BIG: firmware changelog2025-03-28T18:57:51Z<p>Adamn: </p>
<hr />
<div>== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-BIG a SDS-SMALL a SDS-STSW.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
<br />
== 28.3.2025 ==<br />
* oprava odpovědi pro S-UDP příkaz 0x04 (Read FC)<br />
<br />
== 15.3.2025 ==<br />
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)<br />
<br />
== 27.2.2025 ==<br />
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)<br />
* 512: oprava nefunkčního čtení ze sériové linky COM6<br />
<br />
== 8.2.2025 ==<br />
* oprava některých payloadů v protokolu SUDP <br />
<br />
== 22.7.2024 ==<br />
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB<br />
* možnost volby klidového stavu pro každý S0 vstup (umožňuje počítat impulsy i pro NC spínače v měřiči energie)<br />
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli<br />
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)<br />
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou<br />
<br />
== 24.2.2024 ==<br />
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)<br />
* RSTD nesmaže (nanastaví na tovární hodnoty) vaše nastavení pro všechny AD vstupy (to lze teď udělat ručně, nově přidaným tlačítkem ve webovém rozhraní)<br />
<br />
== 31.10.2023 ==<br />
* SNMP - oprava způsobu předání chyby v odpovědi<br />
* SNMP v1 - možnost nastavit dvě nezávislé komunity<br />
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)<br />
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)<br />
* FC: indexy 66, 67, 68, 4990..4999<br />
<br />
== 19.8.2023 ==<br />
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)<br />
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)<br />
<br />
== 14.7.2023 ==<br />
* HTTP POST: oprava sekundární chyby (objevila se ve FW 6.6.2023), kdy FW akceptoval jen rozdělený krok č. 2 (teď už opět umí jak rozdělený, tak i nerozdělený krok č. 2)<br />
* FC: umožněn přímý zápisu do indexu 193 (přímo zapíše do registru PWM - určeno pro nejjemnější uživatelskou přímo konfiguraci generátoru PWM)<br />
<br />
== 6.6.2023 ==<br />
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků<br />
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20<br />
* 512: další zvětšení FC konzole<br />
* webový admin: úprava (oprava) použití timerů v javascriptu <br />
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)<br />
* HTTP POST: poradí si i s ne-oddělenou komunikací (když klient pošle úvodní konverzační data najednou, neodděleně, tzn. nečeká na odpověď ze serveru)<br />
<br />
== 9.3.2023 ==<br />
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()<br />
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci<br />
<br />
== 28.2.2023 ==<br />
* POST: přidán příkaz /wrdf<br />
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip<br />
* malá bezpečnostní aktualizace<br />
<br />
== 9.1.2023 ==<br />
* FC verze 0x11 (+ odpovídající FULLC.EXE)<br />
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84<br />
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení <br />
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84<br />
* FC: doplněna funkčnost FC WatchDog (pro situaci, pokud spadne program na chybu a je zastaven, tak FC Watchdog pokračuje a provede restart FC programu)<br />
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)<br />
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)<br />
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení<br />
* HW BIG2 DS84: RTC běží na baterii na všech HW variantách DS84 - udržuje běžící aktuální čas i při vypnutém napájení<br />
* FC: přidána funkce SDS_onewire_search_bus()<br />
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997<br />
<br />
== 1.12.2022 ==<br />
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)<br />
* trvalé zobrazení archivovaného HW faultu v Logu (pokud dojde k faultu, je hned před restartem zařízení archivován a trvale zobrazován ve výpisu, i po libovolném novém spuštění)<br />
* odstraněno eventuální čekání (a následný WDG restart) při komunikaci s externími I2C zařízeními (specifické chipy na sandwich deskách uživatelů)<br />
<br />
== 30.11.2022 ==<br />
* FC: zvýšena výkonnost (512: optimalizace pro až několika-násobné celkové zrychlení vykonávání programu) (64,128: byť jen menší zrychlení, ale přece + zvětšená konzole echo.htm) <br />
* zrychleno webové rozhraní (zpomaleno zřejmě o dvě verze zpět, byť to bylo bez vlivu na funkci, je vhodnější když to nezdržuje při zobrazování v prohlížeči)<br />
* FC: přidán index 137<br />
* zlepšena interní obsluha sériových linek (COMx/RS485), odstraněno možné náhodné zpoždění (byť jen ve specifickém případě a jen o několik msec, ale i tak se toto vyřešilo)<br />
<br />
== 22.11.2022 ==<br />
* FC (64/128/512): verze 0x10 <br />
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu<br />
<br />
== 18.11.2022 ==<br />
* FC (64/128): verze 0x10 <br />
* FC: nová funkce SDS_set_RTC<br />
* FC: nové funkce pro práci s float<br />
* oprava pro mounting některých typů SD karet<br />
<br />
== 14.11.2022 ==<br />
* FC: oprava výpočtů v 64-bit doméně<br />
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot<br />
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty<br />
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem<br />
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki<br />
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm<br />
<br />
== 16.10.2022 ==<br />
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP<br />
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)<br />
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat<br />
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)<br />
* FC: zápis do indexu 999 funguje jak má<br />
* FC: verze 0x0F (nové funkce PWMx)<br />
<br />
== 5.10.2022 ==<br />
* pouze vše řady 512 (ostatní bez tohoto problému) - důležitá oprava situace kdy někdy chybně došlo ke smazání nahraného FC programu při nahrání nového UWEB projektu do SDS<br />
<br />
== 30.9.2022 ==<br />
* FC: oprava běhu programu v situaci kdy v kódu je vnořený (nested) switch() v rámci jiného switch() (původně chybné chování, teď opraveno)<br />
<br />
== 28.9.2022 ==<br />
* FC: oprava výsledků maker (define), kdy chybně docházelo k pevnému přetypování na int32_t, což je teď opraveno (odstraněno)<br />
<br />
== 1.8.2022 ==<br />
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace<br />
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)<br />
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)<br />
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)<br />
<br />
== 11.7.2022 ==<br />
* FC: verze 0x0E<br />
* FC: přidána funkce mktime()<br />
* FC: přidána funkce gmtime()<br />
* FC: přidána funkce localtime()<br />
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg<br />
<br />
== 1.7.2022 ==<br />
* FC: verze 0x0D<br />
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky<br />
* FC: přidána funkce SDS_TOPB_keyboard_updn()<br />
* FC: přidána funkce SDS_rescan_onewire()<br />
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE<br />
* BIG 64/128 prodloužen čas pro sestavení Ethernetového spojení, což řeší problém s některými USB síťovými kartami atd.<br />
* opraveno HTTP POST nastavení položek NTP<br />
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho<br />
<br />
== 12.4.2022 ==<br />
* doplněna informační stránka o vnitřním stavu OneWire Master (pro snazší identifikaci problémů při používání sběrnice)<br />
* oprava v bootloaderu pro řadu 512 - vyžaduje přeprogramování u výrobce pro všechna SDS řady 512 s FW starším než 14.2.2022<br />
<br />
== 3.4.2022 ==<br />
* FC verze 0x0C<br />
* FC: přidána funkce SDS_I2C_rw<br />
* OneWire stabilnější<br />
<br />
== 21.1.2022 ==<br />
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí<br />
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])<br />
<br />
== 18.1.2022 ==<br />
* RSTD zapíše do NVM všechny konfigurační položky (i to co nenuluje), pro jistotu že v NVM bude vše skutečně zapsáno<br />
* načítání konfigurace upraveno (větší spolehlivost)<br />
<br />
== 15.1.2022 ==<br />
* přidána stránka cfgstatus.htm - pro možnost kontroly stavu uložené konfigurace v pevné paměti (např. co nemáte uloženo)<br />
* přidán M2M výstup ip.xml<br />
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()<br />
* FC: každý program má unikátní identifikátor, podle kterého lze např. kontrolovat či zpětně poznat co máte v SDS nahráno<br />
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace<br />
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech<br />
* SNMP: nové položky .8.90 , .8.91 , .8.99<br />
* FC: nové get(u32) položky 2 a 87<br />
<br />
== 31.12.2021 ==<br />
* možnost vyřadit NTP z činnosti zadáním adresy 127.0.0.1 (vhodné pro uživatele kteří získávají čas odjinud, např. přes LoRA)<br />
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)<br />
* web: opraven zámek zvětšené konzole (echo)<br />
* důslednější kontrola platnosti konfigurace při startu<br />
<br />
== 27.12.2021 ==<br />
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)<br />
* FC: několikanásobně zvětšena konzole (echo.htm)<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (aktualizace bootloaderu jen prostřednictvím přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
* vydána varianta 512 - vlastní soubor s firmware<br />
<br />
== 25.12.2021 ==<br />
* pouze interní vydání<br />
<br />
== 26.3.2021 ==<br />
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)<br />
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C<br />
<br />
== 9.2.2021 ==<br />
* FC: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* FC: drobná úspora heap (více dostupného místa)<br />
* FC: dns resolv drobný fix<br />
* FC: http_get a http_post důležitý fix<br />
* FC: nová funkce http_close<br />
* FC: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)<br />
<br />
== 22.12.2020 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "FULL-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off)<br />
* security fix<br />
<br />
== 10.12.2020 ==<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení<br />
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci<br />
* počítání délky aktivace tarifního vstupu (doba T0 a T1 v sekundách za den) viz nové sys, pozor pro funkci vyžaduje NTP<br />
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP<br />
<br />
== 23.11.2020 ==<br />
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou<br />
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)<br />
* FC: detekce nesprávné dereference ukazatele<br />
<br />
== 14.11.2020 ==<br />
* webová administrace: stránka p=42: index ck03 se propíše i do nastavení (chybělo od 23.10.2020, web byl aktualizován, nastavení ale přebíralo ck00)<br />
<br />
== 4.11.2020 ==<br />
* FC + FULLC.exe: odstraněn problém při načtení nahraného FULL-C programu v SDS, kdy dříve mohlo u jedné specifické velikosti nahraného programu, dojít k jeho nespuštění kvůli neodpovídajícímu crc<br />
<br />
== 3.11.2020 ==<br />
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)<br />
* FULLC.exe: odstraněno omezení na 255 znaků na řádek<br />
* FULLC.exe: zrychlení nahrávání do SDS<br />
<br />
== 23.10.2020 ==<br />
* webová administrace: stránka p=42: změna indexu ck00 na ck03 ať se dají uživatelským skriptem všechny prvky samostatně rozlišit<br />
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST<br />
<br />
== 14.10.2020 ==<br />
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)<br />
<br />
== 13.10.2020 ==<br />
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)<br />
<br />
== 13.9.2020 ==<br />
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)<br />
<br />
== 9.8.2020 ==<br />
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)<br />
* různé drobné opravy a zabezpečení<br />
* zobrazení auditlogu (webové rozhraní SDS)<br />
* FC: http_post<br />
* FC: MQTT klient<br />
* FC: MODBUS-TCP klient<br />
<br />
== 4.8.2020 ==<br />
* úprava obsluhy relé<br />
* podpora OneWire modulu SDS-1W-T-RH<br />
<br />
== 3.10.2019 ==<br />
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)<br />
* RSTD při zapnutí zařízení, ve kterém není záložní baterie (nebo je vybitá), zachová původně nastavenou MAC adresu (vše ostatní ale už jde do defaultu, což je správně)<br />
* SUDP: rozšířen NOP příkaz <br />
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)<br />
<br />
== 23.9.2019 ==<br />
* oprava GUI (S0 Inputs)<br />
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)<br />
* opraven nefunkční RSTD na modulu STSW-rev3<br />
<br />
== 23.6.2019 ==<br />
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy<br />
<br />
== 28.5.2019 ==<br />
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)<br />
<br />
== 5.5.2019 ==<br />
* dořešeno hlídání stavu (načtení, atd.) SD karty i v případě provozu náročného FULL-C programu (tedy i pro hluboce vnořené smyčky)<br />
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"<br />
<br />
== 24.2.2019 ==<br />
* překlopení z BETA do oficiálního FW<br />
* automatika zimní/letní čas<br />
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.) <br />
* přístup na SD kartu: web server zobrazuje soubory ze SD karty (vše ve složce \web\ a podsložkách této složky)<br />
* oprava čtení napětí baterie pro variantu 128K<br />
* shared.xml<br />
* odstraněno omezení délky ve shared.txt<br />
* zprovozněno getsv<br />
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: nová možnost způsobu čtení teploty SoC<br />
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.<br />
* FULL-C: doplněné set/get funkce pro sdílené proměnné<br />
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float<br />
* FULL-C: funkce pro reset FC programu<br />
* FULL-C: funkce pro watchdog FC programu<br />
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)<br />
<br />
== 1.7.2018 ==<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím) <br />
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS<br />
<br />
== 27.6.2018 ==<br />
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: přidána podpora pro int64_t a uint64_t<br />
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)<br />
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)<br />
* drobné opravy<br />
* drobná oprava v odchozím TCP-SYN a v generátoru ISN<br />
<br />
== 8.3.2018 ==<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 11.2.2017 ==<br />
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)<br />
<br />
== 21.12.2017 ==<br />
* zvýšena stabilita spuštění po zapnutí<br />
<br />
== 20.12.2017 ==<br />
* dočasná změna ve FULL-C (bude zrušena): funkce snprintf() má interně posunutý limit délky zápisu o 1 (toto je záměrný rozdíl proti C99). Změna v SDS je provedena z důvodu neznalosti programátorů FC v tom, že do snprintf() limitu je potřeba započítat i jeden byte pro ukončující nulu. Ve výsledku tedy zápis "snprintf(buf, limit, ...);" je v FC interně vykonán jako "snprintf(buf, limit+1, ...);".<br />
* oprava ve FULL-C: výpočet platné délky bufferu funguje i pro ukazatele vytvořené offsetem ze základní alokované adresy (příklad takového bufferu je: buf=malloc(x)+offset;)<br />
* stav všech relé je načten z paměti vždy po zapnutí modulu, a ty relé které jsou ručně ovládány (manual control) a které byly před vypnutím v zapnutém (ON) stavu, jsou po zapnutí modulu aktivovány (zatímco relé ovládané z IP-W a FC jsou vždy po zapnutí modulu uvedeny do OFF stavu)<br />
<br />
== 18.12.2017 ==<br />
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů) <br />
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)<br />
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje<br />
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")<br />
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")<br />
<br />
== 18.9.2017 ==<br />
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)<br />
* FULL-C: snprint() opraven (když je 'from' kratší než 'to' tak je 'to' doplněn 0x00 - je to zvláštnost, nemá se to používat, ale C99 to předepisuje, tak to dodržíme)<br />
<br />
== 9.9.2017 ==<br />
* vnitřní bezpečnostní aktualizace<br />
<br />
== 29.8.2017 ==<br />
* oprava chování RSTD - pokud je zapojen před zapnutím, nepřejde do automatického resetu po 10sec, ale RSTD je použit a SDS pracuje dále; přitom funkce "zapoj RSTD za běhu" je zachována správně<br />
* zásadní zlepšení odolnosti FULL-C proti chybám programátora - vnitřní hlídání rozsahů bufferu a stringů, zamezující zápisu za hranice pole (typicky chybné použití sprintf() funkce, ale toto hlídání je aplikováno obecně všude)<br />
<br />
== 8.8.2017 ==<br />
* oprava: FC teď správně převádí URL kód "sv?xxxx=yyyy...", na text (vypadlo 31.3. při rozšíření počtu znaků pro sdílené proměnné Txx) <br />
<br />
== 10.7.2017 ==<br />
* vydán firmware pro variantu "128kB" (od teď vychází dva typy firmware, pro variantu "64kB" a variantu "128kB", vyberete si tu svou dle HW který máte)<br />
* velká optimalizace využití paměti pro uložení a běh FULL-C programu (komprese, a zmenšení vyžadovaného heapu pro běh programu) - významně zvětšuje možnou velikost FC programu<br />
* pin RSTD lze teď také použít i bez vypnutí a zapnutí SDS, stačí jej na 10 vteřin za běhu zkratovat (pak se provede RSTD a SDS se rebootuje) - výhodné pro zařízení kde vypnutí nelze provést<br />
* drobné užitečné opravy dle hlášení uživatelů<br />
* verze FC zvýšena na 0x08, a přidána možnost uložit 128 proměnných do baterií zálohované pamětí (tzn. obsah přežije výpadek napájení a FC program po restartu o tyto údaje nepřijde)<br />
<br />
== 2.6.2017 ==<br />
* návratová hodnota funkce DF_read_page() je nastavena správně i v případě, kdy tato funkce čte data z cache (opakované čtení stejné stránky DF)<br />
<br />
== 6.4.2017 ==<br />
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);<br />
<br />
== 31.3.2017 ==<br />
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)<br />
* oprava čtení konfigurace 1-W, pomocí sds_get_a()<br />
* přidán index 139<br />
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)<br />
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)<br />
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)<br />
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)<br />
<br />
<br />
== starší záznamy ==<br />
<br />
Nejsou k dispozici.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=Firmware&diff=946Firmware2025-03-28T18:57:11Z<p>Adamn: </p>
<hr />
<div>== Nový Firmware ==<br />
<br />
Aktualizujte si své SDS - nahrejte do něj nový firmware, který získáte na této stránce - '''naskrolujte dolů''' kde naleznete odkaz na BIN soubor pro vaše zařízení.<br />
<br />
Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].<br />
<br />
<br />
=== Odkazy ke stáhnutí ===<br />
<br><br />
<br />
<div class="successbox">PC Software</div><br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')<br />
|-<br />
| style="padding: 15px;"| <li> stáhnout WinEXE pro SDS-C [https://sds.an-d.cz/firmware/SDSC_310123.exe zápis/simulace/upload SDS-C (SDS-C '''verze 09''') a UWEB, ze dne 31.1.2023]<br>SHA-256: daf1095f206404e33223f675f5d0bc09d4fc5dfd7d9f79f4f735af88f5ff1e6a<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> (FC verze '''0x12''' - '''aktuální'''): stáhnout WinEXE pro FULL-C [https://sds.an-d.cz/firmware/FULLC_220724.exe zápis/upload FULL-C a UWEB, ze dne 22.7.2024],<br> určeno pro Firmware od 9.3.2023 včetně, pro všechny varianty SDS (64kB a 128kB a 512kB)<br>SHA-256: b4cb95d8ec8a6e844a3a4c9a2e9fc50ece60ccf44e8043f8c10f46b2294cae0b<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program SDSLOAD.exe''' ("jednokrokový" upload .FC souborů a aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> ('''aktuální''' verze, pro FW od 10.7.2017 včetně a dále) stáhnout WinEXE [https://sds.an-d.cz/firmware/SDSLOAD_220724.exe program SDSLOAD ze dne 22.7.2024],<br> určeno pro všechny SDS varianty 64kB a 128kB a 512kB, (subvarianty DP a DS84)<br>SHA-256: ded5bf1aca2e04e22c33899a0976deccc8ff76eb88f53ecd9769788b7daa25a7<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''<br />
|-<br />
| style="padding: 15px;"| <li> Program '''[[SDS LOG: intro|SDS LOG]]''' - verze 0.1 ze dne 26.8.2011 - [https://sds.an-d.cz/firmware/SDS_LOG.exe stáhnout EXE program]<br />
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]<br />
<li> [[SDS LOG: changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
|}<br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_CZ.bin SDS-MICRO-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_EN.bin SDS-MICRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MICRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_CZ.bin SDS-MICRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_EN.bin SDS-MICRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_CZ.bin SDS-MICRO-ST-DP-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_EN.bin SDS-MICRO-ST-DP-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_CZ.bin SDS-MINI-ST-CZ ze dne 2.11.2023]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_EN.bin SDS-MINI-ST-EN released on 2-Nov-2023]<br />
<li><br />
[[SDS MINI: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].<br />
<li>Výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_CZ.bin SDS-MACRO-LM-CZ ze dne 1.7.2022]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_EN.bin SDS-MACRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MACRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_CZ.bin SDS-MACRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_EN.bin SDS-MACRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MACRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_CZ.bin SDS-TTCPRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_EN.bin SDS-TTCPRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_CZ.bin SDS-IO6-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_EN.bin SDS-IO6-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_CZ.bin SDS-IO6-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_EN.bin SDS-IO6-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.<br />
<li><br />
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.<br />
<li> <br />
<li>[[SDS FTP: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).<br />
<li><br />
<li>Stáhnout firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_CZ.bin (Česká lokalizace) SDS-UPS-ONEDPS-LM ze dne 1.7.2022]<br />
<li>Download firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_EN.bin (English language version) SDS-UPS-ONEDPS-LM released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.<br />
<li><br />
<li>Firmware je zaslán na požádání (pošlete email), aktuální verze je z 1.3.2011 (dále aktualizováno na specifické požádání, raději proto přejděte na nový HW).<br />
<li><br />
<li>Každá deska má svou kalibraci, proto každá deska má svůj vlastní FW, proto musíte uvést S/N svého výrobku.<br />
<li><br />
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW<br />
|-<br />
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]<br />
<li><br />
<li>Firmware je jednotný pro všechny varianty '''SDS Druhé Produktové Řady''', nutné je rozlišení dle varianty 64kB/128kB/512kB. Rozlišení podle dalších subvariant (DP, DS84) se neprovádí.<br />
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.<br />
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.<br />
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu. <br />
<li><br />
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_280325_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 28.3.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_280325_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 28.3.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 512kB) [[firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 12.4.2022|informace pokud máte SDS512 s FW <b>starším</b> než 12.4.2022]]<br />
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_280325_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 28.3.2025]<br />
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.<br />
|-<br />
| style="padding: 15px;"| POZOR<br />
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<br><br />
Aktualizaci lze provést jen fyzicky u výrobce, ten ji provede bezplatně (zašlete výrobci vaše SDS pro jeho aktualizaci). Se starým FW nebude tento HW plně fungovat.<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
=== Informace ===<br />
<br />
VŽDY MĚJTE VE SVÉM ZAŘÍZENÍ NEJNOVĚJŠÍ FIRMWARE, A POUŽÍVEJTE TAKÉ NEJNOVĚJŠÍ SDS-C EXE / FULL-C EXE PROGRAM.<br />
V opačném případě vám budou chybět nové funkce, které neustále přidáváme, a také nebudete mít opravené nalezené chyby.<br />
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.<br />
<br />
<br />
=== Historický Software ===<br />
<br />
Za účelem aktualizace takových SDS, kde už dlouho nebyl aktualizován firmware, je potřeba použít odpovídající EXE program pro aktualizaci takovéhoto zařízení.<br />
<br />
<br />
==== První Produktová Řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_151119.exe ze dne '''15.11.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 08, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020118.exe ze dne '''2.1.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 07, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020317.exe ze dne '''2.3.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 8.8.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_060216.exe ze dne '''6.2.2016''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které nemají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 24.1.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_231111.exe ze dne '''23.11.2011''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 04<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_170211.exe ze dne '''17.2.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''února 2011''')<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro ''SDS-C verze č. 03'' (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_140511.exe ze dne '''14.5.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''konce května 2011''')<br />
<br />
<br />
==== Druhá Produktová řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_070323.exe ze dne '''7.3.2023''']<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_311222.exe ze dne '''31.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 11, (firmware od 9.1.2023 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_071222.exe ze dne '''7.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 10, (firmware od 18.11.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_161022.exe ze dne '''16.10.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0F, (firmware od 16.10.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_110722.exe ze dne '''11.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0E, (firmware od 11.7.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010722.exe ze dne '''1.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0D, (firmware od 6.8.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030422.exe ze dne '''3.4.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0C, (firmware od 23.3.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010322.exe ze dne '''1.3.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0B, (firmware od 6.8.2020 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030119.exe ze dne '''3.1.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0A, (firmware od 3.1.2019 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010718.exe ze dne '''1.7.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 09, (firmware od 27.6.2018 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_100717.exe ze dne '''10.7.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 08, (firmware od 10.7.2017 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_080617.exe ze dne '''8.6.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 06, (firmware starší než Červenec-2017, a pouze pro variantu SDS 64kB)<br />
<br />
* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_120417.exe ze dne 12.4.2017],<br> určeno pouze pro SDS variantu 64kB která používá ''starý'' firmware (2017 nebo starší)<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_100717.exe ze dne 10.7.2017],<br> určeno pouze pro SDS variantu 64kB a 128kB (nepodporuje variantu 512kB tak jako aktuální stáhnutelná verze aplikace)<br />
<br />
<br />
== Beta Testing ==<br />
<br />
Než vydáme novou verzi, je potřeba změny a novinky otestovat.<br />
<br />
Pokud jste ochotní se testu zúčastnit, pak se podívejte [https://forum.sds.an-d.cz/viewtopic.php?id=129 na tento odkaz]. Zde jsou uveřejněny vždy nejnovější beta verze firmware.<br />
<br />
Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=SDS_BIG:_firmware_changelog&diff=945SDS BIG: firmware changelog2025-03-15T09:43:28Z<p>Adamn: </p>
<hr />
<div>== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==<br />
<br />
__NOTOC__ <br />
<br />
Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-BIG a SDS-SMALL a SDS-STSW.<br />
<br />
Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.<br />
<br />
Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.<br />
<br />
Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.<br />
<br />
<br />
<br />
== 15.3.2025 ==<br />
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)<br />
<br />
== 27.2.2025 ==<br />
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)<br />
* 512: oprava nefunkčního čtení ze sériové linky COM6<br />
<br />
== 8.2.2025 ==<br />
* oprava některých payloadů v protokolu SUDP <br />
<br />
== 22.7.2024 ==<br />
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB<br />
* možnost volby klidového stavu pro každý S0 vstup (umožňuje počítat impulsy i pro NC spínače v měřiči energie)<br />
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli<br />
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)<br />
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou<br />
<br />
== 24.2.2024 ==<br />
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)<br />
* RSTD nesmaže (nanastaví na tovární hodnoty) vaše nastavení pro všechny AD vstupy (to lze teď udělat ručně, nově přidaným tlačítkem ve webovém rozhraní)<br />
<br />
== 31.10.2023 ==<br />
* SNMP - oprava způsobu předání chyby v odpovědi<br />
* SNMP v1 - možnost nastavit dvě nezávislé komunity<br />
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)<br />
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)<br />
* FC: indexy 66, 67, 68, 4990..4999<br />
<br />
== 19.8.2023 ==<br />
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)<br />
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)<br />
<br />
== 14.7.2023 ==<br />
* HTTP POST: oprava sekundární chyby (objevila se ve FW 6.6.2023), kdy FW akceptoval jen rozdělený krok č. 2 (teď už opět umí jak rozdělený, tak i nerozdělený krok č. 2)<br />
* FC: umožněn přímý zápisu do indexu 193 (přímo zapíše do registru PWM - určeno pro nejjemnější uživatelskou přímo konfiguraci generátoru PWM)<br />
<br />
== 6.6.2023 ==<br />
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků<br />
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20<br />
* 512: další zvětšení FC konzole<br />
* webový admin: úprava (oprava) použití timerů v javascriptu <br />
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)<br />
* HTTP POST: poradí si i s ne-oddělenou komunikací (když klient pošle úvodní konverzační data najednou, neodděleně, tzn. nečeká na odpověď ze serveru)<br />
<br />
== 9.3.2023 ==<br />
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()<br />
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci<br />
<br />
== 28.2.2023 ==<br />
* POST: přidán příkaz /wrdf<br />
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip<br />
* malá bezpečnostní aktualizace<br />
<br />
== 9.1.2023 ==<br />
* FC verze 0x11 (+ odpovídající FULLC.EXE)<br />
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84<br />
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení <br />
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84<br />
* FC: doplněna funkčnost FC WatchDog (pro situaci, pokud spadne program na chybu a je zastaven, tak FC Watchdog pokračuje a provede restart FC programu)<br />
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)<br />
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)<br />
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení<br />
* HW BIG2 DS84: RTC běží na baterii na všech HW variantách DS84 - udržuje běžící aktuální čas i při vypnutém napájení<br />
* FC: přidána funkce SDS_onewire_search_bus()<br />
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997<br />
<br />
== 1.12.2022 ==<br />
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)<br />
* trvalé zobrazení archivovaného HW faultu v Logu (pokud dojde k faultu, je hned před restartem zařízení archivován a trvale zobrazován ve výpisu, i po libovolném novém spuštění)<br />
* odstraněno eventuální čekání (a následný WDG restart) při komunikaci s externími I2C zařízeními (specifické chipy na sandwich deskách uživatelů)<br />
<br />
== 30.11.2022 ==<br />
* FC: zvýšena výkonnost (512: optimalizace pro až několika-násobné celkové zrychlení vykonávání programu) (64,128: byť jen menší zrychlení, ale přece + zvětšená konzole echo.htm) <br />
* zrychleno webové rozhraní (zpomaleno zřejmě o dvě verze zpět, byť to bylo bez vlivu na funkci, je vhodnější když to nezdržuje při zobrazování v prohlížeči)<br />
* FC: přidán index 137<br />
* zlepšena interní obsluha sériových linek (COMx/RS485), odstraněno možné náhodné zpoždění (byť jen ve specifickém případě a jen o několik msec, ale i tak se toto vyřešilo)<br />
<br />
== 22.11.2022 ==<br />
* FC (64/128/512): verze 0x10 <br />
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu<br />
<br />
== 18.11.2022 ==<br />
* FC (64/128): verze 0x10 <br />
* FC: nová funkce SDS_set_RTC<br />
* FC: nové funkce pro práci s float<br />
* oprava pro mounting některých typů SD karet<br />
<br />
== 14.11.2022 ==<br />
* FC: oprava výpočtů v 64-bit doméně<br />
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot<br />
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty<br />
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem<br />
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki<br />
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm<br />
<br />
== 16.10.2022 ==<br />
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP<br />
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)<br />
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat<br />
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)<br />
* FC: zápis do indexu 999 funguje jak má<br />
* FC: verze 0x0F (nové funkce PWMx)<br />
<br />
== 5.10.2022 ==<br />
* pouze vše řady 512 (ostatní bez tohoto problému) - důležitá oprava situace kdy někdy chybně došlo ke smazání nahraného FC programu při nahrání nového UWEB projektu do SDS<br />
<br />
== 30.9.2022 ==<br />
* FC: oprava běhu programu v situaci kdy v kódu je vnořený (nested) switch() v rámci jiného switch() (původně chybné chování, teď opraveno)<br />
<br />
== 28.9.2022 ==<br />
* FC: oprava výsledků maker (define), kdy chybně docházelo k pevnému přetypování na int32_t, což je teď opraveno (odstraněno)<br />
<br />
== 1.8.2022 ==<br />
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace<br />
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)<br />
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)<br />
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)<br />
<br />
== 11.7.2022 ==<br />
* FC: verze 0x0E<br />
* FC: přidána funkce mktime()<br />
* FC: přidána funkce gmtime()<br />
* FC: přidána funkce localtime()<br />
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg<br />
<br />
== 1.7.2022 ==<br />
* FC: verze 0x0D<br />
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky<br />
* FC: přidána funkce SDS_TOPB_keyboard_updn()<br />
* FC: přidána funkce SDS_rescan_onewire()<br />
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE<br />
* BIG 64/128 prodloužen čas pro sestavení Ethernetového spojení, což řeší problém s některými USB síťovými kartami atd.<br />
* opraveno HTTP POST nastavení položek NTP<br />
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho<br />
<br />
== 12.4.2022 ==<br />
* doplněna informační stránka o vnitřním stavu OneWire Master (pro snazší identifikaci problémů při používání sběrnice)<br />
* oprava v bootloaderu pro řadu 512 - vyžaduje přeprogramování u výrobce pro všechna SDS řady 512 s FW starším než 14.2.2022<br />
<br />
== 3.4.2022 ==<br />
* FC verze 0x0C<br />
* FC: přidána funkce SDS_I2C_rw<br />
* OneWire stabilnější<br />
<br />
== 21.1.2022 ==<br />
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí<br />
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])<br />
<br />
== 18.1.2022 ==<br />
* RSTD zapíše do NVM všechny konfigurační položky (i to co nenuluje), pro jistotu že v NVM bude vše skutečně zapsáno<br />
* načítání konfigurace upraveno (větší spolehlivost)<br />
<br />
== 15.1.2022 ==<br />
* přidána stránka cfgstatus.htm - pro možnost kontroly stavu uložené konfigurace v pevné paměti (např. co nemáte uloženo)<br />
* přidán M2M výstup ip.xml<br />
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()<br />
* FC: každý program má unikátní identifikátor, podle kterého lze např. kontrolovat či zpětně poznat co máte v SDS nahráno<br />
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace<br />
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech<br />
* SNMP: nové položky .8.90 , .8.91 , .8.99<br />
* FC: nové get(u32) položky 2 a 87<br />
<br />
== 31.12.2021 ==<br />
* možnost vyřadit NTP z činnosti zadáním adresy 127.0.0.1 (vhodné pro uživatele kteří získávají čas odjinud, např. přes LoRA)<br />
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)<br />
* web: opraven zámek zvětšené konzole (echo)<br />
* důslednější kontrola platnosti konfigurace při startu<br />
<br />
== 27.12.2021 ==<br />
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)<br />
* FC: několikanásobně zvětšena konzole (echo.htm)<br />
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj<br />
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)<br />
* aktualizován bootloader (aktualizace bootloaderu jen prostřednictvím přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí<br />
* vydána varianta 512 - vlastní soubor s firmware<br />
<br />
== 25.12.2021 ==<br />
* pouze interní vydání<br />
<br />
== 26.3.2021 ==<br />
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)<br />
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C<br />
<br />
== 9.2.2021 ==<br />
* FC: oprava TID v MODBUS-TCP<br />
* MBTC výpis rozšířen<br />
* FC: drobná úspora heap (více dostupného místa)<br />
* FC: dns resolv drobný fix<br />
* FC: http_get a http_post důležitý fix<br />
* FC: nová funkce http_close<br />
* FC: chyba -7 pro MODBUS-TCP a pro MQTT<br />
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)<br />
<br />
== 22.12.2020 ==<br />
* web: ruční přepnutí CBY pro relé (tzn. "kdo ovládá relé"), na "FULL-C", dané relé nevypne (off) ale ponechá jeho stávající stav (on, off)<br />
* security fix<br />
<br />
== 10.12.2020 ==<br />
* dřívější odeslání NTP požadavku po výpadku síťového spojení<br />
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci<br />
* počítání délky aktivace tarifního vstupu (doba T0 a T1 v sekundách za den) viz nové sys, pozor pro funkci vyžaduje NTP<br />
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP<br />
<br />
== 23.11.2020 ==<br />
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou<br />
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)<br />
* FC: detekce nesprávné dereference ukazatele<br />
<br />
== 14.11.2020 ==<br />
* webová administrace: stránka p=42: index ck03 se propíše i do nastavení (chybělo od 23.10.2020, web byl aktualizován, nastavení ale přebíralo ck00)<br />
<br />
== 4.11.2020 ==<br />
* FC + FULLC.exe: odstraněn problém při načtení nahraného FULL-C programu v SDS, kdy dříve mohlo u jedné specifické velikosti nahraného programu, dojít k jeho nespuštění kvůli neodpovídajícímu crc<br />
<br />
== 3.11.2020 ==<br />
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)<br />
* FULLC.exe: odstraněno omezení na 255 znaků na řádek<br />
* FULLC.exe: zrychlení nahrávání do SDS<br />
<br />
== 23.10.2020 ==<br />
* webová administrace: stránka p=42: změna indexu ck00 na ck03 ať se dají uživatelským skriptem všechny prvky samostatně rozlišit<br />
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST<br />
<br />
== 14.10.2020 ==<br />
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)<br />
<br />
== 13.10.2020 ==<br />
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)<br />
<br />
== 13.9.2020 ==<br />
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)<br />
<br />
== 9.8.2020 ==<br />
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)<br />
* různé drobné opravy a zabezpečení<br />
* zobrazení auditlogu (webové rozhraní SDS)<br />
* FC: http_post<br />
* FC: MQTT klient<br />
* FC: MODBUS-TCP klient<br />
<br />
== 4.8.2020 ==<br />
* úprava obsluhy relé<br />
* podpora OneWire modulu SDS-1W-T-RH<br />
<br />
== 3.10.2019 ==<br />
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)<br />
* RSTD při zapnutí zařízení, ve kterém není záložní baterie (nebo je vybitá), zachová původně nastavenou MAC adresu (vše ostatní ale už jde do defaultu, což je správně)<br />
* SUDP: rozšířen NOP příkaz <br />
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)<br />
<br />
== 23.9.2019 ==<br />
* oprava GUI (S0 Inputs)<br />
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)<br />
* opraven nefunkční RSTD na modulu STSW-rev3<br />
<br />
== 23.6.2019 ==<br />
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy<br />
<br />
== 28.5.2019 ==<br />
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)<br />
<br />
== 5.5.2019 ==<br />
* dořešeno hlídání stavu (načtení, atd.) SD karty i v případě provozu náročného FULL-C programu (tedy i pro hluboce vnořené smyčky)<br />
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"<br />
<br />
== 24.2.2019 ==<br />
* překlopení z BETA do oficiálního FW<br />
* automatika zimní/letní čas<br />
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.) <br />
* přístup na SD kartu: web server zobrazuje soubory ze SD karty (vše ve složce \web\ a podsložkách této složky)<br />
* oprava čtení napětí baterie pro variantu 128K<br />
* shared.xml<br />
* odstraněno omezení délky ve shared.txt<br />
* zprovozněno getsv<br />
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: nová možnost způsobu čtení teploty SoC<br />
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.<br />
* FULL-C: doplněné set/get funkce pro sdílené proměnné<br />
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float<br />
* FULL-C: funkce pro reset FC programu<br />
* FULL-C: funkce pro watchdog FC programu<br />
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)<br />
<br />
== 1.7.2018 ==<br />
* SNMP: sdsS0translatedUnitT0,1 je poskytováno jako hodnota od odečtu (ne od úplného začátku měření, jak to bylo předtím) <br />
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS<br />
<br />
== 27.6.2018 ==<br />
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)<br />
* FULL-C: přidána podpora pro int64_t a uint64_t<br />
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)<br />
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)<br />
* drobné opravy<br />
* drobná oprava v odchozím TCP-SYN a v generátoru ISN<br />
<br />
== 8.3.2018 ==<br />
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00<br />
* vhodnější řešení rexmitu částí webových stránek a dynamických dat (ocení to zejména uživatelé s mobilním připojením pro SDS)<br />
<br />
== 2.3.2018 ==<br />
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)<br />
<br />
== 11.2.2017 ==<br />
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)<br />
<br />
== 21.12.2017 ==<br />
* zvýšena stabilita spuštění po zapnutí<br />
<br />
== 20.12.2017 ==<br />
* dočasná změna ve FULL-C (bude zrušena): funkce snprintf() má interně posunutý limit délky zápisu o 1 (toto je záměrný rozdíl proti C99). Změna v SDS je provedena z důvodu neznalosti programátorů FC v tom, že do snprintf() limitu je potřeba započítat i jeden byte pro ukončující nulu. Ve výsledku tedy zápis "snprintf(buf, limit, ...);" je v FC interně vykonán jako "snprintf(buf, limit+1, ...);".<br />
* oprava ve FULL-C: výpočet platné délky bufferu funguje i pro ukazatele vytvořené offsetem ze základní alokované adresy (příklad takového bufferu je: buf=malloc(x)+offset;)<br />
* stav všech relé je načten z paměti vždy po zapnutí modulu, a ty relé které jsou ručně ovládány (manual control) a které byly před vypnutím v zapnutém (ON) stavu, jsou po zapnutí modulu aktivovány (zatímco relé ovládané z IP-W a FC jsou vždy po zapnutí modulu uvedeny do OFF stavu)<br />
<br />
== 18.12.2017 ==<br />
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů) <br />
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)<br />
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje<br />
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")<br />
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")<br />
<br />
== 18.9.2017 ==<br />
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)<br />
* FULL-C: snprint() opraven (když je 'from' kratší než 'to' tak je 'to' doplněn 0x00 - je to zvláštnost, nemá se to používat, ale C99 to předepisuje, tak to dodržíme)<br />
<br />
== 9.9.2017 ==<br />
* vnitřní bezpečnostní aktualizace<br />
<br />
== 29.8.2017 ==<br />
* oprava chování RSTD - pokud je zapojen před zapnutím, nepřejde do automatického resetu po 10sec, ale RSTD je použit a SDS pracuje dále; přitom funkce "zapoj RSTD za běhu" je zachována správně<br />
* zásadní zlepšení odolnosti FULL-C proti chybám programátora - vnitřní hlídání rozsahů bufferu a stringů, zamezující zápisu za hranice pole (typicky chybné použití sprintf() funkce, ale toto hlídání je aplikováno obecně všude)<br />
<br />
== 8.8.2017 ==<br />
* oprava: FC teď správně převádí URL kód "sv?xxxx=yyyy...", na text (vypadlo 31.3. při rozšíření počtu znaků pro sdílené proměnné Txx) <br />
<br />
== 10.7.2017 ==<br />
* vydán firmware pro variantu "128kB" (od teď vychází dva typy firmware, pro variantu "64kB" a variantu "128kB", vyberete si tu svou dle HW který máte)<br />
* velká optimalizace využití paměti pro uložení a běh FULL-C programu (komprese, a zmenšení vyžadovaného heapu pro běh programu) - významně zvětšuje možnou velikost FC programu<br />
* pin RSTD lze teď také použít i bez vypnutí a zapnutí SDS, stačí jej na 10 vteřin za běhu zkratovat (pak se provede RSTD a SDS se rebootuje) - výhodné pro zařízení kde vypnutí nelze provést<br />
* drobné užitečné opravy dle hlášení uživatelů<br />
* verze FC zvýšena na 0x08, a přidána možnost uložit 128 proměnných do baterií zálohované pamětí (tzn. obsah přežije výpadek napájení a FC program po restartu o tyto údaje nepřijde)<br />
<br />
== 2.6.2017 ==<br />
* návratová hodnota funkce DF_read_page() je nastavena správně i v případě, kdy tato funkce čte data z cache (opakované čtení stejné stránky DF)<br />
<br />
== 6.4.2017 ==<br />
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);<br />
<br />
== 31.3.2017 ==<br />
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)<br />
* oprava čtení konfigurace 1-W, pomocí sds_get_a()<br />
* přidán index 139<br />
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)<br />
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)<br />
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)<br />
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)<br />
<br />
<br />
== starší záznamy ==<br />
<br />
Nejsou k dispozici.</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=Firmware&diff=944Firmware2025-03-15T09:42:27Z<p>Adamn: </p>
<hr />
<div>== Nový Firmware ==<br />
<br />
Aktualizujte si své SDS - nahrejte do něj nový firmware, který získáte na této stránce - '''naskrolujte dolů''' kde naleznete odkaz na BIN soubor pro vaše zařízení.<br />
<br />
Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].<br />
<br />
<br />
=== Odkazy ke stáhnutí ===<br />
<br><br />
<br />
<div class="successbox">PC Software</div><br />
<br />
{| class="wikitable" <br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')<br />
|-<br />
| style="padding: 15px;"| <li> stáhnout WinEXE pro SDS-C [https://sds.an-d.cz/firmware/SDSC_310123.exe zápis/simulace/upload SDS-C (SDS-C '''verze 09''') a UWEB, ze dne 31.1.2023]<br>SHA-256: daf1095f206404e33223f675f5d0bc09d4fc5dfd7d9f79f4f735af88f5ff1e6a<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> (FC verze '''0x12''' - '''aktuální'''): stáhnout WinEXE pro FULL-C [https://sds.an-d.cz/firmware/FULLC_220724.exe zápis/upload FULL-C a UWEB, ze dne 22.7.2024],<br> určeno pro Firmware od 9.3.2023 včetně, pro všechny varianty SDS (64kB a 128kB a 512kB)<br>SHA-256: b4cb95d8ec8a6e844a3a4c9a2e9fc50ece60ccf44e8043f8c10f46b2294cae0b<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program SDSLOAD.exe''' ("jednokrokový" upload .FC souborů a aktualizace firmware pro SDS '''druhé řady''')<br />
|-<br />
| style="padding: 15px;"| <li> ('''aktuální''' verze, pro FW od 10.7.2017 včetně a dále) stáhnout WinEXE [https://sds.an-d.cz/firmware/SDSLOAD_220724.exe program SDSLOAD ze dne 22.7.2024],<br> určeno pro všechny SDS varianty 64kB a 128kB a 512kB, (subvarianty DP a DS84)<br>SHA-256: ded5bf1aca2e04e22c33899a0976deccc8ff76eb88f53ecd9769788b7daa25a7<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''<br />
|-<br />
| style="padding: 15px;"| <li> Program '''[[SDS LOG: intro|SDS LOG]]''' - verze 0.1 ze dne 26.8.2011 - [https://sds.an-d.cz/firmware/SDS_LOG.exe stáhnout EXE program]<br />
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]<br />
<li> [[SDS LOG: changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
|}<br />
<br />
<div class="successbox">První Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_CZ.bin SDS-MICRO-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_010722_EN.bin SDS-MICRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MICRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_CZ.bin SDS-MICRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_021123_EN.bin SDS-MICRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_CZ.bin SDS-MICRO-ST-DP-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MICRO_ST_DP_021123_EN.bin SDS-MICRO-ST-DP-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MICRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].<br />
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_CZ.bin SDS-MINI-ST-CZ ze dne 2.11.2023]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MINI_021123_EN.bin SDS-MINI-ST-EN released on 2-Nov-2023]<br />
<li><br />
[[SDS MINI: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].<br />
<li>Výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_CZ.bin SDS-MACRO-LM-CZ ze dne 1.7.2022]<br />
<li><br />
'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_010722_EN.bin SDS-MACRO-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS MACRO: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_CZ.bin SDS-MACRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_MACRO_ST_021123_EN.bin SDS-MACRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>[[SDS MACRO: ST: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_CZ.bin SDS-TTCPRO-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_TTCPRO_021123_EN.bin SDS-TTCPRO-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_CZ.bin SDS-IO6-LM-CZ ze dne 1.7.2022]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_010722_EN.bin SDS-IO6-LM-EN released on 1-Jul-2022]<br />
<li><br />
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).<br />
<li><br />
<li>'''PLNĚ ČESKÁ LOKALIZACE''' / FULL CZECH LOCALISATION<br> - stáhnout firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_CZ.bin SDS-IO6-ST-CZ ze dne 2.11.2023]<br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br> - download firmware [https://sds.an-d.cz/firmware/SDS_IO6_ST_021123_EN.bin SDS-IO6-ST-EN released on 2-Nov-2023]<br />
<li><br />
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.<br />
<li><br />
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.<br />
<li> <br />
<li>[[SDS FTP: LM: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).<br />
<li><br />
<li>Stáhnout firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_CZ.bin (Česká lokalizace) SDS-UPS-ONEDPS-LM ze dne 1.7.2022]<br />
<li>Download firmware [https://sds.an-d.cz/firmware/SDSUPS_ONEDPS_010722_EN.bin (English language version) SDS-UPS-ONEDPS-LM released on 1-Jul-2022]<br />
<li><br />
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM<br />
|-<br />
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.<br />
<li><br />
<li>Firmware je zaslán na požádání (pošlete email), aktuální verze je z 1.3.2011 (dále aktualizováno na specifické požádání, raději proto přejděte na nový HW).<br />
<li><br />
<li>Každá deska má svou kalibraci, proto každá deska má svůj vlastní FW, proto musíte uvést S/N svého výrobku.<br />
<li><br />
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
<div class="successbox">Druhá Produktová Řada SDS</div><br />
<br />
{| class="wikitable"<br />
|-<br />
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW<br />
|-<br />
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]<br />
<li><br />
<li>Firmware je jednotný pro všechny varianty '''SDS Druhé Produktové Řady''', nutné je rozlišení dle varianty 64kB/128kB/512kB. Rozlišení podle dalších subvariant (DP, DS84) se neprovádí.<br />
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.<br />
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.<br />
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu. <br />
<li><br />
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_150325_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 15.3.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_150325_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 15.3.2025]<br />
|-<br />
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"<br />
<li><br />
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION<br />
<li>- stáhnout firmware (varianta: 512kB) [[firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 12.4.2022|informace pokud máte SDS512 s FW <b>starším</b> než 12.4.2022]]<br />
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_150325_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 15.3.2025]<br />
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.<br />
|-<br />
| style="padding: 15px;"| POZOR<br />
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<br><br />
Aktualizaci lze provést jen fyzicky u výrobce, ten ji provede bezplatně (zašlete výrobci vaše SDS pro jeho aktualizaci). Se starým FW nebude tento HW plně fungovat.<br />
|-<br />
| style="padding: 15px; background-color:#ffffff;"|<br />
|}<br />
<br />
=== Informace ===<br />
<br />
VŽDY MĚJTE VE SVÉM ZAŘÍZENÍ NEJNOVĚJŠÍ FIRMWARE, A POUŽÍVEJTE TAKÉ NEJNOVĚJŠÍ SDS-C EXE / FULL-C EXE PROGRAM.<br />
V opačném případě vám budou chybět nové funkce, které neustále přidáváme, a také nebudete mít opravené nalezené chyby.<br />
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.<br />
<br />
<br />
=== Historický Software ===<br />
<br />
Za účelem aktualizace takových SDS, kde už dlouho nebyl aktualizován firmware, je potřeba použít odpovídající EXE program pro aktualizaci takovéhoto zařízení.<br />
<br />
<br />
==== První Produktová Řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_151119.exe ze dne '''15.11.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 08, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020118.exe ze dne '''2.1.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 07, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware novějším než SRPEN 2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_020317.exe ze dne '''2.3.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které mají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 8.8.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_060216.exe ze dne '''6.2.2016''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 06, které nemají podporu pro UserWEB project (tj. SDS první řady, které jsou provozovány s firmware starším než 24.1.2017)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_231111.exe ze dne '''23.11.2011''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s SDS-C ver 04<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro SDS-C (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_170211.exe ze dne '''17.2.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''února 2011''')<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro ''SDS-C verze č. 03'' (zápis/simulace/upload SDS-C), [https://sds.an-d.cz/firmware/archive/SDSC_140511.exe ze dne '''14.5.2011''']<br> - určeno pro zpětnou kompatibilitu se '''starým''' firmware (pro ty kteří zcela náhodou mají neaktualizovaný firmware s původem do '''konce května 2011''')<br />
<br />
<br />
==== Druhá Produktová řada ====<br />
<br />
'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.<br />
<br />
<br />
Následující aplikace jsou poskytnuty pouze jako negarantovaná podpora zařízení, které jste ještě nestihli aktualizovat na nejnovější firmware. Jiný význam tyto aplikace už nemají.<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_070323.exe ze dne '''7.3.2023''']<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_311222.exe ze dne '''31.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 11, (firmware od 9.1.2023 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_071222.exe ze dne '''7.12.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 10, (firmware od 18.11.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_161022.exe ze dne '''16.10.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0F, (firmware od 16.10.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_110722.exe ze dne '''11.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0E, (firmware od 11.7.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010722.exe ze dne '''1.7.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0D, (firmware od 6.8.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030422.exe ze dne '''3.4.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0C, (firmware od 23.3.2022 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010322.exe ze dne '''1.3.2022''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0B, (firmware od 6.8.2020 včetně, varianty SDS 64kB a 128kB a 512kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_030119.exe ze dne '''3.1.2019''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 0A, (firmware od 3.1.2019 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_010718.exe ze dne '''1.7.2018''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 09, (firmware od 27.6.2018 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_100717.exe ze dne '''10.7.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 08, (firmware od 10.7.2017 včetně, varianty SDS 64kB a 128kB)<br />
<br />
* (HISTORICKÉ) stáhnout WinEXE pro FULL-C (zápis/upload FULL-C a UWEB), [https://sds.an-d.cz/firmware/archive/FULLC_080617.exe ze dne '''8.6.2017''']<br> - určeno pro zpětnou kompatibilitu pro zařízení s FULL-C ver 06, (firmware starší než Červenec-2017, a pouze pro variantu SDS 64kB)<br />
<br />
* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_120417.exe ze dne 12.4.2017],<br> určeno pouze pro SDS variantu 64kB která používá ''starý'' firmware (2017 nebo starší)<br />
<br />
* (historická verze, pro starší FW) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_100717.exe ze dne 10.7.2017],<br> určeno pouze pro SDS variantu 64kB a 128kB (nepodporuje variantu 512kB tak jako aktuální stáhnutelná verze aplikace)<br />
<br />
<br />
== Beta Testing ==<br />
<br />
Než vydáme novou verzi, je potřeba změny a novinky otestovat.<br />
<br />
Pokud jste ochotní se testu zúčastnit, pak se podívejte [https://forum.sds.an-d.cz/viewtopic.php?id=129 na tento odkaz]. Zde jsou uveřejněny vždy nejnovější beta verze firmware.<br />
<br />
Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=M2M:_S-UDP_protocol&diff=943M2M: S-UDP protocol2025-03-15T09:02:42Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje funkci zařízení SDS '''druhé produktové řady''' - protože SDS první produktové řady používají jiný protokol.<br />
<br />
== Rychlá komunikace: S-UDP ==<br />
<br />
Pomocí speciálního protokolu, kdy se data přenášejí prostřednictvím [http://en.wikipedia.org/wiki/User_Datagram_Protocol UDP], je možné získávat informace z výrobků řady SDS/OnlineTechnology.<br />
<br />
S-UDP používá následující výchozí UDP PORT: 310<br />
<br />
Komunikace probíhá formou DOTAZ - ODPOVĚĎ. To znamená, že ten, kdo má o informace zájem (vzdálený uživatel) pošle dotaz (korektně vyplněný UDP paket, viz dále) a obratem obdrží od zařízení odpověď - UDP paket s informacemi. UDP Port na kterém je komunikace prováděna lze samozřejmě v administraci zařízení změnit.<br />
<br />
Přenos dat využívá specifického protokolu, který umožňuje bezpečně ovládat specifické zařízení SDS.<br />
<br />
<br />
'''Typické použití:''' komunikace zařízení SDS s protistranou (např. aplikace na mobilním telefonu).<br />
<br />
<br />
== Informace == <br />
<br />
Některé z FULL-C funkcí, které jsou zde popsány, jsou plně implementovány až ve firmware 03/2025 a dále. Je potřeba, aby jste měli svůj modul SDS aktualizován na nový firmware.<br />
<br />
<br />
== Bezpečnost ==<br />
<br />
Protokol S-UDP je založen na důsledné autentizaci strany, která posílá zprávu - zařízení SDS ověřuje identitu odesílatele příkazu, a ten může ověřit identitu SDS který odpovídá.<br />
<br />
<br />
Je to založeno na následujícím principu:<br />
<br />
- S-UDP protokol je zabezpečen symetrickou šifrou, se sdíleným klíčem který znají jen komunikující strany (bezpečnost je přímo úměrná úrovni zabezpečení tohoto klíče na obou stranách)<br />
<br />
- SDS má unikátní identifikátor (zaručeně unikátní, od výrobce) který nelze změnit (je fyzicky vypálen v SoC - nezměnitelně přímo v silikonu chipu).<br />
<br />
<br />
== S-UDP protokol ==<br />
<br />
Každý příkaz a odpověď jsou v samostatném, jediném, UDP paketu.<br />
<br />
Každý paket je sestaven v rámci společného formátu, který je zde popsán. Samotný doplňující datový obsah (payload) je dynamický, a u některých příkazů není potřeba.<br />
<br />
S-UDP Paket se tedy skládá z těchto základní částí (tyto části jsou právě přenášeny UDP paketem, v následující sestavě):<br />
<br />
[MASTER PACKET CONTENTS]<br />
<br />
OFFSET | LEN | DATA<br />
----------+--------+---------------------------------------------------------------<br />
0 | 28 | HEADER<br />
28 | PL*16 | ENCRYPTED PAYLOAD (contains: payload-header and payload-data)<br />
<br />
'''Pozor!''' Hodnota PL je velikost [ENCRYPTED PAYLOAD] vydělená 16. To znamená, že velikost [ENCRYPTED PAYLOAD] musí být beze zbytku dělitelná 16 (tzn. pouze hodnota 16, 32, 64, ...) ! Pokud je potřeba, doplní se na úplný konec (viz oblast "R") zarovnání do potřebné délky, aby se dosáhlo čisté dělitelnosti 16.<br />
<br />
LITTLE-ENDIAN<br />
<br />
Následující uvedené položky jsou ve formátu [http://en.wikipedia.org/wiki/Endianness#Little-endian Little-Endian] (procesory: ARM, x86):<br />
* ''uword'' (unsigned 16-bit)<br />
* ''dword'' (unsigned 32-bit)<br />
* ''slong'' (signed 32-bit)<br />
* ''qword'' (unsigned 64-bit)<br />
<br />
Položky typu: ''byte'', ''sbyte'', ''bytes'' - jsou jednotlivé samostatné bajty, nesdružené do společného čísla.<br />
<br />
<br />
<br />
Zde jsou uvedeny detailní položky:<br />
<br />
[MASTER PACKET CONTENTS]<br />
<br />
OFFSET | LEN | TYPE | DATA<br />
---------+------+--------+-----------------------------<br />
<br />
[HEADER]<br />
<br />
0 | 3 | bytes | header "SDS"<br />
3 | 1 | byte | TV = (SDS-product-line) including (S-UDP protocol master-version)<br />
4 | 1 | byte | PL = number of 16B chunks - this is the payload_length of [ENCRYPTED PAYLOAD] (example: PL==10 => 160 bytes)<br />
5 | 1 | byte | encryption-flag (NOW ACCEPTS ONLY: 0x10 == XTEA-64-CTR)<br />
6 | 1 | byte | reserved<br />
7 | 1 | byte | CK1: basic additive checksum for [ENCRYPTED PAYLOAD] (start from (including) byte offset [28] and forward)<br />
8 | 4 | dword | user_identifier (correlation identifier) - use this to correlate query to response<br />
12 | 16 | bytes | CounterBlock<br />
----------+------+--------+----------------------------<br />
<br />
[ENCRYPTED PAYLOAD] -> everything from this point is included:<br />
<br />
28 | 1 | byte | random number (shall be always different than what was used ever before)<br />
29 | 1 | byte | CK2: basic additive checksum for [HEADER] (all bytes [0] to [27] included, BUT: skipping byte [7])<br />
30 | 2 | uword | XR_MTU value (maximal size of the custom-payload data including R) ( XL + R <= XR_MTU )<br />
32 | 4 | dword | CRC-32 (part-header and plain-text payload) -> byte [36] (included) up to [52+XL-1] (the R area is not included here)<br />
36 | 4 | dword | uptime (msecs from boot)<br />
40 | 4 | dword | time (epoch) (or, if no NTP is available to SDS, this will be a value of "seconds from boot")<br />
44 | 4 | dword | SDS device type (0xXXXXXXXX) - THIS MUST MATCH<br />
48 | 1 | byte | master_command<br />
49 | 1 | byte | sub_command<br />
50 | 2 | uword | XL value (exact length of the actually useful payload-data): XL = (PL*16) - R - 24<br />
<br />
52 | XL | bytes | custom payload-data [C-PAYLOAD]<br />
<br />
52+XL | R | bytes | specific set of (random data filling) to round-up (the PL*16 value) to a clean 16B multiply (16, 32, 64, etc.)<br />
<br />
----------+------+--------+----------------------------<br />
<br />
<br />
Hodnota "SDS device type" je určena podle typu SDS, se kterým komunikujete. Seznam hodnot viz [[Firmware]], například 0xB1900001 pro BIG-64 nebo 0xB1900002 pro BIG-128 atd.Pokud tato hodnota neodpovídá typu firmware v daném SDS, bude paket zcela ignorován a neproveden. Jediná vyjímka je master_command == NOP, což je záměrná vyjímka, která umožní zjištění typu SDS (a přítomnosti SDS) při zahájení komunikace.<br />
<br />
Hodnota "random number" je zde proto, aby šifrované data byly pokaždé jiné, i když se přenáší stejný obsah (tzn. jedná se o zábranu stenografického odhadu obsahu payloadu).<br />
<br />
Hodnota "time" umožňuje zařízení, které komunikuje s SDS, zabránit "replay" útoku (když se zaznamená paket a později se zopakuje - v takovém případě se na to přijde protože "time" bude významně starší). SDS kontrolu provádí vůči svému vnitřnímu času, vzdálené zařízení co se SDS komunikuje by tuto kontrolu mělo dělat také.<br />
<br />
Protože hodnota "time" se zvyšuje pouze co 1 vteřinu, je k dispozici i hodnota "uptime" která se po resetu/bootu (kde se nastaví na nulu) zvyšuje každou 1 milisekundu o jedničku. Kombinace umožňuje vhodně sestavit algoritmus detekce "replay" útoků.<br />
<br />
"CounterBlock" se využívá pro nastavení začátku šifrování a dešifrování. Všechny detaily jsou zcela shodné jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]]. Z hlediska bezpečnosti je důležité, aby obě strany neustále používaly zvyšující se CounterBlock obsah (začít "od jedničky" pouze a jenom po resetu/bootu), tzn. pro každou zprávu použít poslední hodnotu counteru a na té dále stavět pro novou zprávu atd. .<br />
<br />
Hodnota "crc32" se počítá pro dešifrované data, algoritmus je identický jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]].<br />
<br />
Pro zvolené XTEA-64-CTR má "CounterBlock" následující sestavu svého obsahu:<br />
<br />
CounterBlock:<br />
<br />
OFFSET | LEN | TYPE | DATA<br />
----------+------+--------+-----------------------------------------------------------------------------------------<br />
0 | 8 | qword | XTEA-64-CTR: 64-bit counter (counter is increased by 1, for each 16B of processed data)<br />
8 | 8 | bytes | (reserved) not-used area = reserved (fill with 0x00) <br />
<br />
Pro jiné mechanismy (do budoucna) je v CounterBlock oblasti přidána ještě 8B rezerva (např. pro AES-128 se pak využije všech 16 bajtů).<br />
<br />
<br />
Hodnota "TV" (v [HEADER] na offsetu [3]) je určení typu a verze protokolu. Skládá se ze dvou čtyřbitových údajů, viz následující tabulka.<br />
<br />
TV: ttttVVVV<br />
76543210<br />
<br />
BIT OFFSET | LEN (bits) | content<br />
-----------+------------+--------------------------------------------------<br />
7 (MSB) | 4 | "t": produc-line value: 1 == first, 2 == second<br />
3 | 4 | "V": version: 0 = first S-UDP protocol version<br />
<br />
<br />
V konečném důsledku, skutečnou funkční důležitost ma '''[C-PAYLOAD]''', což je blok dat, který obsahuje hodnoty a příkazy, které pomocí S-UDP chceme přenést.<br />
<br />
<br />
<br />
== Postup při příjmu S-UDP paketu ==<br />
<br />
Každá strana, která přijme S-UDP paket, provede následující kroky:<br />
<br />
1) Ověřit platnost hodnot v [HEADER]<br />
a. text "SDS" (platný obsah)<br />
b. hodnota "TV" ("master-version" a "product-line") (platný obsah)<br />
c. hodnota "PL" v platných mezích<br />
d. hodnota "encryption_flag" (platný obsah)<br />
2) Ověřit základní additive-checksum pro [ENCRYPTED PAYLOAD]<br />
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK1" hodnotě<br />
3) Nastavit dešifrování<br />
a. zvolit algoritmus podle "encryption-flag" hodnoty<br />
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)<br />
c. nastavit "CounterBlock" (přečíst z [HEADER])<br />
4) Dešifrovat celou [ENCRYPTED PAYLOAD] na plain-text<br />
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)<br />
5) Ověřit základní additive-checksum pro [HEADER] - teď totiž už máme hodnotu "CK2"<br />
a. přečíst bajty [0] až [27] (ovšem přeskočit byte [7] - pozor!) a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK2" hodnotě<br />
6) Ověřit další hodnoty<br />
a. "SDS-DEVICE-TYPE" musí odpovídat (záruka ovládání toho správného typu SDS) - pokud hodnotu nevíte, můžete si "pomoci" NOP příkazem<br />
b. uschovat hodnotu "XR_MTU" pro vytváření odpovědi ("XR_MTU" omezuje velikost odpovědi, kterou můžeme zpátky odeslat)<br />
c. ověřit časové údaje ("time" a "uptime")<br />
d. ověřit "XL" vůči "PL"<br />
7) Ověřit CRC-32 dešifrovaného payloadu<br />
a. spočítat CRC-32 správným algoritmem, vučí bajtům (plain-text) z [36] až [52+XL-1] včetně<br />
<br />
8) Hotovo: teď se provede aktuální příkaz (Master Command, dle tabulky podle produktové řady viz "TV")<br />
a odešle odpověď (ponechat user_identifier pro korelaci) (pozor na "XR_MTU" omezení)<br />
<br />
<br />
== Postup při odesílání S-UDP paketu ==<br />
<br />
Odesílatel zprávy provádí tyto kroky:<br />
<br />
1) Je sestaven přesný obsah [C-PAYLOAD] a určena odpovídající hodnota XL<br />
a. obsah samozřejmě odpovídá tomu co chcete odeslat<br />
b. určí se i "master-command" a "sub-command" (pozor na produktovou řadu SDS - viz "TV")<br />
2) Vyplní se [HEADER]<br />
a. hlavička "SDS", "encryption-flag"<br />
b. zapsat správnou hodnotu "TV" podle protokolu a konkrétního SDS ("master-version", "product-line")<br />
c. určí se nová unikátní hodnota "user_identifier", a zapíše se do [HEADER]<br />
d. zapíše se "CounterBlock" (hodnota pokračuje po předchozím paketu)<br />
3) Nachystá se zaokrouhlovací oblast "R" <br />
a. Pokud XL není beze zbytku dělitelná 16, musí se doplnit oblastí "R"<br />
4) Spočítá se hodnota "PL"<br />
a. PL = (XL + R)/16<br />
b. zapsat do [HEADER]<br />
5) Začne se vyplňovat [ENCRYPTED PAYLOAD]<br />
a. zapsat náhodný byte do "random number"<br />
b. spočítá se hodnota "CK2" (sečíst bajty [0] až [27] - ovšem přeskočit byte [7] - pozor!) <br />
c. zapsat hodnotu "XR_MTU" podle možností zařízení (tzn. jak velkou odpověď lze bezpečně přijmout, podle omezení sítě)<br />
d. zapíší se hodnoty "uptime" a "time", zapsat hodnotu "SDS-DEVICE-TYPE"<br />
e. zapsat "master-command" a "sub-command"<br />
6) Spočítá se CRC-32 (před šifrováním)<br />
a. spočítat crc32 pro bajty (plain-text) z offsetu [36] až [52+XL-1] včetně<br />
7) Nastavit šifrování<br />
a. zvolit algoritmus (musí odpovídat tomu, co se zapsalo do "encryption-flag")<br />
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)<br />
c. nastavit "CounterBlock" (stejný jako byl zapsán [HEADER])<br />
8) Šifrovat celou [ENCRYPTED PAYLOAD] na plain-text<br />
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)<br />
b. aktualizovaná hodnota "CounterBlock" (zvýšená o průběh šifrování) se uschová pro další použití - viz bod " 2) c. "<br />
9) Spočítat základní additive-checksum pro [ENCRYPTED PAYLOAD]<br />
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek se zapíše do "CK1" hodnoty<br />
<br />
10) Hotovo: paket se následně odešle přes síť do protistrany, která odpoví novým paketem - ten je vztažen k tomuto dotazu pomocí "user_identifier" hodnoty.<br />
<br />
<br />
<br />
== Vzorové obsahy paketů ==<br />
<br />
Na stránce [[M2M: S-UDP protocol: examples]] naleznete ukázkové vzorové pakety a jejich vnitřní obsah, i se zobrazeních jednotlivých položek v paketu (před a po šifrování).<br />
Toto je vhodné pro vývojáře komunikační protistrany, kterým nestačí popis postupu na této stránce, ale chtějí také vidět jednotlivé kroky s aktuálními hodnotami.<br />
<br />
<br />
== Seznam hlavních příkazů ==<br />
<br />
Obě produktové řady SDS, které jsou na trhu, mají svou sadu "master_command" příkazů. Proto je potřeba nejprve zjistit, do které produktové řady vaše SDS spadá, a podle toho dále pokračovat. Lze to přímo odvodit od typu SDS ("SDS-DEVICE-TYPE" hodnota), nebo se zeptat příkazem NOP.<br />
<br />
Zařazení SDS do produktových řad je v [[Seznam_Všech_SDS|tomto seznamu]].<br />
<br />
* První produktová řada: "TV = 0001...." -> '''(1PŘ)'''<br />
* Druhá produktová řada: "TV = 0010...." -> '''(2PŘ)'''<br />
<br />
<br />
== (2PŘ) Master Command (druhá produktová řada: "TV = 0010...." ) ==<br />
<br />
Jednotlivé základní příkazy (''master command''):<br />
<br />
MASTER COMMAND | command<br />
----------------+-------------------------------------<br />
0 | NOP (replies with NOP)<br />
1 | general device status<br />
2 | 1-Wire access<br />
4 | read FC-Get list<br />
8 | write FC-Set list<br />
16 | FULL-C shared variable(s) access<br />
32 | serial port access<br />
64 | DataFlash access<br />
128 | reserved<br />
<br />
Jak lze vidět, jednotlivé ''master command'' příkazy jsou dále rozlišeny pomocí hodnoty ''sub command''.<br />
<br />
Každý příkaz má doplňující datovou sadu, tzn. [C-PAYLOAD]. V rámci těchto dat jsou uvedeny všechny hodnoty, které přesně určují co se má stát (popř. jsou zde všechny odpovědi na dotaz).<br />
<br />
<br />
== (2-PŘ) Master Command: [0] '''NOP''' ==<br />
<br />
SDS odpoví na tento příkaz odesláním [0] NOP.<br />
<br />
Tohoto příkazu lze využít k ověření komunikace a k vzájemné základní synchronizace.<br />
<br />
Specifická vlastnost příkazu NOP, oproti všem ostatním příkazům, je to, že SDS odpoví i v případě, že v dotazu není správně uvedený SDS Device Type. Toto je záměr, aby bylo možné při začátku komunikace s SDS modulem, tento modul identifikovat. Samozřejmě všechny ostatní bezpečnostní prvky jsou stále aplikovány, jen tento detail je zde upraven.<br />
<br />
Tento příkaz je také velmi užitečný pro získání hodnoty "TV" z [HEADER], tím pádem pro určení číslo produktové řady SDS - a tím pádem k určení které "master_command" příkazy jsou k dispozici !<br />
<br />
REPLY (master_command == 0, sent from SDS as reply)<br />
sub_command = 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-------+-------+------------------------------------------------------<br />
0 | 6 | bytes | MAC ADDRESS (bytes, not text)<br />
6 | 4 | bytes | SDS Device Type<br />
10 | 4 | dword | FW version <br />
14 | 32 | bytes | sysLocation (missing the 0x00 terminator)<br />
46 | 8 | bytes | reserved (0x00)<br />
54 | 32 | bytes | OEM string (missing the 0x00 terminator)<br />
86 | 8 | bytes | reserved (0x00)<br />
94 | 1 | byte | bylo aktivováno RSTD<br />
95 | 1 | byte | bylo aktivováno PVD<br />
96 | 1 | byte | SDS je: BIG (hodnota 1) nebo STSW (hodnota 0)<br />
97 | 8 | bytes | reserved (0x00)<br />
105 | 2 | uword | web interface TCP port number (typicky 80)<br />
107 | 1 | byte | SNMP-read enabled<br />
108 | 1 | byte | SNMP-write enabled<br />
109 | 1 | byte | FULLC shared vars access lock (0 = unlocked) tzn. sys[150]<br />
110 | 1 | byte | FULLC program run status<br />
111 | 1 | byte | FULLC program started-by info<br />
112 | 1 | byte | FULLC program watchdog active<br />
113 | 6 | bytes | reserved<br />
119 | 4 | f32 | backup battery voltage (milliVolts)<br />
<br />
Pozn. rozšířená funkcionalita příkazu NOP (tedy vracení payloadu) bylo přidáno až ve Firmware od verze 3.10.2019.<br />
<br />
<br />
== (2-PŘ) Master Command: [1] '''General Device Status''' ==<br />
<br />
SDS odpoví zasláním vybraných údajů, jejichž seznam je přesně daný. Tato funkce je k dispozici pro umožnění rychlého přístupu k základnímu stavu zařízení SDS, bez složité přípravy.<br />
<br />
Základní odpověď s nejzajímavějšími živými údaji. Určeno např. pro průběžnou aktualizaci stavu zobrazeného uživateli.<br />
<br />
REPLY (master_command == 1, sent from SDS as reply)<br />
sub_command = 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-------+-------+------------------------------------------------------<br />
0 | 6 | bytes | MAC ADDRESS (bytes, not text)<br />
6 | 1 | byte | Ethernet Link Status / Speed (0, 10, 100)<br />
7 | 1 | byte | Amount of users logged into SDS Web Admin<br />
8 | 32 | bytes | sysLocation (missing the 0x00 terminator)<br />
40 | 1 | byte | IP Watchdog Config status<br />
41 | 1 | byte | IP Watchdog Output (relay) status<br />
42 | 2 | uword | IP Watchdog RTT value (note.: 0xFFFF = not available)<br />
44 | 1 | byte | DHCP status<br />
45 | 1 | byte | reserved<br />
46 | 1 | byte | NTP status<br />
47 | 1 | sbyte | NTP offset (+/- hours) (signed char)<br />
48 | 2 | uword | SoC chip temperature (degC)<br />
50 | 1 | byte | GPIO-TOPB PIN(s) direction (0 == input)<br />
51 | 1 | byte | GPIO-TOPB PIN(s) pin value<br />
52 | 32*1 | byte | OPTO [1]..[32] status (0xFF == signal) (0x00 == nosignal)<br />
84 | 32*1 | byte | RELAY [1]..[32] status (active/nonactive)<br />
116 | 32*2 | uword | ADC [0]..[31] RAW value<br />
180 | 1 | byte | General 1-W BUS status<br />
181 | 1 | byte | 1-W BUS A - active device count<br />
182 | 1 | byte | 1-W BUS B - active device count<br />
183 | 3 | bytes | reserved (0x00)<br />
186 | 1 | byte | S0 Tariff Value (active/nonactive)<br />
187 | 1 | byte | number of the following S0 INPUT DB data blocks:<br />
188 | 31*28 | data | S0 INPUT [1]..[ (max) 31] DB (data block)<br />
<br />
<br />
S0-INPUT DB offset | LEN | TYPE | content<br />
-------------------+-----+-------+-------------------------------------------------------<br />
0 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)<br />
1 | 3 | bytes | reserved (filled with 0x00)<br />
4 | 4 | dword | T0 impulse counter<br />
8 | 4 | dword | T1 impulse counter<br />
12 | 4 | dword | T0 offset<br />
16 | 4 | dword | T1 offset<br />
20 | 4 | dword | measured space between impulses (msec)<br />
24 | 4 | dword | time since last registered impulse (msec)<br />
<br />
Sestava [C-PAYLOAD] je tedy zřejmá. <br />
<br />
Poslední blok (offset [188] až [1083] včetně) je určen pro přenos 32 S0 vstupů - často je jich ale v zařízení SDS fyzicky přítomno mnohem méně, např. jen devět - a potom zařízení SDS ve své odpovědi pošle jen devět záznamů (namísto 32) (toto se týká pouze a jenom S0 položek, né jiných v rámci paketu). To je provedeno z praktického důvodu: aby byl UDP paket dostatečně malý (a tedy rychlý na zpracování).<br />
<br />
<br />
== (2-PŘ) Master Command: [2] '''1-Wire Access''' ==<br />
<br />
Tato funkce se používá pro čtení stavu hodnot získaných z obou 1-W sběrnic, kterými SDS disponuje (některé SDS mají jen jednu sběrnici). Maximální počet prvků (chipů) na sběrnici je 64, celkem je tedy k dispozici 2x64 = 128 prvků.<br />
<br />
QUERY/COMMAND TO SDS (master_command == 2)<br />
<br />
sub_command | meaning<br />
------------+-----------------------------------------------------------<br />
0 | reserved<br />
1 | obtain status, and list of found items on BUS A<br />
2 | obtain status, and list of found items on BUS B<br />
4 | list all read-values on BUS A<br />
8 | list all read-values on BUS B<br />
<br />
První možností tedy je sub_command == 1 , tzn. výpis nalezených zařízení na sběrnici A respektive B:<br />
<br />
REPLY (master_command == 1, sent from SDS as reply)<br />
sub_command = 1 or 2<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | global 1-W controller status (SDS status)<br />
1 | 1 | byte | number of active items on BUS A<br />
2 | 1 | byte | number of active items on BUS B<br />
3 | 1 | byte | reserved (0x00)<br />
4 | 12 | data | 1-W item status #0<br />
. . . | ... | ... | . . .<br />
4+12*63 | 12 | data | 1-W item status #63<br />
<br />
"1-W item status" ofs | LEN | TYPE | content<br />
----------------------+-----+-------+-------------------------------------------------------<br />
0 | 1 | byte | ctrl: main-status<br />
1 | 1 | byte | ctrl: sub-status <br />
2 | 2 | bytes | reserved (filled with 0x00)<br />
4 | 8 | bytes | ROM-CODE [0]..[7]<br />
<br />
Následuje: výpis získaných hodnot (např. změřené teploty z teplotních čidel) pro jednotlivé sběrnice :<br />
<br />
REPLY (master_command == 1, sent from SDS as reply)<br />
sub_command = 4 or 8<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | global 1-W controller status (SDS status)<br />
1 | 1 | byte | number of active items on BUS A<br />
2 | 1 | byte | number of active items on BUS B<br />
3 | 1 | byte | reserved (0x00)<br />
4 | 12 | data | 1-W item value #0<br />
. . . | ... | ... | . . .<br />
4+12*63 | 12 | data | 1-W item value #63<br />
<br />
"1-W item value" ofs | LEN | TYPE | content<br />
----------------------+-----+-------+-------------------------------------------------------<br />
0 | 1 | byte | ctrl: main-status<br />
1 | 1 | byte | ctrl: sub-status<br />
2 | 1 | byte | value of ROM-CODE offset [0] (1-W DEVICE TYPE: ID)<br />
3 | 1 | byte | value of ROM-CODE offset [7] (1-W DEVICE TYPE: CRC)<br />
4 | 4 | slong | 1-W read: primary value<br />
8 | 4 | slong | 1-W read: secondary value<br />
<br />
Každý chip na sběrnici 1-Wire má vždy primární a sekundární hodnotu, kterou SDS pro daný chip udržuje (ne vždy jsou však, v závislosti na konkrétním chipu, obě hodnoty použity). Aktuální význam je potřeba určit podle chipu (příklad: DS18B20 má "primary value" zpracovanou teplotu v degC, a "secondary value" přímou surovou 16-bit hodnotu přečtenou z čidla).<br />
<br />
<br />
== (2-PŘ) Master Command: [4] '''Read FC-Get List''' ==<br />
<br />
Dotaz (query) který obsahuje seznam indexů jejichž hodnoty jsou tazatelem požadovány, se posílá do SDS, které následně odpoví (reply).<br />
<br />
Dotaz i odpověď má dynamický obsah, který je specificky strukturován.<br />
<br />
QUERY (master_command == 4, sent to SDS)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------<br />
0 | 2 | uword | [#0] index value <br />
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)<br />
4 | L#0 | data | [#0] space prepared for answer from SDS<br />
<br />
(4+(L#0))+0 | 2 | uword | [#1] index value<br />
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)<br />
(4+(L#0))+4 | L#1 | data | [#1] space prepared for answer from SDS<br />
<br />
. . . | ... | . . . | ...<br />
<br />
Z+0 | 2 | uword | [#n] index value <br />
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)<br />
Z+4 | L#n | data | [#n] space prepared for answer from SDS<br />
<br />
Jak lze vidět, v dotazu (query) jsou za sebou naskládány položky (indexy), na které následně SDS odpoví. Vždy musíte u každého indexu, na který se ptáte, uvést typ odpovědi (viz dále) a prostor, kam bude odpověď zapsána - to znamená, musíte znát přesnou délku, kterou má obsah pro daný index !<br />
<br />
Pozor na množství dotazů v rámci jednoho paketu, protože velikost dotazu, a také velikost odpovědi, je omezena XR_MTU. Jakmile SDS při skládání odpovědi narazení na XR_MTU protistrany, už více odpovědí do paketu nepřidá (aby nebylo XR_MTU překročeno).<br />
<br />
REPLY (master_command == 4, sent from SDS as reply to query)<br />
<br />
SDS writes the values into the "[#n] space prepared for answer from SDS"<br />
<br />
Odpověď tedy přesně sleduje (vyplňuje) původní dotaz, přičemž [C-PAYLOAD] teď obdrží skutečný datový obsah pro jednotlivé položky. Pokud poskytnete SDS menší prostor pro odpověď, než je potřeba, bude odpověď vyplněna 0x00.<br />
<br />
Hodnota "sub_command" je nastavena SDS na počet položek (#n) v odpovědi. Toto omezuje maximální počet položek v jednom paketu na 255.<br />
<br />
Následující popis ukazuje kódování typu proměnné a její délky, ve společném slově:<br />
<br />
TBLEN#x: (16-bit unsigned word, little-endian) Type-Bits and Data Length (L#x)<br />
<br />
TBLEN#x: TTTTvvvvvvvvvvvv<br />
FEDCBA9876543210<br />
<br />
BIT OFFSET (hex) | LEN (bits) | content<br />
-----------------+------------+-----------------------------------------<br />
F (MSB) | 4 | "T": type (see bit-value in next table)<br />
B | 12 | "v": length of data, in bytes<br />
<br />
"T" bit-values | meaning | FULL-C set/get<br />
FEDC | | (which function)<br />
----------------+-----------------------------+------------------<br />
0000 | unsigned integer (32-bit) | _u<br />
0001 | signed integer (32-bit) | _i<br />
0010 | float IEEE-754 (32-bit) | _f<br />
0100 | string UTF-8 (L#x * 8-bit) | _a<br />
1000 | reserved (do not use) | <br />
<br />
Horní 4 bity z TBLEN#x tedy určují typ položky. Pro získání délky L#x položky 'x', je potřeba hodnotu TBLEN#x odmaskovat - použít jen dolních 12 bitů.<br />
<br />
Je vaším úkolem správně zvolit typ (T) pro každou položku, pokud zvolíte špatně, nebude údaj pro daný index zpracován.<br />
<br />
<br />
'''Index Value''' - každá položka má svůj číselný index, viz [[FULL-C:_set_and_get|seznam všech FULL-C indexů]].<br />
<br />
POZOR: V případě chyby dojde k odpovědi S-UDP paketem [0] '''NOP''' bez payloadu. Vaše aplikace, komunikující s SDS, toto musí umět správné zpracovat (pokud dostane na požadavek [4] prázdnou odpověď [0], tak je zřejmé, že jste poslali chybný obsah ve svém požadavku [4] - přičemž SDS neposkytuje další bližší informace o tom, kde přesně ve vašem paketu [4] byla chyba). Odpověď paketem [0] NOP je samozřejmě s vaším požadavkem [4] svázána přes identifikátor v hlavičce.<br />
<br />
<br />
== (2-PŘ) Master Command: [8] '''Write FC-Get List''' ==<br />
<br />
Pokud SDS obdrží zprávu s "master_command == 8", tak nastaví příslušné FULL-C indexy na nové hodnoty (podle obsahu této přijaté zprávy). <br />
<br />
SDS na tuto zprávu odpovídá pouze ve smyslu "úspěch" nebo "neúspěch" - takže pro skutečné ověření hodnot (zda-li se zapsaly správně) musíte proto sami zaslat další zprávu "master_command == 4".<br />
<br />
COMMAND TO SDS (master_command == 8, sent to SDS)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------<br />
0 | 2 | uword | [#0] index value <br />
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)<br />
4 | L#0 | data | [#0] new data value to write to SDS<br />
<br />
(4+(L#0))+0 | 2 | uword | [#1] index value<br />
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)<br />
(4+(L#0))+4 | L#1 | data | [#1] new data value to write to SDS<br />
<br />
. . . | ... | . . . | ...<br />
<br />
Z+0 | 2 | uword | [#n] index value <br />
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)<br />
Z+4 | L#n | data | [#n] new data value to write to SDS<br />
<br />
Lze vidět, že formát je naprosto shodný jako formát odpovědi kterou SDS posílá pro "master_command == 4" zprávu. Nicméně, v tomto případě, je tento obsah [C-PAYLOAD] zapsán '''do''' SDS, které jej zpracuje a provede - pouze ale pokud je délka L#x přesně odpovídající danému indexu.<br />
<br />
Odpověď, kterou na tento příkaz SDS následně posílá, je velmi jednoduchá: [C-PAYLOAD] není vůbec použito (XL=0), a "sub_command" obsahuje následující možnost:<br />
<br />
REPLY FROM SDS (master_command == 8)<br />
<br />
NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS<br />
(previously no proper response was provided)<br />
<br />
sub_command | meaning<br />
------------+-----------------------------------------------------------<br />
0 | complete failure (no item modified)<br />
1 | partial failure (some items modified, some not modified)<br />
2 | success (all items modified OK)<br />
<br />
Další, detailnější, rozlišení selhání (failure) se neprovádí (tzn. SDS neposílá více detailnější informaci ve své odpovědi, než uvedené tři možnosti).<br />
<br />
Pozor, odpověď se týka schopnosti převzít jednotlivé položky ze S-UDP příkazu, a předat je do FULL-C bloku k dalšímu zpracování (zápis do indexů). Pokud je specifický index pouze pro čtení, samozřejmě nedojde k zápisu, ovšem to není bráno jako chyba z hlediska odpovědi na tento paket (jen jednoduše nedojde k zápisu pro daný read-only index). Chybová hodnota (0 nebo 1) je v této celkové odpovědi vrácena pouze pokud je obsahem S-UDP příkazu nesmysl (částečný nebo úplný), např. jde o obsahově prázdný paket (není co zapisovat), nebo se snažíte zapsat nesmyslné velikosti nebo rozsahy hodnot, nebo příliš moc indexů najednou atd. <br />
<br />
<br />
== (2-PŘ) Master Command: [16] '''FULL-C Shared Variable(s) Access''' ==<br />
<br />
Tento příkaz se využívá k přístupu ke [[FULL-C:_sharing|sdíleným proměnným]] programu FULL-C.<br />
<br />
Proměnné se označují vzorem, kde je na začátku velké písmeno určující typ, a pak dvě decimální číslice určující pořadí - tedy sto možných hodnot. <br />
<br />
Mohou existovat tyto sdílené proměnné :<br />
* S00 až S99 (hodnoty: signed 32-bit)<br />
* U00 až U99 (hodnoty: unsigned 32-bit)<br />
* F00 až F99 (hodnoty: float 32-bit)<br />
* T00 až T99 (hodnoty: array/text)<br />
<br />
Rozlišování jednotlivých funkcí je závislé na hodnotě "sub_command":<br />
<br />
QUERY-or-COMMAND TO SDS (master_command == 16, sent to SDS)<br />
<br />
sub_command | meaning<br />
------------+---------------------------------------------<br />
0 | provide list of all active shared variables<br />
1 | read from shared variable (single variable)<br />
2 | reserved<br />
4 | write to shared variable (single variable)<br />
8 | reserved<br />
<br />
Pro "sub_command == 0" poskytne SDS odpověď, kde je uvedeno zda-li je specifická sdílená proměnná definována v právě aktivním FULL-C programu.<br />
<br />
RESPONSE: LIST OF SHARED VARIABLES: sub_command = 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 13 | bytes | Uxx existence: bit-field<br />
13 | 13 | bytes | Sxx existence: bit-field<br />
26 | 13 | bytes | Fxx existence: bit-field<br />
39 | 13 | bytes | Txx existence: bit-field<br />
<br />
Jak lze vidět, v odpovědi jsou čtyři samostatné bitové pole, každé o délce 100 bitů (plus nevyužitý zbytek 4 bitů na konci). Každý bit přestavuje existenci jedné ze sdílených proměnných, pokud je nastaven na 1 tak proměnná existuje.<br />
<br />
Xxx existence: bit-field<br />
<br />
BYTE -> [0] . . . [13]<br />
BITS -> 0 . . . 100 (plus 4 at the end, which are not used)<br />
<br />
BYTE [0] = bit 0, 1, 2, ..., 7<br />
BYTE [1] = bit 8, 9, 10, ..., 15<br />
...<br />
BYTE [13] = bit 96, 97, 98 ..., 103<br />
<br />
example: existence of "U11" => bit 11 => look at BYTE [1]<br />
<br />
Takže pro kteroukoliv sdílenou proměnnou si lze nalézt příslušnou pozici, která ukazuje, zda-li právě daná proměnná existuje.<br />
<br />
<br />
'''Další,''' "sub_command == 1" umožňuje z konkrétní (jedné) sdílené proměnné číst.<br />
<br />
QUERY TO SDS: READ ONE SHARED VARIABLE: sub_command = 1<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 3 | bytes | [#0] name (example: "U25")<br />
1 | 1 | byte | reserved (0x00)<br />
<br />
A ''odpověď'' je:<br />
<br />
REPLY FROM SDS: READ ONE SHARED VARIABLE: sub_command = 1<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 3 | bytes | [#0] name (example: "F95")<br />
1 | 1 | byte | reserved (0x00)<br />
4 | 2 | uword | [#0] L#0: data length (L#0)<br />
6 | 2 | uword | reserved (0x0000)<br />
8 | L#0 | data | [#0] data value from the shared variable<br />
<br />
<br />
'''Dále,''' pro "sub_command == 4" dojde ke změně hodnoty.<br />
<br />
COMMAND TO SDS: WRITE ONE SHARED VARIABLE: sub_command = 4<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 3 | bytes | [#0] name (example: "T12")<br />
1 | 1 | byte | reserved (0x00)<br />
4 | 2 | uword | [#0] L#0: data length (L#0)<br />
6 | 2 | uword | reserved (0x0000)<br />
8 | L#0 | data | [#0] new data value to write to shared variable<br />
<br />
A odpověď je zde shodná jako odpověd pro "sub_command == 1".<br />
<br />
<br />
== (2-PŘ) Master Command: [32] '''S0 Input Configuration Query''' ==<br />
<br />
Určeno pro čtení kalibračních konstant pro S0 vstupy. Současně jsou předány i aktuální (živé) údaje pro daný S0 vstup.<br />
<br />
Pozn. master_command == 32 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 32, sent from SDS as reply)<br />
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).<br />
1 | 1 | byte | total number of S0 inputs for this SDS<br />
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)<br />
3 | 1 | byte | reserved (0x00)<br />
4 | 32 | bytes | text (name: unit)<br />
36 | 32 | bytes | text (name: money)<br />
68 | 32 | bytes | text (unit: power)<br />
100 | 32 | bytes | text (name: power)<br />
132 | 32 | bytes | text (name: device)<br />
168 | 4 | dword | MTD value<br />
172 | 4 | dword | minimal impulse length (msec)<br />
176 | 4 | dword | impulse constant value (imp. per unit)<br />
180 | 4 | bytes | price for T0<br />
184 | 4 | bytes | price for T1<br />
188 | 8 | bytes | reserved (0x00)<br />
196 | 4 | dword | live value: T0 impulse counter<br />
200 | 4 | dword | live value: T1 impulse counter<br />
204 | 4 | dword | T0 offset<br />
208 | 4 | dword | T1 offset<br />
212 | 4 | dword | live value: measured space between impulses (msec)<br />
216 | 4 | dword | live value: time since last registered impulse (msec)<br />
220 | 4 | bytes | reserved (0x00)<br />
224 | n | bytes | live value: combined text<br />
<br />
Kombinovaný text (combined text) obsahuje vypočtené informace, oddělené znakem '|'. Tyto údaje lze přímo zobrazit uživateli. Výpočet provádí SDS, a stejné hodnoty ukazuje na svém webu. Jedná se zde o doplněk původní funkce GDS (master_command==0).<br />
<br />
Délka textu "n" je dynamická, text je zakončen 0x00 (nebo pokud vyjde přesně na maximální délku co se vleze do payloadu, zakončení nemá a je uříznut na posledním znaku, pozor na to).<br />
<br />
<br />
'''(sub_command = 0xFF)''': speciální odpověď pro Tarifní vstup :<br />
<br />
REPLY (master_command == 32, sent from SDS as reply)<br />
sub_command == 0xFF (tariff)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | constant 0xFF<br />
1 | 3 | bytes | reserved (0x00)<br />
4 | 1 | byte | tariff input<br />
5 | 32 | bytes | text (name: tariff)<br />
37 | 32 | bytes | text (name: tariff T0 input)<br />
69 | 32 | bytes | text (name: tariff T1 input)<br />
<br />
<br />
== (2-PŘ) Master Command: [33] '''S0 Input History Values''' ==<br />
<br />
Určeno pro čtení historických hodnot počítadel pro vybraný S0 vstup. Každá nová položka se do záznamu historie uloží co 15 minut.<br />
<br />
Pozn. master_command == 33 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 33, sent from SDS as reply)<br />
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).<br />
1 | 1 | byte | total number of S0 inputs for this SDS<br />
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)<br />
3 | 3 | bytes | reserved (0x00)<br />
6 | 2 | word | history depth (number of items) - value "n" (example: five items -> n == 5)<br />
8 | 4 | dword | uptime value for the last element (#n) in the list<br />
12 | 4 | dword | ntptime value for the last element (#n) in the list<br />
16 | 4 | dword | history item #1: value of T0 counter (this is the most oldest item)<br />
20 | 4 | dword | history item #1: value of T1 counter (this is the most oldest item)<br />
...<br />
16+(n-1)*8 | 4 | dword | history item #n: value of T0 counter (this is the most newest item)<br />
16+(n-1)*8+4 | 4 | dword | history item #n: value of T1 counter (this is the most newest item)<br />
<br />
Historické údaje počítadel ukazují stav počítadel od současnosti dozadu. Položka #1 je nejstarší, pak #2 je mladší atd. až po položku #n která je nejaktuálnější (nejbližší současné chvíli).<br />
<br />
<br />
== (2-PŘ) Master Command: [40] '''AD Input Configuration Query''' ==<br />
<br />
Určeno pro čtení kalibračních konstant pro AD vstupy.<br />
<br />
Pozn. master_command == 40 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 40, sent from SDS as reply)<br />
sub_command == index to AD array [1..MAX]<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+------+-------+------------------------------------------------------<br />
0 | 1 | byte | actual AD input index for this reply<br />
1 | 1 | byte | total number of AD inputs<br />
2 | 2 | bytes | reserved (0x00)<br />
4 | 4 | f32 | F6 calibration constant<br />
8 | 4 | f32 | F5 calibration constant<br />
12 | 4 | f32 | F4 calibration constant<br />
16 | 4 | f32 | F3 calibration constant<br />
20 | 4 | f32 | F2 calibration constant<br />
24 | 4 | f32 | F1 calibration constant<br />
28 | 4 | f32 | F0 calibration constant<br />
32 | 1 | byte | is calibration factory locked<br />
33 | 32 | bytes | unit<br />
65 | 4 | bytes | reserved (0x00)<br />
69 | 32 | bytes | name<br />
101 | 4 | bytes | reserved (0x00)<br />
105 | 4 | dword | raw value<br />
109 | 4 | f32 | real value (converted from raw)<br />
113 | n | bytes | live value text<br />
<br />
Text "live value" obsahuje hodnotu vypočtenou interně v SDS. Text lze prezentovat uživateli (je to stejné jako co SDS ukáže na svém webu). Jedná se o doplňkovou funkci vůči vlastnímu výpočtu ze surových hodnot z GDS (master_command==0).<br />
<br />
<br />
== (2-PŘ) Master Command: [42] '''PWM Output Configuration Query''' ==<br />
<br />
Určeno pro čtení nastavení pro PWM výstup (konfigurace a živý stav).<br />
<br />
Pozn. master_command == 42 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 42, sent from SDS as reply)<br />
sub_command == 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+------+-------+------------------------------------------------------<br />
0 | 1 | byte | reserved (0x00)<br />
1 | 1 | byte | "N" = total number of PWM outputs<br />
2 | 2 | bytes | reserved (0x00)<br />
<br />
4+(i*12)+ 0 | 4 | dword | frequency (Hz) for PWMx<br />
4+(i*12)+ 4 | 4 | dword | "pulse" value for PWMx<br />
4+(i*12)+ 8 | 1 | byte | "ValueB" value for PWMx<br />
4+(i*12)+ 9 | 2 | uword | "ValueS" value for PWMx<br />
4+(i*12)+ 11 | 1 | byte | output enabled for PWMx<br />
<br />
Pozn. PWM1 má hodnotu "i" = 0, PWM2 má hodnotu "i" = 1 atd.<br />
<br />
V případě, že je některý z PWMx výstupů nevyužit ("přeskočen"), je přesto v odpovědi uveden, aby bylo zachováno číslovaní pořadí všech PWMx výstupů.<br />
<br />
<br />
== (2-PŘ) Master Command: [44] '''RELAYs Configuration Query''' ==<br />
<br />
Určeno pro čtení konfigurace RELAY výstupů (nastavení a živý stav).<br />
<br />
Pozn. master_command == 44 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 44, sent from SDS as reply)<br />
sub_command == index to RELAY array [1..MAX]<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+------+-------+------------------------------------------------------<br />
0 | 1 | byte | actual RELAY output index for this reply<br />
1 | 1 | byte | total number of RELAY outputs<br />
2 | 2 | bytes | reserved (0x00)<br />
4 | 32 | bytes | name<br />
36 | 4 | bytes | reserved (0x00)<br />
40 | 1 | byte | "relay-controlled-by" value<br />
41 | 1 | byte | "relay-output" value<br />
<br />
<br />
== (2-PŘ) Master Command: [48] '''SD Card Status Query''' ==<br />
<br />
Určeno pro čtení stavu SD karty.<br />
<br />
Pozn. master_command == 48 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 48, sent from SDS as reply)<br />
sub_command == 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | card mounted <br />
1 | 3 | bytes | reserved<br />
4 | 4 | dword | card type<br />
8 | 4 | dword | card ProdSN<br />
12 | 4 | dword | card init attempts counter<br />
16 | 4 | dword | card init failures counter<br />
20 | 4 | dword | card total sector count in FAT in KiB<br />
24 | 4 | dword | total sector reads counter<br />
28 | 4 | dword | total sector writes counter<br />
32 | 4 | dword | total sector r/w failures counter<br />
<br />
<br />
== (2-PŘ) Master Command: [50] '''Serial Port Access''' ==<br />
<br />
Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější <br />
firmware.<br />
<br />
<br />
== (2-PŘ) Master Command: [64] '''DataFlash (NVM) Access''' ==<br />
<br />
Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější <br />
firmware.<br />
<br />
<br />
== (2-PŘ) Master Command: [128] '''Reserved''' ==<br />
<br />
Tento příkaz není v současné verzi použit. <br />
<br />
<br />
<br />
== (1-PŘ) Master Command (první produktová řada: "TV = 0001...." ) ==<br />
<br />
Jednotlivé základní příkazy (''master command'') - zatím nejsou pro <br />
první produktovou řadu definovány.<br />
<br />
Detaily zde budou doplněny.<br />
<br />
__NOTOC__</div>Adamnhttps://wiki.merenienergie.cz/subdom/wiki/index.php?title=M2M:_S-UDP_protocol&diff=942M2M: S-UDP protocol2025-03-15T08:47:17Z<p>Adamn: </p>
<hr />
<div> Tato stránka popisuje funkci zařízení SDS '''druhé produktové řady''' - protože SDS první produktové řady používají jiný protokol.<br />
<br />
== Rychlá komunikace: S-UDP ==<br />
<br />
Pomocí speciálního protokolu, kdy se data přenášejí prostřednictvím [http://en.wikipedia.org/wiki/User_Datagram_Protocol UDP], je možné získávat informace z výrobků řady SDS/OnlineTechnology.<br />
<br />
S-UDP používá následující výchozí UDP PORT: 310<br />
<br />
Komunikace probíhá formou DOTAZ - ODPOVĚĎ. To znamená, že ten, kdo má o informace zájem (vzdálený uživatel) pošle dotaz (korektně vyplněný UDP paket, viz dále) a obratem obdrží od zařízení odpověď - UDP paket s informacemi. UDP Port na kterém je komunikace prováděna lze samozřejmě v administraci zařízení změnit.<br />
<br />
Přenos dat využívá specifického protokolu, který umožňuje bezpečně ovládat specifické zařízení SDS.<br />
<br />
<br />
'''Typické použití:''' komunikace zařízení SDS s protistranou (např. aplikace na mobilním telefonu).<br />
<br />
<br />
== Informace == <br />
<br />
Některé z FULL-C funkcí, které jsou zde popsány, jsou plně implementovány až ve firmware 03/2025 a dále. Je potřeba, aby jste měli svůj modul SDS aktualizován na nový firmware.<br />
<br />
<br />
== Bezpečnost ==<br />
<br />
Protokol S-UDP je založen na důsledné autentizaci strany, která posílá zprávu - zařízení SDS ověřuje identitu odesílatele příkazu, a ten může ověřit identitu SDS který odpovídá.<br />
<br />
<br />
Je to založeno na následujícím principu:<br />
<br />
- S-UDP protokol je zabezpečen symetrickou šifrou, se sdíleným klíčem který znají jen komunikující strany (bezpečnost je přímo úměrná úrovni zabezpečení tohoto klíče na obou stranách)<br />
<br />
- SDS má unikátní identifikátor (zaručeně unikátní, od výrobce) který nelze změnit (je fyzicky vypálen v SoC - nezměnitelně přímo v silikonu chipu).<br />
<br />
<br />
== S-UDP protokol ==<br />
<br />
Každý příkaz a odpověď jsou v samostatném, jediném, UDP paketu.<br />
<br />
Každý paket je sestaven v rámci společného formátu, který je zde popsán. Samotný doplňující datový obsah (payload) je dynamický, a u některých příkazů není potřeba.<br />
<br />
S-UDP Paket se tedy skládá z těchto základní částí (tyto části jsou právě přenášeny UDP paketem, v následující sestavě):<br />
<br />
[MASTER PACKET CONTENTS]<br />
<br />
OFFSET | LEN | DATA<br />
----------+--------+---------------------------------------------------------------<br />
0 | 28 | HEADER<br />
28 | PL*16 | ENCRYPTED PAYLOAD (contains: payload-header and payload-data)<br />
<br />
'''Pozor!''' Hodnota PL je velikost [ENCRYPTED PAYLOAD] vydělená 16. To znamená, že velikost [ENCRYPTED PAYLOAD] musí být beze zbytku dělitelná 16 (tzn. pouze hodnota 16, 32, 64, ...) ! Pokud je potřeba, doplní se na úplný konec (viz oblast "R") zarovnání do potřebné délky, aby se dosáhlo čisté dělitelnosti 16.<br />
<br />
LITTLE-ENDIAN<br />
<br />
Následující uvedené položky jsou ve formátu [http://en.wikipedia.org/wiki/Endianness#Little-endian Little-Endian] (procesory: ARM, x86):<br />
* ''uword'' (unsigned 16-bit)<br />
* ''dword'' (unsigned 32-bit)<br />
* ''slong'' (signed 32-bit)<br />
* ''qword'' (unsigned 64-bit)<br />
<br />
Položky typu: ''byte'', ''sbyte'', ''bytes'' - jsou jednotlivé samostatné bajty, nesdružené do společného čísla.<br />
<br />
<br />
<br />
Zde jsou uvedeny detailní položky:<br />
<br />
[MASTER PACKET CONTENTS]<br />
<br />
OFFSET | LEN | TYPE | DATA<br />
---------+------+--------+-----------------------------<br />
<br />
[HEADER]<br />
<br />
0 | 3 | bytes | header "SDS"<br />
3 | 1 | byte | TV = (SDS-product-line) including (S-UDP protocol master-version)<br />
4 | 1 | byte | PL = number of 16B chunks - this is the payload_length of [ENCRYPTED PAYLOAD] (example: PL==10 => 160 bytes)<br />
5 | 1 | byte | encryption-flag (NOW ACCEPTS ONLY: 0x10 == XTEA-64-CTR)<br />
6 | 1 | byte | reserved<br />
7 | 1 | byte | CK1: basic additive checksum for [ENCRYPTED PAYLOAD] (start from (including) byte offset [28] and forward)<br />
8 | 4 | dword | user_identifier (correlation identifier) - use this to correlate query to response<br />
12 | 16 | bytes | CounterBlock<br />
----------+------+--------+----------------------------<br />
<br />
[ENCRYPTED PAYLOAD] -> everything from this point is included:<br />
<br />
28 | 1 | byte | random number (shall be always different than what was used ever before)<br />
29 | 1 | byte | CK2: basic additive checksum for [HEADER] (all bytes [0] to [27] included, BUT: skipping byte [7])<br />
30 | 2 | uword | XR_MTU value (maximal size of the custom-payload data including R) ( XL + R <= XR_MTU )<br />
32 | 4 | dword | CRC-32 (part-header and plain-text payload) -> byte [36] (included) up to [52+XL-1] (the R area is not included here)<br />
36 | 4 | dword | uptime (msecs from boot)<br />
40 | 4 | dword | time (epoch) (or, if no NTP is available to SDS, this will be a value of "seconds from boot")<br />
44 | 4 | dword | SDS device type (0xXXXXXXXX) - THIS MUST MATCH<br />
48 | 1 | byte | master_command<br />
49 | 1 | byte | sub_command<br />
50 | 2 | uword | XL value (exact length of the actually useful payload-data): XL = (PL*16) - R - 24<br />
<br />
52 | XL | bytes | custom payload-data [C-PAYLOAD]<br />
<br />
52+XL | R | bytes | specific set of (random data filling) to round-up (the PL*16 value) to a clean 16B multiply (16, 32, 64, etc.)<br />
<br />
----------+------+--------+----------------------------<br />
<br />
<br />
Hodnota "SDS device type" je určena podle typu SDS, se kterým komunikujete. Seznam hodnot viz [[Firmware]], například 0xB1900001 pro BIG-64 nebo 0xB1900002 pro BIG-128 atd.Pokud tato hodnota neodpovídá typu firmware v daném SDS, bude paket zcela ignorován a neproveden. Jediná vyjímka je master_command == NOP, což je záměrná vyjímka, která umožní zjištění typu SDS (a přítomnosti SDS) při zahájení komunikace.<br />
<br />
Hodnota "random number" je zde proto, aby šifrované data byly pokaždé jiné, i když se přenáší stejný obsah (tzn. jedná se o zábranu stenografického odhadu obsahu payloadu).<br />
<br />
Hodnota "time" umožňuje zařízení, které komunikuje s SDS, zabránit "replay" útoku (když se zaznamená paket a později se zopakuje - v takovém případě se na to přijde protože "time" bude významně starší). SDS kontrolu provádí vůči svému vnitřnímu času, vzdálené zařízení co se SDS komunikuje by tuto kontrolu mělo dělat také.<br />
<br />
Protože hodnota "time" se zvyšuje pouze co 1 vteřinu, je k dispozici i hodnota "uptime" která se po resetu/bootu (kde se nastaví na nulu) zvyšuje každou 1 milisekundu o jedničku. Kombinace umožňuje vhodně sestavit algoritmus detekce "replay" útoků.<br />
<br />
"CounterBlock" se využívá pro nastavení začátku šifrování a dešifrování. Všechny detaily jsou zcela shodné jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]]. Z hlediska bezpečnosti je důležité, aby obě strany neustále používaly zvyšující se CounterBlock obsah (začít "od jedničky" pouze a jenom po resetu/bootu), tzn. pro každou zprávu použít poslední hodnotu counteru a na té dále stavět pro novou zprávu atd. .<br />
<br />
Hodnota "crc32" se počítá pro dešifrované data, algoritmus je identický jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]].<br />
<br />
Pro zvolené XTEA-64-CTR má "CounterBlock" následující sestavu svého obsahu:<br />
<br />
CounterBlock:<br />
<br />
OFFSET | LEN | TYPE | DATA<br />
----------+------+--------+-----------------------------------------------------------------------------------------<br />
0 | 8 | qword | XTEA-64-CTR: 64-bit counter (counter is increased by 1, for each 16B of processed data)<br />
8 | 8 | bytes | (reserved) not-used area = reserved (fill with 0x00) <br />
<br />
Pro jiné mechanismy (do budoucna) je v CounterBlock oblasti přidána ještě 8B rezerva (např. pro AES-128 se pak využije všech 16 bajtů).<br />
<br />
<br />
Hodnota "TV" (v [HEADER] na offsetu [3]) je určení typu a verze protokolu. Skládá se ze dvou čtyřbitových údajů, viz následující tabulka.<br />
<br />
TV: ttttVVVV<br />
76543210<br />
<br />
BIT OFFSET | LEN (bits) | content<br />
-----------+------------+--------------------------------------------------<br />
7 (MSB) | 4 | "t": produc-line value: 1 == first, 2 == second<br />
3 | 4 | "V": version: 0 = first S-UDP protocol version<br />
<br />
<br />
V konečném důsledku, skutečnou funkční důležitost ma '''[C-PAYLOAD]''', což je blok dat, který obsahuje hodnoty a příkazy, které pomocí S-UDP chceme přenést.<br />
<br />
<br />
<br />
== Postup při příjmu S-UDP paketu ==<br />
<br />
Každá strana, která přijme S-UDP paket, provede následující kroky:<br />
<br />
1) Ověřit platnost hodnot v [HEADER]<br />
a. text "SDS" (platný obsah)<br />
b. hodnota "TV" ("master-version" a "product-line") (platný obsah)<br />
c. hodnota "PL" v platných mezích<br />
d. hodnota "encryption_flag" (platný obsah)<br />
2) Ověřit základní additive-checksum pro [ENCRYPTED PAYLOAD]<br />
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK1" hodnotě<br />
3) Nastavit dešifrování<br />
a. zvolit algoritmus podle "encryption-flag" hodnoty<br />
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)<br />
c. nastavit "CounterBlock" (přečíst z [HEADER])<br />
4) Dešifrovat celou [ENCRYPTED PAYLOAD] na plain-text<br />
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)<br />
5) Ověřit základní additive-checksum pro [HEADER] - teď totiž už máme hodnotu "CK2"<br />
a. přečíst bajty [0] až [27] (ovšem přeskočit byte [7] - pozor!) a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK2" hodnotě<br />
6) Ověřit další hodnoty<br />
a. "SDS-DEVICE-TYPE" musí odpovídat (záruka ovládání toho správného typu SDS) - pokud hodnotu nevíte, můžete si "pomoci" NOP příkazem<br />
b. uschovat hodnotu "XR_MTU" pro vytváření odpovědi ("XR_MTU" omezuje velikost odpovědi, kterou můžeme zpátky odeslat)<br />
c. ověřit časové údaje ("time" a "uptime")<br />
d. ověřit "XL" vůči "PL"<br />
7) Ověřit CRC-32 dešifrovaného payloadu<br />
a. spočítat CRC-32 správným algoritmem, vučí bajtům (plain-text) z [36] až [52+XL-1] včetně<br />
<br />
8) Hotovo: teď se provede aktuální příkaz (Master Command, dle tabulky podle produktové řady viz "TV")<br />
a odešle odpověď (ponechat user_identifier pro korelaci) (pozor na "XR_MTU" omezení)<br />
<br />
<br />
== Postup při odesílání S-UDP paketu ==<br />
<br />
Odesílatel zprávy provádí tyto kroky:<br />
<br />
1) Je sestaven přesný obsah [C-PAYLOAD] a určena odpovídající hodnota XL<br />
a. obsah samozřejmě odpovídá tomu co chcete odeslat<br />
b. určí se i "master-command" a "sub-command" (pozor na produktovou řadu SDS - viz "TV")<br />
2) Vyplní se [HEADER]<br />
a. hlavička "SDS", "encryption-flag"<br />
b. zapsat správnou hodnotu "TV" podle protokolu a konkrétního SDS ("master-version", "product-line")<br />
c. určí se nová unikátní hodnota "user_identifier", a zapíše se do [HEADER]<br />
d. zapíše se "CounterBlock" (hodnota pokračuje po předchozím paketu)<br />
3) Nachystá se zaokrouhlovací oblast "R" <br />
a. Pokud XL není beze zbytku dělitelná 16, musí se doplnit oblastí "R"<br />
4) Spočítá se hodnota "PL"<br />
a. PL = (XL + R)/16<br />
b. zapsat do [HEADER]<br />
5) Začne se vyplňovat [ENCRYPTED PAYLOAD]<br />
a. zapsat náhodný byte do "random number"<br />
b. spočítá se hodnota "CK2" (sečíst bajty [0] až [27] - ovšem přeskočit byte [7] - pozor!) <br />
c. zapsat hodnotu "XR_MTU" podle možností zařízení (tzn. jak velkou odpověď lze bezpečně přijmout, podle omezení sítě)<br />
d. zapíší se hodnoty "uptime" a "time", zapsat hodnotu "SDS-DEVICE-TYPE"<br />
e. zapsat "master-command" a "sub-command"<br />
6) Spočítá se CRC-32 (před šifrováním)<br />
a. spočítat crc32 pro bajty (plain-text) z offsetu [36] až [52+XL-1] včetně<br />
7) Nastavit šifrování<br />
a. zvolit algoritmus (musí odpovídat tomu, co se zapsalo do "encryption-flag")<br />
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)<br />
c. nastavit "CounterBlock" (stejný jako byl zapsán [HEADER])<br />
8) Šifrovat celou [ENCRYPTED PAYLOAD] na plain-text<br />
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)<br />
b. aktualizovaná hodnota "CounterBlock" (zvýšená o průběh šifrování) se uschová pro další použití - viz bod " 2) c. "<br />
9) Spočítat základní additive-checksum pro [ENCRYPTED PAYLOAD]<br />
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek se zapíše do "CK1" hodnoty<br />
<br />
10) Hotovo: paket se následně odešle přes síť do protistrany, která odpoví novým paketem - ten je vztažen k tomuto dotazu pomocí "user_identifier" hodnoty.<br />
<br />
<br />
<br />
== Vzorové obsahy paketů ==<br />
<br />
Na stránce [[M2M: S-UDP protocol: examples]] naleznete ukázkové vzorové pakety a jejich vnitřní obsah, i se zobrazeních jednotlivých položek v paketu (před a po šifrování).<br />
Toto je vhodné pro vývojáře komunikační protistrany, kterým nestačí popis postupu na této stránce, ale chtějí také vidět jednotlivé kroky s aktuálními hodnotami.<br />
<br />
<br />
== Seznam hlavních příkazů ==<br />
<br />
Obě produktové řady SDS, které jsou na trhu, mají svou sadu "master_command" příkazů. Proto je potřeba nejprve zjistit, do které produktové řady vaše SDS spadá, a podle toho dále pokračovat. Lze to přímo odvodit od typu SDS ("SDS-DEVICE-TYPE" hodnota), nebo se zeptat příkazem NOP.<br />
<br />
Zařazení SDS do produktových řad je v [[Seznam_Všech_SDS|tomto seznamu]].<br />
<br />
* První produktová řada: "TV = 0001...." -> '''(1PŘ)'''<br />
* Druhá produktová řada: "TV = 0010...." -> '''(2PŘ)'''<br />
<br />
<br />
== (2PŘ) Master Command (druhá produktová řada: "TV = 0010...." ) ==<br />
<br />
Jednotlivé základní příkazy (''master command''):<br />
<br />
MASTER COMMAND | command<br />
----------------+-------------------------------------<br />
0 | NOP (replies with NOP)<br />
1 | general device status<br />
2 | 1-Wire access<br />
4 | read FC-Get list<br />
8 | write FC-Set list<br />
16 | FULL-C shared variable(s) access<br />
32 | serial port access<br />
64 | DataFlash access<br />
128 | reserved<br />
<br />
Jak lze vidět, jednotlivé ''master command'' příkazy jsou dále rozlišeny pomocí hodnoty ''sub command''.<br />
<br />
Každý příkaz má doplňující datovou sadu, tzn. [C-PAYLOAD]. V rámci těchto dat jsou uvedeny všechny hodnoty, které přesně určují co se má stát (popř. jsou zde všechny odpovědi na dotaz).<br />
<br />
<br />
== (2-PŘ) Master Command: [0] '''NOP''' ==<br />
<br />
SDS odpoví na tento příkaz odesláním [0] NOP.<br />
<br />
Tohoto příkazu lze využít k ověření komunikace a k vzájemné základní synchronizace.<br />
<br />
Specifická vlastnost příkazu NOP, oproti všem ostatním příkazům, je to, že SDS odpoví i v případě, že v dotazu není správně uvedený SDS Device Type. Toto je záměr, aby bylo možné při začátku komunikace s SDS modulem, tento modul identifikovat. Samozřejmě všechny ostatní bezpečnostní prvky jsou stále aplikovány, jen tento detail je zde upraven.<br />
<br />
Tento příkaz je také velmi užitečný pro získání hodnoty "TV" z [HEADER], tím pádem pro určení číslo produktové řady SDS - a tím pádem k určení které "master_command" příkazy jsou k dispozici !<br />
<br />
REPLY (master_command == 0, sent from SDS as reply)<br />
sub_command = 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-------+-------+------------------------------------------------------<br />
0 | 6 | bytes | MAC ADDRESS (bytes, not text)<br />
6 | 4 | bytes | SDS Device Type<br />
10 | 4 | dword | FW version <br />
14 | 32 | bytes | sysLocation (missing the 0x00 terminator)<br />
46 | 8 | bytes | reserved (0x00)<br />
54 | 32 | bytes | OEM string (missing the 0x00 terminator)<br />
86 | 8 | bytes | reserved (0x00)<br />
94 | 1 | byte | bylo aktivováno RSTD<br />
95 | 1 | byte | bylo aktivováno PVD<br />
96 | 1 | byte | SDS je: BIG (hodnota 1) nebo STSW (hodnota 0)<br />
97 | 8 | bytes | reserved (0x00)<br />
105 | 2 | uword | web interface TCP port number (typicky 80)<br />
107 | 1 | byte | SNMP-read enabled<br />
108 | 1 | byte | SNMP-write enabled<br />
109 | 1 | byte | FULLC shared vars access lock (0 = unlocked) tzn. sys[150]<br />
110 | 1 | byte | FULLC program run status<br />
111 | 1 | byte | FULLC program started-by info<br />
112 | 1 | byte | FULLC program watchdog active<br />
113 | 6 | bytes | reserved<br />
119 | 4 | f32 | backup battery voltage (milliVolts)<br />
<br />
Pozn. rozšířená funkcionalita příkazu NOP (tedy vracení payloadu) bylo přidáno až ve Firmware od verze 3.10.2019.<br />
<br />
<br />
== (2-PŘ) Master Command: [1] '''General Device Status''' ==<br />
<br />
SDS odpoví zasláním vybraných údajů, jejichž seznam je přesně daný. Tato funkce je k dispozici pro umožnění rychlého přístupu k základnímu stavu zařízení SDS, bez složité přípravy.<br />
<br />
Základní odpověď s nejzajímavějšími živými údaji. Určeno např. pro průběžnou aktualizaci stavu zobrazeného uživateli.<br />
<br />
REPLY (master_command == 1, sent from SDS as reply)<br />
sub_command = 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-------+-------+------------------------------------------------------<br />
0 | 6 | bytes | MAC ADDRESS (bytes, not text)<br />
6 | 1 | byte | Ethernet Link Status / Speed (0, 10, 100)<br />
7 | 1 | byte | Amount of users logged into SDS Web Admin<br />
8 | 32 | bytes | sysLocation (missing the 0x00 terminator)<br />
40 | 1 | byte | IP Watchdog Config status<br />
41 | 1 | byte | IP Watchdog Output (relay) status<br />
42 | 2 | uword | IP Watchdog RTT value (note.: 0xFFFF = not available)<br />
44 | 1 | byte | DHCP status<br />
45 | 1 | byte | reserved<br />
46 | 1 | byte | NTP status<br />
47 | 1 | sbyte | NTP offset (+/- hours) (signed char)<br />
48 | 2 | uword | SoC chip temperature (degC)<br />
50 | 1 | byte | GPIO-TOPB PIN(s) direction (0 == input)<br />
51 | 1 | byte | GPIO-TOPB PIN(s) pin value<br />
52 | 32*1 | byte | OPTO [1]..[32] status (0xFF == signal) (0x00 == nosignal)<br />
84 | 32*1 | byte | RELAY [1]..[32] status (active/nonactive)<br />
116 | 32*2 | uword | ADC [0]..[31] RAW value<br />
180 | 1 | byte | General 1-W BUS status<br />
181 | 1 | byte | 1-W BUS A - active device count<br />
182 | 1 | byte | 1-W BUS B - active device count<br />
183 | 3 | bytes | reserved (0x00)<br />
186 | 1 | byte | S0 Tariff Value (active/nonactive)<br />
187 | 1 | byte | number of the following S0 INPUT DB data blocks:<br />
188 | 31*28 | data | S0 INPUT [1]..[ (max) 31] DB (data block)<br />
<br />
<br />
S0-INPUT DB offset | LEN | TYPE | content<br />
-------------------+-----+-------+-------------------------------------------------------<br />
0 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)<br />
1 | 3 | bytes | reserved (filled with 0x00)<br />
4 | 4 | dword | T0 impulse counter<br />
8 | 4 | dword | T1 impulse counter<br />
12 | 4 | dword | T0 offset<br />
16 | 4 | dword | T1 offset<br />
20 | 4 | dword | measured space between impulses (msec)<br />
24 | 4 | dword | time since last registered impulse (msec)<br />
<br />
Sestava [C-PAYLOAD] je tedy zřejmá. <br />
<br />
Poslední blok (offset [188] až [1083] včetně) je určen pro přenos 32 S0 vstupů - často je jich ale v zařízení SDS fyzicky přítomno mnohem méně, např. jen devět - a potom zařízení SDS ve své odpovědi pošle jen devět záznamů (namísto 32) (toto se týká pouze a jenom S0 položek, né jiných v rámci paketu). To je provedeno z praktického důvodu: aby byl UDP paket dostatečně malý (a tedy rychlý na zpracování).<br />
<br />
<br />
== (2-PŘ) Master Command: [2] '''1-Wire Access''' ==<br />
<br />
Tato funkce se používá pro čtení stavu hodnot získaných z obou 1-W sběrnic, kterými SDS disponuje (některé SDS mají jen jednu sběrnici). Maximální počet prvků (chipů) na sběrnici je 64, celkem je tedy k dispozici 2x64 = 128 prvků.<br />
<br />
QUERY/COMMAND TO SDS (master_command == 2)<br />
<br />
sub_command | meaning<br />
------------+-----------------------------------------------------------<br />
0 | reserved<br />
1 | obtain status, and list of found items on BUS A<br />
2 | obtain status, and list of found items on BUS B<br />
4 | list all read-values on BUS A<br />
8 | list all read-values on BUS B<br />
<br />
První možností tedy je sub_command == 1 , tzn. výpis nalezených zařízení na sběrnici A respektive B:<br />
<br />
REPLY (master_command == 1, sent from SDS as reply)<br />
sub_command = 1 or 2<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | global 1-W controller status (SDS status)<br />
1 | 1 | byte | number of active items on BUS A<br />
2 | 1 | byte | number of active items on BUS B<br />
3 | 1 | byte | reserved (0x00)<br />
4 | 12 | data | 1-W item status #0<br />
. . . | ... | ... | . . .<br />
4+12*63 | 12 | data | 1-W item status #63<br />
<br />
"1-W item status" ofs | LEN | TYPE | content<br />
----------------------+-----+-------+-------------------------------------------------------<br />
0 | 1 | byte | ctrl: main-status<br />
1 | 1 | byte | ctrl: sub-status <br />
2 | 2 | bytes | reserved (filled with 0x00)<br />
4 | 8 | bytes | ROM-CODE [0]..[7]<br />
<br />
Následuje: výpis získaných hodnot (např. změřené teploty z teplotních čidel) pro jednotlivé sběrnice :<br />
<br />
REPLY (master_command == 1, sent from SDS as reply)<br />
sub_command = 4 or 8<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | global 1-W controller status (SDS status)<br />
1 | 1 | byte | number of active items on BUS A<br />
2 | 1 | byte | number of active items on BUS B<br />
3 | 1 | byte | reserved (0x00)<br />
4 | 12 | data | 1-W item value #0<br />
. . . | ... | ... | . . .<br />
4+12*63 | 12 | data | 1-W item value #63<br />
<br />
"1-W item value" ofs | LEN | TYPE | content<br />
----------------------+-----+-------+-------------------------------------------------------<br />
0 | 1 | byte | ctrl: main-status<br />
1 | 1 | byte | ctrl: sub-status<br />
2 | 1 | byte | value of ROM-CODE offset [0] (1-W DEVICE TYPE: ID)<br />
3 | 1 | byte | value of ROM-CODE offset [7] (1-W DEVICE TYPE: CRC)<br />
4 | 4 | slong | 1-W read: primary value<br />
8 | 4 | slong | 1-W read: secondary value<br />
<br />
Každý chip na sběrnici 1-Wire má vždy primární a sekundární hodnotu, kterou SDS pro daný chip udržuje (ne vždy jsou však, v závislosti na konkrétním chipu, obě hodnoty použity). Aktuální význam je potřeba určit podle chipu (příklad: DS18B20 má "primary value" zpracovanou teplotu v degC, a "secondary value" přímou surovou 16-bit hodnotu přečtenou z čidla).<br />
<br />
<br />
== (2-PŘ) Master Command: [4] '''Read FC-Get List''' ==<br />
<br />
Dotaz (query) který obsahuje seznam indexů jejichž hodnoty jsou tazatelem požadovány, se posílá do SDS, které následně odpoví (reply).<br />
<br />
Dotaz i odpověď má dynamický obsah, který je specificky strukturován.<br />
<br />
QUERY (master_command == 4, sent to SDS)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------<br />
0 | 2 | uword | [#0] index value <br />
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)<br />
4 | L#0 | data | [#0] space prepared for answer from SDS<br />
<br />
(4+(L#0))+0 | 2 | uword | [#1] index value<br />
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)<br />
(4+(L#0))+4 | L#1 | data | [#1] space prepared for answer from SDS<br />
<br />
. . . | ... | . . . | ...<br />
<br />
Z+0 | 2 | uword | [#n] index value <br />
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)<br />
Z+4 | L#n | data | [#n] space prepared for answer from SDS<br />
<br />
Jak lze vidět, v dotazu (query) jsou za sebou naskládány položky (indexy), na které následně SDS odpoví. Vždy musíte u každého indexu, na který se ptáte, uvést typ odpovědi (viz dále) a prostor, kam bude odpověď zapsána - to znamená, musíte znát přesnou délku, kterou má obsah pro daný index !<br />
<br />
Pozor na množství dotazů v rámci jednoho paketu, protože velikost dotazu, a také velikost odpovědi, je omezena XR_MTU. Jakmile SDS při skládání odpovědi narazení na XR_MTU protistrany, už více odpovědí do paketu nepřidá (aby nebylo XR_MTU překročeno).<br />
<br />
REPLY (master_command == 4, sent from SDS as reply to query)<br />
<br />
SDS writes the values into the "[#n] space prepared for answer from SDS"<br />
<br />
Odpověď tedy přesně sleduje (vyplňuje) původní dotaz, přičemž [C-PAYLOAD] teď obdrží skutečný datový obsah pro jednotlivé položky. Pokud poskytnete SDS menší prostor pro odpověď, než je potřeba, bude odpověď vyplněna 0x00.<br />
<br />
Hodnota "sub_command" je nastavena SDS na počet položek (#n) v odpovědi. Toto omezuje maximální počet položek v jednom paketu na 255.<br />
<br />
Následující popis ukazuje kódování typu proměnné a její délky, ve společném slově:<br />
<br />
TBLEN#x: (16-bit unsigned word, little-endian) Type-Bits and Data Length (L#x)<br />
<br />
TBLEN#x: TTTTvvvvvvvvvvvv<br />
FEDCBA9876543210<br />
<br />
BIT OFFSET (hex) | LEN (bits) | content<br />
-----------------+------------+-----------------------------------------<br />
F (MSB) | 4 | "T": type (see bit-value in next table)<br />
B | 12 | "v": length of data, in bytes<br />
<br />
"T" bit-values | meaning | FULL-C set/get<br />
FEDC | | (which function)<br />
----------------+-----------------------------+------------------<br />
0000 | unsigned integer (32-bit) | _u<br />
0001 | signed integer (32-bit) | _i<br />
0010 | float IEEE-754 (32-bit) | _f<br />
0100 | string UTF-8 (L#x * 8-bit) | _a<br />
1000 | reserved (do not use) | <br />
<br />
Horní 4 bity z TBLEN#x tedy určují typ položky. Pro získání délky L#x položky 'x', je potřeba hodnotu TBLEN#x odmaskovat - použít jen dolních 12 bitů.<br />
<br />
Je vaším úkolem správně zvolit typ (T) pro každou položku, pokud zvolíte špatně, nebude údaj pro daný index zpracován.<br />
<br />
<br />
'''Index Value''' - každá položka má svůj číselný index, viz [[FULL-C:_set_and_get|seznam všech FULL-C indexů]].<br />
<br />
<br />
== (2-PŘ) Master Command: [8] '''Write FC-Get List''' ==<br />
<br />
Pokud SDS obdrží zprávu s "master_command == 8", tak nastaví příslušné FULL-C indexy na nové hodnoty (podle obsahu této přijaté zprávy). <br />
<br />
SDS na tuto zprávu odpovídá pouze ve smyslu "úspěch" nebo "neúspěch" - takže pro skutečné ověření hodnot (zda-li se zapsaly správně) musíte proto sami zaslat další zprávu "master_command == 4".<br />
<br />
COMMAND TO SDS (master_command == 8, sent to SDS)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------<br />
0 | 2 | uword | [#0] index value <br />
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)<br />
4 | L#0 | data | [#0] new data value to write to SDS<br />
<br />
(4+(L#0))+0 | 2 | uword | [#1] index value<br />
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)<br />
(4+(L#0))+4 | L#1 | data | [#1] new data value to write to SDS<br />
<br />
. . . | ... | . . . | ...<br />
<br />
Z+0 | 2 | uword | [#n] index value <br />
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)<br />
Z+4 | L#n | data | [#n] new data value to write to SDS<br />
<br />
Lze vidět, že formát je naprosto shodný jako formát odpovědi kterou SDS posílá pro "master_command == 4" zprávu. Nicméně, v tomto případě, je tento obsah [C-PAYLOAD] zapsán '''do''' SDS, které jej zpracuje a provede - pouze ale pokud je délka L#x přesně odpovídající danému indexu.<br />
<br />
Odpověď, kterou na tento příkaz SDS následně posílá, je velmi jednoduchá: [C-PAYLOAD] není vůbec použito (XL=0), a "sub_command" obsahuje následující možnost:<br />
<br />
REPLY FROM SDS (master_command == 8)<br />
<br />
NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS<br />
(previously no proper response was provided)<br />
<br />
sub_command | meaning<br />
------------+-----------------------------------------------------------<br />
0 | complete failure (no item modified)<br />
1 | partial failure (some items modified, some not modified)<br />
2 | success (all items modified OK)<br />
<br />
Další, detailnější, rozlišení selhání (failure) se neprovádí (tzn. SDS neposílá více detailnější informaci ve své odpovědi, než uvedené tři možnosti).<br />
<br />
Pozor, odpověď se týka schopnosti převzít jednotlivé položky ze S-UDP příkazu, a předat je do FULL-C bloku k dalšímu zpracování (zápis do indexů). Pokud je specifický index pouze pro čtení, samozřejmě nedojde k zápisu, ovšem to není bráno jako chyba z hlediska odpovědi na tento paket (jen jednoduše nedojde k zápisu pro daný read-only index). Chybová hodnota (0 nebo 1) je v této celkové odpovědi vrácena pouze pokud je obsahem S-UDP příkazu nesmysl (částečný nebo úplný), např. jde o obsahově prázdný paket (není co zapisovat), nebo se snažíte zapsat nesmyslné velikosti nebo rozsahy hodnot, nebo příliš moc indexů najednou atd. <br />
<br />
<br />
== (2-PŘ) Master Command: [16] '''FULL-C Shared Variable(s) Access''' ==<br />
<br />
Tento příkaz se využívá k přístupu ke [[FULL-C:_sharing|sdíleným proměnným]] programu FULL-C.<br />
<br />
Proměnné se označují vzorem, kde je na začátku velké písmeno určující typ, a pak dvě decimální číslice určující pořadí - tedy sto možných hodnot. <br />
<br />
Mohou existovat tyto sdílené proměnné :<br />
* S00 až S99 (hodnoty: signed 32-bit)<br />
* U00 až U99 (hodnoty: unsigned 32-bit)<br />
* F00 až F99 (hodnoty: float 32-bit)<br />
* T00 až T99 (hodnoty: array/text)<br />
<br />
Rozlišování jednotlivých funkcí je závislé na hodnotě "sub_command":<br />
<br />
QUERY-or-COMMAND TO SDS (master_command == 16, sent to SDS)<br />
<br />
sub_command | meaning<br />
------------+---------------------------------------------<br />
0 | provide list of all active shared variables<br />
1 | read from shared variable (single variable)<br />
2 | reserved<br />
4 | write to shared variable (single variable)<br />
8 | reserved<br />
<br />
Pro "sub_command == 0" poskytne SDS odpověď, kde je uvedeno zda-li je specifická sdílená proměnná definována v právě aktivním FULL-C programu.<br />
<br />
RESPONSE: LIST OF SHARED VARIABLES: sub_command = 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 13 | bytes | Uxx existence: bit-field<br />
13 | 13 | bytes | Sxx existence: bit-field<br />
26 | 13 | bytes | Fxx existence: bit-field<br />
39 | 13 | bytes | Txx existence: bit-field<br />
<br />
Jak lze vidět, v odpovědi jsou čtyři samostatné bitové pole, každé o délce 100 bitů (plus nevyužitý zbytek 4 bitů na konci). Každý bit přestavuje existenci jedné ze sdílených proměnných, pokud je nastaven na 1 tak proměnná existuje.<br />
<br />
Xxx existence: bit-field<br />
<br />
BYTE -> [0] . . . [13]<br />
BITS -> 0 . . . 100 (plus 4 at the end, which are not used)<br />
<br />
BYTE [0] = bit 0, 1, 2, ..., 7<br />
BYTE [1] = bit 8, 9, 10, ..., 15<br />
...<br />
BYTE [13] = bit 96, 97, 98 ..., 103<br />
<br />
example: existence of "U11" => bit 11 => look at BYTE [1]<br />
<br />
Takže pro kteroukoliv sdílenou proměnnou si lze nalézt příslušnou pozici, která ukazuje, zda-li právě daná proměnná existuje.<br />
<br />
<br />
'''Další,''' "sub_command == 1" umožňuje z konkrétní (jedné) sdílené proměnné číst.<br />
<br />
QUERY TO SDS: READ ONE SHARED VARIABLE: sub_command = 1<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 3 | bytes | [#0] name (example: "U25")<br />
1 | 1 | byte | reserved (0x00)<br />
<br />
A ''odpověď'' je:<br />
<br />
REPLY FROM SDS: READ ONE SHARED VARIABLE: sub_command = 1<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 3 | bytes | [#0] name (example: "F95")<br />
1 | 1 | byte | reserved (0x00)<br />
4 | 2 | uword | [#0] L#0: data length (L#0)<br />
6 | 2 | uword | reserved (0x0000)<br />
8 | L#0 | data | [#0] data value from the shared variable<br />
<br />
<br />
'''Dále,''' pro "sub_command == 4" dojde ke změně hodnoty.<br />
<br />
COMMAND TO SDS: WRITE ONE SHARED VARIABLE: sub_command = 4<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+--------------------------<br />
0 | 3 | bytes | [#0] name (example: "T12")<br />
1 | 1 | byte | reserved (0x00)<br />
4 | 2 | uword | [#0] L#0: data length (L#0)<br />
6 | 2 | uword | reserved (0x0000)<br />
8 | L#0 | data | [#0] new data value to write to shared variable<br />
<br />
A odpověď je zde shodná jako odpověd pro "sub_command == 1".<br />
<br />
<br />
== (2-PŘ) Master Command: [32] '''S0 Input Configuration Query''' ==<br />
<br />
Určeno pro čtení kalibračních konstant pro S0 vstupy. Současně jsou předány i aktuální (živé) údaje pro daný S0 vstup.<br />
<br />
Pozn. master_command == 32 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 32, sent from SDS as reply)<br />
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).<br />
1 | 1 | byte | total number of S0 inputs for this SDS<br />
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)<br />
3 | 1 | byte | reserved (0x00)<br />
4 | 32 | bytes | text (name: unit)<br />
36 | 32 | bytes | text (name: money)<br />
68 | 32 | bytes | text (unit: power)<br />
100 | 32 | bytes | text (name: power)<br />
132 | 32 | bytes | text (name: device)<br />
168 | 4 | dword | MTD value<br />
172 | 4 | dword | minimal impulse length (msec)<br />
176 | 4 | dword | impulse constant value (imp. per unit)<br />
180 | 4 | bytes | price for T0<br />
184 | 4 | bytes | price for T1<br />
188 | 8 | bytes | reserved (0x00)<br />
196 | 4 | dword | live value: T0 impulse counter<br />
200 | 4 | dword | live value: T1 impulse counter<br />
204 | 4 | dword | T0 offset<br />
208 | 4 | dword | T1 offset<br />
212 | 4 | dword | live value: measured space between impulses (msec)<br />
216 | 4 | dword | live value: time since last registered impulse (msec)<br />
220 | 4 | bytes | reserved (0x00)<br />
224 | n | bytes | live value: combined text<br />
<br />
Kombinovaný text (combined text) obsahuje vypočtené informace, oddělené znakem '|'. Tyto údaje lze přímo zobrazit uživateli. Výpočet provádí SDS, a stejné hodnoty ukazuje na svém webu. Jedná se zde o doplněk původní funkce GDS (master_command==0).<br />
<br />
Délka textu "n" je dynamická, text je zakončen 0x00 (nebo pokud vyjde přesně na maximální délku co se vleze do payloadu, zakončení nemá a je uříznut na posledním znaku, pozor na to).<br />
<br />
<br />
'''(sub_command = 0xFF)''': speciální odpověď pro Tarifní vstup :<br />
<br />
REPLY (master_command == 32, sent from SDS as reply)<br />
sub_command == 0xFF (tariff)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | constant 0xFF<br />
1 | 3 | bytes | reserved (0x00)<br />
4 | 1 | byte | tariff input<br />
5 | 32 | bytes | text (name: tariff)<br />
37 | 32 | bytes | text (name: tariff T0 input)<br />
69 | 32 | bytes | text (name: tariff T1 input)<br />
<br />
<br />
== (2-PŘ) Master Command: [33] '''S0 Input History Values''' ==<br />
<br />
Určeno pro čtení historických hodnot počítadel pro vybraný S0 vstup. Každá nová položka se do záznamu historie uloží co 15 minut.<br />
<br />
Pozn. master_command == 33 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 33, sent from SDS as reply)<br />
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).<br />
1 | 1 | byte | total number of S0 inputs for this SDS<br />
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)<br />
3 | 3 | bytes | reserved (0x00)<br />
6 | 2 | word | history depth (number of items) - value "n" (example: five items -> n == 5)<br />
8 | 4 | dword | uptime value for the last element (#n) in the list<br />
12 | 4 | dword | ntptime value for the last element (#n) in the list<br />
16 | 4 | dword | history item #1: value of T0 counter (this is the most oldest item)<br />
20 | 4 | dword | history item #1: value of T1 counter (this is the most oldest item)<br />
...<br />
16+(n-1)*8 | 4 | dword | history item #n: value of T0 counter (this is the most newest item)<br />
16+(n-1)*8+4 | 4 | dword | history item #n: value of T1 counter (this is the most newest item)<br />
<br />
Historické údaje počítadel ukazují stav počítadel od současnosti dozadu. Položka #1 je nejstarší, pak #2 je mladší atd. až po položku #n která je nejaktuálnější (nejbližší současné chvíli).<br />
<br />
<br />
== (2-PŘ) Master Command: [40] '''AD Input Configuration Query''' ==<br />
<br />
Určeno pro čtení kalibračních konstant pro AD vstupy.<br />
<br />
Pozn. master_command == 40 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 40, sent from SDS as reply)<br />
sub_command == index to AD array [1..MAX]<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+------+-------+------------------------------------------------------<br />
0 | 1 | byte | actual AD input index for this reply<br />
1 | 1 | byte | total number of AD inputs<br />
2 | 2 | bytes | reserved (0x00)<br />
4 | 4 | f32 | F6 calibration constant<br />
8 | 4 | f32 | F5 calibration constant<br />
12 | 4 | f32 | F4 calibration constant<br />
16 | 4 | f32 | F3 calibration constant<br />
20 | 4 | f32 | F2 calibration constant<br />
24 | 4 | f32 | F1 calibration constant<br />
28 | 4 | f32 | F0 calibration constant<br />
32 | 1 | byte | is calibration factory locked<br />
33 | 32 | bytes | unit<br />
65 | 4 | bytes | reserved (0x00)<br />
69 | 32 | bytes | name<br />
101 | 4 | bytes | reserved (0x00)<br />
105 | 4 | dword | raw value<br />
109 | 4 | f32 | real value (converted from raw)<br />
113 | n | bytes | live value text<br />
<br />
Text "live value" obsahuje hodnotu vypočtenou interně v SDS. Text lze prezentovat uživateli (je to stejné jako co SDS ukáže na svém webu). Jedná se o doplňkovou funkci vůči vlastnímu výpočtu ze surových hodnot z GDS (master_command==0).<br />
<br />
<br />
== (2-PŘ) Master Command: [42] '''PWM Output Configuration Query''' ==<br />
<br />
Určeno pro čtení nastavení pro PWM výstup (konfigurace a živý stav).<br />
<br />
Pozn. master_command == 42 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 42, sent from SDS as reply)<br />
sub_command == 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+------+-------+------------------------------------------------------<br />
0 | 1 | byte | reserved (0x00)<br />
1 | 1 | byte | "N" = total number of PWM outputs<br />
2 | 2 | bytes | reserved (0x00)<br />
<br />
4+(i*12)+ 0 | 4 | dword | frequency (Hz) for PWMx<br />
4+(i*12)+ 4 | 4 | dword | "pulse" value for PWMx<br />
4+(i*12)+ 8 | 1 | byte | "ValueB" value for PWMx<br />
4+(i*12)+ 9 | 2 | uword | "ValueS" value for PWMx<br />
4+(i*12)+ 11 | 1 | byte | output enabled for PWMx<br />
<br />
Pozn. PWM1 má hodnotu "i" = 0, PWM2 má hodnotu "i" = 1 atd.<br />
<br />
V případě, že je některý z PWMx výstupů nevyužit ("přeskočen"), je přesto v odpovědi uveden, aby bylo zachováno číslovaní pořadí všech PWMx výstupů.<br />
<br />
<br />
== (2-PŘ) Master Command: [44] '''RELAYs Configuration Query''' ==<br />
<br />
Určeno pro čtení konfigurace RELAY výstupů (nastavení a živý stav).<br />
<br />
Pozn. master_command == 44 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 44, sent from SDS as reply)<br />
sub_command == index to RELAY array [1..MAX]<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+------+-------+------------------------------------------------------<br />
0 | 1 | byte | actual RELAY output index for this reply<br />
1 | 1 | byte | total number of RELAY outputs<br />
2 | 2 | bytes | reserved (0x00)<br />
4 | 32 | bytes | name<br />
36 | 4 | bytes | reserved (0x00)<br />
40 | 1 | byte | "relay-controlled-by" value<br />
41 | 1 | byte | "relay-output" value<br />
<br />
<br />
== (2-PŘ) Master Command: [48] '''SD Card Status Query''' ==<br />
<br />
Určeno pro čtení stavu SD karty.<br />
<br />
Pozn. master_command == 48 byl přidán až ve Firmware od verze 3.10.2019.<br />
<br />
REPLY (master_command == 48, sent from SDS as reply)<br />
sub_command == 0<br />
<br />
C-PAYLOAD offset | LEN | TYPE | content<br />
-----------------+-----+-------+------------------------------------------------------<br />
0 | 1 | byte | card mounted <br />
1 | 3 | bytes | reserved<br />
4 | 4 | dword | card type<br />
8 | 4 | dword | card ProdSN<br />
12 | 4 | dword | card init attempts counter<br />
16 | 4 | dword | card init failures counter<br />
20 | 4 | dword | card total sector count in FAT in KiB<br />
24 | 4 | dword | total sector reads counter<br />
28 | 4 | dword | total sector writes counter<br />
32 | 4 | dword | total sector r/w failures counter<br />
<br />
<br />
== (2-PŘ) Master Command: [50] '''Serial Port Access''' ==<br />
<br />
Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější <br />
firmware.<br />
<br />
<br />
== (2-PŘ) Master Command: [64] '''DataFlash (NVM) Access''' ==<br />
<br />
Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější <br />
firmware.<br />
<br />
<br />
== (2-PŘ) Master Command: [128] '''Reserved''' ==<br />
<br />
Tento příkaz není v současné verzi použit. <br />
<br />
<br />
<br />
== (1-PŘ) Master Command (první produktová řada: "TV = 0001...." ) ==<br />
<br />
Jednotlivé základní příkazy (''master command'') - zatím nejsou pro <br />
první produktovou řadu definovány.<br />
<br />
Detaily zde budou doplněny.<br />
<br />
__NOTOC__</div>Adamn