Zobrazení zdroje stránky FULL-C: program upload

 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.

== Způsoby nahrání vašeho FULL-C programu do SDS ==
__NOTOC__
FULL-C program zapíšete a zpracujete v aplikaci FULLC.EXE (stáhněte si vždy tu aktuální z této wiki).

Zpracovaný program je možné:

1. přímo ve FULLC.exe nahrát do zařízení SDS

2. uložit (pomocí FULLC.exe) do souboru .FC pro pozdější využítí (znovuotevření ve FULLC.exe, nebo nahrání do SDS např. pomocí SDSLOAD.exe)

3. uložit (pomocí FULLC.exe) do souboru .FCB pro pozdější nahrání do SDS


=== Soubor .FC ===

Tento soubor obsahuje jeden nebo více prvků, které si sami vyberete.

Každý prvek může nebo nemusí být do .FC vložen:
1. zdrojový kód FULL-C programu
2. přeložený FULL-C program (pro nahrání do SDS)
3. UserWEB project
4. obsah User DF
5. textová poznámka (pro identifikaci obsahu .FC)

Soubor .FC lze vytvořit ve FULLC.exe, a lze jej ve FULLC.exe také načíst; nebo jej lze načíst a použít i v aplikaci SDSLOAD.exe.

Soubor .FC je jako celek samostatně symetricky šifrován, a uživatel má možnost zvolit si heslo (je-li použito, nelze bez něj pak .FC otevřít).

=== Soubor .FCB ===

Soubor .FCB obsahuje jen a pouze přeložený FULL-C program. Soubor .FCB existuje z důvodu potřeby implementace (vašich vlastních) skriptovaných metod nahrávání hotového FULL-C programu do SDS.

Soubor .FCB obsahuje čistý výstup z překladu provedeného FULLC.exe, který je sám o sobě šifrovaný. Další dodatečné šifrování .FCB tak není prováděno (není potřeba).

Obsah .FCB lze přímo 1:1 nahrát do SDS, viz popis protokolů dole na této stránce.


=== Soubor .UWB ===

Soubor .UWB obsahuje přeložený UserWEB project. Soubor .UWB existuje z důvodu potřeby implementace (vašich vlastních) skriptovaných metod nahrávání hotového UserWEB projektu do SDS.

Obsah .UWB lze přímo 1:1 nahrát do SDS, viz popis protokolů dole na této stránce.


== Způsoby nahrání FC programu do SDS ==

Existují dva protokoly:

1. '''prostřednictvím UDP (8081) s proprietárním symetrickým šifrováním přenosu''' (unikátní klíč pro každé spojení)

Tento programovací UDP protokol je využit na všech SDS, nicméně interně se různě odlišuje (v detailech) podle Produktové Řady.

Tento protokol je dostupný jedině a pouze přes aplikaci FULLC.exe a SDSLOAD.exe

Na SDS-BIG-512 lze programování přes tento protokol zakázat.


2. '''prostřednictvím HTTP/HTTPS POST protokolu (REST API)''' (unikátní salt pro každé spojení)

Přenásí se obsah .FCB nebo .UWB souboru (nebo také další funkce, jako je IP konfigurace).

Tento protokol je k dispozici na SDS-BIG-512 a to primárně z důvodu potřeby zákazníků skriptovat nahrávání a konfiguraci svých SDS (např. vlastním python skriptem).

Uživatel je nejprve autorizován (průmyslový standard: dvojitý SHA-256 hash vůči unikátnímu Salt, který je vždy jiný pro každé nové spojení), a poté je provedeno smazání původního programu a nahrání nového (klient pošle sekvenci příkazů a obsah svého souboru .FCB nebo .UWB).

''Detaily tohoto protokolu budou popsány zde.''

Vzorová aplikace FCB_LOADER.exe je k dispozici na dotaz, i se zdrojovými kódy.


'''Proč tento způsob ?''' 

* Protože UDP protokol (8081) je proprietární a není možné jeho specifikaci běžně veřejně uvolnit.
* Protože implementace autorizované komunikace přes HTTPS POST je průmyslovým standardem a je velmi snadné provést jeho skriptování v různých jazycích