Skip to content

canair coverage

Alias: cov

usage: canair coverage [-h] [--all] [--unmapped] [--unverified] [--bitfields]
                       [--no-capture] [--json] [--notation NAME]
                       [ecu] [pid]

[UDS] Audit PID definitions for decoding gaps.

positional arguments:
  ecu              Filter to one ECU (e.g. IGPM)
  pid              Filter to one PID (e.g. 22BC03)

options:
  -h, --help       show this help message and exit
  --all            Include fully-mapped PIDs (no gaps)
  --unmapped       Only report unmapped-byte findings
  --unverified     Only report bytes mapped by an unverified signal (needs
                   confirming)
  --bitfields      Only report bytes with undecoded bits (partial bitfields).
                   A byte some signal also reads whole is still reported,
                   flagged '(also read whole)'
  --no-capture     Only report PIDs with params but no capture
  --json           Output as JSON
  --notation NAME  byte-index notation for output labels: wican (default),
                   isotp, torque, bix. Overrides the display.byte_notation
                   config key.

  canair coverage                 # audit every ECU/PID
  canair coverage IGPM            # only the IGPM ECU
  canair coverage IGPM 22BC03     # a single ECU/PID
  canair coverage --bitfields     # only incomplete-bitfield findings
  canair coverage --unmapped      # only unmapped-byte findings
  canair coverage --unverified    # only bytes mapped by an unverified param
  canair coverage --no-capture    # only PIDs missing captures
  canair coverage --all           # include fully-mapped PIDs too
  canair coverage --json          # machine-readable output