Zobrazení zdroje stránky FULL-C: TopBoard functions

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 *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);
         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() ===

'''SDS_TOPB_keyboard_status()''' je jednou ze dvou 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.

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.'''

 calculated[0] = vždy nula (nepoužito)
 calculated[1] = počet "plných kliknutí" tlačítka TL1 od posledního volání této funkce
 calculated[2] = počet "plných kliknutí" tlačítka TL2 od posledního volání této funkce
 calculated[3] = počet "plných kliknutí" tlačítka TL3 od posledního volání této funkce 
 calculated[4] = počet "plných kliknutí" tlačítka TL4 od posledního volání této funkce 
 calculated[5] = počet "plných kliknutí" tlačítka TL5 od posledního volání této funkce 

Každé volání funkce, tato všechna počítadla calculated[] 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.

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

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

 bit     7   6   5   4   3   2   1   0  (MSB ... LSB)  
 dec     128 64 32  16   8   4   2   1   
 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.

'''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.


=== SDS_TOPB_keyboard_updn() ===

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.


 presses[0] = vždy nula (nepoužito)
 presses[1] = počet "stisků" tlačítka TL1 od posledního volání této funkce 
 presses[2] = počet "stisků" tlačítka TL2 od posledního volání této funkce 
 presses[3] = počet "stisků" tlačítka TL3 od posledního volání této funkce 
 presses[4] = počet "stisků" tlačítka TL4 od posledního volání této funkce 
 presses[5] = počet "stisků" tlačítka TL5 od posledního volání této funkce 
 
 releases[0] = vždy nula (nepoužito)
 releases[1] = počet "uvolnění" tlačítka TL1 od posledního volání této funkce 
 releases[2] = počet "uvolnění" tlačítka TL2 od posledního volání této funkce 
 releases[3] = počet "uvolnění" tlačítka TL3 od posledního volání této funkce 
 releases[4] = počet "uvolnění" tlačítka TL4 od posledního volání této funkce 
 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í.

SDS interně filtruje zákmity, takže uvedené hodnoty jsou předány už po filtraci.


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