Modulo smartCORE Socket CAN bus
Descrizione
Il modulo canbus mette a disposizione l'interfaccia hardware CAN bus tramite Fast Message Dispatcher.
In questo modo
- da un lato vengono distribuiti (dispatched) i messaggi CAN bus letti
- dall'altro viene messo a disposizione un meccanismo di scrittura
In linea di principio il modulo può essere utilizzato con qualsiasi Fast Message Receiver. Nel contesto del CAN bus risultano opportuni
- il Fast Message Producer (generico) ("fmproducer")
- il modulo DBC Receiver ("dbc")
Interfacce e protocolli utilizzati
- CAN bus
- Fast Message Dispatching
Configurazione JSON
Nella sezione seguente viene descritta l'intera configurazione JSON del modulo e vengono illustrati i singoli parametri.
Configurazione di esempio (minima)
{
"module":"CANBus1",
"factory":"canbus",
"config":{
"interface":1
}
}
Configurazione di esempio (massima)
{
"module":"CANBus1",
"factory":"canbus",
"config":{
"fmd":"CANBus1",
"priority":80,
"writeBufferSize":1024,
"interface":1,
"bitrate":500000,
"listenOnly":false,
"maxBurstDurationUs":0,
"dispatchCanIdAsDataPrefix":false,
"smioUtcClock":"0x010"
}
}
Elenco dei parametri
| Nome parametro | Obbligatorio | Tipo di dati | Intervallo di valori sensato | Default | Descrizione |
|---|---|---|---|---|---|
| fmd | No | STRING | Nome dell'istanza del modulo | Nome del Fast Message Dispatcher | |
| priority | No | INT | 1 - 99 | 80 | Priorità di scheduling dell'interfaccia CAN bus |
| writeBufferSize | No | INT | 1 - | 8192 | Numero massimo di frame nel buffer di scrittura |
| interface | SÌ | INT o STRING | 1 - | N/A | Indice o nome dell'interfaccia CAN bus (vedere la documentazione smartDEVICE) |
| bitrate | No | INT | 1 - | 500000 | Bitrate dell'interfaccia CAN bus |
| listenOnly | No | BOOL | false, true | false | Flag listen-only dell'interfaccia CAN bus |
| maxBurstDurationUs | No | INT | 0 - | 0 | Max Burst Duration [us] dell'interfaccia CAN bus |
| dispatchCanIdAsDataPrefix | No | BOOL | false, true | false | Antepone al frame dati CAN bus inoltrato il CAN ID a 32 bit in rappresentazione Little Endian. Utile per Fast Message Receiver indipendenti dal CAN ID, come ad es. CAN RAW e debugging |
| keepEFFFlag 1 | No | BOOL | false, true | false | Tipicamente il flag EFF nell'indirizzamento CAN viene impostato automaticamente, a seconda dell'intervallo di valori in cui si trova il CAN ID (11 / 29 bit). Per l'interpretazione il bit può essere trasmesso al fmproducer. In tal caso gli indirizzi a 29 bit vanno indicati con l'offset 2147483648 (0x80000000). |
| smioUtcClock 2 | No | INT o STRING | 0, 1 - 0x7FF | 0 | CAN ID su cui l'ora di sistema viene inviata ogni 10 secondi a tutti gli smartIO con firmware ESP32 (vedere Ora smartIO). 0 disattiva la funzione. Come STRING sono ammessi anche valori esadecimali come "0x010". |
Ora smartIO (smioUtcClock)
Gli smartIO con firmware ESP32 (ad es. smartIO 8x24) non dispongono di un orologio in tempo reale con batteria tampone. Ricavano l'ora da un messaggio CAN il cui CAN ID viene impostato sullo smartIO con SYStem:UTC (default 0x010).
Se smioUtcClock è impostato, il modulo canbus invia questo messaggio ogni 10 secondi in broadcast a tutti gli smartIO sul bus. Non è prevista alcuna conferma di ricezione. Il CAN ID nel modulo canbus e sullo smartIO devono coincidere.
| Byte | Contenuto |
|---|---|
| 0 - 5 | Ora di sistema in millisecondi dal 1970-01-01 UTC, 48 bit, Motorola (big endian) |
| 6 | 0 |
| 7 | Checksum: somma dei byte 0 - 6 (modulo 256) |
Viene inviata l'ora di sistema del dispositivo smartCORE così com'è. Se l'orologio di sistema è errato, anche gli smartIO ricevono l'ora errata.
Con "listenOnly": true, smioUtcClock viene ignorato.
Informazioni sul modulo
| Informazione | Valore |
|---|---|
| Autore | optiMEAS GmbH |
| da smartCORE | 0.120 |
| Tipo di modulo | Dispatcher (Producer) |
| Dipendenze | qualsiasi modulo Fast Message Receiver (ad es. "dbc", "fmproducer") |