Susi Server

Automotive Vehicle Source

Node ID: vehicle · Role: Source · Realtime config: no

Description

High-level vehicle CAN source with built-in DBC-based presets for specific car models. Decodes wheel speeds, steering angle, and other signals into VehicleSpeed and VehicleState data.

Inputs / Outputs

Config aliases

AutomotiveVehicleSource, vehicle

Properties

Each row shows the setting’s label in the node’s Properties panel and, in code, its key in the node’s settings object in the config file. A setting omitted from the config file uses the default shown here.

PropertyTypeDefaultDescription
CAN Interface canInterfaceselectPeakCANCAN adapter family: PeakCAN (PCAN), Vector (CANalyzer / XL), or Internal (built-in CAN). Options: PeakCAN, Vector, Internal.
Baudrate baudratenumber500000CAN bus speed in bits per second (500000 = 500 kbit/s, standard for most passenger cars).
Channel channelnumber0Hardware channel index on the selected adapter (0 = first channel).
Debug Output debugbooleanfalseEnable verbose logging of decoded CAN frames and derived vehicle state.

Subtypes

ValueDisplay nameExtra properties
MinimalMinimal7 field(s)
ExternalExternal (with Steering)13 field(s)
CitroenPreset: Citroen1 field(s)
CupraPreset: Cupra1 field(s)
Honda EnvixPreset: Honda Envix1 field(s)
HyundaiPreset: Hyundai1 field(s)
PicassoPreset: Picasso1 field(s)
R56Preset: R561 field(s)
SubaruPreset: Subaru1 field(s)
Tesla Model 3Preset: Tesla Model 3none

Subtype: Minimal — Minimal

PropertyTypeDefaultDescription
Speed CAN ID speedCanIdnumber0CAN ID (decimal) of the frame carrying vehicle speed (e.g. 599 for Tesla Model 3 DI_speed).
Speed Start Bit speedStartBitnumber0Bit position where the speed signal starts (LSB-first numbering, as per DBC). Bit 0 = LSB of byte 0.
Speed Length (bits) speedBitsLengthnumber8Length of the speed signal in bits. May cross byte boundaries.
Speed Scale (kph per bit) speedScalenumber1.0Scale factor applied to the raw value, in kph per bit. Output is converted to m/s internally.
Speed Offset (kph) speedOffsetnumber0.0Offset added to the scaled raw value, in kph.
Speed Big Endian speedIsBigEndianbooleanfalseByte order. Motorola DBC signals = big endian; Intel DBC signals = little endian.
Speed Signed speedIsSignedbooleanfalseTreat the bit field as a signed two’s-complement integer (e.g. for signals that can go negative).

Subtype: External — External (with Steering)

PropertyTypeDefaultDescription
Speed CAN ID speedCanIdnumber0CAN ID (decimal) carrying vehicle speed.
Speed Start Byte speedStartBytenumber0Byte offset of the speed field in the payload.
Speed Length (bytes) speedLengthnumber1Length of the speed field in bytes (1, 2, or 4).
Speed Scale speedScalenumber1.0Scale factor applied to the raw speed value.
Speed Offset speedOffsetnumber0.0Offset added to the scaled speed value.
Speed Big Endian speedIsBigEndianbooleanfalseByte order of the multi-byte speed value.
Steering CAN ID steeringCanIdnumber0CAN ID (decimal) carrying the steering angle.
Steering Start Byte steeringStartBytenumber0Byte offset of the steering field in the payload.
Steering Length (bytes) steeringLengthnumber1Length of the steering field in bytes.
Steering Scale steeringScalenumber1.0Scale factor applied to the raw steering value to obtain radians.
Steering Offset steeringOffsetnumber0.0Offset added to the scaled steering value (radians).
Wheel Base (m) wheelBasenumber2.9Vehicle wheelbase in meters. Used by the bicycle / Ackermann vehicle model.
Track Width (m) trackWidthnumber1.6Vehicle track width in meters. Used by the vehicle model.

Subtype: Citroen — Preset: Citroen

PropertyTypeDefaultDescription
Drive Model driveModelselectDifferentialOptions: Differential, Ackermann, SimpleAckermann.

Subtype: Cupra — Preset: Cupra

PropertyTypeDefaultDescription
Drive Model driveModelselectDifferentialOptions: Differential, Ackermann, SimpleAckermann.

Subtype: Honda Envix — Preset: Honda Envix

PropertyTypeDefaultDescription
Drive Model driveModelselectDifferentialOptions: Differential, Ackermann, SimpleAckermann.

Subtype: Hyundai — Preset: Hyundai

PropertyTypeDefaultDescription
Drive Model driveModelselectDifferentialOptions: Differential, Ackermann, SimpleAckermann.

Subtype: Picasso — Preset: Picasso

PropertyTypeDefaultDescription
Drive Model driveModelselectDifferentialOptions: Differential, Ackermann, SimpleAckermann.

Subtype: R56 — Preset: R56

PropertyTypeDefaultDescription
Drive Model driveModelselectDifferentialOptions: Differential, Ackermann, SimpleAckermann.

Subtype: Subaru — Preset: Subaru

PropertyTypeDefaultDescription
Drive Model driveModelselectDifferentialOptions: Differential, Ackermann, SimpleAckermann.

Example node definition

A minimal entry in config.json looks like the block below. Paste it under the sources key, keyed by an instance name of your choice. All settings are optional: anything not listed under settings uses the default from the Properties table above. See The configuration file for how the sections and endpoint wiring work.

{
  "sources": {
    "vehicle": {
      "outEndpoint": "inproc://vehicle_data",
      "type": "Minimal",
      "settings": {}
    }
  }
}
Loading documentation…