SDS-C: popis jazyka - Historie editací

Adamn v 11. 4. 2021, 12:25

2021-04-11T12:25:04Z

Adamn v 18. 3. 2021, 19:46

2021-03-18T19:46:59Z

Adamn v 18. 3. 2021, 19:45

2021-03-18T19:45:49Z

Ukázat změny

Adamn v 18. 3. 2021, 13:11

2021-03-18T13:11:18Z

Adamn v 18. 3. 2021, 13:10

2021-03-18T13:10:37Z

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

2021-03-18T13:08:52Z

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

Nová stránka

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.

Jazyk SDS-C má vyhrazené proměnné a příkazy. Přes tyto proměnné a příkazy ovládá váš SDS-C program zařízení SDS.

== Funkce ==

'''Seznam systémových funkcí (které poskytuje zařízení SDS-C) naleznete [[SDS-C: sdsc sysf|zde]].'''

Samozřejmě že si můžete definovat své vlastní uživatelské funkce (pokud jejich název nebude kolidovat s vyhrazenými slovy).

== #define ==

Můžete si zpřehlednit program a především centralizovat řadu funkcí, a to pomocí deklarace '''#define'''.

Zejména pokud máte často se opakující odkaz v celém programu (např. často ovládáte např. třetí relé z mnoha míst v programu), pak je výborné si program zpřehlednit, a zejména, pokud se pak rozhodnete ve zmíněném příkladu přejít z třetího na první relé, mít možnost tuto změnu provést jediným zásahem na jediném místě.

<syntaxhighlight lang="c">
#define RELE sys[231]
<syntaxhighlight lang="c">

Takto teď kdekoliv v programu, kam napíšete '''RELE''' (pozn. kromě ohraničených textů a komentářů), bude automaticky vloženo '''sys[231]''' (nebo cokoli jiného co si pak sami definujete).

Příklad:
<syntaxhighlight lang="c">
RELE = 1; //zapne rele
<syntaxhighlight lang="c">

Všechny názvy musí být kompletně velkými písmeny.

Pozor - lze použít jen jednu úroveň (tzn. nelze vnořit define do define).

== Vyhrazené proměnné SDS-C ==

Vyhrazené proměnné v SDS-C jsou tzv. ''systémové proměnné''. Jejich obsah odpovídá aktuálnímu fyzickému stavu systému, tj. HW zařízení.
Stejně tak lze pomocí specifických systémových proměnných zasahovat i do konfigurace, měnit textové údaje ve webovém rozhraní atd.

'''Kompletní seznam naleznete [[SDS-C: sdsc_sysp|zde]].'''

== Uživatelské proměnné ==

Programátor si může v SDS-C definovat své vlastní proměnné.

Použije se pro tento účel klíčové slovo ''var''. Toto je jediný možný definiční typ pro proměnnou, akceptovaný v SDS-C.

Příklad:
<syntaxhighlight lang="c">
var pocet;
<syntaxhighlight lang="c">

Definuje proměnnou ''pocet'', typ 32-bitů signed (to znamená: 1 bit pro znaménko a 31 bitů pro číslo).

V této verzi je možné používat pouze 32-bit/signed. Proto se do programu nepíše typ proměnné, ale jen ''var'' a zvolený název.

Co a jak když chcete pracovat s desetinnými čísly? Snadná pomoc:
<syntaxhighlight lang="c">
var a,b,x, celaCast, desetinnaCast, preciznost;

a = 5;
b = 2;

// ted chci x = a/b, tj x=5/2, tj. x=2.5
// ale mam jen celociselne deleni...

preciznost = 10; // nebo 100, 1000, ... jak moc je potreba

x = (a * preciznost) / b; // posuneme tedy desetinnou carku nasobenim

// x je ted 25, takze

celaCast = x / preciznost;
desetinnaCast = x % preciznost;

// vysledek -> celaCast = 2, desetinnaCast = 5

echo('vysledek = ',celaCast,'.',desetinnaCast); //-> vypise: vysledek = 2.5
<syntaxhighlight lang="c">

== Texty ==

Jazyk SDS-C umožňuje pracovat pouze s pevně definovanými, konstantními (tj. dále neměnnými) texty.

Jazyk SDS-C má tedy z hlediska práce s texty řadu omezení, vůči jazyku FULL-C.

Všechny texty (jako konstanty) si definuje programátor. Definice lze provést kdekoliv.

Např.
<syntaxhighlight lang="c">
smtp_send('joe@foo.bar', 'subject', 'Další definovaný text, hodnota i=', i, ' a další text...');
<syntaxhighlight lang="c">

Texty lze předat pouze jako parametry funkcí a do některých systémových proměnných, a dále už nikam jinam.

== Vyhrazené klíčové slova ==

V jazyku SDS-C je řada vyhrazených slov, které mají pevně přiřazenou funkci. Jejich znalost je pro
programovaní v SDS-C naprosto '''nezbytná'''.

* '''return'''

Umožňuje předčasný návrat ze zavolané funkce.
Příklad:
<syntaxhighlight lang="c">
if (i % j == 0) return;
<syntaxhighlight lang="c">

Pokud zavoláte '''return''' přímo v ''main'', pak je ''main'' předčasně ukončen a vzápětí znovu spuštěn od svého začátku.

* '''label'''

Definuje bod v programu (návěstí), kam je možné odkudkoliv odjinud skočit. V současné verzi SDS-C není vyžadován (byl to původně vyžadováno v prvních starých verzích).

Využívá se např. pro vytváření smyček.

Definice cílového bodu (tj. kam lze skočit):

lze použít dvě varianty:
<syntaxhighlight lang="c">
-název-:
<syntaxhighlight lang="c">
<syntaxhighlight lang="c">
label -název-:
<syntaxhighlight lang="c">

Všimněte si, že si můžete zvýšit přehlednost programu tím, že před samotný název návěstí dáte slovo '''label'''. Pak lze v editoru snadněji najít pohledem místa, kam se bude skákat (pozn. jiný význam to prakticky nemá).

Skok se provede takto:
<syntaxhighlight lang="c">
goto -název-;
<syntaxhighlight lang="c">

Pozor! Definice bodu návěstí lze provést pouze '''nad''' všemi skoky (goto) na konkrétní návěst.
Pokud bude tedy skok (goto) nad místem definice cíle (label), bude to bráno jako chyba.

* '''if'''

Pomocí ''if'' se provádí větvení programu dle aktuálního stavu.
Provede se test zadané podmínky, a na základě výsledku (pravda/nepravda) se provede příslušná zadaná akce.
Lze provést pouze jediné volání funkce nebo jediný skok (label), přičemž pro pravdivý výsledek lze definovat takovouto akci a stejně tak i pro nepravdivý výsledek.

'''POZOR''' Vždy jsou vykonány kompletně '''všechny''' testované vstupy v podmínce '''if''' - ať pak nejste překvapeni !

Příklad:
<syntaxhighlight lang="c">
if (sys[24] < 23) posliSMS();
<syntaxhighlight lang="c">

<syntaxhighlight lang="c">
if (i % 10 == 0) goto neni10 else jinaFunkce(); //pokud i je nasobek 10, pak se skoci na label neni10, jinak se vola jinaFunkce
<syntaxhighlight lang="c">

<syntaxhighlight lang="c">
if (q & 2 && z != u) neco() else necoJineho();
<syntaxhighlight lang="c">

<syntaxhighlight lang="c">
if (teplota < 10 && chci_alarm != 0) hlas_alarm() else return; //priklad vyuziti return
<syntaxhighlight lang="c">

Takže viz poslední příklad - i když bude platit, že teplota < 10, vždy bude otestován i chci_alarm != 0, a až pak na základě všech výsledků se rozhodne, který příkaz se provede.

Jak pomocí '''if''' pracovat s bloky kódu, když nechcete volat funkce:

<syntaxhighlight lang="c">
if (i != 0)
{

echo(' i neni nula ');
// atd...

} else

{

echo(' i je nula ');

}

// dalsi kod...
<syntaxhighlight lang="c">

* '''var'''

Pomocí ''var'' se definují uživatelské proměnné.

== Funkce v SDS-C ==

Funkce jsou ohraničené části programu, které mají svůj specifický název, zadaný programátorem.

Všechny tyto funkce nevracejí hodnotu, lze je pouze zavolat.
Po svém provedení pokračuje běh programu v místě, odkud byla funkce zavolána.

Využití funkcí - nejčastěji pro opakované kusy programu, aby se nemuselo plýtvat s volným místem pro zápis programu.

Příklad definice funkce ''test'' a jejího zavolání z jiné funkce ''funkceX'':
<syntaxhighlight lang="c">
test
{
i += 10; //nejaky obsah funkce...
}

funkceX
{

//zavolame test()
test();

//...
}
<syntaxhighlight lang="c">

Všimněte si rozdílu definice funkce v SDS-C, ve srovnání s FULL-C. Pro SDS-C funkce nevrací hodnoty a nepřebírá parametry.

Takže pro SDS-C je definice: ''test { . . . };'' kdežto pro FULL-C je odpovídající definice: ''void test(void) { . . . };''

Funkce lze volat odkudkoliv, včetně klíčového slova ''if'' (pouze jako reakci na vyhodnocení podmínky, nikoliv v podmínce samotné).

Některé funkce jsou definovány jako vyhrazené, a některé jsou definovány jako interní pro daný výrobek SDS - viz seznam. Nesmíte použít názvy těchto funkcí pro své vlastní (uživatelské). Celkový počet funkcí je omezen.

== Vyhrazené funkce v SDS-C ==

Jsou definovány tři základní vyhrazené funkce, které lze použít jedině k definovánému účelu.

Funkce '''main''' obsahuje hlavní program. Pokud si nevytvoříte vlastní smyčku, je po provedení všech instrukcí v ''main'' tato opět spuštěna od začátku (toto se dějě stále dokola po celou dobu kdy je zařízení zapnuto). Z této funkce lze volat jakékoliv podfunkce.
'''Je povinnost mít funkci ''main'' v programu definovanou.'''

Funkce '''init''' je zavolána jen při resetu zařízení. Není povinnost mít funkci ''init'' v programu definovanou.
Pozn. funkci ''init'' je možné znovu zavolat odkudkoliv.

Příkaz '''return''' je speciální funkce/příkaz - jedná se pouze o návrat (viz zásobník, tj. předčasné ukončení funkce ve které je ''return'' zavolán). ''return'' se nikde v programu nedefinuje, je to totiž vyhrazené slovo, které se jen používá.

== Další poznámky ==

Návod pro SDS-C je rozdělen do více stránek na této WiKi.

@@ Řádek 145: / Řádek 145: @@
    echo('Teplota je ',pr,' stupnu Celsia.');
+}
-<syntaxhighlight lang="c">
+</syntaxhighlight>
 == Další vlastní funkce ==
-Nemusíte se snažit vše vecpat do '''main'''. Často opakované kusy programu lze dát "bokem" do jiné funkce, a pak stačí jen tuto funkci "zavolat" a program v této funkci se na míste zavolání provede.
+Nemusíte se snažit vše vecpat do '''main'''. Často opakované kusy programu lze dát "bokem" do jiné funkce, a pak stačí jen tuto funkci "zavolat" a program v této funkci se na místě zavolání provede.
 Příklad zápisu vlastní funkce (samozřejmě můžete mít svých funkcí více):
@@ Řádek 660: / Řádek 660: @@
 * je přístupné stejně jako Sdílené Proměnné z webového rozhraní SDS (tzn. vhodné pro např. dálkovou konfiguraci SDS-C programu)
 * nelze jej využít ve zcela všech SDS-C funkcích (v porovnání s polem text[]) - nicméně se zde bavíme jen o několika funkcích z mnoha, kde to nejde

@@ Řádek 488: / Řádek 488: @@
 Toto už je pěkný program na hraní, dá se kompletně odzkoušet v debuggeru. Můžete se pak pokusit sami doplnit další funkce, např. již naznačené ovládání relé (např. ovládající nějaké topení, které by ovlivňovalo teplotní čidlo), atd.
-Dalším rozšířením programu může být dálkové ovládání. Využije se funkce zařízení SDS, které umožňuje měnit hodnoty některých proměnných "na dálku" - přes webové rozhraní nebo pomocí vhodně složených URI, poslaných z jiného zařízení nebo nadřazeného řídícího systému. Více informací [[SDSC: sharing|naleznete zde]]. V tomto příkladu by se jednalo o potřebu dálkově měnit proměnné ''limit'' a případně ''hystereze''. Pak stačí doplnit do programové smyčky tento kus programu:
+Dalším rozšířením programu může být dálkové ovládání. Využije se funkce zařízení SDS, které umožňuje měnit hodnoty některých proměnných "na dálku" - přes webové rozhraní nebo pomocí vhodně složených URI, poslaných z jiného zařízení nebo nadřazeného řídícího systému. Více informací [[SDSC-C: sharing|naleznete zde]]. V tomto příkladu by se jednalo o potřebu dálkově měnit proměnné ''limit'' a případně ''hystereze''. Pak stačí doplnit do programové smyčky tento kus programu:
 <syntaxhighlight lang="c">
 //...
@@ Řádek 502: / Řádek 502: @@
 </syntaxhighlight>
-Pak můžete u běžícího programu, bez nutnosti do jeho kódu zasahovat při potřebě změnit např. zmíněný teplotní limit, provést tuto změnu za provozu, např. přes webové rozhraní (opět viz návod [[SDSC: sharing|zde]]) - s výhou si můžete do zařízení nahrát svou vlastní webovou stránku, a přes tu pak měnit konkrétní ''sys[]'' hodnoty. V té samé stránce může být i dynamické zobrazování aktuálních hodnot, takže cílový uživatel si bude moct komfortně ovládat zařízení, bez nutnosti se starat o vnitřní funkci.
+Pak můžete u běžícího programu, bez nutnosti do jeho kódu zasahovat při potřebě změnit např. zmíněný teplotní limit, provést tuto změnu za provozu, např. přes webové rozhraní (opět viz návod [[SDS-C: sharing|zde]]) - s výhou si můžete do zařízení nahrát svou vlastní webovou stránku, a přes tu pak měnit konkrétní ''sys[]'' hodnoty. V té samé stránce může být i dynamické zobrazování aktuálních hodnot, takže cílový uživatel si bude moct komfortně ovládat zařízení, bez nutnosti se starat o vnitřní funkci.

← Starší verze		Verze z 18. 3. 2021, 13:11
Řádek 246:		Řádek 246:

	Návod pro SDS-C je rozdělen do více stránek na této WiKi.		Návod pro SDS-C je rozdělen do více stránek na této WiKi.
		+
		+
		+	__NOTOC__