SDS: Síťový Dohledový Systém - Příspěvky uživatele [cs]

Síťový Dohledový Systém

2025-12-23T17:54:44Z

Adamn:

<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>

<div class="row">

<div class="small-2 large-4 columns">

<div class="successbox">První Produktová Řada SDS</div>
Řada '''ST''': ''aktuální''
<ul>
<li> [[SDS MICRO: ST]] / [[SDS MICRO: ST DP|ST-DP]]</li>
<li> [[SDS IO6: ST]]</li>
<li> [[SDS MACRO: ST]]</li>
<li> [[SDS TTCPRO: ST]] (+[[SDS TTCPRO: GSM|GSM]], +[[SDS TTCPRO: 8in2out|8in2out]])</li>
<li> [[SDS MINI: ST]] ([[SDS MINI: LoRa|+ LoRA]])</li></ul>
</ul>
<div><br></div>
Řada '''LM''':
<ul>
<li> [[SDS MICRO: LM]] <br>varianty: LIGHT / E (DIN)</li>
<li> [[SDS IO6: LM]]</li>
<li> [[SDS MACRO: LM]]</li>
<li> [[SDS UPS: LM]] varianta: ONEDPS</li>
</ul>

<div><br></div>
<div class="successbox">Druhá Produktová Řada SDS</div>
<ul>
<li> [[SDS BIG|SDS BIG / BIG2]] (DP, DS84) : 64 / 128 / 512</li>
<li>    [[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>
<li> [[SDS SMALL]] : 64 / 128 / 512</li>
<li> [[SDS STSW]] : 64 / 128 / 512</li>
<li> [[SDS MBGW|SDS ENERGO MBGW]] : 512</li>
</ul>
<div><br></div>

<div class="successbox">SDS Doplňkové Moduly</div>
<ul>
<div><li> [[SDS 1W T-RH]]</div>
<div><li> [[SDS ANALOG RH]]</div>
<div><li> [[SDS PWM10]]</div>
</ul>
<div><br></div>

</div>

<div class="small-4 large-4 columns">

<div class="successbox">SDS-C</div>
<ul>
<li> [[SDS-C: intro|úvod]] a [[SDS-C: popis jazyka|popis jazyka]]</li>
<li> [[SDS-C: sdsc_sysp|systémové proměnné]]</li>
<li> [[SDS-C: sdsc_rsvdf|vyhrazené funkce]]</li>
<li> [[SDS-C: sdsc_sysf|systémové funkce]]</li>
<li> [[OSI7 status code|OSI stavové hodnoty]]</li>
<li> [[SDS-C: examples|příklady]]</li>
<li> [[SDS-C: DataFlash|paměť DataFlash]]</li>
<li> [[SDS-C: rychlost|rychlost]]</li>
<li> [[SDS-C: sharing|sdílené proměnné]]</li>
<li> [[SDS-C: program upload|způsoby nahrání SDS-C do SDS]]</li>
</ul>
<div><br></div>
<div class="successbox">FULL-C</div>
<ul>
<li> [[FULL-C: intro|úvod]] a [[FULL-C: popis jazyka|popis jazyka]]</li>
<li> [[FULL-C: tips and tricks|důležité postupy, triky, tipy]]</li>
<li> [[FULL-C: set and get|systémové proměnné]]</li>
<li> [[FULL-C: functions|systémové funkce]]</li>
<li> [[FULL-C: examples|příklady]]</li>
<li> [[FULL-C: sharing|sdílené proměnné]]</li>
<li> [[FULL-C: SD card|použití SD karty]]</li>
<li> [[FULL-C: 64 bit|64-bitové proměnné a programování]]</li>
<li> [[FULL-C: program upload|způsoby nahrání FC do SDS]]</li>
</ul>
<div><br></div>

<div class="successbox">Webové Rozhraní</div>
<ul>
<li> [[HTTPS, TLS]]</li>
<li> 1PŘ [[Webové Rozhraní: První Produktová Řada|web]], 2PŘ [[Webové Rozhraní: Druhá Produktová Řada|web]]</li>
<li> 1PŘ [[M2M: První Produktová Řada|M2M]], 2PŘ [[M2M: Druhá Produktová Řada|M2M]]</li>
<li> [[User Web Page]]</li>
<li> [[SDS Audit Log]]</li>
<li> [[Config Status]]</li>
</ul>
</div>

<div class="small-6 large-4 columns">
<div class="successbox">Aktualizace</div>
<ul>
<li> [[Seznam Všech SDS]] - co si vybrat</li>
<li> '''[[Firmware|> > > Nový Firmware < < <]]'''</li>
<li> [[Konfigurace Zařízení SDS]]</li>
</ul>
<div><br></div>
<div class="successbox">Kontakty</div>
<ul>
<li> [http://forum.merenienergie.cz Live Podpora: Fórum] </li>
<li> [[Přímý kontakt na vývojáře SDS]] </li>
<li> [http://www.onlinetechnology.cz E-SHOP OnlineTechnology.cz] </li>
<li> [http://energycloud.merenienergie.cz Portál Měření Energií] </li>
<li> [https://vati.cz/zakazkove-programovani Zakázková tvorba programů pro SDS]</li>
</ul>
<div><br></div>
<div class="successbox">Technologie</div>
<ul>
<li> [[SDS v síti: tipy, příklady, nastavení]]</li>
<li> [[HW Vstupy]] a [[HW Výstupy]]</li>
<li> [[SDS: Měření energie]]</li>
<li> [[S0|Odečet rozhraní S0]], a [[S0 Algoritmus]]</li>
<li> [[MQTT]]</li>
<li> [[MODBUS-TCP]]</li>
<li> [[SNMP]] + [[SNMP: TRAP|TRAP]] , [[SNMP:_OIDs|seznam OID]]</li>
<li> [[SMTP]] (email)</li>
<li> SDS: 1PŘ [[M2M: UDP protocol|UDP]], 2PŘ [[M2M: S-UDP protocol|S-UDP]]</li>
<li> GET/POST:<br>1PŘ [[HTTP Klient: První Produktová Řada|HTTP klient]], 2PŘ [[FULL-C:_http_client_functions|HTTP klient]]</li>
<li> [[SD karta]]</li>
<li> [[LoRA]]</li>
<li> [[OneWire]]</li>
<li> [[DALI]]</li>
<li> [[I2C]], [[CAN]], [[RS485, RS422, RS232]], [[MODBUS-RTU]]</li>
<li> [[MBUS]]</li>
</ul>
</div>

</div>

</div>

<br><br>
=== Síťový Dohledový Systém - OnlineTechnology.cz ===

Vítejte v aktualizované wiki pro výrobky SDS, vyvíjené a vyráběné v České Republice.

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í.

PROČ KOUPIT PRÁVĚ NAŠE VÝROBKY SDS?
* vynikající poměr cena / výkon
* nejlepší poměr přepočítané ceny na jeden vstup/výstup, bez kompromisu v návrhu a realizaci výrobku
* plná uživatelská programovatelnost, žádná omezení
* trvalá osobní technická podpora, bez ohledu na datum prodeje nebo typ či počet zařízeni
* trvalá podpora naprosto všech prodaných výrobků (stále vydáváme nový firmware, a to i pro ty nejstarší výrobky)
* trvalá aktualizace hardware (vydáváme nové lepší moduly, a stále podporujeme i ty předchozí)
* integrace i do systémů jako je Node-RED a další
* živé diskusní fórum a návody na wiki

PLC/PAC SDS
* Programmable Logic Controller / Programmable Automation Controller - to je SDS
* Programování v jazyce SDS-C nebo FULL-C bez omezení, možnost sledování a změna parametrů za běhu
* Velké množství I/O a komunikačních rozhraní
* SDS je bezpečné a stabilní - nezaloženo na Linuxu, naopak: SDS běží na profesionálně napsaném a testovaném firmware

AN-D označuje skupinu odpovědnou za vývoj a design výrobku - prodej je v režii výrobce.
Designed in Czech Republic, Europe. Made in Czech Republic, Europe.

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 !

Chcete integrovat SDS do svého výrobku ? Nabízíme možnost OEM zástavby.

=== Prodej ===

SDS okamžitě zakoupíte na oficiálním eshopu: www.onlinetechnology.cz

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.

Firmware

2025-11-23T10:25:07Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

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]].

=== Odkazy ke stáhnutí ===
<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.
<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<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]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

SDS MACRO: ST: firmware changelog

2025-11-15T14:25:10Z

Adamn:

== SDS-MACRO ST ==

__NOTOC__

Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-MACRO ST.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

== 15.11.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* SDS-C: přidány indexy 303 a 304 a 305
* SDS-C: přidán index 2198

== 2.11.2023 ==
* oprava SNMP (způsob předávání chybových hodnot)
* opraveno: LOGIC-S0 lze použít pro výběr Tarifu

== 29.11.2022 ==
* SDS-C: přidán index 137
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve
* 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

== 26.11.2022 ==
* 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)
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)

== 4.8.2022 ==
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti
* 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í)
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce
* malá bezpečnostní aktualizace

== 1.7.2022 ==
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)
* 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
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných
* další drobné úpravy a opravy

== 27.12.2021 ==
* opraveno: nastavení názvu relé 2 až 6 se teď správně ukládá (funguje)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí

== 3.5.2021 ==
* oprava nastavování frekvence PWM1 přes webové rozhraní

== 14.4.2021 ==
* oprava hodnot v sys 39 (0 vyp, 3 zap)

== 13.4.2021 ==
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP

== 11.4.2021 ==
* 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.).

== 26.3.2021 ==
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)

== 12.3.2021 ==
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno

== 9.2.2021 ==
* SDS-C: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* SDS-C: drobná úspora heap (více dostupného místa)
* SDS-C: dns resolv drobný fix
* SDS-C: http_get a http_post důležitý fix
* SDS-C: nová funkce http_close
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 10.1.2021 ==
* 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)

== 5.1.2021 ==
* SDS-C: oprava textcmp()
* bezpečnostní oprava
* dřívější odeslání NTP požadavku po výpadku síťového spojení

== 20.11.2020 ==
* changelog založen

SDS MACRO: LM: firmware changelog

2025-11-15T14:24:59Z

Adamn:

== SDS-MACRO LM ==

__NOTOC__

Tato stránka se věnuje změnám ve firmware a v HW pro výrobek SDS-MACRO LM.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

== 15.11.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* SDS-C: přidány indexy 303 a 304 a 305
* SDS-C: přidán index 2198

== 1.7.2022 ==
* 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
* obsluha času: možnost zápisu do sys[4], sys[39]
* doplněny další možné vstupní typy do funkcí itoa/itoh
* možnost zakázat NTP

== 26.3.2021 ==
* 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>
* zaveden inovovaný algoritmus detekce S0 impulsů (stejný jako pro řadu ST), tedy s možností bohaté uživatelské konfigurace detektoru
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)

== 9.2.2021 ==
* SDS-C: dns resolv drobný fix
* SDS-C: http_get a http_post drobný fix
* SDS-C: nová funkce http_close
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT

== 5.1.2021 ==
* SDS-C: oprava textcmp()
* bezpečnostní oprava
* dřívější odeslání NTP požadavku po výpadku síťového spojení

== 23.10.2020 ==
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST

== 4.8.2020 ==
* SNMP fix - správná hodnota ve .5.13 až .5.16
* drobné opravy a optimalizace

== 18.7.2020 ==
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)

== 26.6.2020 ==
* různé drobky/opravy dle hlášení uživatelů a testů

== 15.5.2020 ==
* SDS-C 09: přidáno http_post()

== 14.5.2020 ==
* oprava pro některé sys[] pro S0 vstupy (které se automaticky neaktualizovaly)

== 11.5.2020 ==
* oprava Content-Length pro CSS soubor (problém s Chrome)
* oprava chování při odpojeném SDS-1W-T-RH

== 20.4.2020 ==
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)
* implementován SDS Audit Log
* zvýšená ochrana proti brute-force hledání vstupního hesla

== 14.11.2019 ==
* 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)
* relé lze z webového rozhraní aktivovat i v režimu OneShot
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas)

== 5.3.2019 ==
* 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)

== 12.1.2019 ==
* 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)

== 4.1.2019 ==
* překlopena beta do oficiálního vydání
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)
* watchdog sds-c programu

== 1.7.2018 ==
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS
* 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

== 27.3.2018 ==
* oprava funkce zápisu prázdného řetězce do názvu 1-Wire teploměru ("smazání názvu" uživatelem)
* 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)
* oprava někdy vynechaného načtení konfigurace (okrajové případy, ale přece)

== 12.3.2018 ==
* 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í)

== 8.3.2018 ==
* oprava používání zámku (lock) v administraci 1-Wire sběrnice BUS-B
* oprava echo.htm - zobrazuje se
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 18.12.2017 ==
* 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
* SDS-C: přidán sys[4], sys[11], sys[38], sys[39]
* SDS-C: sys[4] = local-time
* SDS-C: sys[11] = vždy "správné" číslo dne v týdnu
* SDS-C: sys[38] = utc-time
* SDS-C: sys[39] = stav automatiky přepínání CEST/CET času
* 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)
* zámek 1-W pozice se ukládá do pevné paměti (při stisku tlačítka na webovém rozhraní)
* vylepšení v oblasti VCP (telnet pro sériovou linku) - spolehlivější
* 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)
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)

== 10.8.2017 ==
* SDS-C: zvýšena verze na hodnotu 07
* SDS-C: přidány nové sys[] položky (indexy 1792 až 2047)
* SDS-C: optimalizovaná cache pro velké programy
* SDS-C: maximální počet proměnných zvýšen na 144
* SDS-C: maximální počet procesů (procedur) zvýšen na 96
* SDS-C: hloubka zásobníku (stacku) zvýšena na 24
* vydán nový odpovídající SDSC.exe

== 3.8.2017 ==
* oprava chyby kdy se po každém spuštění systému mohla ztratit část S0 konfigurace (nastavení tarifního vstupu)

== 18.4.2017 ==
* (nová funkčnost) použití UserWEB Projektu
* oprava v echo() pro zápis do sériové linky (uart)
* drobné ale důležité fixy v html stránkách (texty, vzhled)
* nové NTP dotazy lze aktivovat i z SDS-C programu (viz aktualizovaný seznam sys)

== 24.11.2016 ==
* 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)
* SDS-C: přidán přímý přístup do LCD Frame Bufferu přes sys[1024] až sys[1551]

== 28.3.2016 ==
* impulse counter lze z webu zadat do plných 32 bitů, původně jen 31 bitů
* další drobné opravy
* oprava zpracování nastavení baudrate při komunikaci RFC2217

== 23.2.2016 ==
* oprava nefunkčního zápisu pomocí SNMP (několik předchozích verzí, teď opraveno)

== 5.2.2016 ==
* 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)
* 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)

== 15.11.2015 ==
* důležité opravy

== 3.7.2015 ==
* vylepšený DHCP client
* řada oprav podle průběžného testování

== 2.4.2015 ==
* srovnáno s SDS-MICRO 2.4.2015 (opravy chyb a nové funkce)

== 9.9.2014 ==
* opravena chyba pro sys[64]==1 (vnitřním zaokrouhlením to skočilo na nulu)

== 17.8.2014 ==
* srovnáno se stejnou verzí firmware SDS-MICRO

== 8.7.2014 ==
* opravy v oblasti obsluhy sériového rozhraní (RS485)
* do webové administrace přidána možnost vzájemného přehození pozic dvou 1-Wire záznamů
* další drobné opravy z průběžných beta testů

== 1.3.2014 ==
* SDS-C: nová funkce serial_write()
* 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
* 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)
* SDS-C: opravena funkce snmp_send_trap() - horní část seznamu trapů byla předtím chybně neodeslatená (teď už je vše OK)
* vylepšení odolnosti při výpadku a při obnovení připojení k Ethernetu
* různé drobné důležité opravy (viz beta testy)

== 25.1.2014 ==
* opravy a nové funkce, srovnáno s firmware SDS MICRO

== 30.11.2013 ==
* opravy a nové funkce, srovnáno s firmware SDS MICRO

== 3.10.2013 ==
* celá řada drobných oprav
* login html stránka upravena (w3c valid)
* možnost nastavit MTD pro S0 měření
* nový SDSC.exe program
* SDS-C: přidána funkce lcd_setpixel()

== 24.3.2013 ==
* opravena chyba kdy nebylo možné ručně zadat více než hodnotu 32767 do impulsního počítadla z webového rozhraní

== 16.3.2013 ==
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:
* zápis výpadku a znovu-připojení Ethernetu do logu historie
* 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.)
* 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)
* get_sys[xxx] vrací i text pro textové položky (vyzkoušejte všechny sys[] které jsou textové)
* SDS-C: přidáno sys[900] až sys[931] (text ROM CODE pro 1-W čidla)
* upraveno zpracování ARP tabulky (více bezpečné pro dlouhodobý provoz)
* možnost řízení tarifního signálu pro S0 prostřednictvím SDS-C programu
* funkce "odečet" pro S0 (viz nastavení S0 vstupů ve webové administraci)
* SDS-C: funkce smtp_send() akceptuje text[] nejen pro obsah zprávy, ale i pro adresu příjemce a subject
* SDS-C: funkce http_get() akceptuje text[] nejen pro obsah zprávy, ale i pro nastavení HTTP HOST parametru

== 29.5.2012 ==
* 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

== 7.5.2012 ==
* opravena funkčnost PWM výstupu - lze správné nastavit střídu v rozmezí 0 až 100% viz návod na WiKi

== 18.3.2012 ==
* finální podoba SNMP MIB (stáhněte si aktualizovaný MIB soubor)

== 12.3.2012 ==
* řada důležitých oprav, aktualizujte !
* všechny nové funkce dostupné v SDS MICRO jsou dostupné i pro SDS MACRO (srovnání firmware)

== 22.1.2012 ==
* všechny nové funkce z BETA testu přidány do dostupného firmware (pozn. podpora pro čtyři S0 vstupy)

== 27.10.2011 ==
* 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)
* web: funkce /get_sys a /get_ram může vrátit řadu proměnných za sebou

== 2.10.2011 ==
* přidán sys[26]
* přidán sys[63]
* přidán sys[78]
* doplněn UDP protokol o čtyři nové funkce (čtení / zápis polí sys[] a ram[])

== 6.9.2011 ==
* pouze úpravy pro RS485 výstup - přepracovaný kód pro výstup dat (serial_text_out nepřevádí konstanty na text)

== 31.7.2011 ==
* opraven problém s UDP protokolem - příkaz '''write''' (už funguje vždy ok)
* nový SDSC.exe program - doplňuje správnou HTML serverovou hlavičku pro uživatelskou stránku

== 29.7.2011 ==
* možnost zápis z SDS-C programu do systémových proměnných sys[559] až sys[561]
* nová funkce pro UDP protokol - funkce '''write''' umožňuje hromadný zápis do sys[] systémových proměnných

== 25.7.2011 ==
* IP watchdog už umí ovládat i zbylé dvě relé (původně jen RE1 a RE2, teď RE1 až RE4)

== 24.7.2011 ==
* 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

== 10.7.2011 ==
* 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...)
* přidán IP Watchdog do hlavní nabídky ve webovém rozhraní

* doplněny funkce, které jsou v SDS MICRO (viz changelog MICRO ze dne 16.6.2011)
** řada doplňků v SDS-C, webovém rozhraní, atd.

== 21.5.2011 ==
* od této verze jsou k dispozici dvě jazykové varianty - plně Česká varianta a plně Anglická varianta
* varianty se liší pouze texty ve webovém rozhraní, jejich funkčnost je ale zcela shodná (bez rozdílů)

== 14.5.2011 ==
* vydána pouze nová EXE aplikace pro nahrávání SDS-C
* od této verze umožňuje použít složité kostrukce s IF, např.: if (test) { kus programu; } else { kus programu; };

== 1.5.2011 ==
* stránka /usys.xml

== 17.3.2011 ==
* možnost nahrát si vlastní webovou stránku (pomocí stejného EXE jakým se nahrává SDS-C)
* možnost změnit port HTTP klienta (funkce http_get)

== 6.3.2011 ==
* přechod na novou verzi SDS-C (verze 03)

== 17.2.2011 ==
* SDS-C doplněno o funkce: lcd_echo, lcd_clear, lcd_newline (použijte nový EXE pro SDS-C)

== 6.2.2011 ==
* přemístěn výpis teplot z teplotních čidel na konec status stránky
* dalši úvodní drobnosti...

== 11.1.2011 ==
* založena tato stránka

== starší verze ==
* changelog pro verze starší než 2011 není k dispozici

SDS MICRO: LM: firmware changelog

2025-11-15T14:24:49Z

Adamn:

== SDS-MICRO LM / SDS-IO6 LM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 15.11.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* SDS-C: přidány indexy 303 a 304 a 305
* SDS-C: přidán index 2198

== 1.7.2022 ==
* 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
* obsluha času: možnost zápisu do sys[4], sys[39]
* IO6: doplněny další možné vstupní typy do funkcí itoa/itoh (MICRO už to mělo)
* IO6: možnost zakázat NTP (MICRO už to mělo)

== 28.6.2021 ==
* IO6: web: oprava oneshotreset
* 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ě)

== 26.3.2021 ==
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)

== 9.2.2021 ==
* SDS-C: dns resolv drobný fix
* SDS-C: http_get a http_post drobný fix
* SDS-C: nová funkce http_close
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT

== 5.1.2021 ==
* SDS-C: oprava textcmp()
* bezpečnostní oprava
* dřívější odeslání NTP požadavku po výpadku síťového spojení

== 23.10.2020 ==
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST

== 4.8.2020 ==
* SNMP fix - správná hodnota ve .5.13 až .5.16
* drobné opravy a optimalizace

== 18.7.2020 ==
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)

== 27.6.2020 (jen MICRO) ==
* oprava nestartování předchozí verze FW na některých specifických typech HW varianty SDS-MICRO-x

== 26.6.2020 ==
* SDS-C 09: http_post()
* MQTT klient
* různé drobky/opravy dle hlášení uživatelů a testů

== 11.5.2020 ==
* oprava Content-Length pro CSS soubor (problém s Chrome)
* oprava chování při odpojeném SDS-1W-T-RH

== 20.4.2020 ==
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)

== 15.4.2020 ==
* implementován SDS Audit Log
* zvýšená ochrana proti brute-force hledání vstupního hesla

== 14.11.2019 ==
* drobný bugfix pro S0 (způsob zobrazování aktuálního výkonu)
* relé lze z webového rozhraní aktivovat i v režimu OneShot
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas)

== 17.1.2019 ==
* bugfix SDS-C watchdogu

== 12.1.2019 ==
* 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)

== 4.1.2019 ==
* překlopena beta do oficiálního vydání
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)
* watchdog sds-c programu

== 1.7.2018 ==
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS

== 30.3.2018 ==
* oprava funkce zápisu prázdného řetězce do názvu 1-Wire teploměru ("smazání názvu" uživatelem)
* 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
* 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)
* 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).

== 12.3.2018 ==
* 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í)

== 8.3.2018 ==
* oprava echo.htm - zobrazuje se
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 18.12.2017 ==
* 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
* 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)
* zámek 1-W pozice se ukládá do pevné paměti (při stisku tlačítka na webovém rozhraní)
* vylepšení v oblasti VCP (telnet pro sériovou linku) - spolehlivější
* 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)
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)

== 23.10.2017 ==
* hlavní nová funkce: přidána volitelná funkce (checkbox ve webovém rozhraní) pro plně automatickou volbu Letního Času (SELČ - aplikovatelné napříč Evropou)
* 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).
* přidány SNMP položky (OID) pro text "ADC jednotka" (pro každý AD vstup).
* 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.).
* SDS-C: přidán sys[4], sys[11], sys[38], sys[39]
* SDS-C: sys[4] = local-time
* SDS-C: sys[11] = vždy "správné" číslo dne v týdnu
* SDS-C: sys[38] = utc-time
* SDS-C: sys[39] = stav automatiky přepínání CEST/CET času

== 10.8.2017 ==
* SDS-C: zvýšena verze na hodnotu 07 (funguje i pro výrobky s EEPROM tak pro výrobky s NVM-DF)
* SDS-C: přidány nové sys[] položky (indexy 1792 až 2047)
* SDS-C: optimalizovaná cache pro velké programy
* SDS-C: maximální počet proměnných zvýšen na 144
* SDS-C: maximální počet procesů (procedur) zvýšen na 96
* SDS-C: hloubka zásobníku (stacku) zvýšena na 24
* vydán nový odpovídající SDSC.exe

== 3.8.2017 ==
* oprava chyby kdy se po každém spuštění systému mohla ztratit část S0 konfigurace (nastavení tarifního vstupu)

== 18.4.2017 ==
* (nová funkčnost) použití UserWEB Projektu
* oprava v echo() pro zápis do sériové linky (uart)
* drobné ale důležité fixy v html stránkách (texty, vzhled)
* nové NTP dotazy lze aktivovat i z SDS-C programu (viz aktualizovaný seznam sys)

== 24.11.2016 ==
* 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)

== 28.3.2016 ==
* impulse counter lze z webu zadat do plných 32 bitů, původně jen 31 bitů
* další drobné opravy

== 26.3.2016 ==
* oprava chybného zpracování RFC2217 příkazu pro změnu BaudRate (zpracoval se jen poslední byte místo celého dwordu, teď opraveno)

== 23.2.2016 ==
* oprava nefunkčního zápisu pomocí SNMP (několik předchozích verzí, teď opraveno)

== 5.2.2016 ==
* 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)
* 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)

== 15.11.2015 ==
* důležité opravy

== 3.7.2015 ==
* vylepšený DHCP client
* řada oprav podle průběžného testování

== 2.4.2015 ==
* veškeré opravy od posledního vydání (viz průběh BETA testů)
* významně zvýšena spolehlivost a stabilita při síťové zátěži (Eth. komunikace)
* SDS-C: přidáno sys[193]
* SDS-C: přidáno sys[37]
* SDS-C: přidáno sys[139]
* SDS-C: možnost zápisu do sys[4]
* SNMP TRAP předává plný OID (dosud dával jen OID useknutný za E.ID)

== 9.9.2014 ==
* opravena chyba pro sys[64]==1 (vnitřním zaokrouhlením to skočilo na nulu)

== 17.8.2014 ==
* přidána možnost použít get_var[index] pro čtení vnitřních proměnných v SDS-C přes web
* SNMP: umožňuje zápis do všech položek přes "Counter32" (nová záležitost) a původní "Integer" typ
* SNMP: přidána možnost zápisu do položek S0-impulse-counter (T0 a T1)
* RS485: při vysílání je budič aktivní max 1msec (nebo méně) od posledního znaku

== 8.7.2014 ==
* opravy v oblasti obsluhy sériového rozhraní (RS485)
* do webové administrace přidána možnost vzájemného přehození pozic dvou 1-Wire záznamů
* další drobné opravy z průběžných beta testů

== 8.3.2014 ==
* 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[])

== 1.3.2014 ==
* SDS-C: nová funkce serial_write()
* 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
* SDS-C: opravena funkce snmp_send_trap() - horní část seznamu trapů byla předtím chybně neodeslatená (teď už je vše OK)
* vylepšení odolnosti při výpadku a při obnovení připojení k Ethernetu
* různé drobné důležité opravy (viz beta testy)

== 23.1.2014 ==
* překlopená beta-verze (po ukončené ověřovací sérii testů)
* SDS-C: úpravy (spolehlivost) v http_get(), dns_resolve()
* rozšířena 1-W funkcionality (další chipy)
* možnost "zrušit odečet" tlačítkem ve webovém rozhraní
* možnost nastavit minimální akceptovanou délku S0 impulsu pro každý vstup samostatně
* maximální velikost user.htm je zvětšena (teď lze vyplnit celou DF)

== 30.11.2013 ==
* celá řada drobných oprav (nalezené v rámci testování od poslední verze)
* S0.htm: všechny hodnoty zobrazují údaje od posledního odpočtu (chybělo pro T0/T1 kWh)
* web: /get_dfi[x]
* SDS-C: čtení a zápis celé stránky z/do paměti DataFlash

== 3.10.2013 ==
* celá řada drobných oprav
* login html stránka upravena (w3c valid)
* možnost nastavit MTD pro S0 měření
* nový SDSC.exe program

== 16.3.2013 ==
* zápis výpadku a znovu-připojení Ethernetu do logu historie
* 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.)
* 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)
* get_sys[xxx] vrací i text pro textové položky (vyzkoušejte všechny sys[] které jsou textové)
* SDS-C: přidáno sys[900] až sys[931] (text ROM CODE pro 1-W čidla)
* upraveno zpracování ARP tabulky (více bezpečné pro dlouhodobý provoz)
* možnost řízení tarifního signálu pro S0 prostřednictvím SDS-C programu
* funkce "odečet" pro S0 (viz nastavení S0 vstupů ve webové administraci)
* SDS-C: funkce smtp_send() akceptuje text[] nejen pro obsah zprávy, ale i pro adresu příjemce a subject
* SDS-C: funkce http_get() akceptuje text[] nejen pro obsah zprávy, ale i pro nastavení HTTP HOST parametru

== 4.2.2013 ==
* při zobrazení echo.htm, když je konzole plná textu, nedojde k resetu zařízení
* 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ě
* SDS-C: přidáno sys[45]
* SDS-C: přidáno sys[46]
* SDS-C: přidáno sys[98]
* SDS-C: echoinline() funguje správně

== 20.12.2012 ==
Významné vydání, oprava řady drobných chyb průběžně hlášených od uživatelů, celá řada nových funkcí
* DHCP CLIENT
* SNMP write
* rychlejší boot loader
* rychlejší webová administrace
* přesnější udržování aktuálního času v zařízení (dvojnásobná kontrola přesnosti a korekce)
* přepracované úložiště v pevné paměti - SDS s eeprom ukládá všech 16 názvů pro teploměry
* možnost změny portu "UDP protokolu" (výchozí port 280)
* SDS-C: konzole zvětšena o zhruba 400 znaků
* 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
* pro každý S0 vstup lze nastavit rozdílnou cenu pro T0 a T1 (stav tarifu)
* SDS-C: funkce send_udp()
* SDS-C: přidáno sys[61]
* SDS-C: přidáno sys[27]
* SDS-C: funkce echoinline()
* správné zpracování LOGIC S0 u zařízení SDS MICRO, které tento vstup nemají
* upraven CSV soubor (vypisuje detaily pro S0)
* upraven xml.xml a s0.xml (vše funguje jak má i při plném osazení, typicky pro SDS MACRO 8)
* SDS-C: sprintf dává 0x00 na konec textu (tohle chybělo)
* SDS-C: http_get() zapisuje 0x00 na "konec" text[], když se do text[] ukládá přijatá odpověď.
* SDS-C: oprava která má zajistit nevyvolání chyby 1029 pro http_get() funkci
* rozšířený MIB (položky pro S0 hodnoty)
* SDS-C: SNMP TRAP (odesílání TRAPů z SDS-C programu)
* a řada drobných obrav a vylepšení

== 7.5.2012 ==
* opravena funkčnost PWM výstupu - lze správné nastavit střídu v rozmezí 0 až 100% viz návod na WiKi

== 29.3.2012 ==
* firmware funguje správně i v historických zařízeních SDS MICRO LIGHT (1) používajících 24C16/24C256

== 27.3.2012 ==
* spolehlivé načítání prvních osmi uložených pozic teploměrů z pevné paměti po resetu
* automaticky umístí nadbývající připojené teploměr na pozice 9 až 16
* zamykání pozic teploměrů funguje správně
* předělaná SDS-C funkce smtp_send() - má větší pracovní buffer, zvládne náročnější SMTP servery

== 18.3.2012 ==
* finální podoba SNMP MIB (stáhněte si aktualizovaný MIB soubor)

== 11.3.2012 ==
* malá změna v SNMP MIB (srovnání MIBů mezi MICRO/MACRO)
* další drobné opravy nahlášené po testování firmware z 8.3.

== 8.3.2012 ==
* odstraněno zpoždění v převodníku Ethernet-Serial (Virtual COM port)

== 4.3.2012 ==
Řada oprav a vylepšení, pocházející z BETA testování (viz forum)
* správný výpočet data od 29.2.2012
* možnost uzamknout pozice 1-Wire zařízení (teploměry)
* rozšířené SNMP
* SDS-C verze č. 06
* pole text[] a funkce atoi(), sprintf()
* uživatelská stránka může být i jako přímo indexová stránka webového rozhraní
* všechny fyzické vstupy a výstupy jsou počítány od jedničky
* další drobné úpravy a opravy, viz soupis u BETA testů

== 17.1.2012 ==
* oprava indexů v "temp" tagech v xml.xml a temp.xml

== 16.1.2012 ==
* 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)

== 15.1.2011 ==
* opravena chyba s user-dataflash (oprava má význam pouze pro výrobky osazené DF, nikoliv EE, tam chyba nebyla)

== 21.12.2011 ==
* zapracovány všechny nové funkce, testované v rámci BETA testování nového firmware (probíhalo od 27.10.)

== 27.10.2011 ==
* 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)
* web: funkce /get_sys a /get_ram může vrátit řadu proměnných za sebou

== 2.10.2011 ==
* přidán sys[26]
* přidán sys[63]
* přidán sys[78]
* doplněn UDP protokol o čtyři nové funkce (čtení / zápis polí sys[] a ram[])

== 31.7.2011 ==
* opraven problém s UDP protokolem - příkaz '''write''' (už funguje vždy ok)
* nový SDSC.exe program - doplňuje správnou HTML serverovou hlavičku pro uživatelskou stránku

== 29.7.2011 ==
* možnost zápis z SDS-C programu do systémových proměnných sys[559] až sys[561]
* nová funkce pro UDP protokol - funkce '''write''' umožňuje hromadný zápis do sys[] systémových proměnných

== 25.6.2011 ==
* 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...)

== 16.6.2011 ==
* verze SDS-C č. 04
* SDS-C: plně funkční funkce ping()
* rozšíření maximální velikosti SDS-C programu ve všech verzích SDS MICRO (light, light2, DIN)
** DATAFLASH maximální velikost programu je 65472 bajtů
** 24C16 maximální velikost programu je 900 bajtů
** 24C256 maximální velikost programu je 31416 bajtů

* web: nastavení uživatelské proměnné pomocí volání sdscep pracuje s doplňkovými parametry (např. vrací hodnotu)
* upravena obsluha eeprom paměti (jiný I2C driver) - tzn. větší spolehlivost a větší rychlost
* sys[25] po každém zavolání čte hodnotu z PHY HW a vrací skutečný stav v daný okamžik
* čtení ze sériové linky je teď dostupné pro program v SDS-C (viz sys[48] a sys[49])
* změna řízení PWM výstupu, lze teď plynule regulovat poměr log0 a log1 v celém rozsahu
* všechny stránky předělány na UTF-8, vstupy textů berou i České znaky atd.
* výpis MAC adresy pro SDS-C program (viz sys[31] až sys[36])
* SDS-C: http_get může uložit získaná data webové stranky do pole ram[]
* 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
* web: informační stránka /arp.htm
* SDS-C: zvětšena velikost pole ram[] na 512 záznamů
* web: výpis hodnot sys[] a ram[] pomocí dynamicky generované webové stránky (např. /get_ram[123] )
* web: čtení výpisu sys[] a ram[] lze zakázat v nastavení (SDS-C parametr)
* SDS-C: možnost zápisu do S0 impulsních počítadel (nulování, úpravy hodnot, atd.)
* 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í

== 21.5.2011 ==
* opravy v českém a anglickém překladu webového rozhraní

== 14.5.2011 ==
* vydána pouze nová EXE aplikace pro nahrávání SDS-C
* od této verze umožňuje použít složité kostrukce s IF, např.: if (test) { kus programu; } else { kus programu; };

== 13.5.2011 ==
* od této verze jsou k dispozici dvě jazykové varianty - plně Česká varianta a plně Anglická varianta
* varianty se liší pouze texty ve webovém rozhraní, jejich funkčnost je ale zcela shodná (bez rozdílů)

== 20.3.2011 ==
* funkční nahrávání uživatelské webové stránky

== 3.3.2011 ==
* pouze nový simulační WinEXE program pro SDS-C
** funkční simulátor LCD (SDS MACRO)
** vylepšení v hlášení chyb při kontrole programu SDS-C

== 27.2.2011 ==
* změněn výpis UpTime v Actual Status webové stránce na dny/hod/min/sec/msec
* doplněna generovaná webová stránka: echo.htm (obsahuje pouze výpis konzole SDS-C, vhodné pro embedding do jiného webu)
* nový XML soubor - usys.xml - výpis vzdálených proměnných SDS-C
* možnost volby nezasílání http dat pro volání sdscep (umožnujě tzv. tichou aktualizaci hodnoty sys)
* do SNMP doplněna hodnota teploty SoC (vyčtená z HW, bez převodu na °C)
* příprava pro nahrání uživatelské webové stránky (plná podpora bude v následující verzi fw)
* nová verze SDS-C, nové možnosti, nový simulátor
** SDS-C: možnost použít #define v programu
** SDS-C: možnost použít uživatelské proměnné jako indexy do pole (sys, ram)
** SDS-C: k dispozici je univerzální pole ram[]
** SDS-C: nová WinEXE aplikace, řada drobností...

== 30.1.2011 ==
* úpravy specifické pro verzi LIGHT s EEPROM (restart zařízení)

== 29.1.2011 ==
* v SNMP doplněn výpis celé hodnoty (x100) pro 1-W teploměry 2 až 16

== 28.1.2011 ==
* dvě nové funkce v SDS-C, pro zápis do sériového portu
* zpřesněný interní čítač reálného času

== 26.1.2011 ==
* 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ů).
* doplňky v simulátoru SDS-C, zejména ohledně času, korekce optovstupů, atd.

== 9.1.2011 ==
* 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)
* 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)

== 7.12.2010 ==
* 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ů

== 1.12.2010 ==
* firmware podporuje i jiné osazené dataflash (menší velikosti) paměti

== 29.11.2010 ==
* 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í
* úpravy odkazů na www.merenienergie.cz, portal.merenienergie.cz

== 20.10.2010 ==
* upraven UDP protokol - doplněno ROMCODE pro teplotní čidla
* upraveno zadávání uživatelských sys[] proměnných z webu (už lze zadávat i záporné čísla)
* opravena ztráta nastavení GMT offset po resetu zařízení

== 8.10.2010 ==
* opraven SNMP který měl od verze 10.9. problémy
* tento a novější firmware je vhodný pro spolupráci se službou portal.merenienergie.cz

== 6.10.2010 ==
* oprava výpisu přepočtené spotřeby (kW) - doplněno vždy na tři desetinná místa
* funkční nulování převodu peněz
* SMTP konfigurace se správně načte po zapnutí zařízení

== 26.9.2010 ==
* SDS-C: stránka "control", uživatelsky editovatelné proměnné
* SDS-C: do sys[] doplněna informace pro S0 (čas od posledního impulsu)
* drobné doplňky do XML, příprava pro SDSMON.exe
* UDP protokol, popis viz wiki

== 17.9.2010 ==
* 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ů)
* výstup /temp.txt je doplněn na dvojici: romcode : teplota
* výstup /temp.xml je doplněn o tagy s romcode

== 15.9.2010 ==
* doplněn výstup teplot ze všech čidel, do textové formy, /temp.txt
* odečet teplotních web-snippet tempX.htm akceptuje hex znaky (tj. 0-9, a-f)

== 14.9.2010 ==
* opraven výpis teploty v csv.csv
* nový xml soubor: temp.xml - pouze s údaji o teplotě

== 10.9.2010 ==
* opraveno zobrazení kWh na webových stránkách (špatný číselný text u vyšších hodnot kWh)

== 8.9.2010 ==
* ve firmware byl zvýšen maximální počet obsluhovaných teplotních sensorů z 8 na 16

== 14.8.2010 ==
* opraveno SDS-C - správnost předávání konstantních číselných parametrů funkcím
* doplněna nová funkce do SDS-C - funkce http_get
* nový Win32 program pro práci s SDS-C (doplněna funkčnost vzdálených labelů)
* zobrazení názvů tarifů na celkové stránce pro S0 (předtím bylo jen na detailních stránkách)

== 9.8.2010 ==
* firmware funguje i pro HW rev2,3 (SDS MICRO light), předchozí verze 3.8. nenašla externí flash paměť

== 3.8.2010 ==
* opravena chyba kdy nedošlo k přečtení konfigurace pro S0 vstupy z pevné paměti, už je to ok
* upraven výpočet okamžitého výkonu, aby při nepřipojeném měřiči ukazoval nulu

== 2.8.2010 ==
* zcela přepracováno webové rozhraní pro měřiče energie
* rozšířené snmp/xml/csv pro měřiče energie
* možnost připojít více samostatnyćh měřičů energie najednou
* vstup pro tarifní rozlišení (denní/noční proud, výroba/dodávka, atd.)
* vylepšený Windows® program pro nahrávání firmware

== 26.7.2010 ==

* nový firmware pro převodník Ethernet/Serial
* samostatná stránka ve webovém rozhraní pro zobrazení stavu převodníku Ethernet/Serial

== 23.7.2010 ==

* ú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
* drobná oprava v SMTP klientu
* byl vydán nový Windows® program pro nahrávání programů v SDS-C

== 18.7.2010 ==

* maximální počet znaků v přihlašovacích údajích pro SMTP je rozšířen na 32 znaků
* drobné opravy ve webovém rozhraní

== 15.7.2010 ==

* 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)

== 10.7.2010 ==

* opravy drobností tak jak byly nahlášeny od uživatelů
* tři desetinné místa na ose grafu spotřeby energie
* oprava hodnoty dne u data v grafu spotřeby energie
* doplňky v http serveru, úprava hlavičky pro CSV
* přihlašovací stránka se už zobrazí všude a vždy (předtím někdy neprošlo např. nod32)
* příprava pro centrální sběrný program SDSMON.exe

== 2.6.2010 ==

* oficiální verze SDS-C k dispozici
* celá řada nových funkcí, především pro SDS-C
* SMTP - odesílání emailů (z programu SDS-C)
* výstup dat i ve formě CSV souboru (středníkový oddělovač pro Excel®)

== 17.5.2010 ==

* opraven výpis LOGu pro IP adresy
* záznam nepovedených přístupů (když to někdo zkouší se špatným heslem)
* drobnosti v http serveru
* graf S0 má místo +1kWh jen +0.1kWh
* oprava detekce EEPROM (aktualizujte FW !)

== 15.5.2010 ==

* změna výchozího NTP serveru (default config)
* kratší odpočet při změně NTP serveru
* stránka S0 i z hlavního menu

== 12.5.2010 ==

* drobné úpravy
* informace o datové paměti (bude důležité pro SDS-C)
* volba NTP serveru

== 4.5.2010 ==

* řada doplňků pro S0 vstup (přepočty, kreslení grafu, xml)

== 23.4.2010 ==

* počítáni S0 impulsů (opto 3), speciální webové zobrazení a přepočty
* doplňky v SNMP, doplněný MIB
* nepřipojené teploměry hlásí teplotu 32767
* příprava stránky pro řízení relé pomocí teploměrů

== 25.1.2010 ==

* možnost pojmenovat si všechny analogové vstupy
* doplněno: název analogového vstupu lze přečíst přes SNMP
* doplněno: název relátka lze přečíst přes SNMP

== 15.1.2010 ==

* opraveno chybějící tlačítko u přihlašovací stránky (šlo pouze stiskem klávesy Enter)
* doplněno chybějící čtvrté nastavovací tlačítko u ADC konstant

== 11.1.2010 ==

* opraveno (doplňeno) chybějící záporné znaménko u výpisu teploty (web, SNMP)

== 31.10.2009 ==

* navýšení maximálního počtu současně přihlášených uživatelů do webového rozhraní

== 30.10.2009 ==

* zvýšení max počtu 1-Wire® teploměrů na 8 kusů na jedné sběrnici
* doplněn výstup SNMP o údaje desetinných hodnot pro všechny teploměry
* 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
* zobrazení sysLocation také v přehledové stránce (actual status)
* možnost pojmenovat si všechny teploměry (16 znaků pro každý)
* možnost pojmenovat si ovládané relé (16 znaků pro každé)

== 29.10.2009 ==

* drobnosti před vydáním 30.10.2009

== 10.10.2009 ==

* NTP klient - synchronizace času a data protokolem NTP
* nastavení NTP serveru a GMT prostřednictvím "Admin config" webové stránky
* zobrazení NTP času a data v "actual status" webové stránce
* zobrazení času a data v "Log" webové stránce u všech položek

== 20.09.2009 ==

* webová stránka "aktuální stav" - upraveno pro správné zobrazování v IE
* v nadpisu webové stránky (tag title) se zobrazuje název zařízení a navíc celý obsah textu ''sysLocation''

== 07.09.2009 ==

* 1-Wire® měří na 1/16 stupně Celsia, upraveno časování (větší spolehlivost), lze připojit více čidel
* možnost změny MAC adresy (přímo z webového rozhraní)
* zobrazení informační (potvrzovací) stránky před změnou IP, MAC

== výchozí firmware ==

* výchozí firmware

SDS MICRO: ST: firmware changelog

2025-11-15T14:24:43Z

Adamn:

== SDS-MICRO ST / SDS-MICRO ST DP / SDS-IO6 ST ==

__NOTOC__

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'''.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 15.11.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* SDS-C: přidány indexy 303 a 304 a 305
* SDS-C: přidán index 2198

== 2.11.2023 ==
* oprava SNMP (způsob předávání chybových hodnot)

== 6.2.2023 ==
* pouze SDS MICRO ST DP : nový výchozí firmware

== 29.11.2022 ==
* SDS-C: přidán index 137
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve
* 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

== 26.11.2022 ==
* 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)
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)

== 4.8.2022 ==
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti
* 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í)
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce
* malá bezpečnostní aktualizace

== 1.7.2022 ==
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)
* 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
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných
* další drobné úpravy a opravy

== 27.12.2021 ==
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí

== 14.4.2021 ==
* oprava hodnot v sys 39 (0 vyp, 3 zap)

== 13.4.2021 ==
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP

== 11.4.2021 ==
* 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.).

== 26.3.2021 ==
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)

== 12.3.2021 ==
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno

== 9.2.2021 ==
* SDS-C: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* SDS-C: drobná úspora heap (více dostupného místa)
* SDS-C: dns resolv drobný fix
* SDS-C: http_get a http_post důležitý fix
* SDS-C: nová funkce http_close
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 10.1.2021 ==
* 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)

== 5.1.2021 ==
* SDS-C: oprava textcmp()
* bezpečnostní oprava
* dřívější odeslání NTP požadavku po výpadku síťového spojení

== 23.10.2020 ==
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST
* web: oprava tempX.htm
* oprava ovládání PDx (při změně z webu se nesáhne na ostatní bity nastavené např. ze SDS-C)

== 20.9.2020 ==
* zvýšení odolnosti na výpadky komunkace (crc chyby) na OneWire sběrnici

== 4.8.2020 ==
* drobné opravy a optimalizace
* IO6-ST: oprava detekce eth

== 18.7.2020 ==
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)

== 27.6.2020 (jen MICRO-ST) ==
* oprava možného okrajového problému s nečitelnými AD vstupy

== 26.6.2020 ==
* různé drobky/opravy dle hlášení uživatelů a testů
* plně otestovaný MODBUS klient a MQTT klient
* audit log

== 20.6.2020 ==
* SDS-C verze 09: přidáno http_post()
* MODBUS-TCP klient
* doladění MQTT klienta

== 14.6.2020 ==
* SDS-C verze 09
* MQTT klient
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)
* různé opravy (podle ostatních SDS)

== 15.11.2019 ==
* oprava přehozených AD3 a AD4

== 14.11.2019 ==
* první vydání FW pro SDS MICRO ST

SDS MINI: ST: firmware changelog

2025-11-15T14:24:34Z

Adamn:

== SDS-MINI ST a SDS-TTCPRO ST ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 15.11.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* SDS-C: přidány indexy 303 a 304 a 305
* SDS-C: přidán index 2198

== 2.11.2023 ==
* oprava SNMP (způsob předávání chybových hodnot)

== 29.11.2022 ==
* SDS-C: přidán index 137
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve
* 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

== 26.11.2022 ==
* 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)
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)

== 4.8.2022 ==
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti
* 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í)
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce
* malá bezpečnostní aktualizace

== 1.7.2022 ==
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)
* 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
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných
* další drobné úpravy a opravy

== 27.12.2021 ==
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí

== 14.4.2021 ==
* oprava hodnot v sys 39 (0 vyp, 3 zap)

== 13.4.2021 ==
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP

== 11.4.2021 ==
* 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.).

== 26.3.2021 ==
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)

== 12.3.2021 ==
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno

== 9.2.2021 ==
* SDS-C: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* SDS-C: drobná úspora heap (více dostupného místa)
* SDS-C: dns resolv drobný fix
* SDS-C: http_get a http_post důležitý fix
* SDS-C: nová funkce http_close
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 10.1.2021 ==
* 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)

== 5.1.2021 ==
* SDS-C: oprava textcmp()
* bezpečnostní oprava
* dřívější odeslání NTP požadavku po výpadku síťového spojení

== 23.10.2020 ==
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST
* web: oprava tempX.htm
* oprava ovládání PDx (při změně z webu se nesáhne na ostatní bity nastavené např. ze SDS-C)

== 20.9.2020 ==
* zvýšení odolnosti na výpadky komunikace (crc chyby) na OneWire sběrnici

== 4.8.2020 ==
* drobné opravy a optimalizace

== 18.7.2020 ==
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)

== 27.6.2020 (jen MINI) ==
* oprava možného okrajového problému s nečitelnými AD vstupy

== 26.6.2020 ==
* různé drobky/opravy dle hlášení uživatelů a testů
* plně otestovaný MODBUS klient a MQTT klient
* audit log

== 20.6.2020 ==
* SDS-C verze 09: přidáno http_post()
* MODBUS-TCP klient
* doladění MQTT klienta

== 14.6.2020 ==
* SDS-C verze 09
* MQTT klient
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)
* různé opravy (podle ostatních SDS)

== 14.11.2019 ==
* relé lze z webového rozhraní aktivovat i v režimu OneShot
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas)

== 17.2.2019 ==
* oprava v ovládání PDx GPIO ze SDS-C (je to teď zcela shodné s TTCPRO)

== 12.1.2019 ==
* 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)

== 4.1.2019 ==
* překlopena beta do oficiálního vydání
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)
* watchdog sds-c programu
* COM6 je k dispozici

== 1.7.2018 ==
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS
* opraven možný výpadek vysílání na ETH (opraveno stejně jako pro TTCPRO)
* 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)

== 8.3.2018 ==
* oprava echo.htm - zobrazuje se
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktualizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 18.1.2018 ==

* měření AD vstupů funguje

== 18.12.2017 ==

* zvýšena stabilita spuštění po zapnutí

== 18.12.2017 ==

* výchozí firmware (MINI odpovídá obsahem TTCPRO 18.12.2017)
* měření AD vstupů je v tomto vydání vypnuto (použijte novější FW)
* COM6 je vypnut (bude zapnut v příštím vydání)

SDS MICRO: ST: firmware changelog

2025-11-15T14:23:40Z

Adamn:

== SDS-MICRO ST / SDS-MICRO ST DP / SDS-IO6 ST ==

__NOTOC__

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'''.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 15.11.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* SDS-C: přidány indexy 303 a 304 a 305
* SDS-C: přidán indexy 2198

== 2.11.2023 ==
* oprava SNMP (způsob předávání chybových hodnot)

== 6.2.2023 ==
* pouze SDS MICRO ST DP : nový výchozí firmware

== 29.11.2022 ==
* SDS-C: přidán index 137
* dns_resolv hlásí chybu sítě (resp. odpojený ethernet) dříve
* 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

== 26.11.2022 ==
* 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)
* SDS-C: přidány indexy 2811...2816 a 2861...2866 (statistiky COMx)

== 4.8.2022 ==
* zlepšení funkce OneWire - další doplnění pro counterfeit čidla
* zlepšení funkce OneWire - odstranění náhodných výpadků pro čidla vlhkosti
* 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í)
* opraveno hlášení o stavu (chybějící) konfigurace na úvodní webové stránce
* malá bezpečnostní aktualizace

== 1.7.2022 ==
* SDS umí číst teplotu i z counterfeit teplotních čidel (pozná je a přizpůsobí se jejich poškozené komunikaci)
* 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
* funkční autorizovaný HTTP POST pro nahrání nového FW, SDSC, UserWeb, konfigurace a sdílených proměnných
* další drobné úpravy a opravy

== 27.12.2021 ==
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* aktualizován bootloader (vyžaduje fyzické přeprogramování u výrobce) - umí znovu nahrát FW pokud se v SoC poškodí

== 14.4.2021 ==
* oprava hodnot v sys 39 (0 vyp, 3 zap)

== 13.4.2021 ==
* možnost ručního řízení (zap-vyp) aplikace automatiky LČ (zápis do sys 39) když je vypnutý NTP

== 11.4.2021 ==
* 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.).

== 26.3.2021 ==
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)

== 12.3.2021 ==
* oprava COM1 a COM6 - chybně aktivní parita i když nebyla uživatelem nastavena; opraveno

== 9.2.2021 ==
* SDS-C: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* SDS-C: drobná úspora heap (více dostupného místa)
* SDS-C: dns resolv drobný fix
* SDS-C: http_get a http_post důležitý fix
* SDS-C: nová funkce http_close
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 10.1.2021 ==
* 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)

== 5.1.2021 ==
* SDS-C: oprava textcmp()
* bezpečnostní oprava
* dřívější odeslání NTP požadavku po výpadku síťového spojení

== 23.10.2020 ==
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST
* web: oprava tempX.htm
* oprava ovládání PDx (při změně z webu se nesáhne na ostatní bity nastavené např. ze SDS-C)

== 20.9.2020 ==
* zvýšení odolnosti na výpadky komunkace (crc chyby) na OneWire sběrnici

== 4.8.2020 ==
* drobné opravy a optimalizace
* IO6-ST: oprava detekce eth

== 18.7.2020 ==
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)

== 27.6.2020 (jen MICRO-ST) ==
* oprava možného okrajového problému s nečitelnými AD vstupy

== 26.6.2020 ==
* různé drobky/opravy dle hlášení uživatelů a testů
* plně otestovaný MODBUS klient a MQTT klient
* audit log

== 20.6.2020 ==
* SDS-C verze 09: přidáno http_post()
* MODBUS-TCP klient
* doladění MQTT klienta

== 14.6.2020 ==
* SDS-C verze 09
* MQTT klient
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)
* různé opravy (podle ostatních SDS)

== 15.11.2019 ==
* oprava přehozených AD3 a AD4

== 14.11.2019 ==
* první vydání FW pro SDS MICRO ST

SDS MICRO: LM: firmware changelog

2025-11-15T14:23:05Z

Adamn:

== SDS-MICRO LM / SDS-IO6 LM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 15.11.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* SDS-C: přidány indexy 303 a 304 a 305
* SDS-C: přidán indexy 2198

== 1.7.2022 ==
* 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
* obsluha času: možnost zápisu do sys[4], sys[39]
* IO6: doplněny další možné vstupní typy do funkcí itoa/itoh (MICRO už to mělo)
* IO6: možnost zakázat NTP (MICRO už to mělo)

== 28.6.2021 ==
* IO6: web: oprava oneshotreset
* 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ě)

== 26.3.2021 ==
* SDS-C: oprava chování wait() v režimu sys[63]=128 (teď už čeká po správnou dobu, ne po kratší)

== 9.2.2021 ==
* SDS-C: dns resolv drobný fix
* SDS-C: http_get a http_post drobný fix
* SDS-C: nová funkce http_close
* SDS-C: chyba -7 pro MODBUS-TCP a pro MQTT

== 5.1.2021 ==
* SDS-C: oprava textcmp()
* bezpečnostní oprava
* dřívější odeslání NTP požadavku po výpadku síťového spojení

== 23.10.2020 ==
* SDS-C: oprava http_get/post: správná vyplnění výsledů i pro situaci kdy server ukončí spojení přes TCP RST

== 4.8.2020 ==
* SNMP fix - správná hodnota ve .5.13 až .5.16
* drobné opravy a optimalizace

== 18.7.2020 ==
* SDS-C: SMTP klient správně zvládne i servery které (chybně) nereagují potvrzením na předání těla emailu
* SDS-C: http klient upraven (zvýšena odolnost na výpadky spojení se serverem, upraveny timeouty)

== 27.6.2020 (jen MICRO) ==
* oprava nestartování předchozí verze FW na některých specifických typech HW varianty SDS-MICRO-x

== 26.6.2020 ==
* SDS-C 09: http_post()
* MQTT klient
* různé drobky/opravy dle hlášení uživatelů a testů

== 11.5.2020 ==
* oprava Content-Length pro CSS soubor (problém s Chrome)
* oprava chování při odpojeném SDS-1W-T-RH

== 20.4.2020 ==
* podpora pro modul SDS-1W-T-RH (rovnice pro HIH-5031)

== 15.4.2020 ==
* implementován SDS Audit Log
* zvýšená ochrana proti brute-force hledání vstupního hesla

== 14.11.2019 ==
* drobný bugfix pro S0 (způsob zobrazování aktuálního výkonu)
* relé lze z webového rozhraní aktivovat i v režimu OneShot
* SDS-C: emailový klient odesílá i platný datum v hlavičce emailu (je-li v SDS k dispozici platný čas)

== 17.1.2019 ==
* bugfix SDS-C watchdogu

== 12.1.2019 ==
* 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)

== 4.1.2019 ==
* překlopena beta do oficiálního vydání
* SDS-C: verze 08 (pole share[], nové položky v sys[], nové sds-c funkce)
* watchdog sds-c programu

== 1.7.2018 ==
* SDS-C: přidán sys 183 poskytující datum vydání FW který je právě nahrán v SDS

== 30.3.2018 ==
* oprava funkce zápisu prázdného řetězce do názvu 1-Wire teploměru ("smazání názvu" uživatelem)
* 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
* 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)
* 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).

== 12.3.2018 ==
* 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í)

== 8.3.2018 ==
* oprava echo.htm - zobrazuje se
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 18.12.2017 ==
* 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
* 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)
* zámek 1-W pozice se ukládá do pevné paměti (při stisku tlačítka na webovém rozhraní)
* vylepšení v oblasti VCP (telnet pro sériovou linku) - spolehlivější
* 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)
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)

== 23.10.2017 ==
* hlavní nová funkce: přidána volitelná funkce (checkbox ve webovém rozhraní) pro plně automatickou volbu Letního Času (SELČ - aplikovatelné napříč Evropou)
* 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).
* přidány SNMP položky (OID) pro text "ADC jednotka" (pro každý AD vstup).
* 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.).
* SDS-C: přidán sys[4], sys[11], sys[38], sys[39]
* SDS-C: sys[4] = local-time
* SDS-C: sys[11] = vždy "správné" číslo dne v týdnu
* SDS-C: sys[38] = utc-time
* SDS-C: sys[39] = stav automatiky přepínání CEST/CET času

== 10.8.2017 ==
* SDS-C: zvýšena verze na hodnotu 07 (funguje i pro výrobky s EEPROM tak pro výrobky s NVM-DF)
* SDS-C: přidány nové sys[] položky (indexy 1792 až 2047)
* SDS-C: optimalizovaná cache pro velké programy
* SDS-C: maximální počet proměnných zvýšen na 144
* SDS-C: maximální počet procesů (procedur) zvýšen na 96
* SDS-C: hloubka zásobníku (stacku) zvýšena na 24
* vydán nový odpovídající SDSC.exe

== 3.8.2017 ==
* oprava chyby kdy se po každém spuštění systému mohla ztratit část S0 konfigurace (nastavení tarifního vstupu)

== 18.4.2017 ==
* (nová funkčnost) použití UserWEB Projektu
* oprava v echo() pro zápis do sériové linky (uart)
* drobné ale důležité fixy v html stránkách (texty, vzhled)
* nové NTP dotazy lze aktivovat i z SDS-C programu (viz aktualizovaný seznam sys)

== 24.11.2016 ==
* 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)

== 28.3.2016 ==
* impulse counter lze z webu zadat do plných 32 bitů, původně jen 31 bitů
* další drobné opravy

== 26.3.2016 ==
* oprava chybného zpracování RFC2217 příkazu pro změnu BaudRate (zpracoval se jen poslední byte místo celého dwordu, teď opraveno)

== 23.2.2016 ==
* oprava nefunkčního zápisu pomocí SNMP (několik předchozích verzí, teď opraveno)

== 5.2.2016 ==
* 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)
* 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)

== 15.11.2015 ==
* důležité opravy

== 3.7.2015 ==
* vylepšený DHCP client
* řada oprav podle průběžného testování

== 2.4.2015 ==
* veškeré opravy od posledního vydání (viz průběh BETA testů)
* významně zvýšena spolehlivost a stabilita při síťové zátěži (Eth. komunikace)
* SDS-C: přidáno sys[193]
* SDS-C: přidáno sys[37]
* SDS-C: přidáno sys[139]
* SDS-C: možnost zápisu do sys[4]
* SNMP TRAP předává plný OID (dosud dával jen OID useknutný za E.ID)

== 9.9.2014 ==
* opravena chyba pro sys[64]==1 (vnitřním zaokrouhlením to skočilo na nulu)

== 17.8.2014 ==
* přidána možnost použít get_var[index] pro čtení vnitřních proměnných v SDS-C přes web
* SNMP: umožňuje zápis do všech položek přes "Counter32" (nová záležitost) a původní "Integer" typ
* SNMP: přidána možnost zápisu do položek S0-impulse-counter (T0 a T1)
* RS485: při vysílání je budič aktivní max 1msec (nebo méně) od posledního znaku

== 8.7.2014 ==
* opravy v oblasti obsluhy sériového rozhraní (RS485)
* do webové administrace přidána možnost vzájemného přehození pozic dvou 1-Wire záznamů
* další drobné opravy z průběžných beta testů

== 8.3.2014 ==
* 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[])

== 1.3.2014 ==
* SDS-C: nová funkce serial_write()
* 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
* SDS-C: opravena funkce snmp_send_trap() - horní část seznamu trapů byla předtím chybně neodeslatená (teď už je vše OK)
* vylepšení odolnosti při výpadku a při obnovení připojení k Ethernetu
* různé drobné důležité opravy (viz beta testy)

== 23.1.2014 ==
* překlopená beta-verze (po ukončené ověřovací sérii testů)
* SDS-C: úpravy (spolehlivost) v http_get(), dns_resolve()
* rozšířena 1-W funkcionality (další chipy)
* možnost "zrušit odečet" tlačítkem ve webovém rozhraní
* možnost nastavit minimální akceptovanou délku S0 impulsu pro každý vstup samostatně
* maximální velikost user.htm je zvětšena (teď lze vyplnit celou DF)

== 30.11.2013 ==
* celá řada drobných oprav (nalezené v rámci testování od poslední verze)
* S0.htm: všechny hodnoty zobrazují údaje od posledního odpočtu (chybělo pro T0/T1 kWh)
* web: /get_dfi[x]
* SDS-C: čtení a zápis celé stránky z/do paměti DataFlash

== 3.10.2013 ==
* celá řada drobných oprav
* login html stránka upravena (w3c valid)
* možnost nastavit MTD pro S0 měření
* nový SDSC.exe program

== 16.3.2013 ==
* zápis výpadku a znovu-připojení Ethernetu do logu historie
* 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.)
* 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)
* get_sys[xxx] vrací i text pro textové položky (vyzkoušejte všechny sys[] které jsou textové)
* SDS-C: přidáno sys[900] až sys[931] (text ROM CODE pro 1-W čidla)
* upraveno zpracování ARP tabulky (více bezpečné pro dlouhodobý provoz)
* možnost řízení tarifního signálu pro S0 prostřednictvím SDS-C programu
* funkce "odečet" pro S0 (viz nastavení S0 vstupů ve webové administraci)
* SDS-C: funkce smtp_send() akceptuje text[] nejen pro obsah zprávy, ale i pro adresu příjemce a subject
* SDS-C: funkce http_get() akceptuje text[] nejen pro obsah zprávy, ale i pro nastavení HTTP HOST parametru

== 4.2.2013 ==
* při zobrazení echo.htm, když je konzole plná textu, nedojde k resetu zařízení
* 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ě
* SDS-C: přidáno sys[45]
* SDS-C: přidáno sys[46]
* SDS-C: přidáno sys[98]
* SDS-C: echoinline() funguje správně

== 20.12.2012 ==
Významné vydání, oprava řady drobných chyb průběžně hlášených od uživatelů, celá řada nových funkcí
* DHCP CLIENT
* SNMP write
* rychlejší boot loader
* rychlejší webová administrace
* přesnější udržování aktuálního času v zařízení (dvojnásobná kontrola přesnosti a korekce)
* přepracované úložiště v pevné paměti - SDS s eeprom ukládá všech 16 názvů pro teploměry
* možnost změny portu "UDP protokolu" (výchozí port 280)
* SDS-C: konzole zvětšena o zhruba 400 znaků
* 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
* pro každý S0 vstup lze nastavit rozdílnou cenu pro T0 a T1 (stav tarifu)
* SDS-C: funkce send_udp()
* SDS-C: přidáno sys[61]
* SDS-C: přidáno sys[27]
* SDS-C: funkce echoinline()
* správné zpracování LOGIC S0 u zařízení SDS MICRO, které tento vstup nemají
* upraven CSV soubor (vypisuje detaily pro S0)
* upraven xml.xml a s0.xml (vše funguje jak má i při plném osazení, typicky pro SDS MACRO 8)
* SDS-C: sprintf dává 0x00 na konec textu (tohle chybělo)
* SDS-C: http_get() zapisuje 0x00 na "konec" text[], když se do text[] ukládá přijatá odpověď.
* SDS-C: oprava která má zajistit nevyvolání chyby 1029 pro http_get() funkci
* rozšířený MIB (položky pro S0 hodnoty)
* SDS-C: SNMP TRAP (odesílání TRAPů z SDS-C programu)
* a řada drobných obrav a vylepšení

== 7.5.2012 ==
* opravena funkčnost PWM výstupu - lze správné nastavit střídu v rozmezí 0 až 100% viz návod na WiKi

== 29.3.2012 ==
* firmware funguje správně i v historických zařízeních SDS MICRO LIGHT (1) používajících 24C16/24C256

== 27.3.2012 ==
* spolehlivé načítání prvních osmi uložených pozic teploměrů z pevné paměti po resetu
* automaticky umístí nadbývající připojené teploměr na pozice 9 až 16
* zamykání pozic teploměrů funguje správně
* předělaná SDS-C funkce smtp_send() - má větší pracovní buffer, zvládne náročnější SMTP servery

== 18.3.2012 ==
* finální podoba SNMP MIB (stáhněte si aktualizovaný MIB soubor)

== 11.3.2012 ==
* malá změna v SNMP MIB (srovnání MIBů mezi MICRO/MACRO)
* další drobné opravy nahlášené po testování firmware z 8.3.

== 8.3.2012 ==
* odstraněno zpoždění v převodníku Ethernet-Serial (Virtual COM port)

== 4.3.2012 ==
Řada oprav a vylepšení, pocházející z BETA testování (viz forum)
* správný výpočet data od 29.2.2012
* možnost uzamknout pozice 1-Wire zařízení (teploměry)
* rozšířené SNMP
* SDS-C verze č. 06
* pole text[] a funkce atoi(), sprintf()
* uživatelská stránka může být i jako přímo indexová stránka webového rozhraní
* všechny fyzické vstupy a výstupy jsou počítány od jedničky
* další drobné úpravy a opravy, viz soupis u BETA testů

== 17.1.2012 ==
* oprava indexů v "temp" tagech v xml.xml a temp.xml

== 16.1.2012 ==
* 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)

== 15.1.2011 ==
* opravena chyba s user-dataflash (oprava má význam pouze pro výrobky osazené DF, nikoliv EE, tam chyba nebyla)

== 21.12.2011 ==
* zapracovány všechny nové funkce, testované v rámci BETA testování nového firmware (probíhalo od 27.10.)

== 27.10.2011 ==
* 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)
* web: funkce /get_sys a /get_ram může vrátit řadu proměnných za sebou

== 2.10.2011 ==
* přidán sys[26]
* přidán sys[63]
* přidán sys[78]
* doplněn UDP protokol o čtyři nové funkce (čtení / zápis polí sys[] a ram[])

== 31.7.2011 ==
* opraven problém s UDP protokolem - příkaz '''write''' (už funguje vždy ok)
* nový SDSC.exe program - doplňuje správnou HTML serverovou hlavičku pro uživatelskou stránku

== 29.7.2011 ==
* možnost zápis z SDS-C programu do systémových proměnných sys[559] až sys[561]
* nová funkce pro UDP protokol - funkce '''write''' umožňuje hromadný zápis do sys[] systémových proměnných

== 25.6.2011 ==
* 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...)

== 16.6.2011 ==
* verze SDS-C č. 04
* SDS-C: plně funkční funkce ping()
* rozšíření maximální velikosti SDS-C programu ve všech verzích SDS MICRO (light, light2, DIN)
** DATAFLASH maximální velikost programu je 65472 bajtů
** 24C16 maximální velikost programu je 900 bajtů
** 24C256 maximální velikost programu je 31416 bajtů

* web: nastavení uživatelské proměnné pomocí volání sdscep pracuje s doplňkovými parametry (např. vrací hodnotu)
* upravena obsluha eeprom paměti (jiný I2C driver) - tzn. větší spolehlivost a větší rychlost
* sys[25] po každém zavolání čte hodnotu z PHY HW a vrací skutečný stav v daný okamžik
* čtení ze sériové linky je teď dostupné pro program v SDS-C (viz sys[48] a sys[49])
* změna řízení PWM výstupu, lze teď plynule regulovat poměr log0 a log1 v celém rozsahu
* všechny stránky předělány na UTF-8, vstupy textů berou i České znaky atd.
* výpis MAC adresy pro SDS-C program (viz sys[31] až sys[36])
* SDS-C: http_get může uložit získaná data webové stranky do pole ram[]
* 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
* web: informační stránka /arp.htm
* SDS-C: zvětšena velikost pole ram[] na 512 záznamů
* web: výpis hodnot sys[] a ram[] pomocí dynamicky generované webové stránky (např. /get_ram[123] )
* web: čtení výpisu sys[] a ram[] lze zakázat v nastavení (SDS-C parametr)
* SDS-C: možnost zápisu do S0 impulsních počítadel (nulování, úpravy hodnot, atd.)
* 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í

== 21.5.2011 ==
* opravy v českém a anglickém překladu webového rozhraní

== 14.5.2011 ==
* vydána pouze nová EXE aplikace pro nahrávání SDS-C
* od této verze umožňuje použít složité kostrukce s IF, např.: if (test) { kus programu; } else { kus programu; };

== 13.5.2011 ==
* od této verze jsou k dispozici dvě jazykové varianty - plně Česká varianta a plně Anglická varianta
* varianty se liší pouze texty ve webovém rozhraní, jejich funkčnost je ale zcela shodná (bez rozdílů)

== 20.3.2011 ==
* funkční nahrávání uživatelské webové stránky

== 3.3.2011 ==
* pouze nový simulační WinEXE program pro SDS-C
** funkční simulátor LCD (SDS MACRO)
** vylepšení v hlášení chyb při kontrole programu SDS-C

== 27.2.2011 ==
* změněn výpis UpTime v Actual Status webové stránce na dny/hod/min/sec/msec
* doplněna generovaná webová stránka: echo.htm (obsahuje pouze výpis konzole SDS-C, vhodné pro embedding do jiného webu)
* nový XML soubor - usys.xml - výpis vzdálených proměnných SDS-C
* možnost volby nezasílání http dat pro volání sdscep (umožnujě tzv. tichou aktualizaci hodnoty sys)
* do SNMP doplněna hodnota teploty SoC (vyčtená z HW, bez převodu na °C)
* příprava pro nahrání uživatelské webové stránky (plná podpora bude v následující verzi fw)
* nová verze SDS-C, nové možnosti, nový simulátor
** SDS-C: možnost použít #define v programu
** SDS-C: možnost použít uživatelské proměnné jako indexy do pole (sys, ram)
** SDS-C: k dispozici je univerzální pole ram[]
** SDS-C: nová WinEXE aplikace, řada drobností...

== 30.1.2011 ==
* úpravy specifické pro verzi LIGHT s EEPROM (restart zařízení)

== 29.1.2011 ==
* v SNMP doplněn výpis celé hodnoty (x100) pro 1-W teploměry 2 až 16

== 28.1.2011 ==
* dvě nové funkce v SDS-C, pro zápis do sériového portu
* zpřesněný interní čítač reálného času

== 26.1.2011 ==
* 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ů).
* doplňky v simulátoru SDS-C, zejména ohledně času, korekce optovstupů, atd.

== 9.1.2011 ==
* 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)
* 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)

== 7.12.2010 ==
* 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ů

== 1.12.2010 ==
* firmware podporuje i jiné osazené dataflash (menší velikosti) paměti

== 29.11.2010 ==
* 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í
* úpravy odkazů na www.merenienergie.cz, portal.merenienergie.cz

== 20.10.2010 ==
* upraven UDP protokol - doplněno ROMCODE pro teplotní čidla
* upraveno zadávání uživatelských sys[] proměnných z webu (už lze zadávat i záporné čísla)
* opravena ztráta nastavení GMT offset po resetu zařízení

== 8.10.2010 ==
* opraven SNMP který měl od verze 10.9. problémy
* tento a novější firmware je vhodný pro spolupráci se službou portal.merenienergie.cz

== 6.10.2010 ==
* oprava výpisu přepočtené spotřeby (kW) - doplněno vždy na tři desetinná místa
* funkční nulování převodu peněz
* SMTP konfigurace se správně načte po zapnutí zařízení

== 26.9.2010 ==
* SDS-C: stránka "control", uživatelsky editovatelné proměnné
* SDS-C: do sys[] doplněna informace pro S0 (čas od posledního impulsu)
* drobné doplňky do XML, příprava pro SDSMON.exe
* UDP protokol, popis viz wiki

== 17.9.2010 ==
* 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ů)
* výstup /temp.txt je doplněn na dvojici: romcode : teplota
* výstup /temp.xml je doplněn o tagy s romcode

== 15.9.2010 ==
* doplněn výstup teplot ze všech čidel, do textové formy, /temp.txt
* odečet teplotních web-snippet tempX.htm akceptuje hex znaky (tj. 0-9, a-f)

== 14.9.2010 ==
* opraven výpis teploty v csv.csv
* nový xml soubor: temp.xml - pouze s údaji o teplotě

== 10.9.2010 ==
* opraveno zobrazení kWh na webových stránkách (špatný číselný text u vyšších hodnot kWh)

== 8.9.2010 ==
* ve firmware byl zvýšen maximální počet obsluhovaných teplotních sensorů z 8 na 16

== 14.8.2010 ==
* opraveno SDS-C - správnost předávání konstantních číselných parametrů funkcím
* doplněna nová funkce do SDS-C - funkce http_get
* nový Win32 program pro práci s SDS-C (doplněna funkčnost vzdálených labelů)
* zobrazení názvů tarifů na celkové stránce pro S0 (předtím bylo jen na detailních stránkách)

== 9.8.2010 ==
* firmware funguje i pro HW rev2,3 (SDS MICRO light), předchozí verze 3.8. nenašla externí flash paměť

== 3.8.2010 ==
* opravena chyba kdy nedošlo k přečtení konfigurace pro S0 vstupy z pevné paměti, už je to ok
* upraven výpočet okamžitého výkonu, aby při nepřipojeném měřiči ukazoval nulu

== 2.8.2010 ==
* zcela přepracováno webové rozhraní pro měřiče energie
* rozšířené snmp/xml/csv pro měřiče energie
* možnost připojít více samostatnyćh měřičů energie najednou
* vstup pro tarifní rozlišení (denní/noční proud, výroba/dodávka, atd.)
* vylepšený Windows® program pro nahrávání firmware

== 26.7.2010 ==

* nový firmware pro převodník Ethernet/Serial
* samostatná stránka ve webovém rozhraní pro zobrazení stavu převodníku Ethernet/Serial

== 23.7.2010 ==

* ú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
* drobná oprava v SMTP klientu
* byl vydán nový Windows® program pro nahrávání programů v SDS-C

== 18.7.2010 ==

* maximální počet znaků v přihlašovacích údajích pro SMTP je rozšířen na 32 znaků
* drobné opravy ve webovém rozhraní

== 15.7.2010 ==

* 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)

== 10.7.2010 ==

* opravy drobností tak jak byly nahlášeny od uživatelů
* tři desetinné místa na ose grafu spotřeby energie
* oprava hodnoty dne u data v grafu spotřeby energie
* doplňky v http serveru, úprava hlavičky pro CSV
* přihlašovací stránka se už zobrazí všude a vždy (předtím někdy neprošlo např. nod32)
* příprava pro centrální sběrný program SDSMON.exe

== 2.6.2010 ==

* oficiální verze SDS-C k dispozici
* celá řada nových funkcí, především pro SDS-C
* SMTP - odesílání emailů (z programu SDS-C)
* výstup dat i ve formě CSV souboru (středníkový oddělovač pro Excel®)

== 17.5.2010 ==

* opraven výpis LOGu pro IP adresy
* záznam nepovedených přístupů (když to někdo zkouší se špatným heslem)
* drobnosti v http serveru
* graf S0 má místo +1kWh jen +0.1kWh
* oprava detekce EEPROM (aktualizujte FW !)

== 15.5.2010 ==

* změna výchozího NTP serveru (default config)
* kratší odpočet při změně NTP serveru
* stránka S0 i z hlavního menu

== 12.5.2010 ==

* drobné úpravy
* informace o datové paměti (bude důležité pro SDS-C)
* volba NTP serveru

== 4.5.2010 ==

* řada doplňků pro S0 vstup (přepočty, kreslení grafu, xml)

== 23.4.2010 ==

* počítáni S0 impulsů (opto 3), speciální webové zobrazení a přepočty
* doplňky v SNMP, doplněný MIB
* nepřipojené teploměry hlásí teplotu 32767
* příprava stránky pro řízení relé pomocí teploměrů

== 25.1.2010 ==

* možnost pojmenovat si všechny analogové vstupy
* doplněno: název analogového vstupu lze přečíst přes SNMP
* doplněno: název relátka lze přečíst přes SNMP

== 15.1.2010 ==

* opraveno chybějící tlačítko u přihlašovací stránky (šlo pouze stiskem klávesy Enter)
* doplněno chybějící čtvrté nastavovací tlačítko u ADC konstant

== 11.1.2010 ==

* opraveno (doplňeno) chybějící záporné znaménko u výpisu teploty (web, SNMP)

== 31.10.2009 ==

* navýšení maximálního počtu současně přihlášených uživatelů do webového rozhraní

== 30.10.2009 ==

* zvýšení max počtu 1-Wire® teploměrů na 8 kusů na jedné sběrnici
* doplněn výstup SNMP o údaje desetinných hodnot pro všechny teploměry
* 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
* zobrazení sysLocation také v přehledové stránce (actual status)
* možnost pojmenovat si všechny teploměry (16 znaků pro každý)
* možnost pojmenovat si ovládané relé (16 znaků pro každé)

== 29.10.2009 ==

* drobnosti před vydáním 30.10.2009

== 10.10.2009 ==

* NTP klient - synchronizace času a data protokolem NTP
* nastavení NTP serveru a GMT prostřednictvím "Admin config" webové stránky
* zobrazení NTP času a data v "actual status" webové stránce
* zobrazení času a data v "Log" webové stránce u všech položek

== 20.09.2009 ==

* webová stránka "aktuální stav" - upraveno pro správné zobrazování v IE
* v nadpisu webové stránky (tag title) se zobrazuje název zařízení a navíc celý obsah textu ''sysLocation''

== 07.09.2009 ==

* 1-Wire® měří na 1/16 stupně Celsia, upraveno časování (větší spolehlivost), lze připojit více čidel
* možnost změny MAC adresy (přímo z webového rozhraní)
* zobrazení informační (potvrzovací) stránky před změnou IP, MAC

== výchozí firmware ==

* výchozí firmware

SDS-C: sdsc sysp

2025-11-15T14:22:50Z

Adamn:

Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS.
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).

== Definice systémových proměnných SDS-C : pole sys[] ==

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é).

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.

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í).

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í).

''Legenda k tabulce:''

Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).

Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.

Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW''').

Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.
'''Význam hodnot:'''
* '''01''' - první verze, výchozí firmware ze začátku roku 2010
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější

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.

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í.

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.

'''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.

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.

'''Důležité upozornění'''

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).

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.

''Příklad:''
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.
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.

<pre>
skutečná binární hodnota | 32-bit signed | 32-bit unsigned
(32-bit) | SDS-C integer | (internal SDS)
----------------------------------+---------------+-----------------
00000000000000000000000000000000 | 0 | 0
00000000000000000000000000000001 | 1 | 1
00000000000000001111111111111111 | 65535 | 65535
01111111111111111111111111111111 | 2147483647 | 2147483647
10000000000000000000000000000000 | -2147483648 | 2147483648
10000000000000000000000000000001 | -2147483647 | 2147483649
10000000000000001111111111111111 | -2147418113 | 2147549183
11111111111111111111111111111111 | -1 | 4294967295
11111111111111111111111111111110 | -2 | 4294967294
11111111111111111111111111111101 | -3 | 4294967293
</pre>

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á).

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é.

V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''

'''Použítí v SDS-C programu'''

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.

Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)?
<syntaxhighlight lang="c">
teplota0_ve_stupnich_C = sys[310] / 100;
</syntaxhighlight>

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:
<syntaxhighlight lang="c">
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };
</syntaxhighlight>

Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):
<syntaxhighlight lang="c">
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)
</syntaxhighlight>

Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:
<syntaxhighlight lang="c">
#define RELE1 sys[231]

#define TEPLOTA sys[310]

// ...

RELE1 = 255;

if (TEPLOTA > 3200) goto x;
</syntaxhighlight>

== Pole ram[] ==

Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).

Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.

Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).

Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:
<syntaxhighlight lang="c">
hodnota = ram[10];

index = 23;
ram[index] = 15 * 2;

index = sys[1023];
ram[index] = 30;
</syntaxhighlight>

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í.

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).

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.

== Ukládání trvalých dat ==

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[].

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í.

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).

Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].

Další možnost:<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).

== Pole text[] ==

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).

Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].

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.

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).

== Pole share[] ==

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é]]).

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.

== Vyhrazené funkce ==

Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].

== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==

'''STAV SYSTÉMU'''

sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program

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é)

sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci

sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)
- počítá se od nuly (0) od každého zapnutí zařízení
- pouze 31 bitové počítadlo
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času

sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně,
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)

sys[5] 01 i R rozpad LOCAL času: den (1 až 31)
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)

'''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.

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).

== Ethernet, Internet ==

sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)
sys[13] 01 i R IP[1] adresa zařízení
sys[14] 01 i R IP[2] adresa zařízení
sys[15] 01 i R IP[3] adresa zařízení

sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)
sys[17] 01 i R GW_IP[1] adresa brány
sys[18] 01 i R GW_IP[2] adresa brány
sys[19] 01 i R GW_IP[3] adresa brány

sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)
sys[21] 01 i R NETMASK[1] síťová maska
sys[22] 01 i R NETMASK[2] síťová maska
sys[23] 01 i R NETMASK[3] síťová maska

sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)
!= 0 : Ethernetová komunikace je funkční (LINK OK)

sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)
== 0 : neznámá rychlost (není k dispozici Ethernet)
== 10 : 10 MBit per sec
== 100 : 100 MBit per sec

sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti
(po resetu zařízení se vráti na poslední uloženou hodnotu)

sys[27] 06 i R platnost přidělené IP adresy zařízení SDS
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet

sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik

sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)
== 1 : odesláno DHCP DISCOVER
== 2 : obdrženo DHCP OFFER
== 3 : odesláno DHCP REQUEST
== 4 : obdrženo DHCP ACK
== 5 : IP adresa je přidělena (BOUND)
== 6,7,8,9,10,11 : zpracování DHCP RENEW

sys[30] 06 i R aktuální hodnota "DHCP Lease Time"
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)
- údaj je uveden v jednotkách [sec]

sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)
sys[32] 04 i R MAC[1]
sys[33] 04 i R MAC[2]
sys[34] 04 i R MAC[3]
sys[35] 04 i R MAC[4]
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)

sys[37] 06 i R NTP Client Status (synchronizace času)
== 0 : nesynchronizováno
== 1 : úspěšně přijal paket od NTP Serveru
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz
(dotaz se odešle za 10sec od takovéhoto zápisu)

sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)
- není zde aplikován offset, ani automatika letního času
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď),
uvnitř SDS je sice udržována jako 32bit,
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).

sys[39] 07 i R stav automatiky přepínání Letního Času
== 0 : automatika zakázána, lokální čas není ovlivněn
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).
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)
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í
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

sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)

sys[139] 09 i R vyhrazeno

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í).

sys[40] až sys[44] RESERVED vyhrazeno

== Provozní údaje ==

sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)
- po resetu zařízení začíná vždy počítat od nuly
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!
- pro sys[45] je k dispozici 31 bitů,
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).

sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),
význam hodnot závisí na typu konkrétního zařízení SDS.
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.

SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM):
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]

SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST:
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]

Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.

sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu
(při přetečení 2^31 počítá opět od nuly, pořád dokola)

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).
Tento index vyžaduje aktuální FW (11/2022 nebo novější).

== Rozhraní sériové komunikace ==

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.

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ě.

Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše.
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í.

Rozhraní COM1:

sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici),
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není !
(Toto může způsobit nezkušenému programátorovi potíže).
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné,
a s tou pak dále dle libosti pracovat.
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!

sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?
== 0 : není připojen klient
!= 0 : je připojen klient (přes TELNET port)
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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í).

Rozhraní COM6:

sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

sys[57] 02 i R rychlost [bps] rozhraní UART - COM6
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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.

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).

== Generátor náhodných čísel ==

sys[61] 06 i R generátor náhodných čísel
- při každém přečtení sys[61] je poskytnuto náhodné číslo

== Výsledek převodu textu na číslo ==

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]''.

sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''

Pro více informací se podívejte přímo na návod k této funkci.

== Nastavení rychlosti provádění SDS-C programu ==

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čí.

sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku)
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )

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).

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.

== Časování ==

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:

sys[64] 01 i RW sekundový odpočítávač
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1,
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)

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.

== OSI7 funkce ==

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).

Všechny funkce OSI7 poskytují průběžný stav své činnosti:
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)
- význam hodnot viz [[OSI7_status_code|popis zde]]

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.

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.
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''

Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru

sys[74] 01 s R text, reserved (v této verzi nepoužito)

Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):

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)
sys[303] 09 i W DNS RESOLV - write value 0xD65 (3429dec) to clear the DNS cache
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)
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)
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)

HTTP GET:

sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)
- nastaveno po dokončení práce funkce '''http_get()'''
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.

sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.

sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu.
Nastavte na:

== 0 : jakékoliv přijaté data jsou '''zahozena''',
neuloží se (nedojde ke změně obsahu ram[] nebo text[])

== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole ram[] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !

sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])
- maximální hodnota je omezena velikostí pole ram[] nebo text[]
- pozor! pokud zapíšete '''0''', budou všechna data zahozena,
ale i v takovém případě dojde k přepisu ram[0] (viz výše)

sys[79] až sys[80] RESERVED vyhrazeno

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.

Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru

sys[85] až sys[88] RESERVED vyhrazeno

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()" ) :

sys[89] 06 i R IP-Watchdog: stav
== 0 : není v provozu (neaktivováno ve webovém rozhraní)
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)

sys[90] 06 i R IP-Watchdog: poslední známé RTT
== 0 .. 65533 : hodnota RTT v msec
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)

sys[91] 06 i R IP-Watchdog: stav výstupu
== 0 : výstup není aktivován
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)

Informace z (SDC-C) ICMP PING funkce - '''ping()''' :

sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92]
== 0 : klid (není odeslán paket, nečekám na odpověď),
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle
== 1 : funkce '''ping()''' byla právě zavolána,
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání
== 2 : čeká se na odpověď od ARP
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket,
protože v ARP tabulce nebyl příslušný záznam)
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY
(požadovaný stav, funkce '''ping()''' funguje ok)
== 8 : právě obdržel ECHO REPLY
(byla přijata odpověď od vzdáleného zařízení)

sys[93] 04 i R PING SEQ number
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE
na ICMP PING REQUEST odeslaný funkcí '''ping()'''

sys[94] 04 i R Round Trip Time, v milisekundách
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''
- č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)

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'''" .

Funkce '''send_udp()''':

sys[95] 06 i R výsledek posledního volání '''send_udp()'''
Hodnoty:
== 0 : nic neprovedeno
Hodnota '''0''' je nastavena po startu SDS-C programu
== 1 : právě bylo zahájeno odesílání paketu (provádí se)
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.
== 2 : byl odeslán UDP paket, úspěšně
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz
== 4 : zavolali jste funkci '''send_udp()''' dříve,
než byla dokočena činnost předchozího požadavku
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)

Funkce '''snmp_send_trap()''':

sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''
Hodnoty:
== 0 : odesílání neprobíhá
== 1 : probíhá odesílání, výsledek ještě není znám
== 2 : odeslání se povedlo
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)

sys[97] RESERVED vyhrazeno

== Zápis textu do pole, Porovnání textů ==

Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.

sys[98] i R společné využití viz (1) a (2)

06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'',
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:
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''
- kam byla zapsána terminační 0x00 funkcí '''itoh()'''
- kam byla zapsána terminační 0x00 funkcí '''itoa()'''

08 i R (2) výsledek porovnání textů
- hodnota výsledku zavolání funkce '''textcmp()'''
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci
X == 0 : oba texty jsou identické
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''

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.

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[]'').

== Uživatelské pozice v pevné paměti ==

sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]

sys[100] až sys[115]
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti

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[]'').

''' Reserved '''

sys[116] až sys[136] RESERVED vyhrazeno

== Proměnné nastavitelné uživatelem z webového rozhraní ==

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.

sys[140] až sys[149]
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)
(vždy 32-bit signed integer)

sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu
Nastavení:
== 0 : stránka "control" je přístupná bez hesla,
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)

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).

Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.

Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).

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í.

== Proměnné vstupů a výstupů pro všechny výrobky SDS ==

'''POZOR'''

'''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.

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í).

'''Pokračování výpisu:'''

sys[151] až sys[182]
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu
Hodnoty:
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)

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.

'''Důležité info:'''

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).

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.

== Stav SDS-C programu ==

Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).

sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)

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.

Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:

sys[184] 08 i RW způsob spuštění SDS-C programu
== 0 : bez informace
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace

Stav SDS-C watchdogu:

sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec
== -1 : wdg není aktivní
== 0 : odpočet vypršel, dojde k resetu SDS-C programu
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)

== Pulse-Width Modulation výstupy ==

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).

''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.
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).
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.
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).
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]).

Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !

Pozor, pro tyto typy SDS:

SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO'''

Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).

Podle typu SDS:

SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)

sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)

sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).

sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]
- tato hodnota není aktualizována vůči sys[192], ani není archivována
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.

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.

Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.

SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)

sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)

sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)

sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)

sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[187] 09 i RW duty-cycle '''PWM3''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)

sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[189] 09 i RW duty-cycle '''PWM4''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)

sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.

== Ovládání výstupů - Relé ==

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é.

sys[196] až sys[228]
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''
- lze nastavit i z webového rozhraní
Hodnoty:
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)

sys[229] až sys[230] RESERVED vyhrazeno

sys[231] až sys[262]
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)
Hodnoty:
== 0 : relé není aktivní
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)
!= 0 : relé je aktivní
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)

sys[263] až sys[265] RESERVED vyhrazeno

sys[266] až sys[298]
01 s R uživatelský textový název pro '''RE1''' až '''RE32'''
- nastaveno ve webovém rozhraní

sys[264] až sys[300] RESERVED vyhrazeno

== Ovládání PDx ==

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.

Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):

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)
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)
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)
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
SDS '''IO6-ST''': nepoužito
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

Řízení směru pro jednotlivé PDx resp. TOPB:

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)
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)
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)
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
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

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í.

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.

MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).

sys[306] až sys[309] RESERVED vyhrazeno

== Tlačítka na desce display pro SDS-MACRO-ST ==

Č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).

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.

== Vstupy - teploměry na externí sběrnici 1-Wire® ==

Č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.

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici

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)'''.

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'''.

sys[342] až [345] RESERVED vyhrazeno

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)
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''

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)
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''

sys[350] až sys[381]
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)

sys[382] až [389] RESERVED vyhrazeno

sys[391] až sys[422]
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)

''' Reserved '''

sys[423] až sys[430] RESERVED vyhrazeno

== Vstupy: analogové vstupy pro měření napětí ==

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.

sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4

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.

Rozsah hodnoty RAW je:
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)

Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):

sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[436] 01 i R Div pro A/D 1
sys[437] 01 s R textový název A/D 1
sys[438] 01 s R jednotka A/D 1

sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[440] 01 i R Div pro A/D 2
sys[441] 01 s R textový název A/D 2
sys[442] 01 s R jednotka A/D 2

sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[444] 01 i R Div pro A/D 3
sys[445] 01 s R textový název A/D 3
sys[446] 01 s R jednotka A/D 3

sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[448] 01 i R Div pro A/D 4
sys[449] 01 s R textový název A/D 4
sys[450] 01 s R jednotka A/D 4

'''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) !
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".

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).

''' Reserved '''

sys[451] až sys[458] RESERVED vyhrazeno

== Proměnné pro S0 impulsní vstup ==

sys[459] 01 i RW stav tarifu
== 0 : T0 (vysoký tarif)
== 1 : T1 (nízký tarif)

sys[460] až sys[492]
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty,
pak sem v takovém případě nastavte číslo 1
- platné hodnoty: 1 až 65280 (včetně)

sys[493] až sys[525]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[526] až sys[558]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[559] až sys[591]
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).

sys[592] až sys[624]
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)
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

sys[625] až sys[657]
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"
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

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.

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.

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é.

sys[658] až sys[670] reserved for future use

poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).

== Speciální vstupy a výstupy ==

Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.

'''Pouze pro SDS MICRO (LM) LIGHT:'''

sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)

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ší.

SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.

SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).

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'''.

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).

'''Pouze pro SDS MACRO ST:'''

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).

sys[671] 02 i R čtení stavu TL1
sys[672] 02 i R čtení stavu TL2

'''Pájecí plošky CFG:'''

Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.

V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.
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).
Takový firmware se teprve chystá (SDS TTCPRO).

sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)

== Speciální proměnné pro SDS-UPS ==

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 .

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í.

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).

sys[700] 02 i R reserved
sys[701] 02 i R reserved
sys[702] 02 i R reserved
sys[703] 02 i R reserved

'''Přepínač algoritmů:'''

sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C

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.

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.

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.

sys[705] až sys[731] reserved

Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.

Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.

'''Vstupy a konfigurace:'''

sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu

Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě.
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu.
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.).

sys[737] až sys[739] reserved

Následuje konfigurace provedená uživatelem ve webovém rozhraní.
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á.

sys[740] 02 i R primary voltage to say target is ok (pri_pvts)
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)
sys[748] 02 i R flag: do not switch accu off (aku_dach)

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.

sys[749] až sys[760] reserved

'''Výstupy:'''

Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !

sys[761] 02 i RW ovládání vypínání nabíječe
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)

sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)
!= 0 : zásah do zpětné vazby (posun rozsahu)
(vhodné pro skokové zvýšení výstupního napětí nabíječe,
když už nereaguje v původním rozsahu)

sys[763] 02 i RW ovládání odpojovače baterie
== 0 : spínač vypnutý (baterie odpojena od zátěže)
!= 0 : spínač sepnutý (baterie připojena)

sys[764] 02 i RW indikační LED - nabíjení akumulátoru
== 0 : LED svítí (informace: akumulátor je nabíjen)
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)

sys[765] 02 i RW indikační LED - výpadek primárního vstupu
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)

'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:

sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)
- minimální hodnota = 1
- maximální hodnota = 2497

sys[767] až sys[769] RESERVED vyhrazeno

Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':

sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx

sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx

sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx

Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):

UPS_PROVOZ_START 0
UPS_PROVOZ_PRIOK 1
UPS_PROVOZ_PRIOK_CHARGING 2
UPS_PROVOZ_ONLY_BATT 4
UPS_PROVOZ_NO_BATT 8

UPS_NABREZIM_CC 0
UPS_NABREZIM_CV 2
UPS_NABREZIM_PAUZA 4
UPS_NABREZIM_URCENI_REZIMU 8

UPS_BATERIE_ODHAD_NEZNAM 0
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1
UPS_BATERIE_ODHAD_OK_NABIJIM 2
UPS_BATERIE_ODHAD_PLNE_NABITO 4

== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==

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.
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.

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.

Změřená teplota je uložena na standardních indexech:

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 degC

Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):

sys[800] až sys[831]
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

sys[832] až sys[863]
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

SDS provádí přepočet na údaj RH v procentech (0 až 100):

sys[864] až sys[895]
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).

Rezerva (zatím nepoužito):

sys[896] až sys[899] RESERVED vyhrazeno

== Doplňující informace pro 1-Wire zařízení ==

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).

'''1-Wire chipy interně zpracovávané SDS'''

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.

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]'''.

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.

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ů.
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:

sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále až

sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):

sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále . . . až

sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.

Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.

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.

sys[931] až sys[939] reserved

'''Ostatní 1-Wire chipy'''

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.

Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci.
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.
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[]''',
nebo bude nastaven chybový kód.

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.
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).

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.

Obecný stav sběrnic:

sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů
:
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici

== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)

== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)

== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)

== 8 : byl přečten ROM CODE z připojeného ostatního chipu
(už lze také požádat o další nové čtení 1-W sběrnice)

== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici
(zkuste provést rescan/čtení znovu)

sys[942] až sys[949] reserved

'''Pro sběrnici [A]:'''

sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[951] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire
:
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)
sys[953] 06 i R romcode[1] (1-W: serial code)
sys[954] 06 i R romcode[2] (1-W: serial code)
sys[955] 06 i R romcode[3] (1-W: serial code)
sys[956] 06 i R romcode[4] (1-W: serial code)
sys[957] 06 i R romcode[5] (1-W: serial code)
sys[958] 06 i R romcode[6] (1-W: serial code)
sys[959] 06 i R romcode[7] (1-W: CRC byte)

sys[960] až sys[969] reserved

'''Pro sběrnici [B]:'''

sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[971] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire
:
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)
sys[973] 06 i R romcode[1] (1-W: serial code)
sys[974] 06 i R romcode[2] (1-W: serial code)
sys[975] 06 i R romcode[3] (1-W: serial code)
sys[976] 06 i R romcode[4] (1-W: serial code)
sys[977] 06 i R romcode[5] (1-W: serial code)
sys[978] 06 i R romcode[6] (1-W: serial code)
sys[979] 06 i R romcode[7] (1-W: CRC byte)

sys[980] až sys[989] reserved

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).

'''Pozor''':

Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy,
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ů).

== Reserved ==

sys[990] až sys[1023] reserved

== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==

'''Přímý přístup do LCD Frame Buffer paměti:'''

sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)

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).

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 !

Č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).

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.

'''Pozor''' SDS-MACRO-ST

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.

== Vyhrazená oblast ==

'''Zbytek:'''

sys[1552] až sys[1663] reserved

== Bateriově Zálohovaná Paměť ==

'''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!

Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější.

sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot
- každý index má k dispozici 32 bitů (tj. celý signed integer)
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")

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).

''(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).

== Další informace ze S0 vstupů ==

Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.

Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:

sys[1792] až sys[1823]
07 i R cena za jednotku v režimu T0
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1824] až sys[1855]
07 i R cena za jednotku v režimu T1
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1856] až sys[1887]
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")
- text

sys[1888] až sys[1919]
07 s R název měny, podle nastavení (např. text "CZK")
- text

sys[1920] až sys[1951]
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")
- text

sys[1952] až sys[1983]
07 s R název činnosti, podle nastavení (např. text "spotřeba")
- text

sys[1984] až sys[2015]
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")
- text

sys[2016] až sys[2047]
07 i R konfigurační detaily pro daný S0 vstup
- bit 0 nastaven = je to aktivní S0 vstup
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)

Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.

== Reserved ==

sys[2048] až sys[2197] reserved

== MQTT klient ==

Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:

sys[2199] 09 i R podpora MQTT
0 = NE
1 = ANO, verze MQTT 3.1.1, SDS první část implementace
2..max = (reserved)

Každé nové připojení k Brokeru:

sys[2200] 09 i R stav průběhu mqtt_connect()
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno a odeslán CONNECT požadavek
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )
8 = probíhá odpojování, čekáme na výsledek (na odpojení)

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.

sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"
-7 = nepoužito
-6 = timeout při čekání na CONNACK, nepřipojeno
-5 = nepoužito
-4 = nepoužito
-3 = nepoužito
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)
-1 = idle, nepřipojeno
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)
1 = MQTT 0x01: Connection Refused, unacceptable protocol version
2 = MQTT 0x02: Connection Refused, identifier rejected
3 = MQTT 0x03: Connection Refused, Server unavailable
4 = MQTT 0x04: Connection Refused, bad user name or password
5 = MQTT 0x05: Connection Refused, not authorized

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).

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:

sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu
-4 = nespravne parametry (počet parametrů)
-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
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity
0 = nepoužito
1 = mqtt_publish() probíhá
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci
4 = mqtt_subscribe() probíhá - čekám na SUBACK
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce

Informativní položka:

sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru
(objeví-li se chyba, dojde k okamžitému odpojení)

Nastavení (položka 2198 je k dispzoici až od FW 11/2025):

sys[2198] 09 i R mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN )
sys[2198] 09 i W write ( default: 0b00110001 )

Zatím nepoužité pozice:

sys[2204] až sys[2208] reserved

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)

sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)

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.

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 !

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)

Jednotlivé položky v tabulce příchozích zpráv:

sys[2211] až sys[2241]
09 s R název položky (Topic Name) pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2242] až sys[2249] reserved

sys[2251] až sys[2281]
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2282] až sys[2289] reserved

sys[2291] až sys[2321]
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru
(pro detekci změny - příchozí zprávy z Brokeru)
0 = zatím nic nepřišlo
1..MAX = hodnota uptime v okamžiku poslední změny

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.

== Reserved ==

sys[2322] až sys[2398] reserved

== MODBUS-TCP klient ==

Ověření FW v SDS:

sys[2399] 09 i R podpora pro MODBUS TCP
0 = NE
1 = ANO (první verze implementace v SDS)

Každé nové TCP spojení na server:

sys[2400] 09 i R stav průběhu modbus_tcp_connect()
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno, můžete komunikovat

MODBUS funkce - každá má svůj nezávislý stavový údaj:

sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
pro všechny tyto stavy platí následující hodnoty:
-6 = timeout (neprovedeno), můžete volat další funkci
-5 = nespravne parametry (hodnoty), můžete volat další funkci
-4 = nespravne parametry (počet parametrů), můžete volat další funkci
-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
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity, lze volat funkci
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci
256 = pracuji, čekejte na aktualizovanou hodnotu

sys[2417] až sys[2462] reserved

sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy

sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy

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).

sys[2465] 09 i R timestamp poslední přijaté zprávy
(vhodné pro detekci nové přijaté zprávy)

sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu
(počet celých položek)

sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])
(MODBUS způsob číslování položek - adresa 1..n)

sys[2470] až sys[2719]
09 i R přijaté hodnoty pro poslední přijatou zprávu
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr

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.

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.

Rezerva

sys[2715] až sys[2809] reserved

== Statistiky COMx ==

COM1:

sys[2810] 09 i R reserved

sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1

sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1

sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1

sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1

Rezerva

sys[2817] až sys[2860] reserved

COM6:

sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6

sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6

sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6

sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6

Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).

== Konec dokumentu ==

'''Konec dokumentu.'''

Firmware

2025-11-15T14:20:15Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

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]].

=== Odkazy ke stáhnutí ===
<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ů:
<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<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]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

SDS-C: sdsc sysp

2025-11-15T11:19:56Z

Adamn:

Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS.
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).

== Definice systémových proměnných SDS-C : pole sys[] ==

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é).

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.

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í).

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í).

''Legenda k tabulce:''

Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).

Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.

Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW''').

Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.
'''Význam hodnot:'''
* '''01''' - první verze, výchozí firmware ze začátku roku 2010
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější

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.

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í.

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.

'''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.

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.

'''Důležité upozornění'''

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).

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.

''Příklad:''
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.
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.

<pre>
skutečná binární hodnota | 32-bit signed | 32-bit unsigned
(32-bit) | SDS-C integer | (internal SDS)
----------------------------------+---------------+-----------------
00000000000000000000000000000000 | 0 | 0
00000000000000000000000000000001 | 1 | 1
00000000000000001111111111111111 | 65535 | 65535
01111111111111111111111111111111 | 2147483647 | 2147483647
10000000000000000000000000000000 | -2147483648 | 2147483648
10000000000000000000000000000001 | -2147483647 | 2147483649
10000000000000001111111111111111 | -2147418113 | 2147549183
11111111111111111111111111111111 | -1 | 4294967295
11111111111111111111111111111110 | -2 | 4294967294
11111111111111111111111111111101 | -3 | 4294967293
</pre>

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á).

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é.

V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''

'''Použítí v SDS-C programu'''

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.

Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)?
<syntaxhighlight lang="c">
teplota0_ve_stupnich_C = sys[310] / 100;
</syntaxhighlight>

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:
<syntaxhighlight lang="c">
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };
</syntaxhighlight>

Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):
<syntaxhighlight lang="c">
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)
</syntaxhighlight>

Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:
<syntaxhighlight lang="c">
#define RELE1 sys[231]

#define TEPLOTA sys[310]

// ...

RELE1 = 255;

if (TEPLOTA > 3200) goto x;
</syntaxhighlight>

== Pole ram[] ==

Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).

Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.

Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).

Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:
<syntaxhighlight lang="c">
hodnota = ram[10];

index = 23;
ram[index] = 15 * 2;

index = sys[1023];
ram[index] = 30;
</syntaxhighlight>

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í.

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).

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.

== Ukládání trvalých dat ==

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[].

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í.

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).

Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].

Další možnost:<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).

== Pole text[] ==

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).

Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].

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.

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).

== Pole share[] ==

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é]]).

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.

== Vyhrazené funkce ==

Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].

== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==

'''STAV SYSTÉMU'''

sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program

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é)

sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci

sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)
- počítá se od nuly (0) od každého zapnutí zařízení
- pouze 31 bitové počítadlo
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času

sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně,
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)

sys[5] 01 i R rozpad LOCAL času: den (1 až 31)
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)

'''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.

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).

== Ethernet, Internet ==

sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)
sys[13] 01 i R IP[1] adresa zařízení
sys[14] 01 i R IP[2] adresa zařízení
sys[15] 01 i R IP[3] adresa zařízení

sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)
sys[17] 01 i R GW_IP[1] adresa brány
sys[18] 01 i R GW_IP[2] adresa brány
sys[19] 01 i R GW_IP[3] adresa brány

sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)
sys[21] 01 i R NETMASK[1] síťová maska
sys[22] 01 i R NETMASK[2] síťová maska
sys[23] 01 i R NETMASK[3] síťová maska

sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)
!= 0 : Ethernetová komunikace je funkční (LINK OK)

sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)
== 0 : neznámá rychlost (není k dispozici Ethernet)
== 10 : 10 MBit per sec
== 100 : 100 MBit per sec

sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti
(po resetu zařízení se vráti na poslední uloženou hodnotu)

sys[27] 06 i R platnost přidělené IP adresy zařízení SDS
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet

sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik

sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)
== 1 : odesláno DHCP DISCOVER
== 2 : obdrženo DHCP OFFER
== 3 : odesláno DHCP REQUEST
== 4 : obdrženo DHCP ACK
== 5 : IP adresa je přidělena (BOUND)
== 6,7,8,9,10,11 : zpracování DHCP RENEW

sys[30] 06 i R aktuální hodnota "DHCP Lease Time"
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)
- údaj je uveden v jednotkách [sec]

sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)
sys[32] 04 i R MAC[1]
sys[33] 04 i R MAC[2]
sys[34] 04 i R MAC[3]
sys[35] 04 i R MAC[4]
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)

sys[37] 06 i R NTP Client Status (synchronizace času)
== 0 : nesynchronizováno
== 1 : úspěšně přijal paket od NTP Serveru
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz
(dotaz se odešle za 10sec od takovéhoto zápisu)

sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)
- není zde aplikován offset, ani automatika letního času
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď),
uvnitř SDS je sice udržována jako 32bit,
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).

sys[39] 07 i R stav automatiky přepínání Letního Času
== 0 : automatika zakázána, lokální čas není ovlivněn
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).
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)
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í
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

sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)

sys[139] 09 i R vyhrazeno

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í).

sys[40] až sys[44] RESERVED vyhrazeno

== Provozní údaje ==

sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)
- po resetu zařízení začíná vždy počítat od nuly
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!
- pro sys[45] je k dispozici 31 bitů,
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).

sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),
význam hodnot závisí na typu konkrétního zařízení SDS.
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.

SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM):
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]

SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST:
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]

Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.

sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu
(při přetečení 2^31 počítá opět od nuly, pořád dokola)

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).
Tento index vyžaduje aktuální FW (11/2022 nebo novější).

== Rozhraní sériové komunikace ==

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.

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ě.

Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše.
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í.

Rozhraní COM1:

sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici),
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není !
(Toto může způsobit nezkušenému programátorovi potíže).
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné,
a s tou pak dále dle libosti pracovat.
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!

sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?
== 0 : není připojen klient
!= 0 : je připojen klient (přes TELNET port)
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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í).

Rozhraní COM6:

sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

sys[57] 02 i R rychlost [bps] rozhraní UART - COM6
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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.

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).

== Generátor náhodných čísel ==

sys[61] 06 i R generátor náhodných čísel
- při každém přečtení sys[61] je poskytnuto náhodné číslo

== Výsledek převodu textu na číslo ==

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]''.

sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''

Pro více informací se podívejte přímo na návod k této funkci.

== Nastavení rychlosti provádění SDS-C programu ==

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čí.

sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku)
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )

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).

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.

== Časování ==

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:

sys[64] 01 i RW sekundový odpočítávač
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1,
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)

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.

== OSI7 funkce ==

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).

Všechny funkce OSI7 poskytují průběžný stav své činnosti:
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)
- význam hodnot viz [[OSI7_status_code|popis zde]]

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.

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.
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''

Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru

sys[74] 01 s R text, reserved (v této verzi nepoužito)

Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):

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)
sys[303] 09 i W DNS RESOLV - write value 0xD65 (3429dec) to clear the DNS cache
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)
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)
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)

HTTP GET:

sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)
- nastaveno po dokončení práce funkce '''http_get()'''
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.

sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.

sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu.
Nastavte na:

== 0 : jakékoliv přijaté data jsou '''zahozena''',
neuloží se (nedojde ke změně obsahu ram[] nebo text[])

== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole ram[] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !

sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])
- maximální hodnota je omezena velikostí pole ram[] nebo text[]
- pozor! pokud zapíšete '''0''', budou všechna data zahozena,
ale i v takovém případě dojde k přepisu ram[0] (viz výše)

sys[79] až sys[80] RESERVED vyhrazeno

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.

Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru

sys[85] až sys[88] RESERVED vyhrazeno

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()" ) :

sys[89] 06 i R IP-Watchdog: stav
== 0 : není v provozu (neaktivováno ve webovém rozhraní)
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)

sys[90] 06 i R IP-Watchdog: poslední známé RTT
== 0 .. 65533 : hodnota RTT v msec
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)

sys[91] 06 i R IP-Watchdog: stav výstupu
== 0 : výstup není aktivován
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)

Informace z (SDC-C) ICMP PING funkce - '''ping()''' :

sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92]
== 0 : klid (není odeslán paket, nečekám na odpověď),
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle
== 1 : funkce '''ping()''' byla právě zavolána,
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání
== 2 : čeká se na odpověď od ARP
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket,
protože v ARP tabulce nebyl příslušný záznam)
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY
(požadovaný stav, funkce '''ping()''' funguje ok)
== 8 : právě obdržel ECHO REPLY
(byla přijata odpověď od vzdáleného zařízení)

sys[93] 04 i R PING SEQ number
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE
na ICMP PING REQUEST odeslaný funkcí '''ping()'''

sys[94] 04 i R Round Trip Time, v milisekundách
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''
- č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)

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'''" .

Funkce '''send_udp()''':

sys[95] 06 i R výsledek posledního volání '''send_udp()'''
Hodnoty:
== 0 : nic neprovedeno
Hodnota '''0''' je nastavena po startu SDS-C programu
== 1 : právě bylo zahájeno odesílání paketu (provádí se)
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.
== 2 : byl odeslán UDP paket, úspěšně
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz
== 4 : zavolali jste funkci '''send_udp()''' dříve,
než byla dokočena činnost předchozího požadavku
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)

Funkce '''snmp_send_trap()''':

sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''
Hodnoty:
== 0 : odesílání neprobíhá
== 1 : probíhá odesílání, výsledek ještě není znám
== 2 : odeslání se povedlo
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)

sys[97] RESERVED vyhrazeno

== Zápis textu do pole, Porovnání textů ==

Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.

sys[98] i R společné využití viz (1) a (2)

06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'',
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:
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''
- kam byla zapsána terminační 0x00 funkcí '''itoh()'''
- kam byla zapsána terminační 0x00 funkcí '''itoa()'''

08 i R (2) výsledek porovnání textů
- hodnota výsledku zavolání funkce '''textcmp()'''
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci
X == 0 : oba texty jsou identické
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''

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.

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[]'').

== Uživatelské pozice v pevné paměti ==

sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]

sys[100] až sys[115]
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti

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[]'').

''' Reserved '''

sys[116] až sys[136] RESERVED vyhrazeno

== Proměnné nastavitelné uživatelem z webového rozhraní ==

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.

sys[140] až sys[149]
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)
(vždy 32-bit signed integer)

sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu
Nastavení:
== 0 : stránka "control" je přístupná bez hesla,
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)

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).

Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.

Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).

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í.

== Proměnné vstupů a výstupů pro všechny výrobky SDS ==

'''POZOR'''

'''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.

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í).

'''Pokračování výpisu:'''

sys[151] až sys[182]
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu
Hodnoty:
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)

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.

'''Důležité info:'''

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).

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.

== Stav SDS-C programu ==

Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).

sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)

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.

Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:

sys[184] 08 i RW způsob spuštění SDS-C programu
== 0 : bez informace
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace

Stav SDS-C watchdogu:

sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec
== -1 : wdg není aktivní
== 0 : odpočet vypršel, dojde k resetu SDS-C programu
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)

== Pulse-Width Modulation výstupy ==

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).

''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.
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).
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.
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).
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]).

Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !

Pozor, pro tyto typy SDS:

SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO'''

Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).

Podle typu SDS:

SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)

sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)

sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).

sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]
- tato hodnota není aktualizována vůči sys[192], ani není archivována
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.

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.

Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.

SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)

sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)

sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)

sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)

sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[187] 09 i RW duty-cycle '''PWM3''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)

sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[189] 09 i RW duty-cycle '''PWM4''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)

sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.

== Ovládání výstupů - Relé ==

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é.

sys[196] až sys[228]
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''
- lze nastavit i z webového rozhraní
Hodnoty:
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)

sys[229] až sys[230] RESERVED vyhrazeno

sys[231] až sys[262]
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)
Hodnoty:
== 0 : relé není aktivní
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)
!= 0 : relé je aktivní
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)

sys[263] až sys[265] RESERVED vyhrazeno

sys[266] až sys[298]
01 s R uživatelský textový název pro '''RE1''' až '''RE32'''
- nastaveno ve webovém rozhraní

sys[264] až sys[300] RESERVED vyhrazeno

== Ovládání PDx ==

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.

Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):

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)
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)
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)
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
SDS '''IO6-ST''': nepoužito
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

Řízení směru pro jednotlivé PDx resp. TOPB:

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)
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)
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)
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
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

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í.

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.

MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).

sys[306] až sys[309] RESERVED vyhrazeno

== Tlačítka na desce display pro SDS-MACRO-ST ==

Č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).

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.

== Vstupy - teploměry na externí sběrnici 1-Wire® ==

Č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.

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici

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)'''.

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'''.

sys[342] až [345] RESERVED vyhrazeno

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)
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''

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)
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''

sys[350] až sys[381]
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)

sys[382] až [389] RESERVED vyhrazeno

sys[391] až sys[422]
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)

''' Reserved '''

sys[423] až sys[430] RESERVED vyhrazeno

== Vstupy: analogové vstupy pro měření napětí ==

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.

sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4

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.

Rozsah hodnoty RAW je:
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)

Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):

sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[436] 01 i R Div pro A/D 1
sys[437] 01 s R textový název A/D 1
sys[438] 01 s R jednotka A/D 1

sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[440] 01 i R Div pro A/D 2
sys[441] 01 s R textový název A/D 2
sys[442] 01 s R jednotka A/D 2

sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[444] 01 i R Div pro A/D 3
sys[445] 01 s R textový název A/D 3
sys[446] 01 s R jednotka A/D 3

sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[448] 01 i R Div pro A/D 4
sys[449] 01 s R textový název A/D 4
sys[450] 01 s R jednotka A/D 4

'''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) !
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".

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).

''' Reserved '''

sys[451] až sys[458] RESERVED vyhrazeno

== Proměnné pro S0 impulsní vstup ==

sys[459] 01 i RW stav tarifu
== 0 : T0 (vysoký tarif)
== 1 : T1 (nízký tarif)

sys[460] až sys[492]
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty,
pak sem v takovém případě nastavte číslo 1
- platné hodnoty: 1 až 65280 (včetně)

sys[493] až sys[525]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[526] až sys[558]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[559] až sys[591]
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).

sys[592] až sys[624]
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)
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

sys[625] až sys[657]
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"
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

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.

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.

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é.

sys[658] až sys[670] reserved for future use

poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).

== Speciální vstupy a výstupy ==

Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.

'''Pouze pro SDS MICRO (LM) LIGHT:'''

sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)

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ší.

SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.

SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).

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'''.

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).

'''Pouze pro SDS MACRO ST:'''

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).

sys[671] 02 i R čtení stavu TL1
sys[672] 02 i R čtení stavu TL2

'''Pájecí plošky CFG:'''

Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.

V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.
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).
Takový firmware se teprve chystá (SDS TTCPRO).

sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)

== Speciální proměnné pro SDS-UPS ==

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 .

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í.

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).

sys[700] 02 i R reserved
sys[701] 02 i R reserved
sys[702] 02 i R reserved
sys[703] 02 i R reserved

'''Přepínač algoritmů:'''

sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C

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.

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.

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.

sys[705] až sys[731] reserved

Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.

Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.

'''Vstupy a konfigurace:'''

sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu

Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě.
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu.
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.).

sys[737] až sys[739] reserved

Následuje konfigurace provedená uživatelem ve webovém rozhraní.
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á.

sys[740] 02 i R primary voltage to say target is ok (pri_pvts)
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)
sys[748] 02 i R flag: do not switch accu off (aku_dach)

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.

sys[749] až sys[760] reserved

'''Výstupy:'''

Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !

sys[761] 02 i RW ovládání vypínání nabíječe
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)

sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)
!= 0 : zásah do zpětné vazby (posun rozsahu)
(vhodné pro skokové zvýšení výstupního napětí nabíječe,
když už nereaguje v původním rozsahu)

sys[763] 02 i RW ovládání odpojovače baterie
== 0 : spínač vypnutý (baterie odpojena od zátěže)
!= 0 : spínač sepnutý (baterie připojena)

sys[764] 02 i RW indikační LED - nabíjení akumulátoru
== 0 : LED svítí (informace: akumulátor je nabíjen)
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)

sys[765] 02 i RW indikační LED - výpadek primárního vstupu
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)

'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:

sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)
- minimální hodnota = 1
- maximální hodnota = 2497

sys[767] až sys[769] RESERVED vyhrazeno

Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':

sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx

sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx

sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx

Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):

UPS_PROVOZ_START 0
UPS_PROVOZ_PRIOK 1
UPS_PROVOZ_PRIOK_CHARGING 2
UPS_PROVOZ_ONLY_BATT 4
UPS_PROVOZ_NO_BATT 8

UPS_NABREZIM_CC 0
UPS_NABREZIM_CV 2
UPS_NABREZIM_PAUZA 4
UPS_NABREZIM_URCENI_REZIMU 8

UPS_BATERIE_ODHAD_NEZNAM 0
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1
UPS_BATERIE_ODHAD_OK_NABIJIM 2
UPS_BATERIE_ODHAD_PLNE_NABITO 4

== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==

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.
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.

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.

Změřená teplota je uložena na standardních indexech:

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 degC

Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):

sys[800] až sys[831]
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

sys[832] až sys[863]
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

SDS provádí přepočet na údaj RH v procentech (0 až 100):

sys[864] až sys[895]
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).

Rezerva (zatím nepoužito):

sys[896] až sys[899] RESERVED vyhrazeno

== Doplňující informace pro 1-Wire zařízení ==

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).

'''1-Wire chipy interně zpracovávané SDS'''

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.

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]'''.

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.

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ů.
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:

sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále až

sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):

sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále . . . až

sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.

Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.

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.

sys[931] až sys[939] reserved

'''Ostatní 1-Wire chipy'''

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.

Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci.
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.
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[]''',
nebo bude nastaven chybový kód.

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.
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).

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.

Obecný stav sběrnic:

sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů
:
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici

== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)

== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)

== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)

== 8 : byl přečten ROM CODE z připojeného ostatního chipu
(už lze také požádat o další nové čtení 1-W sběrnice)

== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici
(zkuste provést rescan/čtení znovu)

sys[942] až sys[949] reserved

'''Pro sběrnici [A]:'''

sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[951] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire
:
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)
sys[953] 06 i R romcode[1] (1-W: serial code)
sys[954] 06 i R romcode[2] (1-W: serial code)
sys[955] 06 i R romcode[3] (1-W: serial code)
sys[956] 06 i R romcode[4] (1-W: serial code)
sys[957] 06 i R romcode[5] (1-W: serial code)
sys[958] 06 i R romcode[6] (1-W: serial code)
sys[959] 06 i R romcode[7] (1-W: CRC byte)

sys[960] až sys[969] reserved

'''Pro sběrnici [B]:'''

sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[971] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire
:
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)
sys[973] 06 i R romcode[1] (1-W: serial code)
sys[974] 06 i R romcode[2] (1-W: serial code)
sys[975] 06 i R romcode[3] (1-W: serial code)
sys[976] 06 i R romcode[4] (1-W: serial code)
sys[977] 06 i R romcode[5] (1-W: serial code)
sys[978] 06 i R romcode[6] (1-W: serial code)
sys[979] 06 i R romcode[7] (1-W: CRC byte)

sys[980] až sys[989] reserved

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).

'''Pozor''':

Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy,
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ů).

== Reserved ==

sys[990] až sys[1023] reserved

== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==

'''Přímý přístup do LCD Frame Buffer paměti:'''

sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)

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).

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 !

Č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).

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.

'''Pozor''' SDS-MACRO-ST

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.

== Vyhrazená oblast ==

'''Zbytek:'''

sys[1552] až sys[1663] reserved

== Bateriově Zálohovaná Paměť ==

'''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!

Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější.

sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot
- každý index má k dispozici 32 bitů (tj. celý signed integer)
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")

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).

''(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).

== Další informace ze S0 vstupů ==

Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.

Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:

sys[1792] až sys[1823]
07 i R cena za jednotku v režimu T0
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1824] až sys[1855]
07 i R cena za jednotku v režimu T1
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1856] až sys[1887]
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")
- text

sys[1888] až sys[1919]
07 s R název měny, podle nastavení (např. text "CZK")
- text

sys[1920] až sys[1951]
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")
- text

sys[1952] až sys[1983]
07 s R název činnosti, podle nastavení (např. text "spotřeba")
- text

sys[1984] až sys[2015]
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")
- text

sys[2016] až sys[2047]
07 i R konfigurační detaily pro daný S0 vstup
- bit 0 nastaven = je to aktivní S0 vstup
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)

Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.

== Reserved ==

sys[2048] až sys[2198] reserved

== MQTT klient ==

Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:

sys[2199] 09 i R podpora MQTT
0 = NE
1 = ANO, verze MQTT 3.1.1, SDS první část implementace
2..max = (reserved)

Každé nové připojení k Brokeru:

sys[2200] 09 i R stav průběhu mqtt_connect()
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno a odeslán CONNECT požadavek
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )
8 = probíhá odpojování, čekáme na výsledek (na odpojení)

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.

sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"
-7 = nepoužito
-6 = timeout při čekání na CONNACK, nepřipojeno
-5 = nepoužito
-4 = nepoužito
-3 = nepoužito
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)
-1 = idle, nepřipojeno
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)
1 = MQTT 0x01: Connection Refused, unacceptable protocol version
2 = MQTT 0x02: Connection Refused, identifier rejected
3 = MQTT 0x03: Connection Refused, Server unavailable
4 = MQTT 0x04: Connection Refused, bad user name or password
5 = MQTT 0x05: Connection Refused, not authorized

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).

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:

sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu
-4 = nespravne parametry (počet parametrů)
-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
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity
0 = nepoužito
1 = mqtt_publish() probíhá
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci
4 = mqtt_subscribe() probíhá - čekám na SUBACK
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce

Informativní položka:

sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru
(objeví-li se chyba, dojde k okamžitému odpojení)

Nastavení (položka 2198 je k dispzoici až od FW 11/2025):

sys[2198] 09 i R mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN )
sys[2198] 09 i W write ( default: 0b00110001 )

Zatím nepoužité pozice:

sys[2204] až sys[2208] reserved

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)

sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)

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.

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 !

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)

Jednotlivé položky v tabulce příchozích zpráv:

sys[2211] až sys[2241]
09 s R název položky (Topic Name) pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2242] až sys[2249] reserved

sys[2251] až sys[2281]
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2282] až sys[2289] reserved

sys[2291] až sys[2321]
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru
(pro detekci změny - příchozí zprávy z Brokeru)
0 = zatím nic nepřišlo
1..MAX = hodnota uptime v okamžiku poslední změny

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.

== Reserved ==

sys[2322] až sys[2398] reserved

== MODBUS-TCP klient ==

Ověření FW v SDS:

sys[2399] 09 i R podpora pro MODBUS TCP
0 = NE
1 = ANO (první verze implementace v SDS)

Každé nové TCP spojení na server:

sys[2400] 09 i R stav průběhu modbus_tcp_connect()
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno, můžete komunikovat

MODBUS funkce - každá má svůj nezávislý stavový údaj:

sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
pro všechny tyto stavy platí následující hodnoty:
-6 = timeout (neprovedeno), můžete volat další funkci
-5 = nespravne parametry (hodnoty), můžete volat další funkci
-4 = nespravne parametry (počet parametrů), můžete volat další funkci
-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
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity, lze volat funkci
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci
256 = pracuji, čekejte na aktualizovanou hodnotu

sys[2417] až sys[2462] reserved

sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy

sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy

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).

sys[2465] 09 i R timestamp poslední přijaté zprávy
(vhodné pro detekci nové přijaté zprávy)

sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu
(počet celých položek)

sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])
(MODBUS způsob číslování položek - adresa 1..n)

sys[2470] až sys[2719]
09 i R přijaté hodnoty pro poslední přijatou zprávu
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr

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.

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.

Rezerva

sys[2715] až sys[2809] reserved

== Statistiky COMx ==

COM1:

sys[2810] 09 i R reserved

sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1

sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1

sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1

sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1

Rezerva

sys[2817] až sys[2860] reserved

COM6:

sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6

sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6

sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6

sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6

Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).

== Konec dokumentu ==

'''Konec dokumentu.'''

SDS-C: sdsc sysp

2025-11-15T11:11:23Z

Adamn:

Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS.
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).

== Definice systémových proměnných SDS-C : pole sys[] ==

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é).

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.

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í).

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í).

''Legenda k tabulce:''

Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).

Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.

Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW''').

Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.
'''Význam hodnot:'''
* '''01''' - první verze, výchozí firmware ze začátku roku 2010
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější

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.

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í.

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.

'''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.

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.

'''Důležité upozornění'''

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).

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.

''Příklad:''
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.
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.

<pre>
skutečná binární hodnota | 32-bit signed | 32-bit unsigned
(32-bit) | SDS-C integer | (internal SDS)
----------------------------------+---------------+-----------------
00000000000000000000000000000000 | 0 | 0
00000000000000000000000000000001 | 1 | 1
00000000000000001111111111111111 | 65535 | 65535
01111111111111111111111111111111 | 2147483647 | 2147483647
10000000000000000000000000000000 | -2147483648 | 2147483648
10000000000000000000000000000001 | -2147483647 | 2147483649
10000000000000001111111111111111 | -2147418113 | 2147549183
11111111111111111111111111111111 | -1 | 4294967295
11111111111111111111111111111110 | -2 | 4294967294
11111111111111111111111111111101 | -3 | 4294967293
</pre>

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á).

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é.

V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''

'''Použítí v SDS-C programu'''

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.

Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)?
<syntaxhighlight lang="c">
teplota0_ve_stupnich_C = sys[310] / 100;
</syntaxhighlight>

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:
<syntaxhighlight lang="c">
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };
</syntaxhighlight>

Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):
<syntaxhighlight lang="c">
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)
</syntaxhighlight>

Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:
<syntaxhighlight lang="c">
#define RELE1 sys[231]

#define TEPLOTA sys[310]

// ...

RELE1 = 255;

if (TEPLOTA > 3200) goto x;
</syntaxhighlight>

== Pole ram[] ==

Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).

Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.

Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).

Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:
<syntaxhighlight lang="c">
hodnota = ram[10];

index = 23;
ram[index] = 15 * 2;

index = sys[1023];
ram[index] = 30;
</syntaxhighlight>

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í.

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).

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.

== Ukládání trvalých dat ==

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[].

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í.

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).

Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].

Další možnost:<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).

== Pole text[] ==

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).

Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].

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.

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).

== Pole share[] ==

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é]]).

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.

== Vyhrazené funkce ==

Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].

== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==

'''STAV SYSTÉMU'''

sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program

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é)

sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci

sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)
- počítá se od nuly (0) od každého zapnutí zařízení
- pouze 31 bitové počítadlo
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času

sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně,
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)

sys[5] 01 i R rozpad LOCAL času: den (1 až 31)
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)

'''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.

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).

== Ethernet, Internet ==

sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)
sys[13] 01 i R IP[1] adresa zařízení
sys[14] 01 i R IP[2] adresa zařízení
sys[15] 01 i R IP[3] adresa zařízení

sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)
sys[17] 01 i R GW_IP[1] adresa brány
sys[18] 01 i R GW_IP[2] adresa brány
sys[19] 01 i R GW_IP[3] adresa brány

sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)
sys[21] 01 i R NETMASK[1] síťová maska
sys[22] 01 i R NETMASK[2] síťová maska
sys[23] 01 i R NETMASK[3] síťová maska

sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)
!= 0 : Ethernetová komunikace je funkční (LINK OK)

sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)
== 0 : neznámá rychlost (není k dispozici Ethernet)
== 10 : 10 MBit per sec
== 100 : 100 MBit per sec

sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti
(po resetu zařízení se vráti na poslední uloženou hodnotu)

sys[27] 06 i R platnost přidělené IP adresy zařízení SDS
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet

sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik

sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)
== 1 : odesláno DHCP DISCOVER
== 2 : obdrženo DHCP OFFER
== 3 : odesláno DHCP REQUEST
== 4 : obdrženo DHCP ACK
== 5 : IP adresa je přidělena (BOUND)
== 6,7,8,9,10,11 : zpracování DHCP RENEW

sys[30] 06 i R aktuální hodnota "DHCP Lease Time"
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)
- údaj je uveden v jednotkách [sec]

sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)
sys[32] 04 i R MAC[1]
sys[33] 04 i R MAC[2]
sys[34] 04 i R MAC[3]
sys[35] 04 i R MAC[4]
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)

sys[37] 06 i R NTP Client Status (synchronizace času)
== 0 : nesynchronizováno
== 1 : úspěšně přijal paket od NTP Serveru
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz
(dotaz se odešle za 10sec od takovéhoto zápisu)

sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)
- není zde aplikován offset, ani automatika letního času
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď),
uvnitř SDS je sice udržována jako 32bit,
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).

sys[39] 07 i R stav automatiky přepínání Letního Času
== 0 : automatika zakázána, lokální čas není ovlivněn
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).
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)
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í
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

sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)

sys[139] 09 i R vyhrazeno

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í).

sys[40] až sys[44] RESERVED vyhrazeno

== Provozní údaje ==

sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)
- po resetu zařízení začíná vždy počítat od nuly
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!
- pro sys[45] je k dispozici 31 bitů,
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).

sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),
význam hodnot závisí na typu konkrétního zařízení SDS.
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.

SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM):
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]

SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST:
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]

Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.

sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu
(při přetečení 2^31 počítá opět od nuly, pořád dokola)

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).
Tento index vyžaduje aktuální FW (11/2022 nebo novější).

== Rozhraní sériové komunikace ==

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.

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ě.

Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše.
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í.

Rozhraní COM1:

sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici),
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není !
(Toto může způsobit nezkušenému programátorovi potíže).
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné,
a s tou pak dále dle libosti pracovat.
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!

sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?
== 0 : není připojen klient
!= 0 : je připojen klient (přes TELNET port)
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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í).

Rozhraní COM6:

sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

sys[57] 02 i R rychlost [bps] rozhraní UART - COM6
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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.

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).

== Generátor náhodných čísel ==

sys[61] 06 i R generátor náhodných čísel
- při každém přečtení sys[61] je poskytnuto náhodné číslo

== Výsledek převodu textu na číslo ==

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]''.

sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''

Pro více informací se podívejte přímo na návod k této funkci.

== Nastavení rychlosti provádění SDS-C programu ==

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čí.

sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku)
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )

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).

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.

== Časování ==

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:

sys[64] 01 i RW sekundový odpočítávač
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1,
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)

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.

== OSI7 funkce ==

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).

Všechny funkce OSI7 poskytují průběžný stav své činnosti:
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)
- význam hodnot viz [[OSI7_status_code|popis zde]]

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.

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.
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''

Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru

sys[74] 01 s R text, reserved (v této verzi nepoužito)

Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):

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)
sys[303] 09 i W DNS RESOLV - write value 0xD65 (3429dec) to clear the DNS cache
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)
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)
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)

HTTP GET:

sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)
- nastaveno po dokončení práce funkce '''http_get()'''
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.

sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.

sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu.
Nastavte na:

== 0 : jakékoliv přijaté data jsou '''zahozena''',
neuloží se (nedojde ke změně obsahu ram[] nebo text[])

== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole ram[] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !

sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])
- maximální hodnota je omezena velikostí pole ram[] nebo text[]
- pozor! pokud zapíšete '''0''', budou všechna data zahozena,
ale i v takovém případě dojde k přepisu ram[0] (viz výše)

sys[79] až sys[80] RESERVED vyhrazeno

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.

Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru

sys[85] až sys[88] RESERVED vyhrazeno

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()" ) :

sys[89] 06 i R IP-Watchdog: stav
== 0 : není v provozu (neaktivováno ve webovém rozhraní)
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)

sys[90] 06 i R IP-Watchdog: poslední známé RTT
== 0 .. 65533 : hodnota RTT v msec
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)

sys[91] 06 i R IP-Watchdog: stav výstupu
== 0 : výstup není aktivován
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)

Informace z (SDC-C) ICMP PING funkce - '''ping()''' :

sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92]
== 0 : klid (není odeslán paket, nečekám na odpověď),
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle
== 1 : funkce '''ping()''' byla právě zavolána,
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání
== 2 : čeká se na odpověď od ARP
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket,
protože v ARP tabulce nebyl příslušný záznam)
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY
(požadovaný stav, funkce '''ping()''' funguje ok)
== 8 : právě obdržel ECHO REPLY
(byla přijata odpověď od vzdáleného zařízení)

sys[93] 04 i R PING SEQ number
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE
na ICMP PING REQUEST odeslaný funkcí '''ping()'''

sys[94] 04 i R Round Trip Time, v milisekundách
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''
- č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)

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'''" .

Funkce '''send_udp()''':

sys[95] 06 i R výsledek posledního volání '''send_udp()'''
Hodnoty:
== 0 : nic neprovedeno
Hodnota '''0''' je nastavena po startu SDS-C programu
== 1 : právě bylo zahájeno odesílání paketu (provádí se)
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.
== 2 : byl odeslán UDP paket, úspěšně
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz
== 4 : zavolali jste funkci '''send_udp()''' dříve,
než byla dokočena činnost předchozího požadavku
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)

Funkce '''snmp_send_trap()''':

sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''
Hodnoty:
== 0 : odesílání neprobíhá
== 1 : probíhá odesílání, výsledek ještě není znám
== 2 : odeslání se povedlo
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)

sys[97] RESERVED vyhrazeno

== Zápis textu do pole, Porovnání textů ==

Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.

sys[98] i R společné využití viz (1) a (2)

06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'',
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:
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''
- kam byla zapsána terminační 0x00 funkcí '''itoh()'''
- kam byla zapsána terminační 0x00 funkcí '''itoa()'''

08 i R (2) výsledek porovnání textů
- hodnota výsledku zavolání funkce '''textcmp()'''
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci
X == 0 : oba texty jsou identické
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''

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.

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[]'').

== Uživatelské pozice v pevné paměti ==

sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]

sys[100] až sys[115]
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti

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[]'').

''' Reserved '''

sys[116] až sys[136] RESERVED vyhrazeno

== Proměnné nastavitelné uživatelem z webového rozhraní ==

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.

sys[140] až sys[149]
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)
(vždy 32-bit signed integer)

sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu
Nastavení:
== 0 : stránka "control" je přístupná bez hesla,
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)

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).

Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.

Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).

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í.

== Proměnné vstupů a výstupů pro všechny výrobky SDS ==

'''POZOR'''

'''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.

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í).

'''Pokračování výpisu:'''

sys[151] až sys[182]
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu
Hodnoty:
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)

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.

'''Důležité info:'''

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).

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.

== Stav SDS-C programu ==

Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).

sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)

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.

Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:

sys[184] 08 i RW způsob spuštění SDS-C programu
== 0 : bez informace
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace

Stav SDS-C watchdogu:

sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec
== -1 : wdg není aktivní
== 0 : odpočet vypršel, dojde k resetu SDS-C programu
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)

== Pulse-Width Modulation výstupy ==

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).

''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.
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).
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.
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).
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]).

Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !

Pozor, pro tyto typy SDS:

SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO'''

Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).

Podle typu SDS:

SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)

sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)

sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).

sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]
- tato hodnota není aktualizována vůči sys[192], ani není archivována
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.

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.

Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.

SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)

sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)

sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)

sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)

sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[187] 09 i RW duty-cycle '''PWM3''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)

sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[189] 09 i RW duty-cycle '''PWM4''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)

sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.

== Ovládání výstupů - Relé ==

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é.

sys[196] až sys[228]
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''
- lze nastavit i z webového rozhraní
Hodnoty:
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)

sys[229] až sys[230] RESERVED vyhrazeno

sys[231] až sys[262]
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)
Hodnoty:
== 0 : relé není aktivní
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)
!= 0 : relé je aktivní
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)

sys[263] až sys[265] RESERVED vyhrazeno

sys[266] až sys[298]
01 s R uživatelský textový název pro '''RE1''' až '''RE32'''
- nastaveno ve webovém rozhraní

sys[264] až sys[300] RESERVED vyhrazeno

== Ovládání PDx ==

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.

Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):

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)
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)
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)
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
SDS '''IO6-ST''': nepoužito
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

Řízení směru pro jednotlivé PDx resp. TOPB:

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)
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)
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)
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
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

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í.

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.

MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).

sys[306] až sys[309] RESERVED vyhrazeno

== Tlačítka na desce display pro SDS-MACRO-ST ==

Č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).

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.

== Vstupy - teploměry na externí sběrnici 1-Wire® ==

Č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.

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici

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)'''.

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'''.

sys[342] až [345] RESERVED vyhrazeno

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)
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''

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)
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''

sys[350] až sys[381]
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)

sys[382] až [389] RESERVED vyhrazeno

sys[391] až sys[422]
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)

''' Reserved '''

sys[423] až sys[430] RESERVED vyhrazeno

== Vstupy: analogové vstupy pro měření napětí ==

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.

sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4

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.

Rozsah hodnoty RAW je:
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)

Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):

sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[436] 01 i R Div pro A/D 1
sys[437] 01 s R textový název A/D 1
sys[438] 01 s R jednotka A/D 1

sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[440] 01 i R Div pro A/D 2
sys[441] 01 s R textový název A/D 2
sys[442] 01 s R jednotka A/D 2

sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[444] 01 i R Div pro A/D 3
sys[445] 01 s R textový název A/D 3
sys[446] 01 s R jednotka A/D 3

sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[448] 01 i R Div pro A/D 4
sys[449] 01 s R textový název A/D 4
sys[450] 01 s R jednotka A/D 4

'''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) !
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".

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).

''' Reserved '''

sys[451] až sys[458] RESERVED vyhrazeno

== Proměnné pro S0 impulsní vstup ==

sys[459] 01 i RW stav tarifu
== 0 : T0 (vysoký tarif)
== 1 : T1 (nízký tarif)

sys[460] až sys[492]
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty,
pak sem v takovém případě nastavte číslo 1
- platné hodnoty: 1 až 65280 (včetně)

sys[493] až sys[525]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[526] až sys[558]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[559] až sys[591]
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).

sys[592] až sys[624]
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)
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

sys[625] až sys[657]
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"
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

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.

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.

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é.

sys[658] až sys[670] reserved for future use

poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).

== Speciální vstupy a výstupy ==

Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.

'''Pouze pro SDS MICRO (LM) LIGHT:'''

sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)

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ší.

SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.

SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).

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'''.

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).

'''Pouze pro SDS MACRO ST:'''

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).

sys[671] 02 i R čtení stavu TL1
sys[672] 02 i R čtení stavu TL2

'''Pájecí plošky CFG:'''

Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.

V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.
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).
Takový firmware se teprve chystá (SDS TTCPRO).

sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)

== Speciální proměnné pro SDS-UPS ==

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 .

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í.

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).

sys[700] 02 i R reserved
sys[701] 02 i R reserved
sys[702] 02 i R reserved
sys[703] 02 i R reserved

'''Přepínač algoritmů:'''

sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C

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.

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.

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.

sys[705] až sys[731] reserved

Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.

Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.

'''Vstupy a konfigurace:'''

sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu

Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě.
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu.
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.).

sys[737] až sys[739] reserved

Následuje konfigurace provedená uživatelem ve webovém rozhraní.
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á.

sys[740] 02 i R primary voltage to say target is ok (pri_pvts)
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)
sys[748] 02 i R flag: do not switch accu off (aku_dach)

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.

sys[749] až sys[760] reserved

'''Výstupy:'''

Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !

sys[761] 02 i RW ovládání vypínání nabíječe
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)

sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)
!= 0 : zásah do zpětné vazby (posun rozsahu)
(vhodné pro skokové zvýšení výstupního napětí nabíječe,
když už nereaguje v původním rozsahu)

sys[763] 02 i RW ovládání odpojovače baterie
== 0 : spínač vypnutý (baterie odpojena od zátěže)
!= 0 : spínač sepnutý (baterie připojena)

sys[764] 02 i RW indikační LED - nabíjení akumulátoru
== 0 : LED svítí (informace: akumulátor je nabíjen)
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)

sys[765] 02 i RW indikační LED - výpadek primárního vstupu
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)

'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:

sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)
- minimální hodnota = 1
- maximální hodnota = 2497

sys[767] až sys[769] RESERVED vyhrazeno

Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':

sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx

sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx

sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx

Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):

UPS_PROVOZ_START 0
UPS_PROVOZ_PRIOK 1
UPS_PROVOZ_PRIOK_CHARGING 2
UPS_PROVOZ_ONLY_BATT 4
UPS_PROVOZ_NO_BATT 8

UPS_NABREZIM_CC 0
UPS_NABREZIM_CV 2
UPS_NABREZIM_PAUZA 4
UPS_NABREZIM_URCENI_REZIMU 8

UPS_BATERIE_ODHAD_NEZNAM 0
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1
UPS_BATERIE_ODHAD_OK_NABIJIM 2
UPS_BATERIE_ODHAD_PLNE_NABITO 4

== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==

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.
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.

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.

Změřená teplota je uložena na standardních indexech:

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 degC

Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):

sys[800] až sys[831]
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

sys[832] až sys[863]
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

SDS provádí přepočet na údaj RH v procentech (0 až 100):

sys[864] až sys[895]
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).

Rezerva (zatím nepoužito):

sys[896] až sys[899] RESERVED vyhrazeno

== Doplňující informace pro 1-Wire zařízení ==

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).

'''1-Wire chipy interně zpracovávané SDS'''

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.

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]'''.

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.

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ů.
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:

sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále až

sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):

sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále . . . až

sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.

Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.

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.

sys[931] až sys[939] reserved

'''Ostatní 1-Wire chipy'''

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.

Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci.
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.
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[]''',
nebo bude nastaven chybový kód.

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.
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).

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.

Obecný stav sběrnic:

sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů
:
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici

== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)

== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)

== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)

== 8 : byl přečten ROM CODE z připojeného ostatního chipu
(už lze také požádat o další nové čtení 1-W sběrnice)

== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici
(zkuste provést rescan/čtení znovu)

sys[942] až sys[949] reserved

'''Pro sběrnici [A]:'''

sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[951] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire
:
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)
sys[953] 06 i R romcode[1] (1-W: serial code)
sys[954] 06 i R romcode[2] (1-W: serial code)
sys[955] 06 i R romcode[3] (1-W: serial code)
sys[956] 06 i R romcode[4] (1-W: serial code)
sys[957] 06 i R romcode[5] (1-W: serial code)
sys[958] 06 i R romcode[6] (1-W: serial code)
sys[959] 06 i R romcode[7] (1-W: CRC byte)

sys[960] až sys[969] reserved

'''Pro sběrnici [B]:'''

sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[971] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire
:
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)
sys[973] 06 i R romcode[1] (1-W: serial code)
sys[974] 06 i R romcode[2] (1-W: serial code)
sys[975] 06 i R romcode[3] (1-W: serial code)
sys[976] 06 i R romcode[4] (1-W: serial code)
sys[977] 06 i R romcode[5] (1-W: serial code)
sys[978] 06 i R romcode[6] (1-W: serial code)
sys[979] 06 i R romcode[7] (1-W: CRC byte)

sys[980] až sys[989] reserved

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).

'''Pozor''':

Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy,
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ů).

== Reserved ==

sys[990] až sys[1023] reserved

== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==

'''Přímý přístup do LCD Frame Buffer paměti:'''

sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)

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).

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 !

Č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).

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.

'''Pozor''' SDS-MACRO-ST

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.

== Vyhrazená oblast ==

'''Zbytek:'''

sys[1552] až sys[1663] reserved

== Bateriově Zálohovaná Paměť ==

'''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!

Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější.

sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot
- každý index má k dispozici 32 bitů (tj. celý signed integer)
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")

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).

''(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).

== Další informace ze S0 vstupů ==

Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.

Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:

sys[1792] až sys[1823]
07 i R cena za jednotku v režimu T0
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1824] až sys[1855]
07 i R cena za jednotku v režimu T1
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1856] až sys[1887]
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")
- text

sys[1888] až sys[1919]
07 s R název měny, podle nastavení (např. text "CZK")
- text

sys[1920] až sys[1951]
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")
- text

sys[1952] až sys[1983]
07 s R název činnosti, podle nastavení (např. text "spotřeba")
- text

sys[1984] až sys[2015]
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")
- text

sys[2016] až sys[2047]
07 i R konfigurační detaily pro daný S0 vstup
- bit 0 nastaven = je to aktivní S0 vstup
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)

Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.

== Reserved ==

sys[2048] až sys[2198] reserved

== MQTT klient ==

Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:

sys[2199] 09 i R podpora MQTT
0 = NE
1 = ANO, verze MQTT 3.1.1, SDS první část implementace
2..max = (reserved)

Každé nové připojení k Brokeru:

sys[2200] 09 i R stav průběhu mqtt_connect()
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno a odeslán CONNECT požadavek
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )
8 = probíhá odpojování, čekáme na výsledek (na odpojení)

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.

sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"
-7 = nepoužito
-6 = timeout při čekání na CONNACK, nepřipojeno
-5 = nepoužito
-4 = nepoužito
-3 = nepoužito
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)
-1 = idle, nepřipojeno
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)
1 = MQTT 0x01: Connection Refused, unacceptable protocol version
2 = MQTT 0x02: Connection Refused, identifier rejected
3 = MQTT 0x03: Connection Refused, Server unavailable
4 = MQTT 0x04: Connection Refused, bad user name or password
5 = MQTT 0x05: Connection Refused, not authorized

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).

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:

sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu
-4 = nespravne parametry (počet parametrů)
-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
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity
0 = nepoužito
1 = mqtt_publish() probíhá
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci
4 = mqtt_subscribe() probíhá - čekám na SUBACK
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce

Informativní položka:

sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru
(objeví-li se chyba, dojde k okamžitému odpojení)

Zatím nepoužité pozice:

sys[2204] až sys[2208] reserved

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)

sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)

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.

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 !

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)

Jednotlivé položky v tabulce příchozích zpráv:

sys[2211] až sys[2241]
09 s R název položky (Topic Name) pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2242] až sys[2249] reserved

sys[2251] až sys[2281]
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2282] až sys[2289] reserved

sys[2291] až sys[2321]
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru
(pro detekci změny - příchozí zprávy z Brokeru)
0 = zatím nic nepřišlo
1..MAX = hodnota uptime v okamžiku poslední změny

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.

== Reserved ==

sys[2322] až sys[2398] reserved

== MODBUS-TCP klient ==

Ověření FW v SDS:

sys[2399] 09 i R podpora pro MODBUS TCP
0 = NE
1 = ANO (první verze implementace v SDS)

Každé nové TCP spojení na server:

sys[2400] 09 i R stav průběhu modbus_tcp_connect()
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno, můžete komunikovat

MODBUS funkce - každá má svůj nezávislý stavový údaj:

sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
pro všechny tyto stavy platí následující hodnoty:
-6 = timeout (neprovedeno), můžete volat další funkci
-5 = nespravne parametry (hodnoty), můžete volat další funkci
-4 = nespravne parametry (počet parametrů), můžete volat další funkci
-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
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity, lze volat funkci
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci
256 = pracuji, čekejte na aktualizovanou hodnotu

sys[2417] až sys[2462] reserved

sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy

sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy

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).

sys[2465] 09 i R timestamp poslední přijaté zprávy
(vhodné pro detekci nové přijaté zprávy)

sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu
(počet celých položek)

sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])
(MODBUS způsob číslování položek - adresa 1..n)

sys[2470] až sys[2719]
09 i R přijaté hodnoty pro poslední přijatou zprávu
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr

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.

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.

Rezerva

sys[2715] až sys[2809] reserved

== Statistiky COMx ==

COM1:

sys[2810] 09 i R reserved

sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1

sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1

sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1

sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1

Rezerva

sys[2817] až sys[2860] reserved

COM6:

sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6

sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6

sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6

sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6

Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).

== Konec dokumentu ==

'''Konec dokumentu.'''

SDS-C: sdsc sysp

2025-11-15T11:06:13Z

Adamn:

Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS.
Zařízení Druhé Produktové Řady používají jazyk FULL-C (jiná část této Wiki).

== Definice systémových proměnných SDS-C : pole sys[] ==

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é).

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.

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í).

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í).

''Legenda k tabulce:''

Proměnná typu '''i''' je 32-bit signed integer (nejvyšší bit je znaménko, a zbývajících 31 bitů je číselná hodnota).

Proměnná typu '''s''' je soubor znaků (string) - tj. '''text''' (řetězec znaků) - a tyto proměnné '''lze použít jen pro čtení'''.

Některé proměnné lze jen číst ('''R'''), do některých lze kromě čtení i zapisovat ('''RW''').

Údaj '''XX''' v seznamu proměnných udává verzi firmware, kdy byla daná proměnná zavedena.
'''Význam hodnot:'''
* '''01''' - první verze, výchozí firmware ze začátku roku 2010
* '''02''' - druhá verze, bylo vydáno na přelomu roku 2010 a 2011
* '''03''' - třetí verze, tj. pouze pro firmware od 03.2011
* '''04''' - čtvrtá verze, tj. pouze pro firmware od 06.2011 a novější
* '''05''' - pátá verze, tj. pouze pro firmware od 11.2011 a novější
* '''06''' - šestá verze, tj. pouze pro firmware od 03.2012 a novější
* '''07''' - sedmá verze, tj. pouze pro firmware od 07.2017 a novější
* '''08''' - osmá verze, tj. pouze pro firmware od 12.2018 a novější
* '''09''' - devátá verze, tj. pouze pro firmware od 06.2020 a novější

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.

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í.

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.

'''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.

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.

'''Důležité upozornění'''

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).

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.

''Příklad:''
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.
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.

<pre>
skutečná binární hodnota | 32-bit signed | 32-bit unsigned
(32-bit) | SDS-C integer | (internal SDS)
----------------------------------+---------------+-----------------
00000000000000000000000000000000 | 0 | 0
00000000000000000000000000000001 | 1 | 1
00000000000000001111111111111111 | 65535 | 65535
01111111111111111111111111111111 | 2147483647 | 2147483647
10000000000000000000000000000000 | -2147483648 | 2147483648
10000000000000000000000000000001 | -2147483647 | 2147483649
10000000000000001111111111111111 | -2147418113 | 2147549183
11111111111111111111111111111111 | -1 | 4294967295
11111111111111111111111111111110 | -2 | 4294967294
11111111111111111111111111111101 | -3 | 4294967293
</pre>

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á).

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é.

V tabulce jsou konkrétní "sys[]" položky, kterých se toto týká, označeny tímto symbolem: '''(!)'''

'''Použítí v SDS-C programu'''

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.

Příklad zápisu v programu: jaká je teplota na čidle 1 (celé stupně Celsia)?
<syntaxhighlight lang="c">
teplota0_ve_stupnich_C = sys[310] / 100;
</syntaxhighlight>

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:
<syntaxhighlight lang="c">
if (sys[310] > sys[311]) { echo('Prvni cidlo je teplejsi nez druhe.'); };
</syntaxhighlight>

Příklad zápisu v programu: jak zapnu relé RE1? (musíte vědět "co" "kam" zapsat):
<syntaxhighlight lang="c">
sys[231] = 255; // v tomto okamžiku dojde k ovládnutí relé č. 1 (- viz index 231 dole v seznamu)
</syntaxhighlight>

Můžete (od 03 verze SDS-C) použít i ''#define'', příklad:
<syntaxhighlight lang="c">
#define RELE1 sys[231]

#define TEPLOTA sys[310]

// ...

RELE1 = 255;

if (TEPLOTA > 3200) goto x;
</syntaxhighlight>

== Pole ram[] ==

Pole '''ram[]''' je samostatné nezávislé pole, dostupné pro SDS-C program od verze č. 03 (a výše).

Obsah pole ram[] je uložen samostatně v RAM paměti, a je při resetu zařízení ztracen.

Obsah pole ram[] se nekryje s dalšími proměnnými programu a tak dále (je to zcela samostatné paměťové pole).

Pole ram[] lze indexovat číslem nebo proměnnou. Příkladem:
<syntaxhighlight lang="c">
hodnota = ram[10];

index = 23;
ram[index] = 15 * 2;

index = sys[1023];
ram[index] = 30;
</syntaxhighlight>

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í.

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).

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.

== Ukládání trvalých dat ==

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[].

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í.

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).

Více informací, způsob použití a důležité varování je uvedeno na [[SDS-C: DataFlash|stránce ohledně DataFlash]].

Další možnost:<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).

== Pole text[] ==

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).

Za tímto účelem je připraveno pole '''text[]'''. Detailní popis je [[SDS-C:_popis_jazyka#Pole_text.5B.5D|zde]].

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.

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).

== Pole share[] ==

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é]]).

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.

== Vyhrazené funkce ==

Seznam konkrétních zabudovaných '''funkcí''' naleznete na [[SDS-C: sdsc sysf|jiné stránce]].

== Jednotné proměnné (pole sys[]) pro všechny výrobky řady SDS ==

'''STAV SYSTÉMU'''

sys[0] 01 i R "pair code" firmware (nastaven výrobcem napevno: identifikátor vázanosti firmware na hardware)
- lze využít pro rozeznání typu zařízení SDS, na kterém je spuštěn SDS-C program

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é)

sys[2] 01 s R text SNMP-sysLocation, nastaveno ve webové administraci

sys[3] 01 i R hodnota '''UpTime10''' (doba běhu zařízení)
- počítá se od nuly (0) od každého zapnutí zařízení
- pouze 31 bitové počítadlo
(SDS si pro sebe interně počítá UpTime10 jako 32bit, nicméně
nejvyšší bit je odmaskován před předáním hodnoty do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)
- po překročení 2147483647 (zde odpovídá up-time 248 dnů) začíná hodnota opět na nule
- jeden krok (zvýšení o jedničku) této hodnoty UpTime10 odpovídá právě '''10 msec''' uplynulému času

sys[4] 01 i R hodnota '''LOCAL''' času (UNIX čas, v sekundách)
- jedná se o lokální (eventuálně posunutý) čas, synchronizovaný se NTP serverem
- je zde už předem započítán GMT offset sys[26] (ten lze nastavit ve webovém rozhraní)
- je zde aplikován automatický posun letního času (je-li to povoleno ve webovém rozhraní)
- poskytnuto je pouze 31 bitové číslo (bude platné až do 19. leden 2038 včetně,
pak hodnota roluje na nulu - nejvyšší bit je odmaskován před předáním do SDS-C programu)
- platné hodnoty: 0 až 2147483647 (včetně)

sys[5] 01 i R rozpad LOCAL času: den (1 až 31)
sys[6] 01 i R rozpad LOCAL času: měsíc (1 až 12)
sys[7] 01 i R rozpad LOCAL času: rok (2011 a dále)
sys[8] 01 i R rozpad LOCAL času: hodina (0 až 23)
sys[9] 01 i R rozpad LOCAL času: minuta (0 až 59)
sys[10] 01 i R rozpad LOCAL času: sekunda (0 až 59)
sys[11] 01 i R rozpad LOCAL času: číslo dne v týdnu - počet dní od Neděle (0 až 6)

'''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.

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).

== Ethernet, Internet ==

sys[12] 01 i R IP[0] adresa zařízení (nastaveno ve webové administraci)
sys[13] 01 i R IP[1] adresa zařízení
sys[14] 01 i R IP[2] adresa zařízení
sys[15] 01 i R IP[3] adresa zařízení

sys[16] 01 i R GW_IP[0] adresa brány (nastaveno ve webové administraci)
sys[17] 01 i R GW_IP[1] adresa brány
sys[18] 01 i R GW_IP[2] adresa brány
sys[19] 01 i R GW_IP[3] adresa brány

sys[20] 01 i R NETMASK[0] síťová maska (nastaveno ve webové administraci)
sys[21] 01 i R NETMASK[1] síťová maska
sys[22] 01 i R NETMASK[2] síťová maska
sys[23] 01 i R NETMASK[3] síťová maska

sys[24] 01 i R stav rozhraní Ethernet (je spuštěno?)
== 0 : komunikace přes Ethernet není k dispozici (odpojený kabel, vypnutá protistrana nebo switch, atd.)
!= 0 : Ethernetová komunikace je funkční (LINK OK)

sys[25] 01 i R rychlost připojení k síti Ethernet (hodnoty: 0, 10, 100)
== 0 : neznámá rychlost (není k dispozici Ethernet)
== 10 : 10 MBit per sec
== 100 : 100 MBit per sec

sys[26] 04 i RW hodnota GMT offsetu pro NTP (nastaveno v administraci ve webovém rozhraní)
- platné hodnoty: -11 až 11 (včetně) (údaj v hodinách)
- zápis je možný, ale změněná hodnota (ze SDS-C) není uložena do pevné paměti
(po resetu zařízení se vráti na poslední uloženou hodnotu)

sys[27] 06 i R platnost přidělené IP adresy zařízení SDS
== 0 : zařízení SDS nemá přidělenou platnou IP adresu (typický důvod: čeká se na DHCP)
!= 0 : zařízení SDS má přidělenou platnou IP adresu a může komunikovat přes Ethernet

sys[28] 06 i R poslední okamžik kdy byla změněna IP adresa,
buď ručně z webového rozhraní (administrace) nebo DHCP serverem (je-li DHCP zapnuto)
- údaj odpovídá stavu UpTime10 (1 krok = 10 msec) v daný okamžik

sys[29] 06 i R DHCP: stav (lze použít pro kontrolu správné funkce DHCP klienta v SDS)
== 0 : v klidu (nic se neprovádí, nebo DHCP je vypnuté)
== 1 : odesláno DHCP DISCOVER
== 2 : obdrženo DHCP OFFER
== 3 : odesláno DHCP REQUEST
== 4 : obdrženo DHCP ACK
== 5 : IP adresa je přidělena (BOUND)
== 6,7,8,9,10,11 : zpracování DHCP RENEW

sys[30] 06 i R aktuální hodnota "DHCP Lease Time"
- hodnota je nastavena v okamžiku DHCP BOUND (při přidělení (nové) IP adresy)
- hodnota je každou 1 sec snížena o jednotku (když dojde na nulu, klient začne obnovovat IP adresu)
- údaj je uveden v jednotkách [sec]

sys[31] 04 i R MAC[0] (celá MAC je nastavena ve webovém rozhraní)
sys[32] 04 i R MAC[1]
sys[33] 04 i R MAC[2]
sys[34] 04 i R MAC[3]
sys[35] 04 i R MAC[4]
sys[36] 04 i R MAC[5] (vždy je vyplněno dolních 8 bitů)

sys[37] 06 i R NTP Client Status (synchronizace času)
== 0 : nesynchronizováno
== 1 : úspěšně přijal paket od NTP Serveru
W zápis hodnoty 10 (přesně a pouze: 10) do tohoto indexu vyvolá nucený NTP dotaz
(dotaz se odešle za 10sec od takovéhoto zápisu)

sys[38] 07 i R čistý UTC čas - v sekundách (UNIX Epoch čas)
- není zde aplikován offset, ani automatika letního času
- přímá hodnota získaná z NTP serveru (tj. jeho odpověď),
uvnitř SDS je sice udržována jako 32bit,
ale do SDS-C programu je hodnota předána jen jako 31bit číslo (nejvyšší 32.bit je odmaskován).

sys[39] 07 i R stav automatiky přepínání Letního Času
== 0 : automatika zakázána, lokální čas není ovlivněn
== 1 : automatika povolena, ale v současné době (podle NTP UTC času) je letní čas neaktivní (tzn. je "SEČ").
== 2 : automatika povolena, a v současné době (podle NTP UTC času) je letní čas aktivní (tzn. je "SELČ").
(tzn. do sys[4] je připočten nejen offset ze sys[26], ale teď také plus 1 hodina kvůli SELČ).
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)
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í
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

sys[138] 09 i R stav RTC (záloha času - pouze SDS se záložní baterií)
zatím stále 0, tzn. nepoužito, další obsah se chystá (nový FW)

sys[139] 09 i R vyhrazeno

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í).

sys[40] až sys[44] RESERVED vyhrazeno

== Provozní údaje ==

sys[45] 06 i R relativní čas v milisekundách, počítaný od zapnutí zařízení (tj. UpTime1)
- po resetu zařízení začíná vždy počítat od nuly
- každou milisekundu se zvýší o 1 (narozdíl od UpTime10);
tzn. toto je velmi podobná hodnota jako UpTime, ale je v jiných jednotkách!
- pro sys[45] je k dispozici 31 bitů,
takže po 2147483648 msec dojde k vynulování sys[45] a počítá se opět od nuly nahoru
(pozn.: SDS si interně udržuje hodnotu jako 32bitů, ale do SDS-C programu se předává jen 31bitů).

sys[46] 06 i R "surová" (raw) hodnota teploty SoC chipu (není to přímo teplota v degC, ale speciální digitální hodnota),
význam hodnot závisí na typu konkrétního zařízení SDS.
Je to dáno způsobem měření této teploty, a převod na stupně Celsia je jednoduchý, přes vzorec.

SDS MICRO (LM), MACRO (LM), UPS, IO6 (LM):
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = ((5*(59-30*((3/1024)*sys[46])))/2) ]

SDS TTCPRO, MINI, MACRO-ST, MICRO-ST, IO6-ST:
Vzorec pro přepočet na degC je [ teplota_SoC_v_degC = (((((sys[46]/4096)*3.3)-0.76)/0.0025)+25) ]

Teplota SoC je pouze orientační, a je měřena s přesností +/- 5 degC.

sys[137] 09 i R POUZE VARIANTY "ST" - počet provedených cyklů procesoru (provedených CPU instrukcí) od zapnutí/restartu
(při přetečení 2^31 počítá opět od nuly, pořád dokola)

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).
Tento index vyžaduje aktuální FW (11/2022 nebo novější).

== Rozhraní sériové komunikace ==

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.

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ě.

Poznámka: čtení z UART RX bufferů je k dispozci jen od verze SDS-C č. '''04''' (včetně) a výše.
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í.

Rozhraní COM1:

sys[48] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM1 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[49] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM1
- čtením tohoto sys[49] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici),
takže si dejte '''pozor''' protože po vyjmutí už tento znak v bufferu samozřejmě není !
(Toto může způsobit nezkušenému programátorovi potíže).
Proto je vhodnější čtení ze sys[49] provést vždy jednou do vlastní proměnné,
a s tou pak dále dle libosti pracovat.
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

Poznámka: UART-COM1 buffer je '''vymazán vždy tehdy''', když se připojí TCP klient k převodníku Eth/UART - pozor!

sys[50] 02 i R je připojen klient (Ethernet) k převodníku Eth/UART ?
== 0 : není připojen klient
!= 0 : je připojen klient (přes TELNET port)
sys[51] 02 i R rychlost [bps] rozhraní UART - COM1 (viz převodník Eth/UART)
sys[52] 02 i R počet datových bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 5,6,7,8)
sys[53] 02 i R počet stop bitů rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 1,2)
sys[54] 02 i R nastavení paritního bitu rozhraní UART - COM1 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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í).

Rozhraní COM6:

sys[55] 04 i R informace, je-li přijímací (RX) buffer rozhraní UART-COM6 prázdný. Možné hodnoty:
== 0 : v RX bufferu je jeden popř. více znaků, lze je přečíst (buffer není prázdný)
== 1 : RX buffer je '''prázdný''' (nebyl přijat znak od posledního vyprázdnění bufferu)

sys[56] 04 i R čtení (vyjmutí) znaku z přijímacího (RX) bufferu rozhraní UART-COM6
- čtením tohoto sys[56] se vyjme právě jeden znak (je-li v bufferu nějaký k dispozici)
Možné hodnoty:
== 0 až 255 : hodnota právě vyjmutého znaku z RX bufferu (znak přijatý UARTem)
== -1 : v bufferu není jakýkoliv znak k dispozici (prázdný buffer)

sys[57] 02 i R rychlost [bps] rozhraní UART - COM6
sys[58] 02 i R počet datových bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 5,6,7,8,9)
sys[59] 02 i R počet stop bitů rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 1,2)
sys[60] 02 i R nastavení paritního bitu rozhraní UART - COM6 (platné hodnoty - podle typu SDS: 0,1,2,3,4,5)

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.

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).

== Generátor náhodných čísel ==

sys[61] 06 i R generátor náhodných čísel
- při každém přečtení sys[61] je poskytnuto náhodné číslo

== Výsledek převodu textu na číslo ==

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]''.

sys[62] 06 i RW výsledek převodu provedeného funkcí '''atoi(text[index]);'''

Pro více informací se podívejte přímo na návod k této funkci.

== Nastavení rychlosti provádění SDS-C programu ==

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čí.

sys[63] 04 i RW vypnutí rychlostního omezení běhu programu, nastavte na:
== 0 : (výchozí hodnota po spuštění programu) - jeden celý příkaz se provede '''co 1 msec'''
== 128 : program je prováděn s co největší rychlostí (bez zarovnávacího 1 msec kroku)
( pozor ale na realizaci čekacích smyček, pak lze použít jen k tomu určené SDS-C funkce nebo sys[64] )

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).

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.

== Časování ==

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:

sys[64] 01 i RW sekundový odpočítávač
- zapište libovolné kladné číslo, a systém každou vteřinu toto číslo sníží o 1,
až do nuly, kde v sys[64] zůstane nula (dokud tam zase něco nezapíšete)
- nejvyšší možná použitelná hodnota: (31-bitů) 2147483647 secs (včetně)

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.

== OSI7 funkce ==

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).

Všechny funkce OSI7 poskytují průběžný stav své činnosti:
sys[65] 01 i R status code - hlášení průběhu, úspěšnosti, nebo chyby OSI7 funkcí (DNS, HTTP-GET, email, ...)
- význam hodnot viz [[OSI7_status_code|popis zde]]

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.

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.
sys[66] 01 i R bajt IP[0] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[67] 01 i R bajt IP[1] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[68] 01 i R bajt IP[2] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''
sys[69] 01 i R bajt IP[3] - vystup DNS resolveru, funkce ''dns_resolv("dotazovanadomena.cz");''

Pro funkci DNS resolveru je potřeba provést konfiguraci (přes webové rozhraní).
sys[70] 01 i R bajt DNS_R_IP[0] - adresa samotného DNS resolveru (DNS server)
sys[71] 01 i R bajt DNS_R_IP[1] - adresa samotného DNS resolveru
sys[72] 01 i R bajt DNS_R_IP[2] - adresa samotného DNS resolveru
sys[73] 01 i R bajt DNS_R_IP[3] - adresa samotného DNS resolveru

sys[74] 01 s R text, reserved (v této verzi nepoužito)

Rozšířená funkcionalita pro DNS resolver (pouze ve FW od 11/2025):

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)
sys[303] 09 i W DNS RESOLV - write anything to clear the DNS cache
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)
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)
sys[305] 09 i W DNS RESOLV - set the hard TTL value limit (in seconds)

HTTP GET:

sys[75] 01 i R návratový kód webového serveru pro HTTP GET (odpověď z webového serveru)
- nastaveno po dokončení práce funkce '''http_get()'''
- např. číslo '''200''' pro 'OK', '''404''' pro 'not found', a tak dále.

sys[76] 03 i RW číslo portu který chcete aby HTTP klient použil (výchozí hodnota po startu je '''80''')
- '''pozn.''' hodnota tohoto sys[76] se přebere v okamžiku zavolání '''http_get''',
pozdější zápisy mají vliv až zase v okamžiku dalšího zavolání '''http_get'''.

sys[77] 04 i RW ukládat data přijatá z HTTP serveru po obdržení odpovědi na HTTP GET požadavek
do pole ram[]. Tato funkce je výhodná pro okamžité řízení SDS-C programu.
Nastavte na:

== 0 : jakékoliv přijaté data jsou '''zahozena''',
neuloží se (nedojde ke změně obsahu ram[] nebo text[])

== 1 : prvních sys[78] bajtů odpovědi je vloženo do pole ram[] v rozsahu ram[1] až ram[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole ram[] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

== 2 : prvních sys[78] bajtů odpovědi je vloženo do pole text[] v rozsahu text[0] až text[sys[78]]
a do ram[0] je uložena délka odpovědi (tj. hodnota: -1, 0, 1, 2, ... až sys[78]).
(tzn. původní obsah této oblasti pole text[] a položka ram[0] je přepsán)
(pokud bude obdržen znak 0x00 dříve, než se zapíše sys[78] bajtů do ram[],
bude zápis přerušen a přijatý 0x00 nebude uložen)

Hodnota do ram[0] je vždy zapsaná, ať je sys[77] jakékoliv. Počítejte s tím ve svém programu !

sys[78] 04 i RW počet bajtů, které CHCETE uložit do ram[] nebo text[] po přijetí HTTP GET odpovědi
- výchozí hodnota je '''32''' (tzn. uloží se 32 znaků + samostatně délka do ram[0])
- maximální hodnota je omezena velikostí pole ram[] nebo text[]
- pozor! pokud zapíšete '''0''', budou všechna data zahozena,
ale i v takovém případě dojde k přepisu ram[0] (viz výše)

sys[79] až sys[80] RESERVED vyhrazeno

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.

Pro funkci SMTP je potřeba provést konfiguraci (přes webové rozhraní):
sys[81] 01 i R bajt SMTP_S_IP[0] - adresa SMTP serveru (je použita pro funkci '''smtp_send()''')
sys[82] 01 i R bajt SMTP_S_IP[1] - adresa SMTP serveru
sys[83] 01 i R bajt SMTP_S_IP[2] - adresa SMTP serveru
sys[84] 01 i R bajt SMTP_S_IP[3] - adresa SMTP serveru

sys[85] až sys[88] RESERVED vyhrazeno

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()" ) :

sys[89] 06 i R IP-Watchdog: stav
== 0 : není v provozu (neaktivováno ve webovém rozhraní)
!= 0 : v provozu (uživatel aktivoval IP-Watchdog ve webovém rozhraní)

sys[90] 06 i R IP-Watchdog: poslední známé RTT
== 0 .. 65533 : hodnota RTT v msec
>= 65534 : hodnota není k dispozici (nebyl obdržen PING response)

sys[91] 06 i R IP-Watchdog: stav výstupu
== 0 : výstup není aktivován
!= 0 : výstup je aktivován (nebyl obdržen PING response podle zadaných požadavků)

Informace z (SDC-C) ICMP PING funkce - '''ping()''' :

sys[92] 04 i R stav ICMP PING RESPONSE v okamžiku čtení tohoto sys[92]
== 0 : klid (není odeslán paket, nečekám na odpověď),
popř. byla zadána neplatná IP adresa do funkce '''ping()''' a proto se nic neodešle
== 1 : funkce '''ping()''' byla právě zavolána,
takže se teprve chystá provést svou činnost, zatím se neví výsledek odesílání
== 2 : čeká se na odpověď od ARP
(POZOR! Znamená to že místo ICMP PING REQUEST paketu byl odeslán ARP paket,
protože v ARP tabulce nebyl příslušný záznam)
== 4 : poslán ECHO REQUEST, čekám na ECHO REPLY
(požadovaný stav, funkce '''ping()''' funguje ok)
== 8 : právě obdržel ECHO REPLY
(byla přijata odpověď od vzdáleného zařízení)

sys[93] 04 i R PING SEQ number
- hodnota je nastavena na '''-1''' dokud není přijata odpověď ICMP PING RESPONSE
na ICMP PING REQUEST odeslaný funkcí '''ping()'''

sys[94] 04 i R Round Trip Time, v milisekundách
- dokud není přijata platná ICMP PING RESPONSE tak je zde hodnota '''0xFFFF'''
- č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)

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'''" .

Funkce '''send_udp()''':

sys[95] 06 i R výsledek posledního volání '''send_udp()'''
Hodnoty:
== 0 : nic neprovedeno
Hodnota '''0''' je nastavena po startu SDS-C programu
== 1 : právě bylo zahájeno odesílání paketu (provádí se)
nastaveno okamžitě po jakémkoliv zavolání '''send_udp()'''.
== 2 : byl odeslán UDP paket, úspěšně
Hodnota '''2''' je nastavena až v okamžiku úspěšného skutečného odeslání UDP paketu
== 3 : nebyl odeslán UDP paket, protože byl místo toho odeslán ARP dotaz
Hodnota '''3''' je nastavena, pokud není známá MAC pro zadanou IP
a byl tedy místo požadovaného UDP paketu odeslán ARP dotaz
== 4 : zavolali jste funkci '''send_udp()''' dříve,
než byla dokočena činnost předchozího požadavku
(sledujte hodnotu sys[95] a správně ji vyhodnocujte, a nestane se vám to)
== 5 : byly zadány neplatné parametry (neplatná IP, nebo port, nebo index či délka dat)

Funkce '''snmp_send_trap()''':

sys[96] 06 i R výsledek posledního volání '''snmp_send_trap()'''
Hodnoty:
== 0 : odesílání neprobíhá
== 1 : probíhá odesílání, výsledek ještě není znám
== 2 : odeslání se povedlo
== 3 : odeslání se nepovedlo (neplatné parametry při zavolání funkce)
== 4 : odeslání se nepovedlo (není známý ARP záznam pro udanou host IP)
== 5 : odeslání se nepovedlo (právě pracuje (odesílá své data) některá jiná funkce, např. http_get)

sys[97] RESERVED vyhrazeno

== Zápis textu do pole, Porovnání textů ==

Položka ''sys[98]'' je využita více SDS-C funkcemi, přičemž všechny tyto funkce pracují s polem ''text[]''.

sys[98] i R společné využití viz (1) a (2)

06 i R (1) číslo indexu do pole ''text[]'' kam byla zapsána terminační 0x00,
tj. ukazatel kde byl aktuální konec zápisu do pole ''text[]'',
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:
- kam byla zapsána terminační 0x00 funkcí '''sprintf()'''
- kam byla zapsána terminační 0x00 funkcí '''itoh()'''
- kam byla zapsána terminační 0x00 funkcí '''itoa()'''

08 i R (2) výsledek porovnání textů
- hodnota výsledku zavolání funkce '''textcmp()'''
X < 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v poli ''text[]'' než v porovnávaném řetězci
X == 0 : oba texty jsou identické
X > 0 : (texty jsou rozdílné): první nalezený nestejný znak má nižší vlastní hodnotu v porovnávaném řetězci než v poli ''text[]''

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.

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[]'').

== Uživatelské pozice v pevné paměti ==

sys[99] 05 i RW předávací proměnná pro čtení a zápis z/do paměti [[SDS-C: DataFlash|dataflash]]

sys[100] až sys[115]
01 i RW data uložená do permanentní paměti = co se sem napíše zůstane i po vypnutí zařízení,
můžete si sem uložit co chcete (tj. 16x signed long délky 32bit),
- po speciálním systémovém resetu (RSTD) je vše nastaveno na 0xFFFFFFFF
- pozor! minimalizujte množství zápisů, životnost této paměti není neomezená !
- zápis do těchto sys[] přímo ihned fyzicky zapíše do pevné paměti
- čtení těchto sys[] způsobí přímé fyzické čtení pevné paměti

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[]'').

''' Reserved '''

sys[116] až sys[136] RESERVED vyhrazeno

== Proměnné nastavitelné uživatelem z webového rozhraní ==

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.

sys[140] až sys[149]
01 i RW "uživatelské proměnné", které můžete měnit "z webu" (správně formulovaným HTTP GET dotazem)
(vždy 32-bit signed integer)

sys[150] 01 i RW blokování přístupu k možnosti změny obsahu "uživatelských proměnných" z webu
Nastavení:
== 0 : stránka "control" je přístupná bez hesla,
!= 0 : pro přístup je nutno se přihlásit (uživatel je vyzván k příhlášení)

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).

Zápisem do ''sys[150]'' můžete nastavit bezpečnost přístupu k této webové stránce.

Adresa webové stránky je (IP je zde pro příklad): http://192.168.1.250/control (více informací [[SDSC: sharing|zde]]).

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í.

== Proměnné vstupů a výstupů pro všechny výrobky SDS ==

'''POZOR'''

'''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.

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í).

'''Pokračování výpisu:'''

sys[151] až sys[182]
01 i R stav binárního vstupu OPTO1 až OPTO32 (optočlen)
- hodnota odpovídá fyzickému stavu vstupů (zda-li je nebo není přítomen signál na LED optočlenu)
- pozor, hodnota '''0''' skutečně znamená přítomnost signálu
Hodnoty:
== 0 : (nulová hodnota) signál přítomen (napětí na LED = svítící LED v optočlenu)
!= 0 : (libovolná nenulová hodnota) bez signálu (LED v optočlenu nesvítí)

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.

'''Důležité info:'''

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).

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.

== Stav SDS-C programu ==

Informace o verzi firmware modulu SDS (vhodné např. pro kontrolu, že uživatel používá nejnovější firmware, tak jak má).

sys[183] 08 i RW verze nainstalovaného firmware v SDS modulu
(hex: 0x00DDMMYY, nebo jen 0x00000000 u starších FW)

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.

Informace o způsobu, jakým byl aktuální běh SDS-C programu spuštěn:

sys[184] 08 i RW způsob spuštění SDS-C programu
== 0 : bez informace
== 1 : standardní spuštění SDS-C programu po běžném startu zařízení SDS
== 2 : program SDS-C byl (znovu) spuštěn na základě restartu od watchdogu (byl timeout)
== 4 : program SDS-C byl čerstvě nahrán z EXE aplikace

Stav SDS-C watchdogu:

sys[185] 08 i R hodnota odpočítávání SDS-C watchdogu v msec
== -1 : wdg není aktivní
== 0 : odpočet vypršel, dojde k resetu SDS-C programu
1..2147482000 : aktuální hodnota odpočtu (snižuje se o 1 každou milisekundu)

== Pulse-Width Modulation výstupy ==

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).

''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.
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).
Alternativně lze zápis do sys[192] nahradit zápisem do sys[193], toto lze kombinovat.
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).
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]).

Různé typy SDS mají jiný způsob obsluhy PWM generátoru - pozor !

Pozor, pro tyto typy SDS:

SDS '''UPS''', SDS '''IO6 (LM)''', SDS '''IO6-ST''' a SDS '''TTCPRO'''

Tyto výrobky nemají PWM výstup (zápis do příslušných sys[] zde nemá význam).

Podle typu SDS:

SDS '''MICRO (LM)''' a SDS '''MACRO (LM)''' - pouze jeden PWM výstup (PWM1)

sys[191] 01 i RW "Fm" = frekvence PWM1 výstupu [Hz]
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)(bylo v rozsahu: 2 až 10000000).
- pozn. od SDS-C č. '''04''': lze nastavit hodnotu od ''24'' (24Hz) do ''49999998'' (49.999998Mhz)

sys[192] 01 i RW poměr nastavení "pulse-width" PWM1 výstupu (výchozí způsob nastavování PWM generátoru)
- do SDS-C č. '''03''': specifický omezený rozsah (souvisí se starým firmware)
- od SDS-C č. '''04''': lze nastavit hodnotu od 0 do "Fm" (např. "Fm / 2" představuje PWM signál 1:1).

sys[193] 06 i RW ruční přímý zápis do registru PWM1 generátoru
- tzn. není předzpracováno jako sys[192], tzn. jedná se o alternativu k sys[192]
- tato hodnota není aktualizována vůči sys[192], ani není archivována
- rozsah: ''0'' až "Fm" (tj. ''0'' až sys[191]).

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupu osciloskopem.

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.

Další typy SDS - všimněte si rozdílu ''významu'' jednotlivých indexů vůči vůči tabulce výše.

SDS '''MINI''', SDS '''MICRO-ST''' - pouze jeden PWM výstup (PWM1)
SDS '''MACRO-ST''' - čtyři PWM výstupy (zde: první skupina PWM1 a PWM2, druhá skupina je popsána dále)

sys[191] 07 i RW "Fm" = (společná) frekvence pro '''PWM1 a PWM2''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM1 a PWM2 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[192] 07 i RW duty-cycle '''PWM1''' výstupu v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[192] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[192] ignorovány (nejsou zapamatovány)

sys[193] 07 i W duty-cycle '''PWM1''' výstupu v mikrosekundách (druhý možný způsob nastavování PWM generátoru)
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[193] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[193] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[194] 07 i RW duty-cycle '''PWM2''' v procentech (výchozí způsob nastavování PWM generátoru)
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[194] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[194] ignorovány (nejsou zapamatovány)

sys[195] 07 i W duty-cycle '''PWM2''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[191] a vypočte se jako: X = 1000000 / sys[191]; - pozor !)
- před zápisem do sys[195] musí být nastavena frekvence generátoru (nenulový zápis do sys[191])
- pokud je aktuální hodnota sys[191] == 0 (nula), tak jsou všechny zápisy do sys[195] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

SDS '''MACRO-ST''' - čtyři PWM výstupy (zde druhá skupina: PWM3 a PWM4)

sys[186] 09 i RW "Fm" = (společná) frekvence pro '''PWM3 a PWM4''' výstupy [Hz]
- 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])
- zápis hodnoty 0 vypne PWM3 a PWM4 výstupy (výstup trvale neaktivní) - pro opětovné zapnutí zapište nenulovou hodnotu

sys[187] 09 i RW duty-cycle '''PWM3''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[187] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[187] ignorovány (nejsou zapamatovány)

sys[188] 09 i W duty-cycle '''PWM3''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[188] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[188] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

sys[189] 09 i RW duty-cycle '''PWM4''' v procentech
- povolené rozmezí 0 až 100 (0% až 100%)
- před zápisem do sys[189] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[189] ignorovány (nejsou zapamatovány)

sys[190] 09 i W duty-cycle '''PWM4''' výstupu v mikrosekundách
- pouze pro zápis, pozor !
- povolené rozmezí 0 až X (kde X závisí na sys[186] a vypočte se jako: X = 1000000 / sys[186]; - pozor !)
- před zápisem do sys[190] musí být nastavena frekvence generátoru (nenulový zápis do sys[186])
- pokud je aktuální hodnota sys[186] == 0 (nula), tak jsou všechny zápisy do sys[190] ignorovány (nejsou zapamatovány)
- POZOR čtení nedává hodnotu v mikrosekundách, ale přímo hodnotu z registru generátoru

Doporučení je vždy si ověřit vzájemné závislosti konfigurace PWM výstupů osciloskopem.

== Ovládání výstupů - Relé ==

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é.

sys[196] až sys[228]
01 i RW informace, kdo ovládá '''RE1''' až '''RE32'''
- lze nastavit i z webového rozhraní
Hodnoty:
== 0 : ovládáno z webového rozhraní (ruční řízení - trvale zapnuto, trvale vypnuto)
== 2 : ovládáno z SDS-C programu (zápis do sys[], je ignorováno nastavení na webu)
== 4 : ovládáno z IP Watchdogu (interní IP watchdog, nastavuje se přes web)

sys[229] až sys[230] RESERVED vyhrazeno

sys[231] až sys[262]
01 i RW stav výstupu RE1 až RE32 (= zápis do tohoto sys[] přímo ovládá relé)
Hodnoty:
== 0 : relé není aktivní
(cívka relé bez proudu, MICRO-LM: mosfet není sepnut)
!= 0 : relé je aktivní
(cívka relé pod proudem, MICRO-LM: mosfet je sepnut = výstup REx je spojen na GND)

sys[263] až sys[265] RESERVED vyhrazeno

sys[266] až sys[298]
01 s R uživatelský textový název pro '''RE1''' až '''RE32'''
- nastaveno ve webovém rozhraní

sys[264] až sys[300] RESERVED vyhrazeno

== Ovládání PDx ==

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.

Stav vstupu (je-li PDx jako vstup) nebo výstupu (je-li PDx jako výstup):

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)
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)
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)
SDS '''MINI''': bit0 = stav i/o pinu TOPB, bit1 = stav padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
SDS '''IO6-ST''': nepoužito
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

Řízení směru pro jednotlivé PDx resp. TOPB:

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)
SDS '''MICRO LM DIN''' a '''SDS MACRO LM''': pozor, D0 je vždy výstup (nastavení je napevno, nelze změnit)
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)
SDS '''MINI''': bit0 = směr i/o pinu TOPB, bit1 = směr i/o padu PD1, ostatní bity (2..7) nepoužity
SDS '''UPS''': nepoužito
SDS '''IO6''': nepoužito
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
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

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í.

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.

MICRO-ST: výstup PD0 je zapojen formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

MACRO-ST: výstupy PD0 a PD1 jsou zapojeny formou FET spínače (log0 = HiZ = rozepnuto) (log1 = ACT = sepnuto na GND).

Nezapomeňte vždy ve svém programu správně nastavit hodnoty do sys[302] (toto je častá chyba když se to zapomene).

sys[306] až sys[309] RESERVED vyhrazeno

== Tlačítka na desce display pro SDS-MACRO-ST ==

Č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).

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.

== Vstupy - teploměry na externí sběrnici 1-Wire® ==

Č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.

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici

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)'''.

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'''.

sys[342] až [345] RESERVED vyhrazeno

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)
sys[347] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''B'''

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)
sys[349] 01 i R počet všech detekovaných (připojených) čidel teploty na sběrnici '''A'''

sys[350] až sys[381]
01 i R čidlo 1 až 32 - aktuální stav/chyba čidla v okamžiku čtení tohoto sys[]
== 0 : default, čidlo neexistuje, nic nevim (stav ihned po zapnutí, popř. trvale pro prázdnou pozici)
== 2 : vše ok, komunikuje, odpovidá, právě byl získán výsledek
== 4 : ví se jen že existuje (byl získán ROMCODE) (obvykle dočasný stav po spuštění zařízení)
== 8 : začal další převod, čidlo je OK, komunikuje (správný stav)
== 16 : nepovedlo se začít nový převod, CHYBA (obvykle fyzický problém se sběrnicí)
== 32 : bylo přijato neplatné CRC, chyba (obvykle fyzický problém se sběrnicí)

sys[382] až [389] RESERVED vyhrazeno

sys[391] až sys[422]
01 s R uživatelský textový název pro čidlo 1 až 32 (nastaveno ve webovém rozhraní)

''' Reserved '''

sys[423] až sys[430] RESERVED vyhrazeno

== Vstupy: analogové vstupy pro měření napětí ==

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.

sys[431] 01 i R RAW hodnota A/D převodu ze vstupu AD1
sys[432] 01 i R RAW hodnota A/D převodu ze vstupu AD2
sys[433] 01 i R RAW hodnota A/D převodu ze vstupu AD3
sys[434] 01 i R RAW hodnota A/D převodu ze vstupu AD4

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.

Rozsah hodnoty RAW je:
* SDS-MICRO-LM, SDS-MACRO-LM, SDS-UPS-ONEDPS: 0..1023 (10bit rozlišení)
* SDS-MINI a všechny varianty SDS ST: 0..4095 (12bit rozlišení)

Všechny převodní konstanty A/D, nastavené ve webovém rozhraní (viz admin stránka):

sys[435] 01 i R Offset pro A/D 1 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[436] 01 i R Div pro A/D 1
sys[437] 01 s R textový název A/D 1
sys[438] 01 s R jednotka A/D 1

sys[439] 01 i R Offset pro A/D 2 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[440] 01 i R Div pro A/D 2
sys[441] 01 s R textový název A/D 2
sys[442] 01 s R jednotka A/D 2

sys[443] 01 i R Offset pro A/D 3 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[444] 01 i R Div pro A/D 3
sys[445] 01 s R textový název A/D 3
sys[446] 01 s R jednotka A/D 3

sys[447] 01 i R Offset pro A/D 4 [jen pro informaci, dále už nepoužít - viz pozn.]
sys[448] 01 i R Div pro A/D 4
sys[449] 01 s R textový název A/D 4
sys[450] 01 s R jednotka A/D 4

'''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) !
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".

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).

''' Reserved '''

sys[451] až sys[458] RESERVED vyhrazeno

== Proměnné pro S0 impulsní vstup ==

sys[459] 01 i RW stav tarifu
== 0 : T0 (vysoký tarif)
== 1 : T1 (nízký tarif)

sys[460] až sys[492]
06 i RW konfigurace - uživatelem nastavený (webové rozhraní) poměr MTD, pro vstup S0 [1] až [32],
je-li MTD pro tento vstup použit (pokud není použit (přímé měření), má zde být 1 )
- příklad: pro MTD s poměrem 300A:5A je zapsaná hodnota 60
- pozor, nezapočítávejte vliv MTD do hodnoty imp./1kWh
- pozor, některé elektroměry mají MTD už započítané do vlastní impulsní konstanty,
pak sem v takovém případě nastavte číslo 1
- platné hodnoty: 1 až 65280 (včetně)

sys[493] až sys[525]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T0
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[526] až sys[558]
01 i RW hodnoty impulsních akumulátorů (počítadel) pro vstup S0 [1] až [32] pro tarif T1
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed).

sys[559] až sys[591]
01 i RW konfigurace - uživatelem nastavené přepočtové konstanty S0: počet imp./1kWh (z webového rozhraní)
- pozor, tato hodnota platí pro samotný elektroměr, není to hodnota ve které je započítán vliv MTD
- pozn. v případě, že měřícím prvkem není elektroměr ale jiný přístroj, bude zde odpovídající
jiná konfigurační hodnota (např. vodoměr: počet imp./m^3).

sys[592] až sys[624]
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)
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

sys[625] až sys[657]
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"
- měřeno v msec
- (!) pozor SDS interně drží počítadla jako 32-bit unsigned hodnoty (0 až 4294967295)
ale SDS-C čte sys[] jako 32-bit signed hodnoty;
při čtení tedy dostanete stejné hodnoty 32 bitů, ale reprezentace čísla bude jiná (signed - viz vysvětlení nahoře).

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.

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.

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é.

sys[658] až sys[670] reserved for future use

poznámka: další sys[] indexy pro S0 vstupy jsou uvedeny ještě dále v tomto celém seznamu (dole na stránce).

== Speciální vstupy a výstupy ==

Toto je funkce dostupná jen na omezeném rozsahu výrobků SDS.

'''Pouze pro SDS MICRO (LM) LIGHT:'''

sys[671] 02 i W zápis na pin M4 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[672] 02 i W zápis na pin M5 (pouze SDS MICRO LIGHT s EEPROM, všechny ostatní výrobky toto nemají)
sys[673] 02 i W zápis na pin B1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)
sys[674] 02 i W zápis na pin A1 (SDS MICRO LIGHT, LIGHT2, SDS MICRO DIN)

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ší.

SDS MICRO LIGHT s pamětí EEPROM: k dispozici jsou všechny čtyři výstupy.

SDS MICRO LIGHT s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO LIGHT 2 s pamětí DATAFLASH: k dispozici jsou jen dva výstupy (A1, B1).

SDS MICRO DIN: k dispozici jsou jen dva výstupy (A1, B1).

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'''.

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).

'''Pouze pro SDS MACRO ST:'''

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).

sys[671] 02 i R čtení stavu TL1
sys[672] 02 i R čtení stavu TL2

'''Pájecí plošky CFG:'''

Zkratovací CFG plošky jsou k dispozici jen pro SDS TTCPRO. Vhodné pro pevnou konfiguraci uživatelem.

V současné době není k dispozici firmware, které přenáší hodnotu z pájecích plošek (CFG1, CFG2) do ''sys[]''.
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).
Takový firmware se teprve chystá (SDS TTCPRO).

sys[675] 07 i R stav plošky CFG1 (zkratována = je zde 0)
sys[676] 07 i R stav plošky CFG2 (zkratována = je zde 0)

== Speciální proměnné pro SDS-UPS ==

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 .

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í.

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).

sys[700] 02 i R reserved
sys[701] 02 i R reserved
sys[702] 02 i R reserved
sys[703] 02 i R reserved

'''Přepínač algoritmů:'''

sys[704] 02 i RW řízení nabíjení - hodnoty které lze zapsat:
== 0 : nabíjení je ovládáno pomocí firmware (výchozí chování výrobku)
== 345 : pouze nabíjení (a ne jiné funkce) jsou řízeny programem SDS-C (= chování programujete vy)
== 824 : kompletní řízení (= volba funkce, nabíjení) je řízeno programem SDS-C

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.

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.

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.

sys[705] až sys[731] reserved

Pro realizaci vlastního nabíjecího algoritmu potřebujete zpracovávat všechny vstupy a důsledně nastavovat všechy výstupy.

Pokud váš program pouze sleduje činnost původního nabíjecího algoritmu, pak může samozřejmě všechny sys[] jen číst.

'''Vstupy a konfigurace:'''

sys[732] 02 i R surová hodnota z A/D převodu - hodnota 2.5V vstupu - odpovídá hodnotě proudu 0.0A
sys[733] 02 i R surová hodnota z A/D převodu - hodnota proudu do-z akumulátoru
sys[734] 02 i R surová hodnota z A/D převodu - hodnota proudu z primárního vstupu
sys[735] 02 i R surová hodnota z A/D převodu - hodnota napětí akumulátoru
sys[736] 02 i R surová hodnota z A/D převodu - hodnota napětí primárního vstupu

Rozsah surových hodnot z A/D převodu je 0 až 4095. Lineárně to odpovídá příslušné měřené hodnotě.
Měření napětí má 0 na 0V a maximální hodnot (4095) na maximu rozsahu.
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.).

sys[737] až sys[739] reserved

Následuje konfigurace provedená uživatelem ve webovém rozhraní.
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á.

sys[740] 02 i R primary voltage to say target is ok (pri_pvts)
sys[741] 02 i R primary zadany odpocet v msec (pri_pvat)
sys[742] 02 i R primary voltage to allow charging (at what voltage to allow chargin) (pri_fchg)
sys[743] 02 i R accu disconnect voltage level (at what voltage to disconnect accu) (aku_avdv)
sys[744] 02 i R accu target voltage when charging (when to switch to CV) (aku_avcd)
sys[745] 02 i R accu target current when charging (constant current when in CC) (aku_accc)
sys[746] 02 i R target charging voltage (final voltage on accu when fully charged)
sys[747] 02 i R flag: do not answer ping when primary gone (pri_ping)
sys[748] 02 i R flag: do not switch accu off (aku_dach)

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.

sys[749] až sys[760] reserved

'''Výstupy:'''

Tyto '''všechny''' výstupy musíte správně ovládat po celou dobu, co bude zařízení SDS UPS zapnuto !

sys[761] 02 i RW ovládání vypínání nabíječe
== 0 : nabíječ v provozu (zapnuto = nabíjí se, regulujte jiným sys[])
!= 0 : nabíječ mimo provoz (vypnuto = nenabíjí se)

sys[762] 02 i RW ovládání posunu rozsahu regulace nabíječe
== 0 : bez zásahu do zpětné vazby (původní regulační rozsah)
!= 0 : zásah do zpětné vazby (posun rozsahu)
(vhodné pro skokové zvýšení výstupního napětí nabíječe,
když už nereaguje v původním rozsahu)

sys[763] 02 i RW ovládání odpojovače baterie
== 0 : spínač vypnutý (baterie odpojena od zátěže)
!= 0 : spínač sepnutý (baterie připojena)

sys[764] 02 i RW indikační LED - nabíjení akumulátoru
== 0 : LED svítí (informace: akumulátor je nabíjen)
!= 0 : LED nesvítí (informace: akumulátor není nabíjen)

sys[765] 02 i RW indikační LED - výpadek primárního vstupu
== 0 : LED svítí (informace: napětí primárního vstupu pod dolním limitem)
!= 0 : LED nesvítí (informace: primární vstup má napětí vyšší než je dolní limit)

'''Řízení nabíjení:''' Je potřeba správně regulovat pomocí následujícího výstupu:

sys[766] 02 i RW přímé řízení nabíjecího bloku (výstup vaší regulace sem - hodnota řídí nabíječ)
- minimální hodnota = 1
- maximální hodnota = 2497

sys[767] až sys[769] RESERVED vyhrazeno

Následující údaje jsou určeny pro '''zobrazování na webovém rozhraní''':

sys[770] 02 i RW provozní režim: vždy jedno z UPS_PROVOZ_xxx

sys[771] 02 i RW nabíjecí režim: vždy jedno z UPS_NABREZIM_xxx

sys[772] 02 i RW výsledek odhadu stavu baterie: vždy jedno z UPS_BATERIE_ODHAD_xxx

Konstanty pro zápis (je to potřeba dodržet, protože se to přímo zobrazuje na webovém rozhraní):

UPS_PROVOZ_START 0
UPS_PROVOZ_PRIOK 1
UPS_PROVOZ_PRIOK_CHARGING 2
UPS_PROVOZ_ONLY_BATT 4
UPS_PROVOZ_NO_BATT 8

UPS_NABREZIM_CC 0
UPS_NABREZIM_CV 2
UPS_NABREZIM_PAUZA 4
UPS_NABREZIM_URCENI_REZIMU 8

UPS_BATERIE_ODHAD_NEZNAM 0
UPS_BATERIE_ODHAD_MOC_NIZKE_NAPETI 1
UPS_BATERIE_ODHAD_OK_NABIJIM 2
UPS_BATERIE_ODHAD_PLNE_NABITO 4

== Výsledky z 1-Wire sensoru vlhkosti (T/RH) SDS-1W-T-RH ==

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.
SDS interně provádí výpočet relativní vlhkosti (RH) pomocí kompenzační rovnice, určené výrobcem sensoru vlhkosti.

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.

Změřená teplota je uložena na standardních indexech:

sys[310] až sys[341]
01 i R hodnota údaje (teplota) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 degC

Dále jsou k dispozici surové hodnoty, nutné pro výpočet hodnoty RH (Relative Humidity):

sys[800] až sys[831]
08 i R hodnota údaje (napětí Vad = výstupu čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

sys[832] až sys[863]
08 i R hodnota údaje (napětí Vdd = napájení čidla RH) z konkrétního čidla na 1-Wire® sběrnici, hodnota v násobku 0.01 V

SDS provádí přepočet na údaj RH v procentech (0 až 100):

sys[864] až sys[895]
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).

Rezerva (zatím nepoužito):

sys[896] až sys[899] RESERVED vyhrazeno

== Doplňující informace pro 1-Wire zařízení ==

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).

'''1-Wire chipy interně zpracovávané SDS'''

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.

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]'''.

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.

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ů.
Jednotlivé platné ROM CODE jsou v ''sys[]'' uloženy za sebou, viz výpis:

sys[900] 06 s RW ROM CODE pro první chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[901] 06 s R ROM CODE pro druhý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále až

sys[915] 06 s R ROM CODE pro šestnáctý chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

Následuje sběrnice [B], je-li přítomná v daném zařízení (dostupné pouze pro SDS-MACRO):

sys[916] 06 s R ROM CODE pro první chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

A tak dále . . . až

sys[931] 06 s R ROM CODE pro šestnáctý chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

'''Pozor''': pokud sběrnice [B] v zařízení není, tak sys[916] až sys[931] vrátí znak '-'.

Tak jak jsou jednotlivé ROM CODE viditelné ve webové administraci, tak jsou tedy dostupné i přes sys[] položky.

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.

sys[931] až sys[939] reserved

'''Ostatní 1-Wire chipy'''

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.

Čtení ostatních 1-W chipů se spouští v rámci SDS-C programu, který musí zavolat příslušnou SDS-C funkci.
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.
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[]''',
nebo bude nastaven chybový kód.

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.
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).

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.

Obecný stav sběrnic:

sys[940] 06 i R Stav 1-W sběrnice '''[A]''' pro rescan ostatních 1-W chipů
sys[941] 06 i R Stav 1-W sběrnice '''[B]''' pro rescan ostatních 1-W chipů
:
== 0 : ještě nebylo provedeno jediné/jakékoliv čtení ostatních chipů na 1-W sběrnici

== 1 : došlo k chybě: nebylo dokončeno předchozí čtení sběrnice
(nesmíte požadovat nové čtení, dokud se plně neprovedlo to poslední)

== 2 : probíhá čtení ROM CODE z připojeného ostatního chipu
(dokud se toto nedokončí, nelze provést opětovný požadavek na další rescan/čtení)

== 4 : nebyl nalezen jakýkoliv ostatní chip (s odpovídajícím Family Code byte)

== 8 : byl přečten ROM CODE z připojeného ostatního chipu
(už lze také požádat o další nové čtení 1-W sběrnice)

== 16 : došlo k chybě: nepovedlo se přečíst data po 1-W sběrnici
(zkuste provést rescan/čtení znovu)

sys[942] až sys[949] reserved

'''Pro sběrnici [A]:'''

sys[950] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[951] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [A] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[952] až sys[959]: bajtový rozpad ROM CODE pro chip na [A] sběrnici 1-Wire
:
sys[952] 06 i R romcode[0] (1-W: ID family-code byte)
sys[953] 06 i R romcode[1] (1-W: serial code)
sys[954] 06 i R romcode[2] (1-W: serial code)
sys[955] 06 i R romcode[3] (1-W: serial code)
sys[956] 06 i R romcode[4] (1-W: serial code)
sys[957] 06 i R romcode[5] (1-W: serial code)
sys[958] 06 i R romcode[6] (1-W: serial code)
sys[959] 06 i R romcode[7] (1-W: CRC byte)

sys[960] až sys[969] reserved

'''Pro sběrnici [B]:'''

sys[970] 06 i R časová značka posledního okamžiku komunikace s chipem na [B] sběrnici 1-Wire
(nebo: 0 (nula) = pokud ještě nebyla komunikace provedena).
- v okamžiku každého nového pokusu o čtení je nastavena na 0 (nula),
a pak v okamžiku přečtení ROM CODE, je zde hodnota převzatá ze '''sys[3]'''

sys[971] 06 s R celý text ROM CODE:
- ROM CODE pro chip na [B] sběrnici 1-Wire
- formát textu "0011223344556677" (8x HEX kód, bez uvozovek)

sys[972] až sys[979]: bajtový rozpad ROM CODE pro chip na [B] sběrnici 1-Wire
:
sys[972] 06 i R romcode[0] (1-W: ID family-code byte)
sys[973] 06 i R romcode[1] (1-W: serial code)
sys[974] 06 i R romcode[2] (1-W: serial code)
sys[975] 06 i R romcode[3] (1-W: serial code)
sys[976] 06 i R romcode[4] (1-W: serial code)
sys[977] 06 i R romcode[5] (1-W: serial code)
sys[978] 06 i R romcode[6] (1-W: serial code)
sys[979] 06 i R romcode[7] (1-W: CRC byte)

sys[980] až sys[989] reserved

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).

'''Pozor''':

Pokud je takových chipů připojeno na sběrnici více, popř. pokud jsou smíchány s "teploměrnými" chipy,
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ů).

== Reserved ==

sys[990] až sys[1023] reserved

== Speciální položky jen pro SDS-MACRO-LM a SDS-MACRO-ST ==

'''Přímý přístup do LCD Frame Buffer paměti:'''

sys[1024] až sys[1551] LCD buffer (dostupné jen pro SDS MACRO LM a SDS MACRO ST !)
01 i RW každý index v rámci tohoto rozsahu sys[] lze zapisovat i číst
- jedná se o pole 528 bajtů (4 řádky x 132 sloupců)
- každý bajt pole obsluhuje přesně danou oblast (několika pixelů) LCD displaye
- platné hodnoty pro každý index : 0 až 255 včetně - zapisujte a čtěte jen hodnoty 0 až 255 (včetně)

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).

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 !

Č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).

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.

'''Pozor''' SDS-MACRO-ST

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.

== Vyhrazená oblast ==

'''Zbytek:'''

sys[1552] až sys[1663] reserved

== Bateriově Zálohovaná Paměť ==

'''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!

Pozor! Tato funkce vyžaduje FW od 18.8.2017 a nebo novější.

sys[1664] až sys[1791] (pouze pro SDS TTCPRO a SDS MINI a SDS MICRO-ST a SDS MACRO-ST a SDS IO6-ST)
07 i RW sada 128 samostatných pozic v zálohované paměti RAM, pro ukládání libovolných hodnot
- každý index má k dispozici 32 bitů (tj. celý signed integer)
- čtení a zápis je rychlé (je to v RAM, takže se nemusí čekat jako při práci s DF)
- lze použít nezávisle (lze přístupovat ke kterékoliv položce "na přeskáčku")

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).

''(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).

== Další informace ze S0 vstupů ==

Následující položky jsou k dispozici pro všechny SDS První Produktové Řady.

Od verze SDS-C č. 07 jsou přidány tyto systémové proměnné:

sys[1792] až sys[1823]
07 i R cena za jednotku v režimu T0
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1824] až sys[1855]
07 i R cena za jednotku v režimu T1
- původní hodnota je poskytnuta jako násobek 1000 (např. nastavená hodnota 3.40 je zde předána jako číslo 3400)

sys[1856] až sys[1887]
07 s R název jednotky se vztahem k času, podle nastavení (např. text "kWh")
- text

sys[1888] až sys[1919]
07 s R název měny, podle nastavení (např. text "CZK")
- text

sys[1920] až sys[1951]
07 s R název jednotky bez vztahu k času, podle nastavení (např. text "kW")
- text

sys[1952] až sys[1983]
07 s R název činnosti, podle nastavení (např. text "spotřeba")
- text

sys[1984] až sys[2015]
07 s R název měřiče, podle nastavení (např. text "elektroměr č. 1")
- text

sys[2016] až sys[2047]
07 i R konfigurační detaily pro daný S0 vstup
- bit 0 nastaven = je to aktivní S0 vstup
- bit 1 nastaven = tento S0 vstup je rozdělen na dvoutarif T0/T1 (jinak je to jedno-tarif)

Samozřejmě pro využití těchto systémových proměnných, potřebujete mít v SDS aktuální firmware.

== Reserved ==

sys[2048] až sys[2198] reserved

== MQTT klient ==

Vždy si zjistěte, jestli máte v SDS takové FW, které podporuje funkci MQTT klient:

sys[2199] 09 i R podpora MQTT
0 = NE
1 = ANO, verze MQTT 3.1.1, SDS první část implementace
2..max = (reserved)

Každé nové připojení k Brokeru:

sys[2200] 09 i R stav průběhu mqtt_connect()
-7 = obdrželi jsme CONNACK, ale negativní = nepřipojeno ( výsledek viz sys[2201] )
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno a odeslán CONNECT požadavek
4 = obdrželi jsme CONNACK, připojeno ( výsledek viz sys[2201] )
8 = probíhá odpojování, čekáme na výsledek (na odpojení)

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.

sys[2201] 09 i R výsledek mqtt_connect() = hodnota "CONNACK Connect Return"
-7 = nepoužito
-6 = timeout při čekání na CONNACK, nepřipojeno
-5 = nepoužito
-4 = nepoužito
-3 = nepoužito
-2 = probíhá připojování, čekáme na CONNACK (zatím nepřišel)
-1 = idle, nepřipojeno
0 = (výsledek:) MQTT 0x00: broker akceptoval připojení - LZE POKRAČOVAT (provádět Publish, Subscribe)
1 = MQTT 0x01: Connection Refused, unacceptable protocol version
2 = MQTT 0x02: Connection Refused, identifier rejected
3 = MQTT 0x03: Connection Refused, Server unavailable
4 = MQTT 0x04: Connection Refused, bad user name or password
5 = MQTT 0x05: Connection Refused, not authorized

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).

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:

sys[2202] 09 i R výsledek pro tyto funkce: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
-8 = SUBACK dorazil z Broker ale s indikovanou chybou (Failure Bit), můžete volat další funkci
-7 = vybraná položka (řádek) subscribe tabulky je prázdná, není co odhlašovat
-6 = timeout (možnosti: publish neprovedeno, nebo: SUBACK vůbec nedorazil, nebo: UNSUBACK vůbec nedorazil), můžete volat další funkci
-5 = nespravne parametry (hodnoty, např. index) např. jejich celková délka se nevleze do paketu
-4 = nespravne parametry (počet parametrů)
-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
-2 = SDS není připojeno k brokeru (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity
0 = nepoužito
1 = mqtt_publish() probíhá
2 = mqtt_publish() hotovo (OK - obdržen TCP ACK), můžete volat další funkci
4 = mqtt_subscribe() probíhá - čekám na SUBACK
8 = SUBACK dorazil z Broker, bez chyby (OK), můžete volat další funkci
16 = čekám na UNSUBACK (pouze pro unsubscribe funkce)
32 = UNSUBACK dorazil z Brokeru, můžete volat další funkce

Informativní položka:

sys[2203] 09 i R počet chyb v protokolu MQTT směrem z Brokeru
(objeví-li se chyba, dojde k okamžitému odpojení)

Zatím nepoužité pozice:

sys[2204] až sys[2208] reserved

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)

sys[2210] 09 s R poslední přijatý Topic Name z Brokeru (broker publish)
sys[2250] 09 s R poslední přijatý Value z Brokeru (broker publish)
sys[2290] 09 i R timestamp pro poslední přijatou zprávu (broker publish)

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.

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 !

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)

Jednotlivé položky v tabulce příchozích zpráv:

sys[2211] až sys[2241]
09 s R název položky (Topic Name) pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2242] až sys[2249] reserved

sys[2251] až sys[2281]
09 s R poslední přijatá hodnota (Value) ze publish zprávy ze brokeru pro daný index #1 - #31
(max délka záznamu dle SDS)

sys[2282] až sys[2289] reserved

sys[2291] až sys[2321]
09 i R timestamp (hodnota uptime) v okamžiku příchodu zprávy z Brokeru
(pro detekci změny - příchozí zprávy z Brokeru)
0 = zatím nic nepřišlo
1..MAX = hodnota uptime v okamžiku poslední změny

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.

== Reserved ==

sys[2322] až sys[2398] reserved

== MODBUS-TCP klient ==

Ověření FW v SDS:

sys[2399] 09 i R podpora pro MODBUS TCP
0 = NE
1 = ANO (první verze implementace v SDS)

Každé nové TCP spojení na server:

sys[2400] 09 i R stav průběhu modbus_tcp_connect()
-6 = timeout při čekání na připojení, nepřipojeno
-5 = nespravne parametry (hodnoty např. IP, port), nepřipojeno
-4 = nespravne parametry (počet parametrů), nepřipojeno
-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
-2 = pokus o TCP připojení selhal
-1 = nepoužito
0 = klid, nic se neprovádí, ODPOJENO ! (lze se začít připojovat)
1 = bylo zahájeno připojování (otevírá se TCP spojení)
2 = TCP připojeno, můžete komunikovat

MODBUS funkce - každá má svůj nezávislý stavový údaj:

sys[2401] 09 i R stav průběhu zpracování funkce 0x01 - modbus_tcp_read(uid, 0x01, ...);
sys[2402] 09 i R stav průběhu zpracování funkce 0x02 - modbus_tcp_read(uid, 0x02, ...);
sys[2403] 09 i R stav průběhu zpracování funkce 0x03 - modbus_tcp_read(uid, 0x03, ...);
sys[2404] 09 i R stav průběhu zpracování funkce 0x04 - modbus_tcp_read(uid, 0x04, ...);
sys[2405] 09 i R stav průběhu zpracování funkce 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
sys[2406] 09 i R stav průběhu zpracování funkce 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
sys[2415] 09 i R stav průběhu zpracování funkce 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
sys[2416] 09 i R stav průběhu zpracování funkce 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
pro všechny tyto stavy platí následující hodnoty:
-6 = timeout (neprovedeno), můžete volat další funkci
-5 = nespravne parametry (hodnoty), můžete volat další funkci
-4 = nespravne parametry (počet parametrů), můžete volat další funkci
-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
-2 = SDS není připojeno (buď právě ještě probíhá připojování, nebo není vůbec připojeno)
-1 = bez aktivity, lze volat funkci
0 = provedeno OK (obdržena platná odpověď bez chybového kódu), můžete volat další funkci
1 .. 15 = obdržena odpověď s chybou 0x01 až 0x0F, můžete volat další funkci
256 = pracuji, čekejte na aktualizovanou hodnotu

sys[2417] až sys[2462] reserved

sys[2463] 09 i R poslední hodnota Unit Identifier zapsaná do MBAP hlavičky při odeslání zprávy

sys[2464] 09 i R poslední hodnota Transaction Identifier zapsaná do MBAP hlavičky při odeslání zprávy

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).

sys[2465] 09 i R timestamp poslední přijaté zprávy
(vhodné pro detekci nové přijaté zprávy)

sys[2466] 09 i R počet přijatých položek, pro poslední přijatou zprávu
(počet celých položek)

sys[2467] 09 i R přijatá hodnota Unit Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2468] 09 i R přijatá hodnota Transaction Identifier z příchozí MBAP hlavičky
(hodnota adresy je převzata z příchozí zprávy)

sys[2469] 09 i R adresa první položky coil/input/register (které odpovídá údaj v sys[2470])
(MODBUS způsob číslování položek - adresa 1..n)

sys[2470] až sys[2719]
09 i R přijaté hodnoty pro poslední přijatou zprávu
MODBUS funkce 0x01 a 0x02: každý sys[] má hodnotu 0 až 255, jednotlivé bity určují coils/input
MODBUS funkce 0x03 a 0x04: každý sys[] má hodnotu -32768 až 32767, tedy hodnotu pro každý jeden registr

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.

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.

Rezerva

sys[2715] až sys[2809] reserved

== Statistiky COMx ==

COM1:

sys[2810] 09 i R reserved

sys[2811] 09 i R počet odeslaných bajtů (TX) na port COM1

sys[2812] 09 i R počet neodeslaných bajtů (zahozených) pro port COM1
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2813] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM1

sys[2814] 09 i R počet přijatých bajtů (RX) na portu COM1

sys[2815] 09 i R počet nepřijatých bajtů (ignorované) pro port COM1
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2816] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM1

Rezerva

sys[2817] až sys[2860] reserved

COM6:

sys[2861] 09 i R počet odeslaných bajtů (TX) na port COM6

sys[2862] 09 i R počet neodeslaných bajtů (zahozených) pro port COM6
(tzn. SDS chce odeslat více bajtů než zvládá nastavená rychlost COM portu)

sys[2863] 09 i R počet čekajících bajtů na odeslání (TX) ve frontě pro port COM6

sys[2864] 09 i R počet přijatých bajtů (RX) na portu COM6

sys[2865] 09 i R počet nepřijatých bajtů (ignorované) pro port COM6
(tzn. pro případ kdy do SDS je posláno více bajtů než SDS zpracuje, a tak musí zahazovat)

sys[2866] 09 i R počet nevyzvednutých přijatých bajtů (RX) ve frontě pro port COM6

Pro využití všech těchto statistik, je potřeba mít v SDS aktuální firmware (starší FW zde vrací nuly).

== Konec dokumentu ==

'''Konec dokumentu.'''

SDS BIG: firmware changelog

2025-10-25T13:13:23Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 25.10.2025 ==
* doplněna položka do M2M stránky onewire.csv - uživatelský název každého 1W prvku
* FC: doplněna nová funkcionalita do funkce SDS_reset_program() - viz popis této funkce na wiki

== 11.8.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* FC: přidány indexy 70 a 71 a 72

== 28.3.2025 ==
* oprava odpovědi pro S-UDP příkaz 0x04 (Read FC)

== 15.3.2025 ==
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)

== 27.2.2025 ==
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)
* 512: oprava nefunkčního čtení ze sériové linky COM6

== 8.2.2025 ==
* oprava některých payloadů v protokolu SUDP

== 22.7.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

Firmware

2025-10-25T13:10:59Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

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]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<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]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

FULL-C: general functions

2025-10-25T08:59:04Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Nezařazené funkce FULL-C ==
__NOTOC__

Zde je seznam různých funkcí, které FULL-C poskytuje a které nejsou blíže popsány na specifické tématické stránce:
<pre>
void SDS_reset_program(unsigned int key);
void SDS_set_wdg(unsigned int newTimeOut);
void SDS_kick_wdg(unsigned int key);

void SDS_heap_stats(unsigned int *currentAllocatedBytes,
unsigned int *totalFreeBytes, unsigned int *biggestFreeBlockAvailable);
</pre>

== Účel ==

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.

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.

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.

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.

Další prvky jsou:
* úvodní analýza programu a způsob psaní kódu programu
* detailně sepsané požadavky na všech úrovních, a jejich provázání na kód a test
* sledování využití paměti
* úvodní diagnostika
* průběžná diagnostika
* telemetrie (logování, informace předávané uživateli, historie, záchyt chybových stavů tak aby šla chyba plně identifikovat)
* statická a dynamická analýza kódu programu
* SiL a HiL testování
* Unit Testy
* schopnost programu pracovat v režimu snížené kapacity systému (např. při poškozené části systému)
* odolnost programu a jeho vnitřních prvků a funkcí (především proti integer a buffer overflow)
* zabezpečená komunikační rozhraní (safety a security)
* zabezpečená datová úložiště (safety a security)

Většina těchto prvků je "na vás", tedy SDS poskytuje prostor a možnosti k jejich realizaci.

=== SDS_reset_program(): okamžité nové spuštění FC programu ===

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).

Podmínkou je předání hodnoty ''key'' jako čísla 1.

<pre>
//
SDS_reset_program(1); // reset programu se provede jen a pouze, pokud je parametr == 1

// nebo takto:

unsigned int k;
k = 1234;
SDS_reset_program(k); // protoze "k" neni 1, program bude pokracovat (nestane se restart programu)

k = 1;
SDS_reset_program(k); // a ted uz se program spusti odznova, protoze klic je 1
</pre>

=== SDS_reset_program(): restartování celého SDS modulu ===

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í).

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 !

<pre>
unsigned int dynamic_reset_value;

// calculate
dynamic_reset_value = SDS_get_u(3); // ziskame aktualni cas
dynamic_reset_value = 0xF0000000 | (dynamic_reset_value >> 5); // specialni doplnujici vypocet

// go
SDS_reset_program(dynamic_reset_value); // reset SDS se provede jen tehdy, pokud hodnota odpovida

// ted se bud provedl reset SDS, a proto se sem program uz nedostane (a vse zacne od zacatku),
// nebo se neprovedl (protoze byla neplatna hodnota v dynamic_reset_value)

printf("chyba, neprovedl se reset, zkusim to znovu ?\n");

</pre>

=== SDS_set_wdg(): spuštění dohledu správněhu běhu FC programu ===

Funkce nastaví a okamžitě spustí Watchdog pro FULL-C program - cílem je hlídat "nezaseknutí" vašeho FULL-C programu.

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.

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.

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.

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().

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).

=== SDS_kick_wdg(): průběžná aktualizace dohledu běhu FC programu ===

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).

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).

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á.

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ě !

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.

=== Příklad obsluhy FC-watchdogu ===

<pre>
void main(void)
{
// start programu
SDS_set_wdg(16); // nastav watchdog na 16 sekund

// . . .

for (;;)
{

// . . .

if (vse_je_ok)
{
SDS_kick_wdg(16); // znovunastavení hlídače, od teď máme zase až 16 sekund . . .
}

// . . .

}
</pre>

=== SDS_heap_stats(): zjištění stavu dynamické paměti ===

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()'''.

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).

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()'''.

=== SDS_heap_stats(): příklad ===

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.

<pre>
void main(void)
{
unsigned int currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable;
void * ptr;

printf("START\n");

SDS_heap_stats(&currentAllocatedBytes, &totalFreeBytes, &biggestFreeBlockAvailable);
printf("currentAllocatedBytes: %uB, totalFreeBytes: %uB, biggestFreeBlockAvailable:%uB \n\n",
currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable);

printf("ALLOC 2048 BYTES\n");
ptr = malloc(2048);

SDS_heap_stats(&currentAllocatedBytes, &totalFreeBytes, &biggestFreeBlockAvailable);
printf("currentAllocatedBytes: %uB, totalFreeBytes: %uB, biggestFreeBlockAvailable:%uB \n\n",
currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable);

printf("FREE PTR\n");
free(ptr); ptr = 0;

SDS_heap_stats(&currentAllocatedBytes, &totalFreeBytes, &biggestFreeBlockAvailable);
printf("currentAllocatedBytes: %uB, totalFreeBytes: %uB, biggestFreeBlockAvailable:%uB \n\n",
currentAllocatedBytes, totalFreeBytes, biggestFreeBlockAvailable);

}
</pre>

== Důležité systémové indexy ==

* '''40''': SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)
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)

* '''86''': FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)
Využijte pro vzdálené sledování stavu programu (je-li spuštěn a běží, nebo je-li pozastaven či vůbec neběží).

* '''87''': FC: unique identifier of the actually uploaded FULL-C program
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).

* '''132''': FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
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.

* '''133''': FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
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.

* '''134''': FC: archived text of the last FC error
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.

* '''135''': FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)
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.

* '''136''': FC: total count of all FC program starts, since the SDS boot
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.

* '''137''': read an actual SDS CPU cycle counter (number of executed instructions since power-up/reboot), continuously wraps around, (1 step = approx. 2 nsec)
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.

* '''183''': SDS FW date stamp (or just 0x00000000 for a very old firmware)
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.

* '''184''': FC: information about how this actual running program was started (0 = none) (1 = normal) (2 = fc-wdg or manual restart) (4 = freshly loaded)
Informace, jakým způsobem byl aktuální běžící FC program spuštěn.

* '''185''': FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec
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.

New Device First Setup Steps

2025-08-11T10:44:58Z

Adamn:

== Nově zakoupené zařízení SDS ==
<br><br>

1. VŽDY AKTUALIZUJTE NA NOVÝ FIRMWARE - který získáte na stránce [[Firmware]].

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)

'''Pouze takto připravené zařízení lze dále provozovat.'''

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.

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 !!!

== Důsledky neprovedení výše uvedených kroků ==

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).

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á.

New Device First Setup Steps

2025-08-11T10:44:48Z

Adamn:

== Nově zakoupené zařízení SDS ==
<br><br>

1. VŽDY AKTUALIZUJTE NA NOVÝ FIRMWARE - který získáte na stránce [[Firmware]].

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)

'''Pouze takto připravené zařízení lze dále provozovat.'''

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.

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 !!!

== Důsledky neprovedení výše uvedených kroků ==

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).

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á.

SDS BIG: firmware changelog

2025-08-11T10:38:49Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 11.8.2025 ==
* přepracována interní DNS cache - pro funkci dns_resolv() - zprovozněno TTL
* FC: přidány indexy 70 a 71 a 72

== 28.3.2025 ==
* oprava odpovědi pro S-UDP příkaz 0x04 (Read FC)

== 15.3.2025 ==
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)

== 27.2.2025 ==
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)
* 512: oprava nefunkčního čtení ze sériové linky COM6

== 8.2.2025 ==
* oprava některých payloadů v protokolu SUDP

== 22.7.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

Firmware

2025-08-11T10:37:16Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

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]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<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]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

New Device First Setup Steps

2025-08-11T08:00:05Z

Adamn:

New Device First Setup Steps

2025-08-11T07:58:44Z

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…“

== 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 FACTORY RESET (aktivace RSTD) - a to i v případě, že jste firmware neaktualizovali (tzn. že už v zařízení byl nejnovější FW)

Pouze takto připravené zařízení lze dále provozovat.

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.

Firmware

2025-08-11T07:56:15Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

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]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<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]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

FULL-C dns resolv functions

2025-08-10T16:32:01Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==
__NOTOC__

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.

Za tímto účelem jsou k dispozici tyto dvě funkce:
<pre>
void dns_resolv(char *domainNameInput);
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);
</pre>

== Princip ==

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).

Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.

'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''

== Příklad ==

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).

<pre>
void main(void)
{
char DNSname[96];
unsigned int status;
unsigned int IP0, IP1, IP2, IP3;

sprintf((char *)DNSname, "www.google.com");

printf("RESOLVING %s \n", DNSname);

// start - select the new DNSname for all the subsequent status function calls
dns_resolv(DNSname);

// get the first status value
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
// only if truly working, keep waiting
while (512 == status)
{
// keep getting a new status, until it is different than 512
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
}

// check the final status value
if (513 == status)
{
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);
// only in this case, we can use the IPx address
// ... OK

// we can print the additional internal DNS cache status, for this particular domain
// note. the value is valid only if the status is 512, otherwise not
unsigned int ttl;
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item
printf("REMAINING DNS-CACHE TTL-VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);
} else
{
printf("DNS RESOLV FAILED (error %u) \n", status);
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again
}

}
</pre>

== Interní DNS cache ==

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ěď,
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).

Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().

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.

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.

Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.

Toto si řídí SDS interně.

Každou 1 sekundu dojde ke snížení zbývajících hodnot TTL u všech záznamů v interní cache.

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).

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ý).

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).

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).

== Upozornění ==

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.

DNS cache je (záměrně) vymazána při:
* nahrání nového FULLC programu
* restartu zařízení SDS

DNS cache není vymazána při výpadku Ethernetového připojení.

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).

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).

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.

== Stavové hodnoty ==

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).

dns_resolv_status() význam
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)
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)
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)
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)
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu
516 | dotaz selhal, protože došlo k odpojení Ethernetu
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)

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().

FULL-C: set and get

2025-08-10T16:22:06Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Jak je FULL-C program připojen k hardware ==

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é).

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).

Zde je seznam těchto funkcí:
<pre>
void SDS_set_i32(unsigned int index, signed int value);
signed int SDS_get_i32(unsigned int index);

void SDS_set_i64(unsigned int index, int64_t value);
signed int SDS_get_i64(unsigned int index);

void SDS_set_u32(unsigned int index, unsigned int value);
unsigned int SDS_get_u32(unsigned int index);

void SDS_set_u64(unsigned int index, uint64_t value);
unsigned int SDS_get_u64(unsigned int index);

void SDS_set_f32(unsigned int index, float value);
float SDS_get_f32(unsigned int index);

void SDS_set_a(unsigned int index, void *ptr, unsigned int len);
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);
</pre>

Historicky zde původně byly i tyto funkce:
<pre>
void SDS_set_i(unsigned int index, signed int value);
signed int SDS_get_i(unsigned int index);

void SDS_set_u(unsigned int index, unsigned int value);
unsigned int SDS_get_u(unsigned int index);
</pre>
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32).
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ý.

=== Detailní Příklady ===

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]].

== Princip ==

Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.

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).

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):

typ položky | rozsah | typ proměnné | postfix set\get funkce
--------------------------+----------------+-----------------+-------------------------
signed 32-bit integer | -2^31..+2^31 | int | _i32
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64
IP address | uchar[4] | unsigned int | _u32
float | IEEE-754 | float | _f32
string (text) | len\maxlen | void* \ char* | _a
binary array | len\maxlen | void* \ char* | _a

Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.

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);''.

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.

== Funkce _u32 \ _i32 \ _f32 ==

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).

Č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é).

První příklad: ''čtení'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
unsigned int NTPtime;
NTPtime = SDS_get_u32(4);
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);
</syntaxhighlight>

Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem
<syntaxhighlight lang="c">
int NTPoffset;
NTPoffset = SDS_get_i32(26);
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);
</syntaxhighlight>

Třetí příklad: ''čtení'' float hodnoty
<syntaxhighlight lang="c">
float AD_Rinput__in_user_units;
AD_Rinput__in_user_units = SDS_get_f32(311);
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);
</syntaxhighlight>

Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)
SDS_set_u32(231, 0xFF);
</syntaxhighlight>

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.

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.

== Funkce _u64 \ _i64 ==

Princip je identický jako pro _u32 a _i32 funkce.

Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.

== Funkce _a ==

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.

První příklad: čtení textového parametru
<syntaxhighlight lang="c">
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00
char sysLoc[32];

// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů
SDS_get_a(2, (void *)sysLoc, 32);

// a můžeme se podívat na výsledek (výpis do konzole)
printf("Nastavená system location: %s \n", sysLoc);
</syntaxhighlight>

Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů
<syntaxhighlight lang="c">
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)
unsigned int OPTOvalues[8];

// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);

// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)
if (0 == OPTOvalues[0]) ...
</syntaxhighlight>
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.

Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.

== Úplné detaily a všechny příklady ==

'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.

== Tabulka ==

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.

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.).

-----------+---------+------+--------------------------------------------------------------------------------------------------------
index | i\u\f\a | dir | comment
-----------+---------+------+--------------------------------------------------------------------------------------------------------
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)
0 | | SET | n/a (read-only)
-----------+---------+------+--
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)
1 | | SET | n/a
-----------+---------+------+--
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)
2 | a | GET | sysLocation (user configured text)
2 | | SET | n/a
-----------+---------+------+--
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)
3 | | SET | n/a
-----------+---------+------+--
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds
4 | | SET | n/a (read-only)
-----------+---------+------+--
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)
5 | | SET | n/a
-----------+---------+------+--
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)
6 | | SET | n/a
-----------+---------+------+--
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)
7 | | SET | n/a
-----------+---------+------+--
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)
8 | | SET | n/a
-----------+---------+------+--
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)
9 | | SET | n/a
-----------+---------+------+--
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)
10 | | SET | n/a
-----------+---------+------+--
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)
11 | | SET | n/a
-----------+---------+------+--
12 | u32 | GET | SDS device IP address (web admin IP)
12 | | SET | n/a (read-only)
-----------+---------+------+--
13..15 | | GET | n/a (reserved)
13..15 | | SET | n/a (reserved)
-----------+---------+------+--
16 | u32 | GET | network gateway IP address
16 | | SET | n/a (read-only)
-----------+---------+------+--
17..19 | | GET | n/a (reserved)
17..19 | | SET | n/a (reserved)
-----------+---------+------+--
20 | u32 | GET | network IP MASK
20 | | SET | n/a (read-only)
-----------+---------+------+--
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)
21 | | SET | n/a (reserved)
-----------+---------+------+--
22 | u32 | GET | SNMPv3 - Engine Boots
22 | | SET | n/a (reserved)
-----------+---------+------+--
23 | u32 | GET | SNMPv3 - Engine Time
23 | | SET | n/a (reserved)
-----------+---------+------+--
24 | u32 | GET | Ethernet Link Status
24 | | SET | n/a (read-only)
-----------+---------+------+--
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)
25 | | SET | n/a (read-only)
-----------+---------+------+--
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)
-----------+---------+------+--
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)
27 | | SET | n/a (read-only)
-----------+---------+------+--
28 | u32 | GET | timestamp of last change (assignment) of IP address
28 | | SET | n/a (read-only)
-----------+---------+------+--
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)
29 | | SET | n/a (read-only)
-----------+---------+------+--
30 | u32 | GET | DHCP lease time (secs) value
30 | | SET | n/a (read-only)
-----------+---------+------+--
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)
31 | | SET | n/a (read-only)
-----------+---------+------+--
32 | u32 | GET | MAC[1]
32 | | SET | n/a (read-only)
-----------+---------+------+--
33 | u32 | GET | MAC[2]
33 | | SET | n/a (read-only)
-----------+---------+------+--
34 | u32 | GET | MAC[3]
34 | | SET | n/a (read-only)
-----------+---------+------+--
35 | u32 | GET | MAC[4]
35 | | SET | n/a (read-only)
-----------+---------+------+--
36 | u32 | GET | MAC[5]
36 | | SET | n/a (read-only)
-----------+---------+------+--
37..39 | | GET | n/a (reserved)
37..39 | | SET | n/a (read-only)
-----------+---------+------+--
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)
40 | | SET | n/a (read-only)
-----------+---------+------+--
41 | a | GET | OEM branding (login web page) [32 chars]
41 | a | SET | set custom OEM branding (login web page) [32 chars]
-----------+---------+------+--
42 | a | GET | OEM branding (welcome web page) [128 chars]
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]
-----------+---------+------+--
43 | u32 | GET | NTP-server IP address
43 | | SET | n/a (read-only)
-----------+---------+------+--
44 | u32 | GET | NTP-client status (0 = NOT synchronized)
44 | | SET | n/a (read-only)
-----------+---------+------+--
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)
45 | | SET | n/a (read-only)
-----------+---------+------+--
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)
46 | | SET | n/a (read-only)
-----------+---------+------+--
48..60 | | GET | n/a (reserved)
48..60 | | SET | n/a (reserved)
-----------+---------+------+--
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)
61 | | SET | n/a (read-only)
-----------+---------+------+--
62..63 | | GET | n/a (reserved)
62..63 | | SET | n/a (reserved)
-----------+---------+------+--
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)
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0
-----------+---------+------+--
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)
65 | u32 | SET | n/a (reserved)
-----------+---------+------+--
66 | u32 | GET | DNS-server IP address
66 | | SET | n/a (read-only)
-----------+---------+------+--
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)
67 | | SET | n/a (read-only)
-----------+---------+------+--
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)
68 | | SET | n/a (read-only)
-----------+---------+------+--
69 | | GET | n/a (reserved)
69 | | SET | n/a (reserved)
-----------+---------+------+--
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)
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)
-----------+---------+------+--
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)
71 | | SET | n/a (reserved)
-----------+---------+------+--
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)
72 | u32 | SET | DNS RESOLV - set the hard TTL value limit (in seconds)
-----------+---------+------+--
73..77 | | GET | n/a (reserved)
73..77 | | SET | n/a (reserved)
-----------+---------+------+--
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs
78 | | SET | n/a (reserved)
-----------+---------+------+--
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)
79 | | SET | n/a (reserved)
-----------+---------+------+--
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84
80 | | SET | n/a (reserved)
-----------+---------+------+--
81..84 | | GET | n/a (reserved)
81..84 | | SET | n/a (reserved)
-----------+---------+------+--
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2
85 | | SET | n/a (reserved)
-----------+---------+------+--
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)
86 | | SET | n/a (reserved)
-----------+---------+------+--
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program
87 | | SET | n/a (reserved)
-----------+---------+------+--
88 | | GET | n/a (reserved)
88 | | SET | n/a (reserved)
-----------+---------+------+--
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)
89 | | SET | n/a (read-only)
-----------+---------+------+--
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)
90 | | SET | n/a (read-only)
-----------+---------+------+--
91 | u32 | GET | SDS IP-WatchDog: logical output status
91 | | SET | n/a (read-only)
-----------+---------+------+--
92..131 | | GET | n/a (reserved)
92..131 | | SET | n/a (reserved)
-----------+---------+------+--
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
132 | | SET | n/a (read-only)
-----------+---------+------+--
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
133 | | SET | n/a (read-only)
-----------+---------+------+--
134 | a | GET | FC: archived text of the last FC error
134 | | SET | n/a (read-only)
-----------+---------+------+--
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)
135 | | SET | n/a (read-only)
-----------+---------+------+--
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot
136 | | SET | n/a (read-only)
-----------+---------+------+--
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)
137 | | SET | n/a
-----------+---------+------+--
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)
138 | | SET | n/a
-----------+---------+------+--
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied
139 | | SET | n/a
-----------+---------+------+--
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)
-----------+---------+------+--
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)
-----------+---------+------+--
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)
-----------+---------+------+--
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)
-----------+---------+------+--
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)
-----------+---------+------+--
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)
-----------+---------+------+--
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)
-----------+---------+------+--
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)
-----------+---------+------+--
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)
-----------+---------+------+--
149 | | GET | n/a (reserved)
149 | | SET | n/a (reserved)
-----------+---------+------+--
150 | | GET | FC: shared-variables access control - read state of the access control
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)
-----------+---------+------+--
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)
151..182 | | SET | n/a (read-only)
-----------+---------+------+--
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
183 | | SET | n/a (read-only)
-----------+---------+------+--
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)
184 | | SET | n/a (read-only)
-----------+---------+------+--
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec
185 | | SET | n/a (read-only)
-----------+---------+------+--
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
188 | u32 | GET | PWM3 HW: direct "pulse" register value
188 | | SET | n/a
-----------+---------+------+--
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
190 | u32 | GET | PWM4 HW: direct "pulse" register value
190 | | SET | n/a
-----------+---------+------+--
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value
-----------+---------+------+--
194 | u32 | GET | reserved
194 | | SET | N/A
-----------+---------+------+--
195 | u32 | GET | reserved
195 | | SET | N/A
-----------+---------+------+--
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)
-----------+---------+------+--
229..230 | | GET | n/a (reserved)
229..230 | | SET | n/a (reserved)
-----------+---------+------+--
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)
-----------+---------+------+--
263..265 | | GET | n/a (reserved)
263..265 | | SET | n/a (reserved)
-----------+---------+------+--
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)
266..297 | | SET | n/a (read-only)
-----------+---------+------+--
298..300 | | GET | n/a (reserved)
298..300 | | SET | n/a (reserved)
-----------+---------+------+--
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)
-----------+---------+------+--
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)
-----------+---------+------+--
303..310 | | GET | n/a (reserved)
303..310 | | SET | n/a (reserved)
-----------+---------+------+--
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input
311..342 | | SET | n/a (read-only)
-----------+---------+------+--
343..374 | a | GET | AD: input identification / name (text)
343..374 | | SET | n/a (read-only)
-----------+---------+------+--
375..406 | a | GET | AD: input unit name (text)
375..406 | | SET | n/a (read-only)
-----------+---------+------+--
407..427 | | GET | n/a (reserved)
407..427 | | SET | n/a (reserved)
-----------+---------+------+--
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV)
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW
-----------+---------+------+--
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)
429 | | SET | n/a (read-only)
-----------+---------+------+--
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)
430 | | SET | n/a (read-only)
-----------+---------+------+--
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)
431..438 | | SET | n/a (read-only)
-----------+---------+------+--
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant
439..446 | | SET | n/a (read-only)
-----------+---------+------+--
447..462 | | GET | n/a (reserved)
447..462 | | SET | n/a (reserved)
-----------+---------+------+--
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]
463..469 | | SET | n/a (read-only)
-----------+---------+------+--
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]
470..476 | | SET | n/a (read-only)
-----------+---------+------+--
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]
477..483 | | SET | n/a (read-only)
-----------+---------+------+--
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]
484..490 | | SET | n/a (read-only)
-----------+---------+------+--
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]
491..497 | | SET | n/a (read-only)
-----------+---------+------+--
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]
498..504 | | SET | n/a (read-only)
-----------+---------+------+--
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]
505..511 | | SET | n/a (read-only)
-----------+---------+------+--
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]
512..518 | | SET | n/a (read-only)
-----------+---------+------+--
519..991 | | GET | n/a (reserved)
519..991 | | SET | n/a (reserved)
-----------+---------+------+--
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)
992 | | SET | n/a (reserved)
-----------+---------+------+--
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)
993 | | SET | n/a (reserved)
-----------+---------+------+--
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
994 | | SET | n/a (reserved)
-----------+---------+------+--
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])
995 | | SET | n/a (reserved)
-----------+---------+------+--
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])
996 | | SET | n/a (reserved)
-----------+---------+------+--
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active
997 | | SET | n/a (reserved)
-----------+---------+------+--
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active
998 | | SET | n/a (reserved)
-----------+---------+------+--
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)
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)
-----------+---------+------+--
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses
1064..1095| | SET | n/a (read-only)
-----------+---------+------+--
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse
1096..1127| | SET | n/a (read-only)
-----------+---------+------+--
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])
1128..1159| | SET | n/a (reserved)
-----------+---------+------+--
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])
1160..1191| | SET | n/a (reserved)
-----------+---------+------+--
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now
1192..1223| | SET | n/a (reserved)
-----------+---------+------+--
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now
1224..1255| | SET | n/a (reserved)
-----------+---------+------+--
1256..1499| | GET | n/a (reserved)
1256..1499| | SET | n/a (reserved)
-----------+---------+------+--
1500..1531| a | GET | [S0-input] master configuration struct for this input
1500..1531| a | SET | n/a (reserved)
-----------+---------+------+--
1532..1999| | GET | n/a (reserved)
1532..1999| | SET | n/a (reserved)
-----------+---------+------+--
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status
2000..2063| | SET | n/a (reserved)
-----------+---------+------+--
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device
2100..2163| | SET | n/a (reserved)
-----------+---------+------+--
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)
2200..2263| | SET | n/a (reserved)
-----------+---------+------+--
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)
2300..2363| | SET | n/a (reserved)
-----------+---------+------+--
2364..2487| | GET | n/a (reserved)
2364..2487| | SET | n/a (reserved)
-----------+---------+------+--
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)
2488..2495| | SET | n/a
-----------+---------+------+--
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)
2496 | | SET | n/a
-----------+---------+------+--
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)
2497 | | SET | n/a
-----------+---------+------+--
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)
2498 | | SET | n/a
-----------+---------+------+--
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)
2499 | | SET | n/a
-----------+---------+------+--
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status
2500..2563| | SET | n/a (reserved)
-----------+---------+------+--
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device
2600..2663| | SET | n/a (reserved)
-----------+---------+------+--
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)
2700..2763| | SET | n/a (reserved)
-----------+---------+------+--
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)
2800..2863| | SET | n/a (reserved)
-----------+---------+------+--
2864..2986| | GET | n/a (reserved)
2864..2986| | SET | n/a (reserved)
-----------+---------+------+--
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)
2986..2993| | SET | n/a
-----------+---------+------+--
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)
2994 | | SET | n/a
-----------+---------+------+--
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)
2995 | | SET | n/a
-----------+---------+------+--
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)
2996 | | SET | n/a
-----------+---------+------+--
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)
2997 | | SET | n/a
-----------+---------+------+--
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user
2998 | | SET | n/a (read-only)
-----------+---------+------+--
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)
2999 | | SET | n/a (read-only)
-----------+---------+------+--
3000 | | GET | n/a (reserved)
3000 | | SET | n/a (reserved)
-----------+---------+------+--
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)
3001 | a | SET | write
-----------+---------+------+--
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)
3002 | a | SET | write
-----------+---------+------+--
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)
3003 | a | SET | write
-----------+---------+------+--
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)
3004 | a | SET | write
-----------+---------+------+--
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)
3005 | a | SET | write
-----------+---------+------+--
3006..3799| | GET | n/a (reserved)
3006..3799| | SET | n/a (reserved)
-----------+---------+------+--
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected
3800 | | SET | n/a (read-only)
-----------+---------+------+--
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801
3801 | | SET | n/a (read-only)
-----------+---------+------+--
3802..3849| | GET | n/a (reserved)
3802..3849| | SET | n/a (reserved)
-----------+---------+------+--
3850 | u32 | GET | SD Card - fully mounted and useable
3850 | | SET | n/a (read-only)
-----------+---------+------+--
3851 | i32 | GET | latest file i/o error code
3851 | | SET | n/a (read-only)
-----------+---------+------+--
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)
3852 | | SET | n/a (read-only)
-----------+---------+------+--
3853 | u32 | GET | SD Card - CardType
3853 | | SET | n/a (read-only)
-----------+---------+------+--
3854 | u32 | GET | SD Card - CID - ProductSN
3854 | | SET | n/a (read-only)
-----------+---------+------+--
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)
3855 | | SET | n/a (read-only)
-----------+---------+------+--
3856 | u32 | GET | statistic counter: SDcard: failed init attempts
3856 | | SET | n/a (read-only)
-----------+---------+------+--
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)
3857 | | SET | n/a (read-only)
-----------+---------+------+--
3858 | u32 | GET | statistic counter: SDcard: sector reads
3858 | | SET | n/a (read-only)
-----------+---------+------+--
3859 | u32 | GET | statistic counter: SDcard: sector writes
3859 | | SET | n/a (read-only)
-----------+---------+------+--
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures
3860 | | SET | n/a (read-only)
-----------+---------+------+--
3861 | u32 | GET | statistic counter: number of opened files
3861 | | SET | n/a (read-only)
-----------+---------+------+--
3862..3999| | GET | n/a (reserved)
3862..3999| | SET | n/a (reserved)
-----------+---------+------+--
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write
-----------+---------+------+--
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write
-----------+---------+------+--
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write
-----------+---------+------+--
4300..4399| a | GET | Shared Variables: T00 through T99 - read
4300..4399| a | SET | Shared Variables: T00 through T99 - write
-----------+---------+------+--
4400..4989| | GET | n/a (reserved)
4400..4989| | SET | n/a (reserved)
-----------+---------+------+--
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)
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10
-----------+---------+------+--
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read
-----------+-+-------+------+--
5128..11197 | | GET | n/a (reserved)
5128..11197 | | SET | n/a (reserved)
-----------+-+-------+------+--
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN )
11198 | u32 | SET | write ( default: 0b00110001 )
-----------+---------+------+--
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)
11199 | | SET | n/a
-----------+---------+------+--
12200 | i32 | GET | work progress (and result) of mqtt_connect()
12200 | | SET | n/a
-----------+---------+------+--
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()
12201 | | SET | n/a
-----------+---------+------+--
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
12202 | | SET | n/a
-----------+---------+------+--
12203 | i32 | GET | MQTT protocol error counter (informative)
12203 | | SET | n/a
-----------+--+------+------+--
12204..12208 | | GET | n/a (reserved)
12204..12208 | | SET | n/a (reserved)
-----------+--+------+------+--
12209 | i32 | GET | Subscribe Table - total number of available rows
12209 | | SET | n/a
-----------+---------+------+--
12210 | a | GET | latest received Topic Name (sent from broker)
12210 | | SET | n/a
-----------+--+------+------+--
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row
12211..12241 | | SET | n/a
--------------+------+------+--
12242..12249 | | GET | n/a (reserved)
12242..12249 | | SET | n/a
-----------+--+------+------+--
12250 | a | GET | latest received Value (sent from broker)
12250 | | SET | n/a
-----------+--+------+------+--
12251..12281 | a | GET | Subscribe Table: actual Value for each table row
12251..12281 | | SET | n/a
--------------+------+------+--
12282..12289 | | GET | n/a (reserved)
12282..12289 | | SET | n/a
-----------+--+------+------+--
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker
12290 | | SET | n/a
-----------+--+------+--+---+--+--
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row
12291..12321 | | SET | n/a
--------------+------+--+---+--+--
12322..12398 | | GET | n/a (reserved)
12322..12398 | | SET | n/a (reserved)
-----------+--+------+------+--
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)
12399 | | SET | n/a
-----------+---------+------+--
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()
12400 | | SET | n/a
-----------+---------+------+--
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);
12401 | | SET | n/a
-----------+---------+------+--
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);
12402 | | SET | n/a
-----------+---------+------+--
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);
12403 | | SET | n/a
-----------+---------+------+--
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);
12404 | | SET | n/a
-----------+---------+------+--
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
12405 | | SET | n/a
-----------+---------+------+--
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
12406 | | SET | n/a
-----------+--+------+------+--
12407..12414 | | GET | n/a (reserved)
12407..12414 | | SET | n/a (reserved)
-----------+--+------+------+--
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
12415 | | SET | n/a
-----------+---------+------+--
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
12416 | | SET | n/a
-----------+--+------+------+--
12417..12462 | | GET | n/a (reserved)
12417..12462 | | SET | n/a (reserved)
-----------+--+------+------+--
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)
12463 | | SET | n/a
-----------+---------+------+--
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)
12464 | | SET | n/a
-----------+---------+------+--
12465 | u/i 32 | GET | timestamp of the latest received message
12465 | | SET | n/a
-----------+---------+------+--
12466 | u/i 32 | GET | a count of received items inside the latest received message
12466 | | SET | n/a
-----------+---------+------+--
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)
12467 | | SET | n/a
-----------+---------+------+--
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)
12468 | | SET | n/a
-----------+---------+------+--
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)
12469 | | SET | n/a
-----------+--+------+--+---+--+--
12470..12719 | i32 (a) | GET | received values (latest received message contents)
12470..12719 | | SET | n/a
--------------+---------+------+--

'''Poznámky'''

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.

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).
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.
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.

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).

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.

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.

'''Vysvětlení položek'''

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í.
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).

'''Vstupy pro měření napětí'''

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]].

__NOTOC__

FULL-C dns resolv functions

2025-08-10T09:55:51Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==
__NOTOC__

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.

Za tímto účelem jsou k dispozici tyto dvě funkce:
<pre>
void dns_resolv(char *domainNameInput);
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);
</pre>

== Princip ==

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).

Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.

'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''

== Příklad ==

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).

<pre>
void main(void)
{
char DNSname[96];
unsigned int status;
unsigned int IP0, IP1, IP2, IP3;

sprintf((char *)DNSname, "www.google.com");

printf("RESOLVING %s \n", DNSname);

// start - select the new DNSname for all the subsequent status function calls
dns_resolv(DNSname);

// get the first status value
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
// only if truly working, keep waiting
while (512 == status)
{
// keep getting a new status, until it is different than 512
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
}

// check the final status value
if (513 == status)
{
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);
// only in this case, we can use the IPx address
// ... OK

// we can print the additional internal DNS cache status, for this particular domain
// note. the value is valid only if the status is 512, otherwise not
unsigned int ttl;
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item
printf("REMAINING DNS-CACHE TTL-VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);
} else
{
printf("DNS RESOLV FAILED (error %u) \n", status);
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again
}

}
</pre>

== Interní DNS cache ==

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ěď,
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).

Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().

Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS.

Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.

Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.

Toto si řídí SDS interně.

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.

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).

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().

== Upozornění ==

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.

DNS cache je (záměrně) vymazána při:
* nahrání nového FULLC programu
* restartu zařízení SDS

DNS cache není vymazána při výpadku Ethernetového připojení.

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).

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.

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.

== Stavové hodnoty ==

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).

dns_resolv_status() význam
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)
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)
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)
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)
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu
516 | dotaz selhal, protože došlo k odpojení Ethernetu
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)

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().

FULL-C dns resolv functions

2025-08-10T09:52:15Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==
__NOTOC__

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.

Za tímto účelem jsou k dispozici tyto dvě funkce:
<pre>
void dns_resolv(char *domainNameInput);
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);
</pre>

== Princip ==

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).

Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.

'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''

== Příklad ==

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).

<pre>
void main(void)
{
char DNSname[96];
unsigned int status;
unsigned int IP0, IP1, IP2, IP3;

sprintf((char *)DNSname, "www.google.com");

printf("RESOLVING %s \n", DNSname);

// start - select the new DNSname for all the subsequent status function calls
dns_resolv(DNSname);

// get the first status value
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
// only if truly working, keep waiting
while (512 == status)
{
// keep getting a new status, until it is different than 512
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
}

// check the final status value
if (513 == status)
{
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);
// only in this case, we can use the IPx address
// ... OK

// we can print the additional internal DNS cache status, for this particular domain
// note. the value is valid only if the status is 512, otherwise not
unsigned int ttl;
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item
printf("DNS CACHE TTL VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);
} else
{
printf("DNS RESOLV FAILED (error %u) \n", status);
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again
}

}
</pre>

== Interní DNS cache ==

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ěď,
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).

Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().

Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS.

Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.

Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.

Toto si řídí SDS interně.

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.

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).

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().

== Upozornění ==

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.

DNS cache je (záměrně) vymazána při:
* nahrání nového FULLC programu
* restartu zařízení SDS

DNS cache není vymazána při výpadku Ethernetového připojení.

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).

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.

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.

== Stavové hodnoty ==

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).

dns_resolv_status() význam
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)
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)
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)
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)
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu
516 | dotaz selhal, protože došlo k odpojení Ethernetu
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)

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().

FULL-C: set and get

2025-08-10T09:39:15Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Jak je FULL-C program připojen k hardware ==

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é).

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).

Zde je seznam těchto funkcí:
<pre>
void SDS_set_i32(unsigned int index, signed int value);
signed int SDS_get_i32(unsigned int index);

void SDS_set_i64(unsigned int index, int64_t value);
signed int SDS_get_i64(unsigned int index);

void SDS_set_u32(unsigned int index, unsigned int value);
unsigned int SDS_get_u32(unsigned int index);

void SDS_set_u64(unsigned int index, uint64_t value);
unsigned int SDS_get_u64(unsigned int index);

void SDS_set_f32(unsigned int index, float value);
float SDS_get_f32(unsigned int index);

void SDS_set_a(unsigned int index, void *ptr, unsigned int len);
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);
</pre>

Historicky zde původně byly i tyto funkce:
<pre>
void SDS_set_i(unsigned int index, signed int value);
signed int SDS_get_i(unsigned int index);

void SDS_set_u(unsigned int index, unsigned int value);
unsigned int SDS_get_u(unsigned int index);
</pre>
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32).
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ý.

=== Detailní Příklady ===

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]].

== Princip ==

Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.

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).

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):

typ položky | rozsah | typ proměnné | postfix set\get funkce
--------------------------+----------------+-----------------+-------------------------
signed 32-bit integer | -2^31..+2^31 | int | _i32
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64
IP address | uchar[4] | unsigned int | _u32
float | IEEE-754 | float | _f32
string (text) | len\maxlen | void* \ char* | _a
binary array | len\maxlen | void* \ char* | _a

Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.

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);''.

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.

== Funkce _u32 \ _i32 \ _f32 ==

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).

Č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é).

První příklad: ''čtení'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
unsigned int NTPtime;
NTPtime = SDS_get_u32(4);
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);
</syntaxhighlight>

Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem
<syntaxhighlight lang="c">
int NTPoffset;
NTPoffset = SDS_get_i32(26);
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);
</syntaxhighlight>

Třetí příklad: ''čtení'' float hodnoty
<syntaxhighlight lang="c">
float AD_Rinput__in_user_units;
AD_Rinput__in_user_units = SDS_get_f32(311);
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);
</syntaxhighlight>

Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)
SDS_set_u32(231, 0xFF);
</syntaxhighlight>

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.

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.

== Funkce _u64 \ _i64 ==

Princip je identický jako pro _u32 a _i32 funkce.

Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.

== Funkce _a ==

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.

První příklad: čtení textového parametru
<syntaxhighlight lang="c">
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00
char sysLoc[32];

// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů
SDS_get_a(2, (void *)sysLoc, 32);

// a můžeme se podívat na výsledek (výpis do konzole)
printf("Nastavená system location: %s \n", sysLoc);
</syntaxhighlight>

Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů
<syntaxhighlight lang="c">
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)
unsigned int OPTOvalues[8];

// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);

// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)
if (0 == OPTOvalues[0]) ...
</syntaxhighlight>
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.

Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.

== Úplné detaily a všechny příklady ==

'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.

== Tabulka ==

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.

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.).

-----------+---------+------+--------------------------------------------------------------------------------------------------------
index | i\u\f\a | dir | comment
-----------+---------+------+--------------------------------------------------------------------------------------------------------
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)
0 | | SET | n/a (read-only)
-----------+---------+------+--
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)
1 | | SET | n/a
-----------+---------+------+--
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)
2 | a | GET | sysLocation (user configured text)
2 | | SET | n/a
-----------+---------+------+--
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)
3 | | SET | n/a
-----------+---------+------+--
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds
4 | | SET | n/a (read-only)
-----------+---------+------+--
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)
5 | | SET | n/a
-----------+---------+------+--
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)
6 | | SET | n/a
-----------+---------+------+--
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)
7 | | SET | n/a
-----------+---------+------+--
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)
8 | | SET | n/a
-----------+---------+------+--
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)
9 | | SET | n/a
-----------+---------+------+--
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)
10 | | SET | n/a
-----------+---------+------+--
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)
11 | | SET | n/a
-----------+---------+------+--
12 | u32 | GET | SDS device IP address (web admin IP)
12 | | SET | n/a (read-only)
-----------+---------+------+--
13..15 | | GET | n/a (reserved)
13..15 | | SET | n/a (reserved)
-----------+---------+------+--
16 | u32 | GET | network gateway IP address
16 | | SET | n/a (read-only)
-----------+---------+------+--
17..19 | | GET | n/a (reserved)
17..19 | | SET | n/a (reserved)
-----------+---------+------+--
20 | u32 | GET | network IP MASK
20 | | SET | n/a (read-only)
-----------+---------+------+--
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)
21 | | SET | n/a (reserved)
-----------+---------+------+--
22 | u32 | GET | SNMPv3 - Engine Boots
22 | | SET | n/a (reserved)
-----------+---------+------+--
23 | u32 | GET | SNMPv3 - Engine Time
23 | | SET | n/a (reserved)
-----------+---------+------+--
24 | u32 | GET | Ethernet Link Status
24 | | SET | n/a (read-only)
-----------+---------+------+--
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)
25 | | SET | n/a (read-only)
-----------+---------+------+--
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)
-----------+---------+------+--
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)
27 | | SET | n/a (read-only)
-----------+---------+------+--
28 | u32 | GET | timestamp of last change (assignment) of IP address
28 | | SET | n/a (read-only)
-----------+---------+------+--
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)
29 | | SET | n/a (read-only)
-----------+---------+------+--
30 | u32 | GET | DHCP lease time (secs) value
30 | | SET | n/a (read-only)
-----------+---------+------+--
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)
31 | | SET | n/a (read-only)
-----------+---------+------+--
32 | u32 | GET | MAC[1]
32 | | SET | n/a (read-only)
-----------+---------+------+--
33 | u32 | GET | MAC[2]
33 | | SET | n/a (read-only)
-----------+---------+------+--
34 | u32 | GET | MAC[3]
34 | | SET | n/a (read-only)
-----------+---------+------+--
35 | u32 | GET | MAC[4]
35 | | SET | n/a (read-only)
-----------+---------+------+--
36 | u32 | GET | MAC[5]
36 | | SET | n/a (read-only)
-----------+---------+------+--
37..39 | | GET | n/a (reserved)
37..39 | | SET | n/a (read-only)
-----------+---------+------+--
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)
40 | | SET | n/a (read-only)
-----------+---------+------+--
41 | a | GET | OEM branding (login web page) [32 chars]
41 | a | SET | set custom OEM branding (login web page) [32 chars]
-----------+---------+------+--
42 | a | GET | OEM branding (welcome web page) [128 chars]
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]
-----------+---------+------+--
43 | u32 | GET | NTP-server IP address
43 | | SET | n/a (read-only)
-----------+---------+------+--
44 | u32 | GET | NTP-client status (0 = NOT synchronized)
44 | | SET | n/a (read-only)
-----------+---------+------+--
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)
45 | | SET | n/a (read-only)
-----------+---------+------+--
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)
46 | | SET | n/a (read-only)
-----------+---------+------+--
48..60 | | GET | n/a (reserved)
48..60 | | SET | n/a (reserved)
-----------+---------+------+--
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)
61 | | SET | n/a (read-only)
-----------+---------+------+--
62..63 | | GET | n/a (reserved)
62..63 | | SET | n/a (reserved)
-----------+---------+------+--
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)
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0
-----------+---------+------+--
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)
65 | u32 | SET | n/a (reserved)
-----------+---------+------+--
66 | u32 | GET | DNS-server IP address
66 | | SET | n/a (read-only)
-----------+---------+------+--
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)
67 | | SET | n/a (read-only)
-----------+---------+------+--
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)
68 | | SET | n/a (read-only)
-----------+---------+------+--
69 | | GET | n/a (reserved)
69 | | SET | n/a (reserved)
-----------+---------+------+--
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)
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)
-----------+---------+------+--
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)
71 | | SET | n/a (reserved)
-----------+---------+------+--
72..77 | | GET | n/a (reserved)
72..77 | | SET | n/a (reserved)
-----------+---------+------+--
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs
78 | | SET | n/a (reserved)
-----------+---------+------+--
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)
79 | | SET | n/a (reserved)
-----------+---------+------+--
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84
80 | | SET | n/a (reserved)
-----------+---------+------+--
81..84 | | GET | n/a (reserved)
81..84 | | SET | n/a (reserved)
-----------+---------+------+--
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2
85 | | SET | n/a (reserved)
-----------+---------+------+--
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)
86 | | SET | n/a (reserved)
-----------+---------+------+--
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program
87 | | SET | n/a (reserved)
-----------+---------+------+--
88 | | GET | n/a (reserved)
88 | | SET | n/a (reserved)
-----------+---------+------+--
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)
89 | | SET | n/a (read-only)
-----------+---------+------+--
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)
90 | | SET | n/a (read-only)
-----------+---------+------+--
91 | u32 | GET | SDS IP-WatchDog: logical output status
91 | | SET | n/a (read-only)
-----------+---------+------+--
92..131 | | GET | n/a (reserved)
92..131 | | SET | n/a (reserved)
-----------+---------+------+--
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
132 | | SET | n/a (read-only)
-----------+---------+------+--
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
133 | | SET | n/a (read-only)
-----------+---------+------+--
134 | a | GET | FC: archived text of the last FC error
134 | | SET | n/a (read-only)
-----------+---------+------+--
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)
135 | | SET | n/a (read-only)
-----------+---------+------+--
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot
136 | | SET | n/a (read-only)
-----------+---------+------+--
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)
137 | | SET | n/a
-----------+---------+------+--
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)
138 | | SET | n/a
-----------+---------+------+--
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied
139 | | SET | n/a
-----------+---------+------+--
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)
-----------+---------+------+--
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)
-----------+---------+------+--
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)
-----------+---------+------+--
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)
-----------+---------+------+--
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)
-----------+---------+------+--
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)
-----------+---------+------+--
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)
-----------+---------+------+--
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)
-----------+---------+------+--
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)
-----------+---------+------+--
149 | | GET | n/a (reserved)
149 | | SET | n/a (reserved)
-----------+---------+------+--
150 | | GET | FC: shared-variables access control - read state of the access control
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)
-----------+---------+------+--
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)
151..182 | | SET | n/a (read-only)
-----------+---------+------+--
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
183 | | SET | n/a (read-only)
-----------+---------+------+--
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)
184 | | SET | n/a (read-only)
-----------+---------+------+--
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec
185 | | SET | n/a (read-only)
-----------+---------+------+--
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
188 | u32 | GET | PWM3 HW: direct "pulse" register value
188 | | SET | n/a
-----------+---------+------+--
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
190 | u32 | GET | PWM4 HW: direct "pulse" register value
190 | | SET | n/a
-----------+---------+------+--
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value
-----------+---------+------+--
194 | u32 | GET | reserved
194 | | SET | N/A
-----------+---------+------+--
195 | u32 | GET | reserved
195 | | SET | N/A
-----------+---------+------+--
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)
-----------+---------+------+--
229..230 | | GET | n/a (reserved)
229..230 | | SET | n/a (reserved)
-----------+---------+------+--
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)
-----------+---------+------+--
263..265 | | GET | n/a (reserved)
263..265 | | SET | n/a (reserved)
-----------+---------+------+--
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)
266..297 | | SET | n/a (read-only)
-----------+---------+------+--
298..300 | | GET | n/a (reserved)
298..300 | | SET | n/a (reserved)
-----------+---------+------+--
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)
-----------+---------+------+--
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)
-----------+---------+------+--
303..310 | | GET | n/a (reserved)
303..310 | | SET | n/a (reserved)
-----------+---------+------+--
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input
311..342 | | SET | n/a (read-only)
-----------+---------+------+--
343..374 | a | GET | AD: input identification / name (text)
343..374 | | SET | n/a (read-only)
-----------+---------+------+--
375..406 | a | GET | AD: input unit name (text)
375..406 | | SET | n/a (read-only)
-----------+---------+------+--
407..427 | | GET | n/a (reserved)
407..427 | | SET | n/a (reserved)
-----------+---------+------+--
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV)
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW
-----------+---------+------+--
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)
429 | | SET | n/a (read-only)
-----------+---------+------+--
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)
430 | | SET | n/a (read-only)
-----------+---------+------+--
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)
431..438 | | SET | n/a (read-only)
-----------+---------+------+--
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant
439..446 | | SET | n/a (read-only)
-----------+---------+------+--
447..462 | | GET | n/a (reserved)
447..462 | | SET | n/a (reserved)
-----------+---------+------+--
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]
463..469 | | SET | n/a (read-only)
-----------+---------+------+--
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]
470..476 | | SET | n/a (read-only)
-----------+---------+------+--
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]
477..483 | | SET | n/a (read-only)
-----------+---------+------+--
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]
484..490 | | SET | n/a (read-only)
-----------+---------+------+--
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]
491..497 | | SET | n/a (read-only)
-----------+---------+------+--
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]
498..504 | | SET | n/a (read-only)
-----------+---------+------+--
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]
505..511 | | SET | n/a (read-only)
-----------+---------+------+--
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]
512..518 | | SET | n/a (read-only)
-----------+---------+------+--
519..991 | | GET | n/a (reserved)
519..991 | | SET | n/a (reserved)
-----------+---------+------+--
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)
992 | | SET | n/a (reserved)
-----------+---------+------+--
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)
993 | | SET | n/a (reserved)
-----------+---------+------+--
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
994 | | SET | n/a (reserved)
-----------+---------+------+--
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])
995 | | SET | n/a (reserved)
-----------+---------+------+--
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])
996 | | SET | n/a (reserved)
-----------+---------+------+--
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active
997 | | SET | n/a (reserved)
-----------+---------+------+--
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active
998 | | SET | n/a (reserved)
-----------+---------+------+--
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)
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)
-----------+---------+------+--
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses
1064..1095| | SET | n/a (read-only)
-----------+---------+------+--
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse
1096..1127| | SET | n/a (read-only)
-----------+---------+------+--
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])
1128..1159| | SET | n/a (reserved)
-----------+---------+------+--
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])
1160..1191| | SET | n/a (reserved)
-----------+---------+------+--
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now
1192..1223| | SET | n/a (reserved)
-----------+---------+------+--
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now
1224..1255| | SET | n/a (reserved)
-----------+---------+------+--
1256..1499| | GET | n/a (reserved)
1256..1499| | SET | n/a (reserved)
-----------+---------+------+--
1500..1531| a | GET | [S0-input] master configuration struct for this input
1500..1531| a | SET | n/a (reserved)
-----------+---------+------+--
1532..1999| | GET | n/a (reserved)
1532..1999| | SET | n/a (reserved)
-----------+---------+------+--
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status
2000..2063| | SET | n/a (reserved)
-----------+---------+------+--
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device
2100..2163| | SET | n/a (reserved)
-----------+---------+------+--
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)
2200..2263| | SET | n/a (reserved)
-----------+---------+------+--
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)
2300..2363| | SET | n/a (reserved)
-----------+---------+------+--
2364..2487| | GET | n/a (reserved)
2364..2487| | SET | n/a (reserved)
-----------+---------+------+--
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)
2488..2495| | SET | n/a
-----------+---------+------+--
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)
2496 | | SET | n/a
-----------+---------+------+--
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)
2497 | | SET | n/a
-----------+---------+------+--
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)
2498 | | SET | n/a
-----------+---------+------+--
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)
2499 | | SET | n/a
-----------+---------+------+--
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status
2500..2563| | SET | n/a (reserved)
-----------+---------+------+--
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device
2600..2663| | SET | n/a (reserved)
-----------+---------+------+--
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)
2700..2763| | SET | n/a (reserved)
-----------+---------+------+--
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)
2800..2863| | SET | n/a (reserved)
-----------+---------+------+--
2864..2986| | GET | n/a (reserved)
2864..2986| | SET | n/a (reserved)
-----------+---------+------+--
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)
2986..2993| | SET | n/a
-----------+---------+------+--
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)
2994 | | SET | n/a
-----------+---------+------+--
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)
2995 | | SET | n/a
-----------+---------+------+--
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)
2996 | | SET | n/a
-----------+---------+------+--
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)
2997 | | SET | n/a
-----------+---------+------+--
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user
2998 | | SET | n/a (read-only)
-----------+---------+------+--
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)
2999 | | SET | n/a (read-only)
-----------+---------+------+--
3000 | | GET | n/a (reserved)
3000 | | SET | n/a (reserved)
-----------+---------+------+--
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)
3001 | a | SET | write
-----------+---------+------+--
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)
3002 | a | SET | write
-----------+---------+------+--
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)
3003 | a | SET | write
-----------+---------+------+--
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)
3004 | a | SET | write
-----------+---------+------+--
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)
3005 | a | SET | write
-----------+---------+------+--
3006..3799| | GET | n/a (reserved)
3006..3799| | SET | n/a (reserved)
-----------+---------+------+--
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected
3800 | | SET | n/a (read-only)
-----------+---------+------+--
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801
3801 | | SET | n/a (read-only)
-----------+---------+------+--
3802..3849| | GET | n/a (reserved)
3802..3849| | SET | n/a (reserved)
-----------+---------+------+--
3850 | u32 | GET | SD Card - fully mounted and useable
3850 | | SET | n/a (read-only)
-----------+---------+------+--
3851 | i32 | GET | latest file i/o error code
3851 | | SET | n/a (read-only)
-----------+---------+------+--
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)
3852 | | SET | n/a (read-only)
-----------+---------+------+--
3853 | u32 | GET | SD Card - CardType
3853 | | SET | n/a (read-only)
-----------+---------+------+--
3854 | u32 | GET | SD Card - CID - ProductSN
3854 | | SET | n/a (read-only)
-----------+---------+------+--
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)
3855 | | SET | n/a (read-only)
-----------+---------+------+--
3856 | u32 | GET | statistic counter: SDcard: failed init attempts
3856 | | SET | n/a (read-only)
-----------+---------+------+--
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)
3857 | | SET | n/a (read-only)
-----------+---------+------+--
3858 | u32 | GET | statistic counter: SDcard: sector reads
3858 | | SET | n/a (read-only)
-----------+---------+------+--
3859 | u32 | GET | statistic counter: SDcard: sector writes
3859 | | SET | n/a (read-only)
-----------+---------+------+--
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures
3860 | | SET | n/a (read-only)
-----------+---------+------+--
3861 | u32 | GET | statistic counter: number of opened files
3861 | | SET | n/a (read-only)
-----------+---------+------+--
3862..3999| | GET | n/a (reserved)
3862..3999| | SET | n/a (reserved)
-----------+---------+------+--
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write
-----------+---------+------+--
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write
-----------+---------+------+--
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write
-----------+---------+------+--
4300..4399| a | GET | Shared Variables: T00 through T99 - read
4300..4399| a | SET | Shared Variables: T00 through T99 - write
-----------+---------+------+--
4400..4989| | GET | n/a (reserved)
4400..4989| | SET | n/a (reserved)
-----------+---------+------+--
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)
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10
-----------+---------+------+--
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read
-----------+-+-------+------+--
5128..11197 | | GET | n/a (reserved)
5128..11197 | | SET | n/a (reserved)
-----------+-+-------+------+--
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN )
11198 | u32 | SET | write ( default: 0b00110001 )
-----------+---------+------+--
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)
11199 | | SET | n/a
-----------+---------+------+--
12200 | i32 | GET | work progress (and result) of mqtt_connect()
12200 | | SET | n/a
-----------+---------+------+--
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()
12201 | | SET | n/a
-----------+---------+------+--
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
12202 | | SET | n/a
-----------+---------+------+--
12203 | i32 | GET | MQTT protocol error counter (informative)
12203 | | SET | n/a
-----------+--+------+------+--
12204..12208 | | GET | n/a (reserved)
12204..12208 | | SET | n/a (reserved)
-----------+--+------+------+--
12209 | i32 | GET | Subscribe Table - total number of available rows
12209 | | SET | n/a
-----------+---------+------+--
12210 | a | GET | latest received Topic Name (sent from broker)
12210 | | SET | n/a
-----------+--+------+------+--
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row
12211..12241 | | SET | n/a
--------------+------+------+--
12242..12249 | | GET | n/a (reserved)
12242..12249 | | SET | n/a
-----------+--+------+------+--
12250 | a | GET | latest received Value (sent from broker)
12250 | | SET | n/a
-----------+--+------+------+--
12251..12281 | a | GET | Subscribe Table: actual Value for each table row
12251..12281 | | SET | n/a
--------------+------+------+--
12282..12289 | | GET | n/a (reserved)
12282..12289 | | SET | n/a
-----------+--+------+------+--
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker
12290 | | SET | n/a
-----------+--+------+--+---+--+--
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row
12291..12321 | | SET | n/a
--------------+------+--+---+--+--
12322..12398 | | GET | n/a (reserved)
12322..12398 | | SET | n/a (reserved)
-----------+--+------+------+--
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)
12399 | | SET | n/a
-----------+---------+------+--
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()
12400 | | SET | n/a
-----------+---------+------+--
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);
12401 | | SET | n/a
-----------+---------+------+--
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);
12402 | | SET | n/a
-----------+---------+------+--
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);
12403 | | SET | n/a
-----------+---------+------+--
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);
12404 | | SET | n/a
-----------+---------+------+--
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
12405 | | SET | n/a
-----------+---------+------+--
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
12406 | | SET | n/a
-----------+--+------+------+--
12407..12414 | | GET | n/a (reserved)
12407..12414 | | SET | n/a (reserved)
-----------+--+------+------+--
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
12415 | | SET | n/a
-----------+---------+------+--
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
12416 | | SET | n/a
-----------+--+------+------+--
12417..12462 | | GET | n/a (reserved)
12417..12462 | | SET | n/a (reserved)
-----------+--+------+------+--
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)
12463 | | SET | n/a
-----------+---------+------+--
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)
12464 | | SET | n/a
-----------+---------+------+--
12465 | u/i 32 | GET | timestamp of the latest received message
12465 | | SET | n/a
-----------+---------+------+--
12466 | u/i 32 | GET | a count of received items inside the latest received message
12466 | | SET | n/a
-----------+---------+------+--
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)
12467 | | SET | n/a
-----------+---------+------+--
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)
12468 | | SET | n/a
-----------+---------+------+--
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)
12469 | | SET | n/a
-----------+--+------+--+---+--+--
12470..12719 | i32 (a) | GET | received values (latest received message contents)
12470..12719 | | SET | n/a
--------------+---------+------+--

'''Poznámky'''

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.

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).
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.
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.

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).

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.

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.

'''Vysvětlení položek'''

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í.
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).

'''Vstupy pro měření napětí'''

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]].

__NOTOC__

FULL-C: set and get

2025-08-10T09:34:38Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Jak je FULL-C program připojen k hardware ==

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é).

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).

Zde je seznam těchto funkcí:
<pre>
void SDS_set_i32(unsigned int index, signed int value);
signed int SDS_get_i32(unsigned int index);

void SDS_set_i64(unsigned int index, int64_t value);
signed int SDS_get_i64(unsigned int index);

void SDS_set_u32(unsigned int index, unsigned int value);
unsigned int SDS_get_u32(unsigned int index);

void SDS_set_u64(unsigned int index, uint64_t value);
unsigned int SDS_get_u64(unsigned int index);

void SDS_set_f32(unsigned int index, float value);
float SDS_get_f32(unsigned int index);

void SDS_set_a(unsigned int index, void *ptr, unsigned int len);
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);
</pre>

Historicky zde původně byly i tyto funkce:
<pre>
void SDS_set_i(unsigned int index, signed int value);
signed int SDS_get_i(unsigned int index);

void SDS_set_u(unsigned int index, unsigned int value);
unsigned int SDS_get_u(unsigned int index);
</pre>
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32).
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ý.

=== Detailní Příklady ===

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]].

== Princip ==

Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.

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).

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):

typ položky | rozsah | typ proměnné | postfix set\get funkce
--------------------------+----------------+-----------------+-------------------------
signed 32-bit integer | -2^31..+2^31 | int | _i32
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64
IP address | uchar[4] | unsigned int | _u32
float | IEEE-754 | float | _f32
string (text) | len\maxlen | void* \ char* | _a
binary array | len\maxlen | void* \ char* | _a

Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.

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);''.

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.

== Funkce _u32 \ _i32 \ _f32 ==

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).

Č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é).

První příklad: ''čtení'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
unsigned int NTPtime;
NTPtime = SDS_get_u32(4);
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);
</syntaxhighlight>

Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem
<syntaxhighlight lang="c">
int NTPoffset;
NTPoffset = SDS_get_i32(26);
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);
</syntaxhighlight>

Třetí příklad: ''čtení'' float hodnoty
<syntaxhighlight lang="c">
float AD_Rinput__in_user_units;
AD_Rinput__in_user_units = SDS_get_f32(311);
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);
</syntaxhighlight>

Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)
SDS_set_u32(231, 0xFF);
</syntaxhighlight>

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.

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.

== Funkce _u64 \ _i64 ==

Princip je identický jako pro _u32 a _i32 funkce.

Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.

== Funkce _a ==

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.

První příklad: čtení textového parametru
<syntaxhighlight lang="c">
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00
char sysLoc[32];

// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů
SDS_get_a(2, (void *)sysLoc, 32);

// a můžeme se podívat na výsledek (výpis do konzole)
printf("Nastavená system location: %s \n", sysLoc);
</syntaxhighlight>

Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů
<syntaxhighlight lang="c">
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)
unsigned int OPTOvalues[8];

// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);

// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)
if (0 == OPTOvalues[0]) ...
</syntaxhighlight>
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.

Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.

== Úplné detaily a všechny příklady ==

'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.

== Tabulka ==

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.

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.).

-----------+---------+------+--------------------------------------------------------------------------------------------------------
index | i\u\f\a | dir | comment
-----------+---------+------+--------------------------------------------------------------------------------------------------------
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)
0 | | SET | n/a (read-only)
-----------+---------+------+--
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)
1 | | SET | n/a
-----------+---------+------+--
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)
2 | a | GET | sysLocation (user configured text)
2 | | SET | n/a
-----------+---------+------+--
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)
3 | | SET | n/a
-----------+---------+------+--
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds
4 | | SET | n/a (read-only)
-----------+---------+------+--
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)
5 | | SET | n/a
-----------+---------+------+--
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)
6 | | SET | n/a
-----------+---------+------+--
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)
7 | | SET | n/a
-----------+---------+------+--
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)
8 | | SET | n/a
-----------+---------+------+--
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)
9 | | SET | n/a
-----------+---------+------+--
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)
10 | | SET | n/a
-----------+---------+------+--
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)
11 | | SET | n/a
-----------+---------+------+--
12 | u32 | GET | SDS device IP address (web admin IP)
12 | | SET | n/a (read-only)
-----------+---------+------+--
13..15 | | GET | n/a (reserved)
13..15 | | SET | n/a (reserved)
-----------+---------+------+--
16 | u32 | GET | network gateway IP address
16 | | SET | n/a (read-only)
-----------+---------+------+--
17..19 | | GET | n/a (reserved)
17..19 | | SET | n/a (reserved)
-----------+---------+------+--
20 | u32 | GET | network IP MASK
20 | | SET | n/a (read-only)
-----------+---------+------+--
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)
21 | | SET | n/a (reserved)
-----------+---------+------+--
22 | u32 | GET | SNMPv3 - Engine Boots
22 | | SET | n/a (reserved)
-----------+---------+------+--
23 | u32 | GET | SNMPv3 - Engine Time
23 | | SET | n/a (reserved)
-----------+---------+------+--
24 | u32 | GET | Ethernet Link Status
24 | | SET | n/a (read-only)
-----------+---------+------+--
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)
25 | | SET | n/a (read-only)
-----------+---------+------+--
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)
-----------+---------+------+--
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)
27 | | SET | n/a (read-only)
-----------+---------+------+--
28 | u32 | GET | timestamp of last change (assignment) of IP address
28 | | SET | n/a (read-only)
-----------+---------+------+--
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)
29 | | SET | n/a (read-only)
-----------+---------+------+--
30 | u32 | GET | DHCP lease time (secs) value
30 | | SET | n/a (read-only)
-----------+---------+------+--
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)
31 | | SET | n/a (read-only)
-----------+---------+------+--
32 | u32 | GET | MAC[1]
32 | | SET | n/a (read-only)
-----------+---------+------+--
33 | u32 | GET | MAC[2]
33 | | SET | n/a (read-only)
-----------+---------+------+--
34 | u32 | GET | MAC[3]
34 | | SET | n/a (read-only)
-----------+---------+------+--
35 | u32 | GET | MAC[4]
35 | | SET | n/a (read-only)
-----------+---------+------+--
36 | u32 | GET | MAC[5]
36 | | SET | n/a (read-only)
-----------+---------+------+--
37..39 | | GET | n/a (reserved)
37..39 | | SET | n/a (read-only)
-----------+---------+------+--
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)
40 | | SET | n/a (read-only)
-----------+---------+------+--
41 | a | GET | OEM branding (login web page) [32 chars]
41 | a | SET | set custom OEM branding (login web page) [32 chars]
-----------+---------+------+--
42 | a | GET | OEM branding (welcome web page) [128 chars]
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]
-----------+---------+------+--
43 | u32 | GET | NTP-server IP address
43 | | SET | n/a (read-only)
-----------+---------+------+--
44 | u32 | GET | NTP-client status (0 = NOT synchronized)
44 | | SET | n/a (read-only)
-----------+---------+------+--
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)
45 | | SET | n/a (read-only)
-----------+---------+------+--
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)
46 | | SET | n/a (read-only)
-----------+---------+------+--
48..60 | | GET | n/a (reserved)
48..60 | | SET | n/a (reserved)
-----------+---------+------+--
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)
61 | | SET | n/a (read-only)
-----------+---------+------+--
62..63 | | GET | n/a (reserved)
62..63 | | SET | n/a (reserved)
-----------+---------+------+--
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)
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0
-----------+---------+------+--
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)
65 | u32 | SET | n/a (reserved)
-----------+---------+------+--
66 | u32 | GET | DNS-server IP address
66 | | SET | n/a (read-only)
-----------+---------+------+--
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)
67 | | SET | n/a (read-only)
-----------+---------+------+--
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)
68 | | SET | n/a (read-only)
-----------+---------+------+--
69 | | GET | n/a (reserved)
69 | | SET | n/a (reserved)
-----------+---------+------+--
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)
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)
-----------+---------+------+--
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)
71 | | SET | n/a (reserved)
-----------+---------+------+--
72..77 | | GET | n/a (reserved)
72..77 | | SET | n/a (reserved)
-----------+---------+------+--
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs
78 | | SET | n/a (reserved)
-----------+---------+------+--
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)
79 | | SET | n/a (reserved)
-----------+---------+------+--
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84
80 | | SET | n/a (reserved)
-----------+---------+------+--
81..84 | | GET | n/a (reserved)
81..84 | | SET | n/a (reserved)
-----------+---------+------+--
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2
85 | | SET | n/a (reserved)
-----------+---------+------+--
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)
86 | | SET | n/a (reserved)
-----------+---------+------+--
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program
87 | | SET | n/a (reserved)
-----------+---------+------+--
88 | | GET | n/a (reserved)
88 | | SET | n/a (reserved)
-----------+---------+------+--
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)
89 | | SET | n/a (read-only)
-----------+---------+------+--
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)
90 | | SET | n/a (read-only)
-----------+---------+------+--
91 | u32 | GET | SDS IP-WatchDog: logical output status
91 | | SET | n/a (read-only)
-----------+---------+------+--
92..131 | | GET | n/a (reserved)
92..131 | | SET | n/a (reserved)
-----------+---------+------+--
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
132 | | SET | n/a (read-only)
-----------+---------+------+--
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
133 | | SET | n/a (read-only)
-----------+---------+------+--
134 | a | GET | FC: archived text of the last FC error
134 | | SET | n/a (read-only)
-----------+---------+------+--
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)
135 | | SET | n/a (read-only)
-----------+---------+------+--
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot
136 | | SET | n/a (read-only)
-----------+---------+------+--
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)
137 | | SET | n/a
-----------+---------+------+--
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)
138 | | SET | n/a
-----------+---------+------+--
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied
139 | | SET | n/a
-----------+---------+------+--
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)
-----------+---------+------+--
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)
-----------+---------+------+--
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)
-----------+---------+------+--
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)
-----------+---------+------+--
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)
-----------+---------+------+--
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)
-----------+---------+------+--
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)
-----------+---------+------+--
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)
-----------+---------+------+--
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)
-----------+---------+------+--
149 | | GET | n/a (reserved)
149 | | SET | n/a (reserved)
-----------+---------+------+--
150 | | GET | FC: shared-variables access control - read state of the access control
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)
-----------+---------+------+--
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)
151..182 | | SET | n/a (read-only)
-----------+---------+------+--
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
183 | | SET | n/a (read-only)
-----------+---------+------+--
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)
184 | | SET | n/a (read-only)
-----------+---------+------+--
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec
185 | | SET | n/a (read-only)
-----------+---------+------+--
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
188 | u32 | GET | PWM3 HW: direct "pulse" register value
188 | | SET | n/a
-----------+---------+------+--
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
190 | u32 | GET | PWM4 HW: direct "pulse" register value
190 | | SET | n/a
-----------+---------+------+--
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value
-----------+---------+------+--
194 | u32 | GET | reserved
194 | | SET | N/A
-----------+---------+------+--
195 | u32 | GET | reserved
195 | | SET | N/A
-----------+---------+------+--
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)
-----------+---------+------+--
229..230 | | GET | n/a (reserved)
229..230 | | SET | n/a (reserved)
-----------+---------+------+--
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)
-----------+---------+------+--
263..265 | | GET | n/a (reserved)
263..265 | | SET | n/a (reserved)
-----------+---------+------+--
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)
266..297 | | SET | n/a (read-only)
-----------+---------+------+--
298..300 | | GET | n/a (reserved)
298..300 | | SET | n/a (reserved)
-----------+---------+------+--
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)
-----------+---------+------+--
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)
-----------+---------+------+--
303..310 | | GET | n/a (reserved)
303..310 | | SET | n/a (reserved)
-----------+---------+------+--
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input
311..342 | | SET | n/a (read-only)
-----------+---------+------+--
343..374 | a | GET | AD: input identification / name (text)
343..374 | | SET | n/a (read-only)
-----------+---------+------+--
375..406 | a | GET | AD: input unit name (text)
375..406 | | SET | n/a (read-only)
-----------+---------+------+--
407..427 | | GET | n/a (reserved)
407..427 | | SET | n/a (reserved)
-----------+---------+------+--
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV)
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW
-----------+---------+------+--
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)
429 | | SET | n/a (read-only)
-----------+---------+------+--
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)
430 | | SET | n/a (read-only)
-----------+---------+------+--
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)
431..438 | | SET | n/a (read-only)
-----------+---------+------+--
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant
439..446 | | SET | n/a (read-only)
-----------+---------+------+--
447..462 | | GET | n/a (reserved)
447..462 | | SET | n/a (reserved)
-----------+---------+------+--
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]
463..469 | | SET | n/a (read-only)
-----------+---------+------+--
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]
470..476 | | SET | n/a (read-only)
-----------+---------+------+--
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]
477..483 | | SET | n/a (read-only)
-----------+---------+------+--
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]
484..490 | | SET | n/a (read-only)
-----------+---------+------+--
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]
491..497 | | SET | n/a (read-only)
-----------+---------+------+--
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]
498..504 | | SET | n/a (read-only)
-----------+---------+------+--
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]
505..511 | | SET | n/a (read-only)
-----------+---------+------+--
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]
512..518 | | SET | n/a (read-only)
-----------+---------+------+--
519..991 | | GET | n/a (reserved)
519..991 | | SET | n/a (reserved)
-----------+---------+------+--
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)
992 | | SET | n/a (reserved)
-----------+---------+------+--
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)
993 | | SET | n/a (reserved)
-----------+---------+------+--
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
994 | | SET | n/a (reserved)
-----------+---------+------+--
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])
995 | | SET | n/a (reserved)
-----------+---------+------+--
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])
996 | | SET | n/a (reserved)
-----------+---------+------+--
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active
997 | | SET | n/a (reserved)
-----------+---------+------+--
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active
998 | | SET | n/a (reserved)
-----------+---------+------+--
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)
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)
-----------+---------+------+--
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses
1064..1095| | SET | n/a (read-only)
-----------+---------+------+--
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse
1096..1127| | SET | n/a (read-only)
-----------+---------+------+--
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])
1128..1159| | SET | n/a (reserved)
-----------+---------+------+--
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])
1160..1191| | SET | n/a (reserved)
-----------+---------+------+--
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now
1192..1223| | SET | n/a (reserved)
-----------+---------+------+--
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now
1224..1255| | SET | n/a (reserved)
-----------+---------+------+--
1256..1499| | GET | n/a (reserved)
1256..1499| | SET | n/a (reserved)
-----------+---------+------+--
1500..1531| a | GET | [S0-input] master configuration struct for this input
1500..1531| a | SET | n/a (reserved)
-----------+---------+------+--
1532..1999| | GET | n/a (reserved)
1532..1999| | SET | n/a (reserved)
-----------+---------+------+--
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status
2000..2063| | SET | n/a (reserved)
-----------+---------+------+--
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device
2100..2163| | SET | n/a (reserved)
-----------+---------+------+--
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)
2200..2263| | SET | n/a (reserved)
-----------+---------+------+--
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)
2300..2363| | SET | n/a (reserved)
-----------+---------+------+--
2364..2487| | GET | n/a (reserved)
2364..2487| | SET | n/a (reserved)
-----------+---------+------+--
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)
2488..2495| | SET | n/a
-----------+---------+------+--
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)
2496 | | SET | n/a
-----------+---------+------+--
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)
2497 | | SET | n/a
-----------+---------+------+--
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)
2498 | | SET | n/a
-----------+---------+------+--
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)
2499 | | SET | n/a
-----------+---------+------+--
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status
2500..2563| | SET | n/a (reserved)
-----------+---------+------+--
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device
2600..2663| | SET | n/a (reserved)
-----------+---------+------+--
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)
2700..2763| | SET | n/a (reserved)
-----------+---------+------+--
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)
2800..2863| | SET | n/a (reserved)
-----------+---------+------+--
2864..2986| | GET | n/a (reserved)
2864..2986| | SET | n/a (reserved)
-----------+---------+------+--
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)
2986..2993| | SET | n/a
-----------+---------+------+--
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)
2994 | | SET | n/a
-----------+---------+------+--
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)
2995 | | SET | n/a
-----------+---------+------+--
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)
2996 | | SET | n/a
-----------+---------+------+--
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)
2997 | | SET | n/a
-----------+---------+------+--
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user
2998 | | SET | n/a (read-only)
-----------+---------+------+--
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)
2999 | | SET | n/a (read-only)
-----------+---------+------+--
3000 | | GET | n/a (reserved)
3000 | | SET | n/a (reserved)
-----------+---------+------+--
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)
3001 | a | SET | write
-----------+---------+------+--
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)
3002 | a | SET | write
-----------+---------+------+--
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)
3003 | a | SET | write
-----------+---------+------+--
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)
3004 | a | SET | write
-----------+---------+------+--
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)
3005 | a | SET | write
-----------+---------+------+--
3006..3799| | GET | n/a (reserved)
3006..3799| | SET | n/a (reserved)
-----------+---------+------+--
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected
3800 | | SET | n/a (read-only)
-----------+---------+------+--
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801
3801 | | SET | n/a (read-only)
-----------+---------+------+--
3802..3849| | GET | n/a (reserved)
3802..3849| | SET | n/a (reserved)
-----------+---------+------+--
3850 | u32 | GET | SD Card - fully mounted and useable
3850 | | SET | n/a (read-only)
-----------+---------+------+--
3851 | i32 | GET | latest file i/o error code
3851 | | SET | n/a (read-only)
-----------+---------+------+--
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)
3852 | | SET | n/a (read-only)
-----------+---------+------+--
3853 | u32 | GET | SD Card - CardType
3853 | | SET | n/a (read-only)
-----------+---------+------+--
3854 | u32 | GET | SD Card - CID - ProductSN
3854 | | SET | n/a (read-only)
-----------+---------+------+--
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)
3855 | | SET | n/a (read-only)
-----------+---------+------+--
3856 | u32 | GET | statistic counter: SDcard: failed init attempts
3856 | | SET | n/a (read-only)
-----------+---------+------+--
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)
3857 | | SET | n/a (read-only)
-----------+---------+------+--
3858 | u32 | GET | statistic counter: SDcard: sector reads
3858 | | SET | n/a (read-only)
-----------+---------+------+--
3859 | u32 | GET | statistic counter: SDcard: sector writes
3859 | | SET | n/a (read-only)
-----------+---------+------+--
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures
3860 | | SET | n/a (read-only)
-----------+---------+------+--
3861 | u32 | GET | statistic counter: number of opened files
3861 | | SET | n/a (read-only)
-----------+---------+------+--
3862..3999| | GET | n/a (reserved)
3862..3999| | SET | n/a (reserved)
-----------+---------+------+--
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write
-----------+---------+------+--
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write
-----------+---------+------+--
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write
-----------+---------+------+--
4300..4399| a | GET | Shared Variables: T00 through T99 - read
4300..4399| a | SET | Shared Variables: T00 through T99 - write
-----------+---------+------+--
4400..4989| | GET | n/a (reserved)
4400..4989| | SET | n/a (reserved)
-----------+---------+------+--
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)
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10
-----------+---------+------+--
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read
-----------+-+-------+------+--
5128..11197 | | GET | n/a (reserved)
5128..11197 | | SET | n/a (reserved)
-----------+-+-------+------+--
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN )
11198 | u32 | SET | write ( default: 0b00110001 )
-----------+---------+------+--
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)
11199 | | SET | n/a
-----------+---------+------+--
12200 | i32 | GET | work progress (and result) of mqtt_connect()
12200 | | SET | n/a
-----------+---------+------+--
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()
12201 | | SET | n/a
-----------+---------+------+--
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
12202 | | SET | n/a
-----------+---------+------+--
12203 | i32 | GET | MQTT protocol error counter (informative)
12203 | | SET | n/a
-----------+--+------+------+--
12204..12208 | | GET | n/a (reserved)
12204..12208 | | SET | n/a (reserved)
-----------+--+------+------+--
12209 | i32 | GET | Subscribe Table - total number of available rows
12209 | | SET | n/a
-----------+---------+------+--
12210 | a | GET | latest received Topic Name (sent from broker)
12210 | | SET | n/a
-----------+--+------+------+--
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row
12211..12241 | | SET | n/a
--------------+------+------+--
12242..12249 | | GET | n/a (reserved)
12242..12249 | | SET | n/a
-----------+--+------+------+--
12250 | a | GET | latest received Value (sent from broker)
12250 | | SET | n/a
-----------+--+------+------+--
12251..12281 | a | GET | Subscribe Table: actual Value for each table row
12251..12281 | | SET | n/a
--------------+------+------+--
12282..12289 | | GET | n/a (reserved)
12282..12289 | | SET | n/a
-----------+--+------+------+--
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker
12290 | | SET | n/a
-----------+--+------+--+---+--+--
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row
12291..12321 | | SET | n/a
--------------+------+--+---+--+--
12322..12398 | | GET | n/a (reserved)
12322..12398 | | SET | n/a (reserved)
-----------+--+------+------+--
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)
12399 | | SET | n/a
-----------+---------+------+--
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()
12400 | | SET | n/a
-----------+---------+------+--
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);
12401 | | SET | n/a
-----------+---------+------+--
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);
12402 | | SET | n/a
-----------+---------+------+--
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);
12403 | | SET | n/a
-----------+---------+------+--
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);
12404 | | SET | n/a
-----------+---------+------+--
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
12405 | | SET | n/a
-----------+---------+------+--
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
12406 | | SET | n/a
-----------+--+------+------+--
12407..12414 | | GET | n/a (reserved)
12407..12414 | | SET | n/a (reserved)
-----------+--+------+------+--
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
12415 | | SET | n/a
-----------+---------+------+--
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
12416 | | SET | n/a
-----------+--+------+------+--
12417..12462 | | GET | n/a (reserved)
12417..12462 | | SET | n/a (reserved)
-----------+--+------+------+--
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)
12463 | | SET | n/a
-----------+---------+------+--
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)
12464 | | SET | n/a
-----------+---------+------+--
12465 | u/i 32 | GET | timestamp of the latest received message
12465 | | SET | n/a
-----------+---------+------+--
12466 | u/i 32 | GET | a count of received items inside the latest received message
12466 | | SET | n/a
-----------+---------+------+--
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)
12467 | | SET | n/a
-----------+---------+------+--
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)
12468 | | SET | n/a
-----------+---------+------+--
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)
12469 | | SET | n/a
-----------+--+------+--+---+--+--
12470..12719 | i32 (a) | GET | received values (latest received message contents)
12470..12719 | | SET | n/a
--------------+---------+------+--

'''Poznámky'''

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.

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).
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.
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.

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).

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.

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.

'''Vysvětlení položek'''

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í.
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).

'''Vstupy pro měření napětí'''

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]].

__NOTOC__

FULL-C: set and get

2025-08-10T09:27:29Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Jak je FULL-C program připojen k hardware ==

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é).

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).

Zde je seznam těchto funkcí:
<pre>
void SDS_set_i32(unsigned int index, signed int value);
signed int SDS_get_i32(unsigned int index);

void SDS_set_i64(unsigned int index, int64_t value);
signed int SDS_get_i64(unsigned int index);

void SDS_set_u32(unsigned int index, unsigned int value);
unsigned int SDS_get_u32(unsigned int index);

void SDS_set_u64(unsigned int index, uint64_t value);
unsigned int SDS_get_u64(unsigned int index);

void SDS_set_f32(unsigned int index, float value);
float SDS_get_f32(unsigned int index);

void SDS_set_a(unsigned int index, void *ptr, unsigned int len);
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);
</pre>

Historicky zde původně byly i tyto funkce:
<pre>
void SDS_set_i(unsigned int index, signed int value);
signed int SDS_get_i(unsigned int index);

void SDS_set_u(unsigned int index, unsigned int value);
unsigned int SDS_get_u(unsigned int index);
</pre>
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32).
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ý.

=== Detailní Příklady ===

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]].

== Princip ==

Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.

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).

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):

typ položky | rozsah | typ proměnné | postfix set\get funkce
--------------------------+----------------+-----------------+-------------------------
signed 32-bit integer | -2^31..+2^31 | int | _i32
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64
IP address | uchar[4] | unsigned int | _u32
float | IEEE-754 | float | _f32
string (text) | len\maxlen | void* \ char* | _a
binary array | len\maxlen | void* \ char* | _a

Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.

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);''.

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.

== Funkce _u32 \ _i32 \ _f32 ==

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).

Č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é).

První příklad: ''čtení'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
unsigned int NTPtime;
NTPtime = SDS_get_u32(4);
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);
</syntaxhighlight>

Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem
<syntaxhighlight lang="c">
int NTPoffset;
NTPoffset = SDS_get_i32(26);
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);
</syntaxhighlight>

Třetí příklad: ''čtení'' float hodnoty
<syntaxhighlight lang="c">
float AD_Rinput__in_user_units;
AD_Rinput__in_user_units = SDS_get_f32(311);
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);
</syntaxhighlight>

Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)
SDS_set_u32(231, 0xFF);
</syntaxhighlight>

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.

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.

== Funkce _u64 \ _i64 ==

Princip je identický jako pro _u32 a _i32 funkce.

Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.

== Funkce _a ==

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.

První příklad: čtení textového parametru
<syntaxhighlight lang="c">
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00
char sysLoc[32];

// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů
SDS_get_a(2, (void *)sysLoc, 32);

// a můžeme se podívat na výsledek (výpis do konzole)
printf("Nastavená system location: %s \n", sysLoc);
</syntaxhighlight>

Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů
<syntaxhighlight lang="c">
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)
unsigned int OPTOvalues[8];

// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);

// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)
if (0 == OPTOvalues[0]) ...
</syntaxhighlight>
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.

Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.

== Úplné detaily a všechny příklady ==

'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.

== Tabulka ==

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.

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.).

-----------+---------+------+--------------------------------------------------------------------------------------------------------
index | i\u\f\a | dir | comment
-----------+---------+------+--------------------------------------------------------------------------------------------------------
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)
0 | | SET | n/a (read-only)
-----------+---------+------+--
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)
1 | | SET | n/a
-----------+---------+------+--
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)
2 | a | GET | sysLocation (user configured text)
2 | | SET | n/a
-----------+---------+------+--
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)
3 | | SET | n/a
-----------+---------+------+--
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds
4 | | SET | n/a (read-only)
-----------+---------+------+--
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)
5 | | SET | n/a
-----------+---------+------+--
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)
6 | | SET | n/a
-----------+---------+------+--
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)
7 | | SET | n/a
-----------+---------+------+--
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)
8 | | SET | n/a
-----------+---------+------+--
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)
9 | | SET | n/a
-----------+---------+------+--
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)
10 | | SET | n/a
-----------+---------+------+--
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)
11 | | SET | n/a
-----------+---------+------+--
12 | u32 | GET | SDS device IP address (web admin IP)
12 | | SET | n/a (read-only)
-----------+---------+------+--
13..15 | | GET | n/a (reserved)
13..15 | | SET | n/a (reserved)
-----------+---------+------+--
16 | u32 | GET | network gateway IP address
16 | | SET | n/a (read-only)
-----------+---------+------+--
17..19 | | GET | n/a (reserved)
17..19 | | SET | n/a (reserved)
-----------+---------+------+--
20 | u32 | GET | network IP MASK
20 | | SET | n/a (read-only)
-----------+---------+------+--
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)
21 | | SET | n/a (reserved)
-----------+---------+------+--
22 | u32 | GET | SNMPv3 - Engine Boots
22 | | SET | n/a (reserved)
-----------+---------+------+--
23 | u32 | GET | SNMPv3 - Engine Time
23 | | SET | n/a (reserved)
-----------+---------+------+--
24 | u32 | GET | Ethernet Link Status
24 | | SET | n/a (read-only)
-----------+---------+------+--
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)
25 | | SET | n/a (read-only)
-----------+---------+------+--
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)
-----------+---------+------+--
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)
27 | | SET | n/a (read-only)
-----------+---------+------+--
28 | u32 | GET | timestamp of last change (assignment) of IP address
28 | | SET | n/a (read-only)
-----------+---------+------+--
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)
29 | | SET | n/a (read-only)
-----------+---------+------+--
30 | u32 | GET | DHCP lease time (secs) value
30 | | SET | n/a (read-only)
-----------+---------+------+--
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)
31 | | SET | n/a (read-only)
-----------+---------+------+--
32 | u32 | GET | MAC[1]
32 | | SET | n/a (read-only)
-----------+---------+------+--
33 | u32 | GET | MAC[2]
33 | | SET | n/a (read-only)
-----------+---------+------+--
34 | u32 | GET | MAC[3]
34 | | SET | n/a (read-only)
-----------+---------+------+--
35 | u32 | GET | MAC[4]
35 | | SET | n/a (read-only)
-----------+---------+------+--
36 | u32 | GET | MAC[5]
36 | | SET | n/a (read-only)
-----------+---------+------+--
37..39 | | GET | n/a (reserved)
37..39 | | SET | n/a (read-only)
-----------+---------+------+--
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)
40 | | SET | n/a (read-only)
-----------+---------+------+--
41 | a | GET | OEM branding (login web page) [32 chars]
41 | a | SET | set custom OEM branding (login web page) [32 chars]
-----------+---------+------+--
42 | a | GET | OEM branding (welcome web page) [128 chars]
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]
-----------+---------+------+--
43 | u32 | GET | NTP-server IP address
43 | | SET | n/a (read-only)
-----------+---------+------+--
44 | u32 | GET | NTP-client status (0 = NOT synchronized)
44 | | SET | n/a (read-only)
-----------+---------+------+--
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)
45 | | SET | n/a (read-only)
-----------+---------+------+--
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)
46 | | SET | n/a (read-only)
-----------+---------+------+--
48..60 | | GET | n/a (reserved)
48..60 | | SET | n/a (reserved)
-----------+---------+------+--
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)
61 | | SET | n/a (read-only)
-----------+---------+------+--
62..63 | | GET | n/a (reserved)
62..63 | | SET | n/a (reserved)
-----------+---------+------+--
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)
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0
-----------+---------+------+--
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)
65 | u32 | SET | n/a (reserved)
-----------+---------+------+--
66 | u32 | GET | DNS-server IP address
66 | | SET | n/a (read-only)
-----------+---------+------+--
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)
67 | | SET | n/a (read-only)
-----------+---------+------+--
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)
68 | | SET | n/a (read-only)
-----------+---------+------+--
69 | | GET | n/a (reserved)
69 | | SET | n/a (reserved)
-----------+---------+------+--
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)
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)
-----------+---------+------+--
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)
71 | | SET | n/a (reserved)
-----------+---------+------+--
72..77 | | GET | n/a (reserved)
72..77 | | SET | n/a (reserved)
-----------+---------+------+--
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs
78 | | SET | n/a (reserved)
-----------+---------+------+--
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" (newer HW version) / 0 = basic BIG (no DP)
79 | | SET | n/a (reserved)
-----------+---------+------+--
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84
80 | | SET | n/a (reserved)
-----------+---------+------+--
81..84 | | GET | n/a (reserved)
81..84 | | SET | n/a (reserved)
-----------+---------+------+--
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2
85 | | SET | n/a (reserved)
-----------+---------+------+--
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)
86 | | SET | n/a (reserved)
-----------+---------+------+--
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program
87 | | SET | n/a (reserved)
-----------+---------+------+--
88 | | GET | n/a (reserved)
88 | | SET | n/a (reserved)
-----------+---------+------+--
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)
89 | | SET | n/a (read-only)
-----------+---------+------+--
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)
90 | | SET | n/a (read-only)
-----------+---------+------+--
91 | u32 | GET | SDS IP-WatchDog: logical output status
91 | | SET | n/a (read-only)
-----------+---------+------+--
92..131 | | GET | n/a (reserved)
92..131 | | SET | n/a (reserved)
-----------+---------+------+--
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
132 | | SET | n/a (read-only)
-----------+---------+------+--
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
133 | | SET | n/a (read-only)
-----------+---------+------+--
134 | a | GET | FC: archived text of the last FC error
134 | | SET | n/a (read-only)
-----------+---------+------+--
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)
135 | | SET | n/a (read-only)
-----------+---------+------+--
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot
136 | | SET | n/a (read-only)
-----------+---------+------+--
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)
137 | | SET | n/a
-----------+---------+------+--
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)
138 | | SET | n/a
-----------+---------+------+--
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied
139 | | SET | n/a
-----------+---------+------+--
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)
-----------+---------+------+--
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)
-----------+---------+------+--
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)
-----------+---------+------+--
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)
-----------+---------+------+--
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)
-----------+---------+------+--
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)
-----------+---------+------+--
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)
-----------+---------+------+--
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)
-----------+---------+------+--
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)
-----------+---------+------+--
149 | | GET | n/a (reserved)
149 | | SET | n/a (reserved)
-----------+---------+------+--
150 | | GET | FC: shared-variables access control - read state of the access control
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)
-----------+---------+------+--
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)
151..182 | | SET | n/a (read-only)
-----------+---------+------+--
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
183 | | SET | n/a (read-only)
-----------+---------+------+--
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)
184 | | SET | n/a (read-only)
-----------+---------+------+--
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec
185 | | SET | n/a (read-only)
-----------+---------+------+--
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
188 | u32 | GET | PWM3 HW: direct "pulse" register value
188 | | SET | n/a
-----------+---------+------+--
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
190 | u32 | GET | PWM4 HW: direct "pulse" register value
190 | | SET | n/a
-----------+---------+------+--
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value
-----------+---------+------+--
194 | u32 | GET | reserved
194 | | SET | N/A
-----------+---------+------+--
195 | u32 | GET | reserved
195 | | SET | N/A
-----------+---------+------+--
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)
-----------+---------+------+--
229..230 | | GET | n/a (reserved)
229..230 | | SET | n/a (reserved)
-----------+---------+------+--
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)
-----------+---------+------+--
263..265 | | GET | n/a (reserved)
263..265 | | SET | n/a (reserved)
-----------+---------+------+--
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)
266..297 | | SET | n/a (read-only)
-----------+---------+------+--
298..300 | | GET | n/a (reserved)
298..300 | | SET | n/a (reserved)
-----------+---------+------+--
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)
-----------+---------+------+--
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)
-----------+---------+------+--
303..310 | | GET | n/a (reserved)
303..310 | | SET | n/a (reserved)
-----------+---------+------+--
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input
311..342 | | SET | n/a (read-only)
-----------+---------+------+--
343..374 | a | GET | AD: input identification / name (text)
343..374 | | SET | n/a (read-only)
-----------+---------+------+--
375..406 | a | GET | AD: input unit name (text)
375..406 | | SET | n/a (read-only)
-----------+---------+------+--
407..427 | | GET | n/a (reserved)
407..427 | | SET | n/a (reserved)
-----------+---------+------+--
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV)
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW
-----------+---------+------+--
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)
429 | | SET | n/a (read-only)
-----------+---------+------+--
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)
430 | | SET | n/a (read-only)
-----------+---------+------+--
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)
431..438 | | SET | n/a (read-only)
-----------+---------+------+--
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant
439..446 | | SET | n/a (read-only)
-----------+---------+------+--
447..462 | | GET | n/a (reserved)
447..462 | | SET | n/a (reserved)
-----------+---------+------+--
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]
463..469 | | SET | n/a (read-only)
-----------+---------+------+--
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]
470..476 | | SET | n/a (read-only)
-----------+---------+------+--
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]
477..483 | | SET | n/a (read-only)
-----------+---------+------+--
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]
484..490 | | SET | n/a (read-only)
-----------+---------+------+--
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]
491..497 | | SET | n/a (read-only)
-----------+---------+------+--
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]
498..504 | | SET | n/a (read-only)
-----------+---------+------+--
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]
505..511 | | SET | n/a (read-only)
-----------+---------+------+--
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]
512..518 | | SET | n/a (read-only)
-----------+---------+------+--
519..991 | | GET | n/a (reserved)
519..991 | | SET | n/a (reserved)
-----------+---------+------+--
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)
992 | | SET | n/a (reserved)
-----------+---------+------+--
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)
993 | | SET | n/a (reserved)
-----------+---------+------+--
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
994 | | SET | n/a (reserved)
-----------+---------+------+--
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])
995 | | SET | n/a (reserved)
-----------+---------+------+--
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])
996 | | SET | n/a (reserved)
-----------+---------+------+--
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active
997 | | SET | n/a (reserved)
-----------+---------+------+--
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active
998 | | SET | n/a (reserved)
-----------+---------+------+--
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)
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)
-----------+---------+------+--
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses
1064..1095| | SET | n/a (read-only)
-----------+---------+------+--
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse
1096..1127| | SET | n/a (read-only)
-----------+---------+------+--
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])
1128..1159| | SET | n/a (reserved)
-----------+---------+------+--
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])
1160..1191| | SET | n/a (reserved)
-----------+---------+------+--
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now
1192..1223| | SET | n/a (reserved)
-----------+---------+------+--
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now
1224..1255| | SET | n/a (reserved)
-----------+---------+------+--
1256..1499| | GET | n/a (reserved)
1256..1499| | SET | n/a (reserved)
-----------+---------+------+--
1500..1531| a | GET | [S0-input] master configuration struct for this input
1500..1531| a | SET | n/a (reserved)
-----------+---------+------+--
1532..1999| | GET | n/a (reserved)
1532..1999| | SET | n/a (reserved)
-----------+---------+------+--
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status
2000..2063| | SET | n/a (reserved)
-----------+---------+------+--
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device
2100..2163| | SET | n/a (reserved)
-----------+---------+------+--
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)
2200..2263| | SET | n/a (reserved)
-----------+---------+------+--
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)
2300..2363| | SET | n/a (reserved)
-----------+---------+------+--
2364..2487| | GET | n/a (reserved)
2364..2487| | SET | n/a (reserved)
-----------+---------+------+--
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)
2488..2495| | SET | n/a
-----------+---------+------+--
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)
2496 | | SET | n/a
-----------+---------+------+--
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)
2497 | | SET | n/a
-----------+---------+------+--
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)
2498 | | SET | n/a
-----------+---------+------+--
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)
2499 | | SET | n/a
-----------+---------+------+--
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status
2500..2563| | SET | n/a (reserved)
-----------+---------+------+--
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device
2600..2663| | SET | n/a (reserved)
-----------+---------+------+--
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)
2700..2763| | SET | n/a (reserved)
-----------+---------+------+--
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)
2800..2863| | SET | n/a (reserved)
-----------+---------+------+--
2864..2986| | GET | n/a (reserved)
2864..2986| | SET | n/a (reserved)
-----------+---------+------+--
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)
2986..2993| | SET | n/a
-----------+---------+------+--
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)
2994 | | SET | n/a
-----------+---------+------+--
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)
2995 | | SET | n/a
-----------+---------+------+--
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)
2996 | | SET | n/a
-----------+---------+------+--
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)
2997 | | SET | n/a
-----------+---------+------+--
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user
2998 | | SET | n/a (read-only)
-----------+---------+------+--
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)
2999 | | SET | n/a (read-only)
-----------+---------+------+--
3000 | | GET | n/a (reserved)
3000 | | SET | n/a (reserved)
-----------+---------+------+--
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)
3001 | a | SET | write
-----------+---------+------+--
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)
3002 | a | SET | write
-----------+---------+------+--
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)
3003 | a | SET | write
-----------+---------+------+--
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)
3004 | a | SET | write
-----------+---------+------+--
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)
3005 | a | SET | write
-----------+---------+------+--
3006..3799| | GET | n/a (reserved)
3006..3799| | SET | n/a (reserved)
-----------+---------+------+--
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected
3800 | | SET | n/a (read-only)
-----------+---------+------+--
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801
3801 | | SET | n/a (read-only)
-----------+---------+------+--
3802..3849| | GET | n/a (reserved)
3802..3849| | SET | n/a (reserved)
-----------+---------+------+--
3850 | u32 | GET | SD Card - fully mounted and useable
3850 | | SET | n/a (read-only)
-----------+---------+------+--
3851 | i32 | GET | latest file i/o error code
3851 | | SET | n/a (read-only)
-----------+---------+------+--
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)
3852 | | SET | n/a (read-only)
-----------+---------+------+--
3853 | u32 | GET | SD Card - CardType
3853 | | SET | n/a (read-only)
-----------+---------+------+--
3854 | u32 | GET | SD Card - CID - ProductSN
3854 | | SET | n/a (read-only)
-----------+---------+------+--
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)
3855 | | SET | n/a (read-only)
-----------+---------+------+--
3856 | u32 | GET | statistic counter: SDcard: failed init attempts
3856 | | SET | n/a (read-only)
-----------+---------+------+--
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)
3857 | | SET | n/a (read-only)
-----------+---------+------+--
3858 | u32 | GET | statistic counter: SDcard: sector reads
3858 | | SET | n/a (read-only)
-----------+---------+------+--
3859 | u32 | GET | statistic counter: SDcard: sector writes
3859 | | SET | n/a (read-only)
-----------+---------+------+--
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures
3860 | | SET | n/a (read-only)
-----------+---------+------+--
3861 | u32 | GET | statistic counter: number of opened files
3861 | | SET | n/a (read-only)
-----------+---------+------+--
3862..3999| | GET | n/a (reserved)
3862..3999| | SET | n/a (reserved)
-----------+---------+------+--
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write
-----------+---------+------+--
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write
-----------+---------+------+--
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write
-----------+---------+------+--
4300..4399| a | GET | Shared Variables: T00 through T99 - read
4300..4399| a | SET | Shared Variables: T00 through T99 - write
-----------+---------+------+--
4400..4989| | GET | n/a (reserved)
4400..4989| | SET | n/a (reserved)
-----------+---------+------+--
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)
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10
-----------+---------+------+--
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read
-----------+-+-------+------+--
5128..11197 | | GET | n/a (reserved)
5128..11197 | | SET | n/a (reserved)
-----------+-+-------+------+--
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN )
11198 | u32 | SET | write ( default: 0b00110001 )
-----------+---------+------+--
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)
11199 | | SET | n/a
-----------+---------+------+--
12200 | i32 | GET | work progress (and result) of mqtt_connect()
12200 | | SET | n/a
-----------+---------+------+--
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()
12201 | | SET | n/a
-----------+---------+------+--
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
12202 | | SET | n/a
-----------+---------+------+--
12203 | i32 | GET | MQTT protocol error counter (informative)
12203 | | SET | n/a
-----------+--+------+------+--
12204..12208 | | GET | n/a (reserved)
12204..12208 | | SET | n/a (reserved)
-----------+--+------+------+--
12209 | i32 | GET | Subscribe Table - total number of available rows
12209 | | SET | n/a
-----------+---------+------+--
12210 | a | GET | latest received Topic Name (sent from broker)
12210 | | SET | n/a
-----------+--+------+------+--
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row
12211..12241 | | SET | n/a
--------------+------+------+--
12242..12249 | | GET | n/a (reserved)
12242..12249 | | SET | n/a
-----------+--+------+------+--
12250 | a | GET | latest received Value (sent from broker)
12250 | | SET | n/a
-----------+--+------+------+--
12251..12281 | a | GET | Subscribe Table: actual Value for each table row
12251..12281 | | SET | n/a
--------------+------+------+--
12282..12289 | | GET | n/a (reserved)
12282..12289 | | SET | n/a
-----------+--+------+------+--
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker
12290 | | SET | n/a
-----------+--+------+--+---+--+--
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row
12291..12321 | | SET | n/a
--------------+------+--+---+--+--
12322..12398 | | GET | n/a (reserved)
12322..12398 | | SET | n/a (reserved)
-----------+--+------+------+--
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)
12399 | | SET | n/a
-----------+---------+------+--
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()
12400 | | SET | n/a
-----------+---------+------+--
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);
12401 | | SET | n/a
-----------+---------+------+--
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);
12402 | | SET | n/a
-----------+---------+------+--
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);
12403 | | SET | n/a
-----------+---------+------+--
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);
12404 | | SET | n/a
-----------+---------+------+--
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
12405 | | SET | n/a
-----------+---------+------+--
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
12406 | | SET | n/a
-----------+--+------+------+--
12407..12414 | | GET | n/a (reserved)
12407..12414 | | SET | n/a (reserved)
-----------+--+------+------+--
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
12415 | | SET | n/a
-----------+---------+------+--
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
12416 | | SET | n/a
-----------+--+------+------+--
12417..12462 | | GET | n/a (reserved)
12417..12462 | | SET | n/a (reserved)
-----------+--+------+------+--
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)
12463 | | SET | n/a
-----------+---------+------+--
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)
12464 | | SET | n/a
-----------+---------+------+--
12465 | u/i 32 | GET | timestamp of the latest received message
12465 | | SET | n/a
-----------+---------+------+--
12466 | u/i 32 | GET | a count of received items inside the latest received message
12466 | | SET | n/a
-----------+---------+------+--
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)
12467 | | SET | n/a
-----------+---------+------+--
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)
12468 | | SET | n/a
-----------+---------+------+--
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)
12469 | | SET | n/a
-----------+--+------+--+---+--+--
12470..12719 | i32 (a) | GET | received values (latest received message contents)
12470..12719 | | SET | n/a
--------------+---------+------+--

'''Poznámky'''

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.

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).
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.
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.

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).

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.

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.

'''Vysvětlení položek'''

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í.
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).

'''Vstupy pro měření napětí'''

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]].

__NOTOC__

FULL-C dns resolv functions

2025-08-10T08:19:11Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==
__NOTOC__

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.

Za tímto účelem jsou k dispozici tyto dvě funkce:
<pre>
void dns_resolv(char *domainNameInput);
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);
</pre>

== Princip ==

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).

Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.

'''POZOR : Maximální délka názvu DNS domény je interně omezena na 96 znaků !'''

== Příklad ==

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).

<pre>
void main(void)
{
char DNSname[96];
unsigned int status;
unsigned int IP0, IP1, IP2, IP3;

sprintf((char *)DNSname, "www.google.com");

printf("RESOLVING %s \n", DNSname);

// start - select the new DNSname for all the subsequent status function calls
dns_resolv(DNSname);

// get the first status value
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
// only if truly working, keep waiting
while (512 == status)
{
// keep getting a new status, until it is different than 512
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
}

// check the final status value
if (513 == status)
{
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);
// only in this case, we can use the IPx address
// ... OK

// we can print the additional internal DNS cache status, for this particular domain
// note. the value is valid only if the status is 512, otherwise not
unsigned int ttl;
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item
printf("DNS CACHE TTL VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);
} else
{
printf("DNS RESOLV FAILED (error %u) \n", status);
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again
}

}
</pre>

== Interní DNS cache ==

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ěď,
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).

Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().

Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS.

Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.

Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.

Toto si řídí SDS interně.

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.

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).

== Upozornění ==

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.

DNS cache je (záměrně) vymazána při:
* nahrání nového FULLC programu
* restartu zařízení SDS

DNS cache není vymazána při výpadku Ethernetového připojení.

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).

== Stavové hodnoty ==

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).

dns_resolv_status() význam
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)
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)
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)
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)
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu
516 | dotaz selhal, protože došlo k odpojení Ethernetu
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)

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().

FULL-C: set and get

2025-08-10T08:03:16Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Jak je FULL-C program připojen k hardware ==

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é).

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).

Zde je seznam těchto funkcí:
<pre>
void SDS_set_i32(unsigned int index, signed int value);
signed int SDS_get_i32(unsigned int index);

void SDS_set_i64(unsigned int index, int64_t value);
signed int SDS_get_i64(unsigned int index);

void SDS_set_u32(unsigned int index, unsigned int value);
unsigned int SDS_get_u32(unsigned int index);

void SDS_set_u64(unsigned int index, uint64_t value);
unsigned int SDS_get_u64(unsigned int index);

void SDS_set_f32(unsigned int index, float value);
float SDS_get_f32(unsigned int index);

void SDS_set_a(unsigned int index, void *ptr, unsigned int len);
void SDS_get_a(unsigned int index, void *ptr, unsigned int maxlen);
</pre>

Historicky zde původně byly i tyto funkce:
<pre>
void SDS_set_i(unsigned int index, signed int value);
signed int SDS_get_i(unsigned int index);

void SDS_set_u(unsigned int index, unsigned int value);
unsigned int SDS_get_u(unsigned int index);
</pre>
Ty "nezmizely" jen byly '''přejmenovány''' (i na i32, u na u32).
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ý.

=== Detailní Příklady ===

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]].

== Princip ==

Základem je použití přístupu k informacím prostřednictvím tzv. '''index'''u.

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).

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):

typ položky | rozsah | typ proměnné | postfix set\get funkce
--------------------------+----------------+-----------------+-------------------------
signed 32-bit integer | -2^31..+2^31 | int | _i32
signed 64-bit integer | -2^63..+2^63 | int64_t | _i32
unsigned 32-bit integer | 0..+2^32 | unsigned int | _u64
unsigned 64-bit integer | 0..+2^64 | uint64_t | _u64
IP address | uchar[4] | unsigned int | _u32
float | IEEE-754 | float | _f32
string (text) | len\maxlen | void* \ char* | _a
binary array | len\maxlen | void* \ char* | _a

Jak lze vidět, bude při psaní programu potřeba správně vybrat postfix u dané funkce.

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);''.

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.

== Funkce _u32 \ _i32 \ _f32 ==

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).

Č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é).

První příklad: ''čtení'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
unsigned int NTPtime;
NTPtime = SDS_get_u32(4);
printf("Aktuální Epoch Time je %u (secs).\n", NTPtime);
</syntaxhighlight>

Druhý příklad: ''čtení'' 32bitové hodnoty se znaménkem
<syntaxhighlight lang="c">
int NTPoffset;
NTPoffset = SDS_get_i32(26);
printf("Offset pro NTP čas je: %d hod.\n", NTPoffset);
</syntaxhighlight>

Třetí příklad: ''čtení'' float hodnoty
<syntaxhighlight lang="c">
float AD_Rinput__in_user_units;
AD_Rinput__in_user_units = SDS_get_f32(311);
printf("Resistance Measure Input value is: %0.3f \n", AD_Rinput__in_user_units);
</syntaxhighlight>

Čtvrtý příklad: ''zápis'' 32bitové hodnoty bez znaménka
<syntaxhighlight lang="c">
// zapni RELE 1 (zápisem nenulové hodnoty na index [231], viz tabulka)
SDS_set_u32(231, 0xFF);
</syntaxhighlight>

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.

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.

== Funkce _u64 \ _i64 ==

Princip je identický jako pro _u32 a _i32 funkce.

Vždy se podívejte do tabulky, jaké informace můžete v 64bitové formě dostat; většina jich je pouze ve 32bit formě.
To ale nevadí, protože přeci například není problém do proměnné typu uint64_t zapsat 32bitové číslo.

== Funkce _a ==

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.

První příklad: čtení textového parametru
<syntaxhighlight lang="c">
// definujeme si pole o velikosti 32 bajtů; tzn. sem se vleze až 31 znaků plus jeden ukončovací 0x00
char sysLoc[32];

// SDS uloží text z indexu [2] do pole "sysLoc", o maximální velikosti 32 bajtů
SDS_get_a(2, (void *)sysLoc, 32);

// a můžeme se podívat na výsledek (výpis do konzole)
printf("Nastavená system location: %s \n", sysLoc);
</syntaxhighlight>

Druhý příklad: čtení pole údajů - '''pouze''' položky z indexu označeného (a) v tabulce indexů
<syntaxhighlight lang="c">
// definujeme si pole o 8 položkách, které obsahuje prvky typu "unsigned int" (každý tento prvek má velikost: 4 bajty)
unsigned int OPTOvalues[8];

// SDS zapíše 8 pozic od indexu [151] do pole OPTOvalues
// maximální velikost zápisu = 8*4 , tzn. 8 položek v poli OPTOvalues, každá o 4 bajtech
SDS_get_a(151, (void *)OPTOvalues, 8 * 4);

// a muzeme pristupovat na jednotlive polozky (jejich obsah je platny vuci okamziku zavolani GET funkce)
if (0 == OPTOvalues[0]) ...
</syntaxhighlight>
Pro tyto přístupy je potřeba uvést, že blokové čtení funguje jen vždy od prvního indexu pro daný blok indexů.

Na zcela stejném přístupu funguje '''SDS_set_a()''' funkce.

== Úplné detaily a všechny příklady ==

'''Detailní přehled, doplněný o příklady ve FULL-C, naleznete zde: [[FULL-C: set and get: detailed]]'''.

== Tabulka ==

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.

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.).

-----------+---------+------+--------------------------------------------------------------------------------------------------------
index | i\u\f\a | dir | comment
-----------+---------+------+--------------------------------------------------------------------------------------------------------
0 | u32 | GET | firmware PAIRCODE (SDS device master-type identification)
0 | | SET | n/a (read-only)
-----------+---------+------+--
1 | u32 | GET | count of actually logged-in users (logged-in to SDS web admin)
1 | | SET | n/a
-----------+---------+------+--
2 | u32 | GET | unique ID for SDS (serial number assigned during manufacturing)
2 | a | GET | sysLocation (user configured text)
2 | | SET | n/a
-----------+---------+------+--
3 | u32 | GET | uptime (increased by 1 each every 10msec) (example: 100 = 1 sec)
3 | | SET | n/a
-----------+---------+------+--
4 | u32 | GET | LOCAL time (NTP UTC Epoch, with GMT-offset and DST-offset applied), value in seconds
4 | | SET | n/a (read-only)
-----------+---------+------+--
5 | u32 | GET | LOCAL time decomposition = value of DAY (1 through 31)
5 | | SET | n/a
-----------+---------+------+--
6 | u32 | GET | LOCAL time decomposition = value of MONTH (1 through 12)
6 | | SET | n/a
-----------+---------+------+--
7 | u32 | GET | LOCAL time decomposition = value of YEAR (full value)
7 | | SET | n/a
-----------+---------+------+--
8 | u32 | GET | LOCAL time decomposition = value of HOUR (0 through 23)
8 | | SET | n/a
-----------+---------+------+--
9 | u32 | GET | LOCAL time decomposition = value of MINUTE (0 through 59)
9 | | SET | n/a
-----------+---------+------+--
10 | u32 | GET | LOCAL time decomposition = value of SECOND (0 through 59)
10 | | SET | n/a
-----------+---------+------+--
11 | u32 | GET | LOCAL time decomposition = day-of-week number = number of days since Sunday (0 to 6)
11 | | SET | n/a
-----------+---------+------+--
12 | u32 | GET | SDS device IP address (web admin IP)
12 | | SET | n/a (read-only)
-----------+---------+------+--
13..15 | | GET | n/a (reserved)
13..15 | | SET | n/a (reserved)
-----------+---------+------+--
16 | u32 | GET | network gateway IP address
16 | | SET | n/a (read-only)
-----------+---------+------+--
17..19 | | GET | n/a (reserved)
17..19 | | SET | n/a (reserved)
-----------+---------+------+--
20 | u32 | GET | network IP MASK
20 | | SET | n/a (read-only)
-----------+---------+------+--
21 | a | GET | SNMPv3 - EngineID (FC: prepare buffer for 32 chars + trailing zero)
21 | | SET | n/a (reserved)
-----------+---------+------+--
22 | u32 | GET | SNMPv3 - Engine Boots
22 | | SET | n/a (reserved)
-----------+---------+------+--
23 | u32 | GET | SNMPv3 - Engine Time
23 | | SET | n/a (reserved)
-----------+---------+------+--
24 | u32 | GET | Ethernet Link Status
24 | | SET | n/a (read-only)
-----------+---------+------+--
25 | u32 | GET | Ethernet Link Speed (0, 10 or 100)
25 | | SET | n/a (read-only)
-----------+---------+------+--
26 | i32 | GET | read NTP GMT offset (-11 .. 11) = offset, in hour(s), between UTC and LOCAL time
26 | i32 | SET | set NTP GMT offset (warning: this is not stored to permanent memory - use web admin to store it permanently)
-----------+---------+------+--
27 | u32 | GET | validity of the assigned IP address (0 = SDS does not have any IP address assigned, at the moment)
27 | | SET | n/a (read-only)
-----------+---------+------+--
28 | u32 | GET | timestamp of last change (assignment) of IP address
28 | | SET | n/a (read-only)
-----------+---------+------+--
29 | u32 | GET | state of DHCP client (0 = disabled, OR: enabled = status value of 1 .. 11)
29 | | SET | n/a (read-only)
-----------+---------+------+--
30 | u32 | GET | DHCP lease time (secs) value
30 | | SET | n/a (read-only)
-----------+---------+------+--
31 | u32 | GET | MAC[0] (always use only the lowest 8 bits, for each item)
31 | | SET | n/a (read-only)
-----------+---------+------+--
32 | u32 | GET | MAC[1]
32 | | SET | n/a (read-only)
-----------+---------+------+--
33 | u32 | GET | MAC[2]
33 | | SET | n/a (read-only)
-----------+---------+------+--
34 | u32 | GET | MAC[3]
34 | | SET | n/a (read-only)
-----------+---------+------+--
35 | u32 | GET | MAC[4]
35 | | SET | n/a (read-only)
-----------+---------+------+--
36 | u32 | GET | MAC[5]
36 | | SET | n/a (read-only)
-----------+---------+------+--
37..39 | | GET | n/a (reserved)
37..39 | | SET | n/a (read-only)
-----------+---------+------+--
40 | u32 | GET | SoC power-up or reset reason (64/128 = read only LSB: 8 bits) (512 = read all 32 bits)
40 | | SET | n/a (read-only)
-----------+---------+------+--
41 | a | GET | OEM branding (login web page) [32 chars]
41 | a | SET | set custom OEM branding (login web page) [32 chars]
-----------+---------+------+--
42 | a | GET | OEM branding (welcome web page) [128 chars]
42 | a | SET | set custom OEM branding (welcome web page) [128 chars]
-----------+---------+------+--
43 | u32 | GET | NTP-server IP address
43 | | SET | n/a (read-only)
-----------+---------+------+--
44 | u32 | GET | NTP-client status (0 = NOT synchronized)
44 | | SET | n/a (read-only)
-----------+---------+------+--
45 | u32 | GET | UpTime value - units: msec (uptime is constantly counted since then latest SDS FW boot)
45 | | SET | n/a (read-only)
-----------+---------+------+--
46 | u32 | GET | temperature of SoC - the RAW value (you have to manually recalculate this raw value to get degC)
46 | i32 | GET | temperature of SoC - already recalculated to degC (SDS does have, and uses, all the required calibration info)
46 | | SET | n/a (read-only)
-----------+---------+------+--
48..60 | | GET | n/a (reserved)
48..60 | | SET | n/a (reserved)
-----------+---------+------+--
61 | u32 | GET | read this to get a 32-bit Random Number (HW RNG)
61 | | SET | n/a (read-only)
-----------+---------+------+--
62..63 | | GET | n/a (reserved)
62..63 | | SET | n/a (reserved)
-----------+---------+------+--
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)
64 | u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #0
-----------+---------+------+--
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)
65 | u32 | SET | n/a (reserved)
-----------+---------+------+--
66 | u32 | GET | DNS-server IP address
66 | | SET | n/a (read-only)
-----------+---------+------+--
67 | u32 | GET | info about SDS device IP address origin (0=none, 1=manual, 2=dhcp)
67 | | SET | n/a (read-only)
-----------+---------+------+--
68 | u32 | GET | info about DNS server IP address origin (0=none, 1=manual, 2=dhcp)
68 | | SET | n/a (read-only)
-----------+---------+------+--
69 | | GET | n/a (reserved)
69 | | SET | n/a (reserved)
-----------+---------+------+--
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)
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)
-----------+---------+------+--
71..77 | | GET | n/a (reserved)
71..77 | | SET | n/a (reserved)
-----------+---------+------+--
78 | u32 | GET | SDS HW availability detail (information): 0 = single PWM output / 4 = four PWM outputs
78 | | SET | n/a (reserved)
-----------+---------+------+--
79 | u32 | GET | SDS HW sub-type (information): 1 = variant "DP" / 0 = basic BIG (no DP)
79 | | SET | n/a (reserved)
-----------+---------+------+--
80 | u32 | GET | SDS HW sub-type (information): 1 = variant "DS84" / 0 = no DS84
80 | | SET | n/a (reserved)
-----------+---------+------+--
81..84 | | GET | n/a (reserved)
81..84 | | SET | n/a (reserved)
-----------+---------+------+--
85 | u32 | GET | SDS module type (BIG, BIG2 or STSW) discrimination: 0 = STSW or SMALL / 1 = BIG / 2 = BIG2
85 | | SET | n/a (reserved)
-----------+---------+------+--
86 | u32 | GET | FC: actual state (running, uploading, failed etc.) of the FULL-C program (0, 1, 2, 4, 8, 16, 32, 64)
86 | | SET | n/a (reserved)
-----------+---------+------+--
87 | u32 | GET | FC: unique identifier of the actually uploaded FULL-C program
87 | | SET | n/a (reserved)
-----------+---------+------+--
88 | | GET | n/a (reserved)
88 | | SET | n/a (reserved)
-----------+---------+------+--
89 | u32 | GET | SDS IP-WatchDog: state (0 = OFF)
89 | | SET | n/a (read-only)
-----------+---------+------+--
90 | u32 | GET | SDS IP-WatchDog: last known RTT (msecs)
90 | | SET | n/a (read-only)
-----------+---------+------+--
91 | u32 | GET | SDS IP-WatchDog: logical output status
91 | | SET | n/a (read-only)
-----------+---------+------+--
92..131 | | GET | n/a (reserved)
92..131 | | SET | n/a (reserved)
-----------+---------+------+--
132 | u32 | GET | FC: UTC time value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
132 | | SET | n/a (read-only)
-----------+---------+------+--
133 | u32 | GET | FC: UpTime value, of the last FC-WDG restart of this (same) program (zeroed when a new program is uploaded)
133 | | SET | n/a (read-only)
-----------+---------+------+--
134 | a | GET | FC: archived text of the last FC error
134 | | SET | n/a (read-only)
-----------+---------+------+--
135 | u32 | GET | FC: number of FC-WDF restarts of this (same) program (zeroed when a new program is uploaded)
135 | | SET | n/a (read-only)
-----------+---------+------+--
136 | u32 | GET | FC: total count of all FC program starts, since the SDS boot
136 | | SET | n/a (read-only)
-----------+---------+------+--
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)
137 | | SET | n/a
-----------+---------+------+--
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)
138 | | SET | n/a
-----------+---------+------+--
139 | u32 | GET | NTP true actual raw epoch-time (secs since Linux Epoch) = clean UTC with *no* GMT nor DST offset applied
139 | | SET | n/a
-----------+---------+------+--
140 | u32 | GET | FC: custom TRAP variable - read (TRAP:401)
140 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:401)
-----------+---------+------+--
141 | a | GET | FC: custom TRAP variable - read (TRAP:402)
141 | a | SET | FC: custom TRAP variable - write to change (TRAP:402) (note. max 32 characters)
-----------+---------+------+--
142 | u32 | GET | FC: custom TRAP variable - read (TRAP:403)
142 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:403)
-----------+---------+------+--
143 | u32 | GET | FC: custom TRAP variable - read (TRAP:404)
143 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:404)
-----------+---------+------+--
144 | u32 | GET | FC: custom TRAP variable - read (TRAP:405)
144 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:405)
-----------+---------+------+--
145 | u32 | GET | FC: custom TRAP variable - read (TRAP:406)
145 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:406)
-----------+---------+------+--
146 | u32 | GET | FC: custom TRAP variable - read (TRAP:407)
146 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:407)
-----------+---------+------+--
147 | u32 | GET | FC: custom TRAP variable - read (TRAP:408)
147 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:408)
-----------+---------+------+--
148 | u32 | GET | FC: custom TRAP variable - read (TRAP:409)
148 | u32 | SET | FC: custom TRAP variable - write to change (TRAP:409)
-----------+---------+------+--
149 | | GET | n/a (reserved)
149 | | SET | n/a (reserved)
-----------+---------+------+--
150 | | GET | FC: shared-variables access control - read state of the access control
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)
-----------+---------+------+--
151..182 | u32 (a) | GET | OPTO1..OPTO32 status (warning: 0 = input ACTIVE = with signal) (non-zero = input not active = no signal)
151..182 | | SET | n/a (read-only)
-----------+---------+------+--
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
183 | | SET | n/a (read-only)
-----------+---------+------+--
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)
184 | | SET | n/a (read-only)
-----------+---------+------+--
185 | u32 | GET | FC: actual FULL-C WatchDog (decreasing) timeout counter value, v msec
185 | | SET | n/a (read-only)
-----------+---------+------+--
186 | u32 | GET | (common) frequency for PWM3 and PWM4 generator (1Hz .. 5MHz)
186 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
187 | u32 | GET | PWM3 duty-cycle percent (0..100 [%])
187 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
188 | u32 | GET | PWM3 HW: direct "pulse" register value
188 | | SET | n/a
-----------+---------+------+--
189 | u32 | GET | PWM4 duty-cycle percent (0..100 [%])
189 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
190 | u32 | GET | PWM4 HW: direct "pulse" register value
190 | | SET | n/a
-----------+---------+------+--
191 | u32 | GET | (common) frequency for PWM1 and PWM2 generator (1Hz .. 5MHz)
191 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
192 | u32 | GET | PWM1 duty-cycle percent (0..100 [%])
192 | | SET | N/A (use SDS_PWMx_setDutyAsPercents)
-----------+---------+------+--
193 | u32 | GET | PWM1 HW: read direct "pulse" (compare) register value
193 | u32 | SET | PWM1 HW: write to direct "pulse" (compare) register value
-----------+---------+------+--
194 | u32 | GET | reserved
194 | | SET | N/A
-----------+---------+------+--
195 | u32 | GET | reserved
195 | | SET | N/A
-----------+---------+------+--
196..228 | u32 (a) | GET | RELAY1..RELAY32 - "who" controls this output
196..228 | u32 | SET | RELAY1..RELAY32 - (0 = manual = user via web) (2 = FULL-C) (4 = SDS IPwdg)
-----------+---------+------+--
229..230 | | GET | n/a (reserved)
229..230 | | SET | n/a (reserved)
-----------+---------+------+--
231..262 | u32 (a) | GET | RELAY1..RELAY32 - output status (0 = off)
231..262 | u32 | SET | RELAY1..RELAY32 - output status control (0 = off) (!0 = coil activated)
-----------+---------+------+--
263..265 | | GET | n/a (reserved)
263..265 | | SET | n/a (reserved)
-----------+---------+------+--
266..297 | a | GET | RELAY1..RELAY32 - identification/name (text, see webadmin)
266..297 | | SET | n/a (read-only)
-----------+---------+------+--
298..300 | | GET | n/a (reserved)
298..300 | | SET | n/a (reserved)
-----------+---------+------+--
301 | u32 | GET | status (log0/log1) of GPIO-TOPBOARD pin
301 | u32 | SET | control the GPIO-TOPBOARD pin value (if direction is set to output)
-----------+---------+------+--
302 | u32 | GET | direction (in/out) of GPIO-TOPBOARD pin
302 | u32 | SET | control the GPIO-TOPBOARD pin direction (input or output)
-----------+---------+------+--
303..310 | | GET | n/a (reserved)
303..310 | | SET | n/a (reserved)
-----------+---------+------+--
311..342 | f32 (a) | GET | AD: recalculated value (float) of A/D input
311..342 | | SET | n/a (read-only)
-----------+---------+------+--
343..374 | a | GET | AD: input identification / name (text)
343..374 | | SET | n/a (read-only)
-----------+---------+------+--
375..406 | a | GET | AD: input unit name (text)
375..406 | | SET | n/a (read-only)
-----------+---------+------+--
407..427 | | GET | n/a (reserved)
407..427 | | SET | n/a (reserved)
-----------+---------+------+--
428 | u32 | GET | AD: user-selected type of the OpAmp chip (HW SDS) (0 = AD) (9 = LMV)
428 | | SET | n/a (read-only) (configuration to be done via web admin) - note. this must match the HW
-----------+---------+------+--
429 | u32 | GET | AD: raw value of Vbatt (raw ADC value). To convert use: Vbatt = (raw * 3.3)/2048 (result in Volts)
429 | | SET | n/a (read-only)
-----------+---------+------+--
430 | u32 | GET | AD: value of VrefInt in miliVolts (typical value: 3300)
430 | | SET | n/a (read-only)
-----------+---------+------+--
431..438 | u32 (a) | GET | AD: raw value of A/D input in 12bits (0..4095) - for all SDS variants (64, 128 and 512)
431..438 | | SET | n/a (read-only)
-----------+---------+------+--
439..446 | u32 (a) | GET | AD: raw value of A/D input in 16bits (0..65535) - available only for the 512 SDS variant
439..446 | | SET | n/a (read-only)
-----------+---------+------+--
447..462 | | GET | n/a (reserved)
447..462 | | SET | n/a (reserved)
-----------+---------+------+--
463..469 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [0]
463..469 | | SET | n/a (read-only)
-----------+---------+------+--
470..476 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [1]
470..476 | | SET | n/a (read-only)
-----------+---------+------+--
477..483 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [2]
477..483 | | SET | n/a (read-only)
-----------+---------+------+--
484..490 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [3]
484..490 | | SET | n/a (read-only)
-----------+---------+------+--
491..497 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [4]
491..497 | | SET | n/a (read-only)
-----------+---------+------+--
498..504 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [5]
498..504 | | SET | n/a (read-only)
-----------+---------+------+--
505..511 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [6]
505..511 | | SET | n/a (read-only)
-----------+---------+------+--
512..518 | f32 (a) | GET | AD: calibration constants (F0..F6) for A/D input nr. [7]
512..518 | | SET | n/a (read-only)
-----------+---------+------+--
519..991 | | GET | n/a (reserved)
519..991 | | SET | n/a (reserved)
-----------+---------+------+--
992 | u32 | GET | UTC timestamp (localtime) of the moment, when local clock gets to 23:59:59 (= last second of this day)
992 | | SET | n/a (reserved)
-----------+---------+------+--
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)
993 | | SET | n/a (reserved)
-----------+---------+------+--
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
994 | | SET | n/a (reserved)
-----------+---------+------+--
995 | u32 | GET | count of seconds, during yesterday, capturing the total length of T0 tariff activity (captures the timespan since [993] to [994])
995 | | SET | n/a (reserved)
-----------+---------+------+--
996 | u32 | GET | count of seconds, during yesterday, capturing the total length of T1 tariff activity (captures the timespan since [993] to [994])
996 | | SET | n/a (reserved)
-----------+---------+------+--
997 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T0 tariff being active
997 | | SET | n/a (reserved)
-----------+---------+------+--
998 | u32 | GET | count of seconds since the moment of [994] (start of today) until NOW; counting the duration of T1 tariff being active
998 | | SET | n/a (reserved)
-----------+---------+------+--
999 | u32 | GET | immediate state of the global Tariff Input (0 = T0 is active right now) (!0 = T1 is active right now)
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)
-----------+---------+------+--
1000..1031| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T0 tariff
1000..1031| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1032..1063| u32 (a) | GET | [S0-input] actual live value of the impulse counter, for T1 tariff
1032..1063| u32 | SET | [S0-input] modify the impulse counter, for T0 tariff
-----------+---------+------+--
1064..1095| u32 (a) | GET | [S0-input] time distance (in msec) between impulses
1064..1095| | SET | n/a (read-only)
-----------+---------+------+--
1096..1127| u32 (a) | GET | [S0-input] time (in msec) since the last captured impulse
1096..1127| | SET | n/a (read-only)
-----------+---------+------+--
1128..1159| u32 | GET | [S0-input] T0 counter value difference for the yesterday (for timespan since [993] to [994])
1128..1159| | SET | n/a (reserved)
-----------+---------+------+--
1160..1191| u32 | GET | [S0-input] T1 counter value difference for the yesterday (for timespan since [993] to [994])
1160..1191| | SET | n/a (reserved)
-----------+---------+------+--
1192..1223| u32 | GET | [S0-input] T0 counter value difference for the today - timespan since [994] (since start of today) to now
1192..1223| | SET | n/a (reserved)
-----------+---------+------+--
1224..1255| u32 | GET | [S0-input] T1 counter value difference for the today - timespan since [994] (since start of today) to now
1224..1255| | SET | n/a (reserved)
-----------+---------+------+--
1256..1499| | GET | n/a (reserved)
1256..1499| | SET | n/a (reserved)
-----------+---------+------+--
1500..1531| a | GET | [S0-input] master configuration struct for this input
1500..1531| a | SET | n/a (reserved)
-----------+---------+------+--
1532..1999| | GET | n/a (reserved)
1532..1999| | SET | n/a (reserved)
-----------+---------+------+--
2000..2063| u32 (a) | GET | [1-W BUS (A)] device status
2000..2063| | SET | n/a (reserved)
-----------+---------+------+--
2100..2163| a | GET | [1-W BUS (A)] master configuration struct for this OneWire device
2100..2163| | SET | n/a (reserved)
-----------+---------+------+--
2200..2263| i32 (a) | GET | [1-W BUS (A)] obtained value from device (basic value)
2200..2263| | SET | n/a (reserved)
-----------+---------+------+--
2300..2363| i32 (a) | GET | [1-W BUS (A)] obtained value from device (additional value)
2300..2363| | SET | n/a (reserved)
-----------+---------+------+--
2364..2487| | GET | n/a (reserved)
2364..2487| | SET | n/a (reserved)
-----------+---------+------+--
2488..2495| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (A)
2488..2495| | SET | n/a
-----------+---------+------+--
2496 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (A)
2496 | | SET | n/a
-----------+---------+------+--
2497 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (A)
2497 | | SET | n/a
-----------+---------+------+--
2498 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (A)
2498 | | SET | n/a
-----------+---------+------+--
2499 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (A)
2499 | | SET | n/a
-----------+---------+------+--
2500..2563| u32 (a) | GET | [1-W BUS (B)] device status
2500..2563| | SET | n/a (reserved)
-----------+---------+------+--
2600..2663| a | GET | [1-W BUS (B)] master configuration struct for this OneWire device
2600..2663| | SET | n/a (reserved)
-----------+---------+------+--
2700..2763| i32 (a) | GET | [1-W BUS (B)] obtained value from device (basic value)
2700..2763| | SET | n/a (reserved)
-----------+---------+------+--
2800..2863| i32 (a) | GET | [1-W BUS (B)] obtained value from device (additional value)
2800..2863| | SET | n/a (reserved)
-----------+---------+------+--
2864..2986| | GET | n/a (reserved)
2864..2986| | SET | n/a (reserved)
-----------+---------+------+--
2986..2993| a | GET | (8-Byte) ROM code for a FamilyID OneWire device found with SDS_onewire_search_bus() for bus (B)
2986..2993| | SET | n/a
-----------+---------+------+--
2994 | u32 | GET | number of FamilyID OneWire devices found (via last SEARCH scan (SDS_onewire_search_bus)) on bus (B)
2994 | | SET | n/a
-----------+---------+------+--
2995 | i32 | GET | principal result of a last SEARCH scan (SDS_onewire_search_bus) of the OneWire bus (B)
2995 | | SET | n/a
-----------+---------+------+--
2996 | i32 | GET | principal result of a last MASTER rescan of the OneWire bus (B)
2996 | | SET | n/a
-----------+---------+------+--
2997 | u32 | GET | number of OneWire devices found (via MASTER rescan) on bus (B)
2997 | | SET | n/a
-----------+---------+------+--
2998 | u32 | GET | general 1-W Master Chip status: 1 = detecting; 2 or 4 = failure; 8 = working; 16 = disabled by user
2998 | | SET | n/a (read-only)
-----------+---------+------+--
2999 | u32 | GET | general 1-W Master Chip status: detection-retry countdown (*10msec)
2999 | | SET | n/a (read-only)
-----------+---------+------+--
3000 | | GET | n/a (reserved)
3000 | | SET | n/a (reserved)
-----------+---------+------+--
3001 | a | GET | custom 24-byte string (readable via SNMP .8.80)
3001 | a | SET | write
-----------+---------+------+--
3002 | a | GET | custom 24-byte string (readable via SNMP .8.81)
3002 | a | SET | write
-----------+---------+------+--
3003 | a | GET | custom 16-byte string (readable via SNMP .8.82)
3003 | a | SET | write
-----------+---------+------+--
3004 | a | GET | custom 16-byte string (readable via SNMP .8.83)
3004 | a | SET | write
-----------+---------+------+--
3005 | a | GET | custom 16-byte string (readable via SNMP .8.84)
3005 | a | SET | write
-----------+---------+------+--
3006..3799| | GET | n/a (reserved)
3006..3799| | SET | n/a (reserved)
-----------+---------+------+--
3800 | u32 | GET | PVD Active - (nonzero:) main power failure detected
3800 | | SET | n/a (read-only)
-----------+---------+------+--
3801 | u32 | GET | PVD Was Active - this flag is only cleared by reading this index 3801
3801 | | SET | n/a (read-only)
-----------+---------+------+--
3802..3849| | GET | n/a (reserved)
3802..3849| | SET | n/a (reserved)
-----------+---------+------+--
3850 | u32 | GET | SD Card - fully mounted and useable
3850 | | SET | n/a (read-only)
-----------+---------+------+--
3851 | i32 | GET | latest file i/o error code
3851 | | SET | n/a (read-only)
-----------+---------+------+--
3852 | u32 | GET | SD Card - Block Size in bytes (typically 512)
3852 | | SET | n/a (read-only)
-----------+---------+------+--
3853 | u32 | GET | SD Card - CardType
3853 | | SET | n/a (read-only)
-----------+---------+------+--
3854 | u32 | GET | SD Card - CID - ProductSN
3854 | | SET | n/a (read-only)
-----------+---------+------+--
3855 | u32 | GET | statistic counter: SDcard: all init attempts (= successful + failed)
3855 | | SET | n/a (read-only)
-----------+---------+------+--
3856 | u32 | GET | statistic counter: SDcard: failed init attempts
3856 | | SET | n/a (read-only)
-----------+---------+------+--
3857 | u32 | GET | SD Card - Total Sector Count in KiB (size of the card)
3857 | | SET | n/a (read-only)
-----------+---------+------+--
3858 | u32 | GET | statistic counter: SDcard: sector reads
3858 | | SET | n/a (read-only)
-----------+---------+------+--
3859 | u32 | GET | statistic counter: SDcard: sector writes
3859 | | SET | n/a (read-only)
-----------+---------+------+--
3860 | u32 | GET | statistic counter: SDcard: sector r/w failures
3860 | | SET | n/a (read-only)
-----------+---------+------+--
3861 | u32 | GET | statistic counter: number of opened files
3861 | | SET | n/a (read-only)
-----------+---------+------+--
3862..3999| | GET | n/a (reserved)
3862..3999| | SET | n/a (reserved)
-----------+---------+------+--
4000..4099| i32 | GET | Shared Variables: S00 through S99 - read
4000..4099| i32 | SET | Shared Variables: S00 through S99 - write
-----------+---------+------+--
4100..4199| u32 | GET | Shared Variables: U00 through U99 - read
4100..4199| u32 | SET | Shared Variables: U00 through U99 - write
-----------+---------+------+--
4200..4299| f32 | GET | Shared Variables: F00 through F99 - read
4200..4299| f32 | SET | Shared Variables: F00 through F99 - write
-----------+---------+------+--
4300..4399| a | GET | Shared Variables: T00 through T99 - read
4300..4399| a | SET | Shared Variables: T00 through T99 - write
-----------+---------+------+--
4400..4989| | GET | n/a (reserved)
4400..4989| | SET | n/a (reserved)
-----------+---------+------+--
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)
4990..4999| u32 | SET | write this to set/start/restart an automatic SECOND DOWN-COUNTER #1..#10
-----------+---------+------+--
5000..5127| u/i/f 32| GET | BackUp-RAM (FC version 0x08+) - write
5000..5127| u/i/f 32| SET | BackUp-RAM (FC version 0x08+) - read
-----------+-+-------+------+--
5128..11197 | | GET | n/a (reserved)
5128..11197 | | SET | n/a (reserved)
-----------+-+-------+------+--
11198 | u32 | GET | mqtt_publish PUBLISH Fixed Header value ( 0b0011dqqr : d=DUP, qq=QOS, r=RETAIN )
11198 | u32 | SET | write ( default: 0b00110001 )
-----------+---------+------+--
11199 | u/i 32 | GET | FW support for MQTT-c (0 == NOT present)
11199 | | SET | n/a
-----------+---------+------+--
12200 | i32 | GET | work progress (and result) of mqtt_connect()
12200 | | SET | n/a
-----------+---------+------+--
12201 | i32 | GET | "CONNACK Connect Return" - result of mqtt_connect()
12201 | | SET | n/a
-----------+---------+------+--
12202 | i32 | GET | result of: mqtt_publish(), mqtt_subscribe(), mqtt_unsubscribe_index(), mqtt_unsubscribe_name()
12202 | | SET | n/a
-----------+---------+------+--
12203 | i32 | GET | MQTT protocol error counter (informative)
12203 | | SET | n/a
-----------+--+------+------+--
12204..12208 | | GET | n/a (reserved)
12204..12208 | | SET | n/a (reserved)
-----------+--+------+------+--
12209 | i32 | GET | Subscribe Table - total number of available rows
12209 | | SET | n/a
-----------+---------+------+--
12210 | a | GET | latest received Topic Name (sent from broker)
12210 | | SET | n/a
-----------+--+------+------+--
12211..12241 | a | GET | Subscribe Table: Topic Name for each table row
12211..12241 | | SET | n/a
--------------+------+------+--
12242..12249 | | GET | n/a (reserved)
12242..12249 | | SET | n/a
-----------+--+------+------+--
12250 | a | GET | latest received Value (sent from broker)
12250 | | SET | n/a
-----------+--+------+------+--
12251..12281 | a | GET | Subscribe Table: actual Value for each table row
12251..12281 | | SET | n/a
--------------+------+------+--
12282..12289 | | GET | n/a (reserved)
12282..12289 | | SET | n/a
-----------+--+------+------+--
12290 | u32 | GET | timestamp for the latest received data (Topic) from broker
12290 | | SET | n/a
-----------+--+------+--+---+--+--
12291..12321 | u32 (a) | GET | Subscribe Table: timestamp for the last Value update, for each table row
12291..12321 | | SET | n/a
--------------+------+--+---+--+--
12322..12398 | | GET | n/a (reserved)
12322..12398 | | SET | n/a (reserved)
-----------+--+------+------+--
12399 | u/i 32 | GET | FW support for MODBUS-TCP-c (0 == NOT present)
12399 | | SET | n/a
-----------+---------+------+--
12400 | i32 | GET | work progress (and result) of modbus_tcp_connect()
12400 | | SET | n/a
-----------+---------+------+--
12401 | i32 | GET | progress/result for function 0x01 - modbus_tcp_read(uid, 0x01, ...);
12401 | | SET | n/a
-----------+---------+------+--
12402 | i32 | GET | progress/result for function 0x02 - modbus_tcp_read(uid, 0x02, ...);
12402 | | SET | n/a
-----------+---------+------+--
12403 | i32 | GET | progress/result for function 0x03 - modbus_tcp_read(uid, 0x03, ...);
12403 | | SET | n/a
-----------+---------+------+--
12404 | i32 | GET | progress/result for function 0x04 - modbus_tcp_read(uid, 0x04, ...);
12404 | | SET | n/a
-----------+---------+------+--
12405 | i32 | GET | progress/result for function 0x05 - modbus_tcp_writesingle(uid, 0x05, ...);
12405 | | SET | n/a
-----------+---------+------+--
12406 | i32 | GET | progress/result for function 0x06 - modbus_tcp_writesingle(uid, 0x06, ...);
12406 | | SET | n/a
-----------+--+------+------+--
12407..12414 | | GET | n/a (reserved)
12407..12414 | | SET | n/a (reserved)
-----------+--+------+------+--
12415 | i32 | GET | progress/result for function 0x0F - modbus_tcp_writemultiple(uid, 0x0F, ...);
12415 | | SET | n/a
-----------+---------+------+--
12416 | i32 | GET | progress/result for function 0x10 - modbus_tcp_writemultiple(uid, 0x10, ...);
12416 | | SET | n/a
-----------+--+------+------+--
12417..12462 | | GET | n/a (reserved)
12417..12462 | | SET | n/a (reserved)
-----------+--+------+------+--
12463 | u/i 32 | GET | latest Unit Identifier value written to MBAP header (msg TX to server)
12463 | | SET | n/a
-----------+---------+------+--
12464 | u/i 32 | GET | latest Transaction Identifier value written to MBAP header (msg TX to server)
12464 | | SET | n/a
-----------+---------+------+--
12465 | u/i 32 | GET | timestamp of the latest received message
12465 | | SET | n/a
-----------+---------+------+--
12466 | u/i 32 | GET | a count of received items inside the latest received message
12466 | | SET | n/a
-----------+---------+------+--
12467 | u/i 32 | GET | latest received Unit Identifier value (inside incoming MBAP header)
12467 | | SET | n/a
-----------+---------+------+--
12468 | u/i 32 | GET | latest received Transaction Identifier value (inside incoming MBAP header)
12468 | | SET | n/a
-----------+---------+------+--
12469 | u/i 32 | GET | an address of the first coil/input/register item (maps to a value in 12470)
12469 | | SET | n/a
-----------+--+------+--+---+--+--
12470..12719 | i32 (a) | GET | received values (latest received message contents)
12470..12719 | | SET | n/a
--------------+---------+------+--

'''Poznámky'''

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.

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).
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.
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.

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).

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.

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.

'''Vysvětlení položek'''

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í.
To naleznete na dalších stránkách v rámci této wiki, nebo se nás rovnou zeptejte (přes forum).

'''Vstupy pro měření napětí'''

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]].

__NOTOC__

FULL-C dns resolv functions

2025-08-10T08:01:54Z

Adamn:

Tato stránka popisuje programovací jazyk '''FULL-C''', který je dostupný na vybraných zařízeních SDS.
Některá zařízení používají SDS-C, pro který máme návody jinde na této WiKi.

== Síťové funkce: dotaz na přidělenou IP adresu pro DNS jméno ==
__NOTOC__

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.

Za tímto účelem jsou k dispozici tyto dvě funkce:
<pre>
void dns_resolv(char *domainNameInput);
unsigned int dns_resolv_status(unsigned int *IP0value, unsigned int *IP1value, unsigned int *IP2value, unsigned int *IP3value);
</pre>

== Princip ==

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).

Po odeslání dotazu se čeká na odpověď, přičemž FULL-C program pravidelně kontroluje stav voláním '''dns_resolv_status()''' funkce.

== Příklad ==

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).

<pre>
void main(void)
{
char DNSname[64];
unsigned int status;
unsigned int IP0, IP1, IP2, IP3;

sprintf((char *)DNSname, "www.google.com");

printf("RESOLVING %s \n", DNSname);

// start - select the new DNSname for all the subsequent status function calls
dns_resolv(DNSname);

// get the first status value
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
// only if truly working, keep waiting
while (512 == status)
{
// keep getting a new status, until it is different than 512
status = dns_resolv_status(&IP0, &IP1, &IP2, &IP3);
}

// check the final status value
if (513 == status)
{
printf("GOT RESULT: IP = %u.%u.%u.%u\n", IP0, IP1, IP2, IP3);
// only in this case, we can use the IPx address
// ... OK

// we can print the additional internal DNS cache status, for this particular domain
// note. the value is valid only if the status is 512, otherwise not
unsigned int ttl;
ttl = SDS_get_u(70); // index [70] = actual TTL value for the selected DNS cache item
printf("DNS CACHE TTL VALUE IS %u SECONDS FOR DOMAIN %s\n", ttl, DNSname);
} else
{
printf("DNS RESOLV FAILED (error %u) \n", status);
// in this case, the IPx adress is not valid, and you need to repeat the dns_resolv() call again
}

}
</pre>

== Interní DNS cache ==

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ěď,
je výsledek k dispozici (dá se získat pomocí dns_resolv_status funkce).

Funkce dns_resolv_status() vrací vždy výsledek toho úplně posledního dotazu, který byl vyvolán zavoláním funkce dns_resolv().

Platná odpověď z DNS serveru je uložena do interní tabulky (DNS cache) v SDS.

Pokud je zbývající hodnota TTL větší než 0, bude ihned k dispozici odpověď z interní cache.

Pokud záznam v interní cache není (nebo už vypršel), bude automaticky odeslána žádost o nový překlad na DNS server.

Toto si řídí SDS interně.

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.

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).

== Upozornění ==

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.

DNS cache je (záměrně) vymazána při:
* nahrání nového FULLC programu
* restartu zařízení SDS

DNS cache není vymazána při výpadku Ethernetového připojení.

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).

== Stavové hodnoty ==

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).

dns_resolv_status() význam
-------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------
0 | klid, můžete odeslat DNS dotaz, funkce dns_resolv_status() současně nevrací platnou IP adresu (musíte nejprve spustit DNS překlad)
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)
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)
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)
515 | funkce byla zavolána s neplatnými parametry - nic nebylo provedeno, funkce nevrací platnou IP adresu

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().

SDS BIG: firmware changelog

2025-03-28T18:57:51Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 28.3.2025 ==
* oprava odpovědi pro S-UDP příkaz 0x04 (Read FC)

== 15.3.2025 ==
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)

== 27.2.2025 ==
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)
* 512: oprava nefunkčního čtení ze sériové linky COM6

== 8.2.2025 ==
* oprava některých payloadů v protokolu SUDP

== 22.7.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

Firmware

2025-03-28T18:57:11Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<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]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

SDS BIG: firmware changelog

2025-03-15T09:43:28Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 15.3.2025 ==
* oprava odpovědi pro S-UDP příkaz 0x08 (Write FC)

== 27.2.2025 ==
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)
* 512: oprava nefunkčního čtení ze sériové linky COM6

== 8.2.2025 ==
* oprava některých payloadů v protokolu SUDP

== 22.7.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

Firmware

2025-03-15T09:42:27Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<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]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

M2M: S-UDP protocol

2025-03-15T09:02:42Z

Adamn:

Tato stránka popisuje funkci zařízení SDS '''druhé produktové řady''' - protože SDS první produktové řady používají jiný protokol.

== Rychlá komunikace: S-UDP ==

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.

S-UDP používá následující výchozí UDP PORT: 310

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.

Přenos dat využívá specifického protokolu, který umožňuje bezpečně ovládat specifické zařízení SDS.

'''Typické použití:''' komunikace zařízení SDS s protistranou (např. aplikace na mobilním telefonu).

== Informace ==

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.

== Bezpečnost ==

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á.

Je to založeno na následujícím principu:

- 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)

- 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).

== S-UDP protokol ==

Každý příkaz a odpověď jsou v samostatném, jediném, UDP paketu.

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.

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ě):

[MASTER PACKET CONTENTS]

OFFSET | LEN | DATA
----------+--------+---------------------------------------------------------------
0 | 28 | HEADER
28 | PL*16 | ENCRYPTED PAYLOAD (contains: payload-header and payload-data)

'''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.

LITTLE-ENDIAN

Následující uvedené položky jsou ve formátu [http://en.wikipedia.org/wiki/Endianness#Little-endian Little-Endian] (procesory: ARM, x86):
* ''uword'' (unsigned 16-bit)
* ''dword'' (unsigned 32-bit)
* ''slong'' (signed 32-bit)
* ''qword'' (unsigned 64-bit)

Položky typu: ''byte'', ''sbyte'', ''bytes'' - jsou jednotlivé samostatné bajty, nesdružené do společného čísla.

Zde jsou uvedeny detailní položky:

[MASTER PACKET CONTENTS]

OFFSET | LEN | TYPE | DATA
---------+------+--------+-----------------------------

[HEADER]

0 | 3 | bytes | header "SDS"
3 | 1 | byte | TV = (SDS-product-line) including (S-UDP protocol master-version)
4 | 1 | byte | PL = number of 16B chunks - this is the payload_length of [ENCRYPTED PAYLOAD] (example: PL==10 => 160 bytes)
5 | 1 | byte | encryption-flag (NOW ACCEPTS ONLY: 0x10 == XTEA-64-CTR)
6 | 1 | byte | reserved
7 | 1 | byte | CK1: basic additive checksum for [ENCRYPTED PAYLOAD] (start from (including) byte offset [28] and forward)
8 | 4 | dword | user_identifier (correlation identifier) - use this to correlate query to response
12 | 16 | bytes | CounterBlock
----------+------+--------+----------------------------

[ENCRYPTED PAYLOAD] -> everything from this point is included:

28 | 1 | byte | random number (shall be always different than what was used ever before)
29 | 1 | byte | CK2: basic additive checksum for [HEADER] (all bytes [0] to [27] included, BUT: skipping byte [7])
30 | 2 | uword | XR_MTU value (maximal size of the custom-payload data including R) ( XL + R <= XR_MTU )
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)
36 | 4 | dword | uptime (msecs from boot)
40 | 4 | dword | time (epoch) (or, if no NTP is available to SDS, this will be a value of "seconds from boot")
44 | 4 | dword | SDS device type (0xXXXXXXXX) - THIS MUST MATCH
48 | 1 | byte | master_command
49 | 1 | byte | sub_command
50 | 2 | uword | XL value (exact length of the actually useful payload-data): XL = (PL*16) - R - 24

52 | XL | bytes | custom payload-data [C-PAYLOAD]

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.)

----------+------+--------+----------------------------

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.

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).

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é.

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ů.

"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. .

Hodnota "crc32" se počítá pro dešifrované data, algoritmus je identický jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]].

Pro zvolené XTEA-64-CTR má "CounterBlock" následující sestavu svého obsahu:

CounterBlock:

OFFSET | LEN | TYPE | DATA
----------+------+--------+-----------------------------------------------------------------------------------------
0 | 8 | qword | XTEA-64-CTR: 64-bit counter (counter is increased by 1, for each 16B of processed data)
8 | 8 | bytes | (reserved) not-used area = reserved (fill with 0x00)

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ů).

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.

TV: ttttVVVV
76543210

BIT OFFSET | LEN (bits) | content
-----------+------------+--------------------------------------------------
7 (MSB) | 4 | "t": produc-line value: 1 == first, 2 == second
3 | 4 | "V": version: 0 = first S-UDP protocol version

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.

== Postup při příjmu S-UDP paketu ==

Každá strana, která přijme S-UDP paket, provede následující kroky:

1) Ověřit platnost hodnot v [HEADER]
a. text "SDS" (platný obsah)
b. hodnota "TV" ("master-version" a "product-line") (platný obsah)
c. hodnota "PL" v platných mezích
d. hodnota "encryption_flag" (platný obsah)
2) Ověřit základní additive-checksum pro [ENCRYPTED PAYLOAD]
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK1" hodnotě
3) Nastavit dešifrování
a. zvolit algoritmus podle "encryption-flag" hodnoty
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (přečíst z [HEADER])
4) Dešifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
5) Ověřit základní additive-checksum pro [HEADER] - teď totiž už máme hodnotu "CK2"
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ě
6) Ověřit další hodnoty
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
b. uschovat hodnotu "XR_MTU" pro vytváření odpovědi ("XR_MTU" omezuje velikost odpovědi, kterou můžeme zpátky odeslat)
c. ověřit časové údaje ("time" a "uptime")
d. ověřit "XL" vůči "PL"
7) Ověřit CRC-32 dešifrovaného payloadu
a. spočítat CRC-32 správným algoritmem, vučí bajtům (plain-text) z [36] až [52+XL-1] včetně

8) Hotovo: teď se provede aktuální příkaz (Master Command, dle tabulky podle produktové řady viz "TV")
a odešle odpověď (ponechat user_identifier pro korelaci) (pozor na "XR_MTU" omezení)

== Postup při odesílání S-UDP paketu ==

Odesílatel zprávy provádí tyto kroky:

1) Je sestaven přesný obsah [C-PAYLOAD] a určena odpovídající hodnota XL
a. obsah samozřejmě odpovídá tomu co chcete odeslat
b. určí se i "master-command" a "sub-command" (pozor na produktovou řadu SDS - viz "TV")
2) Vyplní se [HEADER]
a. hlavička "SDS", "encryption-flag"
b. zapsat správnou hodnotu "TV" podle protokolu a konkrétního SDS ("master-version", "product-line")
c. určí se nová unikátní hodnota "user_identifier", a zapíše se do [HEADER]
d. zapíše se "CounterBlock" (hodnota pokračuje po předchozím paketu)
3) Nachystá se zaokrouhlovací oblast "R"
a. Pokud XL není beze zbytku dělitelná 16, musí se doplnit oblastí "R"
4) Spočítá se hodnota "PL"
a. PL = (XL + R)/16
b. zapsat do [HEADER]
5) Začne se vyplňovat [ENCRYPTED PAYLOAD]
a. zapsat náhodný byte do "random number"
b. spočítá se hodnota "CK2" (sečíst bajty [0] až [27] - ovšem přeskočit byte [7] - pozor!)
c. zapsat hodnotu "XR_MTU" podle možností zařízení (tzn. jak velkou odpověď lze bezpečně přijmout, podle omezení sítě)
d. zapíší se hodnoty "uptime" a "time", zapsat hodnotu "SDS-DEVICE-TYPE"
e. zapsat "master-command" a "sub-command"
6) Spočítá se CRC-32 (před šifrováním)
a. spočítat crc32 pro bajty (plain-text) z offsetu [36] až [52+XL-1] včetně
7) Nastavit šifrování
a. zvolit algoritmus (musí odpovídat tomu, co se zapsalo do "encryption-flag")
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (stejný jako byl zapsán [HEADER])
8) Šifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
b. aktualizovaná hodnota "CounterBlock" (zvýšená o průběh šifrování) se uschová pro další použití - viz bod " 2) c. "
9) Spočítat základní additive-checksum pro [ENCRYPTED PAYLOAD]
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

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.

== Vzorové obsahy paketů ==

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í).
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.

== Seznam hlavních příkazů ==

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.

Zařazení SDS do produktových řad je v [[Seznam_Všech_SDS|tomto seznamu]].

* První produktová řada: "TV = 0001...." -> '''(1PŘ)'''
* Druhá produktová řada: "TV = 0010...." -> '''(2PŘ)'''

== (2PŘ) Master Command (druhá produktová řada: "TV = 0010...." ) ==

Jednotlivé základní příkazy (''master command''):

MASTER COMMAND | command
----------------+-------------------------------------
0 | NOP (replies with NOP)
1 | general device status
2 | 1-Wire access
4 | read FC-Get list
8 | write FC-Set list
16 | FULL-C shared variable(s) access
32 | serial port access
64 | DataFlash access
128 | reserved

Jak lze vidět, jednotlivé ''master command'' příkazy jsou dále rozlišeny pomocí hodnoty ''sub command''.

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).

== (2-PŘ) Master Command: [0] '''NOP''' ==

SDS odpoví na tento příkaz odesláním [0] NOP.

Tohoto příkazu lze využít k ověření komunikace a k vzájemné základní synchronizace.

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.

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 !

REPLY (master_command == 0, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 4 | bytes | SDS Device Type
10 | 4 | dword | FW version
14 | 32 | bytes | sysLocation (missing the 0x00 terminator)
46 | 8 | bytes | reserved (0x00)
54 | 32 | bytes | OEM string (missing the 0x00 terminator)
86 | 8 | bytes | reserved (0x00)
94 | 1 | byte | bylo aktivováno RSTD
95 | 1 | byte | bylo aktivováno PVD
96 | 1 | byte | SDS je: BIG (hodnota 1) nebo STSW (hodnota 0)
97 | 8 | bytes | reserved (0x00)
105 | 2 | uword | web interface TCP port number (typicky 80)
107 | 1 | byte | SNMP-read enabled
108 | 1 | byte | SNMP-write enabled
109 | 1 | byte | FULLC shared vars access lock (0 = unlocked) tzn. sys[150]
110 | 1 | byte | FULLC program run status
111 | 1 | byte | FULLC program started-by info
112 | 1 | byte | FULLC program watchdog active
113 | 6 | bytes | reserved
119 | 4 | f32 | backup battery voltage (milliVolts)

Pozn. rozšířená funkcionalita příkazu NOP (tedy vracení payloadu) bylo přidáno až ve Firmware od verze 3.10.2019.

== (2-PŘ) Master Command: [1] '''General Device Status''' ==

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.

Základní odpověď s nejzajímavějšími živými údaji. Určeno např. pro průběžnou aktualizaci stavu zobrazeného uživateli.

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 1 | byte | Ethernet Link Status / Speed (0, 10, 100)
7 | 1 | byte | Amount of users logged into SDS Web Admin
8 | 32 | bytes | sysLocation (missing the 0x00 terminator)
40 | 1 | byte | IP Watchdog Config status
41 | 1 | byte | IP Watchdog Output (relay) status
42 | 2 | uword | IP Watchdog RTT value (note.: 0xFFFF = not available)
44 | 1 | byte | DHCP status
45 | 1 | byte | reserved
46 | 1 | byte | NTP status
47 | 1 | sbyte | NTP offset (+/- hours) (signed char)
48 | 2 | uword | SoC chip temperature (degC)
50 | 1 | byte | GPIO-TOPB PIN(s) direction (0 == input)
51 | 1 | byte | GPIO-TOPB PIN(s) pin value
52 | 32*1 | byte | OPTO [1]..[32] status (0xFF == signal) (0x00 == nosignal)
84 | 32*1 | byte | RELAY [1]..[32] status (active/nonactive)
116 | 32*2 | uword | ADC [0]..[31] RAW value
180 | 1 | byte | General 1-W BUS status
181 | 1 | byte | 1-W BUS A - active device count
182 | 1 | byte | 1-W BUS B - active device count
183 | 3 | bytes | reserved (0x00)
186 | 1 | byte | S0 Tariff Value (active/nonactive)
187 | 1 | byte | number of the following S0 INPUT DB data blocks:
188 | 31*28 | data | S0 INPUT [1]..[ (max) 31] DB (data block)

S0-INPUT DB offset | LEN | TYPE | content
-------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
1 | 3 | bytes | reserved (filled with 0x00)
4 | 4 | dword | T0 impulse counter
8 | 4 | dword | T1 impulse counter
12 | 4 | dword | T0 offset
16 | 4 | dword | T1 offset
20 | 4 | dword | measured space between impulses (msec)
24 | 4 | dword | time since last registered impulse (msec)

Sestava [C-PAYLOAD] je tedy zřejmá.

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í).

== (2-PŘ) Master Command: [2] '''1-Wire Access''' ==

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ů.

QUERY/COMMAND TO SDS (master_command == 2)

sub_command | meaning
------------+-----------------------------------------------------------
0 | reserved
1 | obtain status, and list of found items on BUS A
2 | obtain status, and list of found items on BUS B
4 | list all read-values on BUS A
8 | list all read-values on BUS B

První možností tedy je sub_command == 1 , tzn. výpis nalezených zařízení na sběrnici A respektive B:

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 1 or 2

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item status #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item status #63

"1-W item status" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 2 | bytes | reserved (filled with 0x00)
4 | 8 | bytes | ROM-CODE [0]..[7]

Následuje: výpis získaných hodnot (např. změřené teploty z teplotních čidel) pro jednotlivé sběrnice :

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 4 or 8

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item value #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item value #63

"1-W item value" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 1 | byte | value of ROM-CODE offset [0] (1-W DEVICE TYPE: ID)
3 | 1 | byte | value of ROM-CODE offset [7] (1-W DEVICE TYPE: CRC)
4 | 4 | slong | 1-W read: primary value
8 | 4 | slong | 1-W read: secondary value

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).

== (2-PŘ) Master Command: [4] '''Read FC-Get List''' ==

Dotaz (query) který obsahuje seznam indexů jejichž hodnoty jsou tazatelem požadovány, se posílá do SDS, které následně odpoví (reply).

Dotaz i odpověď má dynamický obsah, který je specificky strukturován.

QUERY (master_command == 4, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] space prepared for answer from SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] space prepared for answer from SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] space prepared for answer from SDS

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 !

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).

REPLY (master_command == 4, sent from SDS as reply to query)

SDS writes the values into the "[#n] space prepared for answer from SDS"

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.

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.

Následující popis ukazuje kódování typu proměnné a její délky, ve společném slově:

TBLEN#x: (16-bit unsigned word, little-endian) Type-Bits and Data Length (L#x)

TBLEN#x: TTTTvvvvvvvvvvvv
FEDCBA9876543210

BIT OFFSET (hex) | LEN (bits) | content
-----------------+------------+-----------------------------------------
F (MSB) | 4 | "T": type (see bit-value in next table)
B | 12 | "v": length of data, in bytes

"T" bit-values | meaning | FULL-C set/get
FEDC | | (which function)
----------------+-----------------------------+------------------
0000 | unsigned integer (32-bit) | _u
0001 | signed integer (32-bit) | _i
0010 | float IEEE-754 (32-bit) | _f
0100 | string UTF-8 (L#x * 8-bit) | _a
1000 | reserved (do not use) |

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ů.

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.

'''Index Value''' - každá položka má svůj číselný index, viz [[FULL-C:_set_and_get|seznam všech FULL-C indexů]].

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.

== (2-PŘ) Master Command: [8] '''Write FC-Get List''' ==

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).

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".

COMMAND TO SDS (master_command == 8, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] new data value to write to SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] new data value to write to SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] new data value to write to SDS

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.

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:

REPLY FROM SDS (master_command == 8)

NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS
(previously no proper response was provided)

sub_command | meaning
------------+-----------------------------------------------------------
0 | complete failure (no item modified)
1 | partial failure (some items modified, some not modified)
2 | success (all items modified OK)

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).

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.

== (2-PŘ) Master Command: [16] '''FULL-C Shared Variable(s) Access''' ==

Tento příkaz se využívá k přístupu ke [[FULL-C:_sharing|sdíleným proměnným]] programu FULL-C.

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.

Mohou existovat tyto sdílené proměnné :
* S00 až S99 (hodnoty: signed 32-bit)
* U00 až U99 (hodnoty: unsigned 32-bit)
* F00 až F99 (hodnoty: float 32-bit)
* T00 až T99 (hodnoty: array/text)

Rozlišování jednotlivých funkcí je závislé na hodnotě "sub_command":

QUERY-or-COMMAND TO SDS (master_command == 16, sent to SDS)

sub_command | meaning
------------+---------------------------------------------
0 | provide list of all active shared variables
1 | read from shared variable (single variable)
2 | reserved
4 | write to shared variable (single variable)
8 | reserved

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.

RESPONSE: LIST OF SHARED VARIABLES: sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 13 | bytes | Uxx existence: bit-field
13 | 13 | bytes | Sxx existence: bit-field
26 | 13 | bytes | Fxx existence: bit-field
39 | 13 | bytes | Txx existence: bit-field

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.

Xxx existence: bit-field

BYTE -> [0] . . . [13]
BITS -> 0 . . . 100 (plus 4 at the end, which are not used)

BYTE [0] = bit 0, 1, 2, ..., 7
BYTE [1] = bit 8, 9, 10, ..., 15
...
BYTE [13] = bit 96, 97, 98 ..., 103

example: existence of "U11" => bit 11 => look at BYTE [1]

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.

'''Další,''' "sub_command == 1" umožňuje z konkrétní (jedné) sdílené proměnné číst.

QUERY TO SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "U25")
1 | 1 | byte | reserved (0x00)

A ''odpověď'' je:

REPLY FROM SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "F95")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] data value from the shared variable

'''Dále,''' pro "sub_command == 4" dojde ke změně hodnoty.

COMMAND TO SDS: WRITE ONE SHARED VARIABLE: sub_command = 4

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "T12")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] new data value to write to shared variable

A odpověď je zde shodná jako odpověd pro "sub_command == 1".

== (2-PŘ) Master Command: [32] '''S0 Input Configuration Query''' ==

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.

Pozn. master_command == 32 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 32, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 1 | byte | reserved (0x00)
4 | 32 | bytes | text (name: unit)
36 | 32 | bytes | text (name: money)
68 | 32 | bytes | text (unit: power)
100 | 32 | bytes | text (name: power)
132 | 32 | bytes | text (name: device)
168 | 4 | dword | MTD value
172 | 4 | dword | minimal impulse length (msec)
176 | 4 | dword | impulse constant value (imp. per unit)
180 | 4 | bytes | price for T0
184 | 4 | bytes | price for T1
188 | 8 | bytes | reserved (0x00)
196 | 4 | dword | live value: T0 impulse counter
200 | 4 | dword | live value: T1 impulse counter
204 | 4 | dword | T0 offset
208 | 4 | dword | T1 offset
212 | 4 | dword | live value: measured space between impulses (msec)
216 | 4 | dword | live value: time since last registered impulse (msec)
220 | 4 | bytes | reserved (0x00)
224 | n | bytes | live value: combined text

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).

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).

'''(sub_command = 0xFF)''': speciální odpověď pro Tarifní vstup :

REPLY (master_command == 32, sent from SDS as reply)
sub_command == 0xFF (tariff)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | constant 0xFF
1 | 3 | bytes | reserved (0x00)
4 | 1 | byte | tariff input
5 | 32 | bytes | text (name: tariff)
37 | 32 | bytes | text (name: tariff T0 input)
69 | 32 | bytes | text (name: tariff T1 input)

== (2-PŘ) Master Command: [33] '''S0 Input History Values''' ==

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.

Pozn. master_command == 33 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 33, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 3 | bytes | reserved (0x00)
6 | 2 | word | history depth (number of items) - value "n" (example: five items -> n == 5)
8 | 4 | dword | uptime value for the last element (#n) in the list
12 | 4 | dword | ntptime value for the last element (#n) in the list
16 | 4 | dword | history item #1: value of T0 counter (this is the most oldest item)
20 | 4 | dword | history item #1: value of T1 counter (this is the most oldest item)
...
16+(n-1)*8 | 4 | dword | history item #n: value of T0 counter (this is the most newest item)
16+(n-1)*8+4 | 4 | dword | history item #n: value of T1 counter (this is the most newest item)

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).

== (2-PŘ) Master Command: [40] '''AD Input Configuration Query''' ==

Určeno pro čtení kalibračních konstant pro AD vstupy.

Pozn. master_command == 40 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 40, sent from SDS as reply)
sub_command == index to AD array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual AD input index for this reply
1 | 1 | byte | total number of AD inputs
2 | 2 | bytes | reserved (0x00)
4 | 4 | f32 | F6 calibration constant
8 | 4 | f32 | F5 calibration constant
12 | 4 | f32 | F4 calibration constant
16 | 4 | f32 | F3 calibration constant
20 | 4 | f32 | F2 calibration constant
24 | 4 | f32 | F1 calibration constant
28 | 4 | f32 | F0 calibration constant
32 | 1 | byte | is calibration factory locked
33 | 32 | bytes | unit
65 | 4 | bytes | reserved (0x00)
69 | 32 | bytes | name
101 | 4 | bytes | reserved (0x00)
105 | 4 | dword | raw value
109 | 4 | f32 | real value (converted from raw)
113 | n | bytes | live value text

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).

== (2-PŘ) Master Command: [42] '''PWM Output Configuration Query''' ==

Určeno pro čtení nastavení pro PWM výstup (konfigurace a živý stav).

Pozn. master_command == 42 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 42, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | reserved (0x00)
1 | 1 | byte | "N" = total number of PWM outputs
2 | 2 | bytes | reserved (0x00)

4+(i*12)+ 0 | 4 | dword | frequency (Hz) for PWMx
4+(i*12)+ 4 | 4 | dword | "pulse" value for PWMx
4+(i*12)+ 8 | 1 | byte | "ValueB" value for PWMx
4+(i*12)+ 9 | 2 | uword | "ValueS" value for PWMx
4+(i*12)+ 11 | 1 | byte | output enabled for PWMx

Pozn. PWM1 má hodnotu "i" = 0, PWM2 má hodnotu "i" = 1 atd.

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ů.

== (2-PŘ) Master Command: [44] '''RELAYs Configuration Query''' ==

Určeno pro čtení konfigurace RELAY výstupů (nastavení a živý stav).

Pozn. master_command == 44 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 44, sent from SDS as reply)
sub_command == index to RELAY array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual RELAY output index for this reply
1 | 1 | byte | total number of RELAY outputs
2 | 2 | bytes | reserved (0x00)
4 | 32 | bytes | name
36 | 4 | bytes | reserved (0x00)
40 | 1 | byte | "relay-controlled-by" value
41 | 1 | byte | "relay-output" value

== (2-PŘ) Master Command: [48] '''SD Card Status Query''' ==

Určeno pro čtení stavu SD karty.

Pozn. master_command == 48 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 48, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | card mounted
1 | 3 | bytes | reserved
4 | 4 | dword | card type
8 | 4 | dword | card ProdSN
12 | 4 | dword | card init attempts counter
16 | 4 | dword | card init failures counter
20 | 4 | dword | card total sector count in FAT in KiB
24 | 4 | dword | total sector reads counter
28 | 4 | dword | total sector writes counter
32 | 4 | dword | total sector r/w failures counter

== (2-PŘ) Master Command: [50] '''Serial Port Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [64] '''DataFlash (NVM) Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [128] '''Reserved''' ==

Tento příkaz není v současné verzi použit.

== (1-PŘ) Master Command (první produktová řada: "TV = 0001...." ) ==

Jednotlivé základní příkazy (''master command'') - zatím nejsou pro
první produktovou řadu definovány.

Detaily zde budou doplněny.

__NOTOC__

M2M: S-UDP protocol

2025-03-15T08:47:17Z

Adamn:

Tato stránka popisuje funkci zařízení SDS '''druhé produktové řady''' - protože SDS první produktové řady používají jiný protokol.

== Rychlá komunikace: S-UDP ==

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.

S-UDP používá následující výchozí UDP PORT: 310

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.

Přenos dat využívá specifického protokolu, který umožňuje bezpečně ovládat specifické zařízení SDS.

'''Typické použití:''' komunikace zařízení SDS s protistranou (např. aplikace na mobilním telefonu).

== Informace ==

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.

== Bezpečnost ==

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á.

Je to založeno na následujícím principu:

- 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)

- 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).

== S-UDP protokol ==

Každý příkaz a odpověď jsou v samostatném, jediném, UDP paketu.

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.

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ě):

[MASTER PACKET CONTENTS]

OFFSET | LEN | DATA
----------+--------+---------------------------------------------------------------
0 | 28 | HEADER
28 | PL*16 | ENCRYPTED PAYLOAD (contains: payload-header and payload-data)

'''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.

LITTLE-ENDIAN

Následující uvedené položky jsou ve formátu [http://en.wikipedia.org/wiki/Endianness#Little-endian Little-Endian] (procesory: ARM, x86):
* ''uword'' (unsigned 16-bit)
* ''dword'' (unsigned 32-bit)
* ''slong'' (signed 32-bit)
* ''qword'' (unsigned 64-bit)

Položky typu: ''byte'', ''sbyte'', ''bytes'' - jsou jednotlivé samostatné bajty, nesdružené do společného čísla.

Zde jsou uvedeny detailní položky:

[MASTER PACKET CONTENTS]

OFFSET | LEN | TYPE | DATA
---------+------+--------+-----------------------------

[HEADER]

0 | 3 | bytes | header "SDS"
3 | 1 | byte | TV = (SDS-product-line) including (S-UDP protocol master-version)
4 | 1 | byte | PL = number of 16B chunks - this is the payload_length of [ENCRYPTED PAYLOAD] (example: PL==10 => 160 bytes)
5 | 1 | byte | encryption-flag (NOW ACCEPTS ONLY: 0x10 == XTEA-64-CTR)
6 | 1 | byte | reserved
7 | 1 | byte | CK1: basic additive checksum for [ENCRYPTED PAYLOAD] (start from (including) byte offset [28] and forward)
8 | 4 | dword | user_identifier (correlation identifier) - use this to correlate query to response
12 | 16 | bytes | CounterBlock
----------+------+--------+----------------------------

[ENCRYPTED PAYLOAD] -> everything from this point is included:

28 | 1 | byte | random number (shall be always different than what was used ever before)
29 | 1 | byte | CK2: basic additive checksum for [HEADER] (all bytes [0] to [27] included, BUT: skipping byte [7])
30 | 2 | uword | XR_MTU value (maximal size of the custom-payload data including R) ( XL + R <= XR_MTU )
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)
36 | 4 | dword | uptime (msecs from boot)
40 | 4 | dword | time (epoch) (or, if no NTP is available to SDS, this will be a value of "seconds from boot")
44 | 4 | dword | SDS device type (0xXXXXXXXX) - THIS MUST MATCH
48 | 1 | byte | master_command
49 | 1 | byte | sub_command
50 | 2 | uword | XL value (exact length of the actually useful payload-data): XL = (PL*16) - R - 24

52 | XL | bytes | custom payload-data [C-PAYLOAD]

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.)

----------+------+--------+----------------------------

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.

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).

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é.

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ů.

"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. .

Hodnota "crc32" se počítá pro dešifrované data, algoritmus je identický jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]].

Pro zvolené XTEA-64-CTR má "CounterBlock" následující sestavu svého obsahu:

CounterBlock:

OFFSET | LEN | TYPE | DATA
----------+------+--------+-----------------------------------------------------------------------------------------
0 | 8 | qword | XTEA-64-CTR: 64-bit counter (counter is increased by 1, for each 16B of processed data)
8 | 8 | bytes | (reserved) not-used area = reserved (fill with 0x00)

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ů).

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.

TV: ttttVVVV
76543210

BIT OFFSET | LEN (bits) | content
-----------+------------+--------------------------------------------------
7 (MSB) | 4 | "t": produc-line value: 1 == first, 2 == second
3 | 4 | "V": version: 0 = first S-UDP protocol version

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.

== Postup při příjmu S-UDP paketu ==

Každá strana, která přijme S-UDP paket, provede následující kroky:

1) Ověřit platnost hodnot v [HEADER]
a. text "SDS" (platný obsah)
b. hodnota "TV" ("master-version" a "product-line") (platný obsah)
c. hodnota "PL" v platných mezích
d. hodnota "encryption_flag" (platný obsah)
2) Ověřit základní additive-checksum pro [ENCRYPTED PAYLOAD]
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK1" hodnotě
3) Nastavit dešifrování
a. zvolit algoritmus podle "encryption-flag" hodnoty
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (přečíst z [HEADER])
4) Dešifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
5) Ověřit základní additive-checksum pro [HEADER] - teď totiž už máme hodnotu "CK2"
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ě
6) Ověřit další hodnoty
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
b. uschovat hodnotu "XR_MTU" pro vytváření odpovědi ("XR_MTU" omezuje velikost odpovědi, kterou můžeme zpátky odeslat)
c. ověřit časové údaje ("time" a "uptime")
d. ověřit "XL" vůči "PL"
7) Ověřit CRC-32 dešifrovaného payloadu
a. spočítat CRC-32 správným algoritmem, vučí bajtům (plain-text) z [36] až [52+XL-1] včetně

8) Hotovo: teď se provede aktuální příkaz (Master Command, dle tabulky podle produktové řady viz "TV")
a odešle odpověď (ponechat user_identifier pro korelaci) (pozor na "XR_MTU" omezení)

== Postup při odesílání S-UDP paketu ==

Odesílatel zprávy provádí tyto kroky:

1) Je sestaven přesný obsah [C-PAYLOAD] a určena odpovídající hodnota XL
a. obsah samozřejmě odpovídá tomu co chcete odeslat
b. určí se i "master-command" a "sub-command" (pozor na produktovou řadu SDS - viz "TV")
2) Vyplní se [HEADER]
a. hlavička "SDS", "encryption-flag"
b. zapsat správnou hodnotu "TV" podle protokolu a konkrétního SDS ("master-version", "product-line")
c. určí se nová unikátní hodnota "user_identifier", a zapíše se do [HEADER]
d. zapíše se "CounterBlock" (hodnota pokračuje po předchozím paketu)
3) Nachystá se zaokrouhlovací oblast "R"
a. Pokud XL není beze zbytku dělitelná 16, musí se doplnit oblastí "R"
4) Spočítá se hodnota "PL"
a. PL = (XL + R)/16
b. zapsat do [HEADER]
5) Začne se vyplňovat [ENCRYPTED PAYLOAD]
a. zapsat náhodný byte do "random number"
b. spočítá se hodnota "CK2" (sečíst bajty [0] až [27] - ovšem přeskočit byte [7] - pozor!)
c. zapsat hodnotu "XR_MTU" podle možností zařízení (tzn. jak velkou odpověď lze bezpečně přijmout, podle omezení sítě)
d. zapíší se hodnoty "uptime" a "time", zapsat hodnotu "SDS-DEVICE-TYPE"
e. zapsat "master-command" a "sub-command"
6) Spočítá se CRC-32 (před šifrováním)
a. spočítat crc32 pro bajty (plain-text) z offsetu [36] až [52+XL-1] včetně
7) Nastavit šifrování
a. zvolit algoritmus (musí odpovídat tomu, co se zapsalo do "encryption-flag")
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (stejný jako byl zapsán [HEADER])
8) Šifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
b. aktualizovaná hodnota "CounterBlock" (zvýšená o průběh šifrování) se uschová pro další použití - viz bod " 2) c. "
9) Spočítat základní additive-checksum pro [ENCRYPTED PAYLOAD]
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

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.

== Vzorové obsahy paketů ==

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í).
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.

== Seznam hlavních příkazů ==

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.

Zařazení SDS do produktových řad je v [[Seznam_Všech_SDS|tomto seznamu]].

* První produktová řada: "TV = 0001...." -> '''(1PŘ)'''
* Druhá produktová řada: "TV = 0010...." -> '''(2PŘ)'''

== (2PŘ) Master Command (druhá produktová řada: "TV = 0010...." ) ==

Jednotlivé základní příkazy (''master command''):

MASTER COMMAND | command
----------------+-------------------------------------
0 | NOP (replies with NOP)
1 | general device status
2 | 1-Wire access
4 | read FC-Get list
8 | write FC-Set list
16 | FULL-C shared variable(s) access
32 | serial port access
64 | DataFlash access
128 | reserved

Jak lze vidět, jednotlivé ''master command'' příkazy jsou dále rozlišeny pomocí hodnoty ''sub command''.

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).

== (2-PŘ) Master Command: [0] '''NOP''' ==

SDS odpoví na tento příkaz odesláním [0] NOP.

Tohoto příkazu lze využít k ověření komunikace a k vzájemné základní synchronizace.

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.

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 !

REPLY (master_command == 0, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 4 | bytes | SDS Device Type
10 | 4 | dword | FW version
14 | 32 | bytes | sysLocation (missing the 0x00 terminator)
46 | 8 | bytes | reserved (0x00)
54 | 32 | bytes | OEM string (missing the 0x00 terminator)
86 | 8 | bytes | reserved (0x00)
94 | 1 | byte | bylo aktivováno RSTD
95 | 1 | byte | bylo aktivováno PVD
96 | 1 | byte | SDS je: BIG (hodnota 1) nebo STSW (hodnota 0)
97 | 8 | bytes | reserved (0x00)
105 | 2 | uword | web interface TCP port number (typicky 80)
107 | 1 | byte | SNMP-read enabled
108 | 1 | byte | SNMP-write enabled
109 | 1 | byte | FULLC shared vars access lock (0 = unlocked) tzn. sys[150]
110 | 1 | byte | FULLC program run status
111 | 1 | byte | FULLC program started-by info
112 | 1 | byte | FULLC program watchdog active
113 | 6 | bytes | reserved
119 | 4 | f32 | backup battery voltage (milliVolts)

Pozn. rozšířená funkcionalita příkazu NOP (tedy vracení payloadu) bylo přidáno až ve Firmware od verze 3.10.2019.

== (2-PŘ) Master Command: [1] '''General Device Status''' ==

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.

Základní odpověď s nejzajímavějšími živými údaji. Určeno např. pro průběžnou aktualizaci stavu zobrazeného uživateli.

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 1 | byte | Ethernet Link Status / Speed (0, 10, 100)
7 | 1 | byte | Amount of users logged into SDS Web Admin
8 | 32 | bytes | sysLocation (missing the 0x00 terminator)
40 | 1 | byte | IP Watchdog Config status
41 | 1 | byte | IP Watchdog Output (relay) status
42 | 2 | uword | IP Watchdog RTT value (note.: 0xFFFF = not available)
44 | 1 | byte | DHCP status
45 | 1 | byte | reserved
46 | 1 | byte | NTP status
47 | 1 | sbyte | NTP offset (+/- hours) (signed char)
48 | 2 | uword | SoC chip temperature (degC)
50 | 1 | byte | GPIO-TOPB PIN(s) direction (0 == input)
51 | 1 | byte | GPIO-TOPB PIN(s) pin value
52 | 32*1 | byte | OPTO [1]..[32] status (0xFF == signal) (0x00 == nosignal)
84 | 32*1 | byte | RELAY [1]..[32] status (active/nonactive)
116 | 32*2 | uword | ADC [0]..[31] RAW value
180 | 1 | byte | General 1-W BUS status
181 | 1 | byte | 1-W BUS A - active device count
182 | 1 | byte | 1-W BUS B - active device count
183 | 3 | bytes | reserved (0x00)
186 | 1 | byte | S0 Tariff Value (active/nonactive)
187 | 1 | byte | number of the following S0 INPUT DB data blocks:
188 | 31*28 | data | S0 INPUT [1]..[ (max) 31] DB (data block)

S0-INPUT DB offset | LEN | TYPE | content
-------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
1 | 3 | bytes | reserved (filled with 0x00)
4 | 4 | dword | T0 impulse counter
8 | 4 | dword | T1 impulse counter
12 | 4 | dword | T0 offset
16 | 4 | dword | T1 offset
20 | 4 | dword | measured space between impulses (msec)
24 | 4 | dword | time since last registered impulse (msec)

Sestava [C-PAYLOAD] je tedy zřejmá.

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í).

== (2-PŘ) Master Command: [2] '''1-Wire Access''' ==

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ů.

QUERY/COMMAND TO SDS (master_command == 2)

sub_command | meaning
------------+-----------------------------------------------------------
0 | reserved
1 | obtain status, and list of found items on BUS A
2 | obtain status, and list of found items on BUS B
4 | list all read-values on BUS A
8 | list all read-values on BUS B

První možností tedy je sub_command == 1 , tzn. výpis nalezených zařízení na sběrnici A respektive B:

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 1 or 2

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item status #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item status #63

"1-W item status" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 2 | bytes | reserved (filled with 0x00)
4 | 8 | bytes | ROM-CODE [0]..[7]

Následuje: výpis získaných hodnot (např. změřené teploty z teplotních čidel) pro jednotlivé sběrnice :

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 4 or 8

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item value #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item value #63

"1-W item value" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 1 | byte | value of ROM-CODE offset [0] (1-W DEVICE TYPE: ID)
3 | 1 | byte | value of ROM-CODE offset [7] (1-W DEVICE TYPE: CRC)
4 | 4 | slong | 1-W read: primary value
8 | 4 | slong | 1-W read: secondary value

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).

== (2-PŘ) Master Command: [4] '''Read FC-Get List''' ==

Dotaz (query) který obsahuje seznam indexů jejichž hodnoty jsou tazatelem požadovány, se posílá do SDS, které následně odpoví (reply).

Dotaz i odpověď má dynamický obsah, který je specificky strukturován.

QUERY (master_command == 4, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] space prepared for answer from SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] space prepared for answer from SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] space prepared for answer from SDS

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 !

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).

REPLY (master_command == 4, sent from SDS as reply to query)

SDS writes the values into the "[#n] space prepared for answer from SDS"

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.

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.

Následující popis ukazuje kódování typu proměnné a její délky, ve společném slově:

TBLEN#x: (16-bit unsigned word, little-endian) Type-Bits and Data Length (L#x)

TBLEN#x: TTTTvvvvvvvvvvvv
FEDCBA9876543210

BIT OFFSET (hex) | LEN (bits) | content
-----------------+------------+-----------------------------------------
F (MSB) | 4 | "T": type (see bit-value in next table)
B | 12 | "v": length of data, in bytes

"T" bit-values | meaning | FULL-C set/get
FEDC | | (which function)
----------------+-----------------------------+------------------
0000 | unsigned integer (32-bit) | _u
0001 | signed integer (32-bit) | _i
0010 | float IEEE-754 (32-bit) | _f
0100 | string UTF-8 (L#x * 8-bit) | _a
1000 | reserved (do not use) |

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ů.

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.

'''Index Value''' - každá položka má svůj číselný index, viz [[FULL-C:_set_and_get|seznam všech FULL-C indexů]].

== (2-PŘ) Master Command: [8] '''Write FC-Get List''' ==

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).

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".

COMMAND TO SDS (master_command == 8, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] new data value to write to SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] new data value to write to SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] new data value to write to SDS

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.

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:

REPLY FROM SDS (master_command == 8)

NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS
(previously no proper response was provided)

sub_command | meaning
------------+-----------------------------------------------------------
0 | complete failure (no item modified)
1 | partial failure (some items modified, some not modified)
2 | success (all items modified OK)

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).

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.

== (2-PŘ) Master Command: [16] '''FULL-C Shared Variable(s) Access''' ==

Tento příkaz se využívá k přístupu ke [[FULL-C:_sharing|sdíleným proměnným]] programu FULL-C.

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.

Mohou existovat tyto sdílené proměnné :
* S00 až S99 (hodnoty: signed 32-bit)
* U00 až U99 (hodnoty: unsigned 32-bit)
* F00 až F99 (hodnoty: float 32-bit)
* T00 až T99 (hodnoty: array/text)

Rozlišování jednotlivých funkcí je závislé na hodnotě "sub_command":

QUERY-or-COMMAND TO SDS (master_command == 16, sent to SDS)

sub_command | meaning
------------+---------------------------------------------
0 | provide list of all active shared variables
1 | read from shared variable (single variable)
2 | reserved
4 | write to shared variable (single variable)
8 | reserved

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.

RESPONSE: LIST OF SHARED VARIABLES: sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 13 | bytes | Uxx existence: bit-field
13 | 13 | bytes | Sxx existence: bit-field
26 | 13 | bytes | Fxx existence: bit-field
39 | 13 | bytes | Txx existence: bit-field

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.

Xxx existence: bit-field

BYTE -> [0] . . . [13]
BITS -> 0 . . . 100 (plus 4 at the end, which are not used)

BYTE [0] = bit 0, 1, 2, ..., 7
BYTE [1] = bit 8, 9, 10, ..., 15
...
BYTE [13] = bit 96, 97, 98 ..., 103

example: existence of "U11" => bit 11 => look at BYTE [1]

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.

'''Další,''' "sub_command == 1" umožňuje z konkrétní (jedné) sdílené proměnné číst.

QUERY TO SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "U25")
1 | 1 | byte | reserved (0x00)

A ''odpověď'' je:

REPLY FROM SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "F95")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] data value from the shared variable

'''Dále,''' pro "sub_command == 4" dojde ke změně hodnoty.

COMMAND TO SDS: WRITE ONE SHARED VARIABLE: sub_command = 4

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "T12")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] new data value to write to shared variable

A odpověď je zde shodná jako odpověd pro "sub_command == 1".

== (2-PŘ) Master Command: [32] '''S0 Input Configuration Query''' ==

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.

Pozn. master_command == 32 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 32, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 1 | byte | reserved (0x00)
4 | 32 | bytes | text (name: unit)
36 | 32 | bytes | text (name: money)
68 | 32 | bytes | text (unit: power)
100 | 32 | bytes | text (name: power)
132 | 32 | bytes | text (name: device)
168 | 4 | dword | MTD value
172 | 4 | dword | minimal impulse length (msec)
176 | 4 | dword | impulse constant value (imp. per unit)
180 | 4 | bytes | price for T0
184 | 4 | bytes | price for T1
188 | 8 | bytes | reserved (0x00)
196 | 4 | dword | live value: T0 impulse counter
200 | 4 | dword | live value: T1 impulse counter
204 | 4 | dword | T0 offset
208 | 4 | dword | T1 offset
212 | 4 | dword | live value: measured space between impulses (msec)
216 | 4 | dword | live value: time since last registered impulse (msec)
220 | 4 | bytes | reserved (0x00)
224 | n | bytes | live value: combined text

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).

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).

'''(sub_command = 0xFF)''': speciální odpověď pro Tarifní vstup :

REPLY (master_command == 32, sent from SDS as reply)
sub_command == 0xFF (tariff)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | constant 0xFF
1 | 3 | bytes | reserved (0x00)
4 | 1 | byte | tariff input
5 | 32 | bytes | text (name: tariff)
37 | 32 | bytes | text (name: tariff T0 input)
69 | 32 | bytes | text (name: tariff T1 input)

== (2-PŘ) Master Command: [33] '''S0 Input History Values''' ==

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.

Pozn. master_command == 33 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 33, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 3 | bytes | reserved (0x00)
6 | 2 | word | history depth (number of items) - value "n" (example: five items -> n == 5)
8 | 4 | dword | uptime value for the last element (#n) in the list
12 | 4 | dword | ntptime value for the last element (#n) in the list
16 | 4 | dword | history item #1: value of T0 counter (this is the most oldest item)
20 | 4 | dword | history item #1: value of T1 counter (this is the most oldest item)
...
16+(n-1)*8 | 4 | dword | history item #n: value of T0 counter (this is the most newest item)
16+(n-1)*8+4 | 4 | dword | history item #n: value of T1 counter (this is the most newest item)

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).

== (2-PŘ) Master Command: [40] '''AD Input Configuration Query''' ==

Určeno pro čtení kalibračních konstant pro AD vstupy.

Pozn. master_command == 40 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 40, sent from SDS as reply)
sub_command == index to AD array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual AD input index for this reply
1 | 1 | byte | total number of AD inputs
2 | 2 | bytes | reserved (0x00)
4 | 4 | f32 | F6 calibration constant
8 | 4 | f32 | F5 calibration constant
12 | 4 | f32 | F4 calibration constant
16 | 4 | f32 | F3 calibration constant
20 | 4 | f32 | F2 calibration constant
24 | 4 | f32 | F1 calibration constant
28 | 4 | f32 | F0 calibration constant
32 | 1 | byte | is calibration factory locked
33 | 32 | bytes | unit
65 | 4 | bytes | reserved (0x00)
69 | 32 | bytes | name
101 | 4 | bytes | reserved (0x00)
105 | 4 | dword | raw value
109 | 4 | f32 | real value (converted from raw)
113 | n | bytes | live value text

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).

== (2-PŘ) Master Command: [42] '''PWM Output Configuration Query''' ==

Určeno pro čtení nastavení pro PWM výstup (konfigurace a živý stav).

Pozn. master_command == 42 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 42, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | reserved (0x00)
1 | 1 | byte | "N" = total number of PWM outputs
2 | 2 | bytes | reserved (0x00)

4+(i*12)+ 0 | 4 | dword | frequency (Hz) for PWMx
4+(i*12)+ 4 | 4 | dword | "pulse" value for PWMx
4+(i*12)+ 8 | 1 | byte | "ValueB" value for PWMx
4+(i*12)+ 9 | 2 | uword | "ValueS" value for PWMx
4+(i*12)+ 11 | 1 | byte | output enabled for PWMx

Pozn. PWM1 má hodnotu "i" = 0, PWM2 má hodnotu "i" = 1 atd.

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ů.

== (2-PŘ) Master Command: [44] '''RELAYs Configuration Query''' ==

Určeno pro čtení konfigurace RELAY výstupů (nastavení a živý stav).

Pozn. master_command == 44 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 44, sent from SDS as reply)
sub_command == index to RELAY array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual RELAY output index for this reply
1 | 1 | byte | total number of RELAY outputs
2 | 2 | bytes | reserved (0x00)
4 | 32 | bytes | name
36 | 4 | bytes | reserved (0x00)
40 | 1 | byte | "relay-controlled-by" value
41 | 1 | byte | "relay-output" value

== (2-PŘ) Master Command: [48] '''SD Card Status Query''' ==

Určeno pro čtení stavu SD karty.

Pozn. master_command == 48 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 48, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | card mounted
1 | 3 | bytes | reserved
4 | 4 | dword | card type
8 | 4 | dword | card ProdSN
12 | 4 | dword | card init attempts counter
16 | 4 | dword | card init failures counter
20 | 4 | dword | card total sector count in FAT in KiB
24 | 4 | dword | total sector reads counter
28 | 4 | dword | total sector writes counter
32 | 4 | dword | total sector r/w failures counter

== (2-PŘ) Master Command: [50] '''Serial Port Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [64] '''DataFlash (NVM) Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [128] '''Reserved''' ==

Tento příkaz není v současné verzi použit.

== (1-PŘ) Master Command (první produktová řada: "TV = 0001...." ) ==

Jednotlivé základní příkazy (''master command'') - zatím nejsou pro
první produktovou řadu definovány.

Detaily zde budou doplněny.

__NOTOC__

M2M: S-UDP protocol

2025-03-15T08:36:40Z

Adamn:

Tato stránka popisuje funkci zařízení SDS '''druhé produktové řady''' - protože SDS první produktové řady používají jiný protokol.

== Rychlá komunikace: S-UDP ==

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.

S-UDP používá následující výchozí UDP PORT: 310

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.

Přenos dat využívá specifického protokolu, který umožňuje bezpečně ovládat specifické zařízení SDS.

'''Typické použití:''' komunikace zařízení SDS s protistranou (např. aplikace na mobilním telefonu).

== Informace ==

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.

== Bezpečnost ==

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á.

Je to založeno na následujícím principu:

- 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)

- 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).

== S-UDP protokol ==

Každý příkaz a odpověď jsou v samostatném, jediném, UDP paketu.

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.

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ě):

[MASTER PACKET CONTENTS]

OFFSET | LEN | DATA
----------+--------+---------------------------------------------------------------
0 | 28 | HEADER
28 | PL*16 | ENCRYPTED PAYLOAD (contains: payload-header and payload-data)

'''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.

LITTLE-ENDIAN

Následující uvedené položky jsou ve formátu [http://en.wikipedia.org/wiki/Endianness#Little-endian Little-Endian] (procesory: ARM, x86):
* ''uword'' (unsigned 16-bit)
* ''dword'' (unsigned 32-bit)
* ''slong'' (signed 32-bit)
* ''qword'' (unsigned 64-bit)

Položky typu: ''byte'', ''sbyte'', ''bytes'' - jsou jednotlivé samostatné bajty, nesdružené do společného čísla.

Zde jsou uvedeny detailní položky:

[MASTER PACKET CONTENTS]

OFFSET | LEN | TYPE | DATA
---------+------+--------+-----------------------------

[HEADER]

0 | 3 | bytes | header "SDS"
3 | 1 | byte | TV = (SDS-product-line) including (S-UDP protocol master-version)
4 | 1 | byte | PL = number of 16B chunks - this is the payload_length of [ENCRYPTED PAYLOAD] (example: PL==10 => 160 bytes)
5 | 1 | byte | encryption-flag (NOW ACCEPTS ONLY: 0x10 == XTEA-64-CTR)
6 | 1 | byte | reserved
7 | 1 | byte | CK1: basic additive checksum for [ENCRYPTED PAYLOAD] (start from (including) byte offset [28] and forward)
8 | 4 | dword | user_identifier (correlation identifier) - use this to correlate query to response
12 | 16 | bytes | CounterBlock
----------+------+--------+----------------------------

[ENCRYPTED PAYLOAD] -> everything from this point is included:

28 | 1 | byte | random number (shall be always different than what was used ever before)
29 | 1 | byte | CK2: basic additive checksum for [HEADER] (all bytes [0] to [27] included, BUT: skipping byte [7])
30 | 2 | uword | XR_MTU value (maximal size of the custom-payload data including R) ( XL + R <= XR_MTU )
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)
36 | 4 | dword | uptime (msecs from boot)
40 | 4 | dword | time (epoch) (or, if no NTP is available to SDS, this will be a value of "seconds from boot")
44 | 4 | dword | SDS device type (0xXXXXXXXX) - THIS MUST MATCH
48 | 1 | byte | master_command
49 | 1 | byte | sub_command
50 | 2 | uword | XL value (exact length of the actually useful payload-data): XL = (PL*16) - R - 24

52 | XL | bytes | custom payload-data [C-PAYLOAD]

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.)

----------+------+--------+----------------------------

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.

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).

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é.

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ů.

"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. .

Hodnota "crc32" se počítá pro dešifrované data, algoritmus je identický jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]].

Pro zvolené XTEA-64-CTR má "CounterBlock" následující sestavu svého obsahu:

CounterBlock:

OFFSET | LEN | TYPE | DATA
----------+------+--------+-----------------------------------------------------------------------------------------
0 | 8 | qword | XTEA-64-CTR: 64-bit counter (counter is increased by 1, for each 16B of processed data)
8 | 8 | bytes | (reserved) not-used area = reserved (fill with 0x00)

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ů).

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.

TV: ttttVVVV
76543210

BIT OFFSET | LEN (bits) | content
-----------+------------+--------------------------------------------------
7 (MSB) | 4 | "t": produc-line value: 1 == first, 2 == second
3 | 4 | "V": version: 0 = first S-UDP protocol version

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.

== Postup při příjmu S-UDP paketu ==

Každá strana, která přijme S-UDP paket, provede následující kroky:

1) Ověřit platnost hodnot v [HEADER]
a. text "SDS" (platný obsah)
b. hodnota "TV" ("master-version" a "product-line") (platný obsah)
c. hodnota "PL" v platných mezích
d. hodnota "encryption_flag" (platný obsah)
2) Ověřit základní additive-checksum pro [ENCRYPTED PAYLOAD]
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK1" hodnotě
3) Nastavit dešifrování
a. zvolit algoritmus podle "encryption-flag" hodnoty
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (přečíst z [HEADER])
4) Dešifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
5) Ověřit základní additive-checksum pro [HEADER] - teď totiž už máme hodnotu "CK2"
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ě
6) Ověřit další hodnoty
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
b. uschovat hodnotu "XR_MTU" pro vytváření odpovědi ("XR_MTU" omezuje velikost odpovědi, kterou můžeme zpátky odeslat)
c. ověřit časové údaje ("time" a "uptime")
d. ověřit "XL" vůči "PL"
7) Ověřit CRC-32 dešifrovaného payloadu
a. spočítat CRC-32 správným algoritmem, vučí bajtům (plain-text) z [36] až [52+XL-1] včetně

8) Hotovo: teď se provede aktuální příkaz (Master Command, dle tabulky podle produktové řady viz "TV")
a odešle odpověď (ponechat user_identifier pro korelaci) (pozor na "XR_MTU" omezení)

== Postup při odesílání S-UDP paketu ==

Odesílatel zprávy provádí tyto kroky:

1) Je sestaven přesný obsah [C-PAYLOAD] a určena odpovídající hodnota XL
a. obsah samozřejmě odpovídá tomu co chcete odeslat
b. určí se i "master-command" a "sub-command" (pozor na produktovou řadu SDS - viz "TV")
2) Vyplní se [HEADER]
a. hlavička "SDS", "encryption-flag"
b. zapsat správnou hodnotu "TV" podle protokolu a konkrétního SDS ("master-version", "product-line")
c. určí se nová unikátní hodnota "user_identifier", a zapíše se do [HEADER]
d. zapíše se "CounterBlock" (hodnota pokračuje po předchozím paketu)
3) Nachystá se zaokrouhlovací oblast "R"
a. Pokud XL není beze zbytku dělitelná 16, musí se doplnit oblastí "R"
4) Spočítá se hodnota "PL"
a. PL = (XL + R)/16
b. zapsat do [HEADER]
5) Začne se vyplňovat [ENCRYPTED PAYLOAD]
a. zapsat náhodný byte do "random number"
b. spočítá se hodnota "CK2" (sečíst bajty [0] až [27] - ovšem přeskočit byte [7] - pozor!)
c. zapsat hodnotu "XR_MTU" podle možností zařízení (tzn. jak velkou odpověď lze bezpečně přijmout, podle omezení sítě)
d. zapíší se hodnoty "uptime" a "time", zapsat hodnotu "SDS-DEVICE-TYPE"
e. zapsat "master-command" a "sub-command"
6) Spočítá se CRC-32 (před šifrováním)
a. spočítat crc32 pro bajty (plain-text) z offsetu [36] až [52+XL-1] včetně
7) Nastavit šifrování
a. zvolit algoritmus (musí odpovídat tomu, co se zapsalo do "encryption-flag")
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (stejný jako byl zapsán [HEADER])
8) Šifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
b. aktualizovaná hodnota "CounterBlock" (zvýšená o průběh šifrování) se uschová pro další použití - viz bod " 2) c. "
9) Spočítat základní additive-checksum pro [ENCRYPTED PAYLOAD]
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

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.

== Vzorové obsahy paketů ==

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í).
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.

== Seznam hlavních příkazů ==

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.

Zařazení SDS do produktových řad je v [[Seznam_Všech_SDS|tomto seznamu]].

* První produktová řada: "TV = 0001...." -> '''(1PŘ)'''
* Druhá produktová řada: "TV = 0010...." -> '''(2PŘ)'''

== (2PŘ) Master Command (druhá produktová řada: "TV = 0010...." ) ==

Jednotlivé základní příkazy (''master command''):

MASTER COMMAND | command
----------------+-------------------------------------
0 | NOP (replies with NOP)
1 | general device status
2 | 1-Wire access
4 | read FC-Get list
8 | write FC-Set list
16 | FULL-C shared variable(s) access
32 | serial port access
64 | DataFlash access
128 | reserved

Jak lze vidět, jednotlivé ''master command'' příkazy jsou dále rozlišeny pomocí hodnoty ''sub command''.

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).

== (2-PŘ) Master Command: [0] '''NOP''' ==

SDS odpoví na tento příkaz odesláním [0] NOP.

Tohoto příkazu lze využít k ověření komunikace a k vzájemné základní synchronizace.

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.

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 !

REPLY (master_command == 0, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 4 | bytes | SDS Device Type
10 | 4 | dword | FW version
14 | 32 | bytes | sysLocation (missing the 0x00 terminator)
46 | 8 | bytes | reserved (0x00)
54 | 32 | bytes | OEM string (missing the 0x00 terminator)
86 | 8 | bytes | reserved (0x00)
94 | 1 | byte | bylo aktivováno RSTD
95 | 1 | byte | bylo aktivováno PVD
96 | 1 | byte | SDS je: BIG (hodnota 1) nebo STSW (hodnota 0)
97 | 8 | bytes | reserved (0x00)
105 | 2 | uword | web interface TCP port number (typicky 80)
107 | 1 | byte | SNMP-read enabled
108 | 1 | byte | SNMP-write enabled
109 | 1 | byte | FULLC shared vars access lock (0 = unlocked) tzn. sys[150]
110 | 1 | byte | FULLC program run status
111 | 1 | byte | FULLC program started-by info
112 | 1 | byte | FULLC program watchdog active
113 | 6 | bytes | reserved
119 | 4 | f32 | backup battery voltage (milliVolts)

Pozn. rozšířená funkcionalita příkazu NOP (tedy vracení payloadu) bylo přidáno až ve Firmware od verze 3.10.2019.

== (2-PŘ) Master Command: [1] '''General Device Status''' ==

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.

Základní odpověď s nejzajímavějšími živými údaji. Určeno např. pro průběžnou aktualizaci stavu zobrazeného uživateli.

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 1 | byte | Ethernet Link Status / Speed (0, 10, 100)
7 | 1 | byte | Amount of users logged into SDS Web Admin
8 | 32 | bytes | sysLocation (missing the 0x00 terminator)
40 | 1 | byte | IP Watchdog Config status
41 | 1 | byte | IP Watchdog Output (relay) status
42 | 2 | uword | IP Watchdog RTT value (note.: 0xFFFF = not available)
44 | 1 | byte | DHCP status
45 | 1 | byte | reserved
46 | 1 | byte | NTP status
47 | 1 | sbyte | NTP offset (+/- hours) (signed char)
48 | 2 | uword | SoC chip temperature (degC)
50 | 1 | byte | GPIO-TOPB PIN(s) direction (0 == input)
51 | 1 | byte | GPIO-TOPB PIN(s) pin value
52 | 32*1 | byte | OPTO [1]..[32] status (0xFF == signal) (0x00 == nosignal)
84 | 32*1 | byte | RELAY [1]..[32] status (active/nonactive)
116 | 32*2 | uword | ADC [0]..[31] RAW value
180 | 1 | byte | General 1-W BUS status
181 | 1 | byte | 1-W BUS A - active device count
182 | 1 | byte | 1-W BUS B - active device count
183 | 3 | bytes | reserved (0x00)
186 | 1 | byte | S0 Tariff Value (active/nonactive)
187 | 1 | byte | number of the following S0 INPUT DB data blocks:
188 | 31*28 | data | S0 INPUT [1]..[ (max) 31] DB (data block)

S0-INPUT DB offset | LEN | TYPE | content
-------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
1 | 3 | bytes | reserved (filled with 0x00)
4 | 4 | dword | T0 impulse counter
8 | 4 | dword | T1 impulse counter
12 | 4 | dword | T0 offset
16 | 4 | dword | T1 offset
20 | 4 | dword | measured space between impulses (msec)
24 | 4 | dword | time since last registered impulse (msec)

Sestava [C-PAYLOAD] je tedy zřejmá.

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í).

== (2-PŘ) Master Command: [2] '''1-Wire Access''' ==

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ů.

QUERY/COMMAND TO SDS (master_command == 2)

sub_command | meaning
------------+-----------------------------------------------------------
0 | reserved
1 | obtain status, and list of found items on BUS A
2 | obtain status, and list of found items on BUS B
4 | list all read-values on BUS A
8 | list all read-values on BUS B

První možností tedy je sub_command == 1 , tzn. výpis nalezených zařízení na sběrnici A respektive B:

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 1 or 2

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item status #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item status #63

"1-W item status" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 2 | bytes | reserved (filled with 0x00)
4 | 8 | bytes | ROM-CODE [0]..[7]

Následuje: výpis získaných hodnot (např. změřené teploty z teplotních čidel) pro jednotlivé sběrnice :

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 4 or 8

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item value #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item value #63

"1-W item value" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 1 | byte | value of ROM-CODE offset [0] (1-W DEVICE TYPE: ID)
3 | 1 | byte | value of ROM-CODE offset [7] (1-W DEVICE TYPE: CRC)
4 | 4 | slong | 1-W read: primary value
8 | 4 | slong | 1-W read: secondary value

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).

== (2-PŘ) Master Command: [4] '''Read FC-Get List''' ==

Dotaz (query) který obsahuje seznam indexů jejichž hodnoty jsou tazatelem požadovány, se posílá do SDS, které následně odpoví (reply).

Dotaz i odpověď má dynamický obsah, který je specificky strukturován.

QUERY (master_command == 4, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] space prepared for answer from SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] space prepared for answer from SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] space prepared for answer from SDS

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 !

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).

REPLY (master_command == 4, sent from SDS as reply to query)

SDS writes the values into the "[#n] space prepared for answer from SDS"

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.

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.

Následující popis ukazuje kódování typu proměnné a její délky, ve společném slově:

TBLEN#x: (16-bit unsigned word, little-endian) Type-Bits and Data Length (L#x)

TBLEN#x: TTTTvvvvvvvvvvvv
FEDCBA9876543210

BIT OFFSET (hex) | LEN (bits) | content
-----------------+------------+-----------------------------------------
F (MSB) | 4 | "T": type (see bit-value in next table)
B | 12 | "v": length of data, in bytes

"T" bit-values | meaning | FULL-C set/get
FEDC | | (which function)
----------------+-----------------------------+------------------
0000 | unsigned integer (32-bit) | _u
0001 | signed integer (32-bit) | _i
0010 | float IEEE-754 (32-bit) | _f
0100 | string UTF-8 (L#x * 8-bit) | _a
1000 | reserved (do not use) |

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ů.

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.

'''Index Value''' - každá položka má svůj číselný index, viz [[FULL-C:_set_and_get|seznam všech FULL-C indexů]].

== (2-PŘ) Master Command: [8] '''Write FC-Get List''' ==

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).

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".

COMMAND TO SDS (master_command == 8, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] new data value to write to SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] new data value to write to SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] new data value to write to SDS

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.

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:

REPLY FROM SDS (master_command == 8)

NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS
(previously no proper response was provided)

sub_command | meaning
------------+-----------------------------------------------------------
0 | complete failure (no item modified)
1 | partial failure (some items modified, some not modified)
2 | success (all items modified OK)

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).

== (2-PŘ) Master Command: [16] '''FULL-C Shared Variable(s) Access''' ==

Tento příkaz se využívá k přístupu ke [[FULL-C:_sharing|sdíleným proměnným]] programu FULL-C.

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.

Mohou existovat tyto sdílené proměnné :
* S00 až S99 (hodnoty: signed 32-bit)
* U00 až U99 (hodnoty: unsigned 32-bit)
* F00 až F99 (hodnoty: float 32-bit)
* T00 až T99 (hodnoty: array/text)

Rozlišování jednotlivých funkcí je závislé na hodnotě "sub_command":

QUERY-or-COMMAND TO SDS (master_command == 16, sent to SDS)

sub_command | meaning
------------+---------------------------------------------
0 | provide list of all active shared variables
1 | read from shared variable (single variable)
2 | reserved
4 | write to shared variable (single variable)
8 | reserved

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.

RESPONSE: LIST OF SHARED VARIABLES: sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 13 | bytes | Uxx existence: bit-field
13 | 13 | bytes | Sxx existence: bit-field
26 | 13 | bytes | Fxx existence: bit-field
39 | 13 | bytes | Txx existence: bit-field

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.

Xxx existence: bit-field

BYTE -> [0] . . . [13]
BITS -> 0 . . . 100 (plus 4 at the end, which are not used)

BYTE [0] = bit 0, 1, 2, ..., 7
BYTE [1] = bit 8, 9, 10, ..., 15
...
BYTE [13] = bit 96, 97, 98 ..., 103

example: existence of "U11" => bit 11 => look at BYTE [1]

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.

'''Další,''' "sub_command == 1" umožňuje z konkrétní (jedné) sdílené proměnné číst.

QUERY TO SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "U25")
1 | 1 | byte | reserved (0x00)

A ''odpověď'' je:

REPLY FROM SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "F95")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] data value from the shared variable

'''Dále,''' pro "sub_command == 4" dojde ke změně hodnoty.

COMMAND TO SDS: WRITE ONE SHARED VARIABLE: sub_command = 4

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "T12")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] new data value to write to shared variable

A odpověď je zde shodná jako odpověd pro "sub_command == 1".

== (2-PŘ) Master Command: [32] '''S0 Input Configuration Query''' ==

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.

Pozn. master_command == 32 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 32, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 1 | byte | reserved (0x00)
4 | 32 | bytes | text (name: unit)
36 | 32 | bytes | text (name: money)
68 | 32 | bytes | text (unit: power)
100 | 32 | bytes | text (name: power)
132 | 32 | bytes | text (name: device)
168 | 4 | dword | MTD value
172 | 4 | dword | minimal impulse length (msec)
176 | 4 | dword | impulse constant value (imp. per unit)
180 | 4 | bytes | price for T0
184 | 4 | bytes | price for T1
188 | 8 | bytes | reserved (0x00)
196 | 4 | dword | live value: T0 impulse counter
200 | 4 | dword | live value: T1 impulse counter
204 | 4 | dword | T0 offset
208 | 4 | dword | T1 offset
212 | 4 | dword | live value: measured space between impulses (msec)
216 | 4 | dword | live value: time since last registered impulse (msec)
220 | 4 | bytes | reserved (0x00)
224 | n | bytes | live value: combined text

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).

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).

'''(sub_command = 0xFF)''': speciální odpověď pro Tarifní vstup :

REPLY (master_command == 32, sent from SDS as reply)
sub_command == 0xFF (tariff)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | constant 0xFF
1 | 3 | bytes | reserved (0x00)
4 | 1 | byte | tariff input
5 | 32 | bytes | text (name: tariff)
37 | 32 | bytes | text (name: tariff T0 input)
69 | 32 | bytes | text (name: tariff T1 input)

== (2-PŘ) Master Command: [33] '''S0 Input History Values''' ==

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.

Pozn. master_command == 33 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 33, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 3 | bytes | reserved (0x00)
6 | 2 | word | history depth (number of items) - value "n" (example: five items -> n == 5)
8 | 4 | dword | uptime value for the last element (#n) in the list
12 | 4 | dword | ntptime value for the last element (#n) in the list
16 | 4 | dword | history item #1: value of T0 counter (this is the most oldest item)
20 | 4 | dword | history item #1: value of T1 counter (this is the most oldest item)
...
16+(n-1)*8 | 4 | dword | history item #n: value of T0 counter (this is the most newest item)
16+(n-1)*8+4 | 4 | dword | history item #n: value of T1 counter (this is the most newest item)

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).

== (2-PŘ) Master Command: [40] '''AD Input Configuration Query''' ==

Určeno pro čtení kalibračních konstant pro AD vstupy.

Pozn. master_command == 40 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 40, sent from SDS as reply)
sub_command == index to AD array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual AD input index for this reply
1 | 1 | byte | total number of AD inputs
2 | 2 | bytes | reserved (0x00)
4 | 4 | f32 | F6 calibration constant
8 | 4 | f32 | F5 calibration constant
12 | 4 | f32 | F4 calibration constant
16 | 4 | f32 | F3 calibration constant
20 | 4 | f32 | F2 calibration constant
24 | 4 | f32 | F1 calibration constant
28 | 4 | f32 | F0 calibration constant
32 | 1 | byte | is calibration factory locked
33 | 32 | bytes | unit
65 | 4 | bytes | reserved (0x00)
69 | 32 | bytes | name
101 | 4 | bytes | reserved (0x00)
105 | 4 | dword | raw value
109 | 4 | f32 | real value (converted from raw)
113 | n | bytes | live value text

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).

== (2-PŘ) Master Command: [42] '''PWM Output Configuration Query''' ==

Určeno pro čtení nastavení pro PWM výstup (konfigurace a živý stav).

Pozn. master_command == 42 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 42, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | reserved (0x00)
1 | 1 | byte | "N" = total number of PWM outputs
2 | 2 | bytes | reserved (0x00)

4+(i*12)+ 0 | 4 | dword | frequency (Hz) for PWMx
4+(i*12)+ 4 | 4 | dword | "pulse" value for PWMx
4+(i*12)+ 8 | 1 | byte | "ValueB" value for PWMx
4+(i*12)+ 9 | 2 | uword | "ValueS" value for PWMx
4+(i*12)+ 11 | 1 | byte | output enabled for PWMx

Pozn. PWM1 má hodnotu "i" = 0, PWM2 má hodnotu "i" = 1 atd.

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ů.

== (2-PŘ) Master Command: [44] '''RELAYs Configuration Query''' ==

Určeno pro čtení konfigurace RELAY výstupů (nastavení a živý stav).

Pozn. master_command == 44 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 44, sent from SDS as reply)
sub_command == index to RELAY array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual RELAY output index for this reply
1 | 1 | byte | total number of RELAY outputs
2 | 2 | bytes | reserved (0x00)
4 | 32 | bytes | name
36 | 4 | bytes | reserved (0x00)
40 | 1 | byte | "relay-controlled-by" value
41 | 1 | byte | "relay-output" value

== (2-PŘ) Master Command: [48] '''SD Card Status Query''' ==

Určeno pro čtení stavu SD karty.

Pozn. master_command == 48 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 48, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | card mounted
1 | 3 | bytes | reserved
4 | 4 | dword | card type
8 | 4 | dword | card ProdSN
12 | 4 | dword | card init attempts counter
16 | 4 | dword | card init failures counter
20 | 4 | dword | card total sector count in FAT in KiB
24 | 4 | dword | total sector reads counter
28 | 4 | dword | total sector writes counter
32 | 4 | dword | total sector r/w failures counter

== (2-PŘ) Master Command: [50] '''Serial Port Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [64] '''DataFlash (NVM) Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [128] '''Reserved''' ==

Tento příkaz není v současné verzi použit.

== (1-PŘ) Master Command (první produktová řada: "TV = 0001...." ) ==

Jednotlivé základní příkazy (''master command'') - zatím nejsou pro
první produktovou řadu definovány.

Detaily zde budou doplněny.

__NOTOC__

M2M: S-UDP protocol

2025-03-15T08:19:45Z

Adamn:

Tato stránka popisuje funkci zařízení SDS '''druhé produktové řady''' - protože SDS první produktové řady používají jiný protokol.

== Rychlá komunikace: S-UDP ==

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.

S-UDP používá následující výchozí UDP PORT: 310

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.

Přenos dat využívá specifického protokolu, který umožňuje bezpečně ovládat specifické zařízení SDS.

'''Typické použití:''' komunikace zařízení SDS s protistranou (např. aplikace na mobilním telefonu).

== Informace ==

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.

== Bezpečnost ==

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á.

Je to založeno na následujícím principu:

- 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)

- 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).

== S-UDP protokol ==

Každý příkaz a odpověď jsou v samostatném, jediném, UDP paketu.

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.

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ě):

[MASTER PACKET CONTENTS]

OFFSET | LEN | DATA
----------+--------+---------------------------------------------------------------
0 | 28 | HEADER
28 | PL*16 | ENCRYPTED PAYLOAD (contains: payload-header and payload-data)

'''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.

LITTLE-ENDIAN

Následující uvedené položky jsou ve formátu [http://en.wikipedia.org/wiki/Endianness#Little-endian Little-Endian] (procesory: ARM, x86):
* ''uword'' (unsigned 16-bit)
* ''dword'' (unsigned 32-bit)
* ''slong'' (signed 32-bit)
* ''qword'' (unsigned 64-bit)

Položky typu: ''byte'', ''sbyte'', ''bytes'' - jsou jednotlivé samostatné bajty, nesdružené do společného čísla.

Zde jsou uvedeny detailní položky:

[MASTER PACKET CONTENTS]

OFFSET | LEN | TYPE | DATA
---------+------+--------+-----------------------------

[HEADER]

0 | 3 | bytes | header "SDS"
3 | 1 | byte | TV = (SDS-product-line) including (S-UDP protocol master-version)
4 | 1 | byte | PL = number of 16B chunks - this is the payload_length of [ENCRYPTED PAYLOAD] (example: PL==10 => 160 bytes)
5 | 1 | byte | encryption-flag (NOW ACCEPTS ONLY: 0x10 == XTEA-64-CTR)
6 | 1 | byte | reserved
7 | 1 | byte | CK1: basic additive checksum for [ENCRYPTED PAYLOAD] (start from (including) byte offset [28] and forward)
8 | 4 | dword | user_identifier (correlation identifier) - use this to correlate query to response
12 | 16 | bytes | CounterBlock
----------+------+--------+----------------------------

[ENCRYPTED PAYLOAD] -> everything from this point is included:

28 | 1 | byte | random number (shall be always different than what was used ever before)
29 | 1 | byte | CK2: basic additive checksum for [HEADER] (all bytes [0] to [27] included, BUT: skipping byte [7])
30 | 2 | uword | XR_MTU value (maximal size of the custom-payload data including R) ( XL + R <= XR_MTU )
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)
36 | 4 | dword | uptime (msecs from boot)
40 | 4 | dword | time (epoch) (or, if no NTP is available to SDS, this will be a value of "seconds from boot")
44 | 4 | dword | SDS device type (0xXXXXXXXX) - THIS MUST MATCH
48 | 1 | byte | master_command
49 | 1 | byte | sub_command
50 | 2 | uword | XL value (exact length of the actually useful payload-data): XL = (PL*16) - R - 24

52 | XL | bytes | custom payload-data [C-PAYLOAD]

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.)

----------+------+--------+----------------------------

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.

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).

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é.

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ů.

"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. .

Hodnota "crc32" se počítá pro dešifrované data, algoritmus je identický jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]].

Pro zvolené XTEA-64-CTR má "CounterBlock" následující sestavu svého obsahu:

CounterBlock:

OFFSET | LEN | TYPE | DATA
----------+------+--------+-----------------------------------------------------------------------------------------
0 | 8 | qword | XTEA-64-CTR: 64-bit counter (counter is increased by 1, for each 16B of processed data)
8 | 8 | bytes | (reserved) not-used area = reserved (fill with 0x00)

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ů).

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.

TV: ttttVVVV
76543210

BIT OFFSET | LEN (bits) | content
-----------+------------+--------------------------------------------------
7 (MSB) | 4 | "t": produc-line value: 1 == first, 2 == second
3 | 4 | "V": version: 0 = first S-UDP protocol version

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.

== Postup při příjmu S-UDP paketu ==

Každá strana, která přijme S-UDP paket, provede následující kroky:

1) Ověřit platnost hodnot v [HEADER]
a. text "SDS" (platný obsah)
b. hodnota "TV" ("master-version" a "product-line") (platný obsah)
c. hodnota "PL" v platných mezích
d. hodnota "encryption_flag" (platný obsah)
2) Ověřit základní additive-checksum pro [ENCRYPTED PAYLOAD]
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK1" hodnotě
3) Nastavit dešifrování
a. zvolit algoritmus podle "encryption-flag" hodnoty
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (přečíst z [HEADER])
4) Dešifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
5) Ověřit základní additive-checksum pro [HEADER] - teď totiž už máme hodnotu "CK2"
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ě
6) Ověřit další hodnoty
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
b. uschovat hodnotu "XR_MTU" pro vytváření odpovědi ("XR_MTU" omezuje velikost odpovědi, kterou můžeme zpátky odeslat)
c. ověřit časové údaje ("time" a "uptime")
d. ověřit "XL" vůči "PL"
7) Ověřit CRC-32 dešifrovaného payloadu
a. spočítat CRC-32 správným algoritmem, vučí bajtům (plain-text) z [36] až [52+XL-1] včetně

8) Hotovo: teď se provede aktuální příkaz (Master Command, dle tabulky podle produktové řady viz "TV")
a odešle odpověď (ponechat user_identifier pro korelaci) (pozor na "XR_MTU" omezení)

== Postup při odesílání S-UDP paketu ==

Odesílatel zprávy provádí tyto kroky:

1) Je sestaven přesný obsah [C-PAYLOAD] a určena odpovídající hodnota XL
a. obsah samozřejmě odpovídá tomu co chcete odeslat
b. určí se i "master-command" a "sub-command" (pozor na produktovou řadu SDS - viz "TV")
2) Vyplní se [HEADER]
a. hlavička "SDS", "encryption-flag"
b. zapsat správnou hodnotu "TV" podle protokolu a konkrétního SDS ("master-version", "product-line")
c. určí se nová unikátní hodnota "user_identifier", a zapíše se do [HEADER]
d. zapíše se "CounterBlock" (hodnota pokračuje po předchozím paketu)
3) Nachystá se zaokrouhlovací oblast "R"
a. Pokud XL není beze zbytku dělitelná 16, musí se doplnit oblastí "R"
4) Spočítá se hodnota "PL"
a. PL = (XL + R)/16
b. zapsat do [HEADER]
5) Začne se vyplňovat [ENCRYPTED PAYLOAD]
a. zapsat náhodný byte do "random number"
b. spočítá se hodnota "CK2" (sečíst bajty [0] až [27] - ovšem přeskočit byte [7] - pozor!)
c. zapsat hodnotu "XR_MTU" podle možností zařízení (tzn. jak velkou odpověď lze bezpečně přijmout, podle omezení sítě)
d. zapíší se hodnoty "uptime" a "time", zapsat hodnotu "SDS-DEVICE-TYPE"
e. zapsat "master-command" a "sub-command"
6) Spočítá se CRC-32 (před šifrováním)
a. spočítat crc32 pro bajty (plain-text) z offsetu [36] až [52+XL-1] včetně
7) Nastavit šifrování
a. zvolit algoritmus (musí odpovídat tomu, co se zapsalo do "encryption-flag")
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (stejný jako byl zapsán [HEADER])
8) Šifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
b. aktualizovaná hodnota "CounterBlock" (zvýšená o průběh šifrování) se uschová pro další použití - viz bod " 2) c. "
9) Spočítat základní additive-checksum pro [ENCRYPTED PAYLOAD]
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

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.

== Vzorové obsahy paketů ==

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í).
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.

== Seznam hlavních příkazů ==

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.

Zařazení SDS do produktových řad je v [[Seznam_Všech_SDS|tomto seznamu]].

* První produktová řada: "TV = 0001...." -> '''(1PŘ)'''
* Druhá produktová řada: "TV = 0010...." -> '''(2PŘ)'''

== (2PŘ) Master Command (druhá produktová řada: "TV = 0010...." ) ==

Jednotlivé základní příkazy (''master command''):

MASTER COMMAND | command
----------------+-------------------------------------
0 | NOP (replies with NOP)
1 | general device status
2 | 1-Wire access
4 | read FC-Get list
8 | write FC-Set list
16 | FULL-C shared variable(s) access
32 | serial port access
64 | DataFlash access
128 | reserved

Jak lze vidět, jednotlivé ''master command'' příkazy jsou dále rozlišeny pomocí hodnoty ''sub command''.

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).

== (2-PŘ) Master Command: [0] '''NOP''' ==

SDS odpoví na tento příkaz odesláním [0] NOP.

Tohoto příkazu lze využít k ověření komunikace a k vzájemné základní synchronizace.

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.

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 !

REPLY (master_command == 0, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 4 | bytes | SDS Device Type
10 | 4 | dword | FW version
14 | 32 | bytes | sysLocation (missing the 0x00 terminator)
46 | 8 | bytes | reserved (0x00)
54 | 32 | bytes | OEM string (missing the 0x00 terminator)
86 | 8 | bytes | reserved (0x00)
94 | 1 | byte | bylo aktivováno RSTD
95 | 1 | byte | bylo aktivováno PVD
96 | 1 | byte | SDS je: BIG (hodnota 1) nebo STSW (hodnota 0)
97 | 8 | bytes | reserved (0x00)
105 | 2 | uword | web interface TCP port number (typicky 80)
107 | 1 | byte | SNMP-read enabled
108 | 1 | byte | SNMP-write enabled
109 | 1 | byte | FULLC shared vars access lock (0 = unlocked) tzn. sys[150]
110 | 1 | byte | FULLC program run status
111 | 1 | byte | FULLC program started-by info
112 | 1 | byte | FULLC program watchdog active
113 | 6 | bytes | reserved
119 | 4 | f32 | backup battery voltage (milliVolts)

Pozn. rozšířená funkcionalita příkazu NOP (tedy vracení payloadu) bylo přidáno až ve Firmware od verze 3.10.2019.

== (2-PŘ) Master Command: [1] '''General Device Status''' ==

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.

Základní odpověď s nejzajímavějšími živými údaji. Určeno např. pro průběžnou aktualizaci stavu zobrazeného uživateli.

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 1 | byte | Ethernet Link Status / Speed (0, 10, 100)
7 | 1 | byte | Amount of users logged into SDS Web Admin
8 | 32 | bytes | sysLocation (missing the 0x00 terminator)
40 | 1 | byte | IP Watchdog Config status
41 | 1 | byte | IP Watchdog Output (relay) status
42 | 2 | uword | IP Watchdog RTT value (note.: 0xFFFF = not available)
44 | 1 | byte | DHCP status
45 | 1 | byte | reserved
46 | 1 | byte | NTP status
47 | 1 | sbyte | NTP offset (+/- hours) (signed char)
48 | 2 | uword | SoC chip temperature (degC)
50 | 1 | byte | GPIO-TOPB PIN(s) direction (0 == input)
51 | 1 | byte | GPIO-TOPB PIN(s) pin value
52 | 32*1 | byte | OPTO [1]..[32] status (0xFF == signal) (0x00 == nosignal)
84 | 32*1 | byte | RELAY [1]..[32] status (active/nonactive)
116 | 32*2 | uword | ADC [0]..[31] RAW value
180 | 1 | byte | General 1-W BUS status
181 | 1 | byte | 1-W BUS A - active device count
182 | 1 | byte | 1-W BUS B - active device count
183 | 3 | bytes | reserved (0x00)
186 | 1 | byte | S0 Tariff Value (active/nonactive)
187 | 1 | byte | number of the following S0 INPUT DB data blocks:
188 | 31*28 | data | S0 INPUT [1]..[ (max) 31] DB (data block)

S0-INPUT DB offset | LEN | TYPE | content
-------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
1 | 3 | bytes | reserved (filled with 0x00)
4 | 4 | dword | T0 impulse counter
8 | 4 | dword | T1 impulse counter
12 | 4 | dword | T0 offset
16 | 4 | dword | T1 offset
20 | 4 | dword | measured space between impulses (msec)
24 | 4 | dword | time since last registered impulse (msec)

Sestava [C-PAYLOAD] je tedy zřejmá.

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í).

== (2-PŘ) Master Command: [2] '''1-Wire Access''' ==

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ů.

QUERY/COMMAND TO SDS (master_command == 2)

sub_command | meaning
------------+-----------------------------------------------------------
0 | reserved
1 | obtain status, and list of found items on BUS A
2 | obtain status, and list of found items on BUS B
4 | list all read-values on BUS A
8 | list all read-values on BUS B

První možností tedy je sub_command == 1 , tzn. výpis nalezených zařízení na sběrnici A respektive B:

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 1 or 2

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item status #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item status #63

"1-W item status" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 2 | bytes | reserved (filled with 0x00)
4 | 8 | bytes | ROM-CODE [0]..[7]

Následuje: výpis získaných hodnot (např. změřené teploty z teplotních čidel) pro jednotlivé sběrnice :

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 4 or 8

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item value #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item value #63

"1-W item value" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 1 | byte | value of ROM-CODE offset [0] (1-W DEVICE TYPE: ID)
3 | 1 | byte | value of ROM-CODE offset [7] (1-W DEVICE TYPE: CRC)
4 | 4 | slong | 1-W read: primary value
8 | 4 | slong | 1-W read: secondary value

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).

== (2-PŘ) Master Command: [4] '''Read FC-Get List''' ==

Dotaz (query) který obsahuje seznam indexů jejichž hodnoty jsou tazatelem požadovány, se posílá do SDS, které následně odpoví (reply).

Dotaz i odpověď má dynamický obsah, který je specificky strukturován.

QUERY (master_command == 4, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] space prepared for answer from SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] space prepared for answer from SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] space prepared for answer from SDS

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 !

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).

REPLY (master_command == 4, sent from SDS as reply to query)

SDS writes the values into the "[#n] space prepared for answer from SDS"

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.

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.

Následující popis ukazuje kódování typu proměnné a její délky, ve společném slově:

TBLEN#x: (16-bit unsigned word, little-endian) Type-Bits and Data Length (L#x)

TBLEN#x: TTTTvvvvvvvvvvvv
FEDCBA9876543210

BIT OFFSET (hex) | LEN (bits) | content
-----------------+------------+-----------------------------------------
F (MSB) | 4 | "T": type (see bit-value in next table)
B | 12 | "v": length of data, in bytes

"T" bit-values | meaning | FULL-C set/get
FEDC | | (which function)
----------------+-----------------------------+------------------
0000 | unsigned integer (32-bit) | _u
0001 | signed integer (32-bit) | _i
0010 | float IEEE-754 (32-bit) | _f
0100 | string UTF-8 (L#x * 8-bit) | _a
1000 | reserved (do not use) |

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ů.

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.

'''Index Value''' - každá položka má svůj číselný index, viz [[FULL-C:_set_and_get|seznam všech FULL-C indexů]].

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:

REPLY FROM SDS (master_command == 8)

NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS
(previously no proper response was provided)

sub_command | meaning
------------+-----------------------------------------------------------
0 | complete failure (no item read)
1 | partial failure (some items read, some not read)
2 | success (all items read OK)

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).

== (2-PŘ) Master Command: [8] '''Write FC-Get List''' ==

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).

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".

COMMAND TO SDS (master_command == 8, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] new data value to write to SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] new data value to write to SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] new data value to write to SDS

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.

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:

REPLY FROM SDS (master_command == 8)

NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS
(previously no proper response was provided)

sub_command | meaning
------------+-----------------------------------------------------------
0 | complete failure (no item modified)
1 | partial failure (some items modified, some not modified)
2 | success (all items modified OK)

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).

== (2-PŘ) Master Command: [16] '''FULL-C Shared Variable(s) Access''' ==

Tento příkaz se využívá k přístupu ke [[FULL-C:_sharing|sdíleným proměnným]] programu FULL-C.

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.

Mohou existovat tyto sdílené proměnné :
* S00 až S99 (hodnoty: signed 32-bit)
* U00 až U99 (hodnoty: unsigned 32-bit)
* F00 až F99 (hodnoty: float 32-bit)
* T00 až T99 (hodnoty: array/text)

Rozlišování jednotlivých funkcí je závislé na hodnotě "sub_command":

QUERY-or-COMMAND TO SDS (master_command == 16, sent to SDS)

sub_command | meaning
------------+---------------------------------------------
0 | provide list of all active shared variables
1 | read from shared variable (single variable)
2 | reserved
4 | write to shared variable (single variable)
8 | reserved

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.

RESPONSE: LIST OF SHARED VARIABLES: sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 13 | bytes | Uxx existence: bit-field
13 | 13 | bytes | Sxx existence: bit-field
26 | 13 | bytes | Fxx existence: bit-field
39 | 13 | bytes | Txx existence: bit-field

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.

Xxx existence: bit-field

BYTE -> [0] . . . [13]
BITS -> 0 . . . 100 (plus 4 at the end, which are not used)

BYTE [0] = bit 0, 1, 2, ..., 7
BYTE [1] = bit 8, 9, 10, ..., 15
...
BYTE [13] = bit 96, 97, 98 ..., 103

example: existence of "U11" => bit 11 => look at BYTE [1]

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.

'''Další,''' "sub_command == 1" umožňuje z konkrétní (jedné) sdílené proměnné číst.

QUERY TO SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "U25")
1 | 1 | byte | reserved (0x00)

A ''odpověď'' je:

REPLY FROM SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "F95")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] data value from the shared variable

'''Dále,''' pro "sub_command == 4" dojde ke změně hodnoty.

COMMAND TO SDS: WRITE ONE SHARED VARIABLE: sub_command = 4

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "T12")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] new data value to write to shared variable

A odpověď je zde shodná jako odpověd pro "sub_command == 1".

== (2-PŘ) Master Command: [32] '''S0 Input Configuration Query''' ==

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.

Pozn. master_command == 32 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 32, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 1 | byte | reserved (0x00)
4 | 32 | bytes | text (name: unit)
36 | 32 | bytes | text (name: money)
68 | 32 | bytes | text (unit: power)
100 | 32 | bytes | text (name: power)
132 | 32 | bytes | text (name: device)
168 | 4 | dword | MTD value
172 | 4 | dword | minimal impulse length (msec)
176 | 4 | dword | impulse constant value (imp. per unit)
180 | 4 | bytes | price for T0
184 | 4 | bytes | price for T1
188 | 8 | bytes | reserved (0x00)
196 | 4 | dword | live value: T0 impulse counter
200 | 4 | dword | live value: T1 impulse counter
204 | 4 | dword | T0 offset
208 | 4 | dword | T1 offset
212 | 4 | dword | live value: measured space between impulses (msec)
216 | 4 | dword | live value: time since last registered impulse (msec)
220 | 4 | bytes | reserved (0x00)
224 | n | bytes | live value: combined text

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).

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).

'''(sub_command = 0xFF)''': speciální odpověď pro Tarifní vstup :

REPLY (master_command == 32, sent from SDS as reply)
sub_command == 0xFF (tariff)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | constant 0xFF
1 | 3 | bytes | reserved (0x00)
4 | 1 | byte | tariff input
5 | 32 | bytes | text (name: tariff)
37 | 32 | bytes | text (name: tariff T0 input)
69 | 32 | bytes | text (name: tariff T1 input)

== (2-PŘ) Master Command: [33] '''S0 Input History Values''' ==

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.

Pozn. master_command == 33 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 33, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 3 | bytes | reserved (0x00)
6 | 2 | word | history depth (number of items) - value "n" (example: five items -> n == 5)
8 | 4 | dword | uptime value for the last element (#n) in the list
12 | 4 | dword | ntptime value for the last element (#n) in the list
16 | 4 | dword | history item #1: value of T0 counter (this is the most oldest item)
20 | 4 | dword | history item #1: value of T1 counter (this is the most oldest item)
...
16+(n-1)*8 | 4 | dword | history item #n: value of T0 counter (this is the most newest item)
16+(n-1)*8+4 | 4 | dword | history item #n: value of T1 counter (this is the most newest item)

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).

== (2-PŘ) Master Command: [40] '''AD Input Configuration Query''' ==

Určeno pro čtení kalibračních konstant pro AD vstupy.

Pozn. master_command == 40 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 40, sent from SDS as reply)
sub_command == index to AD array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual AD input index for this reply
1 | 1 | byte | total number of AD inputs
2 | 2 | bytes | reserved (0x00)
4 | 4 | f32 | F6 calibration constant
8 | 4 | f32 | F5 calibration constant
12 | 4 | f32 | F4 calibration constant
16 | 4 | f32 | F3 calibration constant
20 | 4 | f32 | F2 calibration constant
24 | 4 | f32 | F1 calibration constant
28 | 4 | f32 | F0 calibration constant
32 | 1 | byte | is calibration factory locked
33 | 32 | bytes | unit
65 | 4 | bytes | reserved (0x00)
69 | 32 | bytes | name
101 | 4 | bytes | reserved (0x00)
105 | 4 | dword | raw value
109 | 4 | f32 | real value (converted from raw)
113 | n | bytes | live value text

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).

== (2-PŘ) Master Command: [42] '''PWM Output Configuration Query''' ==

Určeno pro čtení nastavení pro PWM výstup (konfigurace a živý stav).

Pozn. master_command == 42 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 42, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | reserved (0x00)
1 | 1 | byte | "N" = total number of PWM outputs
2 | 2 | bytes | reserved (0x00)

4+(i*12)+ 0 | 4 | dword | frequency (Hz) for PWMx
4+(i*12)+ 4 | 4 | dword | "pulse" value for PWMx
4+(i*12)+ 8 | 1 | byte | "ValueB" value for PWMx
4+(i*12)+ 9 | 2 | uword | "ValueS" value for PWMx
4+(i*12)+ 11 | 1 | byte | output enabled for PWMx

Pozn. PWM1 má hodnotu "i" = 0, PWM2 má hodnotu "i" = 1 atd.

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ů.

== (2-PŘ) Master Command: [44] '''RELAYs Configuration Query''' ==

Určeno pro čtení konfigurace RELAY výstupů (nastavení a živý stav).

Pozn. master_command == 44 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 44, sent from SDS as reply)
sub_command == index to RELAY array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual RELAY output index for this reply
1 | 1 | byte | total number of RELAY outputs
2 | 2 | bytes | reserved (0x00)
4 | 32 | bytes | name
36 | 4 | bytes | reserved (0x00)
40 | 1 | byte | "relay-controlled-by" value
41 | 1 | byte | "relay-output" value

== (2-PŘ) Master Command: [48] '''SD Card Status Query''' ==

Určeno pro čtení stavu SD karty.

Pozn. master_command == 48 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 48, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | card mounted
1 | 3 | bytes | reserved
4 | 4 | dword | card type
8 | 4 | dword | card ProdSN
12 | 4 | dword | card init attempts counter
16 | 4 | dword | card init failures counter
20 | 4 | dword | card total sector count in FAT in KiB
24 | 4 | dword | total sector reads counter
28 | 4 | dword | total sector writes counter
32 | 4 | dword | total sector r/w failures counter

== (2-PŘ) Master Command: [50] '''Serial Port Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [64] '''DataFlash (NVM) Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [128] '''Reserved''' ==

Tento příkaz není v současné verzi použit.

== (1-PŘ) Master Command (první produktová řada: "TV = 0001...." ) ==

Jednotlivé základní příkazy (''master command'') - zatím nejsou pro
první produktovou řadu definovány.

Detaily zde budou doplněny.

__NOTOC__

M2M: S-UDP protocol

2025-03-15T08:18:02Z

Adamn:

Tato stránka popisuje funkci zařízení SDS '''druhé produktové řady''' - protože SDS první produktové řady používají jiný protokol.

== Rychlá komunikace: S-UDP ==

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.

S-UDP používá následující výchozí UDP PORT: 310

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.

Přenos dat využívá specifického protokolu, který umožňuje bezpečně ovládat specifické zařízení SDS.

'''Typické použití:''' komunikace zařízení SDS s protistranou (např. aplikace na mobilním telefonu).

== Bezpečnost ==

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á.

Je to založeno na následujícím principu:

- 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)

- 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).

== S-UDP protokol ==

Každý příkaz a odpověď jsou v samostatném, jediném, UDP paketu.

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.

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ě):

[MASTER PACKET CONTENTS]

OFFSET | LEN | DATA
----------+--------+---------------------------------------------------------------
0 | 28 | HEADER
28 | PL*16 | ENCRYPTED PAYLOAD (contains: payload-header and payload-data)

'''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.

LITTLE-ENDIAN

Následující uvedené položky jsou ve formátu [http://en.wikipedia.org/wiki/Endianness#Little-endian Little-Endian] (procesory: ARM, x86):
* ''uword'' (unsigned 16-bit)
* ''dword'' (unsigned 32-bit)
* ''slong'' (signed 32-bit)
* ''qword'' (unsigned 64-bit)

Položky typu: ''byte'', ''sbyte'', ''bytes'' - jsou jednotlivé samostatné bajty, nesdružené do společného čísla.

Zde jsou uvedeny detailní položky:

[MASTER PACKET CONTENTS]

OFFSET | LEN | TYPE | DATA
---------+------+--------+-----------------------------

[HEADER]

0 | 3 | bytes | header "SDS"
3 | 1 | byte | TV = (SDS-product-line) including (S-UDP protocol master-version)
4 | 1 | byte | PL = number of 16B chunks - this is the payload_length of [ENCRYPTED PAYLOAD] (example: PL==10 => 160 bytes)
5 | 1 | byte | encryption-flag (NOW ACCEPTS ONLY: 0x10 == XTEA-64-CTR)
6 | 1 | byte | reserved
7 | 1 | byte | CK1: basic additive checksum for [ENCRYPTED PAYLOAD] (start from (including) byte offset [28] and forward)
8 | 4 | dword | user_identifier (correlation identifier) - use this to correlate query to response
12 | 16 | bytes | CounterBlock
----------+------+--------+----------------------------

[ENCRYPTED PAYLOAD] -> everything from this point is included:

28 | 1 | byte | random number (shall be always different than what was used ever before)
29 | 1 | byte | CK2: basic additive checksum for [HEADER] (all bytes [0] to [27] included, BUT: skipping byte [7])
30 | 2 | uword | XR_MTU value (maximal size of the custom-payload data including R) ( XL + R <= XR_MTU )
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)
36 | 4 | dword | uptime (msecs from boot)
40 | 4 | dword | time (epoch) (or, if no NTP is available to SDS, this will be a value of "seconds from boot")
44 | 4 | dword | SDS device type (0xXXXXXXXX) - THIS MUST MATCH
48 | 1 | byte | master_command
49 | 1 | byte | sub_command
50 | 2 | uword | XL value (exact length of the actually useful payload-data): XL = (PL*16) - R - 24

52 | XL | bytes | custom payload-data [C-PAYLOAD]

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.)

----------+------+--------+----------------------------

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.

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).

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é.

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ů.

"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. .

Hodnota "crc32" se počítá pro dešifrované data, algoritmus je identický jako pro [[FULL-C_crypto_functions|FULL-C funkci SDS_Crypt()]].

Pro zvolené XTEA-64-CTR má "CounterBlock" následující sestavu svého obsahu:

CounterBlock:

OFFSET | LEN | TYPE | DATA
----------+------+--------+-----------------------------------------------------------------------------------------
0 | 8 | qword | XTEA-64-CTR: 64-bit counter (counter is increased by 1, for each 16B of processed data)
8 | 8 | bytes | (reserved) not-used area = reserved (fill with 0x00)

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ů).

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.

TV: ttttVVVV
76543210

BIT OFFSET | LEN (bits) | content
-----------+------------+--------------------------------------------------
7 (MSB) | 4 | "t": produc-line value: 1 == first, 2 == second
3 | 4 | "V": version: 0 = first S-UDP protocol version

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.

== Postup při příjmu S-UDP paketu ==

Každá strana, která přijme S-UDP paket, provede následující kroky:

1) Ověřit platnost hodnot v [HEADER]
a. text "SDS" (platný obsah)
b. hodnota "TV" ("master-version" a "product-line") (platný obsah)
c. hodnota "PL" v platných mezích
d. hodnota "encryption_flag" (platný obsah)
2) Ověřit základní additive-checksum pro [ENCRYPTED PAYLOAD]
a. přečíst bajty [28] až [28+PL-1] a sečíst je (overflow osm bitů), výsledek musí odpovídat "CK1" hodnotě
3) Nastavit dešifrování
a. zvolit algoritmus podle "encryption-flag" hodnoty
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (přečíst z [HEADER])
4) Dešifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
5) Ověřit základní additive-checksum pro [HEADER] - teď totiž už máme hodnotu "CK2"
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ě
6) Ověřit další hodnoty
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
b. uschovat hodnotu "XR_MTU" pro vytváření odpovědi ("XR_MTU" omezuje velikost odpovědi, kterou můžeme zpátky odeslat)
c. ověřit časové údaje ("time" a "uptime")
d. ověřit "XL" vůči "PL"
7) Ověřit CRC-32 dešifrovaného payloadu
a. spočítat CRC-32 správným algoritmem, vučí bajtům (plain-text) z [36] až [52+XL-1] včetně

8) Hotovo: teď se provede aktuální příkaz (Master Command, dle tabulky podle produktové řady viz "TV")
a odešle odpověď (ponechat user_identifier pro korelaci) (pozor na "XR_MTU" omezení)

== Postup při odesílání S-UDP paketu ==

Odesílatel zprávy provádí tyto kroky:

1) Je sestaven přesný obsah [C-PAYLOAD] a určena odpovídající hodnota XL
a. obsah samozřejmě odpovídá tomu co chcete odeslat
b. určí se i "master-command" a "sub-command" (pozor na produktovou řadu SDS - viz "TV")
2) Vyplní se [HEADER]
a. hlavička "SDS", "encryption-flag"
b. zapsat správnou hodnotu "TV" podle protokolu a konkrétního SDS ("master-version", "product-line")
c. určí se nová unikátní hodnota "user_identifier", a zapíše se do [HEADER]
d. zapíše se "CounterBlock" (hodnota pokračuje po předchozím paketu)
3) Nachystá se zaokrouhlovací oblast "R"
a. Pokud XL není beze zbytku dělitelná 16, musí se doplnit oblastí "R"
4) Spočítá se hodnota "PL"
a. PL = (XL + R)/16
b. zapsat do [HEADER]
5) Začne se vyplňovat [ENCRYPTED PAYLOAD]
a. zapsat náhodný byte do "random number"
b. spočítá se hodnota "CK2" (sečíst bajty [0] až [27] - ovšem přeskočit byte [7] - pozor!)
c. zapsat hodnotu "XR_MTU" podle možností zařízení (tzn. jak velkou odpověď lze bezpečně přijmout, podle omezení sítě)
d. zapíší se hodnoty "uptime" a "time", zapsat hodnotu "SDS-DEVICE-TYPE"
e. zapsat "master-command" a "sub-command"
6) Spočítá se CRC-32 (před šifrováním)
a. spočítat crc32 pro bajty (plain-text) z offsetu [36] až [52+XL-1] včetně
7) Nastavit šifrování
a. zvolit algoritmus (musí odpovídat tomu, co se zapsalo do "encryption-flag")
b. nastavit klíč (stejný jako na protistraně, samozřejmě není přenášen přes síť)
c. nastavit "CounterBlock" (stejný jako byl zapsán [HEADER])
8) Šifrovat celou [ENCRYPTED PAYLOAD] na plain-text
a. hodnota "PL" musí být dělitelná 16 beze zbytku (tato podmínka závisí na použitém šifrovaní)
b. aktualizovaná hodnota "CounterBlock" (zvýšená o průběh šifrování) se uschová pro další použití - viz bod " 2) c. "
9) Spočítat základní additive-checksum pro [ENCRYPTED PAYLOAD]
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

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.

== Vzorové obsahy paketů ==

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í).
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.

== Seznam hlavních příkazů ==

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.

Zařazení SDS do produktových řad je v [[Seznam_Všech_SDS|tomto seznamu]].

* První produktová řada: "TV = 0001...." -> '''(1PŘ)'''
* Druhá produktová řada: "TV = 0010...." -> '''(2PŘ)'''

== (2PŘ) Master Command (druhá produktová řada: "TV = 0010...." ) ==

Jednotlivé základní příkazy (''master command''):

MASTER COMMAND | command
----------------+-------------------------------------
0 | NOP (replies with NOP)
1 | general device status
2 | 1-Wire access
4 | read FC-Get list
8 | write FC-Set list
16 | FULL-C shared variable(s) access
32 | serial port access
64 | DataFlash access
128 | reserved

Jak lze vidět, jednotlivé ''master command'' příkazy jsou dále rozlišeny pomocí hodnoty ''sub command''.

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).

== (2-PŘ) Master Command: [0] '''NOP''' ==

SDS odpoví na tento příkaz odesláním [0] NOP.

Tohoto příkazu lze využít k ověření komunikace a k vzájemné základní synchronizace.

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.

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 !

REPLY (master_command == 0, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 4 | bytes | SDS Device Type
10 | 4 | dword | FW version
14 | 32 | bytes | sysLocation (missing the 0x00 terminator)
46 | 8 | bytes | reserved (0x00)
54 | 32 | bytes | OEM string (missing the 0x00 terminator)
86 | 8 | bytes | reserved (0x00)
94 | 1 | byte | bylo aktivováno RSTD
95 | 1 | byte | bylo aktivováno PVD
96 | 1 | byte | SDS je: BIG (hodnota 1) nebo STSW (hodnota 0)
97 | 8 | bytes | reserved (0x00)
105 | 2 | uword | web interface TCP port number (typicky 80)
107 | 1 | byte | SNMP-read enabled
108 | 1 | byte | SNMP-write enabled
109 | 1 | byte | FULLC shared vars access lock (0 = unlocked) tzn. sys[150]
110 | 1 | byte | FULLC program run status
111 | 1 | byte | FULLC program started-by info
112 | 1 | byte | FULLC program watchdog active
113 | 6 | bytes | reserved
119 | 4 | f32 | backup battery voltage (milliVolts)

Pozn. rozšířená funkcionalita příkazu NOP (tedy vracení payloadu) bylo přidáno až ve Firmware od verze 3.10.2019.

== (2-PŘ) Master Command: [1] '''General Device Status''' ==

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.

Základní odpověď s nejzajímavějšími živými údaji. Určeno např. pro průběžnou aktualizaci stavu zobrazeného uživateli.

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-------+-------+------------------------------------------------------
0 | 6 | bytes | MAC ADDRESS (bytes, not text)
6 | 1 | byte | Ethernet Link Status / Speed (0, 10, 100)
7 | 1 | byte | Amount of users logged into SDS Web Admin
8 | 32 | bytes | sysLocation (missing the 0x00 terminator)
40 | 1 | byte | IP Watchdog Config status
41 | 1 | byte | IP Watchdog Output (relay) status
42 | 2 | uword | IP Watchdog RTT value (note.: 0xFFFF = not available)
44 | 1 | byte | DHCP status
45 | 1 | byte | reserved
46 | 1 | byte | NTP status
47 | 1 | sbyte | NTP offset (+/- hours) (signed char)
48 | 2 | uword | SoC chip temperature (degC)
50 | 1 | byte | GPIO-TOPB PIN(s) direction (0 == input)
51 | 1 | byte | GPIO-TOPB PIN(s) pin value
52 | 32*1 | byte | OPTO [1]..[32] status (0xFF == signal) (0x00 == nosignal)
84 | 32*1 | byte | RELAY [1]..[32] status (active/nonactive)
116 | 32*2 | uword | ADC [0]..[31] RAW value
180 | 1 | byte | General 1-W BUS status
181 | 1 | byte | 1-W BUS A - active device count
182 | 1 | byte | 1-W BUS B - active device count
183 | 3 | bytes | reserved (0x00)
186 | 1 | byte | S0 Tariff Value (active/nonactive)
187 | 1 | byte | number of the following S0 INPUT DB data blocks:
188 | 31*28 | data | S0 INPUT [1]..[ (max) 31] DB (data block)

S0-INPUT DB offset | LEN | TYPE | content
-------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
1 | 3 | bytes | reserved (filled with 0x00)
4 | 4 | dword | T0 impulse counter
8 | 4 | dword | T1 impulse counter
12 | 4 | dword | T0 offset
16 | 4 | dword | T1 offset
20 | 4 | dword | measured space between impulses (msec)
24 | 4 | dword | time since last registered impulse (msec)

Sestava [C-PAYLOAD] je tedy zřejmá.

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í).

== (2-PŘ) Master Command: [2] '''1-Wire Access''' ==

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ů.

QUERY/COMMAND TO SDS (master_command == 2)

sub_command | meaning
------------+-----------------------------------------------------------
0 | reserved
1 | obtain status, and list of found items on BUS A
2 | obtain status, and list of found items on BUS B
4 | list all read-values on BUS A
8 | list all read-values on BUS B

První možností tedy je sub_command == 1 , tzn. výpis nalezených zařízení na sběrnici A respektive B:

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 1 or 2

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item status #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item status #63

"1-W item status" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 2 | bytes | reserved (filled with 0x00)
4 | 8 | bytes | ROM-CODE [0]..[7]

Následuje: výpis získaných hodnot (např. změřené teploty z teplotních čidel) pro jednotlivé sběrnice :

REPLY (master_command == 1, sent from SDS as reply)
sub_command = 4 or 8

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | global 1-W controller status (SDS status)
1 | 1 | byte | number of active items on BUS A
2 | 1 | byte | number of active items on BUS B
3 | 1 | byte | reserved (0x00)
4 | 12 | data | 1-W item value #0
. . . | ... | ... | . . .
4+12*63 | 12 | data | 1-W item value #63

"1-W item value" ofs | LEN | TYPE | content
----------------------+-----+-------+-------------------------------------------------------
0 | 1 | byte | ctrl: main-status
1 | 1 | byte | ctrl: sub-status
2 | 1 | byte | value of ROM-CODE offset [0] (1-W DEVICE TYPE: ID)
3 | 1 | byte | value of ROM-CODE offset [7] (1-W DEVICE TYPE: CRC)
4 | 4 | slong | 1-W read: primary value
8 | 4 | slong | 1-W read: secondary value

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).

== (2-PŘ) Master Command: [4] '''Read FC-Get List''' ==

Dotaz (query) který obsahuje seznam indexů jejichž hodnoty jsou tazatelem požadovány, se posílá do SDS, které následně odpoví (reply).

Dotaz i odpověď má dynamický obsah, který je specificky strukturován.

QUERY (master_command == 4, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] space prepared for answer from SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] space prepared for answer from SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] space prepared for answer from SDS

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 !

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).

REPLY (master_command == 4, sent from SDS as reply to query)

SDS writes the values into the "[#n] space prepared for answer from SDS"

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.

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.

Následující popis ukazuje kódování typu proměnné a její délky, ve společném slově:

TBLEN#x: (16-bit unsigned word, little-endian) Type-Bits and Data Length (L#x)

TBLEN#x: TTTTvvvvvvvvvvvv
FEDCBA9876543210

BIT OFFSET (hex) | LEN (bits) | content
-----------------+------------+-----------------------------------------
F (MSB) | 4 | "T": type (see bit-value in next table)
B | 12 | "v": length of data, in bytes

"T" bit-values | meaning | FULL-C set/get
FEDC | | (which function)
----------------+-----------------------------+------------------
0000 | unsigned integer (32-bit) | _u
0001 | signed integer (32-bit) | _i
0010 | float IEEE-754 (32-bit) | _f
0100 | string UTF-8 (L#x * 8-bit) | _a
1000 | reserved (do not use) |

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ů.

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.

'''Index Value''' - každá položka má svůj číselný index, viz [[FULL-C:_set_and_get|seznam všech FULL-C indexů]].

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:

REPLY FROM SDS (master_command == 8)

NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS
(previously no proper response was provided)

sub_command | meaning
------------+-----------------------------------------------------------
0 | complete failure (no item read)
1 | partial failure (some items read, some not read)
2 | success (all items read OK)

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).

== (2-PŘ) Master Command: [8] '''Write FC-Get List''' ==

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).

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".

COMMAND TO SDS (master_command == 8, sent to SDS)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------
0 | 2 | uword | [#0] index value
2 | 2 | uword | [#0] TBLEN#0: type-bits and data length (L#0)
4 | L#0 | data | [#0] new data value to write to SDS

(4+(L#0))+0 | 2 | uword | [#1] index value
(4+(L#0))+2 | 2 | uword | [#1] TBLEN#1: type-bits and data length (L#1)
(4+(L#0))+4 | L#1 | data | [#1] new data value to write to SDS

. . . | ... | . . . | ...

Z+0 | 2 | uword | [#n] index value
Z+2 | 2 | uword | [#n] TBLEN#n: type-bits and data length (L#n)
Z+4 | L#n | data | [#n] new data value to write to SDS

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.

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:

REPLY FROM SDS (master_command == 8)

NOTE: THIS FEATURE (PROPER RESPONSE) IS IMPLEMENTED SINCE FW 15.March.2025 AND ONWARDS
(previously no proper response was provided)

sub_command | meaning
------------+-----------------------------------------------------------
0 | complete failure (no item modified)
1 | partial failure (some items modified, some not modified)
2 | success (all items modified OK)

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).

== (2-PŘ) Master Command: [16] '''FULL-C Shared Variable(s) Access''' ==

Tento příkaz se využívá k přístupu ke [[FULL-C:_sharing|sdíleným proměnným]] programu FULL-C.

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.

Mohou existovat tyto sdílené proměnné :
* S00 až S99 (hodnoty: signed 32-bit)
* U00 až U99 (hodnoty: unsigned 32-bit)
* F00 až F99 (hodnoty: float 32-bit)
* T00 až T99 (hodnoty: array/text)

Rozlišování jednotlivých funkcí je závislé na hodnotě "sub_command":

QUERY-or-COMMAND TO SDS (master_command == 16, sent to SDS)

sub_command | meaning
------------+---------------------------------------------
0 | provide list of all active shared variables
1 | read from shared variable (single variable)
2 | reserved
4 | write to shared variable (single variable)
8 | reserved

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.

RESPONSE: LIST OF SHARED VARIABLES: sub_command = 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 13 | bytes | Uxx existence: bit-field
13 | 13 | bytes | Sxx existence: bit-field
26 | 13 | bytes | Fxx existence: bit-field
39 | 13 | bytes | Txx existence: bit-field

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.

Xxx existence: bit-field

BYTE -> [0] . . . [13]
BITS -> 0 . . . 100 (plus 4 at the end, which are not used)

BYTE [0] = bit 0, 1, 2, ..., 7
BYTE [1] = bit 8, 9, 10, ..., 15
...
BYTE [13] = bit 96, 97, 98 ..., 103

example: existence of "U11" => bit 11 => look at BYTE [1]

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.

'''Další,''' "sub_command == 1" umožňuje z konkrétní (jedné) sdílené proměnné číst.

QUERY TO SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "U25")
1 | 1 | byte | reserved (0x00)

A ''odpověď'' je:

REPLY FROM SDS: READ ONE SHARED VARIABLE: sub_command = 1

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "F95")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] data value from the shared variable

'''Dále,''' pro "sub_command == 4" dojde ke změně hodnoty.

COMMAND TO SDS: WRITE ONE SHARED VARIABLE: sub_command = 4

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+--------------------------
0 | 3 | bytes | [#0] name (example: "T12")
1 | 1 | byte | reserved (0x00)
4 | 2 | uword | [#0] L#0: data length (L#0)
6 | 2 | uword | reserved (0x0000)
8 | L#0 | data | [#0] new data value to write to shared variable

A odpověď je zde shodná jako odpověd pro "sub_command == 1".

== (2-PŘ) Master Command: [32] '''S0 Input Configuration Query''' ==

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.

Pozn. master_command == 32 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 32, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 1 | byte | reserved (0x00)
4 | 32 | bytes | text (name: unit)
36 | 32 | bytes | text (name: money)
68 | 32 | bytes | text (unit: power)
100 | 32 | bytes | text (name: power)
132 | 32 | bytes | text (name: device)
168 | 4 | dword | MTD value
172 | 4 | dword | minimal impulse length (msec)
176 | 4 | dword | impulse constant value (imp. per unit)
180 | 4 | bytes | price for T0
184 | 4 | bytes | price for T1
188 | 8 | bytes | reserved (0x00)
196 | 4 | dword | live value: T0 impulse counter
200 | 4 | dword | live value: T1 impulse counter
204 | 4 | dword | T0 offset
208 | 4 | dword | T1 offset
212 | 4 | dword | live value: measured space between impulses (msec)
216 | 4 | dword | live value: time since last registered impulse (msec)
220 | 4 | bytes | reserved (0x00)
224 | n | bytes | live value: combined text

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).

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).

'''(sub_command = 0xFF)''': speciální odpověď pro Tarifní vstup :

REPLY (master_command == 32, sent from SDS as reply)
sub_command == 0xFF (tariff)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | constant 0xFF
1 | 3 | bytes | reserved (0x00)
4 | 1 | byte | tariff input
5 | 32 | bytes | text (name: tariff)
37 | 32 | bytes | text (name: tariff T0 input)
69 | 32 | bytes | text (name: tariff T1 input)

== (2-PŘ) Master Command: [33] '''S0 Input History Values''' ==

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.

Pozn. master_command == 33 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 33, sent from SDS as reply)
sub_command == index to S0 array [1..MAX] (typical MAX value is 9)

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | S0 input number for this reply (for a valid answer: 1..MAX , otherwise: 0x00).
1 | 1 | byte | total number of S0 inputs for this SDS
2 | 1 | byte | configuration status (combined flags: bit0 = enabled as S0; bit1 = is tariff used)
3 | 3 | bytes | reserved (0x00)
6 | 2 | word | history depth (number of items) - value "n" (example: five items -> n == 5)
8 | 4 | dword | uptime value for the last element (#n) in the list
12 | 4 | dword | ntptime value for the last element (#n) in the list
16 | 4 | dword | history item #1: value of T0 counter (this is the most oldest item)
20 | 4 | dword | history item #1: value of T1 counter (this is the most oldest item)
...
16+(n-1)*8 | 4 | dword | history item #n: value of T0 counter (this is the most newest item)
16+(n-1)*8+4 | 4 | dword | history item #n: value of T1 counter (this is the most newest item)

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).

== (2-PŘ) Master Command: [40] '''AD Input Configuration Query''' ==

Určeno pro čtení kalibračních konstant pro AD vstupy.

Pozn. master_command == 40 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 40, sent from SDS as reply)
sub_command == index to AD array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual AD input index for this reply
1 | 1 | byte | total number of AD inputs
2 | 2 | bytes | reserved (0x00)
4 | 4 | f32 | F6 calibration constant
8 | 4 | f32 | F5 calibration constant
12 | 4 | f32 | F4 calibration constant
16 | 4 | f32 | F3 calibration constant
20 | 4 | f32 | F2 calibration constant
24 | 4 | f32 | F1 calibration constant
28 | 4 | f32 | F0 calibration constant
32 | 1 | byte | is calibration factory locked
33 | 32 | bytes | unit
65 | 4 | bytes | reserved (0x00)
69 | 32 | bytes | name
101 | 4 | bytes | reserved (0x00)
105 | 4 | dword | raw value
109 | 4 | f32 | real value (converted from raw)
113 | n | bytes | live value text

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).

== (2-PŘ) Master Command: [42] '''PWM Output Configuration Query''' ==

Určeno pro čtení nastavení pro PWM výstup (konfigurace a živý stav).

Pozn. master_command == 42 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 42, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | reserved (0x00)
1 | 1 | byte | "N" = total number of PWM outputs
2 | 2 | bytes | reserved (0x00)

4+(i*12)+ 0 | 4 | dword | frequency (Hz) for PWMx
4+(i*12)+ 4 | 4 | dword | "pulse" value for PWMx
4+(i*12)+ 8 | 1 | byte | "ValueB" value for PWMx
4+(i*12)+ 9 | 2 | uword | "ValueS" value for PWMx
4+(i*12)+ 11 | 1 | byte | output enabled for PWMx

Pozn. PWM1 má hodnotu "i" = 0, PWM2 má hodnotu "i" = 1 atd.

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ů.

== (2-PŘ) Master Command: [44] '''RELAYs Configuration Query''' ==

Určeno pro čtení konfigurace RELAY výstupů (nastavení a živý stav).

Pozn. master_command == 44 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 44, sent from SDS as reply)
sub_command == index to RELAY array [1..MAX]

C-PAYLOAD offset | LEN | TYPE | content
-----------------+------+-------+------------------------------------------------------
0 | 1 | byte | actual RELAY output index for this reply
1 | 1 | byte | total number of RELAY outputs
2 | 2 | bytes | reserved (0x00)
4 | 32 | bytes | name
36 | 4 | bytes | reserved (0x00)
40 | 1 | byte | "relay-controlled-by" value
41 | 1 | byte | "relay-output" value

== (2-PŘ) Master Command: [48] '''SD Card Status Query''' ==

Určeno pro čtení stavu SD karty.

Pozn. master_command == 48 byl přidán až ve Firmware od verze 3.10.2019.

REPLY (master_command == 48, sent from SDS as reply)
sub_command == 0

C-PAYLOAD offset | LEN | TYPE | content
-----------------+-----+-------+------------------------------------------------------
0 | 1 | byte | card mounted
1 | 3 | bytes | reserved
4 | 4 | dword | card type
8 | 4 | dword | card ProdSN
12 | 4 | dword | card init attempts counter
16 | 4 | dword | card init failures counter
20 | 4 | dword | card total sector count in FAT in KiB
24 | 4 | dword | total sector reads counter
28 | 4 | dword | total sector writes counter
32 | 4 | dword | total sector r/w failures counter

== (2-PŘ) Master Command: [50] '''Serial Port Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [64] '''DataFlash (NVM) Access''' ==

Tento příkaz není pro "version == 0x00" podporován. Potřebujete novější
firmware.

== (2-PŘ) Master Command: [128] '''Reserved''' ==

Tento příkaz není v současné verzi použit.

== (1-PŘ) Master Command (první produktová řada: "TV = 0001...." ) ==

Jednotlivé základní příkazy (''master command'') - zatím nejsou pro
první produktovou řadu definovány.

Detaily zde budou doplněny.

__NOTOC__

SDS BIG: firmware changelog

2025-02-27T07:53:20Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 27.2.2025 ==
* upraven timeout pro čtení souboru z SD karty přes webový server (poskytování obsahu z SD karty na web)
* 512: oprava nefunkčního čtení ze sériové linky COM6

== 8.2.2025 ==
* oprava některých payloadů v protokolu SUDP

== 22.7.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

Firmware

2025-02-27T07:51:53Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_270225_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 27.2.2025]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_270225_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 27.2.2025]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_270225_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 27.2.2025]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

SDS BIG: firmware changelog

2025-02-20T07:50:48Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 8.2.2025 ==
* oprava některých payloadů v protokolu SUDP

== 22.7.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

Firmware

2025-02-20T07:48:27Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_080225_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 8.2.2025]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_080225_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 8.2.2025]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_080225_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 8.2.2025]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__

SDS BIG: firmware changelog

2024-07-22T15:08:41Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 22.7.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

SDS BIG: firmware changelog

2024-07-22T15:08:23Z

Adamn:

== SDS-BIG(2) , SDS-SMALL(2), SDS-STSW a všechny OEM ==

__NOTOC__

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.

Změny jsou seřazeny tak, že nejnovější verze (která je stáhnutelná z webu) je popsána jako první.

Proč je vydáván nový firmware? Protože operativně řešíme požadavky uživatelů, a jsou doplňovány nové funkce.

Firmware poskytujeme zcela zadarmo po celou dobu životnosti výrobku. Děláme to vše pro Vás.

== 24.2.2024 ==
* FULLC.EXE - odstraněna chyba, která neumožnila nahrát do SDS soubor FCB větší než 64kB
* 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)
* FC: SDS_reset_program() nezanechává nadbytečnou chybouvou hlášku v konzoli
* FC: mqtt_publish() použije vámi nastavené bitové pole do PUBLISH hlavičky (viz index 11198)
* SMTP odesílání by mělo být robustnější při odesílání více emailů za sebou

== 24.2.2024 ==
* možnost smazat nahraný TLS klíč+certifikát (tlačítko s heslem, ve webovém rozhraní)
* 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í)

== 31.10.2023 ==
* SNMP - oprava způsobu předání chyby v odpovědi
* SNMP v1 - možnost nastavit dvě nezávislé komunity
* 512: plná implementace SNMP v3 (včetně AUTHPRIV)
* 64,128: omezená implementace SNMP v3 (pouze NOAUTHNOPRIV)
* FC: indexy 66, 67, 68, 4990..4999

== 19.8.2023 ==
* oprava SDS UDP SEARCH (příchozí paket na portu 20484 byl firewallem od verze 6.6.23 zahozen, teď už opraveno)
* 512: HTTPS server (aktivace nahráním certifikátu, jinak zůstává HTTP)

== 14.7.2023 ==
* 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)
* 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)

== 6.6.2023 ==
* funkce http_header_set_user_row() má zvětšenou maximální délku parametru na 255 znaků
* 512: počet MQTT subscribe zvětšen z max. 8 na max. 20
* 512: další zvětšení FC konzole
* webový admin: úprava (oprava) použití timerů v javascriptu
* FC: DNS resolv umí pracovat s širším rozsahem UDP portů (někdy způsobilo nepřijetí odpovědi a musel se resolv opakovat)
* 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)

== 9.3.2023 ==
* FC: verze 0x12 (+ odpovídající FULLC.EXE): přidány funkce http_header_set_user_row() a http_header_set_content_type()
* 64 a 128: odstraněno možné zpomalení běhu po zapnutí v určité okrajové situaci

== 28.2.2023 ==
* POST: přidán příkaz /wrdf
* POST: oprava chyby, kdy mohlo dojít k neprovedení akce na základě příkazu /changeip
* malá bezpečnostní aktualizace

== 9.1.2023 ==
* FC verze 0x11 (+ odpovídající FULLC.EXE)
* firmware pro všechny HW varianty BIG, BIG2-DP a BIG2-DP-DS84
* web: doplněno zobrazení surových hodnot, čtených z 1-Wire zařízení
* FC: přidána funkce SDS_onewire_config() pro varianty -DS84
* 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)
* FC: doplněna archivace poslední chyby FC programu, a zobrazení na webu (i v případě restartu FC Watchdogem)
* FC: funkce pro prohledání složky (file_opendir, file_readdir, file_closedir)
* oprava PWM3 a PWM4 na BIG2-64/128 - funkce, ukládání nastavení
* 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í
* FC: přidána funkce SDS_onewire_search_bus()
* FC: přidány indexy 132..136 , indexy 2488..2499, 2986..2997

== 1.12.2022 ==
* bezpečnostní aktualizace (dle nahlášené záležitosti a testu)
* 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í)
* 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ů)

== 30.11.2022 ==
* 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)
* 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)
* FC: přidán index 137
* 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)

== 22.11.2022 ==
* FC (64/128/512): verze 0x10
* dns_resolv správně hlásí chybu 516 a 517 při výpadku připojení v průběhu dotazu

== 18.11.2022 ==
* FC (64/128): verze 0x10
* FC: nová funkce SDS_set_RTC
* FC: nové funkce pro práci s float
* oprava pro mounting některých typů SD karet

== 14.11.2022 ==
* FC: oprava výpočtů v 64-bit doméně
* FC: file_expand() - detailnější rozvrstvení návratových chybových hodnot
* web: rozšířeny zobrazované informace o probíhajícím připojování SD karty
* web server: vrací korektně 503 pro soubory na SD kartě, které jsou zablokovány FC programem
* FC: rozšířena a zásadně zlepšena implementace printf/sprintf/snprintf/sscanf - viz detaily v návodu na wiki
* FC: zlepšen výpis (informace na web) při určitých chybách v FC programu, plus další drobky kolem echo.htm

== 16.10.2022 ==
* tento firmware (od této verze) podporuje i hardware SDS 64/128/512 ve variantě DP
* podpora pro 4 PWM výstupy (pro vhodný hardware - BIG2)
* odpověď na (webový) příkaz /sv? , má doplněný obsah http hlavičky, takže by ji mělo být snazší zpracovat
* FC: watchdog programu je (nově) pozastaven po dobu mountování SD karty (protože je pozastaven i program)
* FC: zápis do indexu 999 funguje jak má
* FC: verze 0x0F (nové funkce PWMx)

== 5.10.2022 ==
* 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

== 30.9.2022 ==
* 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)

== 28.9.2022 ==
* 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)

== 1.8.2022 ==
* správně zobrazovaná hláška (nápověda) na úvodní webové stránce ohledně stavu konfigurace
* FC: přidáno tlačítko (odkaz) pro restart FULLC programu (např. pokud skončil a chcete jej ručně spustit znovu)
* FC: do výpisu chyby při pádu programu je přidán UTC čas (pro identifikaci, kdy se chyba stala)
* FC: spolehlivostní úpravy při startu programu (načtení z DF), a při zápisu nového programu (práce s DF)

== 11.7.2022 ==
* FC: verze 0x0E
* FC: přidána funkce mktime()
* FC: přidána funkce gmtime()
* FC: přidána funkce localtime()
* opraveno zachování konfigurace ipwdg (webové rozhraní) a obsluhy relé ipwdg

== 1.7.2022 ==
* FC: verze 0x0D
* FC: upravena funkce SDS_TOPB_keyboard_status() pro lepší předané výsledky
* FC: přidána funkce SDS_TOPB_keyboard_updn()
* FC: přidána funkce SDS_rescan_onewire()
* FC: odstraněno náhodné hlášení o už probíhajícím nahrávání programu při nahrávání z EXE
* 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.
* opraveno HTTP POST nastavení položek NTP
* opraveno HTTP POST který teď neuzavře spojení dříve než má, pokud mazání NVM pro nový FW (nebo nový UserWeb) trvá dlouho

== 12.4.2022 ==
* 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)
* 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

== 3.4.2022 ==
* FC verze 0x0C
* FC: přidána funkce SDS_I2C_rw
* OneWire stabilnější

== 21.1.2022 ==
* prioritu mají vybrané konfigurační položky v NVM (jsou-li tam platné) před baterií zálohovanou pamětí
* aktivován HTTP POST protokol pro nahrávání a konfiguraci SDS (viz [[SDS:POST_upload]])

== 18.1.2022 ==
* 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
* načítání konfigurace upraveno (větší spolehlivost)

== 15.1.2022 ==
* 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)
* přidán M2M výstup ip.xml
* FC: přidán algoritmus SHA-256 do funkce SDS_crypto()
* 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
* identifikátor FC programu přidán na webové rozhraní a do M2M výstupů, a do exe aplikace
* zobrazeno unikátní identifikační čislo SDS hardware (napevno spojeno s modulem SDS, nezměnitelné), teď i ve M2M výstupech
* SNMP: nové položky .8.90 , .8.91 , .8.99
* FC: nové get(u32) položky 2 a 87

== 31.12.2021 ==
* 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)
* web: informace na web (p=8) o stavu připojování SD karty (mounting...) a o stavu kdy je FC program pozastaven (PAUSED)
* web: opraven zámek zvětšené konzole (echo)
* důslednější kontrola platnosti konfigurace při startu

== 27.12.2021 ==
* opravena chyba kdy na webu nešlo nastavit 100 procent PWM duty (jen 0 až 99, teď už jde i 100)
* FC: několikanásobně zvětšena konzole (echo.htm)
* HW: při poruše hlavního zdroje hodin (krystal) se použije záložní zdroj
* HW: využíváme RTC pro udržení času při přechodu přes reset (drží čas dokud zase nepřijde NTP)
* 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í
* vydána varianta 512 - vlastní soubor s firmware

== 25.12.2021 ==
* pouze interní vydání

== 26.3.2021 ==
* FC: oprava nesprávného zacházení s unsigned typy (na některých místech interně přemapovány na signed)
* FC: chování varianty if pro speciální kombinaci signed/unsigned dle specifikace standardu C

== 9.2.2021 ==
* FC: oprava TID v MODBUS-TCP
* MBTC výpis rozšířen
* FC: drobná úspora heap (více dostupného místa)
* FC: dns resolv drobný fix
* FC: http_get a http_post důležitý fix
* FC: nová funkce http_close
* FC: chyba -7 pro MODBUS-TCP a pro MQTT
* vylepšený algoritmus S0, rozšířené možnosti nastavení detektoru S0 (nastavení přidáno ve webovém rozhraní)

== 22.12.2020 ==
* 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)
* security fix

== 10.12.2020 ==
* dřívější odeslání NTP požadavku po výpadku síťového spojení
* integrovaná korekce chyby A/D měření pro HW osazený LMV324; uživatel může povolit tuto automatickou opravu chyby LMV324 ve webové administraci
* 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
* automatický odečet S0 počítadel (vždy za dnešek a včerejšek), viz nové sys, pozor pro funkci vyžaduje NTP

== 23.11.2020 ==
* FC + FULLC.exe: oprava chyby v případě více #if / #ifdef / #endif bloků zapsaných hned za sebou
* FC: makra a define lze provést i uvnitř funkce (dříve jen venku)
* FC: detekce nesprávné dereference ukazatele

== 14.11.2020 ==
* 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)

== 4.11.2020 ==
* 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

== 3.11.2020 ==
* FC: zobrazení (v konzoli) čísla řádku (ve zdrojovém kódu) při chybě (což velmi zlepší ladění programů)
* FULLC.exe: odstraněno omezení na 255 znaků na řádek
* FULLC.exe: zrychlení nahrávání do SDS

== 23.10.2020 ==
* 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
* FC: oprava http_get/post: správné vyplnění výsledků i pro situaci kdy server ukončí spojení přes TCP RST

== 14.10.2020 ==
* oprava FULL-C funkce XTEA-CRYPT (bug o dvě verze dříve)

== 13.10.2020 ==
* důležitá oprava chyby ve FULL-C (ternary operator, a další nahlášené nesrovnalosti)

== 13.9.2020 ==
* oprava detekce SD karty (některé varianty SD karet nebyly detekovány, teď už ano)

== 9.8.2020 ==
* FULL-C verze 0B (vyžaduje použít aktuální EXE pro překlad)
* různé drobné opravy a zabezpečení
* zobrazení auditlogu (webové rozhraní SDS)
* FC: http_post
* FC: MQTT klient
* FC: MODBUS-TCP klient

== 4.8.2020 ==
* úprava obsluhy relé
* podpora OneWire modulu SDS-1W-T-RH

== 3.10.2019 ==
* SMTP klient posílá v hlavičce i položku "Date" (ale jen za předpokladu správného času v SDS)
* 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ě)
* SUDP: rozšířen NOP příkaz
* SUDP: přidány další nové příkazy (master_cmd: 32, 33, 40, 42, 44, 48)

== 23.9.2019 ==
* oprava GUI (S0 Inputs)
* SNMP nabízí možnost číst všechny sdílené proměnné (FULL-C: Sxx, Uxx, Fxx, Txx)
* opraven nefunkční RSTD na modulu STSW-rev3

== 23.6.2019 ==
* oprava chyby objevené ve FW 28.5.2019, kdy na některých specifických SDS nefungovaly AD vstupy

== 28.5.2019 ==
* oprava funkce SD karty (pro případy kdy se stala po čase nedostupná pro FC/web)

== 5.5.2019 ==
* 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)
* oprava původně chybné implementace S-UDP příkazu "1Waccess: sub-command 8"

== 24.2.2019 ==
* překlopení z BETA do oficiálního FW
* automatika zimní/letní čas
* přístup na SD kartu: FULL-C pracuje se soubory (vytvoření, smazání, čtení a zápis, atd.)
* 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)
* oprava čtení napětí baterie pro variantu 128K
* shared.xml
* odstraněno omezení délky ve shared.txt
* zprovozněno getsv
* verze FULL-C je teď FC 0x0A (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: nová možnost způsobu čtení teploty SoC
* FULL-C: index 64, 65, 184, 185, 429, 430, atd.
* FULL-C: doplněné set/get funkce pro sdílené proměnné
* FULL-C: s/printf umí správné zpracovat požadavek na určení desetinných míst pro float
* FULL-C: funkce pro reset FC programu
* FULL-C: funkce pro watchdog FC programu
* SNMP nové OIDy (dle přidaných věcí - čas, sdcard)

== 1.7.2018 ==
* 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)
* FULL-C: přidán index 183 poskytující datum vydání FW který je právě nahrán v SDS

== 27.6.2018 ==
* verze FULL-C je teď FC 0x09 (vyžaduje použít aktuální EXE pro překlad)
* FULL-C: přidána podpora pro int64_t a uint64_t
* FULL-C: přejmenováno set a get funkce (rozlišení 32 a 64 bit)
* FULL-C: snprintf přesně dle standardu (zrušena nevhodná změna z 20.12.2017)
* drobné opravy
* drobná oprava v odchozím TCP-SYN a v generátoru ISN

== 8.3.2018 ==
* oprava echo.htm - správně wrapuje obsah, a nejsou tam nadbytečné 0x00
* 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)

== 2.3.2018 ==
* aktulizace a oprava ve výpočtu "aktuálního výkonu" pro okrajové situace (např. krajní hodnoty impulsní konstanty)

== 11.2.2017 ==
* zprovozněny funkce set/get pro indexy 4000 až 4300 (alternativní přístup k číselným sdíleným proměnným)

== 21.12.2017 ==
* zvýšena stabilita spuštění po zapnutí

== 20.12.2017 ==
* 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, ...);".
* 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;)
* 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)

== 18.12.2017 ==
* UserWEB projekt má opravenu chybu, kdy nebylo možno použít delší Name Chain tabulku (tedy lze už vložit mnohem více souborů)
* nastavená MAC adresa je zachována i po průchodu RSTD (byla-li platná)
* opravena chyba způsobující nefunkční http_get(), teď už to opět funguje
* aktualizace obsluhy PWM (např. lépe přepočítává zobrazovaná "procenta")
* oprava strcat() funkce (opraveno hlídání max velikosti bufferu ze "from" na "to")

== 18.9.2017 ==
* FULL-C: printf() správně tiskne float i pokud se formátovací parametr zadá jako %d (tedy ne jako %f)
* 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)

== 9.9.2017 ==
* vnitřní bezpečnostní aktualizace

== 29.8.2017 ==
* 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ě
* 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)

== 8.8.2017 ==
* 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)

== 10.7.2017 ==
* 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)
* 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
* 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
* drobné užitečné opravy dle hlášení uživatelů
* 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)

== 2.6.2017 ==
* 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)

== 6.4.2017 ==
* přidána FULL-C funkce AES-128-CTR, viz SDS_crypto(0x20, ...);

== 31.3.2017 ==
* oprava RS485-MASTER drive, je teď zcela přesný (tzn. vypnut v přesném časování za úplně posledním vyslaným bitem)
* oprava čtení konfigurace 1-W, pomocí sds_get_a()
* přidán index 139
* odstraněno omezení na 32 znaků pro sdílené proměnné (přenos textu) "Txx" (xx = 00 až 99)
* fix návratových hodnot FULL-C funkcí pro práci s DF (teď to vrací správně 1 nebo 0, podle wiki)
* upřesněn název: (z BIG na BIG-64) / (z STSW na STSW-64)
* vyžaduje aktuální SDSLOAD.exe (6.3.2017 nebo novější) a FULLC.exe (6.3.2017 nebo novější)

== starší záznamy ==

Nejsou k dispozici.

Firmware

2024-07-22T15:04:08Z

Adamn:

== Nový Firmware ==

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í.

Postup a řešení problémů: [[Manual_Firmware_Update|Návod pro aktualizaci Firmware v SDS]].

=== Odkazy ke stáhnutí ===
<br>

<div class="successbox">PC Software</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_sdsc_winexe.jpg]] '''Program SDSC.exe''' (programovací jazyk SDS-C, aktualizace firmware pro SDS '''první řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_fullc_winexe.jpg]] '''Program FULLC.exe''' (programovací jazyk FULL-C, aktualizace firmware pro SDS '''druhé řady''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| 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''')
|-
| 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
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_empty.jpg]] '''Program SDS LOG'''
|-
| 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]
<li> Zdrojové kódy programu SDS LOG (Creative Commons Licence) [[SDS LOG: source code|ke stáhnutí zde]]
<li> [[SDS LOG: changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
|}

<div class="successbox">První Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMICROE.jpg]] [[Soubor:Thumbnail_SDSMICRO.jpg]] [[Soubor:Thumbnail_SDS_DIN.jpg]] '''D0000001''' MICRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: LM]] varianty '''LIGHT''', '''LIGHT 2''' a '''E (DIN)'''.
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny varianty a revize SDS MICRO LM.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B0000057''' MICRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MICRO_ST_1.png]] '''B000D957''' MICRO ST DP
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MICRO: ST DP]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MICRO ST DP.
<li>
<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]
<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]
<li>
<li>[[SDS MICRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MINI_1.png]] [[Soubor:Thumbnail_SDS_MINI_2.png]] '''B0000020''' MINI ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MINI: ST]].
<li>Výchozí firmware (SDS-C verze č. 09), firmware je jednotný pro všechny revize SDS MINI ST.
<li>
<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]
<li>
'''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]
<li>
[[SDS MINI: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSMACRO.jpg]] '''C0000001''' MACRO LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: LM]].
<li>Výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<li>
'''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]
<li>
<li>[[SDS MACRO: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_MACRO_ST_rev1.png]] '''C0000057''' MACRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS MACRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS MACRO: ST: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSTTCPRO.jpg]] '''B0000001''' TTCPRO ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS TTCPRO: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS TTCPRO ST má shodný Change Log se SDS MINI ST, a to zde: [[SDS MINI: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:thumbnail_SDSIO6.jpg|160px]] '''D0000006''' IO6 LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: LM]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 LM má shodný Change Log se SDS MICRO LM, a to zde: [[SDS MICRO: LM: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_empty.jpg]] '''D0000011''' IO6 ST
|-
| style="padding: 15px;"|<li>Výrobek [[SDS IO6: ST]], výchozí firmware (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>SDS IO6 ST má shodný Change Log se SDS MICRO ST, a to zde: [[SDS MICRO: ST: firmware changelog]].
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDS_FTP_rev1.png]] '''F0000001''' FTP LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS FTP: LM]], výchozí firmware.
<li>
<li> Firmware: ''SDS FTP ze dne 7.9.2010'' už nahrán ve výrobku.
<li>
<li>[[SDS FTP: LM: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_ONEDPS.jpg]] '''E000AAA1''' UPS ONEDPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: ONEDPS]], finální jednodesková verze (aktuální) (SDS-C verze č. 09).
<li>
<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]
<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]
<li>
<li>[[SDS UPS: LM: ONEDPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSUPS_TWODPS.jpg]] '''C00xxxxx''' UPS TWODPS LM
|-
| style="padding: 15px;"|<li>Výrobek [[SDS UPS: LM: TWODPS]], HW rev3u - DVOUDESKOVÁ (UŽ NEPRODÁVANÁ) varianta.
<li>
<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).
<li>
<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.
<li>
<li>HISTORIE: [[SDS UPS: LM: TWODPS: firmware changelog]]
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

<div class="successbox">Druhá Produktová Řada SDS</div>

{| class="wikitable"
|-
| style="padding: 5px;background-color:#cdcdcd;"| [[Soubor:Thumbnail_SDSBIG.jpg]] [[Soubor:Thumbnail_SDSSMALL.jpg]] '''B1900001''' / '''B1900002''' / '''B1900004''' : BIG, BIG2, SMALL, STSW, MBGW
|-
| style="padding: 15px;"|<li>Společný firmware pro výrobky [[SDS BIG]], [[SDS SMALL]] a [[SDS STSW]] a [[SDS MBGW]]
<li>
<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í.
<li>Firmware je společný pro BIG a BIG2, rozlišení je pouze dle varianty 64/128/512.
<li>Pozn. Modul SMALL a modul MBGW interně obsahuje modul STSW, nahrává se tam tedy stejný FW.
<li>Firmware vždy vyžaduje použití odpovídající, aktuální verze FULLC.EXE programu.
<li>
<li>SDS BIG/SMALL/STSW: [[SDS BIG: firmware changelog|firmware changelog]]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "64kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<li>- stáhnout firmware (varianta: 64kB) [https://sds.an-d.cz/firmware/SDS_BIG_64K_220724_EN.bin firmware "64kB" SDS-BIG/SMALL/STSW/OEM ze dne 22.7.2024]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "128kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<li>- stáhnout firmware (varianta: 128kB) [https://sds.an-d.cz/firmware/SDS_BIG_128K_220724_EN.bin firmware "128kB" SDS-BIG/SMALL/STSW/OEM ze dne 22.7.2024]
|-
| style="padding: 15px;"| VARIANTA HARDWARE "512kB"
<li>
<li>'''PLNĚ ANGLICKÁ LOKALIZACE''' / FULL ENGLISH LOCALISATION
<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]]
<li>- stáhnout firmware (varianta: 512kB) [https://sds.an-d.cz/firmware/SDS_BIG_512K_220724_EN.bin firmware "512kB" SDS-BIG/SMALL/STSW/OEM ze dne 22.7.2024]
<li>Informace: SDS BIG/SMALL/STSW 512 se starším FW než 12.4.2022 vyžaduje přeprogramování u výrobce.
|-
| style="padding: 15px;"| POZOR
'''Aktualizujte''' své doplňkové sandwich desky, tzn. [[SDS BIG: DALI]], [[SDS BIG: LORA]] - na verzi FW 5.12.2016 '''nebo novější'''.<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.
|-
| style="padding: 15px; background-color:#ffffff;"|
|}

=== Informace ===

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.
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.
V případě že chcete získat podporu, musíte mít instalovaný nejnovější firmware.

=== Historický Software ===

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í.

==== První Produktová Řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro SDS-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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)

* (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)

* (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)

* (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)

* (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

* (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''')

* (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''')

==== Druhá Produktová řada ====

'''Nepoužívejte''' starý firmware a staré verze aplikace pro FULL-C. '''Aktualizujte''' své zařízení pravidelně.

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í.

* (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''']

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (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)

* (historická verze) stáhnout WinEXE program SDSLOAD [https://sds.an-d.cz/firmware/archive/SDSLOAD_201022.exe ze dne 20.10.2022]

* (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ší)

* (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)

== Beta Testing ==

Než vydáme novou verzi, je potřeba změny a novinky otestovat.

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.

Diskuse s vývojem k aktuálnímu Firmware je k dispozici na našem fóru.

__NOTOC__