Glossary¶
This page defines the terms and abbreviations that the canair docs use. Abbreviations in the docs also show their meaning when you point at them.
Vehicle and protocol terms¶
- CAN (Controller Area Network)
- The bus that connects the electronic control units in a vehicle.
- ECU (electronic control unit)
- A computer in the vehicle, for example the battery management system. canair names each ECU
in the
ecus/directory of the profile. - OBD-II (On-Board Diagnostics)
- The standard diagnostic port and protocol of a vehicle. The WiCAN plugs into this port.
- UDS (Unified Diagnostic Services, ISO 14229)
- The modern diagnostic protocol. A tester sends a request. The ECU sends a response.
- KWP2000 (Keyword Protocol 2000, ISO 14230)
- An older diagnostic protocol. Some ECUs still use it. Which ECUs use which protocol depends on the vehicle. See ECU protocols.
- ISO-TP (ISO 15765-2)
- The transport layer under UDS and KWP2000. It splits a long message over several 8-byte CAN frames.
- PCI (protocol control information)
- The ISO-TP framing bytes. They are not data. The WiCAN byte index counts them. See Byte indexing.
- SID (service identifier)
- The first byte of a UDS or KWP2000 message. It names the service. A positive response adds
0x40to the request SID. - PID (parameter identifier)
- In canair, a diagnostic request that returns a page of data, for example
2101. A PID usually holds several signals. - DID (data identifier)
- A 2-byte UDS identifier, for example
22B002. - LID (local identifier)
- A 1-byte KWP2000 identifier. canair writes these as
21xxPIDs. - RID (routine identifier)
- A 2-byte UDS identifier that names a diagnostic routine.
- NRC (negative response code)
- The code in a refusal from an ECU. It tells you why the ECU refused the request.
- DTC (diagnostic trouble code)
- A fault code that an ECU stores. See DTCs.
- IOControl
- The diagnostic service (UDS
0x2F) that switches an output of an ECU, for example a light. It changes the state of the car. See Safety. - VIN (vehicle identification number)
- The identifier of one vehicle. It is personal data. Do not share it.
Hardware and software terms¶
- WiCAN
- The WiFi OBD-II dongle that canair uses. It comes in a Pro model and a classic model.
- AutoPID
- A feature of the WiCAN that polls PIDs by itself and publishes the values. canair generates
the AutoPID profile from your
ecus/directory. - ELM327
- A text-command protocol for OBD adapters. Many cheap WiFi adapters use it.
- SLCAN (serial-line CAN)
- A text protocol that carries raw CAN frames. It is the default
slcan-tcptransport. - DBC
- A file format that describes the signals in CAN frames. canair imports and exports it.
- Transport
- The way canair reaches the bus:
slcan-tcp,wican-wsorelm327-tcp. See How canair connects.
canair terms¶
- Profile
- The directory that holds everything canair knows about one vehicle. See Profiles.
- Signal
- A decoded quantity that canair reads from the bus, for example battery voltage. It comes from a diagnostic PID or from a broadcast frame.
- Capture
- A recorded payload with its context: time, label and vehicle state. Captures are the evidence for the signal definitions. See Captures & states.
- Vehicle state
- What the car was doing when canair recorded a capture, for example
drivingorcharging. - Variant
- One version of a car that the profile covers, for example the battery size or the facelift. See Variants.
- Domain A and domain B
- The two kinds of data. Domain A is request and response diagnostics. Domain B is the broadcast frames that the car sends by itself. See Broadcast CAN frames.
- Verified and unverified
- A verified signal has evidence that you confirmed against the car. An unverified signal is a guess that still needs proof.
- Research lead
- An open question about a PID or signal that you record in the profile.
canair researchlists them. - Group
- A named set of ECU and PID selectors. Recall it as
@name, for examplemonitor @charging. - Mirror
- The same quantity that you can reach in two places, for example one speed that two frame IDs carry.