Zobrazení zdroje stránky SDS-C: sdsc sysf

 Tato stránka popisuje programovací jazyk '''SDS-C''', který je dostupný na vybraných zařízeních SDS. Některá zařízení používají FULL-C, pro který máme návody jinde na této WiKi.

__NOTOC__

== Existující funkce ==

Funkce poskytované zařízením první řady SDS, které používá SDS-C, jsou vypsány na této stránce.

Můžete pracovat pouze a jenom s těmi funkcemi, které jsou zde uvedeny (pro konkrétní zařízení SDS-C).

Nezapomeňte, že většina styku s okolním světem se v SDS-C provádí prostřednictvím systémových proměnných (nastavení/čtení hodnot, je to aktualizováno v reálném čase).

Poznámka. pro zařízení SDS druhé řady, které využívájí [[FULL-C: intro|FULL-C]], platí zcela jiný seznam systémových funkcí.


== Tabulka ==

Kliknutím na název funkce vás odkaz přemístí na detailnější popis použití.

Vždy zkontrolujte, jakou verzi SDS-C má vaše SDS. Pokud máte starou verzi, nebudou vám nové funkce k dispozici - řešení je jednoduché, vždy použijte [[Firmware|nejaktuálnější firmware]].

{| class="wikitable"
| style="padding: 5px;background-color:#cdcdcd;"| '''Funkce'''
| style="padding: 5px;background-color:#cdcdcd;"| '''Dostupné od verze SDS-C číslo:'''
| style="padding: 5px;background-color:#cdcdcd;"| '''Rychlý popis'''
|-
| style="padding: 5px;"|[[#Vyhrazen.C3.A9_funkce|init {...}]]
| style="padding: 5px;"|01
| style="padding: 5px;"|funkce zavolaná jen jednou po spuštění zařízení (resetu)
|-
| style="padding: 5px;"|[[#Vyhrazen.C3.A9_funkce|main {...}]]
| style="padding: 5px;"|01
| style="padding: 5px;"|funkce hlavní smyčky programu
|-
| style="padding: 5px;"|[[#Vyhrazen.C3.A9_funkce|return;]]
| style="padding: 5px;"|01
| style="padding: 5px;"|předčasné ukončení právě prováděné uživatelské funkce
|-
| style="padding: 5px;"|[[#echo.28.29|echo()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|zápis do konzole s odřádkováním
|-
| style="padding: 5px;"|[[#echoclear.28.29|echoclear()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|vymaže celý obsah konzole
|-
| style="padding: 5px;"|[[#echoinline.28.29|echoinline()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|zapís do konzole bez odřádkování
|-
| style="padding: 5px;"|[[#wait.28.29|wait()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|pozastavení činnosti programu na určenou dobu
|-
| style="padding: 5px;"|[[#sprintf.28.29|sprintf()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|zápis textu do pole 
|-
| style="padding: 5px;"|[[#textcmp.28.29|textcmp()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|porovnání textu v poli, s jiným řetězcem
|-
| style="padding: 5px;"|[[#atoi.28.29|atoi()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|převod textu na číslo
|-
| style="padding: 5px;"|[[#itoa.28.29|itoa()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|převod čísla na text (decimálně)
|-
| style="padding: 5px;"|[[#itoh.28.29|itoh()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|převod čísla na text (hex)
|-
| style="padding: 5px;"|[[#smtp_send.28.29|smtp_send()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|odešle email na zadanou adresu
|-
| style="padding: 5px;"|[[#ping.28.29|ping()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|odešle ICMP PING REQUEST
|-
| style="padding: 5px;"|[[#dns_resolv.28.29|dns_resolv()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|překlad názvu na IP
|-
| style="padding: 5px;"|[[#http_get.28.29|http_get()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|pošle požadavek HTTP GET na server
|-
| style="padding: 5px;"|[[#http_post.28.29|http_post()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|pošle požadavek HTTP POST na server
|-
| style="padding: 5px;"|[[#snmp_send_trap.28.29|snmp_send_trap()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|odeslání SNMP v1 TRAP zprávy
|-
| style="padding: 5px;"|[[#send_udp.28.29|send_udp()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|odeslání UDP paketu
|-
| style="padding: 5px;"|[[#lcd_echo.28.29|lcd_echo()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|psaní textu na LCD (pro SDS MACRO)
|-
| style="padding: 5px;"|[[#lcd_clear.28.29|lcd_clear()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|smazání LCD (pro SDS MACRO)
|-
| style="padding: 5px;"|[[#lcd_newline.28.29|lcd_newline()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|posune text na LCD o jeden řádek nahoru (pro SDS MACRO)
|-
| style="padding: 5px;"|[[#lcd_setpixel.28.29|lcd_setpixel()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|manipulace jednotlivého pixelu na LCD (pro SDS MACRO)
|-
| style="padding: 5px;"|[[#serialX_set.28.29|serial1_set()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|nastavení parametrů COM1
|-
| style="padding: 5px;"|[[#serialX_set.28.29|serial6_set()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|nastavení parametrů COM6
|-
| style="padding: 5px;"|[[#serialX_text_out.28.29|serial1_text_out()]]
| style="padding: 5px;"|01
| style="padding: 5px;"|odeslání textu na COM1
|-
| style="padding: 5px;"|[[#serialX_text_out.28.29|serial6_text_out()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|odeslání textu na COM6
|-
| style="padding: 5px;"|[[#serialX_write.28.29|serial1_write()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|odeslání surových dat na COM1
|-
| style="padding: 5px;"|[[#serialX_write.28.29|serial6_write()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|odeslání surových dat na COM6
|-
| style="padding: 5px;"|[[#read_dataflash.28.29|read_dataflash()]]
| style="padding: 5px;"|05
| style="padding: 5px;"|čte jednu proměnnou z DataFlash 
|-
| style="padding: 5px;"|[[#write_dataflash.28.29|write_dataflash()]]
| style="padding: 5px;"|05
| style="padding: 5px;"|zapíše obsah jedné proměnné do DataFlash 
|-
| style="padding: 5px;"|[[#read_dataflash_page_to_ram.28.29|read_dataflash_page_to_ram()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|přečte obsah DataFlash stránky do ram[] 
|-
| style="padding: 5px;"|[[#write_ram_block_to_dataflash_page.28.29|write_ram_block_to_dataflash_page()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|zapíše obsah ram[] do DataFlash stránky 
|-
| style="padding: 5px;"|[[#onewire_rescan.28.29|onewire_rescan()]]
| style="padding: 5px;"|06
| style="padding: 5px;"|provede rescan 1-W sběrnice 
|-
| style="padding: 5px;"|[[#sdsc_reset_program.28.29|sdsc_reset_program()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|provede znovuspuštění SDS-C programu (restart)
|-
| style="padding: 5px;"|[[#sdsc_set_wdg.28.29|sdsc_set_wdg()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|nastavení a spuštění hlídání běhu SDS-C programu
|-
| style="padding: 5px;"|[[#sdsc_kick_wdg.28.29|sdsc_kick_wdg()]]
| style="padding: 5px;"|08
| style="padding: 5px;"|pravidelné nulování odpočtu hlídače běhu SDS-C programu
|-
| style="padding: 5px;"|[[MQTT|mqtt_connect()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|připojení na MQTT Broker (server)
|-
| style="padding: 5px;"|[[MQTT|mqtt_disconnect()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|odpojení od MQTT Broker (server)
|-
| style="padding: 5px;"|[[MQTT|mqtt_publish()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|zaslání hodnoty do MQTT Broker
|-
| style="padding: 5px;"|[[MQTT|mqtt_subscribe()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|přihlášení SDS k odběru položky 
|-
| style="padding: 5px;"|[[MQTT|mqtt_unsubscribe_index()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|odhlášení SDS z odběru položky 
|-
| style="padding: 5px;"|[[MQTT|mqtt_unsubscribe_name()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|odhlášení SDS z odběru položky 
|-
| style="padding: 5px;"|[[MODBUS-TCP|modbus_tcp_connect()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|připojení k MODBUS TCP serveru
|-
| style="padding: 5px;"|[[MODBUS-TCP|modbus_tcp_disconnect()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|odpojení od MODBUS TCP serveru
|-
| style="padding: 5px;"|[[MODBUS-TCP|modbus_tcp_read()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|čtení hodnot
|-
| style="padding: 5px;"|[[MODBUS-TCP|modbus_tcp_writesingle()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|zápis jedné hodnoty
|-
| style="padding: 5px;"|[[MODBUS-TCP|modbus_tcp_writemultiple()]]
| style="padding: 5px;"|09
| style="padding: 5px;"|zápis více hodnot
|}


== Vyhrazené funkce ==

{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">init { ... }</syntaxhighlight>
| style="padding: 5px;"| funkce (dobrovolně/volitelně použitá programátorem), která se provede jen jednou, právě po zapnutí zařízení (resetu)
|-
| style="padding: 5px;"| <syntaxhighlight lang="c">main { ... }</syntaxhighlight>
| style="padding: 5px;"| funkce (musí být definován její obsah), provádí se stále bezodkladně dokola (ale typicky má programátor svou vlastní vnitřní smyčku uvnitř, takže nikdy z main() "neodejde")
|-
| style="padding: 5px;"| <syntaxhighlight lang="c">return;</syntaxhighlight>
| style="padding: 5px;"| předčasné ukončení právě prováděné uživatelské funkce (návrat)
|-
|}

Využití '''init''': tato funkce je zavolána jen jednou pro spuštění programu (tj. po resetu zařízení SDS nebo po nahrání nového programu).
<syntaxhighlight lang="c">
init
{
  echo('Jsem ve funkci init.');
  // sem dejte to, co chcete, aby se provedlo jednou po restartu zařízení
}
</syntaxhighlight>


Využití '''main''': tato funkce je zavolána jako první (ale až po funkci '''init''' je-li funkce init použita) ze všech funkcí v programu. Jakmile se provedou všechny příkazy zapsané ve funkci '''main''', je tato funkce spuštěna znovu (a znovu...). Samozřejmě opakovanému volání se lze vyhnout, pokud funkci správně naprogramujete.
<syntaxhighlight lang="c">
main
{
  echo('Jsem ve funkci main.');

nekonecna_smycka:
  goto nekonecna_smycka;
}
</syntaxhighlight>


Využití '''return''': tento příkaz předčasně ukončí provádění funkce, ve které je zapsán a právě proveden.
<syntaxhighlight lang="c">
funkce
{
  echo('Pred return');

  return; // ukončení funkce hned v tento moment

  echo('Toto se nikdy neprovede');
}

main
{
  echo('Jsem ve funkci main.');

  funkce();

nekonecna_smycka:
  goto nekonecna_smycka;
}
</syntaxhighlight>


== Jednotné funkce pro SDS-C ==

Všechny vlastní systémové funkce SDS-C mají vždy '''minimálně jeden parametr'''. 

Pokud zavoláte (obvykle omylem) interní funkci bez parametru, např. jen '''echo()''', tak samozřejmě nebude cokoliv vykonáno pro konkrétní zavolání této funkce.

Pozor - uživatelem definované funkce naopak '''parametry nemají''', takže vaše vlastní funkce si volejte bez parametrů, např. '''moje()''' je správně.


----
==== echo() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">echo()</syntaxhighlight>
| style="padding: 5px;"| zapíše text na konzoli (zobrazena na webové stránce) a odřádkuje, užitečné pro ladění programu nebo pro průběžné sledování stavu
|-
|}

Funkce '''echo()''' v podstatě odpovídá funkci '''printf()''', s tím, že funkce '''echo()''' na konec vypsaného textu vždy umístí znak pro nový řádek. Takže každé zavolání '''echo()''' odřádkuje text v konzolovém výpisu.

<syntaxhighlight lang="c">
 echo('Hello !');
</syntaxhighlight>

<syntaxhighlight lang="c">
 //
 echo('Teplota je ',sys[310],' degC ...');

 //
 echo('String je ',text[123]);

 //
 echo('Sdílený text je ',share[0]);

 //
 echo('Parametry jsou ',a,' potom ',b,' a nakonec teplota ',sys[310],' degC.');
</syntaxhighlight>

Každé zavolání funkce '''echo()''' vloží text do konzole, a současně jej odřádkuje. Konzole je přístupná přes webové rozhraní, popř. přes speciální webovou stránku (web-snippet - viz: echo.htm), na které je čistě jen výpis konzole. Odřádkování používá HTML tag "br".


----
==== echoinline() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">echoinline()</syntaxhighlight>
| style="padding: 5px;"| zapíše text na konzoli '''bez odřádkování'''
|-
|}

Funkčně shodné s funkcí '''echo()'''. Neprovede však odřádkování (posun pozice v konzoli na nový řádek).

<syntaxhighlight lang="c">
 echoinline('Hello !');
</syntaxhighlight>

<syntaxhighlight lang="c">
 echoinline('Teplota je ',sys[310],' °C ...');

 // atd.: stejný princip zpracování parametrů jako u echo()
</syntaxhighlight>


----
==== echoclear() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">echoclear()</syntaxhighlight>
| style="padding: 5px;"| vymaže celý obsah konzole (viz echo(), ...)
|-
|}

<syntaxhighlight lang="c">
 echoclear(0);
</syntaxhighlight>

Cokoliv co bylo dosud zapsáno na konzoli je smazáno. Samozřejmě lze dále znovu zapisovat pomocí funkce '''echo(...)'''.

Jako parametr můžete uvést jakékoliv číslo, nemá to v současné verzi firmware vliv (v budoucnu ale může být parametru přiřazen nějaký význam, takže tam raději pište nulu pro budoucí kompatibilitu).


----
==== smtp_send() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">smtp_send()</syntaxhighlight>
| style="padding: 5px;"| odešle email na zadanou adresu, s daným ''subject''em (nadpis zprávy), obsahem je pak zbytek (tzv. multi-text)
|-
|}

<syntaxhighlight lang="c">
 smtp_send('adresa','subject', 'multi-text');
</syntaxhighlight>

<syntaxhighlight lang="c">
 smtp_send('joe@foo.com', 'alarm', 'Teplota cidla ',cidlo,' prekrocila 35 stupnu ! Aktualne to je ',teplota);
</syntaxhighlight>

Odřádkování provedete pomocí zapsání '''\n'''. Toto lze vložit kamkoli do textu, i vícekrát. Příklad:
<syntaxhighlight lang="c">
 smtp_send('joe@foo.com', 'alarm', 'Toto je první řádek.\nToto je druhý řádek.');

 VE VÝSLEDKU (obsah zprávy emailu):
  Toto je první řádek.
  Toto je druhý řádek.
</syntaxhighlight>

Nezapomeňte, že je potřeba mít správně nastavený [[SMTP]] server (jeho IP adresu) v administraci (webové rozhraní), a současně zvolený SMTP server musí podporovat komunikaci se zařízením SDS.

SDS-C: maximální délka textového obsahu zprávy je 1024 znaků !!! Detaily viz [[SMTP]].

Poznámka: po zavolaní '''smtp_send()''' se začne email odesílat, avšak program v SDS-C ihned pokračuje - nečeká se na dokončení zavolané funkce! Proto je vhodné, po zavolání funkce, mít v programu testovací smyčku, která počká na výsledek (podle hodnoty chybového hlášení OSI7 - viz seznam systémových proměnných).


----
==== ping() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">ping()</syntaxhighlight>
| style="padding: 5px;"| odešle ICMP PING REQUEST na zadané IP
|-
|}

<syntaxhighlight lang="c">
 ping(ip[0],ip[1],ip[2],ip[3],ping_sequence);
</syntaxhighlight>
 
<syntaxhighlight lang="c">
 ping(192,168,1,1,1234);
</syntaxhighlight>

Funkce po svém zavolání nuluje výsledkové proměnné, pošle ICMP PING REQUEST a nečeká - hned se vrací, aby mohl program pokračovat. Výsledek (povedlo-li se odeslat nebo ne) je uložen do příslušných systémových proměnných. Až v okamžiku příjmu odpovídajícího ICMP PING RESPONSE (ECHO) je spočítán RTT a tato hodnota je uložena do sys[94], včetně aktualizace stavu funkce v sys[92]. To že se jedná o odpovídající RESPONSE pozná zařízení tak, že porovná SEQUENCE ID v přijatém paketu odpovědi s posledním odeslaným SEQUENCE ID pomocí funkce ping(), a současně se musí jednat o stejnou IP adresu odesílatele odpovědi s IP adresou v odeslaném REQUESTu.

Použijte ''ping_sequence'' pro odlišení vašeho ICMP PING REQUEST paketu od jiných ICMP PING REQUEST paketů (např. od integrovaného IP watchdogu). Typicky, ''ping_sequence'' je potřeba po každém odeslání inkrementovat (nebo jinak změnit) ! Bez ''ping_sequence'' by nebylo pro program možné rozeznat odpovědi na více najednou odeslaných PING REQUESTů.

Pozor! Funkce '''ping()''' je k dispozici až teprve ve verzi SDS-C č. '''04'''.


----
==== dns_resolv() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">dns_resolv()</syntaxhighlight>
| style="padding: 5px;"| provede požadavek na DNS server o překlad názvu domény (text) na IP adresu
|-
|}

<syntaxhighlight lang="c">
 dns_resolv('www.onlinetechnology.cz')
</syntaxhighlight>

Příklad:

<syntaxhighlight lang="c">
 dns_resolv('www.onlinetechnology.cz');
 
 //pockam az se funkce spusti
label cekam_na_dns_1:
 if (sys[65] == 0) goto cekam_na_dns_1; 

 //nastavime cas, po ktery jsme ochotni cekat
 sys[64] = 15; // 15 seconds

 //jeste pracuje?
label cekam_na_dns_2:

 //vyprsel cas po ktery jsme cekali?
 if (sys[64] == 0) goto dns_chyba;

 //test - pracuje jeste?
 if (sys[65] == 514) goto cekam_na_dns_2;

 //test - byla chyba?
 if (sys[65] == 513)
 {
label dns_chyba:
   echo('Chyba pri DNS prekladu. Nemam vysledek.');
   goto preskocit;
 }

 //mame vysledek?
 if (sys[65] == 512)
 {
  //ok, neni chyba!
  //mame vysledek:
  echo('DNS preklad: status=',sys[65],'  IP=',sys[66],'.',sys[67],'.',sys[68],'.',sys[69]);
 } 
 
 label preskocit:
</syntaxhighlight>

Nezapomeňte, že je potřeba mít nastavenou adresu DNS serveru v administraci (webové rozhraní).

Poznámka - po zavolání této funkce není program zastaven (nečeká na ukončení funkce), funkce DNS překladu běží tzv. "na pozadí" (to proto, že to může trvat i velmi dlouho), a díky tomu je možné po dobu čekání na dokončení DNS překladu vykonávat jinou programovou činnost.

Je velmi doporučeno si ověřit v praxi, jak se ve vaší sítí bude tato funkce chovat, ideálně pomocí vlastního testovacího programu (provádět dns_resolv() a vypisovat průběh a výsledky do konzole).


----
==== wait() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">wait()</syntaxhighlight>
| style="padding: 5px;"| pozastavení činnosti programu na určenou dobu v milisekundách
|-
|}

<syntaxhighlight lang="c">
 wait(100);
</syntaxhighlight>

Příklad: počká 100 msec. Po nastavenou dobu je program zablokován. Pokud provádíte čekání, je vždy lepší využít smyčku a odečítat proměnnou (při znalosti že jedna celá instrukce trvá asi 1 msec), než používat ''wait()'', jde o to, že tak v době čekání může program v té smyčce dělat ještě něco jiného.


----
==== http_get() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">http_get()</syntaxhighlight>
| style="padding: 5px;"| pošle požadavek (jako klient) na vzdálený HTTP server (HTTP GET)
|-
|}

Tato funkce má dva cíle: kontrolu funkčnosti webových serverů a možnost odesílat data na webový server.

'''INFORMACE''' - vzhledem k rozsáhlosti návodu je pro HTTP GET funkci samostatná stránka zde: [[HTTP_Klient:_První_Produktová_Řada]].

Tuto funkci lze využít jak k připojení k webovým serverům v Internetu atd., tak také se lze připojit k jinému SDS za účelem [[SDS-C: sharing|vzdálené změny proměnných]], popř. čtení hodnot těchto vzdálených proměnných.


----
==== http_post() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">http_post()</syntaxhighlight>
| style="padding: 5px;"| pošle požadavek (jako klient) na vzdálený HTTP server (HTTP POST)
|-
|}

Tato funkce má dva cíle: kontrolu funkčnosti webových serverů a možnost odesílat data na webový server.

'''INFORMACE''' - vzhledem k rozsáhlosti návodu je pro HTTP POST funkci samostatná stránka zde: [[HTTP_Klient:_První_Produktová_Řada]].


----
==== lcd_echo() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">lcd_echo()</syntaxhighlight>
| style="padding: 5px;"| psaní textu na LCD (použitelné pro zařízení SDS MACRO)
|-
|}

Máte-li SDS MACRO vybavené doplňkovým modulem (interním) s displayem (LCD), můžete na tento display psát libovolné texty, pomocí funkce '''lcd_echo()'''.

Display je provozován v režimu čtyři řádky po 22 znaků.

<syntaxhighlight lang="c">
 lcd_echo(POZICE_NA_ŘÁDKU, ŘÁDEK, BARVA, ...text...);
</syntaxhighlight>

Funkce se používá shodně jako '''echo()''', ovšem je zde potřeba určit, na který ze dvou řádků se má daný výstup zapsat - a proto je potřeba hned první parametr při volání této funkce použít pro určení řádku. Druhý parametr je vyhrazen pro určení barvy, pro aktuální použitý display můžete zvolit:

* neinvertovaná barva - číslo 0
* invertovaná barva - číslo 1

určení pozice na řádku:

* číslo 1 až 22

a pro určení řádku:

* první řádek (a bude nejprve smazán) - číslo 1
* druhý řádek (a bude nejprve smazán) - číslo 2
* třetí řádek (a bude nejprve smazán) - číslo 3
* čtvrtý řádek (a bude nejprve smazán) - číslo 4
* první řádek (nebude smazán) - číslo 100
* druhý řádek (nebude smazán) - číslo 200
* třetí řádek (nebude smazán) - číslo 300
* čtvrtý řádek (nebude smazán) - číslo 400

Pokud chcete zapsat více než 16 znaků, budou nadbytečné znaky zahozeny (nedojde k přepsání dalšího řádku). Zápis probíhá vždy od levého kraje řádku. Také si můžete vybrat, zda-li chcete celý řádek před novým zápisem smazat nebo ne.

Příklad zápisu do prvního řádku na první pozici z kraje, včetné předcházejícího smazání, neinvertované barvy:
<syntaxhighlight lang="c">
 lcd_echo(1, 1, 0, 'text', 'a dalsi');
</syntaxhighlight>

Příklad zápisu do třetího řádku bez předchozího smazání řádku, od desáté pozice zleva, invertované barvy:
<syntaxhighlight lang="c">
 lcd_echo(10, 300, 1, 'Teplota je ',sys[310]);
</syntaxhighlight>

Pozor! Při jakékoliv změně obsahu LCD (byť zápis jediného znaku) je celý display aktualizován - nedojde ke ztrátě předchozích zápisů, ale je potřeba zvážit případné zdržení (příklad: např. při zápisu po jednotlivých znacích (mnoho volání '''lcd_echo()''' ) bude mnohem déle trvat celá akce, než jediné zavolání '''lcd_echo()''' s celým textem).


----
==== lcd_clear() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">lcd_clear()</syntaxhighlight>
| style="padding: 5px;"| smazání LCD (použitelné pro zařízení SDS MACRO)
|-
|}

Funkce má jediný parametr, a to určení řádku. Po zavolání se celý daný řádek vymaže. Nedojde ke změně na ostatních řádcích.

* celý LCD - číslo 0
* první řádek - číslo 1
* druhý řádek - číslo 2
* třetí řádek - číslo 3
* čtvrtý řádek - číslo 4

Příklad smazání celého prvního řádku:
<syntaxhighlight lang="c">
 lcd_clear(1);
</syntaxhighlight>


----
==== lcd_newline() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">lcd_newline()</syntaxhighlight>
| style="padding: 5px;"| posune text na LCD o jeden řádek nahoru (použitelné pro zařízení SDS MACRO)
|-
|}

Funkce nemá parametr. Vhodné pro emulaci vzhledu konzolového výpisu.

Po zavolání funkce je text každého řádku přesunut o jeden řádek výše. Původní obsah nejvyššího řádku se ztrácí.

Příklad použití:
<syntaxhighlight lang="c">
 lcd_newline(0);
</syntaxhighlight>

Paramtery: vždy uveďte číslo 0. V budoucí verzi se totiž význam hodnoty parametru může změnit (nové funkce).


----
==== lcd_setpixel() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">lcd_setpixel()</syntaxhighlight>
| style="padding: 5px;"| vykreslení nebo smazání jednoho pixelu na LCD (použitelné pro zařízení SDS MACRO)
|-
|}

Tato funkce je podporována ve firmware SDS MACRO od verze 3.10.2013, dřívější verzi nemají podporu pro manipulaci s jednotlivými pixely na LCD (k dispozici byla podpora pouze pro výpisy textů).

Funkce má tři parametry:

* (první parametr) souřadnice X
* (druhý parametr) souřadnice Y
* (poslední parametr) operace

"Operace" má tyto dvě sady tří povolených hodnoty:

*  0 = pixel je smazán (nesvítí), display je okamžitě překreslen z bufferu
*  1 = pixel je aktivní (svítí), display je okamžitě překreslen z bufferu
* -1 = pixel je invertován (pokud svítil, nebude, a naopak), display je okamžitě překreslen z bufferu

*  10 = pixel je smazán (nesvítí), změna je provedena jen v bufferu
*  11 = pixel je aktivní (svítí), změna je provedena jen v bufferu
* -11 = pixel je invertován (pokud svítil, nebude, a naopak), změna je provedena jen v bufferu

Při použití kreslení a následného okamžitého překlopení na LCD, je v důsledku dlouhotrvajícího překreslení (přenos bufferu z RAM do LCD) celý program značně zpomalen. Pokud se kreslí jeden pixel, není to problém. Pokud chcete kreslit více pixelů (např. nějaký graf), pak nemá význam po každém změněném pixelu přenášet celý buffer do LCD - stačí to totiž udělat až nakonec, při kreslení posledního pixelu z celé řady. Toto celé se dá provést vhodnou kombinací hodnot "operace" při volání funkce.

Příklad použití:
<syntaxhighlight lang="c">
 //--- ZMENY SE IHNED PROJEVI NA LCD:

 // nastav pixel na [10,20] a ihned aktualizuj cele LCD
 lcd_setpixel(10,20,1);

 // smaz pixel na [11,21] a ihned aktualizuj cele LCD
 lcd_setpixel(11,21,0);

 // invertuj pixel na [10,20] a ihned aktualizuj cele LCD
 lcd_setpixel(10,20,-1);

 //--- Pokracovani prikladu:
 //--- ZMENY SE ZAPISI JEN DO BUFFERU:

 // nastav pixel na [10,20] (zmena jen v bufferu, LCD neni aktualizovano)
 lcd_setpixel(10,20,11);

 // smaz pixel na [11,21] (zmena jen v bufferu, LCD neni aktualizovano)
 lcd_setpixel(11,21,10);

 //--- nakonec potrebujeme prekreslit buffer na LCD

 // invertuj pixel na [10,20] a ihned aktualizuj cele LCD (udela zmenu a pak prenese cely buffer)
 lcd_setpixel(10,20,-1);
</syntaxhighlight>


----
==== serialX_set() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">serial_set()</syntaxhighlight>
| style="padding: 5px;"| <syntaxhighlight lang="c">serial1_set()</syntaxhighlight>
| style="padding: 5px;"| <syntaxhighlight lang="c">serial6_set()</syntaxhighlight>
| style="padding: 5px;"| změna parametrů sériové linky (COM1, COM6)
|-
|}

Funkce má pevný počet parametrů, všechny je potřeba vždy vyplnit.

Tato funkce změní konfiguraci sériové linky. Protože sériová linka je využívána společně s převodníkem Ethernet/Serial, a to současně, je potřeba počítat s tím, že pokud se někdo k převodníku Eth/Serial připojí a pomocí RFC změní konfiguraci sériové linky, nebude už platit to co bylo předtím nastaveno zavoláním této funkce.

Parametry: - pozor, mohou mít různý význam dle typu SDS:
* rychlost v bps (1bps až 1Mbps+)
* počet datových bitů (LM: 8, 7, 6, 5) (ST: 8, 9)
* počet stop bitů (LM: 1, 2) (ST: 1, 2)
* počet a typ paritních bitů (LM: 0, 1, 2, 3, 4, 5) (ST: (0), 1, 2, 3) 

Význam nastavení paritních bitů - '''VARIANTA SDS (LM)'''
* 0 = bez parity
* 1 = bez parity
* 2 = 1 paritní bit, ODD (hodnota bitu určena z předchozích dat)
* 3 = 1 paritní bit, EVEN (hodnota bitu určena z předchozích dat)
* 4 = 1 paritní bit, MARK (bit drží hodnotu)
* 5 = 1 paritní bit, SPACE (bit drží hodnotu)

Význam nastavení paritních bitů - '''VARIANTA SDS (ST)'''
* 0 = bez parity (použijte 1)
* 1 = bez parity 
* 2 = 1 paritní bit, ODD (hodnota bitu určena z předchozích dat) - POZOR, POČET DATOVÝCH BITŮ MUSÍ BÝT DÁN NA 9
* 3 = 1 paritní bit, EVEN (hodnota bitu určena z předchozích dat) - POZOR, POČET DATOVÝCH BITŮ MUSÍ BÝT DÁN NA 9


Příklad nastavení 9600 bps, 8 datových bitů, 1 stop bit, žádná parita, pro výrobky SDS typu (LM):
<syntaxhighlight lang="c">
 // SDS-C starší než verze 08 (tedy verze 01 až 07 včetně, ale už ne 08):
 // -> nastavení vždy jen pro COM1
 serial_set(9600, 8, 1, 0);
</syntaxhighlight>

<syntaxhighlight lang="c">
 // SDS-C verze 08 (včetně) a novější:
 
 // -> nastavení pro COM1
 serial1_set(9600, 8, 1, 0);
 
 // -> nastavení pro COM6
 serial6_set(9600, 8, 1, 0);
</syntaxhighlight>

Příklad nastavení 38400 bps, 8 datových bitů, 1 stop bit, even parita, pro výrobky SDS typu (LM):
<syntaxhighlight lang="c">
 // SDS-C verze 08 (včetně) a novější:
 serial1_set(38400, 9, 1, 3);
</syntaxhighlight>

'''Pozor:''' původní funkce ''serial_set()'' je od verze SDS-C 08 nahrazena novými funkcemi (''serial1_set()'' a ''serial6_set()''). Pro zpětnou kompatibilitu je původní funkce ''serial_set()'' zachována tak, že její zavolání odpovídá zavolání funkce ''serial1_set()''.


----
==== serialX_write() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">serial_write()</syntaxhighlight>
| style="padding: 5px;"| <syntaxhighlight lang="c">serial1_write()</syntaxhighlight>
| style="padding: 5px;"| <syntaxhighlight lang="c">serial6_write()</syntaxhighlight>
| style="padding: 5px;"| odeslání řetězce bajtů na sériovou linku (COM1, COM6)
|-
|}

Funkce odešle určený obsah pole ''ram[]'' nebo ''text[]'' na sérivou linku. Konfigurace sériové linky se provádí jiným příkazem, '''serial_set()'''.

Podle parametrů předadných této funkci dojde k odvysílání bajtů z určeného pole. Každý bajt v poli je předán na sérivou linku, '''bez jakýchkoliv změn''' (oproti chování serial_text_out, viz dále).

Tuto funkci využijete jako alternativu k '''serial_text_out()''', která má specifické chování.

Funkce '''serial_write()''' odesílá přesně stanovený počet bajtů, bez ohledu na jejich obsah (nezastaví se na 0x00 a tak dále).


Parametry funkce:
<syntaxhighlight lang="c">
 serial_write(ArrayType, StartIndex, NumOfBytes);
</syntaxhighlight>

* ''ArrayType'' = výběr text[] nebo ram[] nebo share[]
* ''StartIndex'' = počáteční index v poli (odsud, včetně tohoto indexu, se začnou brát data)
* ''NumOfBytes'' = počet bajtů k odeslání (vždy bude odeslán přesně tento počet bajtů, ať už mají jakýkoliv obsah)


Hodnota ''ArrayType'':
* 0 == pole '''text[]'''
* 1 == pole '''ram[]'''
* 2 == pole '''share[]'''

Při překročení maximální délky pole dojde k automatickému zaříznutí po poslední položce v poli, a dále už se nebude vysílat.

Přiklad:
<syntaxhighlight lang="c">
 // vyplníme náhodne bajty
 text[10] = 0x12;
 text[11] = 0x24;
 text[12] = 0x00;
 text[13] = 0x63;
 text[14] = 0xAB;

 // odešli bajty z pole text[10] až text[(10+5)-1] na COM1
 // (příklad pro SDS-C verze 01 až 07)
 serial_write(0, 10, 5);

 // pro tento příkald jsou odeslány tyto bajty: 0x12 0x24 0x00 0x63 0xAB

 // (příklad pro SDS-C verze 08 (včetně) a novější)
 serial1_write(0, 10, 5); // zápis do COM1
 serial6_write(0, 10, 5); // zápis do COM6

</syntaxhighlight>

'''Pozor:''' původní funkce ''serial_write()'' je od verze SDS-C 08 nahrazena novými funkcemi (''serial1_write()'' a ''serial6_write()''). Pro zpětnou kompatibilitu je původní funkce ''serial_write()'' zachována tak, že její zavolání odpovídá zavolání funkce ''serial1_write()''.


----
==== serialX_text_out() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">serial_text_out()</syntaxhighlight>
| style="padding: 5px;"| <syntaxhighlight lang="c">serial1_text_out()</syntaxhighlight>
| style="padding: 5px;"| <syntaxhighlight lang="c">serial6_text_out()</syntaxhighlight>
| style="padding: 5px;"| odeslání řetězce znaků na sériovou linku (COM1, COM6)
|-
|}

Funkce odešle všechny své parametry na sériovou linku. Konfigurace sériové linky se provádí jiným příkazem, '''serial_set()'''.

Celkem je možno na jedno volání této funkce odeslat až 1024 znaků.

Příklad odeslání textu (lze kombinovat více parametrů):
<syntaxhighlight lang="c">
 // Tento příklad odešle následující znaky: 0x2a 0x42 0x31 0x4f 0x53 0x32 0x48 (tj. text *B1OS2H)
 serial_text_out('*B1', 'OS', '2H');
</syntaxhighlight>

Funkčně identický k předchozímu příkladu je následující příklad (aby šlo vidět, že lze poslat i delší texty):
<syntaxhighlight lang="c">
 //  // Tento příklad odešle následující znaky: 0x2a 0x42 0x31 0x4f 0x53 0x32 0x48 (tj. text *B1OS2H)
 serial_text_out('*B1OS2H');
</syntaxhighlight>

Samozřejmě lze odeslat text a '''hodnotu proměnné, která se převede na text !'''

<syntaxhighlight lang="c">
 // Tento příklad odešle následující znaky: A B C D 1 3 (tj. text ABCD13)
 serial_text_out('ABCD', 0x0D);
</syntaxhighlight>

'''POZOR!''' častým omylem je zápis číselné hodnoty, která se však u této funkce nepřenese na sériovou linku, ale '''nejprve se převede na text''' (tedy číslo 123 na text '123' - bez uvozovek samozřejmě) '''a teprve tento text''' se odešle na sériovou linku.

Příklad zpracování proměnné:
<syntaxhighlight lang="c">
 var i;

 i = 1234;

 // Tento příklad odešle následující text: 'hodnota i = 1234', tj. v hexa: 0x68 0x6f 0x64 0x6e 0x6f 0x74 0x61 0x20 0x69 0x20 0x3d 0x20 0x31 0x32 0x33 0x34

 // varianta pro SDS-C verze 01 až 07 (včetně)
 serial_text_out('hodnota i = ', i);

 // varianta pro SDS-C verze 08 (včetně) a novější
 serial1_text_out('hodnota i = ', i); // zápis do COM1
 serial6_text_out('hodnota i = ', i); // zápis do COM6

</syntaxhighlight>

'''Informace''': 
Častým požadavkem je odesílání nejen textu, ale i "řídících znaků" jako je CR, LF, nebo přímo bajtová data (chci odeslat na sérivou linku hodnotu 0x0A 0x0D, tedy 10dec a 13dec). Takový úkol se nedá efektivně řešit touto funkcí (jestli vůbec), ale je perfektně realizovatelný funkcí '''serialX_write()'''.


S výhodou můžete využít simulátor SDS-C, který vypisuje výstup funkce serial_text_out() jak v hexa hodnotách, tak jako jednotlivé znaky - což je výhodné pro kontrolu co se skutečně v zařízení odesílá.

''Poznámka:'' příjem ze strany sériové linky do zařízení je k dispozici pouze pro verzi SDS-C č. 04 a novější. Data jsou po příjmu z UARTu ukládána do bufferu, a ve správném pořadí je možno je číst (vyjmout z bufferu a použít v programu), a to pomocí čtení hodnoty příslušné systémové proměnné (viz popis systémových proměnných). SDS-C program tak má plnohodnotný přístup k sériové lince zařízení.

'''Pozor:''' původní funkce ''serial_text_out()'' je od verze SDS-C 08 nahrazena novými funkcemi (''serial1_text_out()'' a ''serial6_text_out()''). Pro zpětnou kompatibilitu je původní funkce ''serial_text_out()'' zachována tak, že její zavolání odpovídá zavolání funkce ''serial1_text_out()''.


----

==== read_dataflash() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">read_dataflash()</syntaxhighlight>
| style="padding: 5px;"| čte jednu proměnnou z DataFlash
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 05 a novější.

Detailní popis je dostpný na [[SDS-C: DataFlash|tomto odkaze]].


----
==== write_dataflash() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">write_dataflash()</syntaxhighlight>
| style="padding: 5px;"| zapíše obsah jedné proměnné do DataFlash
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 05 a novější.

Detailní popis je dostpný na [[SDS-C: DataFlash|tomto odkaze]].


----
==== read_dataflash_page_to_ram() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">read_dataflash_page_to_ram()</syntaxhighlight>
| style="padding: 5px;"| přečte obsah DataFlash stránky do ram[]
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 06 a novější.

Detailní popis je dostpný na [[SDS-C: DataFlash|tomto odkaze]].


----
==== write_ram_block_to_dataflash_page() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">write_ram_block_to_dataflash_page()</syntaxhighlight>
| style="padding: 5px;"| zapíše obsah ram[] do DataFlash stránky
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 06 a novější.

Detailní popis je dostpný na [[SDS-C: DataFlash|tomto odkaze]].


----
==== atoi() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">atoi()</syntaxhighlight>
| style="padding: 5px;"| převod textu (z pole text[]) na proměnnou (číselnou hodnotu)
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 06 a novější.

Funkce převede vybraný text uložený v poli '''text[]''' (nebo '''share[]''') do uvedené proměnné.

<syntaxhighlight lang="c">
 var i;
 
 text[0] = '1'; text[1] = '2'; text[2] = '3'; text[3] = 0;

 atoi(text[0]); // převede z pole text[] z indexu 0 do sys[62]

 i = sys[62]; // výsledek je totiž vždy uložen do sys[62]

 echo(i); // vypíše: 123   pozn. ano, mohli by jsme zde napsat echo(sys[62]) se stejným výsledkem
</syntaxhighlight>

Význam parametrů funkce:
<syntaxhighlight lang="c">
 // vstup z pole text[]
 atoi(text[počáteční_index]);

 // vstup z pole share[]
 atoi(share[počáteční_index]);
</syntaxhighlight>

Funkce '''atoi()''' přebírá znaky od určeného indexu pole '''text[]''' (popř. '''share[]''') tak dlouho, dokud nenarazí na hodnotu 0 uloženou v jednom z následujících indexů vstupního pole. Následně se pokusí celý tento vybraný řetězec převést na číslo, které se zapíše do '''sys[62]'''. Pokud to není možné (jsou tam nečíselné znaky, např. písmena), je proces převodu přerušen a hodnota v sys[62] '''není změněna''' (zůstane tam původní hodnota).


----
==== itoa() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">itoa()</syntaxhighlight>
| style="padding: 5px;"| převod číselné proměnné na text (do pole text[]) - desítková soustava
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 08 a novější.

Funkce převede hodnotu ve vybrané proměnné, do textového formátu - zapíše text na určené místu v poli '''text[]''' (včetně zakočení znakem 0x00).

Funkce zapisuje vždy a pouze jenom do pole text[] - nelze zde chtít zápis do pole share[].

<syntaxhighlight lang="c">
 var i;

 // vstupní číselná hodnota  
 i = 1234;

 // převod obsahu "i" na řetězec do pole text na pozici [32]
 itoa(i, 32);

 echo(text[32]); // vypíše text: 1234

 // nebo také takto
 itoa(1234, 32);

 // nebo také takto
 var pozice;
 pozice = 32;
 itoa(1234, pozice);
 
</syntaxhighlight>

Význam parametrů funkce:
<syntaxhighlight lang="c">
 itoa(proměnná_k_převodu, počáteční_index_do_pole_text);
</syntaxhighlight>

Funkce '''itoa()''' zapisuje na konec převodu znak 0x00. Takže pokud převádí hodnotu 1234, tak zapíše 5 znaků do pole text - a to '1' '2' '3' '4' a 0x00. 

Na konec textu je vždy zapsán terminační znak 0x00. Na pozici (index) kam je 0x00 do pole text[] zapsána, ukazuje číslo v sys[98] - snadno lze tak navázat další text od této pozice.
Vždy využívejte údaje ze sys[98], nespoléhejte se na vlastní odhad délky zapsaného textu.


----
==== itoh() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">itoh()</syntaxhighlight>
| style="padding: 5px;"| převod číselné proměnné na text (do pole text[]) - výstup v hex (šestnáctková soustava)
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 08 a novější.

Funkce převede hodnotu ve vybrané proměnné, do textového formátu (hex) - zapíše text na určené místu v poli '''text[]''' (včetně zakočení znakem 0x00).

Funkce zapisuje vždy a pouze jenom do pole text[] - nelze zde chtít zápis do pole share[].

<syntaxhighlight lang="c">
 var i;

 // vstupní číselná hodnota  
 i = 1234;

 // převod obsahu "i" na řetězec do pole text na pozici [32], textový výstup zarovnat zleva nulami na čtyři místa
 itoh(i, 32, 4);

 echo(text[32]); // vypíše text: 04D2

 // nebo také takto
 itoh(1234, 32, 4);

 // nebo také takto
 var pozice;
 pozice = 32;
 itoh(1234, pozice, 4);
 
</syntaxhighlight>

Význam parametrů funkce:
<syntaxhighlight lang="c">
 itoh(proměnná_k_převodu, počáteční_index_do_pole_text, celkové_zarovnání_zleva);
</syntaxhighlight>

Funkce '''itoh()''' zapisuje na konec převodu znak 0x00. Takže pokud převádí hodnotu 1234 se zarovnáním výstupu 4, tak zapíše 5 znaků do pole text - a to '0' '4' 'D' '2' a 0x00. 

Pokud bude potřebný zápis delší než je hodnota ''celkové_zarovnání_zleva'', tak bude text zapsán celý (jinak řečeno: nebude ořezán).
Hodnota ''celkové_zarovnání_zleva'' tedy určuje požadovanou minimální délku (a do té se zarovnává zleva znakem '0'), nikoliv omezení na maximální délku.
Především u záporných čísel se může snadno stát, že bude zapsáno rovnou osm znaků (plus navíc terminační 0x00, takže devět).

Na konec textu je vždy zapsán terminační znak 0x00. Na pozici (index) kam je 0x00 do pole text[] zapsána, ukazuje číslo v sys[98] - snadno lze tak navázat další text od této pozice.
Vždy využívejte údaje ze sys[98], nespoléhejte se na vlastní odhad délky zapsaného textu.


----
==== sprintf() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">sprintf()</syntaxhighlight>
| style="padding: 5px;"| zápis do pole text[]
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 06 a novější.

Funkce je určena pro vyplnění (zápis textu do) pole '''text[]''', popřípadě do pole '''share[]'''. A to od určeného indexu. Pole '''text[]''' nebo '''share[]''', se totiž dá ručně vyplňovat jen po jednotlivých položkách (jeden znak), takže když chcete zapsat delší řetězec, je vhodné použít právé funkci '''sprintf()'''.

Příklad:
<syntaxhighlight lang="c">
 //
 sprintf(text[0], 'Teplota je ', sys[310],' stupňů.');

 //
 sprintf(share[10], 'Něco jiného.');
</syntaxhighlight>

Parametry se zadávají stejně jako u funkce '''echo()'''.

Hodnota v sys[98] určuje, kde je poslední zapsaný znak (0x00) při posledním provedení funkce '''sprintf'''. Toho lze využít pro navázání více následných volání funkce '''sprintf''' pro zápis textů přesně za sebou, bez ohledu na různou délku těchto textů. Hodnota se do sys[98] zapíše vždy (bez ohledu na vybrané pole, do kterého se provádí zápis).

Příklad:
<syntaxhighlight lang="c">
 var posledni_znak;
 sprintf(text[0], 'AbcdEfgh');
 // text[] = 'AbcdEfgh'0
 posledni_znak = sys[98];
 sprintf(text[posledni_znak], 'IjklMnop');
 // text[] = 'AbcdEfghIjklMnop'0
</syntaxhighlight>


----
==== textcmp() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">textcmp()</syntaxhighlight>
| style="padding: 5px;"| Porovnání textu v poli, s jiným řetězcem.
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 08 a novější.

Vstupem jsou vždy dva parametry - určení pole (spolu s indexem odkud se bude porovnávat), a druhého pevného řetězce (vždy jako text v kódu programu, nikoliv jiné pole !).

Příklad:
<syntaxhighlight lang="c">
 // příklad: porovnej obsah text[] od indexu [0] s textem 'mac_tx_ok'
 textcmp(text[0], 'mac_tx_ok');

 // zobraz výsledek porovnání
 echo(sys[98]); 
</syntaxhighlight>

Příklad:
<syntaxhighlight lang="c">
 // příklad: porovnej obsah share[] od indexu [99] s textem 'porovnani'
 textcmp(share[99], 'porovnani');

 // zobraz výsledek 
 echo(sys[98]); 
</syntaxhighlight>

Hodnota v sys[98] určuje výsledek porovnání. Pozor, sys[98] je sdílená pozice pro více různých funkcí.

Pokud jsou řetězce stejné, výsledek do sys[98] je zapsán jako nula (0). Pokud jsou jiné, je výsledek nenulový. Přesný význam viz popis sys[98].


----

==== snmp_send_trap() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">snmp_send_trap()</syntaxhighlight>
| style="padding: 5px;"| odeslání SNMP v1 TRAP zprávy
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 06 a novější (a to konkrétně ve firmware od 2013 včetně a novější).

Funkce odešle jeden SNMP v1 TRAP na určenou IP adresu (na výchozím SNMP TRAP portu). Obsah TRAP zprávy se definuje pomocí zadaných parametrů při zavolání této funkce.

Parametry funkce:
<syntaxhighlight lang="c">
 snmp_send_trap(ip[0],ip[1],ip[2],ip[3], PDUspecificValue, TableIndex);
</syntaxhighlight>

* ''IPadresa'' = adresa stroje na kterém je spuštěn SNMP TRAP přijímač (cílové zařízení)
* ''PDUspecificValue'' =  číselná hodnota určující konkrétní OID položku (podle definice konkrétní TRAP zprávy) viz MIB soubor
* ''TableIndex'' = pokud je konkrétní OID položka tabulky, vyplňte index (viz MIB), jinak je tato položka ignorována (dejte 0)

Pozn. při odeslání TRAPu je vždy použita hodnota '''enterprise 33283''' (odpovídá výrobci zařízení SDS).

Poslat lze pouze ty TRAP zprávy, které dané zařízení podporuje - vždy jsou podporovány všechny SNMP zprávy z celého ''enterprise'' rozsahu zařízení. Vše co přečtete ze zařízení SDS pomocí SNMP WALK, a je prefixována 33283, lze poslat jako TRAP.

Konkrétní hodnoty ''PDUspecificValue'' viz MIB soubor pro příslušné zařízení.

Příklad zavolání funkce:
<syntaxhighlight lang="c">
poslat_trap
{
 
proved_poslani:
 // pokusi se odeslat SNMP TRAP na host IP 10.22.31.47
 // PDUspecificValue je v tomto prikladu 100 (zalezi na specifikaci v SDS: coz je popsano MIB souboru)
 // pro konkretni promennou 1.3.6.1.4.1.33283.1.2.2.1 (typ INTEGER)
 // a protoze to neni tabulkova hodnota, je TableIndex nastaven na nulu
 //
 snmp_send_trap(10,22,31,47, 100, 0);

 // pockame na vysledek
cekej_na_odeslani:
 if (sys[96] == 1) goto cekej_na_odeslani;

 // test na stav
 if (sys[96] == 5)
 {
   // TRAP neni odeslan. Funkce odeslani TRAPu byla zavolana kdyz jeste probiha cinnost jine funkce...
   echo('TRAP neodeslan (neskoncila jina predchozi komunikace)');
   return;
 }

 // test jestli se to nepovedlo (TRAP nebyl odeslan) kvuli chybnemu zadani pri zavolani funkce
 if (sys[96] == 3) 
 {
   echo('TRAP neodeslan (chybne parametry).');
   return;
 }

 // test jestli se to nepovedlo (TRAP nebyl odeslan) kvuli ARPu
 if (sys[96] == 4) 
 {
   echo('TRAP neodeslan (ARP), budu opakovat.');

   // nepovedlo, chvili pockame
   wait(100);
   // a zkusime to znovu
   goto proved_poslani;
 }

 // jen pro informaci:
 if (sys[96] == 2)
 {
    echo('TRAP odeslan uspesne.');
 }

} 
</syntaxhighlight>

Více informací o SNMP viz příslušná stránka na této WiKi.

Po zavolání této funkce se zařízení SDS pokusí okamžitě odeslat SNMP TRAP paket na cílové zařízení. Pokud ještě nebyl proveden ARP překlad IP adresy, není TRAP zpráva odeslána, a SDS-C aplikace je o tom informována hodnotou v ''sys[96]''. Je povinností aplikace hlídat tuto hodnotu po každém zavolání funkce a podle to se zařídit (např. snažit se TRAP zprávu znovu odeslat).

Pro popis hodnot sys[96] se podívejte [[SDS-C: sdsc sysp|sem]].



----
==== send_udp() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">send_udp()</syntaxhighlight>
| style="padding: 5px;"| odeslání UDP paketu
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 06 a novější (tj. firmware od 22.8.2012 včetně a novější).

Funkce odešle jeden UDP paket na určenou IP adresu a určený port. Obsah paketu jsou data v poli '''text[]'''. Typické použití je: pravidelný přenos údajů z SDS do centrálního serveru, nebo přenost textu do syslog serveru.

<syntaxhighlight lang="c">
 send_udp(ip[0],ip[1],ip[2],ip[3], udp_port, text_start_index, data_length);
</syntaxhighlight>
 
<syntaxhighlight lang="c">
 send_udp(192,168,1,100,1234,0,64);
</syntaxhighlight>

Pokud není známa MAC adresa příslušející ke zvolené IP adrese, je namísto UDP paketu odeslán ARP dotaz. Proto je nutné vždy po odeslání UDP paketu funkcí '''send_udp()''' zkontrolovat, zda-li skutečně došlo k odeslání paketu, nebo zda-li byl namísto toho odeslán ARP dotazový paket. To platí pro všechny možné IP adresy, i ty, které nejsou v místní síti, do které spadá zařízení SDS. Proto vždy kontrolujte výsledek a v případě odeslání ARP dotazu ručně opakujte odeslání UDP paketu tak dlouho, dokud se to zdárně nepodaří.

Informaci o stavu odesílání UDP naleznete v '''sys[95]'''.

Po každém zavolání funkce '''send_udp()''' dojde k nastavení '''sys[95]''', a program SDS-C pokračuje v činnosti - odeslání UDP paketu se provede "na pozadí", ale bez zdržení. Pokud však dojde k potřebě poslat ARP dotaz, je tento dotaz ihned odeslán a to opět bez blokování další činnosti SDS-C programu.

Jakmile je úspěšně odeslán UDP paket, nebo jakmile je úspěšně odeslán ARP dotaz, tak je hodnota '''sys[95]''' nastavena na '''2''' respektive '''3'''. Váš program to musí pohlídat a nesmí funkci '''send_udp()''' zavolat znovu dříve, než je '''sys[95]''' nastaveno na '''0''' resp. '''2''' resp. '''3'''.

V případě že sys[95] je nastaveno na '''5''', zadali jste jeden nebo více neplatných parametrů při zavolání této funkce. Volání můžete ihned opakovat (ale použijte správné parametry, jinak to bude opět přerušeno s chybou '''5''').

Data k odeslání musí být připravena v poli '''text[]''' (z jiného místa neumí tato funkce data převzít). Můžete určit, od kterého indexu pole '''text[]''' budou data převzata, a kolik položek (počet bajtů) z tohoto pole chcete odeslat.

Z pole '''text[]''' je vždy za všech okolností použit přesně ten počet bajtů, které určíte parametrem funkce '''send_udp()''' (pokud se však nenarazí na skutečný konec pole daný jeho celkovou velikostí). Na rozdíl od ostatních funkcí, které využívají pole '''text[]''' a které se "zastaví" jakmile narazí na hodnotu '''0''' v některém z položek tohoto pole, tak funkce '''send_udp()''' tuto hodnotu nesleduje a převezme ji do obsahu UDP paketu jako jakokoliv jinou hodnotu.

Využíváme pole '''text[]''' proto, že jeho jednotlivé položky jsou o velikosti 1 byte. To znamená, že každá položka pole '''text[]''' představuje jeden bajt v odeslaném UDP paketu.

Pozn. Data jsou brána pouze z pole text[], nelze chtít je brát z jakéhokoliv jiného pole.

<syntaxhighlight lang="c"> 
odesli_paket
{
opakovat_odesilani:

  // požádat o okamžité odeslání UDP paketu na IP: 192.168.1.100 port 1234
  // s obsahem v poli text[] od indexu [0] o délce 64 bajtů
  send_udp(192,168,1,100, 1234, 0,64);

  // počkáme až se to dokončí (odešle se paket)
cekej_na_provedeni:
  
  // ještě pracuje ?
  if (sys[95] == 1) 
   goto cekej_na_provedeni; 
  
  // teď: co se skutečně provedlo ?

  if (sys[95] == 2) 
  {
    // byl odeslán UDP paket, takže jsme hotovi
    return; 
  }
 
  if (sys[95] == 3)
  {  
    // místo UDP paketu byl odeslán ARP dotaz
    // takže chvíli počkáme, ať nezahltíme síť opakování ARP dotazů 
    // (obvykle to chvíli trvá, než přijde ARP odpověď, 
    // takže počkáme např. 250msec - toto si upravte dle potřeby)
    wait(250);

    // tím, že se místo našeho požadovaného UDP paketu
    // odeslal ARP paket, byl náš původní UDP paket zahozen:
    // takže ho musíme nechat poslat znovu (dokola dokud se to nepovede)
    // pozn. tady by bylo dobré dát počítadlo a pokud se to nepovede
    // vícekrát, tak ohlásit selhání a skončit, jinak se program odsud nikdy nedostane
    goto opakovat_odesilani;
  }

  if (sys[95] == 4)
  {
    // funkce send_udp() byla zavolána dříve než bylo dokončeno
    // provádění předchozího požadovaného požadavku
    
    // obsluhu této situaci si musíte vyřešit dle svého úkolu

    // typické řešení by bylo počkat (chvíli, 250 msec například)
    // a pak provést: goto opakovat_odesilani; 

    // my v tomto příkladu opustíme tuto funkci (tj. naše selhání)
    return;
  }

  if (sys[95] == 5)
  {
    // funkce zavolána s neplatným parametrem (nebo více parametry)

    // tento příklad nic takového neřeší, 
    // takže jdeme z této funkce pryč.
    return;
  }

  // pokud se dostaneme sem, tak je v sys[95] neznámá hodnota
  echo('sys[95] == neznámá hodnota'); 
}
</syntaxhighlight>

Poznámka: dokud není úspěšně odeslán UDP paket (tj. dokud '''sys[95]''' není '''2'''), nesmíte změnit tu část obsahu pole '''text[]''', která se má odeslat jako obsah UDP paketu. Pokud to změníte, dříve než se provede skutečné odeslání, tak se samozřejmě i změní obsah co bude UDP paket obsahovat, což může vést k nečekaným a obtížně zjistitelným problémům.

Poznámka: zadání IP adresy jako 255.255.255.255 do funkce '''send_udp()''' způsobí, že MAC adresa odeslaného UDP paketu bude nastavena na FF:FF:FF:FF:FF:FF. Toto má využití pro rozesílání '''broadcast''' UDP paketů v segmentu místní sítě. Využijete to například pro odeslání ''Wake-On-LAN over UDP'' paketu.


----
==== onewire_rescan() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">onewire_rescan()</syntaxhighlight>
| style="padding: 5px;"| provede rescan 1-W sběrnice
|-
|}

Tato funkce je dostupná teprve pro firmware (SDS-C) od 28.12.2013 včetně a novější.

Parametry funkce:
<syntaxhighlight lang="c">
 onewire_rescan(busID, familyID);
</syntaxhighlight>

* ''busID'' = číslo sběrnice: '''0 == A''', '''16 == B''' 
* ''familyID'' = jaký 1-W chip je hledán (budou zpracovány jen chipy s odpovídajícím Family Code byte)

Tato funkce umožňuje provést okamžitý rescan 1-W sběrnice (sběrnice A nebo B, podle ''busID''). Tento rescan ale vždy ignoruje všechny teploměrné 1-W chipy (teplotní čidla na 1-W sběrnici).

1-W sběrnice umožňuje připojení více než jednoho 1-W chipu. Může to být kombinace různých chipů (teplotní čidla, a další). 

Zařízení SDS striktně odděluje funkčnost pro teplotní čidla a ostatní chipy. Teplotní čidla jsou automaticky zpracovávány vlastním firmware zařízení SDS, a SDS-C program má přímo přístup k jednotlivým změřeným teplotám ze všech čidel, aniž by musel nějak ovládat komunikaci po 1-W sběrnici s teplotními čidly.

Ostatní 1-W chipy ("ne-teploměrné" chipy) jsou dostupné pouze přímo z SDS-C programu, který si musí 1-W sběrnici ovládnout sám. V tuto chvíli poskytuje SDS-C pouze jedinou funkci s tímto účelem, a to ''onewire_rescan()''. 

Tato funkce '''nemá''' jakýkoliv vliv na činnost firmware SDS, který se stará o teplotní čidla připojené na 1-W sběrnici. Pokud dojde k smíchání teplotních čidel a ostatních chipů na stejné sběrnici, pak firmware SDS bude neustále dokola číst hodnoty z jednotlivých teplotních čidel, a SDS-C program toto může pouze dočasně pozastavit, zavoláním funkce ''onewire_rescan()''. Jakmile je rescan proveden, firmware SDS si 1-W sběrnici zase zpátky převezme (pokud jsou na 1-W sběrnici připojena teplotní čidla).


Typické použití funkce ''onewire_rescan()'' je detekce připojení (přiložení) přístupového chipu DS1990A. Pravidelným opakování volání rescan funkce lze detekovat, zda-li uživatel přiložil identifikační chip ke čtecí hlavici (zda-li připojil DS1990A na 1-W sběrnici).

Jednotlivé 1-W chipy se rozlišují pomocí hodnoty Family Code byte: pro chip DS1990A je to hodnota '''0x01''', hodnoty pro jiné chipy viz datasheet výrobce pro konkrétní chip. 

Výstupem ''onewire_rescan()'' je nastavení hodnot do několika '''sys[]''', viz [[SDS-C: sdsc sysp|zde]].

Rescan 1-W sběrnice trvá určitou dobu (150 až 500 msec, podle počtu chipů na 1-W sběrnici). Pokud SDS-C program zavolá funkci ''onewire_rescan()'' dříve, než byl předchozí rescan dokončen, bude toto volání funkce ignorováno (viz sys[940], sys[941]).

Spuštění rescanu a výsledek rescanu je k dispozici po každou sběrnici samostatně. Výsledkem je ROM-CODE nalezeného chipu (pokud je nalezen chip s odpovídajícím Family Code byte) a časová značka, kdy přesně byl tento chip na 1-W sběrnici nalezen.

Časová značka je hodnota sys[3] v okamžiku, kdy byl chip nalezen, popřípadě je nastavena na nulu, pokud nebyl nalezen.

Příklad: hledání DS1990A na sběrnici B:
<syntaxhighlight lang="c">
 onewire_rescan(16, 0x01);
</syntaxhighlight>


----
==== sdsc_reset_program() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">sdsc_reset_program(key)</syntaxhighlight>
| style="padding: 5px;"| provede okamžité znovuspuštění (restart) SDS-C programu
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 08 a novější.

Výsledek zavolání této funkce je identický tomu, co se stane když se provedou všechny instrukce ve funkci main(). Aktuální program SDS-C se spustí znovu od začátku (funkce main).

Vzor: okamžité znovuspuštění SDS-C programu.
<syntaxhighlight lang="c">
 // 
 sdsc_reset_program(1);  // reset programu se provede jen a pouze, pokud je parametr == 1

 // nebo takto:

 var k;
 k = 1234;
 sdsc_reset_program(k); // protoze "k" neni 1, program bude pokracovat (nestane se restart programu)

 k = 1;
 sdsc_reset_program(k); // a ted uz se program spusti odznova, protoze klic je 1 
</syntaxhighlight> 


----
==== sdsc_set_wdg() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">sdsc_set_wdg(timeout_in_sec)</syntaxhighlight>
| style="padding: 5px;"| aktivování hlídače činnosti SDS-C programu
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 08 a novější.

Po zavolání této funkce se aktivuje činnost watchdog pro samotný SDS-C program. Jednou zapnutý watchdog nelze vypnout jinak než nahráním jiného programu nebo vypnutím zařízení SDS.

Watchdog funguje na principu požadavku na pravidelné hlášení o činnosti - funkce sdsc_kick_wdg() - a toto hlášení musí přijít dříve, než uplyne nastavená doba (timeout_in_sec).

Pokud v daném časovém okně není provedeno hlášení, a tedy tento časový odpočet dojde až na konec (na nulu), zařízení SDS provede nové spuštění SDS-C programu.

Funkce hlídání SDS-C (watchdog SDS-C programu) může mít celou řadu využití, obecně je vhodný dodatečný bezpečnostní prvek, zamezující zablokování SDS-C programu nastane-li jeho zablokování 
(např. pokud je v programu chyba, nevhodná smyčka, nebo snad program čeká na nějaký vstup).

Využití watchdogu si musí každý programátor SDS-C nalézt sám, nicméně je obecně doporučeno jej použít (čistě z důvodu ošetření možných chybových stavů samotného vašeho SDS-C programu).

Zařízení SDS má svůj vlastní hardwarový watchdog, který nemá s tímto dodatečným programovým watchdogem cokoliv společného - obojí jsou nezávislé systémy, a jejich výstup má nezávislý dopad.
Z hlediska SDS-C máte možnost ovlivnit nastavení pouze programového watchdogu pro samotný SDS-C program. 


----
==== sdsc_kick_wdg() ====


{| class="filehistory" width="60%"
| style="padding: 5px;"| <syntaxhighlight lang="c">sdsc_kick_wdg(key)</syntaxhighlight>
| style="padding: 5px;"| obnovení odpočtu hlídače SDS-C programu
|-
|}

Tato funkce je dostupná teprve pro SDS-C č. 08 a novější.

Je-li aktivován hlídač SDS-C programu (funkcí sdsc_set_wdg), musí SDS-C program stihnout informovat systém o tom, že "žije". To se provádí voláním funkce ''sdsc_kick_wdg()'', a toto volání se musí stihnout dříve než vyprší časový úsek nastavený při spuštění watchdogu (viz parametr funkce sdsc_set_wdg).

Po zavolání ''sdsc_kick_wdg()'' se hlídací odpočet nastaví na plnou délku, a opět se začne zkracovat.

Dokud tedy SDS-C program provádí opakované volání funkce ''sdsc_kick_wdg()'', a stíhá to vždy v době kratší než je délka odpočtu, tak nedojde k aktivaci watchdogu.

Pokud to nestihne, dojde tedy k doběhu odpočtu do nulové polohy, a systém provede restart SDS-C programu (zbytek SDS pokračuje bez zásahu, dojde jen k ukončení a ihned ke znovuspuštění SDS-C programu).

Vzor: celý WDG
<syntaxhighlight lang="c">
 // start programu
 sdsc_set_wdg(10);  // spustit SDSC-WDG a nastavit odpočet na 10 sec

 // a pak v průběhu programu

hlavnismycka:

 // ...

 sdsc_kick_wdg(10); // klíč je stejná hodnota jako timeout_in_sec

 // ...

 goto hlavnismycka;
</syntaxhighlight> 

Parametr ''key'' musí odpovídat hodnotě původně zapsané do ''timeout_in_sec'' (parametr volání funkce sdsc_set_wdg). Pokud to nebude stejné, nedojde k očekávané akci (znovunastavení odpočítávání na plnou hodnotu) a eventuálně dojde k aktivaci watchdogu.


----
==== Konec stránky. ====


konec stránky