Module socket CAN-Bus smartCORE
Description
Le module canbus met à disposition l'interface matérielle CAN-Bus via le Fast Message Dispatcher.
Pour cela
- d'une part, les messages CAN-Bus lus sont distribués (dispatchés)
- d'autre part, un mécanisme d'écriture est fourni
En principe, le module peut fonctionner avec n'importe quel Fast Message Receiver. Dans le contexte du bus CAN, il est judicieux d'utiliser
- le Fast Message Producer (générique) (« fmproducer »)
- le module récepteur DBC (« dbc »)
Interfaces et protocoles utilisés
- CAN-Bus
- Fast Message Dispatching
Configuration JSON
La section suivante décrit l'ensemble de la configuration JSON du module et explique chacun des paramètres.
Exemple de configuration (minimale)
{
"module":"CANBus1",
"factory":"canbus",
"config":{
"interface":1
}
}
Exemple de configuration (maximale)
{
"module":"CANBus1",
"factory":"canbus",
"config":{
"fmd":"CANBus1",
"priority":80,
"writeBufferSize":1024,
"interface":1,
"bitrate":500000,
"listenOnly":false,
"maxBurstDurationUs":0,
"dispatchCanIdAsDataPrefix":false,
"smioUtcClock":"0x010"
}
}
Liste des paramètres
| Nom du paramètre | Requis | Type de données | Plage de valeurs pertinente | Défaut | Description |
|---|---|---|---|---|---|
| fmd | Non | STRING | Nom de l'instance du module | Nom du Fast Message Dispatcher | |
| priority | Non | INT | 1 - 99 | 80 | Priorité d'ordonnancement de l'interface CAN-Bus |
| writeBufferSize | Non | INT | 1 - | 8192 | Nombre maximal de trames dans le tampon d'écriture |
| interface | OUI | INT ou STRING | 1 - | N/A | Index ou nom de l'interface CAN-Bus (voir la documentation smartDEVICE) |
| bitrate | Non | INT | 1 - | 500000 | Débit binaire de l'interface CAN-Bus |
| listenOnly | Non | BOOL | false, true | false | Indicateur listen-only de l'interface CAN-Bus |
| maxBurstDurationUs | Non | INT | 0 - | 0 | Durée maximale de rafale (Max Burst Duration) [us] de l'interface CAN-Bus |
| dispatchCanIdAsDataPrefix | Non | BOOL | false, true | false | Écrit l'ID CAN de 32 bits en représentation little endian devant la trame de données CAN-Bus transmise. Utile pour les Fast Message Receivers indépendants de l'ID CAN, comme CAN RAW et le débogage |
| keepEFFFlag 1 | Non | BOOL | false, true | false | Normalement, l'indicateur EFF de l'adressage CAN est positionné automatiquement, selon la plage de valeurs dans laquelle se trouve l'ID CAN (11 / 29 bits). Pour l'interprétation, le bit peut être transmis au fmproducer. Les adresses sur 29 bits doivent alors être indiquées avec le décalage 2147483648 (0x80000000). |
| smioUtcClock 2 | Non | INT ou STRING | 0, 1 - 0x7FF | 0 | ID CAN sur lequel l'heure système est envoyée toutes les 10 secondes à tous les smartIO équipés du firmware ESP32 (voir Horloge smartIO). 0 désactive la fonction. En STRING, des valeurs hexadécimales comme "0x010" sont également acceptées. |
Horloge smartIO (smioUtcClock)
Les smartIO équipés du firmware ESP32 (p. ex. smartIO 8x24) ne disposent pas d'horloge temps réel sauvegardée par batterie. Ils reprennent leur heure d'un message CAN dont l'ID CAN est réglé sur le smartIO avec SYStem:UTC (par défaut 0x010).
Si smioUtcClock est défini, le module canbus envoie ce message toutes les 10 secondes en diffusion (broadcast) à tous les smartIO présents sur le bus. Il n'y a pas d'acquittement. L'ID CAN dans le module canbus et sur le smartIO doivent concorder.
| Octet | Contenu |
|---|---|
| 0 - 5 | Heure système en millisecondes depuis le 1970-01-01 UTC, 48 bits, Motorola (big endian) |
| 6 | 0 |
| 7 | Somme de contrôle : somme des octets 0 - 6 (modulo 256) |
L'heure système de l'appareil smartCORE est envoyée telle quelle. Si l'horloge système est fausse, les smartIO reçoivent eux aussi une heure fausse.
Avec "listenOnly": true, smioUtcClock est ignoré.
Informations sur le module
| Information | Valeur |
|---|---|
| Auteur | optiMEAS GmbH |
| depuis smartCORE | 0.120 |
| Type de module | Dispatcher (Producer) |
| Dépendances | n'importe quel module Fast Message Receiver (p. ex. "dbc", "fmproducer") |