Yacht Devices YDPG-01N Uživatelská příručka k softwaru brány Python

© 2024 Yacht Devices Ltd. Dokument YDPG-002. 13. března 2024 Web: https://www.yachtd.com/
NMEA 2000® je registrovaná ochranná známka National Marine Electronics Association.
SeaTalk NG je registrovaná ochranná známka společnosti Raymarine UK Limited. Garmin® je registrovaná ochranná známka společnosti Garmin Ltd. MicroPython obsažený v tomto produktu je distribuován pod licencí MIT (MIT):
Copyright (c) 2013–2017 Damien P. George a další
Tímto se bezplatně uděluje povolení jakékoli osobě, která získá kopii tohoto softwaru a související dokumentace files (dále jen „Software“), nakládat se softwarem bez omezení, včetně, bez omezení, práv používat, kopírovat, upravovat, slučovat, publikovat, distribuovat, sublicencovat a/nebo prodávat kopie softwaru a umožnit osobám komu je k tomu Software poskytnut, za následujících podmínek:
Výše uvedené upozornění na autorská práva a toto upozornění na povolení budou součástí všech kopií nebo podstatných částí Softwaru.
SOFTWARE JE POSKYTOVÁN „TAK, JAK JE“, BEZ ZÁRUKY JAKÉHOKOLI DRUHU, VÝSLOVNÉ NEBO PŘEDPOKLÁDANÉ, VČETNĚ ZÁRUK PRODEJNOSTI, VHODNOSTI PRO KONKRÉTNÍ ÚČEL A NEPORUŠENÍ PRÁV. V ŽÁDNÉM PŘÍPADĚ NENESOU AUTOŘI NEBO NOSITELÉ AUTORSKÝCH PRÁV ODPOVĚDNÍ ZA JAKÉKOLI NÁROKY, ŠKODY NEBO JINÉ ODPOVĚDNOSTI, AŤ JIŽ PŘI SMLUVNÍ AKCI, deliktu ČI JINAK, VYPLÝVAJÍCÍ Z TOHOTO POUŽÍVÁNÍ NEBO V SOUVISLOSTI S NÍM SOFTWARE.

Obsah balení

Zařízení	1 ks
Tento manuál	1 ks
Samolepky pro těsnění USB konektoru	6 ks
USB kabel z Mini-B (M) do typu A (M), 20 cm	1 ks

Zavedení

Yacht Devices Python Gateway (dále jen Gateway nebo Device) je švýcarský armádní nůž pro připojení zařízení NMEA 0183 a NMEA 2000. Je vybaven dvěma sériovými porty (jeden pro příjem dat NMEA 0183 a jedním pro vysílání), rozhraním sběrnice CAN (pro NMEA 2000) a portem USB pro připojení k PC. USB připojení poskytuje dvě rozhraní současně: virtuální disk pro nahrávání uživatelských programů a sériový port s interaktivní výzvou Pythonu pro ladění uživatelského kódu nebo sledování jeho provádění.
Zařízení umožňuje vytvářet brány mezi NMEA 0183 a NMEA 2000, na úrovni sběrnice UART a CAN se standardní knihovnou Python nebo na úrovni NMEA s knihovnou zařízení Yacht. Umožňuje také připojit zařízení NMEA 0183 pracující při různých rychlostech, zpracovávat, filtrovat a upravovat data za běhu. Vnitřní disk zařízení může být použit uživatelským kódem k ukládání protokolů a dalších dat.
Brána hostí MicroPython (www.micropython.org). Jedná se o velmi populární implementaci programovacího jazyka Python 3, která obsahuje malou podmnožinu standardní knihovny Python. Výpočtový výkon brány je omezený a možná nebudete moci používat knihovny náročné na zdroje oblíbené na PC, jako je numpy, a můžete mít potíže s portováním kódu s dlouhým seznamem importů navržených pro PC.
Budete však mít veškerou flexibilitu a sílu jazyka Python a knihovna Yacht Devices vám umožní vytvářet drobné a elegantní programy. Napřample, dekódování AIS z NMEA 0183 na NMEA 2000 trvá asi 1.5 milisekundy na zprávu. Výkon je tedy dostatečný pro aplikace v reálném čase.
Vezměte prosím na vědomí, že programování vyžaduje znalost protokolů NMEA. Standard NMEA 0183 nebo standard NMEA 0183 lze získat od National Marine Electronics Association (www.nmea.org).

Záruka a technická podpora

Záruka na zařízení je platná po dobu dvou let od data zakoupení. Pokud bylo Zařízení zakoupeno v maloobchodní prodejně, může být při uplatnění záruky požadován prodejní doklad.

Záruka na Zařízení je ukončena v případě porušení pokynů v této příručce, porušení integrity nebo opravy nebo úpravy Zařízení bez písemného povolení výrobce.
Pokud je žádost o záruku přijata, musí být vadné zařízení zasláno výrobci.

Záruční závazky zahrnují opravu a/nebo výměnu zboží a nezahrnují náklady na instalaci a konfiguraci zařízení nebo zaslání vadného zařízení výrobci.
Odpovědnost výrobce v případě jakéhokoli poškození v důsledku provozu nebo instalace Zařízení je omezena na cenu Zařízení.

Výrobce nenese odpovědnost za případné chyby a nepřesnosti v návodech a návodech jiných firem.
Zařízení nevyžaduje žádnou údržbu. Pouzdro zařízení je nerozebíratelné.

V případě poruchy si před kontaktováním technické podpory prostudujte Přílohu A.
Výrobce přijímá aplikace v rámci záruky a poskytuje technickou podporu pouze prostřednictvím e-mailu nebo od autorizovaných prodejců.

Kontaktní údaje výrobce a seznam autorizovaných prodejců jsou zveřejněny na webmísto: http://www.yachtd.com/.

Specifikace produktu

Naše zařízení jsou dodávána s různými typy konektorů NMEA 2000. Modely s R na konci názvu modelu jsou vybaveny konektory NMEA 2000 a jsou kompatibilní s Raymarine SeaTalk NG.
Modely s N v příponě modelu jsou vybaveny konektory NMEA 2000 Micro Male. Viz výkresy konektorů v příloze C.

Parametr zařízení	Hodnota	Jednotka
Spotřeba proudu z USB (viz poznámka 1), maximální / průměr	90/37	mA
Podporována specifikace rozhraní USB	1.1, 2.0	—
USB zařízení VID / PID	0483/A217	hex
Napájecí objemtage ze sítě NMEA 2000	9..16	V
Odběr proudu ze sítě NMEA 2000 (viz poznámka 1), max. / prům.	68/32	mA
Ekvivalenční číslo zatížení	2	LEN
Galvanické oddělení mezi NMEA 2000 a USB	N/A
Galvanické oddělení mezi NMEA 2000 / USB a NMEA 0183	2	VRMS
Délka kabelu NMEA 0183	450	mm
Vstupní odpor přijímače NMEA 0183	96	kOhm
Vnitřní prostor na disku pro uživatelské programy	16	MB
Délka pouzdra zařízení	54	mm
Hmotnost	38	g
Rozsah provozních teplot	—20..+55	°С

Poznámka 1: Zařízení lze napájet z USB nebo z rozhraní NMEA 2000, výše uvedená měření jsou se zátěží 100 Ohm připojenou k portu NMEA 0183.
Yacht Devices Ltd prohlašuje, že tento produkt je v souladu se základními požadavky směrnice EMC 2014/30/EU a směrnice o rádiu a TTE 1999/5/EC.
Tento výrobek zlikvidujte v souladu se směrnicí WEEE. Elektronický odpad nemíchejte s domácím nebo průmyslovým odpadem.

Základy NMEA

Tato část popisuje základy sítí NMEA 0183 a NMEA 2000. Před připojením zařízení doporučujeme seznámit se s touto částí.
Tyto sítě se velmi liší na elektrické a softwarové úrovni. NMEA0183 také urazil dlouhou evoluční cestu, ale díky své jednoduchosti a levnosti je stále velmi oblíbený a široce používaný.

NMEA0183
Výchozí rychlost rozhraní NMEA 0183 je 4800 baudů. Vysokorychlostní rozhraní je 38400 baudů a bylo navrženo speciálně pro AIS, ale obvykle grafové plotry a displeje přístrojů umožňují jakákoli data (nejen AIS) na vysokorychlostním portu. Na grafovém plotru lze rychlost portu nakonfigurovat v nastavení.
NMEA 0183 používá různé kabely pro hovor (vysílání, TX) a poslech (příjem, RX) dat. Jeden mluvčí může být připojen k více posluchačům, ale posluchač může mít připojený pouze jeden mluvčí. Speciální zařízení nazývaná „multiplexery“ se používají ke spojení výstupu více mluvčích do jednoho proudu.NMEA 0183, až do verze 2.0 (1992), používal rozhraní RS-232 s „jednostranným zakončením“ s jednou TX linkou a jednou RX signálovou linkou (šedá na obrázku 2.a) a zemnicí linkou (tečkovaná na obrázku 2.a). jako reference pro signály TX a RX. Proto mají stará zařízení pouze tři vodiče.
Od verze 2.0 je NMEA 0183 založeno na «diferenciálním» rozhraní RS-422, které má dvě RX linky RX+ (lze také označit jako «A») a RX- (nebo «B»), dvě TX linky TX+ ( nebo «A», šedá na obrázku 2.b) a TX- (nebo «B», tečkovaná na obrázku 2) a uzemnění (není znázorněno na obrázku 2.b). Moderní zařízení používají pět vodičů.
Zařízení různých verzí lze připojit, ale s jednou opatrností. TX- («B») se nerovná zemní lince. svtage na lince TX (vytečkované na obrázku 2.b) se změní z 0 na 5 V a připojení této linky k zemnicímu vedení může způsobit zkrat.
Správná schémata zapojení jsou znázorněna na obrázku 3.
NMEA2000
Síť NMEA 2000 běží rychlostí 250 kbps a umožňuje připojení až 60 fyzických zařízení. Na rozdíl od NMEA 0183 zde nejsou žádní „mluvčí“ a „posluchači“. Všechna zařízení mohou „mluvit“ a všechna zařízení přijímat všechny zprávy.
Mnoho výrobců elektroniky představilo «značkové» verze NMEA 2000. Raymarine SeaTalk NG, Simrad SimNet, FurunoCAN se liší pouze typem použitých konektorů. V posledních letech však výrobci přecházejí na konektory NMEA 2000.

Páteř sítě (mezi 2 a 2 na obrázku 4) má dvě datové linky (nazývané CAN HIGH a CAN LOW a dvě napájecí linky. Napájecí linky by měly být připojeny k 12V napájecímu zdroji (viz 3 na obrázku 4). Nízkoenergetická zařízení , stejně jako naše brána, odebírají energii přímo z páteřní sítě.
Datové linky jsou „ukončeny“ na obou koncích 120-Ohm rezistorem (viz 2 na obrázku 4). Proto je odpor mezi linkami CAN mezi 60 a 120 Ohmy. Zařízení lze připojit na libovolné místo páteře (mezi terminátory). Kabel z páteře sítě do zařízení se nazývá propojovací kabel (viz 4 na obrázku 4). Naše zařízení lze připojit přímo k páteřní síti.
Vše výše uvedené znamená, že nemůžete jednoduše připojit bránu k portu NMEA 2000 vašeho grafového plotru a připojit k ní senzor NMEA 0183. Nejprve byste měli vytvořit jednoduchou síť NMEA 2000.
Mnoho výrobců nabízí «Starter Kit», který obsahuje vše, co je nutné k vytvoření základní sítě a připojení dvou zařízení:

pro Raymarine SeaTalk NG viz číslo dílu Raymarine T70134;

pro NMEA 2000 viz číslo dílu Garmin 010-11442-00.

Instalace USB ovladačů a připojení k PC

Zařízení je připojeno k portu USB počítače a je kompatibilní s protokolem USB 1.1 (1998) a novějším.
Je tedy kompatibilní se všemi moderními notebooky a PC. Zařízení lze napájet z portu USB (stejně jako z portu NMEA 2000) a po připojení uvidíte signály LED (jinak to znamená, že je kabel nebo port USB poškozen).
Pamatujte, že port USB není galvanicky izolován od sítě NMEA 2000. Při připojování k PC doporučujeme vypnout síť NMEA 2000 nebo od ní odpojit zařízení. Pokud potřebujete zachovat připojení NMEA 2000, zatímco je přístroj připojen přes USB, doporučujeme na lodi napájet notebook z baterie a odpojit jej od měniče. Jinak může potenciálový rozdíl vůči zemi poškodit port USB nebo zařízení.
Na softwarové úrovni brána implementuje dvě zařízení, která fungují současně:

USB disk (velkokapacitní paměťové zařízení; třída 8, podtřída 6);
sériový port (virtuální COM port; USB zařízení třídy 2, podtřída 2).

Sériové porty nevyžadují speciální ovladač ve Windows 10, Windows 11, Mac OS X a Linux; tyto operační systémy automaticky používají systémový ovladač. Ve starších verzích Microsoft Windows byste měli nainstalovat ovladač (.INF file pouze, žádný kód), který spojuje standardní systémový ovladač se zařízením.
USB konektor v zařízení je instalován v rovině s povrchem pouzdra. V důsledku toho nemusí být některé kabely zcela zasunuty, takže zůstane mezera asi 1 mm. To je normální, při připojování USB kabelu nepoužívejte sílu.

Instalace na Microsoft Windows 10 a novějšíZařízení používá ovladače Windows a mělo by se nainstalovat automaticky. Pro kontrolu instalace můžete otevřít «Správce zařízení» z «Ovládacího panelu» a zkontrolovat přítomnost disku YDPG-01 a sériového zařízení USB.

Instalace v systému Microsoft Windows 7 a starších verzích
Ovladač sériového portu USB pro systém Microsoft Windows lze nalézt v kořenové složce velkokapacitního paměťového zařízení (které nevyžaduje ovladač a mělo by být dostupné ihned po připojení) nebo v části Ke stažení na www.yachtd.com.Chcete-li zkontrolovat instalaci v systému Microsoft Windows 7 a starších verzích systému Microsoft Windows, spusťte „Správce zařízení“ z „Ovládací panely“. Pokud je «YDPG-01 Virtual COM Port» v sekci «Ostatní zařízení» (viz obrázek 6), spusťte «Aktualizovat software ovladače…» z kontextové nabídky, poté vyberte «Procházet můj počítač pro software ovladače» a na další klikněte na „Nechte mě vybrat ze seznamu ovladačů zařízení na mém počítači“.
Poté ze seznamu vyberte «Zobrazit všechna zařízení» nebo «Porty (COM a LPT)» a klikněte na «Další». Na další stránce vyberte «Have disk…» a vyberte YDPGDRV.INF z disku brány (viz obrázek 7).
Instalace na Linuxu (Ubuntu)
Zařízení používá systémový ovladač CDC ACM. Po připojení zařízení zadejte do terminálu příkaz dmesg.Na konci výstupu uvidíte vlastnosti Zařízení, název sériového portu a název disku. Chcete-li použít interní disk (viz obrázek 8, řádek 605.082413), pokud nebyl připojen automaticky, zadejte příkaz:
sudo mount /dev/sdb1 /mnt
Chcete-li připojit terminál k interaktivní výzvě Pythonu, zadejte (viz obrázek 8, řádek 604.002001):
obrazovka /dev/ttyACM0

Instalace na Mac OS X
Po připojení zařízení klikněte na ikonu Apple a vyberte položku nabídky „O tomto Macu“.
V okně, které se otevře, klikněte na tlačítka «Další informace...» a «Systémová zpráva...». Najděte «YDPG-01 Virtual COM Port» v podsekci USB v sekci Hardware, jak je znázorněno na obrázku 9.Ve vlastnostech zařízení na obrázku 9 můžete vidět sériové číslo zařízení a to, že disková jednotka zařízení již byla připojena. Tato brána má sériové číslo 00690001 a port brány pro použití v aplikacích je /dev/cu.usbmodem00690001

Instalace a připojení k NMEA

Zařízení nevyžaduje žádnou údržbu. Při rozhodování, kam zařízení nainstalovat, zvolte suché místo montáže. Vyhněte se místům, kde může být zařízení zaplaveno vodou, protože by mohlo dojít k jeho poškození.
Zařízení nemá žádné galvanické oddělení mezi porty NMEA 2000 a USB. Před připojením zařízení k USB si prosím přečtěte část III.

Připojení k NMEA 2000
Zařízení lze připojit přímo k páteřní síti NMEA 2000 bez spojovacího kabelu. Před připojením zařízení vypněte napájení sběrnice. Máte-li jakékoli dotazy týkající se použití konektorů, nahlédněte do dokumentace výrobce:
• Referenční příručka SeaTalk NG (81300-1) pro sítě Raymarine;
• Technická reference pro produkty Garmin NMEA 2000 (190-00891-00) pro sítě Garmin.
Po připojení zařízení zavřete zámek na připojení, abyste zajistili jeho voděodolnost a spolehlivost.
Zařízení je napájeno ze sítě NMEA 2000 (nebo USB) a má LED, která bliká červeně nebo zeleně.
Po zapnutí sítě NMEA 2000 nebo připojení k USB blikne LED na zařízení jednou zeleně, což znamená, že je zapnuto. Pokud se tak nestane, viz příloha A.
Připojení NMEA 2000 můžete zkontrolovat pomocí signálů LED, viz část V. Můžete také zkontrolovat, zda je zařízení přítomno v síti a zkontrolovat verzi firmwaru z mapového plotru. Podrobnosti naleznete v části VI.
Připojení k NMEA 0183
Připojení k síti NMEA 0183 se liší v závislosti na verzi propojovacího zařízení. Schémata připojení naleznete v části II. Nesprávné zapojení může poškodit zařízení!

Všimněte si, že mnoho zařízení NMEA 0183, včetně brány, má jiné barvy vodičů, než je uvedeno ve standardu. Před připojením zkontrolujte štítek na kabelu a/nebo dokumentaci.
Tabulka 1. NMEA 0183 Barvy vodičů

Signál	Standard NMEA 0183	Brána Pythonu
Talker TX+ (A)	Bílý	Červený
Talker TX- (B)	Hnědý	Černý
Posluchač RX+ (A)	Žluť	Žluť
Posluchač RX- (B)	Zelený	Modrý
Země	Černý	Jasný

Všechna připojení by měla být provedena při vypnutém napájení, aby se zabránilo náhodným zkratům během instalace.
Doporučuje se spojovat vodiče krimpováním nebo kroucením spíše než pájením. Pájené spoje se mohou v mořském prostředí rychle rozpadnout a vyžadují vzduchovou izolaci barvou nebo lakem.
Zařízení je dodáváno se sériovým portem konfigurovaným na 4800 baudů (standardní rychlost NMEA 0183). Když připojené zařízení odesílá zprávy touto rychlostí, jejich příjem je potvrzen signálem LED (viz část V). Chcete-li změnit rychlost v nastavení zařízení, viz část VII.

LED signály

Zařízení je vybaveno dvoubarevnou LED diodou, která indikuje stav zařízení. Zařízení po zapnutí vydá krátké zelené bliknutí, což znamená, že zařízení funguje.

Normální provozní signály
Během normálního provozu zařízení produkuje sérii pěti nebo šesti záblesků každých pět sekund. Blikání indikují stav rozhraní zařízení během posledních pěti sekund a mají následující význam:
• Bliká #1: ČERVENĚ, pokud je detekována chyba na sběrnici CAN (NMEA 2000), jinak ZELENÁ.
• Bliká #2: ZELENÁ, pokud jsou data přijímána ze sběrnice CAN, jinak ČERVENÁ.
• Bliká #3: ZELENÁ, když byla data odeslána na sběrnici CAN, jinak ČERVENÁ.
• Bliká #4: ZELENÁ, když je znak pro posun řádku (ASCII 10) přijat z UART (NMEA 0183), jinak ČERVENÁ.
• Bliká #5: ZELENÁ, pokud byl znak pro posun řádku odeslán do UART, jinak ČERVENÁ.
• Flash #6: definovaný uživatelem, nebude v sekvenci chybět, pokud uživatelský program nenastaví svůj stav (viz část VII).
Uživatelem definované blikání
Chování LED může být zcela řízeno uživatelským programem (barva, frekvence, trvání) a pokud blikající signály nevypadají jako normální provozní signály, měli byste se podívat do dokumentace dodané s uživatelským programem.
Žádáme vývojáře softwaru, aby nepoužívali blikající sekvence, které lze zaměnit s normálními provozními signály. Pro jednoduché úkoly doporučujeme použít šesté bliknutí v pořadí pro indikaci stavu aplikačního programu.
Jiné signály
Signály LED během aktualizace firmwaru jsou popsány v části VI. Signály během hardwarového resetu jsou popsány v části VIII.

Aktualizace firmwaru

Aktualizace firmwaru jsou k dispozici v části Ke stažení www.yachtd.com
Otevřete stažený archiv obsahující aktualizaci a přečtěte si soubor README.TXT file, který může obsahovat důležité informace o aktualizaci.
Zařízení nemá žádné galvanické oddělení mezi porty NMEA 2000 a USB, před připojením zařízení k USB si přečtěte část III.
Pokud je zařízení připojeno k síti NMEA 2000, vypněte jej nebo odpojte zařízení.
Připojte zařízení k USB portu notebooku nebo PC a zkopírujte YDPG01.BIN file z archivu aktualizací do kořenové složky interního disku Python Gateway. Odpojte zařízení od portu USB.
Po připojení k USB portu nebo zapnutí sítě NMEA 2000 se aktualizace spustí. Bude to trvat až 30 sekund, během procesu aktualizace nebudou svítit žádné signály LED. Během aktualizace neodpojujte bránu od zdroje napájení (USB nebo NMEA 2000).
Po dokončení aktualizace se bude kontrolka LED střídat mezi červenou a zelenou po dobu 5 sekund. Zavaděč poté aktualizaci odstraní file z disku Zařízení a přenese řízení na firmware.
Pokud zařízení již používá specifikovanou verzi firmwaru nebo pokud zařízení nemůže otevřít soubor file, nebo pokud file je poškozený, zavaděč okamžitě přenese řízení na firmware. To se děje bez jakékoli vizuální indikace.
Informace o zařízení, včetně verze firmwaru, se zobrazují v seznamu zařízení NMEA 2000 (SeaTalk NG, SimNet, Furuno CAN) nebo ve společném seznamu externích zařízení na mapovém plotru (viz Obrázek 10). Tento seznam je obvykle přístupný z nabídky «Diagnostika», «Externí rozhraní» nebo «Externí zařízení» plotru.

Programování zařízení

Interní disk zařízení obsahuje soubor boot.py file (který inicializuje knihovny a konfiguruje periferní zařízení zařízení, včetně rychlosti portů NMEA 0183) a main.py file (který je prázdný a je určen pro uživatelský kód). Tyto files jsou prováděny postupně zařízením, když je zapnuto.
Poskytne vám je váš dodavatel softwaru files a dodávaný software může také obsahovat knihovny (jiné files s příponou .py filepřípona jména). Některé knihovny mohou být v podsložkách. Zkopírujte vše files a složky z archivu obsahujícího software do kořenového adresáře interního disku Zařízení a souhlasíte s tím, že všechny nahradíte files novými.
Vypněte zařízení (odpojte jej od USB a od NMEA 2000). Při příštím zapnutí se spustí nový software. Protože signály LED lze ovládat uživatelským kódem, zeptejte se svého dodavatele softwaru, jak zkontrolovat, jak zkontrolovat stav programu pomocí signálů LED (viz také Část V).
Sériový port USB zařízení poskytuje přístup k interaktivní výzvě Pythonu (REPL). Zde můžete zkontrolovat stav spuštěného programu, zkontrolovat chyby při provádění nebo přerušit program a spustit svůj vlastní kód.
Sériový port můžete použít s terminálovým programem. Pro Microsoft Windows doporučujeme freeware Putty (k dispozici také pro Linux, lze jej stáhnout z www.putty.org). V systémech Linux a Mac OS X lze použít příkaz screen. Pro konfiguraci uvedenou v části III můžete k připojení použít následující příkazy:Pokud zařízení nemá spuštěný program, zobrazí se výzva Pythonu, jak je znázorněno na obrázku 11.
Pokud používáte terminál poprvé, použijte příkaz help() k získání základních informací o práci s terminálem a interaktivním promptem (REPL).
Spuštěný program nebo kód lze přerušit stisknutím Ctrl+C a (poté) lze interpret Pythonu soft resetovat stisknutím Ctrl+D. Měkký reset je mnohem rychlejší než restart zařízení (cyklus napájení) a nepřeruší relaci terminálu. Všimněte si, že po resetu softwaru se spustí boot.py a main.py. Interpret můžete resetovat pomocí Ctrl+W namísto Ctrl+D a přeskočit main.py při spuštění.Chcete-li otestovat připojení NMEA 2000, zadejte do REPL příkaz can.test() pro příjem a tisk deseti 29bitových zpráv s identifikátorem (zprávy NMEA 2000) ze sběrnice CAN. Chcete-li otestovat příjem NMEA 0183, zadejte příkaz uart_rx.test() pro příjem a tisk deseti řádků přijatých z NMEA 0183. Výsledek těchto dvou příkazů je znázorněn na obrázku 11.
Pokud jste však vývojář softwaru, nejpohodlnějším způsobem interakce s bránou je použití bezplatné aplikace Thonny, která je k dispozici pro systémy Microsoft Windows, Linux a OS X na adrese www.thonny.org. Toto jednoduché IDE umožňuje úpravy files přímo na bráně, zvýraznění syntaxe, uložení zálohy files na PC, spusťte a zastavte svůj kód, pracujte s REPL, vykreslujte proměnné atd. V možnostech Thonny (nabídka «Spustit», položka «Konfigurovat interpret…») byste měli vybrat «MicroPython (obecný)» a port brány na záložka „Tlumočník“.
Chcete-li otestovat novou instalaci, možná budete muset změnit rychlost NMEA 0183 v souboru boot.py file. Najděte řádky s podřetězcem baudrate=4800 a nahraďte 4800 rychlostí, kterou potřebujete. Chcete-li použít změny, můžete vypnout napájení zařízení nebo soft resetovat interpret Pythonu.
Chcete-li přidat šestý záblesk k sekvenci normálních provozních signálů (viz část V), zadejte REPL nebo přidejte do hlavního.py řádek led.green() nebo led.red() a vyberte odpovídající barvu.
Dokumentace knihovny Yacht Devices pro Python Gateway a kódyampsoubory jsou zveřejněny online na: http://www.yachtd.com/products/python_gateway/lib.html
Vezměte prosím na vědomí, že programování vyžaduje znalost protokolů NMEA. Kopii normy NMEA 2000 nebo NMEA 0183 lze získat od National Marine Electronics Association (www.nmea.org).

Reset zařízení

Existují dva typy resetování: reset hardwaru a reset softwaru. Zařízení lze také restartovat vypnutím (odpojením od sítě USB i NMEA 2000 nebo vypnutím NMEA 2000 i USB) a opětovným zapnutím (z USB a/nebo NMEA 2000).
Hardwarový reset vrátí vaše zařízení do stavu, ve kterém bylo původně zakoupeno. Všechna nastavení budou ztracena a aktualizace firmwaru budou vráceny zpět. Originál files na interním disku budou obnoveny, všichni uživatelé files budou smazány nebo přepsány. Resetování zařízení:

Odpojte zařízení od NMEA 2000 nebo vypněte napájení NMEA 2000.
Připojte zařízení k USB (k notebooku nebo pouze k napájecímu kabelu) a během jedné sekundy jej odpojte.
Tento postup opakujte čtyřikrát, přičemž mezi připojeními musí být alespoň 2 sekundy. Během tohoto postupu by neměly být žádné signály LED. Pokud existují, znamená to, že jste zařízení odpojili příliš pozdě a je třeba zahájit postup znovu.
Připojte zařízení k USB popáté a LED se rozsvítí červeně. Počkejte asi 5 sekund, než změní barvu na zelenou, a okamžitě se odpojte. Pokud jste si to rozmysleli, neodpojujte zařízení a počkejte dvě sekundy, než LED zhasne a zařízení se vrátí do normálního provozu.
Pokud jste zařízení odpojili, když jeho LED v předchozím kroku svítila zeleně, provede reset při příštím připojení k síti USB nebo NMEA 2000. To může trvat až minutu.
Během této doby bude LED svítit červeně. Neodpojujte zařízení, dokud jeho LED nezačne blikat, což signalizuje normální provoz.

Softwarový reset je termín používaný pro interpret Pythonu. Můžete jej restartovat bez cyklování zařízení a bez přerušení relace terminálu. V terminálové relaci (viz část VII) přerušte aktuální program stisknutím Ctrl+C a poté stiskněte Ctrl+D v interaktivní výzvě Pythonu (REPL). Tím se překladač resetuje a po resetování se spustí boot.py a main.py. Interpret můžete resetovat pomocí Ctrl+W namísto Ctrl+D, abyste vynechali spouštění main.py při spuštění.

Dodatek A. Odstraňování problémů

Situace	Možná příčina a náprava
Žádné LED signály	1. LED je ovládána uživatelským programem. Vypněte zařízení (odpojte USB kabel a vypněte síť NMEA 2000) a poté jej znovu zapněte. Po dobu jedné sekundy po zapnutí by měla LED dioda zařízení ukazovat krátký zelený signál. Všechny následující LED signály lze vypnout uživatelským programem. Obraťte se na dodavatele softwaru. 2. Porucha napájení. Zařízení lze napájet z USB nebo NMEA 2000. Pokud se po zapnutí Zařízení neobjeví žádný signál LED, a to ani z USB, ani z NMEA 2000, může to znamenat poškození vnitřních obvodů Zařízení a poškození Zařízení. V opačném případě zkontrolujte a vyčistěte kontakty zařízení, zkuste vyměnit kabel USB nebo NMEA 2000 a ujistěte se, že jsou kabely na obou koncích správně připojeny.
Chaotické nebo nerozpoznané signály LED	LED lze ovládat uživatelským programem. Podrobnosti vám sdělí váš dodavatel softwaru. Proveďte reset softwaru (viz část VIII) pomocí Ctrl+W (abyste se vyhnuli spuštění main.py při spuštění) a zkontrolujte signály LED.
Zvláštní chování Zařízení, i když je uživatelský program ukončen	Program může používat zpětná volání, což znamená, že jeho kód může být stále vykonáván (kontrolní LED signály, čtení a odesílání zpráv), když je jeho hlavní cyklus přerušen a uživatel může zadávat příkazy do terminálu. Proveďte reset softwaru (viz oddíl VIII) pomocí Ctrl+W (abyste se vyhnuli spuštění main.py při spuštění), abyste zkontrolovali chování zařízení.

Situace	Možná příčina a náprava
Aplikace nebo terminálový program nemůže otevřít sériový port zařízení	1. Problém s ovladačem. Pokud jste zařízení připojili k novému portu USB, znovu jej připojte k dříve používanému portu. Zkontrolujte, zda je zařízení USB správně připojeno a rozpoznáno (viz část III). 2. Software problém. Sériové porty nejsou určeny k použití více aplikacemi současně. Zavřete všechny aplikace, které mohou používat port zařízení. V Linuxu zkontrolujte nastavení správce modemu (po připojení může po dobu jedné minuty otevírat nové porty a port v tu chvíli není k dispozici pro použití jinými aplikacemi). Zkuste zařízení znovu připojit.
Přestože má terminálový program přístup k portu COM, REPL nereaguje na stisknutí žádné klávesy. Softwarový reset nefunguje.	1. REPL je řízen uživatelským programem. Program může vyžadovat vstup z terminálového programu. Napsané znaky se v tomto případě nezobrazí. Obraťte se na dodavatele softwaru. 2. Zařízení uvízlo v nekonečné smyčce. Uživatelský program může způsobit, že stroj uvízne v nekonečné smyčce. Pokuste se odstranit files boot.py a/nebo main.py z disku. Nezapomeňte zálohovat files na bezpečné místo.

Dodatek B. Podporované zprávy NMEA 2000

Tato příloha obsahuje zprávy používané při servisní komunikaci s ostatními zařízeními v síti.
«Ne» v tabulce níže znamená, že brána nebude zpracovávat ani odesílat tyto zprávy během servisní komunikace s jinými zařízeními. Všimněte si, že servisní komunikace není ovlivněna uživatelským programem.

Zpráva	Dostávat	Přenést
Potvrzení ISO, PGN 59392 (0xE800)	Ano	Ano
Požadavek ISO, PGN 59904 (0xEA00)	Ano	Žádný
ISO Transport Protocol (DT), PGN 60160 (0xEB00)	Ano	Žádný
ISO Transport Protocol (CM), PGN 60416 (0xEC00)	Ano	Žádný
Nárok na adresu ISO, PGN 60928 (0xEE00)	Ano	Ano
Adresa přikázaná ISO, PGN 65240 (0xFED8)	Ano	Žádný
Funkce skupiny NMEA, PGN 126208 (0x1ED00)	Ano	Ano
Seznam PGN (přijato/odesláno), PGN 126464 (0x1EE00)	Žádný	Ano
Heartbeat, PGN 126993 (0x1F011), viz poznámka 2	Žádný	Ano
Systémový čas, PGN 126992 (0x1F010)	Ano	Žádný
Informace o produktu, PGN 126996 (0x1F014)	Žádný	Ano
Informace o konfiguraci, PGN 126998 (0x1F016) , viz Poznámka 3	Žádný	Ano
Údaje o poloze GNSS, PGN 129029 (0x1F805), viz poznámka 3	Ano	Žádný
Místní časový posun, PGN 129033 (0x1F809), viz poznámka 3	Ano	Žádný

Poznámka 1: Instance zařízení NMEA 2000, instance systému, popis instalace Pole 1 a popis instalace Pole 2 lze změnit pomocí PGN 126208. Může být podporováno některými modely mapových plotrů nebo to lze provést pomocí profesionálního PC softwaru (s hardwarovým konektorem do sítě NMEA 2000). Pokud máte brány nebo routery Yacht Devices NMEA 2000 Wi-Fi, USB nebo Ethernet, můžete si zdarma stáhnout náš protokol CAN Viewer software (běží na Microsoft Windows, Mac OS X a Linux) at http://www.yachtd.com/downloads/.
Poznámka 2: Pole «Equipment Status» zprávy Heartbeat je řízeno uživatelským programem (třída NMEA2000, method equipment(), viz odkaz na dokumentaci knihovny v sekci VII).
Poznámka 3: Tyto zprávy se používají pro synchronizaci hodin reálného času (třída NMEA 2000, metoda rtc(), viz odkaz na dokumentaci knihovny v sekci VII). RTC lze také synchronizovat pomocí vět NMEA 0183 ZDA a RMC.

Dodatek C. Konektory zařízení

Konektor USB (typ Mini-B samice) a vodiče NMEA 0183 jsou znázorněny na obrázku 1 v části I.

Dokumenty / zdroje

Yacht Devices YDPG-01N Python Gateway Software [pdfUživatelská příručka
YDPG-01N, YDPG-01N Software brány Python, software brány Python, software brány, software

Reference

Uživatelská příručka

YDPG-01N Python Gateway Software