FULL-C: I2C functions - Historie editací

Adamn v 17. 11. 2022, 18:47

2022-11-17T18:47:45Z

Adamn v 17. 11. 2022, 18:47

2022-11-17T18:47:26Z

Adamn v 2. 6. 2022, 06:38

2022-06-02T06:38:58Z

Adamn v 2. 6. 2022, 06:37

2022-06-02T06:37:56Z

Adamn v 29. 11. 2021, 10:13

2021-11-29T10:13:03Z

Adamn: Založena nová stránka s textem „ 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,…“

2021-11-29T09:59:29Z

Založena nová stránka s textem „ 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,…“

Nová stránka

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.

== Funkce pro komunikaci s rozšiřující (sandwich) deskou, pomocí sběrnice I2C ==
__NOTOC__
Zařízení SDS-BIG lze osadit doplňující/rozšiřující (sandwich) deskou. Většina těchto desek komunikuje přes COM3 respektive TOPB protokol; nicméně některé naopak využívají I2C sběrnici.

Desky které komunikují přes TOPB protokol totiž obsahují svůj vlastní mikroprocesor, který se stará o nějakou složitou funkci (např. obsluhu displaye, nebo nějaké komunikační sběrnice). Nicméně desky, u kterých není tato dodatečná inteligence potřebná, se do SDS-BIG připojují přes interní I2C sběrnici (konektor SC-2).

Pro zajištění naprosté univerzálnosti, je umožněno FULL-C programu bez omezení komunikovat po této I2C sběrnici. Tato sběrnice je sdílena s dalšími prvky uvnitř SDS, což nevadí, protože firmware v SDS-BIG to hlídá a správné časuje svou komunikaci versus komunikaci od FULL-C programu.

Program může použít tyto funkce:
<pre>
void SDS_I2C_write(unsigned int address, char *ptr, unsigned int len);
unsigned int SDS_I2C_read(unsigned int address, char register, char *ptr, unsigned int len);
</pre>

== Základní popis ==

K dispozi jsou dvě funkce, jedna čistě pro zápis datových bajtů po I2C sběrnici, druhá pro čtení (se zápisem jednoho bajtu hned na začátku). Tyto funkce by měli pokrýt většinu běžných I2C periférií.

Výrobce SDS nabízí vlastní sandwich desky, které komunikují přes I2C. Nic však nebrání tomu, aby jste si mohli připojit své desky či vlastní I2C periférii (za předpokladu dodržení návrhových a provozních omezení) - kontaktujte výrobce pro detaily.

== Deska SW-RELE6 ==

První oficiální I2C rozšiřující deska pro SDS-BIG je deska SW-RELE6. Z hlediska I2C sběrnice je realizována pomocí dvou 8-bit expandérů (TCA9554A). Pomocí uvedených dvou FULL-C funkcí lze s touto deskou plně komunikovat a plně obsloužit všechny vstupní i výstupní periférii, které tam jsou osazeny.

== UPOZORNĚNÍ ==

POZOR: '''podpora pro I2C komunikaci ve FULL-C je k dispozici až s verzí FULL-C 0x0C''' !

← Starší verze		Verze z 17. 11. 2022, 18:47
Řádek 63:		Řádek 63:
	== Deska SW-RTC-COM-O6 ==		== Deska SW-RTC-COM-O6 ==

−	Další oficiální rozšiřující blok je [[SDS_BIG:_SW-RTC-COM-O6:SW-RTC-COM-O6]].	+	Další oficiální rozšiřující blok je [[SDS_BIG:_SW-RTC-COM-O6\|SW-RTC-COM-O6]].

@@ Řádek 47: / Řádek 47: @@
 '''Hodnoty vrácené funkcí SDS_i2c_rw():'''
-* v případě úspěchu vrací funkce počet zapsaných (když je jen zápis) resp. přečtených bajtů (když je jakékoliv čtení)
+* v případě úspěchu (vše zapsáno či přečteno) vrací funkce (0)
-* v případě neúspěchu chybu (-1)
+* v případě NACK vrací funkce (-1)
-* TODO doplnit (timeout)
+* v případě obecné chyby vrací funkce (-2)
 == Deska SW-RELE6 ==
-První oficiální I2C rozšiřující deska pro SDS-BIG je deska [[SDS_BIG:_SW-RELE6|SW-RELE6]]. Z hlediska I2C sběrnice je realizována pomocí dvou 8-bit expandérů (TCA9554A). Pomocí uvedených dvou FULL-C funkcí lze s touto deskou plně komunikovat a plně obsloužit všechny vstupní i výstupní periférii, které tam jsou osazeny.
+Jedna z oficiálních I2C rozšiřujících bloků pro SDS-BIG je deska [[SDS_BIG:_SW-RELE6|SW-RELE6]]. Z hlediska I2C sběrnice je realizována pomocí dvou 8-bit expandérů (TCA9554A). Pomocí uvedených dvou FULL-C funkcí lze s touto deskou plně komunikovat a plně obsloužit všechny vstupní i výstupní periférii, které tam jsou osazeny.
 Veškerý popis obsluhy desky  [[SDS_BIG:_SW-RELE6|SW-RELE6]] je na odkazované stránce.

← Starší verze		Verze z 2. 6. 2022, 06:38
Řádek 54:		Řádek 54:
	== Deska SW-RELE6 ==		== Deska SW-RELE6 ==

−	První oficiální I2C rozšiřující deska pro SDS-BIG je deska SW-RELE6. Z hlediska I2C sběrnice je realizována pomocí dvou 8-bit expandérů (TCA9554A). Pomocí uvedených dvou FULL-C funkcí lze s touto deskou plně komunikovat a plně obsloužit všechny vstupní i výstupní periférii, které tam jsou osazeny.	+	První oficiální I2C rozšiřující deska pro SDS-BIG je deska [[SDS_BIG:_SW-RELE6\|SW-RELE6]]. Z hlediska I2C sběrnice je realizována pomocí dvou 8-bit expandérů (TCA9554A). Pomocí uvedených dvou FULL-C funkcí lze s touto deskou plně komunikovat a plně obsloužit všechny vstupní i výstupní periférii, které tam jsou osazeny.
		+
		+	Veškerý popis obsluhy desky [[SDS_BIG:_SW-RELE6\|SW-RELE6]] je na odkazované stránce.

@@ Řádek 37: / Řádek 37: @@
 Funkce v případě zápisu nerozlišuje co jednotlivé bajty "znamenají" - protože z hlediska I2C sběrnice je to nepodstatné - v dokumentaci k perifériím je ale často provedeno rozdělení na "registr" a "data". Zde to jednoduše dejte vše dohromady, do pole pro zápis, pěkně hned za sebe.
 Funkce se vrátí FULL-C programu po úplném provedení. V případě úspěchu vrací funkce počet zapsaných (když je jen zápis) resp. přečtených bajtů (když je jakékoliv čtení), v případě neúspěchu chybu (-1).
-Podpora PMBUS/SMBUS kdy periférie sama určí délku zápisu je implementována - předpokladem je ale že musíte vždy dodat dostatečné (ideálně maximálně) velký buffer pro čtení (RdPtr/RdLen).
+Prioritu k přístupu na I2C sběrnici má obsluha OneWire rozhraní (které se provádí přes jiné chipy interně připojené na I2C sběrnici, uvnitř SDS). Tato obsluha je vám zcela skryta a nemusí se o ni nijak starat, firmware v SDS se o to postará trvale automaticky samo. Nicméně, pokud budete chtít neustále masivně přistupovat ze svého FULL-C programu na sběrnici I2C, bude občas volání neúspěšné, protože prioritu si vezme SDS samo pro svou obsluhu I2C. Toto je však extrémní případ, který nastane jen někdy když pokud budete opravdu neustále ve smyčce ve svém programu na I2C přistupovat. Ve firmware je přístup ošetřen mutexy, takže nedojde ke kolizi, ale může teoreticky dojít k timeoutu, který je indikován do vašeho programu chybovou hodnotou - je potřeba tedy všechny chybové hodnoty správně ošetřit a eventuálně příkaz opakovat.

@@ Řádek 12: / Řádek 12: @@
 Program může použít tyto funkce:
 <pre>
-         void SDS_I2C_write(unsigned int address, char *ptr, unsigned int len);
+          int SDS_I2C_rw(unsigned int address, char *WrPtr, unsigned int WrLen, char *RdPtr, unsigned int RdLen);
 </pre>
@@ Řádek 22: / Řádek 21: @@
 Výrobce SDS nabízí vlastní sandwich desky, které komunikují přes I2C. Nic však nebrání tomu, aby jste si mohli připojit své desky či vlastní I2C periférii (za předpokladu dodržení návrhových a provozních omezení) - kontaktujte výrobce pro detaily.