FULL-C: general functions - Historie editací

Adamn v 25. 10. 2025, 08:59

2025-10-25T08:59:04Z

Adamn v 31. 12. 2022, 11:51

2022-12-31T11:51:17Z

Adamn v 31. 12. 2022, 10:55

2022-12-31T10:55:39Z

Adamn v 2. 6. 2022, 08:12

2022-06-02T08:12:08Z

Adamn v 8. 8. 2021, 14:24

2021-08-08T14:24:50Z

Adamn: Založena nová stránka s textem „ 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,…“

2021-08-08T14:24:31Z

Založena nová stránka s textem „ 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,…“

Nová stránka

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

void SDS_disable_onewire(void);
</pre>

== 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_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: Princip ==

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.

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

== SDS_disable_onewire: Princip ==

Tato funkce je určena pro uživatele modulů SDS-STSW, které nemají osazený chip 1-Wire Master. Jedná se o některé uživatele (OEM integrátoři) tohoto modulu, kteří v zájmu snížení ceny požadali o vynechání HW podpory pro 1-Wire sběrnici (toto snížení ceny se promítne ale pouze od XYZ odebraných kusů).

Funkci '''SDS_disable_onewire()''' je v takovém případě potřeba zavolat hned na začátku FULL-C programu - tím se vyřadí automatické spuštění 1-Wire sběrnice, které se samozřejmě nemůže na omezeném HW (kde chybí 1-Wire Master chip) povést. Dojde tedy k šesti pokusům o navázání komunikace, a všechny logicky selžou - a pro zajištění stabilního provozu, je vhodné tomuto celému procesu jednoduše předejít (touto funkcí).

''Poznámka:'' podobná funkce je k dispozici i pro SD kartu, tedy funkce SDS_disable_sdc(), viz příslušný návod.

@@ Řádek 16: / Řádek 16: @@
-== Důležité systémové indexy ==
+== Účel ==
+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 ==
+=== 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).
@@ Řádek 53: / Řádek 65: @@
-== SDS_set_wdg: spuštění dohledu správněhu běhu FC programu ==
+=== 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.
@@ Řádek 68: / Řádek 80: @@
-== SDS_kick_wdg: průběžná aktualizace dohledu běhu FC programu ==
+=== 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).
@@ Řádek 105: / Řádek 117: @@
 </pre>
-== SDS_heap_stats: Princip ==
+=== 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()'''.
@@ Řádek 114: / Řádek 126: @@
-=== SDS_heap_stats: Příklad ===
+=== 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.
@@ Řádek 146: / Řádek 158: @@
+}
 </pre>

@@ Řádek 62: / Řádek 62: @@
   k = 1;
   SDS_reset_program(k); // a ted uz se program spusti odznova, protoze klic je 1
 </pre>

@@ Řádek 13: / Řádek 13: @@
           void SDS_heap_stats(unsigned int *currentAllocatedBytes,
 unsigned int *totalFreeBytes, unsigned int *biggestFreeBlockAvailable);
-         void SDS_disable_onewire(void);
-         void SDS_rescan_onewire(unsigned int BUSnr);
-</pre>
@@ Řádek 133: / Řádek 146: @@
+}
 </pre>

@@ Řádek 15: / Řádek 15: @@
           void SDS_disable_onewire(void);
 </pre>
 == SDS_reset_program: okamžité nové spuštění FC programu ==
@@ Řádek 140: / Řádek 142: @@
 ''Poznámka:'' podobná funkce je k dispozici i pro SD kartu, tedy funkce SDS_disable_sdc(), viz příslušný návod.

@@ Řádek 103: / Řádek 103: @@
 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.
-<c>
+<pre>
 void main(void)
+{