AXIOMATIC AX140910 CAN-ENET Software Support Package

Informazione di u produttu

U CAN-ENET Software Support Package (SSP) hè un inseme di moduli software, documentazione, è examples per u sviluppu di software d'applicazione chì travaglia cù diversi convertitori Axiomatic Ethernet to CAN è Wi-Fi to CAN. U pacchettu di software furnisce un manuale d'utilizatore, fonte files, è examples. U manuale d'utilizatore hè validu per qualsiasi versione SSP 3.0.xx, è l'aghjurnamenti specifichi à u manuale d'utilizatore sò fatti aghjunghjendu lettere A, B, ..., Z à u numeru di versione di u manuale d'utilizatore. U SSP pò esse usatu per a prugrammazione di sistemi integrati cù risorse limitate è ancu per a prugrammazione di l'applicazioni in Windows o Linux.

Usu di u produttu

1. Scaricate u zip di distribuzione file da l'Axiomatic website o ricevi cum'è un attache per email.
2. Sblocca u zip file in Windows clicchendu u dirittu right file è appughjà u buttone Unblock in Properties->General->Unblock.
3. Estrae l'archiviu zip per creà a seguente struttura di cartulare:
   • U cartulare radicale cuntene l'aiutu SSP file CANEnetSSP.chm in u formatu d'aiutu Microsoft HTML è u manuale d'usu UMAX140910v3.0.pdf in u formatu Adobe Reader.
   • A Fonte FileU cartulare s cuntene l'infurmazioni di u statu di salute di u cunvertitore descritte in u Protocolu di Comunicazione di u Convertitore Ethernet à CAN.
   • L'Examples folder cuntene examples chì ponu esse custruitu nantu à Microsoft Windows o Linux usendu Windows.mk o Linux.mk make files.
4. Custruisce eseguibile files per l'examples usendu a marca files situatu in u .Exampannuariu les.
5. Sè necessariu, crea un subdirectory .Bin in u .Examples directory induve tutti l'executable è l'ughjettu files seranu postu.
6. U zip SSP file cuntene cumpilatu examples per Windows in u subdirectory .Bin.
7. Tutti i SSP exampi sò stati testati in Windows 10 è Linux Ubuntu 16.04.

U SSP usa solu tipi di dati standard int è char. U tipu int hè utilizatu quandu a dimensione di dati esatta o massima per u paràmetru interu ùn hè micca criticu. U tippu char hè utilizatu per indicà una stringa ASCII o riferite un unicu caratteru ASCII. L'altri tipi basi sò derivati ​​​​da l'intestazione è anu a dimensione di dati esatta, eccettu u tipu booleanu BOOL_t, chì hè derivatu da int, vede: CommonTypes.h file.

ACRONIMI

• Interfaccia di prugrammazione di l'applicazione API
• ASCII Codice Standard Americanu per l'Interchange d'Informazioni
• Distribuzione di software BSD Berkeley
• CAN Controller Area Network
• HTML HyperText Markup Language
• Protocolu Internet IP
• Rete Locale LAN
• Paquet di supportu di u software SSP

INFORMAZIONI GENERALI

U CAN-ENET Software Support Package (SSP) furnisce un inseme di moduli software, documentazione, è examples per u sviluppu di software di applicazione chì travaglia cù diversi convertitori Axiomatic Ethernet to CAN è Wi-Fi to CAN.
U manuale d'utilizatore hè validu per u SSP cù i stessi dui numeri di versione maiò chì u manuale d'utilizatore. Per esample, stu manuale d'utilizatore hè validu per qualsiasi versione SSP 3.0.xx. L'aghjurnamenti specifichi di u manuale d'utilizatore sò fatti aghjunghjendu lettere: A, B, ..., Z à u numeru di versione di u manuale d'utilizatore. Tutti i moduli di software SSP sò scritti in un linguaghju di prugrammazione C standard per a portabilità è cumplettamente documentati. Forniscenu supportu per i protokolli di cumunicazione è scuperta di Axiomatic. U protokollu di cumunicazione hè principarmenti utilizatu per trasmette missaghji CAN nantu à Ethernet o qualsiasi altra rete IP, è u protocolu Discovery - per localizà u cunvertitore in a LAN. U SSP pò esse ugualmente utilizatu per a prugrammazione di sistemi integrati cù risorse limitate è per a prugrammazione di l'applicazioni in Windows o Linux.

CONTENUT SSP

U SSP hè distribuitu cum'è un zip file cù u nome : CANEnetSSPv .zip, induve numeri riferite à u numeru di versione principale SSP è - à a lettera di cambiamentu di documentazione facultativa. Per evità prublemi potenziali cù a visualizazione di l'aiutu SSP file, u zip di distribuzione file deve esse sbloccatu in Windows s'ellu hè acquistatu nantu à Internet (dopu à scaricà da Axiomatic websitu, riceve in e-mail cum'è un attache, etc.) Questu pò esse fattu clicchendu right-clicking u file è appughjà u buttone Unblock in Properties->General->Unblock. Dopu avè estratto l'archiviu zip, a seguente struttura di cartulare serà creata:

U cartulare radicale cuntene l'aiutu SSP file CANEnetSSP.chm in u formatu d'aiutu Microsoft HTML è stu manuale d'utilizatore UMAX140910v3.0.pdf in u formatu Adobe Reader. U numeru di versione SSP più significativu riflette cambiamenti incompatibili, dopu - cambiamenti cumpatibili, l'ultimu - cambiamenti minori chì ùn affettanu micca a funziunalità SSP. A lettera opzionale hè aghjuntu per i cambiamenti in u manuale d'utilizatore è / o aiutu file

Fonte Files
A fonte SSP files sò raggruppati in cartulari .\Source è .\Inc secondu u so tipu. Sò scritti in C standard è prisentanu i seguenti moduli di software:

• PM messagiu. Fornisce supportu per a struttura di missaghju indipendente di u protocolu descritta in u Protocolu di Comunicazione di u Convertitore Ethernet à CAN.
• Prutoculu di cummunicazione. Supporta i missaghji da u protocolu di cumunicazione Ethernet à CAN Converter.
• DiscProtocol. Supporta i missaghji da Ethernet à CAN Converter Discovery Protocol.
• HealthData. Fornisce strutture di dati è funzioni per trasfurmà l'infurmazioni di u statu di salute di u cunvertitore Ethernet à CAN descritte in u Protocolu di Comunicazione di u Convertitore Ethernet à CAN.

Tutti i tipi di dati basi è macros cumuni sò definiti in CommonTypes.h file.

Examples
U SSP cuntene ancu i seguenti exampi prugrammi in u .\Exampl'annuariu chì mostra diversi scenarii di cumunicazione cù u convertitore Axiomatic Ethernet à CAN:

• CANReceive.c. Questa applicazione di cunsola mostra cumu i frames CAN ponu esse ricevuti da u convertitore Axiomatic Ethernet à CAN.
• CANSend.c. Questu example mostra cumu i frames CAN ponu esse mandati à l'Axiomatic Ethernet to CAN converter.
• Scuperta.c. Questu exampl'applicazione mostra cumu l'utilizatore pò scopre un convertitore Axiomatic Ethernet à CAN nantu à a rete locale (LAN).
• Heartbeat.c. Questa applicazione mostra cumu i missaghji Heartbeat ponu esse ricevuti da u convertitore Axiomatic Ethernet à CAN. Mostra ancu unpacking di i Dati di Salute da i missaghji Heartbeat.
• StatusRequest.c. Questu exampl'applicazione mostra cumu l'utilizatore pò dumandà u status di convertitore Axiomatic Ethernet à CAN

Tutti exampi pò esse custruitu nantu à Microsoft Windows o Linux usendu Windows.mk o Linux.mk make files. A marca files sò ancu situati in u .\Exampannuariu les. Dopu à custruisce eseguibile files, u script make, se ne necessariu, crea u subdirectory .\Bin in u .\Examples directory induve mette tutti l'executable è l'ughjettu files. U zip SSP file cuntene cumpilatu examples per Windows in u subdirectory .\Bin. Tutti i SSP exampi sò stati testati in Windows 10 è Linux Ubuntu 16.04

TIPI DI DATI E STILE DI CODIFICAZIONE

U SSP usa solu tipi di dati standard int è char. U tipu int hè utilizatu quandu a dimensione di dati esatta o massima per u paràmetru interu ùn hè micca criticu. U tippu char hè utilizatu per indicà una stringa ASCII o riferite un unicu caratteru ASCII. Altri tipi basi sò derivati ​​da header è avè a dimensione esatta di dati, eccettu u tipu Boolean BOOL_t, chì hè derivatu da int, vede: CommonTypes.h file. Tutti i tipi di basi esportati SSP sò chjamati cù lettere maiuscule è anu a fine "_t". Per esample: BOOL_t, WORD_t, etc. Tutti l'altri tipi esportati sò chjamati cù lettere maiuscule, anu a finitura '_t' è sò prefissati cù u file abbreviazione per u file sò definiti in. U "CP" hè utilizatu per u CommProtocol.h, "DP" - per u DiscProtocol.h, "HD" - per u HealthData.h è "PM" - per u PMessage.h file. Tutti i nomi di macros usanu lettere maiuscule è sò prefissati cù u file abbreviazione per u file sò definiti in u listessu modu comu tippi di dati. L'abbreviazione "CT" hè aduprata per u CommonTypes.h file.
I nomi di variàbili sò prefissati cù u so tipu per i tipi basi è i puntatori. Per esample: int tipu hè prefissatu cù 'i', tipu di puntatore - cù 'p', pointer to integer - cù 'pi', etc. Strutture, unioni, enumeratori ùn sò micca prefissati. Per stringhe terminate zero, u prefissu "sz" hè utilizatu. I nomi di funzioni sò prefissati cù u file abbreviazione u listessu modu cum'è i tipi di dati è macros. Una tabulazione hè uguale à quattru spazii

USU SSP

L'utilizatore deve aghjunghje u SSP files à u prughjettu di l'applicazione. U CommProtocol.c o DiscProtocol.c pò esse esclusu se u protocolu adattatu ùn hè micca usatu. U HealthData.c pò ancu esse esclusu s'ellu ùn ci hè micca bisognu di processà i dati di salute di u cunvertitore.
U SSP ùn hà micca bisognu di inizializazione prima di l'usu. Ùn hà micca variabili glubale. Tutte e funzioni SSP sò thread-safe è rientranti. Per mandà è riceve i missaghji di cunvertitore, hè necessariu un supportu di u protocolu Internet (IP). Un modu standard per furnisce stu supportu hè di utilizà sockets Internet. L'API di socket hè ben standardizatu è hè utilizatu in tutti i SSP examples è per a descrizzione di l'operazioni di cunvertitore.

Riceve missaghji da u Convertitore
L'utilizatore deve prima preparà un socket per riceve i dati di u cunvertitore.
Quandu i dati sò ricevuti, deve esse passatu à a funzione PMParseFromBuffer (). L'utilizatore furnisce duie funzioni di callback: OnDataParsed() è OnDataParsedError(). A prima funzione hè invucata dopu chì u missaghju di u protocolu hè statu analizatu bè è a seconda - nantu à l'errore di analisi. Allora, l'utilizatore deve chjamà parsers per messagi individuali specifichi di protokollu in a funzione OnDataParsed(), vede quì sottu:

UMAX140910. Paquet di supportu di u software CAN-ENET. Versione 3.0

UMAX140910. Paquet di supportu di u software CAN-ENET. Versione 3.0

Se l'utilizatore vole analizà u valore dwHealthData in stati operativi individuali di i cumpunenti hardware è software principali di u convertitore, a funzione HDUnpackHealthData() deve esse chjamata:

UMAX140910. Paquet di supportu di software CAN-ENET. Versione 3.0 Questa funzione torna ancu u Status di Salute aggregatu di u convertitore.

Mandà missaghji à u Convertitore
I missaghji di l'utilizatori ponu esse mandati à u cunvertitore generendu prima u missaghju di protokollu necessariu è poi cupiendu u messagiu à u buffer di trasmissione. Per esample, mandendu una dumanda di statutu richiederà i seguenti cumandamenti

L'invio di frames CAN FD hè più elaboratu. U missaghju CAN FD Stream pò cuntene più di un quadru CAN FD o classicu CAN, salvu chì a bandiera CP_SUPPORTED_FEATURE_FLAG_CAN_FD_STREAM_ONE_FRAME_PER_MESSAGE hè stabilita da u node in u missaghju Status Response o Heartbeat. L'utilizatore deve prima priparà un missaghju CAN FD Stream viotu è dopu aghjunghje CAN frames à questu.

UMAX140910. Paquet di supportu di u software CAN-ENET. Versione 3.0

Se u protocolu TCP hè utilizatu, l'opzione TCP_NODELAY deve esse impostata à u socket per evità ritardi in l'inviu di messagi di protokollu.

Scopre u Convertitore
U cunvertitore pò esse scupertu cù u protocolu di Discovery Converter Ethernet à CAN. L'utilizatore deve fà i seguenti:

• Apri un datagram socket cù l'opzione SO_BROADCAST.
• Preparate una dumanda di scuperta è copiala in u buffer di trasmissione.
• Mandate a dumanda di scuperta à l'indirizzu IP globale.
• Aspettate e risposte di scuperta entranti da i cunvertitori situati nantu à a stessa LAN.
• Analizà e risposte prima da PMParseFromBuffer() è dopu da DPParseResponse() chjamatu da OnDataParsed() .

Un ex simplificatuampu codice chì illustra u cuncettu hè presentatu quì sottu

UMAX140910. Paquet di supportu di u software CAN-ENET. Versione 3.0

DOCUMENTAZIONE

I seguenti documenti chì descrizanu i protokolli proprietarii Axiomatic utilizati in u SSP sò dispunibuli nantu à dumanda:

• O. Bogush, "Protokollu di cumunicazione Ethernet à CAN Converter. Versione di u documentu: 5, "Axiomatic Technologies Corporation, 14 dicembre 2022.
• O. Bogush, "Protokollu di Discovery Converter Ethernet à CAN. Versione di u documentu: 1A, "Axiomatic Technologies Corporation, 5 aprile 2021.
• O. Bogush, "Ethernet to CAN Converter Health Status. Versione di u documentu: 3, "Axiomatic Technologies Corporation, 5 aprile 2021.

Per dumandà i documenti, cuntattate Axiomatic Technologies à: sales@axiomatic.com

LICENZA

U software SSP hè distribuitu cù una Licenza BSD permissiva di 3 clausole. U testu di a licenza hè inclusu in u software files

STORIA VERSIONE

Manuale d'uso Versione	SSP versione	Data	Autore	Mudamenti
3.0	3.0.0	14 di dicembre di u 2022	Olek Bogush	· Supportu aghjuntu per CAN FD Stream. · Supportu deprecated per CAN è Notification Stream. · Aghjunghjite i paràmetri di u nodu di cumunicazione à i missaghji di Risposta di Status è Heartbeat. · Aghjurnatu CommProtocol.c, CommProtocol.h, è examples: CANReceive.c, CANSend.c, Heartbeat.c, è StatusRequest.c. · Numeru telefuninu finlandese aghjurnatu in prima pagina.
2.0	2.0.xx	27 d'aprile, 2021	Olek Bogush	· Supportu aghjuntu per i cunvertitori Axiomatic Wi-Fi à CAN. · Aggiuntu Tipu di cunvertitore paràmetru in Battitu di core è Risposta di Status missaghji. · Aghjurnatu Documentazione sezione. · Aghjurnatu CANReceive.c, Heartbeat.c è StatusRequest.c examples inseme cù Windows.mk è Linux.mk fà files.
1.0A	1.0.xx	2 di marzu, 2017	Olek Bogush	· In Cuntenutu SSP aghjuntu dumanda à sbloccare a distribuzione .zip file in Windows.
1.0	1.0.xx	27 ottobre 2016	Olek Bogush	· Liberazione iniziale.

I NOSTRI PRODOTTI

• Alimentazione AC/DC
• Cuntrolli di l'attuatori / Interfacce
• Interfacce Ethernet di l'automobile
• Caricatori di batterie
• Cuntrolli CAN, Routers, Repeaters
• CAN/WiFi, CAN/Bluetooth, Routers
• Corrente / VoltagConvertitori e/PWM
• Convertitori DC/DC Power
• Scanners di temperatura di u mutore
• Convertitori Ethernet/CAN, Gateway, Switch
• Controller di Fan Drive
• Gateways, CAN/Modbus, RS-232
• Giroscopi, Inclinometri
• Controller di Valve Idraulici
• Inclinometri, triassiali
• Cuntrolli I/O
• Convertitori di signali LVDT
• Cuntrolli di a macchina
• Modbus, RS-422, RS-485 Controlli
• Cuntrolli di Motore, Inverter
• Alimentazione, DC / DC, AC / DC
• Convertitori di signali PWM / Isolatori
• Resolver Signal Conditioners
• Strumenti di serviziu
• Cundizzioni di signali, cunvertitori
• Cuntrolli CAN di Strain Gauge
• Suppressori di surge

A NOSTRA COMPAGNIA
Axiomatic furnisce cumpunenti di cuntrollu di e macchine elettroniche à l'autostrada, u veiculu cummerciale, u veiculu elettricu, u generatore di energia, a manipulazione di materiali, l'energia rinnuvevule è i mercati OEM industriali. Innovemu cù cuntrolli di macchina ingegneriati è off-the-shelf chì aghjunghjenu valore per i nostri clienti.

DESIGN E FABRICATURA DI QUALITÀ
Avemu un stabilimentu di cuncepimentu / fabricazione registratu ISO9001: 2015 in Canada.

GARANTIA, APPROVAZIONI APPLICAZIONE / LIMITAZIONI

Axiomatic Technologies Corporation si riserva u dirittu di fà correzioni, mudificazioni, rinfurzà, migliure, è altri cambiamenti à i so prudutti è servizii in ogni mumentu è di discontinuà qualsiasi pruduttu o serviziu senza avvisu. I clienti anu da ottene l'ultime informazioni pertinenti prima di fà ordini è anu da verificà chì tali informazioni sò attuali è cumplete. L'utilizatori anu da esse assicurati chì u pruduttu hè adattatu per l'usu in l'applicazione prevista. Tutti i nostri prudutti portanu una garanzia limitata contr'à difetti in materiale è manufatti. Per piacè riferite à a nostra Garanzia, Approvazioni / Limitazioni di Applicazioni è Prucessu di Ritornu di Materiali à https://www.axiomatic.com/service/.

CONFORMITÀ
I dettagli di cunfurmità di u produttu ponu esse truvati in a literatura di u produttu è / o in axiomatic.com. Ogni dumanda deve esse mandata à sales@axiomatic.com.

USU SICURU
Tutti i prudutti deve esse servitu da Axiomatic. Ùn apre u pruduttu è fà u serviziu sè stessu

SERVICE
Tutti i prudutti per esse rinviati à Axiomatic necessitanu un Numeru d'Autorizazione di Ritornu di Materiali (RMA#) da sales@axiomatic.com. Per piacè furnite l'infurmazioni seguenti quandu dumandate un numeru RMA:

• Numeru di serie, numeru di parte
• Ore di runtime, descrizzione di u prublema
• Schema di configurazione di cablaggio, applicazione è altri cumenti in quantu necessariu

DISPOSIZIONE
I prudutti axiomatici sò scarti elettroni. Per piacè seguite i vostri rifiuti ambientali lucali è e leggi, i regulamenti è e pulitiche di riciclamentu per l'eliminazione sicura o u riciclamentu di i rifiuti elettronichi

CONTATTI
Axiomatic Technologies Corporation 1445 Courtneypark Dr. E. Mississauga, ON CANADA 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ä FINLANDIA

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

Documenti / Risorse

AXIOMATIC AX140910 CAN-ENET Software Support Package [pdfManuale d'usu UMAX140910, AX140910, AX140910 CAN-ENET Software Support Package, AX140910 Software Support Package, CAN-ENET Software Support Package, Software Support Package, Software Support Package, Support Package, Package

Referenze

• Manuale d'usu