Aller au contenu principal

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ètreRequisType de donnéesPlage de valeurs pertinenteDéfautDescription
fmdNonSTRINGNom de l'instance du moduleNom du Fast Message Dispatcher
priorityNonINT1 - 9980Priorité d'ordonnancement de l'interface CAN-Bus
writeBufferSizeNonINT1 -8192Nombre maximal de trames dans le tampon d'écriture
interfaceOUIINT ou STRING1 -N/AIndex ou nom de l'interface CAN-Bus (voir la documentation smartDEVICE)
bitrateNonINT1 -500000Débit binaire de l'interface CAN-Bus
listenOnlyNonBOOLfalse, truefalseIndicateur listen-only de l'interface CAN-Bus
maxBurstDurationUsNonINT0 -0Durée maximale de rafale (Max Burst Duration) [us] de l'interface CAN-Bus
dispatchCanIdAsDataPrefixNonBOOLfalse, truefalseÉ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 1NonBOOLfalse, truefalseNormalement, 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 2NonINT ou STRING0, 1 - 0x7FF0ID 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.

OctetContenu
0 - 5Heure système en millisecondes depuis le 1970-01-01 UTC, 48 bits, Motorola (big endian)
60
7Somme 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​

InformationValeur
AuteuroptiMEAS GmbH
depuis smartCORE0.120
Type de moduleDispatcher (Producer)
Dépendancesn'importe quel module Fast Message Receiver (p. ex. "dbc", "fmproducer")

Footnotes​

  1. Disponible uniquement à partir de la version 2.10.1 de smartCore. ↩

  2. Disponible uniquement à partir de la version 2.12 de smartCORE. ↩