FULL-C: onewire functions - Historie editací

Adamn v 15. 1. 2023, 14:15

2023-01-15T14:15:55Z

Adamn v 9. 1. 2023, 15:34

2023-01-09T15:34:55Z

Adamn v 9. 1. 2023, 12:46

2023-01-09T12:46:14Z

Adamn v 9. 1. 2023, 11:50

2023-01-09T11:50:57Z

Adamn v 9. 1. 2023, 10:21

2023-01-09T10:21:40Z

Adamn v 31. 12. 2022, 10:54

2022-12-31T10:54:25Z

Adamn v 31. 12. 2022, 09:28

2022-12-31T09:28:44Z

Adamn v 28. 12. 2022, 11:46

2022-12-28T11:46:34Z

Adamn v 28. 12. 2022, 11:35

2022-12-28T11:35:37Z

Adamn v 28. 12. 2022, 11:34

2022-12-28T11:34:09Z

@@ Řádek 186: / Řádek 186: @@
 Možné hodnoty:
-                | Pvalue | Pvalue |
+                | Pvalue | Pvalue | Pvalue | Pvalue | Pvalue | Pvalue |  Pvalue |  Pvalue |  Pvalue |  Pvalue |  Pvalue |  Pvalue |  Pvalue |  Pvalue |  Pvalue |  Pvalue |
-  Pxxx | význam |   0    |   1    |
+  Pxxx | význam |   0    |   1    |   2    |   3    |   4    |   5    |    6    |    7    |    8    |    9    |   10    |   11    |   12    |   13    |   14    |   15    |
-  -----+--------+--------+--------+-- ...
+  -----+--------+--------+--------+--------+--------+--------+--------+---------+---------+---------+---------+---------+---------+---------+---------+---------+---------+
-   | tRSTL  | 440    |
+   | tRSTL  | 440    | 460    | 480    | 500    | 520    | 540    |  560    |  580    |  600    |  620    |  640    |  660    |  680    |  700    |  720    |  740    |
-   | tMSP   |  58    |
+   | tMSP   |  58    |  58    |  62    |  62    |  64    |  66    |   68    |   70    |   72    |   74    |   76    |   76    |   76    |   76    |   76    |   76    |
-   | tW0L   |  52    |
+   | tW0L   |  52    |  54    |  56    |  58    |  60    |  62    |   64    |   66    |   68    |   70    |   70    |   70    |   70    |   70    |   70    |   70    |
-   | tREC0  |   2.75 |
+   | tREC0  |   2.75 |   2.75 |   2.75 |   2.75 |   2.75 |   2.75 |    5.25 |    7.75 |   10.25 |   12.75 |   15.25 |   17.75 |   20.25 |   22.75 |   25.25 |   25.25 |
-   | Rwpu   | 500    |
+   | Rwpu   | 500    | 500    | 500    | 500    | 500    | 500    | 1000    | 1000    | 1000    | 1000    | 1000    | 1000    | 1000    | 1000    | 1000    | 1000    |
-Výchozí tovární Pvalue = (DOPLNIT HODNOTU).
+Výchozí tovární hodnota '''Pvalue = 6''' (vybráno vždy po startu zařízení - změníte zavolání funkce).
 Všechny hodnoty jsou v jednotce [MIKROSEKUNDA], mimo hodnotu Rwpu (weak pull-up resistor), který je v jednotce [OHM].
-TODO doplnit tabulku
+Pozn. Volání této funkce pro HW který změnu parametrů nepodporuje (tedy SDS který NEMÁ podtyp DS84), nemá význam - nic se neprovede.
-Pozn. Volání této funkce pro HW který změnu parametrů nepodporuje (tedy SDS který NEMÁ podtyp DS84), nemá význam - nic se neprovede.
+Váš program musí umět poznat stavy tohoto čidla, předtím, než váš FC program vůbec nějakou změřenou teplotní hodnotu zpracuje. Proto je potřeba nejprve zkontrolovat hodnotu, kterou SDS pro dané čidlo poskytuje, a také stavové slovo. SDS totiž automaticky, opakovaně, spouští úkol převodu teploty (a dalších veličin, dle čidla), a průběh a (zejména) výsledek lze sledovat v patřičných položkách (systémové indexy). Tyto položky musí váš FC program kontrolovat, a teprve jsou-li v pořádku, lze výslednou aktualizovanou veličinu (např. poslední změřenou teplotu) použít dále v programu.

@@ Řádek 41: / Řádek 41: @@
 POZOR! Tato funkce provede odstranění všech (neuzamčených) nalezených OneWire slave chipů z dané sběrnice, a následně provede nové naplnění seznamu těmi chipy, které se povede nově najít. Může dojít ke změně pořadí, počítejte s tím ve svém programu !
-POZOR! Pokud chcete jen zjistit přítomnost nějakého chipu s vámi určenou hodnotou FamilyID, použijte funkci SDS_onewire_search_bus() - tato funkce neprovede zásah do seznamu nalezených chipů.
+POZOR! Pokud chcete '''jen zjistit''' přítomnost nějakého chipu s vámi určenou hodnotou FamilyID, a nic nikde nepřepsat, použijte funkci SDS_onewire_search_bus() - tato funkce neprovede zásah do seznamu nalezených chipů.
@@ Řádek 58: / Řádek 58: @@
 Průběh je potřeba sledovat čtením patřičných indexů (2000 až 3000) pro jednotlivé pozice OneWire zařízení. Každé nalezené OneWire zařízení musí mít platný ROMcode - jinak je ROMcode nulový (= zařízení na dané pozici nenalezeno).
-Zavolání funkce (nebo identicky, spuštění rescanu z webového rozhraní), vynuluje obsah index (busA) 2498 nebo (busB) 2996. V okamžiku dokončení rescanu je do tohoto odpovídajícího indexu zapsán výsledek. Váš program tak může čekat, dokud se výsledek v daném indexu neobjeví (nebo dokud nedojde k timeoutu, což si ale musíte ošetřit ve svém programu sami).
+Zavolání funkce '''SDS_rescan_onewire()''' (nebo identicky, spuštění rescanu z webového rozhraní), vynuluje obsah index (busA) 2498 nebo (busB) 2996. V okamžiku dokončení rescanu je do tohoto odpovídajícího indexu zapsán výsledek. Váš program tak může čekat, dokud se výsledek v daném indexu neobjeví (nebo dokud nedojde k timeoutu, což si ale musíte ošetřit ve svém programu sami).
 <u>Hodnoty v indexu 2498, respektive 2996:</u>
@@ Řádek 85: / Řádek 85: @@
 Existují ale i chipy ve formě součástky (např. SMD pouzdro), které pak jsou umístěny (zapájeny) na nějakém připojeném HW k SDS, a přes OneWire sběrnici můžete snadno identifikovat, jaký HW je právě (krátkodobě či trvale) připojen, a podle toho provést další akce.
-Váš FC program tedy periodicky volá funkci SDS_onewire_search_bus(), za účelem detekce připojeného chipu s určeným identifikátorem (FamilyID, konkrétně pro chipy DS1990A je to 0x01). Pokud je na sběrnici chip nalezen, je jeho ROM code zaznamenám do dočasné tabulky (dočasného seznamu), který je přístupný přes určené systémové položky (indexy). Váš program si tento seznam, po provedené aktualizaci, přečte, a vyhodnotí - a podle nalezených ROM code záznamů pak ví, jaký je v té chvíli ke sběrnici připojený chip (nebo více chipů) s daným typem (FamilyID).
+Váš FC program tedy periodicky volá funkci '''SDS_onewire_search_bus()''', za účelem detekce připojeného chipu s určeným identifikátorem (FamilyID, konkrétně pro chipy DS1990A je to 0x01). Pokud je na sběrnici chip nalezen, je jeho ROM code zaznamenám do dočasné tabulky (dočasného seznamu), který je přístupný přes určené systémové položky (indexy). Váš program si tento seznam, po provedené aktualizaci, přečte, a vyhodnotí - a podle nalezených ROM code záznamů pak ví, jaký je v té chvíli ke sběrnici připojený chip (nebo více chipů) s daným typem (FamilyID).
 V případě realizace přístupového systému, pak typicky váš program má seznam povolených chipů (seznam jejich ROM code, který je zadán např. přes UserWEB webové rozhraní výrobku, nebo chipy jsou "naučeny" prvním přiložením atd.), a pokud později uživatel takový chip ke sběrnici připojí (např. přiloží na čtecí hlavici), tak jej SDS nalezne (váš FC program po zavolání této funkce), a program to pak vyhodnotí (platný/neplatný resp. známý/neznámý, ROM code). Typicky se v případě přiložení chipu aktivuje některé z relé, které pak např. ovládne zámek dveří (v případě přístupového systému) nebo provede jinou akci atd.
@@ Řádek 109: / Řádek 109: @@
 Prohledání sběrnice A lze spouštět nezávisle na prohledání sběrnice (B), a naopak. Prohledání pro obě samostatné sběrnice lze spouštět i současně.
-  TODO příklad FC kódu - chystá se
+Jednoduchý příklad:
 '''POZOR''' - prohledání sběrnice přeruší aktuálně probíhající komunikaci s 1-W zařízením. Například, pokud SDS má na určené sběrnici např. teploměry, a právě na některém z teploměrů provádí měření teploty, tak toto bude přerušeno, a měření zahozeno. SDS provede prohledání sběrnice, a pak se teprve vrátí zpět k původní činnosti, která ale bude zahájena znovu. Použití této funkce, pro prohledání sběrnice, je proto potřeba zvážit - respektive navrhnout využití sběrnice A a B tak, aby např. jedna sběrnice byla výhradně určena pro např. teploměrné chipy (které trvale obsluhuje SDS) a druhá pro dočasně připojované čipy (např. přístupové chipy DS1990A), které si neustále prohledává váš FC program. Takto nedojde ke kolizi činnosti na stejné sběrnici, a aktivita na jedné sběrnici nebude přerušována aktivitou na druhé.

@@ Řádek 93: / Řádek 93: @@
 * 2496 = počet nalezených OW zařízení na sběrnici (A) s daným FamilyID
 * 2497 = výsledek pokusu prohledat sběrnici (A) - toto vždy sledujte jako první
-* 2986 .. 2993 = jednotlivé ROM code pro nalezené OW zařízení na sběrnici (A) s daným FamilyID (nebo 0 pro prázdnou pozici), zapsáno vždy jako pole 8 bajtů
+* 2986 .. 2993 = jednotlivé ROM code pro nalezené OW zařízení na sběrnici (B) s daným FamilyID (nebo 0 pro prázdnou pozici), zapsáno vždy jako pole 8 bajtů
-* 2994 = počet nalezených OW zařízení na sběrnici (A) s daným FamilyID
+* 2994 = počet nalezených OW zařízení na sběrnici (B) s daným FamilyID
-* 2995 = výsledek pokusu prohledat sběrnici (A) - toto vždy sledujte jako první
+* 2995 = výsledek pokusu prohledat sběrnici (B) - toto vždy sledujte jako první
 Nalezených zařízení může být i mnohem více než osm, a tak je to do indexu (2496, 2994) zapsáno - ale ROM kódy jsou k dispozici pouze pro prvních osm nalezených zařízení (čistě z důvodu paměťového omezení).

← Starší verze		Verze z 9. 1. 2023, 11:50
Řádek 110:		Řádek 110:

	TODO příklad FC kódu - chystá se		TODO příklad FC kódu - chystá se
		+
		+	'''POZOR''' - prohledání sběrnice přeruší aktuálně probíhající komunikaci s 1-W zařízením. Například, pokud SDS má na určené sběrnici např. teploměry, a právě na některém z teploměrů provádí měření teploty, tak toto bude přerušeno, a měření zahozeno. SDS provede prohledání sběrnice, a pak se teprve vrátí zpět k původní činnosti, která ale bude zahájena znovu. Použití této funkce, pro prohledání sběrnice, je proto potřeba zvážit - respektive navrhnout využití sběrnice A a B tak, aby např. jedna sběrnice byla výhradně určena pro např. teploměrné chipy (které trvale obsluhuje SDS) a druhá pro dočasně připojované čipy (např. přístupové chipy DS1990A), které si neustále prohledává váš FC program. Takto nedojde ke kolizi činnosti na stejné sběrnici, a aktivita na jedné sběrnici nebude přerušována aktivitou na druhé.

@@ Řádek 24: / Řádek 24: @@
 Funkci '''SDS_disable_onewire()''' je v takovém případě potřeba zavolat hned na začátku FULL-C programu - tím se vyřadí automatické spuštění 1-Wire sběrnice, které se samozřejmě nemůže na omezeném HW (kde chybí 1-Wire Master chip) povést. Dojde tedy k šesti pokusům o navázání komunikace, a všechny logicky selžou - a pro zajištění stabilního provozu, je vhodné tomuto celému procesu jednoduše předejít (touto funkcí).
 ''Poznámka:'' podobná funkce je k dispozici i pro SD kartu, tedy funkce SDS_disable_sdc(), viz příslušný návod.
@@ Řádek 34: / Řádek 36: @@
 Mohou existovat důvody, proč by jste chtěli prohledání aktivovat i z programu, potom zavolejte funkci SDS_rescan_onewire(BUSnr).
 POZOR! Tato funkce provede odstranění všech (neuzamčených) nalezených OneWire slave chipů z dané sběrnice, a následně provede nové naplnění seznamu těmi chipy, které se povede nově najít. Může dojít ke změně pořadí, počítejte s tím ve svém programu !
@@ Řádek 40: / Řádek 44: @@
-== SDS_rescan_onewire: Naplánování prozkoumání (rescan) OneWire sběrnice ==
+== SDS_rescan_onewire: Naplánování vynuceného prohledání (rescan) OneWire sběrnice ==
 Dostupné ve firmware od 06/2022.
-Provede zcela stejnou akci, jako je uživatelem stisknuté tlačítko na webovém rozhraní - tedy rescan vybrané sběrnice OneWire.
+Provede zcela stejnou akci, jako je uživatelem stisknuté tlačítko na webovém rozhraní - tedy master rescan vybrané sběrnice OneWire.
 Spuštění rescanu je časováno, tedy dojde k němu s pevným zpožděním od zavolání této funkce.
 * sběrnice A : BUSnr = 0
 * sběrnice B (pozor není na SDS-STSW a odvozených): BUSnr = 1
@@ Řádek 55: / Řádek 60: @@
 Zavolání funkce (nebo identicky, spuštění rescanu z webového rozhraní), vynuluje obsah index (busA) 2498 nebo (busB) 2996. V okamžiku dokončení rescanu je do tohoto odpovídajícího indexu zapsán výsledek. Váš program tak může čekat, dokud se výsledek v daném indexu neobjeví (nebo dokud nedojde k timeoutu, což si ale musíte ošetřit ve svém programu sami).
+<u>Hodnoty v indexu 2498, respektive 2996:</u>
 * -1 = chyba, rescan se neprovedl
 *  0 = neprobíhá rescan
@@ Řádek 64: / Řádek 68: @@
 *  8 = rescan úspěšně dokončen a bylo nalezeno alespoň 1 zařízení
-Počet nalezených OneWire zařízení viz indexy (busA) 2499 a (busB) 2997.
+Master rescan lze spustit pouze, pokud je sběrnice OneWire povolena, a pouze pokud už systém obsluhy OneWire naběhnul (index '''2998''' na hodnotě 8).
@@ Řádek 74: / Řádek 77: @@
 '''Pouze pro FULL-C verze 0x11 a dále.'''
-Nejčastěji je požadavek na okamžité prohledání sběrnice, kdy se hledá, zda-li je připojen specifický OneWire chip. Přitom je zde současně požadavek na to, aby se seznam dříve nalezených OneWire zařízení (např. teploměry) tímto prohledáním nezměnil.
+Nejčastěji je požadavek na okamžité prohledání sběrnice, kdy se hledá, zda-li je připojen specifický OneWire chip. Přitom je zde současně požadavek na to, aby se základní seznam, dříve nalezených OneWire zařízení (např. teploměry), tímto prohledáním nezměnil.
 Typické použití je pro realizaci přístupových systémů, kde se sběrnice opakovaně (pořád dokola) (z vašeho FC programu) prohledává, zda-li na sběrnici byl připojen identifikační chip např. typu DALLAS iButton typ DS1990A. Každý takový chip má unikátní ROM code (od výrobce), a tím se dají jednoznačně od sebe chipy odlišit.
@@ Řádek 86: / Řádek 89: @@
 V případě realizace přístupového systému, pak typicky váš program má seznam povolených chipů (seznam jejich ROM code, který je zadán např. přes UserWEB webové rozhraní výrobku, nebo chipy jsou "naučeny" prvním přiložením atd.), a pokud později uživatel takový chip ke sběrnici připojí (např. přiloží na čtecí hlavici), tak jej SDS nalezne (váš FC program po zavolání této funkce), a program to pak vyhodnotí (platný/neplatný resp. známý/neznámý, ROM code). Typicky se v případě přiložení chipu aktivuje některé z relé, které pak např. ovládne zámek dveří (v případě přístupového systému) nebo provede jinou akci atd.
-TODO příklad FC kódu - chystá se
+Klíčové indexy:

@@ Řádek 19: / Řádek 19: @@
 == Vypnutí všech sběrnic ==
 Mohou existovat důvody, kdy nechcete, aby SDS obsluhovalo své OneWire sběrnice. Zejména pokud máte SDS kde není fyzicky OneWire sběrnice osazena (speciální OEM varianty), kdy nechcete aby SDS zbytečně čekalo na nalezení Master chipů.
@@ Řádek 33: / Řádek 38: @@
 POZOR! Pokud chcete jen zjistit přítomnost nějakého chipu s vámi určenou hodnotou FamilyID, použijte funkci SDS_onewire_search_bus() - tato funkce neprovede zásah do seznamu nalezených chipů.

@@ Řádek 11: / Řádek 11: @@
           void SDS_rescan_onewire(unsigned int BUSnr);
-          int SDS_onewire_config(unsigned int BUSnr, unsigned int Pxxx, unsigned int Pvalue);
+         void SDS_onewire_config(unsigned int BUSnr, unsigned int Pxxx, unsigned int Pvalue);
           void SDS_onewire_search_bus(unsigned int busID, unsigned int familyID);
@@ Řádek 88: / Řádek 88: @@
 TODO doplnit tabulku

@@ Řádek 13: / Řádek 13: @@
            int SDS_onewire_config(unsigned int BUSnr, unsigned int Pxxx, unsigned int Pvalue);
-          void SDS_onewire_scan_for_chip(busID, familyID);
+          void SDS_onewire_search_bus(busID, familyID);
 </pre>
@@ Řádek 32: / Řádek 32: @@
 POZOR! Tato funkce provede odstranění všech (neuzamčených) nalezených OneWire slave chipů z dané sběrnice, a následně provede nové naplnění seznamu těmi chipy, které se povede nově najít. Může dojít ke změně pořadí, počítejte s tím ve svém programu !
-POZOR! Pokud chcete jen zjistit přítomnost nějakého chipu s vámi určenou hodnotou FamilyID, použijte funkci SDS_onewire_scan_for_chip() - tato funkce neprovede zásah do seznamu nalezených chipů.
+POZOR! Pokud chcete jen zjistit přítomnost nějakého chipu s vámi určenou hodnotou FamilyID, použijte funkci SDS_onewire_search_bus() - tato funkce neprovede zásah do seznamu nalezených chipů.
@@ Řádek 47: / Řádek 47: @@
 Existují ale i chipy ve formě součástky (např. SMD pouzdro), které pak jsou umístěny (zapájeny) na nějakém připojeném HW k SDS, a přes OneWire sběrnici můžete snadno identifikovat, jaký HW je právě (krátkodobě či trvale) připojen, a podle toho provést další akce.
-Váš FC program tedy periodicky volá funkci k detekci připojeného chipu s určeným identifikátorem (FamilyID, konkrétně pro chipy DS1990A je to 0x01). Pokud je na sběrnici chip nalezen, je jeho ROM code zaznamenám do dočasné tabulky (dočasného seznamu), který je přístupný přes určené systémové položky (indexy). Váš program si tento seznam, po provedené aktualizaci, přečte, a vyhodnotí - a podle nalezených ROM code záznamů pak ví, jaký je v té chvíli ke sběrnici připojený chip (nebo více chipů) s daným typem (FamilyID).
+Váš FC program tedy periodicky volá funkci SDS_onewire_search_bus(), za účelem detekce připojeného chipu s určeným identifikátorem (FamilyID, konkrétně pro chipy DS1990A je to 0x01). Pokud je na sběrnici chip nalezen, je jeho ROM code zaznamenám do dočasné tabulky (dočasného seznamu), který je přístupný přes určené systémové položky (indexy). Váš program si tento seznam, po provedené aktualizaci, přečte, a vyhodnotí - a podle nalezených ROM code záznamů pak ví, jaký je v té chvíli ke sběrnici připojený chip (nebo více chipů) s daným typem (FamilyID).
 V případě realizace přístupového systému, pak typicky váš program má seznam povolených chipů (seznam jejich ROM code, který je zadán např. přes UserWEB webové rozhraní výrobku, nebo chipy jsou "naučeny" prvním přiložením atd.), a pokud později uživatel takový chip ke sběrnici připojí (např. přiloží na čtecí hlavici), tak jej SDS nalezne (váš FC program po zavolání této funkce), a program to pak vyhodnotí (platný/neplatný resp. známý/neznámý, ROM code). Typicky se v případě přiložení chipu aktivuje některé z relé, které pak např. ovládne zámek dveří (v případě přístupového systému) nebo provede jinou akci atd.

@@ Řádek 10: / Řádek 10: @@
           void SDS_disable_onewire(void);
           void SDS_rescan_onewire(unsigned int BUSnr);
            int SDS_onewire_config(unsigned int BUSnr, unsigned int Pxxx, unsigned int Pvalue);
 </pre>
@@ Řádek 26: / Řádek 29: @@
 Mohou existovat důvody, proč by jste chtěli prohledání aktivovat i z programu, potom zavolejte funkci SDS_rescan_onewire(BUSnr).
-== Nastavení časovaní pro vybrané sběrnice ==
+== Nastavení časovaní pro vybranou OneWire sběrnici ==
 '''Pouze pro SDS varianty DS84.'''