FULL-C: TopBoard functions - Historie editací

Adamn v 25. 6. 2022, 07:46

2022-06-25T07:46:18Z

Adamn v 2. 6. 2022, 08:25

2022-06-02T08:25:47Z

Adamn v 31. 5. 2022, 07:30

2022-05-31T07:30:00Z

Adamn v 31. 5. 2022, 07:25

2022-05-31T07:25:11Z

Adamn v 8. 8. 2021, 13:30

2021-08-08T13:30:38Z

Adamn: Založena nová stránka s textem „FULL-C == Funkce pro práci s TopBoard == NOTOC Zařízení SDS-BIG lze zakoupit s doplňkovou sandwich deskou (tzv. TopBoard), kt…“

2021-06-26T10:03:14Z

Založena nová stránka s textem „FULL-C == Funkce pro práci s TopBoard == __NOTOC__ Zařízení SDS-BIG lze zakoupit s doplňkovou sandwich deskou (tzv. TopBoard), kt…“

Nová stránka

FULL-C

== Funkce pro práci s TopBoard ==

__NOTOC__

Zařízení SDS-BIG lze zakoupit s [[SDS_BIG:_DALI|doplňkovou sandwich deskou (tzv. TopBoard)]], která poskytuje uživatelské rozhraní (bodový display a klávesnici) a také možnost připojit sběrnici DALI. Tuto desku lze připojit i k dalším modulům SDS (např. SDS-STSW, SDS-SMALL).

Pozor! Je vyžadován firmware SDS od verze 5.12.2016 nebo novější!

Pro obsluhu klávesnice a displaye, můžete použít tyto funkce:
<pre>
void SDS_TOPB_keyboard_status(unsigned int *changed, unsigned int *actual, unsigned int *intermediatePresses[6]);

void SDS_TOPB_LCDdraw(unsigned int X0, unsigned int Y0, unsigned int X1, unsigned int Y1, unsigned int DrawTYPE, unsigned int FLAGS);
void SDS_TOPB_LCDtext(unsigned int X0, unsigned int ROW, unsigned int FLAGS, char *ptr, unsigned int len);
void SDS_TOPB_LCDbitmap(unsigned int X0, unsigned int ROW, unsigned int FLAGS, char *ptr, unsigned int len);
void SDS_TOPB_LCDflip(unsigned int FLAGS);
</pre>

Pro komunikaci přes DALI sběrnici (SDS je DALI-MASTER) může program použít tyto funkce:
<pre>
unsigned int SDS_TOPB_DALI_transmitCommand(unsigned int DALIaddress, unsigned int DALIdata);
unsigned int SDS_TOPB_DALI_getReceivedResponse(unsigned int *ReceivedResponse);
</pre>

== Hardware ==

SDS osazené doplňujícím sandwich modulem (sandwich desek je více různých, a všechny se chovají z hlediska key+LCD stejně) poskytuje uživateli grafický LCD a tlačítkovou klávesnici.

LCD je plně grafické a má 132 x 32 jednobarevných pixelů, adresované jako X=0..131 a Y=0..31. Pixely jsou černé (aktivní - blokují podsvícení), a podsvícení je bíle.

Následující FULL-C funkce umožňují kreslení jednotlivých pixelů, obrazců a nebo textu.

SDS využívá princip obrazového bufferu, kdy veškeré kreslení se provádí nejprve do paměti, odkud se teprve vždy celá tato paměť překlopí (najednou překreslí) do LCD kde to pak uživatel přímo vidí.

Využití paměťového bufferu (screenbuffer) je důležite, protože si tak můžete připravit novou obrazovku, zatímco uživatel stále vidí tu předchozí - lze tak realizovat navazující animace a obecně se zabrání nevzhlednému postupnému překreslování LCD (jaké by bylo při postupném kreslení jednotlivých prvků přímo na LCD).

Klávesnice je obsluhována automaticky a FULL-C program se může pravidelně dotazovat na stav tlačítek. Běžně je osazeno 5 tlačítek, na některých modulech ale jen 2 (z rozměrových důvodů).

== Obsluha klávesnice ==

TOPB nabízí pět kláves (tlačítek), které jsou interně ošetřeny proti zákmitům (nemusíte se dále ve FULL-C programu o toto starat). Některé moduly ale nabízí jen dvě tlačítka.

Každý stisk je zaznamenán, takže k dispozici pro FULL-C program je nejen aktuální stav každého tlačítka (stisknuto/uvolněno), ale i počet stisknutí mezi jednotlivými dotazy programu (takže když uživatel rychle mačká tlačítko, tak FULL-C program vždy ví, kolikrát to bylo).

'''SDS_TOPB_keyboard_status()''' je jedinou funkcí ve FULL-C, která zajištujě kompletní obsluhu zjišťovaní stavu klávesnici. Volat tuto funkci je potřeba jen tak často, jak moc je potřeba mít nízkou odezvu.

Prakticky všechny funkce lze řešit přes pole ''intermediatePresses[6]'', navrácené touto funkcí. Pro každé tlačítko, v tomto poli je udaný počet stisků které uživatel provedl, od posledního čtení této hodnoty prostřednictvím volání této funkce. Tzn. po každém zavolání funkce se tyto vnitřní počítadla nulují.

intermediatePresses[0] = vždy nula
intermediatePresses[1] = počet stisků/uvolnění tlačítka TL1 od posledního čtení počtu stisků
intermediatePresses[2] = počet stisků/uvolnění tlačítka TL2 od posledního čtení počtu stisků
intermediatePresses[3] = počet stisků/uvolnění tlačítka TL3 od posledního čtení počtu stisků
intermediatePresses[4] = počet stisků/uvolnění tlačítka TL4 od posledního čtení počtu stisků
intermediatePresses[5] = počet stisků/uvolnění tlačítka TL5 od posledního čtení počtu stisků

'''Pozor''', vždy se musíte podívat na obsah ''actual'' abyjste dokázali rozlišit mezi tím, zda-li každá jednotlivá položka v intermediatePresses[x] je počet stisků nebo počet uvolnění konkrétního tlačítka.

Každé volání funkce tato všechna počítadla intermediatePresses[] nuluje. Což je výborné pro efektivní realizaci reakce na stisk různých tlačítek, bez nutnosti složité obsluhy v programu - stačí ve vhodné
momenty přečíst počet stisků a vhodně reagovat. Pozor však na správnou interpretaci obsahu tohoto pole !

Hodnota ''changed'' ukazuje, zda-li se od posledního zavolání funkce změnil stav některého z tlačítek.

bit 0 1 2 3 4 5 6 7
dec 1 2 4 8 16 32 64 128
význam TL1 TL2 TL3 TL4 TL5 0 0 0

Příklad: od posledního volání funkce stisknul uživatel tlačítko TL1 a TL3, hodnota ''changed'' tedy bude 0b00000101 což je decimálně hodnota 5.

Hodnota ''actual'' ukazuje aktuální stav tlačítka (bit v log1 = příslušné tlačítko stisknuto).

bit 0 1 2 3 4 5 6 7
dec 1 2 4 8 16 32 64 128
význam TL1 TL2 TL3 TL4 TL5 0 0 0

Příklad: v okamžiku volání funkce má právě uživatel stisknuté tlačítko TL5, hodnota ''actual'' tedy bude 0b00010000 což je decimálně hodnota 16.

== Obsluha displaye ==

TOPB nabízí grafický display, na který lze psát a kreslit.

Všechny tyto činnosti probíhají v paměťovém bufferu na pozadí, a teprve
na konkrétní příkaz (LCDflip) se tento buffer celý přenese na display. Toto je důležité pro hladké zobrazení, bez blikání nebo poškozené animace - vždy novou scénu nakreslíte do paměťového bufferu, který představuje celý virtuální display, a ten se teprve na daný příkaz přenese na skutečný display a zobrazí se.

== SDS_TOPB_LCDflip ==

Základní funkce pro překreslení (FLIP) paměťového bufferu (virtuálního LCD) na skutečný (hardware) LCD. Principem je provádění veškerých nových kreseb na pozadí, a až nakonec, najednou, se tyto přenesou na skutečný display.

unsigned int FLAGS

== 0 : just FLIP (přenese paměťový screenbuffer na fyzický LCD)
== 1 : CLEAR and FLIP (smaže paměťový screenbuffer a pak jej ihned přenese na fyzický LCD, tzn. v důsledku smaže i celý LCD).

S výhodou můžete použít FLAGS==1 pro okamžité smazání celého displaye.

Běžná se tato funkce volá s FLAGS==0, kdy dojde jen k přenesení celého bufferu na display, což je základní použití této funkce.

Pokud chcete jen smazat paměťový screenbuffer a přitom nesahat na LCD, musíte si pomoct funkcí SDS_TOPB_LCDdraw (nakreslit vyplněný obdélník přes celou obrazovku).

== SDS_TOPB_LCDdraw ==

Kreslení do bufferu.

Nejprve si určíte, jaký vůbec grafický prvek chcete do bufferu nakreslit:

unsigned int DrawTYPE

== 0 : draw a single PIXEL, coordinates: X0,Y0 (the X1,Y1 is ignored)
== 32 : draw one-pixel-wide LINE, coordinates: from X0,Y0 to X1,Y1
== 64 : draw one-pixel-wide ELLIPSE, coordinates: from X0,Y0 to X1,Y1
== 96 : draw RECTANGLE, coordinates: from X0,Y0 to X1,Y1
== 224 : only FLIP (same as STS_TOPB_LCDflip)

Parametr ''FLAGS'' je bitová kombinace, která navíc svým významem závisí na hodnotě ''DrawTYPE''.

unsigned int FLAGS

(MSB to LSB): 7 6 5 4 3 2 1 0
RSVD RSVD RSVD [FLIP] [SCI SCI] [FILLED] [ADDITIONALFLAG]

RSVD
-> set to zero

[FLIP]
-> set to 1 if you want immediate FLIP after this function is done

[SCI]

| pixel/line/ellipse/rectangle |
------------+------------------------------+-
SCI == 00 | SET PIXEL (to color) |
SCI == 01 | CLEAR PIXEL (to background) |
SCI == 11 | INVERT PIXEL |

[FILLED]
-> applies only to rectangle and ellipse (when set to 1, fills the internals, following SCI)

[ADDITIONALFLAG]
-> used ONLY for DrawTYPE==224 where if ADDITIONALFLAG==1 then buffer is CLEARED and then FLIP

Jak lze vidět, je potřeba vždy připravit správnou kombinaci bitů.

POZOR: starší firmware v TOPB desce ne vždy umí všechny možné grafické prvky - zašlete výrobek výrobci pro aktualizaci firmware.

Funkce kreslí do paměťového screenbufferu. Tento buffer se teprve musí překlopit do fyzického LCD pro aktualizaci zobrazeného obrazu. To můžete provést ihned (FLAGS:FLIP) nebo až "nakonec" pokud kreslíte více různých prvků (pak použijte funkci LCDflip).

Funkci SDS_TOPB_LCDdraw() lze také použít pro smazání celé obrazovky LCD:

SDS_TOPB_LCDdraw(0, 0, 0, 0, 224, 1);

== SDS_TOPB_LCDtext ==

Psaní textu do bufferu - tato funkce umí psát pouze na jeden vybraný řádek. Pevný font, ale můžete určit barvu popředí a pozadí. Pozice se určuje pomocí X0 a Y0, kde X0 určuje posun o daný počet pixelů na řádku, a Y0 vybírá řadek (LCD má čtyři řádky).

X0
-> pixel coordinate [0..131]

ROW
-> row coordinate [0..3]

char *ptr
-> pointer to string

unsigned int len
-> length of text (excluding trailing zero)
-> maximum = 22 characters per line

Parametr ''FLAGS'' je bitová kombinace, která navíc svým významem závisí na hodnotě ''DrawTYPE''.

unsigned int FLAGS

(MSB to LSB): 7 6 5 4 3 2 1 0
RSVD RSVD RSVD [FLIP] [SCI SCI] RSVD RSVD

RSVD
-> set to zero

[FLIP]
-> set to 1 if you want immediate FLIP after this function is done

[SCI]

| text |
------------+----------------+-
SCI == 00 | POSITIVE |
SCI == 01 | NEGATIVE |
SCI == 11 | INVERT TEXT |

Jak lze vidět, je potřeba vždy připravit správnou kombinaci bitů.

== SDS_TOPB_LCDbitmap ==

Přenos malé bitmapy (blok pixelů) do bufferu - tato funkce umí přenést bitmapu na jeden určený řádek. Pro pokrytí celého displaye, který má čtyři řádky, je tedy potřeba použít tuto funkci čtyřikrát, vždy se správnými parametry.

Pravidla jsou opět podobná jako u předchozích funkcí.

Parametr ''FLAGS'' je bitová kombinace.

unsigned int FLAGS

(MSB to LSB): 7 6 5 4 3 2 1 0
RSVD RSVD RSVD [FLIP] RSVD RSVD RSVD [ADDITIONALFLAG]

RSVD
-> set to zero

[FLIP]
-> set to 1 if you want immediate FLIP after this function is done

[ADDITIONALFLAG]
-> the (whole) LCD buffer is filled with a DEFAULT LOGO

== Vzorový program ==

Následující program čte stav klávesnice a zobrazuje tento stav na LCD.

<pre>
void main(void)
{

unsigned int changed;
unsigned int actual;
unsigned int intermediatePresses[6];

char text[32];

printf("START LCD+KEYBOARD TEST\n");

// clear LCD [OP:111] = FLIP ; clear -> ADDITIONALFLAG = 1
SDS_TOPB_LCDdraw(0,0,0,0, 0b11100000, 0b00000001); // --- identical to:
SDS_TOPB_LCDflip(1);

// main loop
for (;;)
{

// read last known KBD status
SDS_TOPB_keyboard_status(&changed, &actual, &intermediatePresses);

if (changed)
{
// print to console
printf("%d %d [%d %d %d %d %d %d]\n", changed, actual,
intermediatePresses[0],
intermediatePresses[1],
intermediatePresses[2],
intermediatePresses[3],
intermediatePresses[4],
intermediatePresses[5]);

// setup text
snprintf(text, 22+1, "actual = %02X ", actual);

// write to LCD
SDS_TOPB_LCDtext(0, 0, 0, text, strlen(text));

// redraw LCD
SDS_TOPB_LCDflip(0);
}

// wait 100 msecs = try to make it longer, to simulate harsh conditions = and you will see it yet works !
wait(100);

}

}

</pre>

----

== Upozornění ==

Pro správnou funkci sběrnice DALI je vyžadována verze firmware v sandwich desce (TOPB3) od 5.12.2016 nebo novější.

Pokud nemáte jistotu, jakou verzi firmware v sandwich desce máte, zašlete ji výrobci pro bezplatnou aktualizaci.

Pokud se pokusíte používat DALI sběrnici se zařízení které má starší firmware, nebude vám to fungovat.

== Sběrnice DALI ==

Sběrnice DALI je určena k řízení osvětlovacích a dalších prvků, připojených na společnou sběrnici, a to buď skupinově nebo po jednotlivých adresách. Sestava se vždy skládá z DALI-MASTER (což je zde zařízení SDS) a prvků DALI-SLAVE (např. světla, chytré vypínače a tlačítka, pohybová čidla, reléové moduly, atd.).

DALI pracuje na principu dvoudrátové sběrnice, po které se přenáší data mezi DALI-MASTER a vybranými DALI-SLAVE prvky. Buď ve směru BROADCAST, kdy DALI-MASTER posílá zprávu úplne všem DALI-SLAVE prvkům na dané fyzické sběrnici, nebo skupinově (vybraným skupinám GROUPS jednotlivých DALI-SLAVE prvků), popř. zcela adresně (reaguje jen ten DALI-SLAVE prvek, který má konkrétní adresu na kterou je zpráva poslána).

Seznam jednotlivých zpráv, které lze posílat, je uveden v normě DALI a na příslušné stránce této WiKi. Samozřejmě výrobci každého DALI-SLAVE zařízení si určují své detaily (jaké zprávy jsou podporovány daným zařízením a jak na ně bude zařízení reagovat).

Pro použití SDS jako DALI MASTER prvku je potřeba zakoupit SDS osazené doplňkovou [[SDS_BIG:_DALI|sandwich DALI deskou]].

== Adresování prvků na sběrnici DALI ==

Vše je popsáno do detailu v příslušné normě.

Na sběrnici je jeden MASTER (zde SDS) a množství SLAVE jednotek - vždy záleží na konkrétním projektu.

Každá SLAVE jednotka má tyto tři určené adresy:
* BROADCAST - globální konstatní adresa (0xFF) na které slyší naprosto všechny jednotky najednou
* GROUP - skupinová adresa, tuto adresu má jedna nebo více jednotek společně, nastavuje se na určenou hodnotu podle projektu
* DIRECT - přímá adresa, tuto adresu má vždy jen jedna jediná jednotka, nastavuje se na určenou hodnotu podle projektu

Každé SLAVE jednotce na sběrnici DALI se tedy nastaví tyto tři hodnoty (0xFF a dvě volitelné). Jaké to jsou, si samozřejmě musíte určit vy sami - protože jen vy víte, jak a co máte zapojeno a k čemu to chcete použít. Skupinové adresy jsou výhodné, protože se dá ovládat více prvků jedním příkazem (např. hromadně zhasnout skupina světel) najednou = bez nutnosti postupného posílání adresných příkazů každé jednotce, což pak není vizuálně pěkné (světla v tomto příkladu by zhasínala postupně).

Jak se adresy nastavují - záleží VŽDY na výrobci dané SLAVE jednotky. Někdy je prostřednictvím jumperů/DIP spínačů/atd. na výrobku, a někdy se to dělá tak, že se jednotka připojí k osobnímu počítači a přes určený program se do ní zapíší tyto adresy (skupinová a přímá adresa).

Pokud se nějaká už instalovaná jednotka pokazí a je potřeba ji nahradit novou (výměna) pak je potřeba tuto novou jednotku správně naadresovat - nastavit jí stejné adresy jaké měla ta původní kterou chcete vyměnit.

== Příkazy sběrnice DALI ==

Základní příkazy jsou předepsány normou DALI.

== Způsob komunikace ==

MASTER (SDS) umí poslat příkaz do SLAVE jednotek na sběrnici, a současně umí i přijmout odpověď (pokud je očekávána odpověď od SLAVE jednotky).

Pokud je požadována odpověď (např. na dotaz na nastavenou hodnotu nebo stav tlačítka), pak je potřeba na MASTERu použít příkazy které adresují SLAVE jednotky pouze přes přímou (DIRECT) adresu !

Vzorový program ukazuje jak poslat dotaz (stav stmívání světla) na SLAVE jednotku a jak ho zobrazit na LCD.

== SDS_TOPB_DALI_getReceivedResponse ==

Tuto funkci je potřeba použít pro ověření výsledku.

unsigned int DALI_RX;
unsigned int RXflags;
RXflags = SDS_TOPB_DALI_getReceivedResponse(&DALI_RX);

Do "DALI_RX" se uloží data (payload) přijatá na sběrnici (pokud jsou platná), a do "RXflags" se uloží stav úspěchu komunikace.

RXflags má několik bitů v dolních 8bitech (LSB) které jsou důležité (vše ostatní v této proměnné je nepoužito):

MSB LSB
31 ... 3 2 1 0
RXflags reserved INVDATA REPEATED FAILURE GOT-RX

* Nejdůležitější je flag "GOT-RX". Pokud je tento bit nastaven na 1, pak jsou data v "DALI_RX" platná a mají se použít.
* Flag "FAILURE" označuje chybový stav sběrnice (zkrat, nadproud, chyba HW vysílače).
* Flag "REPEATED" informuje že došlo k automatickému opakování vysílaní (dle požadavku normy DALI, viz text dále)
* Flag "INVDATA" označuje příjem neplatných dat (chyba slave, dva nebo více slave vysílají odpověd najednou - viz příkaz COMPARE, apod.)

Váš FULL-C program musí správně reagovat na všechny tyto flagy a stavy.

Pro detekci přítomnosti SLAVE na vybrané adrese se s výhodou dá využít bit-0 (GOT-RX). Tento bit je také potřeba vždy ověřit (je-li nastavený) pro ověření správného přijetí odpovědi ze SLAVE (očekává-li se odpověď).

Pro detekci zkratu sběrnice se přímo využívá bit-1 ("FAILURE").

Pro informaci, že příkaz byl automaticky opakován, je nastaven bit-2 ("REPEATED"). Tento bit v podstatě můžete ignorovat, je jen informativní.

Pro detekci rušení na sběrnici, nebo detekci dvou (či více) SLAVEs se stejnou adresou (chyba konfigurace SLAVEs), se využije bit-3 (INVDATA).

== Speciální funkce ==

SDS poskytuje přímý přístup na sběrnici. Chcete odeslat příkaz (vždy 2 bajty, adresa+data), tak je SDS jako MASTER odešle. A následně se pokusí přijmou 1 byte odpovědi.

Některé příkazy ale vyžadují opakování - to specifikuje norma DALI. U následujících příkazů to podle této normy dělá SDS za vás (tzn. FULL-C program zavolá funkci pro odeslání příkazu jednou, a SDS to zopakuje dvakrát, tzn. automaticky odešle 2x na sběrnici).

Automatizované opakování v rámci SDS je zde z důvodů že norma DALI požaduje opakování s maximálním prodlením pod 100 milisekund - což typicky přes FULL-C zajistit nelze.

'''Automaticky opakované příkazy''' při odesílání z SDS MASTER do sběrnice DALI:

* Pro ADDRESS==0x01 a současně DATA v hodnotě z rozsahu 0x20 (včetně) do 0x80 (včetně)
* Pro ADDRESS==0xA5 (Initialize CMD) a libovolné DATA
* Pro ADDRESS==0xA7 (Randomize CMD) ale jen když DATA==0x00

== Doplňující informace ==

Pokud je na sběrnici DALI porucha, všechny Slave jednotky typicky přecházejí do "neřízeného" režimu. To znamená, že se přestanou chovat podle toho jak byly přes DALI nastaveny, a typicky přejdou do "100% zapnuto" režimu. Toto je v pořádku a výrobci slave jednotek to tak chtějí (tím pádem se slave jednotky chovají jen jako "hloupý napáječ světla" který se dá ovládat vypínačem).

Pozn. před spuštění DALI komunikace vyčkejte ve svém programu (ideálně) několik vteřin, zejména je-li délka vedení DALI sběrnice velká (dlouhé kabely). Chvíli trvá než se celý systém "nabije" a dokud se to nestane, nelze přenášet DALI příkazy.

== Vzorový program ==

Následující program kombinuje jednoduchou obsluhu LCD (display) a DALI sběrnice (SDS je DALI-MASTER). Tento program inicializuje prvek na sběrnici a nastaví jej do režimu zapnutá-zátěž (rozsvíceno) - program využívá BROADCAST adresy a je potřeba jej spustit s jediným DALI-SLAVE prvkem (ballast). Vzorový program je zde pro ověření funkčnosti. Samozřejmě jakmile máte více prvků, tak je můžete adresovat - to už vyžaduje znalost funkce sběrnice DALI a jejího aplikačního protokolu.

Program po inicializaci prvku začne dokola provádět smyčku ztlumení a zesílení světla (DOWN a UP):
<pre>

unsigned int DALI_TXRX(unsigned char Address, unsigned char Data, unsigned char * Answer)
{
unsigned int DALI_RX;
unsigned int RXflags;
unsigned int timeout;

// one call to SDS_TOPB_DALI_transmitCommand()
// blocks typically for 60 msecs
// and it includes both DALI-TX and DALI-RX procedures
// so after the call is done (function returns)
// we do have our response from DALI-SLAVE

// try to call the function until it goes through
// (typically, the function return is zero because
// it is already TXing the previous command)
timeout = 200; // 200 msec is very enough
while (1)
{
if (SDS_TOPB_DALI_transmitCommand(Address, Data) == 0)
{
// no success yet, most-likely the TOPB is busy with the previous frame

// can we wait more ?
if (timeout == 0)
{
// failed -> exit
if (Answer) *Answer = 0xFF; // 0xFF is default DALI failure value
// exit as FAILED
return 0;
} else
{
timeout--;
wait(1);
};
} else
{
// success - TX OK
break;
}
}

// OK, we have succeeded with TX

// read the response
RXflags = SDS_TOPB_DALI_getReceivedResponse(&DALI_RX);

// RXflags:
// bit 0 of RXflags contains the GOT-RX flag
// you SHOULD use value in RXflags and follow it up

// only the lowest 8 bits make sense
/* if (Answer) */
{
*Answer = (unsigned char)DALI_RX;
}

// exit as OK
return 1;

}

void main(void)
{
unsigned int i;

unsigned int success;
unsigned char DALI_Answer;

char chx[32];

// console
printf("DALI EXAMPLE\n");

// TOPB LCD: clear and flip
SDS_TOPB_LCDflip(1);
// TOPB LCD: print to buffer
SDS_TOPB_LCDtext(0,0,0,"DALI EXAMPLE", 12);
// TOPB LCD: flip
SDS_TOPB_LCDflip(0);

// --- start sending DALI command ---

//
printf("SENDING 'RESET' TO 'BROADCAST'\n");
success = DALI_TXRX(0b11111111, 0b00100000, &DALI_Answer);
printf("success:%u (DALI-RX: %u)\n", success, DALI_Answer);

// give the DALI-SLAVE some time to reset
wait(50);

//
printf("SENDING 'QUERY-STATUS' TO 'BROADCAST'\n");
success = DALI_TXRX(0b11111111, 0b10010000, &DALI_Answer);
printf("success:%u (DALI-RX: %u)\n", success, DALI_Answer);

//
printf("SENDING 'RECALL-MAX-LEVEL' TO 'BROADCAST'\n");
success = DALI_TXRX(0b11111111, 0b00000101, &DALI_Answer);
printf("success:%u (DALI-RX: %u)\n", success, DALI_Answer);

//
printf("SENDING 'ON-AND-STEP-UP' TO 'BROADCAST'\n");
success = DALI_TXRX(0b11111111, 0b00001000, &DALI_Answer);
printf("success:%u (DALI-RX: %u)\n", success, DALI_Answer);

// --- demo loop ---

for (;;)
{
// some delay for show
wait(50);

// loop -> decrease light intensity
for (i = 0; i < 30; i++)
{
// some delay for show
wait(5);

// DALI COMMAND to BROADCAST-ADDR: "DOWN"
success = DALI_TXRX(0b11111111, 0b00000010, &DALI_Answer);

// DALI COMMAND to BROADCAST-ADDR: "QUERY-ACTUAL-LEVEL"
success = DALI_TXRX(0b11111111, 0b10100000, &DALI_Answer);
// info print to console
printf("set level: %u\n", DALI_Answer);
// info print to LCD
sprintf(chx, "%u ", DALI_Answer);
SDS_TOPB_LCDtext(0,2,0,chx, 15);
SDS_TOPB_LCDflip(0);
}

// some delay for show
wait(50);

// loop -> increase light intensity
for (i = 0; i < 30; i++)
{
// some delay for show
wait(5);

// DALI COMMAND to BROADCAST-ADDR: "UP"
success = DALI_TXRX(0b11111111, 0b00000001, &DALI_Answer);

// DALI COMMAND to BROADCAST-ADDR: "QUERY-ACTUAL-LEVEL"
success = DALI_TXRX(0b11111111, 0b10100000, &DALI_Answer);
// info print to console
printf("set level: %u\n", DALI_Answer);
// info print to LCD
sprintf(chx, "%u ", DALI_Answer);
SDS_TOPB_LCDtext(0,2,0,chx, 15);
SDS_TOPB_LCDflip(0);

}

}

}
</pre>

@@ Řádek 83: / Řádek 83: @@
 '''DOPORUČENÍ''': aktualizujte si firmware v SDS, v rámci této funkce došlo k řadě zlepšení z hlediska následné programové obsluhy odezvy na obsluhu tlačítek.
@@ Řádek 89: / Řádek 91: @@
 Funkce je dostupná ve FULL-C od verze 0x0D (tedy od 06/2022).
-Funkce zapisuje hodnoty do dvou předaných polí. Hodnoty jsou interně akumulovány ve firmware SDS, a předány FULL-C programu vždy při zavolání této funkce. Současně dojde k vynulování interních akumulátorů pro všechny tyto hodnoty v SDS. Tím pádem, každé jednotlivé zavolání této funkce, obdrží přesný počet stisků a uvolnění všech tlačítek, od okamžiku posledního volání této funkce.
+Funkce zapisuje hodnoty do dvou předaných polí. Hodnoty jsou interně akumulovány ve firmware SDS, a předány FULL-C programu vždy při zavolání této funkce. Současně dojde k vynulování interních akumulátorů pro všechny tyto hodnoty v SDS. Tím pádem, každé jednotlivé zavolání této funkce, obdrží přesný počet stisků a uvolnění všech tlačítek, od okamžiku posledního volání této funkce (pro úplnost: tato počítadla pro funkci _updn nejsou nulována voláním funkce SDS_TOPB_keyboard_status, ale pouze voláním funkce _updn).
@@ Řádek 106: / Řádek 108: @@
   releases[5] = počet "uvolnění" tlačítka TL5 od posledního volání této funkce
-Při zmáčknutí tlačítka prstem, dojde k započítání "stisku" a po uvolnění dojde k započítání "uvolnění". Jedno "kliknutí" na tlačítko tedy znamená jeden stisk a uvolnení.
+Při zmáčknutí tlačítka prstem, dojde k započítání "stisku" a po uvolnění dojde k započítání "uvolnění". Jedno "kliknutí" na tlačítko tedy znamená jeden stisk a uvolnění.
 SDS interně filtruje zákmity, takže uvedené hodnoty jsou předány už po filtraci.
@@ Řádek 260: / Řádek 262: @@
+{
-  unsigned int changed;
+  unsigned int changed, i;
   unsigned int actual;
-  unsigned int intermediatePresses[6];
+  unsigned int calculated[6];
+  unsigned int total[6];
   char text[32];
   printf("START LCD+KEYBOARD TEST\n");
-−
   // clear LCD [OP:111] = FLIP ; clear -> ADDITIONALFLAG = 1
   SDS_TOPB_LCDdraw(0,0,0,0, 0b11100000, 0b00000001); // --- identical to:
   SDS_TOPB_LCDflip(1);
-−
   // main loop
   for (;;)
+  {
-−
     // read last known KBD status
-    SDS_TOPB_keyboard_status(&changed, &actual, &intermediatePresses);
+    SDS_TOPB_keyboard_status(&changed, &actual, &calculated);
     if (changed)
@@ Řádek 283: / Řádek 286: @@
          // print to console
          printf("%d %d [%d %d %d %d %d %d]\n", changed, actual,
-         intermediatePresses[0],
+         calculated[0],
-         intermediatePresses[1],
+         calculated[1],
-         intermediatePresses[2],
+         calculated[2],
-         intermediatePresses[3],
+         calculated[3],
-         intermediatePresses[4],
+         calculated[4],
-         intermediatePresses[5]);
+         calculated[5]);
-−
         // setup text
-        snprintf(text, 22+1, "actual = %02X   ", actual);
+        snprintf(text, 22+1, "actual = %02X  ch = %02X ", actual, changed);
         // write to LCD
         SDS_TOPB_LCDtext(0, 0, 0, text, strlen(text));
-−
         // redraw LCD
         SDS_TOPB_LCDflip(0);
@@ Řádek 301: / Řádek 318: @@
     // wait 100 msecs = try to make it longer, to simulate harsh conditions = and you will see it yet works !
     wait(100);
@@ Řádek 306: / Řádek 324: @@
+}
 </pre>

@@ Řádek 11: / Řádek 11: @@
 Pro obsluhu klávesnice a displaye, můžete použít tyto funkce:
 <pre>
-          void SDS_TOPB_keyboard_status(unsigned int *changed, unsigned int *actual, unsigned int *intermediatePresses[6]);
+          void SDS_TOPB_keyboard_status(unsigned int *changed, unsigned int *actual, unsigned int *calculated[6]);
+         void SDS_TOPB_keyboard_updn(unsigned int *presses[6], unsigned int *releases[6]);
           void SDS_TOPB_LCDdraw(unsigned int X0, unsigned int Y0, unsigned int X1, unsigned int Y1, unsigned int DrawTYPE, unsigned int FLAGS);
           void SDS_TOPB_LCDtext(unsigned int X0, unsigned int ROW, unsigned int FLAGS, char *ptr, unsigned int len);
@@ Řádek 47: / Řádek 48: @@
 Každý stisk je zaznamenán, takže k dispozici pro FULL-C program je nejen aktuální stav každého tlačítka (stisknuto/uvolněno), ale i počet stisknutí mezi jednotlivými dotazy programu (takže když uživatel rychle mačká tlačítko, tak FULL-C program vždy ví, kolikrát to bylo).
-Pole ''intermediatePresses[6]'', navrácené touto funkcí, bude určeno pro počítání plných kliknutí (stisknutí+uvolnění) tlačítka TL1 až TL5. Tato funkce je k dispozici až ve firmware od 6/2022.
+=== SDS_TOPB_keyboard_status() ===
- intermediatePresses[0] = vždy nula (nepoužito)
+Pole ''calculated[6]'', navrácené touto funkcí, bude určeno pro počítání plných kliknutí (stisknutí+uvolnění) tlačítka TL1 až TL5. '''Tato funkce je k dispozici až ve firmware od 6/2022 - dřívější firmware neposkytuje hodnoty.'''
-Každé volání funkce, tato všechna počítadla intermediatePresses[] nuluje.
+ calculated[0] = vždy nula (nepoužito)
 "Plné kliknutí" znamená, že uživatel tlačítko TLx stisknul, a pustil. Tlačítko musí být stisknuto a uvolněno, aby se to započítalo. Dokud je pouze jen stisknuto, ještě stále není započítáno (jen to průběžně uvidíte v hodnotě ''actual''), započítáno jako "plný klik" bude až uživatel tlačítko uvolní.
@@ Řádek 79: / Řádek 83: @@
 '''DOPORUČENÍ''': aktualizujte si firmware v SDS, v rámci této funkce došlo k řadě zlepšení z hlediska následné programové obsluhy odezvy na obsluhu tlačítek.

@@ Řádek 49: / Řádek 49: @@
 '''SDS_TOPB_keyboard_status()''' je jedinou funkcí ve FULL-C, která zajišťuje kompletní obsluhu zjišťovaní stavu klávesnici. Volat tuto funkci je potřeba jen tak často, jak moc je potřeba mít nízkou odezvu.
-Prakticky všechny funkce lze řešit přes pole ''intermediatePresses[6]'', navrácené touto funkcí. Pro každé tlačítko, v tomto poli je udaný počet stisků které uživatel provedl, od posledního čtení této hodnoty prostřednictvím volání této funkce. Tzn. po každém zavolání funkce se tyto vnitřní počítadla nulují.
+Pole ''intermediatePresses[6]'', navrácené touto funkcí, bude určeno pro počítání plných kliknutí (stisknutí+uvolnění) tlačítka TL1 až TL5. Tato funkce je k dispozici až ve firmware od 6/2022.
   intermediatePresses[0] = vždy nula (nepoužito)
-  intermediatePresses[1] = počet stisků/uvolnění tlačítka TL1 od posledního čtení počtu stisků
+  intermediatePresses[1] = počet "plných kliknutí" tlačítka TL1 od posledního volání této funkce
-  intermediatePresses[2] = počet stisků/uvolnění tlačítka TL2 od posledního čtení počtu stisků
+  intermediatePresses[2] = počet "plných kliknutí" tlačítka TL2 od posledního volání této funkce
-  intermediatePresses[3] = počet stisků/uvolnění tlačítka TL3 od posledního čtení počtu stisků
+  intermediatePresses[3] = počet "plných kliknutí" tlačítka TL3 od posledního volání této funkce
-  intermediatePresses[4] = počet stisků/uvolnění tlačítka TL4 od posledního čtení počtu stisků
+  intermediatePresses[4] = počet "plných kliknutí" tlačítka TL4 od posledního volání této funkce
-  intermediatePresses[5] = počet stisků/uvolnění tlačítka TL5 od posledního čtení počtu stisků
+  intermediatePresses[5] = počet "plných kliknutí" tlačítka TL5 od posledního volání této funkce
-'''Pozor''', vždy se musíte podívat na obsah ''actual'' (pro každou jednotlivou položku [x]), aby jste dokázali rozlišit mezi tím, zda-li každá jednotlivá položka v intermediatePresses[x] je počet stisků nebo počet uvolnění konkrétního tlačítka TLx.
+Každé volání funkce, tato všechna počítadla intermediatePresses[] nuluje.
-Každé volání funkce tato všechna počítadla intermediatePresses[] nuluje.
+"Plné kliknutí" znamená, že uživatel tlačítko TLx stisknul, a pustil. Tlačítko musí být stisknuto a uvolněno, aby se to započítalo. Dokud je pouze jen stisknuto, ještě stále není započítáno (jen to průběžně uvidíte v hodnotě ''actual''), započítáno jako "plný klik" bude až uživatel tlačítko uvolní.
 Hodnota ''changed'' ukazuje, zda-li se od posledního zavolání funkce změnil stav některého z tlačítek. Jedná se o akumulovanou funkci, takže zachytí i více stisknutí a uvolnění tlačítka.
@@ Řádek 70: / Řádek 68: @@
   význam  0   0   0 TL5 TL4 TL3 TL2 TL1
-Příklad: od posledního volání funkce došlo ke změně stavu tlačítka TL1 a TL3, hodnota ''changed'' tedy bude 0b00000101 což je decimálně hodnota 5.
+Příklad: od posledního volání funkce došlo ke změně stavu (stisknuto/uvolněno) tlačítka TL1 a TL3, hodnota ''changed'' tedy bude 0b00000101 což je decimálně hodnota 5.
 Hodnota ''actual'' ukazuje aktuální stav tlačítka (bit v log1 = příslušné tlačítko stisknuto).
@@ Řádek 80: / Řádek 78: @@
 Příklad: v okamžiku volání funkce má právě uživatel stisknuté tlačítko TL5, hodnota ''actual'' tedy bude 0b00010000 což je decimálně hodnota 16.
-'''DOPORUČENÍ''': využívejte pouze hodnotu v "actual".
+'''DOPORUČENÍ''': aktualizujte si firmware v SDS, v rámci této funkce došlo k řadě zlepšení z hlediska následné programové obsluhy odezvy na obsluhu tlačítek.

@@ Řádek 65: / Řádek 65: @@
 Hodnota ''changed'' ukazuje, zda-li se od posledního zavolání funkce změnil stav některého z tlačítek.
-  bit     0   1   2   3   4   5   6   7
+  bit     7   6   5   4   3   2   1   0  (MSB ... LSB)
-  dec     1   2   4   8   16  32  64  128
+  dec     128 64 32  16   8   4   2   1
-  význam  TL1 TL2 TL3 TL4 TL5 0   0   0
+  význam  0   0   0 TL5 TL4 TL3 TL2 TL1
 Příklad: od posledního volání funkce stisknul uživatel tlačítko TL1 a TL3, hodnota ''changed'' tedy bude 0b00000101 což je decimálně hodnota 5.
@@ Řádek 73: / Řádek 73: @@
 Hodnota ''actual'' ukazuje aktuální stav tlačítka (bit v log1 = příslušné tlačítko stisknuto).
-  bit     0   1   2   3   4   5   6   7
+  bit     7   6   5   4   3   2   1   0  (MSB ... LSB)
-  dec     1   2   4   8   16  32  64  128
+  dec     128 64 32  16   8   4   2   1
-  význam  TL1 TL2 TL3 TL4 TL5 0   0   0
+  význam  0   0   0 TL5 TL4 TL3 TL2 TL1
 Příklad: v okamžiku volání funkce má právě uživatel stisknuté tlačítko TL5, hodnota ''actual'' tedy bude 0b00010000 což je decimálně hodnota 16.