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

 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.

== Síťové funkce: odeslání UDP paketu ==

Zařízení SDS umožňuje odeslat UDP paket, vytvořený z parametrů předaných FULL-C programem.

Za tímto účelem jsou k dispozici tyto dvě funkce:
<pre>
         void udp_send(unsigned int IP0, unsigned int IP1, unsigned int IP2, unsigned int IP3, unsigned int Port, void * PayloadData, unsigned int PayloadLength);
 unsigned int udp_send_status(void);
</pre>


== Princip ==

SDS po zavolání funkce '''udp_send()''' vytvoří jeden úplný UDP paket, a ten odešla na zadanou IP adresu.

Pro kontrolu průběhu a úspěchu či chyby, je k dispozici funkce '''udp_send_status()'''.


== Příklad ==

V tomto příkladu odesílá SDS jeden UDP paket, na cílový stroj s adresou 192.168.1.110 na UDP port 1234.

<pre>
void main(void)
{
 unsigned int status;
 unsigned int payloadLength;
 unsigned char * payload;

 printf("START \n");
 
 // nejprve si vytvorime obsah paketu
 // - toto je priklad, vyuzijeme zde kousek heap pameti, lze to i jinak

 // bude to rekneme 64 bajtu
 payloadLength = 64;

 // ziskame docasnou pamet pro uchovani obsahu
 payload = (unsigned char *)malloc(payloadLength);

 // a pokud jsme obdrzeli pamet...
 if (payload != 0)
 {
   // nejak vyplnime payload . . .
   sprintf((char *)payload, "Hello World");

   // go

   printf("sending UDP packet...\n");
   udp_send(192,168,1,110, 1234, (void *)payload, payloadLength);

   // docasnou pamet uz nepotrebujeme
   free(payload); payload = 0;

   // pockame na dokonceni odesilani UDP paketu
   status = udp_send_status();
   while (status == 1)
   {
     status = udp_send_status();
   }

   // zpracujeme vysledek
   if (status == 2)
   {
     // uspech
     printf("DONE OK \n");
   } else
   {
     // UDP paket nebyl odeslan, chyba
     printf("ERROR: %u \n", status);
   }

 } else
 {
   // malloc() se nepovedl...
   printf(" out of memory \n");
 }

}
</pre>


== Stavové hodnoty ==

Program musí použít volání funkce '''udp_send_status()''' pro zjištění okamžitého stavu.

  udp_send_status()         význam
 -------------------------+-----------------------------------------------------------------------
  0                       |  klid, žádná akce nebyla zahájena
  1                       |  právě probíhá odesílání, čekejte
  2                       |  úspěch, UDP paket byl odeslán na cílový stroj
  3                       |  místo UDP paketu byl odeslán ARP paket (protože SDS zatím neví MAC adresu cílového stroje) (zopakujte odesílání UDP později) (UDP paket nebyl teď odeslán)
  4                       |  nebylo dokončeno předchozí odesílání (nový požadavek přišel dříve, než se dokončil předchozí) (nový požadavek na odeslání UDP není proveden)
  5                       |  funkce byla zavolána s neplatnými parametry (UDP paket nebyl odeslán)
  6                       |  není k dispozici dostatek paměti (UDP paket nebyl odeslán)

__NOTOC__