Adamn v 19. 3. 2021, 09:05

2021-03-19T09:05:35Z

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-03-19T09:05:20Z

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.

== Návod pro začátek ==

Nejprve si stáhněte nejnovější verzi programu FULLC.exe (k dispozici zdarma zde na WiKi), a zkontrolujte, zda-li máte nejnovější verzi firmware ve svém SDS zařízení (nejlépe přes webové administrační rozhraní SDS).

Pro úspěšnou tvorbu programů ve FULL-C, je potřeba, aby jste měli znalosti programování v jazyce C (norma C90). Samozřejmě, ne všichni jsou schopní programovat v C, a potom vám tedy může někdo jiný program připravit (zkuste se zeptat na našem [http://forum.merenienergie.cz]).

V tomto návodu si ukážeme, krok za krokem, jak napsat základní jednoduchý program, a pak k němu přidáme několik důležitých rozšíření.

== Jak zapsat program a nahrát ho do SDS ==

Program samotný je lidsky čitelný text, který je potřeba nejprve zpracovat tak, aby ho uměl přečíst a provést i počítač (zařízení SDS).

Proto je potřeba tento vstupní text (.c soubor) tzv. "přeložit" - a k tomu slouží právě náš program FULLC.exe .

* ve FULLC.exe otevřete okno textového editoru "FULL-C source code"
* dovnitř vložíte / napíšete váš program
* stiskněte tlačítko "COMPILE"
* pokud je vše v pořádku, dostanete hlášení "DONE OK" a neobdržíte chybu
* pokud je v programu chyba, bude označena červeným řádkem v textovém editoru, a popis chyby bude uveden v okně překladače (včetně hlášení "FAILED").
* vždy zkontrolujte rozložení obsazení paměti, cílem je aby se vše "vlezlo", byl dostatečně velký "stack" a "heap" (pokud ne, tak program nebude fungovat, i když byl přeložen v pořádku - je potřeba pro jeho provoz mít dost volného místa v paměti)

* jakmile je tedy program úspěšně přeložen, je možné ho nahrát do zařízení SDS:
* stiskněte tlačítko "Upload FULL-C" z hlavního okna
* vyplňte IP adresu vašeho zařízení, pak heslo pro přístup do zařízení (a případně i port, pokud používáte NAT/port-forwarding atd.)
* stiskněte tlačítko "CONNECT TO SDS DEVICE AND READ INFORMATION*
* pokud je komunikace v pořádku, vyplní se informační texty v pravé časti okna (zkontrolujte obsah) a současně se odblokují dvě tlačítka dole uprostřed
* protože do SDS lze nahrát jak uživatelskou webovou stránku, tak FULL-C program, lze obojí provést právě teď (v libovolném pořadí)
* pro nahrání uživatelské webové stránky (kterou musíte mít celou správně vloženou v příslušném textovém editoru), stiskněte tlačítko "UPLOAD USER HTML PAGE TO SDS"
* pro nahrání přeloženého FULL-C programu, stiskněte tlačítko "UPLOAD COMPILED PROGRAM TO SDS"
* vždy sledujte textový výpis v boxu pod tlačítky, kde se dozvíte, zda-li bylo nahrávání do SDS úspěšné, nebo se nepovedlo

Po nahrání je doporučeno otevřít webovou administraci zařízení SDS, kde se na stránce "FULL-C" zkontroluje stav programu (zda-li se skutečně nahrál v pořádku, jestli funguje, a jak pracuje s pamětí).

Program je ze zdrojového kódu (text) zpracován do tzv. "bytecode" (instrukcí, kterým SDS hardware rozumí a umí je provést). Tento bytecode je ale současně komprimován (dočasně zmenšen) z důvodů snížení množství dat, přenášených přes Ethernet při nahrávání do zařízení SDS. Je potřeba hlídat velikost všech částí, jestli se tedy "vlezou" do paměti zařízení SDS.

== První ukázkový program ==

'''Každý FULL-C program''' musí mít funkci '''main()'''. Toto je první funkce, která je spuštěna po aktivaci programu.

'''Varovaní:''' pokud program opustí funcki '''main()''', je program '''ukončen''' a '''není''' automaticky spuštěn znovu ! Je úkolem programátora nikdy funkci main neopustit.

<syntaxhighlight lang="c">
// hlavni funkce
void main(void)
{

// napis vzkaz do konzole
printf("Hello World !\n");

// a zustan navzdy zde
for (;;);

}
</syntaxhighlight>

Po přeložení tohoto úvodního programu ve FULLC.exe a úspěšném nahrání do SDS, je tento program okamžitě spuštěn. To že se vše povedlo zkontrolujete otevřením stránky "echo.html" ze zařízení SDS.

== Pokračování ==

Bude postupně doplněno.

← Starší verze		Verze z 19. 3. 2021, 09:05
Řádek 66:		Řádek 66:

	Bude postupně doplněno.		Bude postupně doplněno.
		+
		+	__NOTOC__

FULL-C: popis jazyka - Historie editací

Adamn v 19. 3. 2021, 09:05

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,…“