Skip to content

Inspection Model

schoolbus treats protocol learning as inspection.

An object should expose raw values, named fields, and a concise explanation. The same raw value can be inspected at several levels:

Visual Model

flowchart LR raw["Raw value"] --> fields["Named fields"] raw --> container["Frame, word, or sentence"] fields --> explanation["Plain-English explanation"] container --> signal["Signal context when available"] explanation --> observer["Passive observer lesson"]
  • A CAN identifier can be a bus arbitration value.
  • The same identifier can be interpreted as a J1939 priority, PGN, destination, and source address.
  • A word can be a raw integer, a set of named fields, and part of a transaction.

The first release focuses on passive, explanatory behavior. It does not send traffic, operate real hardware, or provide unsafe examples against real vehicles or systems.