Skip to content

canair research

usage: canair research [-h] [--ecu ECU]
                       [--type {scan,decode,verify,iocontrol_scan}]
                       [--status {pending,captured,nrc,done}]
                       [--priority {P1,P2,P3}] [--states STATE] [--summary]
                       [--gaps] [--all] [--limit N] [--verbose] [--json]
                       [--dir DIR]

[UDS] Report open reverse-engineering work from ecus/ research: sections.

options:
  -h, --help            show this help message and exit
  --ecu, -e ECU         Filter by ECU name
  --type, -t {scan,decode,verify,iocontrol_scan}
                        Filter by research type
  --status {pending,captured,nrc,done}
                        Filter by status
  --priority, -p {P1,P2,P3}
                        Filter by priority
  --states, --vehicle-states, --prerequisite, --prereq STATE
                        Filter to items needing this car power state (from the
                        profile's vehicle-state vocabulary)
  --summary, -s         Show aggregate counts instead of the item list
  --gaps                List IOControl DID families never read with 0x22,
                        derived from iocontrol:, scan_log:, research: and
                        saved scans (combines with --ecu, --json and --dir
                        only; with --dir, saved scans are not consulted)
  --all, -a             Include done items (hidden by default)
  --limit, -L N         Show only the N highest-priority items (default 20; 0
                        = all), in the list and under --json. A footer, or a
                        stderr warning under --json, reports what it hid.
                        --summary always counts every item.
  --verbose, -v         Show full notes/results (default caps long prose)
  --json                Output as JSON
  --dir DIR             ecus/ directory (default: active profile)

  canair research                      # the 20 highest-priority open items
  canair research --limit 0            # every open item
  canair research --summary            # overview counts
  canair research --ecu MCU            # just the MCU backlog
  canair research --type decode        # captured-but-undecoded work
  canair research --priority P1        # high-value items only
  canair research --states acc         # what needs ACC power to test
  canair research --gaps               # actuator families whose records were never read
  canair research --json               # for further processing