DBC smartCORE Module

Description

The dbc module provides a DBC parser via a Fast Message Dispatcher. Data is extracted from a dispatched message and routed to the appropriate channels.

In principle, the module can be used with any Fast Message Dispatcher. In the context of CAN bus, this is appropriate

• the (generic) CAN bus socket module ("canbus")

Interfaces & Protocols Used

• CAN-Bus DBC (CAN DBC)
• Fast Message Dispatching

JSON Configuration

The following section describes the module’s entire JSON configuration and explains the individual parameters.

Example Configuration (Minimal)

    {
      "module":"DBC1",
      "factory":"dbc",
      "config":{
        "fmd":"CANBus1",
        "dbcFileContents":"<Base64-encoded contents of the CAN DBC file>"
      }
    },

Example Configuration (Maximal)

    {
      "module":"DBC1",
      "factory":"dbc",
      "config":{
        "fmd":"CANBus1",
        "bufferSize":1024,
        "dbcFileContents":"<BASE64-encoded contents of the CAN DBC file>",
        "dbcParserDebugOutput":true,
        "namespace":["directory","subDirectory"],
        "channelPrefix":"CAN1__",
        "produceOnChangeOnly":true,
        "separateEFFlag":false
      }
    },

Parameter List

Parameter Name	Required	Data Type	Valid Value Range	Default	Description
fmd	YES	STRING			Fast Message Dispatcher Name (e.g., "CANBus1")
bufferSize	No	INT	1 -	1024	Buffer size of the channels to be created and output
dbcFileContents	YES	STRING			Base64-encoded contents of the CAN DBC file
dbcParserDebugOutput	No	BOOL	false, true	false	Flag to enable additional debug information from the DBC parser
channelPrefix	No	STRING			Channel prefix (useful when multiple DBC modules are used and the DBC files have overlapping channel names)
namespace	No	ARRAY [ STRING ]			Channel prefix in the form of hierarchically concatenated namespaces
produceOnChangeOnly	No	BOOL	true, false	true	Output only when a value changes
absoluteTolerance	No	FLOAT	0.0 -	0.0	Tolerance threshold for detecting a value change
doubleChannels	No	ARRAY [ STRING ]		[]	List of channels to be created as double-precision channels
separateEFFlag 1	No	bool		false	Whether to distinguish between "Extended IDs" (29 bits) and standard IDs (11 bits). If false, no distinction is made and the EFF flag is removed from the message ID.

Module Information

Information	Value
Author	optiMEAS GmbH
Since smartCORE	0.120
Module Type	Receiver (Producer)
Dependencies	Any Fast Message Dispatcher module (e.g., "canbus", "fmudp")

Footnotes

1. Available only up to smartCore version 2.10.1. ↩