CAN-Bus smartCORE Socket Modul
Beschreibung
Das canbus Modul stellt die CAN-Bus Hardware Schnittstelle via Fast Message Dispatcher zur Verfügung.
Hierbei werden
- einerseits gelesene CAN-Bus Botschaften dispatched
- andererseits ein Schreibmechanismus zur Verfügung gestellt
Grundsätzlich kann das Modul mit beliebigen Fast Message Receivern betrieben werden. Im Kontext von CAN-Bus sind dies zweckmäßig
- der (generische) Fast Message Producer ("fmproducer")
- das DBC Receiver Modul ("dbc")
Verwendete Schnittstellen & Protokolle
- CAN-Bus
- Fast Message Dispatching
JSON-Konfiguration
Im folgenden Abschnitt soll die gesamte JSON-Konfiguration des Moduls beschrieben und die einzelnen Parameter erläutert werden.
Beispielkonfiguration (minimal)
{
"module":"CANBus1",
"factory":"canbus",
"config":{
"interface":1
}
}
Beispielkonfiguration (maximal)
{
"module":"CANBus1",
"factory":"canbus",
"config":{
"fmd":"CANBus1",
"priority":80,
"writeBufferSize":1024,
"interface":1,
"bitrate":500000,
"listenOnly":false,
"maxBurstDurationUs":0,
"dispatchCanIdAsDataPrefix":false,
"smioUtcClock":"0x010"
}
}
Parameter-Liste
| Parametername | Erforderlich | Datentyp | sinnvoller Wertebereich | Default | Beschreibung |
|---|---|---|---|---|---|
| fmd | Nein | STRING | Name der Modulinstanz | Fast Message Dispatcher Name | |
| priority | Nein | INT | 1 - 99 | 80 | Scheduling Priorität der CAN-Bus Schnittstelle |
| writeBufferSize | Nein | INT | 1 - | 8192 | Max. Anzahl der Frames im Schreibpuffer |
| interface | JA | INT oder STRING | 1 - | N/A | Index oder Name der CAN-Bus Schnittstelle (siehe smartDEVICE Dokumentation) |
| bitrate | Nein | INT | 1 - | 500000 | Bitrate der CAN-Bus Schnittstelle |
| listenOnly | Nein | BOOL | false, true | false | Listen-only Flag der CAN-Bus Schnittstelle |
| maxBurstDurationUs | Nein | INT | 0 - | 0 | Max Burst Duration [us] der CAN-Bus Schnittstelle |
| dispatchCanIdAsDataPrefix | Nein | BOOL | false, true | false | Schreibe vor den weitergeleiteten CAN-Bus Datenframe die 32-bit CAN ID in Little Endian Darstellung. Dies ist sinnvoll für CAN-ID-unabhängige Fast Message Receiver, wie z.B. CAN RAW und Debugging |
| keepEFFFlag 1 | Nein | BOOL | false, true | false | Typischerweise wird das EFF - Flag in der CAN-Adressierung automatisch gesetzt, je nachdem, in welchem Wertebereich die CAN-ID liegt (11 / 29 bit). Für die Interpretation kann das Bit an den fmproducer weitergegeben werden. Dann sind 29bit Adressen mit dem Offset 2147483648 (0x80000000) anzugeben. |
| smioUtcClock 2 | Nein | INT oder STRING | 0, 1 - 0x7FF | 0 | CAN-ID, auf der die Systemzeit alle 10 Sekunden an alle smartIO mit ESP32-Firmware gesendet wird (siehe smartIO-Uhrzeit). 0 schaltet die Funktion ab. Als STRING sind auch Hex-Angaben wie "0x010" möglich. |
smartIO-Uhrzeit (smioUtcClock)
Die smartIO mit ESP32-Firmware (z.B. smartIO 8x24) haben keine batteriegepufferte Echtzeituhr. Sie übernehmen ihre Uhrzeit aus einer CAN-Botschaft, deren CAN-ID am smartIO mit SYStem:UTC eingestellt wird (Default 0x010).
Ist smioUtcClock gesetzt, sendet das canbus Modul diese Botschaft alle 10 Sekunden als Broadcast an alle smartIO am Bus. Eine Quittung gibt es nicht. Die CAN-ID im canbus Modul und am smartIO müssen übereinstimmen.
| Byte | Inhalt |
|---|---|
| 0 - 5 | Systemzeit in Millisekunden seit 1970-01-01 UTC, 48 bit, Motorola (big endian) |
| 6 | 0 |
| 7 | Prüfsumme: Summe der Bytes 0 - 6 (modulo 256) |
Gesendet wird die Systemzeit des smartCORE-Geräts so, wie sie ist. Geht die Systemuhr falsch, erhalten auch die smartIO die falsche Zeit.
Bei "listenOnly": true wird smioUtcClock ignoriert.
Modul-Informationen
| Information | Wert |
|---|---|
| Autor | optiMEAS GmbH |
| seit smartCORE | 0.120 |
| Modultyp | Dispatcher (Producer) |
| Abhängigkeiten | beliebiges Fast Message Receiver Modul (z.B. "dbc", "fmproducer") |