Balíček softwarové podpory AXIOMATIC AX140910 CAN-ENET

Informace o produktu

CAN-ENET Software Support Package (SSP) je sada softwarových modulů, dokumentace a examppro vývoj aplikačního softwaru, který pracuje s různými převodníky Axiomatic Ethernet na CAN a Wi-Fi na CAN. Softwarový balík poskytuje uživatelskou příručku, zdroj files a examples. Uživatelská příručka je platná pro jakoukoli verzi SSP 3.0.xx a aktualizace specifické pro uživatelskou příručku se provádějí přidáním písmen A, B, …, Z k číslu verze uživatelské příručky. SSP lze použít pro programování vestavěných systémů s omezenými zdroji i pro programování aplikací ve Windows nebo Linuxu.

Použití produktu

1. Stáhněte si distribuční zip file z Axiomatic webnebo jej obdržíte jako přílohu e-mailem.
2. Odblokujte zip file ve Windows kliknutím pravým tlačítkem myši na file a stiskněte tlačítko Odblokovat v Vlastnosti->Obecné->Odblokovat.
3. Rozbalte archiv zip a vytvořte následující strukturu složek:
   • Kořenový adresář obsahuje nápovědu SSP file CANEnetSSP.chm ve formátu nápovědy Microsoft HTML a uživatelskou příručku UMAX140910v3.0.pdf ve formátu Adobe Reader.
   • Zdroj Filesložka s obsahuje informace o stavu převodníku popsané v komunikačním protokolu převodníku Ethernet na CAN.
   • Exampsložka les obsahuje napřampsoubory, které lze sestavit na Microsoft Windows nebo Linux pomocí Windows.mk nebo Linux.mk make files.
4. Sestavit spustitelný soubor files pro examppomocí značky filese nachází v .Exampadresář les.
5. V případě potřeby vytvořte podadresář .Bin v souboru .Exampadresář les, kde jsou všechny spustitelné soubory a objekty files bude umístěno.
6. SSP zip file obsahuje sestavený exampsouborů pro Windows v podadresáři .Bin.
7. Všechny SSP exampsoubory byly testovány na Windows 10 a Linuxu Ubuntu 16.04.

SSP používá pouze standardní datové typy int a char. Typ int se používá, když přesná nebo maximální velikost dat pro celočíselný parametr není kritická. Typ char se používá k ukázání na řetězec ASCII nebo k odkazování na jeden znak ASCII. Další základní typy jsou odvozeny od hlavičky a mají přesnou datovou velikost, kromě booleovského typu BOOL_t, který je odvozen od int, viz: CommonTypes.h file.

ZKRATKY

• API aplikační programovací rozhraní
• ASCII americký standardní kód pro výměnu informací
• Distribuce softwaru BSD Berkeley
• CAN Controller Area Network
• Hypertextový značkovací jazyk HTML
• IP internetový protokol
• Místní síť LAN
• Balíček softwarové podpory SSP

OBECNÉ INFORMACE

CAN-ENET Software Support Package (SSP) poskytuje sadu softwarových modulů, dokumentaci a examppro vývoj aplikačního softwaru pracujícího s různými převodníky Axiomatic Ethernet na CAN a Wi-Fi na CAN.
Uživatelská příručka platí pro SSP se stejnými dvěma hlavními čísly verzí jako uživatelská příručka. Napřample, tato uživatelská příručka je platná pro jakýkoli SSP verze 3.0.xx. Aktualizace specifické pro uživatelskou příručku se provádějí přidáním písmen: A, B, …, Z k číslu verze uživatelské příručky. Všechny softwarové moduly SSP jsou napsány ve standardním programovacím jazyce C pro přenositelnost a jsou plně zdokumentovány. Poskytují podporu pro vlastní komunikační protokoly Axiomatic a protokoly Discovery. Komunikační protokol se používá hlavně pro přenos zpráv CAN přes Ethernet nebo jinou IP síť a protokol Discovery – pro lokalizaci převodníku v LAN. SSP lze stejně tak použít pro programování vestavěných systémů s omezenými zdroji a pro programování aplikací ve Windows nebo Linuxu.

OBSAH SSP

SSP je distribuován jako zip file s názvem: CANEnetSSPv .zip, kde čísla odkazují na číslo hlavní verze SSP a – k dopisu o změně volitelné dokumentace. Chcete-li se vyhnout potenciálním problémům se zobrazením nápovědy SSP file, distribuční zip file by měl být odblokován ve Windows, pokud je získán přes internet (po stažení z Axiomatic webweb, příjem v e-mailu jako příloha atd.) To lze provést kliknutím pravým tlačítkem myši na file a stiskněte tlačítko Odblokovat v Vlastnosti->Obecné->Odblokovat. Po rozbalení archivu zip se vytvoří následující struktura složek:

Kořenový adresář obsahuje nápovědu SSP file CANEnetSSP.chm ve formátu nápovědy Microsoft HTML a tuto uživatelskou příručku UMAX140910v3.0.pdf ve formátu Adobe Reader. Nejvýznamnější číslo verze SSP odráží nekompatibilní změny, další – kompatibilní změny, poslední – drobné změny neovlivňující funkčnost SSP. Volitelné písmeno je přidáno pro změny v uživatelské příručce a/nebo nápovědě file

Zdroj Files
Zdroj SSP files jsou seskupeny v adresářích .\Source a .\Inc podle jejich typu. Jsou napsány ve standardu C a představují následující softwarové moduly:

• PMessage. Poskytuje podporu pro protokolově nezávislou strukturu zpráv popsanou v komunikačním protokolu Ethernet to CAN Converter.
• CommProtocol. Podporuje zprávy z komunikačního protokolu Ethernet na CAN Converter.
• DiscProtocol. Podporuje zprávy z Ethernet na CAN Converter Discovery Protocol.
• HealthData. Poskytuje datové struktury a funkce pro zpracování informací o stavu převodníku Ethernet na CAN popsaných v komunikačním protokolu převodníku Ethernet na CAN.

Všechny základní datové typy a běžná makra jsou definovány v CommonTypes.h file.

Examples
SSP dále obsahuje následující example programy v .\Exampadresář les demonstrující různé scénáře komunikace s převodníkem Axiomatic Ethernet na CAN:

• CANReceive.c. Tato konzolová aplikace ukazuje, jak lze přijímat rámce CAN z převodníku Axiomatic Ethernet na CAN.
• MŮŽETE odeslat.c. Tento example ukazuje, jak mohou být CAN rámce odesílány do Axiomatic Ethernet to CAN převodníku.
• Discovery.c. Tento exampAplikace ukazuje, jak může uživatel objevit převodník Axiomatic Ethernet na CAN v místní síti (LAN).
• Heartbeat.c. Tato aplikace ukazuje, jak lze přijímat zprávy Heartbeat z převodníku Axiomatic Ethernet na CAN. Zobrazuje také rozbalení zdravotních dat ze zpráv Heartbeat.
• StatusRequest.c. Tento exampTato aplikace ukazuje, jak může uživatel požádat o stav převodníku Axiomatic Ethernet na CAN

Vše exampsoubory lze sestavit na Microsoft Windows nebo Linux pomocí Windows.mk nebo Linux.mk make files. Značka files jsou také umístěny v .\Příklampadresář les. Po sestavení spustitelného souboru files, skript make v případě potřeby vytvoří podadresář .\Bin v souboru .\Examples, kam umístí všechny spustitelné soubory a objekty files. SSP zip file obsahuje sestavený exampsouborů pro Windows v podadresáři .\Bin. Všechny SSP exampsoubory byly testovány na Windows 10 a Linuxu Ubuntu 16.04

DATOVÉ TYPY A STYL KÓDOVÁNÍ

SSP používá pouze standardní datové typy int a char. Typ int se používá, když přesná nebo maximální velikost dat pro celočíselný parametr není kritická. Typ char se používá k ukázání na řetězec ASCII nebo k odkazování na jeden znak ASCII. Další základní typy jsou odvozeny od záhlaví a mají přesnou velikost dat, kromě booleovského typu BOOL_t, který je odvozen z int, viz: CommonTypes.h file. Všechny exportované základní typy SSP jsou pojmenovány velkými písmeny a mají koncovku '_t'. Napřample: BOOL_t, WORD_t atd. Všechny ostatní exportované typy jsou pojmenovány velkými písmeny, mají koncovku '_t' a předponu file zkratka pro file jsou definovány v. „CP“ se používá pro CommProtocol.h, „DP“ – pro DiscProtocol.h, „HD“ – pro HealthData.ha „PM“ – pro PMessage.h file. Všechny názvy maker používají velká písmena a mají předponu file zkratka pro file jsou definovány v, stejným způsobem jako datové typy. Zkratka 'CT' se používá pro CommonTypes.h file.
Názvy proměnných mají u základních typů a ukazatelů předponu s jejich typem. Napřample: typ int má předponu 'i', typ ukazatele - 'p', ukazatel na celé číslo - 'pi' atd. Struktury, sjednocení, enumerátory nemají předponu. Pro řetězce ukončené nulou se používá předpona 'sz'. Názvy funkcí mají předponu file zkratky stejným způsobem jako datové typy a makra. Jeden tabulátor se rovná čtyřem mezerám

POUŽITÍ SSP

Uživatel by měl přidat SSP files k projektu aplikace. CommProtocol.c nebo DiscProtocol.c lze vyloučit, pokud není použit příslušný protokol. HealthData.c lze také vyloučit, pokud není potřeba zpracovávat zdravotní data převodníku.
SSP nevyžaduje před použitím inicializaci. Nemá žádné globální proměnné. Všechny funkce SSP jsou bezpečné pro vlákna a znovu se vracejí. Pro odesílání a přijímání zpráv převodníku je vyžadována podpora internetového protokolu (IP). Standardním způsobem poskytování této podpory je použití internetových zásuvek. Socket API je dobře standardizováno a používá se ve všech SSP exampsouborů a pro popis operací převodníku.

Příjem zpráv z konvertoru
Uživatel by měl nejprve připravit zásuvku pro příjem dat převodníku.
Když jsou data přijata, měla by být předána funkci PMParseFromBuffer(). Uživatel poskytuje dvě funkce zpětného volání: OnDataParsed() a OnDataParsedError(). První funkce je vyvolána po úspěšné analýze zprávy protokolu a druhá – při chybě analýzy. Poté by měl uživatel volat analyzátory pro jednotlivé zprávy specifické pro protokol uvnitř funkce OnDataParsed(), viz níže:

UMAX140910. Balíček softwarové podpory CAN-ENET. Verze 3.0

UMAX140910. Balíček softwarové podpory CAN-ENET. Verze 3.0

Pokud chce uživatel analyzovat hodnotu dwHealthData do jednotlivých provozních stavů hlavních hardwarových a softwarových komponent převodníku, měla by být zavolána funkce HDUnpackHealthData():

UMAX140910. Balíček softwarové podpory CAN-ENET. Verze 3.0 Tato funkce také vrací agregovaný zdravotní stav převodníku.

Odesílání zpráv do konvertoru
Uživatelské zprávy lze odesílat do převodníku tak, že se nejprve vygeneruje požadovaná protokolová zpráva a poté se zpráva zkopíruje do vysílací vyrovnávací paměti. Napřample, odeslání žádosti o stav bude vyžadovat následující příkazy

Odesílání rámců CAN FD je propracovanější. Zpráva CAN FD Stream může obsahovat více než jeden CAN FD nebo klasický CAN rámec, pokud není uzlem nastaven příznak CP_SUPPORTED_FEATURE_FLAG_CAN_FD_STREAM_ONE_FRAME_PER_MESSAGE ve zprávě Status Response nebo Heartbeat. Uživatel by měl nejprve připravit prázdnou zprávu CAN FD Stream a poté k ní přidat rámce CAN.

UMAX140910. Balíček softwarové podpory CAN-ENET. Verze 3.0

Pokud je použit protokol TCP, měla by být volba TCP_NODELAY nastavena na soket, aby se zabránilo zpoždění při odesílání zpráv protokolu

Objevování konvertoru
Převodník lze zjistit pomocí protokolu Ethernet to CAN Converter Discovery Protocol. Uživatel by měl provést následující:

• Otevřít datagram socket s volbou SO_BROADCAST.
• Připravte požadavek na zjišťování a zkopírujte jej do vysílací vyrovnávací paměti.
• Odešlete požadavek na zjišťování na globální IP adresu.
• Počkejte na příchozí odezvy zjišťování z převodníků umístěných ve stejné síti LAN.
• Nejprve analyzujte odpovědi pomocí PMParseFromBuffer() a poté pomocí DPParseResponse() volaného z OnDataParsed() .

Zjednodušený exampkód znázorňující tento koncept je uveden níže

UMAX140910. Balíček softwarové podpory CAN-ENET. Verze 3.0

DOKUMENTACE

Následující dokumenty popisující proprietární protokoly Axiomatic používané v SSP jsou k dispozici na vyžádání:

• O. Bogush, „Komunikační protokol převodníku Ethernet na CAN. Verze dokumentu: 5,“ Axiomatic Technologies Corporation, 14. prosince 2022.
• O. Bogush, „Ethernet to CAN Converter Discovery Protocol. Verze dokumentu: 1A,“ Axiomatic Technologies Corporation, 5. dubna 2021.
• O. Bogush, “Zdravotní stav převodníku Ethernet na CAN. Verze dokumentu: 3,“ Axiomatic Technologies Corporation, 5. dubna 2021.

Pro vyžádání dokumentů kontaktujte společnost Axiomatic Technologies na adrese: sales@axiomatic.com

LICENCE

Software SSP je distribuován s povolenou 3-klauzulovou BSD licencí. Text licence je součástí softwaru files

HISTORIE VERZE

Verze uživatelské příručky	SSP verze	Datum	Autor	Modifikace
3.0	3.0.0	14. prosince 2022	Olek Bogush	· Přidána podpora pro CAN FD Stream. · Zastaralá podpora pro CAN a Notification Stream. · Přidáno nastavení komunikačního uzlu do zpráv Stavová odpověď a Prezenční signál. · Aktualizovány CommProtocol.c, CommProtocol.h a exampsoubory: CANReceive.c, CANSend.c, Heartbeat.c a StatusRequest.c. · Aktualizované telefonní číslo finské kanceláře na přední straně.
2.0	2.0.xx	27. dubna 2021	Olek Bogush	· Přidána podpora pro převodníky Axiomatic Wi-Fi na CAN. · Přidal Typ převodníku parametr v Tlukot srdce a Stavová odpověď zprávy. · Aktualizováno Dokumentace sekce. · Aktualizováno CANReceive.c, Heartbeat.c a StatusRequest.c examples spolu s Windows.mk a Linux.mk udělat files.
1.0A	1.0.xx	2. března 2017	Olek Bogush	· V Obsah SSP přidán požadavek na odblokování distribuce .zip file ve Windows.
1.0	1.0.xx	27. října 2016	Olek Bogush	· První vydání.

NAŠE PRODUKTY

• AC / DC napájecí zdroje
• Ovládací prvky/rozhraní pohonu
• Automobilová rozhraní Ethernet
• Nabíječky baterií
• Ovládací prvky CAN, směrovače, opakovače
• CAN/WiFi, CAN/Bluetooth, routery
• Aktuální/Voltage/PWM převodníky
• DC/DC měniče napájení
• Snímače teploty motoru
• Ethernet/CAN převodníky, brány, přepínače
• Ovladače pohonu ventilátoru
• Brány, CAN/Modbus, RS-232
• Gyroskopy, sklonoměry
• Hydraulické ovladače ventilů
• Sklonoměry, tříosé
• I/O Controls
• Převodníky signálu LVDT
• Ovládání stroje
• Ovládání Modbus, RS-422, RS-485
• Řízení motoru, měniče
• Napájecí zdroje, DC/DC, AC/DC
• Převodníky/izolátory PWM signálu
• Kondicionéry signálu Resolver
• Servisní nástroje
• Kondicionéry signálu, převodníky
• Ovládání CAN tenzometru
• Potlačovače přepětí

NAŠE SPOLEČNOST
Axiomatic dodává elektronické komponenty pro řízení strojů pro off-highway, užitková vozidla, elektrická vozidla, agregáty generátorů, manipulaci s materiálem, obnovitelné zdroje energie a průmyslové OEM trhy. Inovujeme pomocí navržených a běžně dostupných ovládacích prvků strojů, které přidávají hodnotu pro naše zákazníky.

KVALITNÍ NÁVRH A VÝROBA
Máme v Kanadě registrované/výrobní zařízení ISO9001:2015.

ZÁRUKA, SCHVÁLENÍ A OMEZENÍ APLIKACE

Společnost Axiomatic Technologies Corporation si vyhrazuje právo kdykoli provádět opravy, úpravy, vylepšení, vylepšení a další změny svých produktů a služeb a ukončit jakýkoli produkt nebo službu bez upozornění. Zákazníci by měli před zadáním objednávky získat nejnovější relevantní informace a měli by si ověřit, zda jsou tyto informace aktuální a úplné. Uživatelé by se měli ujistit, že produkt je vhodný pro použití v zamýšlené aplikaci. Všechny naše produkty mají omezenou záruku na vady materiálu a zpracování. Přečtěte si prosím naše Záruční, schvalovací/omezení a proces vrácení materiálů na adrese https://www.axiomatic.com/service/.

DODRŽOVÁNÍ
Podrobnosti o shodě produktu lze nalézt v produktové literatuře a/nebo na axiomatic.com. Případné dotazy zasílejte na sales@axiomatic.com.

BEZPEČNÉ POUŽÍVÁNÍ
Všechny produkty by měly být servisovány společností Axiomatic. Výrobek neotevírejte a servis provádějte sami

SERVIS
Všechny produkty, které mají být vráceny společnosti Axiomatic, vyžadují číslo autorizace vrácení materiálu (RMA#). sales@axiomatic.com. Při žádosti o číslo RMA uveďte následující informace:

• Sériové číslo, číslo dílu
• Provozní hodiny, popis problému
• Schéma zapojení, aplikace a další komentáře podle potřeby

LIKVIDACE
Produkty Axiomatic jsou elektronický odpad. Pro bezpečnou likvidaci nebo recyklaci elektronického odpadu prosím dodržujte místní zákony, předpisy a zásady týkající se ekologického odpadu a recyklace

KONTAKTY
Axiomatic Technologies Corporation 1445 Courtneypark Dr. E. Mississauga, V KANADĚ L5T 2E3

• TEL: +1 905 602 9270
• FAX: +1 905 602 9279
• www.axiomatic.com
• sales@axiomatic.com

Axiomatic Technologies Oy Höytämöntie 6 33880 Lempäälä FINSKO

• TEL: +358 103 375 750
• www.axiomatic.com
• salesfinland@axiomatic.com

Dokumenty / zdroje

Balíček softwarové podpory AXIOMATIC AX140910 CAN-ENET [pdfUživatelská příručka UMAX140910, AX140910, AX140910 CAN-ENET Software Support Package, AX140910 Software Support Pack, CAN-ENET Software Support Pack, Software Support Package, Software Package, Support Package, Package

Reference

• Uživatelská příručka