Zobrazení zdroje stránky FULL-C: serial bus functions

FULL-C

== Funkce pro práci se sériovými sběrnicemi ==

__NOTOC__


Zařízení SDS mají k dispozici jednu nebo více sériových sběrnic, které lze přímo ovládat z FULL-C programu.

Program může použít tyto funkce:
<pre>
         void SDS_serial_config(unsigned int busID, unsigned int BaudRateCfg, unsigned int DataSizeCfg, unsigned int StopBitsCfg, unsigned int ParityCfg);
         void SDS_serial_writeCH(unsigned int busID, unsigned char writeChar);
         void SDS_serial_write(unsigned int busID, void *ptr, unsigned int len);
 unsigned int SDS_serial_read(unsigned int busID, void *ptr, unsigned int maxlen);
</pre>


== Sériové sběrnice (UART) ==

Sériová sběrnice umožňuje připojit další prvky a zařízení ke každému SDS. Výhodou je, že data se posílají sériově, což vyžaduje "jen jeden drát" v každém směru.


Každé zařízení SDS má k dispozici následující sériové sběrnice (které jsou dostupné prostřednictvím FULL-C funkcí):

* COM1 - busID == 1
* COM3 - pouze prostřednictvím funkcí SDS_TOPB_xxxx()
* COM6 - busID == 6

Je čistě na vás, jaký HW připojíte ke COM1 a jaký ke COM6. 

Výrobek SDS-BIG napevno připojuje RS485 ke sběrnici COM1, přičemž se navíc sám vnitřně stará o přepínaní směru master budiče linky RS485.

COM6 je k dispozici vždy jako nezávislá duplexní sériová linka (UART) s 3V3 CMOS logikou. COM6 je určeno pro připojení komunikačních modulů jako je GSM, LoRa, MBUS a další.


== Sběrnice RS485 na SDS-BIG ==

Zařízení SDS-BIG má specifika pro své použití - '''musíte přesně sledovat návod''' zde: [[SDS_BIG:_RS485]]. 


== Konfigurace ==

Využijte funkci SDS_serial_config(). Potřebné parametry jsou následující:

* busID       - viz seznam výše, určuje kterou sériovou sběrnici chcete nastavit
* BaudRateCfg - určuje rychlost sériového přenosu (např. 9600, nebo 115200 bps)
* DataSizeCfg - určuje kolik datových bitů má jedno slovo přenášené po lince, možnosti jsou 9 nebo 8 (běžně je to 8)
* StopBitsCfg - určuje kolik stop-bitů má jedno slovo přenášené po lince, možnosti jsou 0, 1 nebo 2 (běžně je to 1)
* ParityCfg   - určuje jaký typ má případný paritní bit v každém slově přenášeném po lince, možnosti jsou 1=odd, 2=even, 0=none (běžně to je 0)


 Pozor! 

Pokud je ParityCfg nenulové, '''musí''' být DataSizeCfg napevno '''nastaven na 9'''. Nastavte to na 9 bez obav, protože data samotné zůstávají stále na osmi bitech, přičemž ten devátý je právě pro paritu. Obvyklá chyba je, že nastavíte ParitCfg nenulově (na 1 nebo 2) ale zapomenete dát DataSizeCfg na 9, a směr vysílání z SDS pak nefunguje !

 Informace

Každou sériovou linku (neplatí pro COM3) musíte nejprve, jednou na začátku, před použitím (čtení či zápis) nastavit právě touto funkcí.


== Zápis do sériové linky (výstup dat ze SDS) ==

Využijte funkci SDS_serial_writeCH() pro zápis jednoho znaku, popř. SDS_serial_write() pro zápis více (tj. 'len') znaků.


== Čtení ze sériové linky (vstup dat do SDS) ==

SDS obsahuje vnitřní vyrovnávací buffer, pro případ že by FULL-C program nestíhal číst data tak rychle, jak do SDS po sériové lince přicházejí. Ovšem kapacita tohoto bufferu je omezená.

Využijte funkci SDS_serial_read() pro čtení jednoho nebo více znaků (čte až 'maxlen' znaků do vámi přichystané oblasti na kterou ukazuej 'ptr').


== Příklad ==

Vzorový příklad, který komunikuje po sběrnici COM6 rychlostí 9600bps a využívá EVEN paritu. Tento příklad opakovaně odesílá pět bajtů dat (nějaký příkaz) a pak vypisuje do konzole vše co přijal

<pre>
unsigned char buf[128];

void main(void)
{

 // 6 -> SETUP COM6
 // 9 -> we have 8bit data word + 1bit parity
 // 1 -> one stop bit
 // 2 -> even parity
 SDS_serial_config(6, 9600, 9, 1, 2);

 // loop for ever
 for (;;)
 {

   printf("TX...\n");

   // send cmd to slave
   SDS_serial_writeCH(6, 0x10);
   SDS_serial_writeCH(6, 0x5b);
   SDS_serial_writeCH(6, 0x00);
   SDS_serial_writeCH(6, 0x5b);
   SDS_serial_writeCH(6, 0x16);

   // waiting for slave
   wait(1000);

   // read all from slave
   for (;;)
   {
     int rd, i;

     // try to read up to 64 bytes
     rd = SDS_serial_read(6, (void *) &buf[0], 64);

     // got anything ?
     if (0 == rd) break;

     // print all we got so far
     for (i = 0; i < rd; i++)
     {
       printf("%02x ", buf[i]);
     }

     printf("\n");

   }

   // wait before repeating
   wait(1000);
 }

}
</pre>

== Příklad ==

Řada příkladů je k dispozici na našem fóru, např. zde: https://forum.sds.an-d.cz//viewtopic.php?pid=6854#p6854 a další.