Skip to content

BLF / Binary Logging Format

Vector binary log format for CAN, LIN, FlexRay, Ethernet, and related captures.

Status Examples Runtime example Source posture
draft-structure-only synthetic/passive docs-only atlas metadata plus public/tooling cross-checks

Identity

Vector binary log format for CAN, LIN, FlexRay, Ethernet, and related captures.

What This Protocol Teaches

  • A proprietary log format can become de facto infrastructure.
  • It teaches how to inspect timestamped records, channel identifiers, bus-specific events without mistaking field extraction for meaning.
  • It keeps observer inference separate from system truth.

Operational Context

BLF / Binary Logging Format appears in automotive, capture-format contexts and is modeled in the atlas at the capture-format layer(s). The binder treats it as an inspection surface: what evidence appears, what timing matters, and what outside authority is required before assigning meaning.

Draft status

draft-structure-only: this is not yet a final-copy binder page. It has an atlas-grounded teaching hook and source notes, but still needs a stronger worked trace, page-specific ambiguity case, and reviewer-validated visual before promotion.

A Concrete Artifact

# synthetic BLF summary
object=CAN_MESSAGE timestamp=0.010 channel=1 id=0x123 dlc=8 data=10 27 ...

Synthetic

Synthetic offline sample for explanation; not a real operational trace or live-system instruction.

Worked Decode

  1. Treat object=CAN_MESSAGE as a log-object classification in a synthetic capture summary.
  2. timestamp=0.010 and channel=1 are capture metadata, not hardware proof.
  3. id=0x123 dlc=8 data=10 27 ... is preserved traffic evidence, not decoded signal meaning.
  4. The page can teach provenance and record shape while staying docs-only for BLF parsing.

Field Layout / Anatomy

Element Shape Inspection meaning
timestamped records artifact-specific evidence Inspect with timing and source context before naming meaning.
channel identifiers artifact-specific evidence Inspect with timing and source context before naming meaning.
bus-specific events artifact-specific evidence Inspect with timing and source context before naming meaning.
semantic authority external source Dictionary, profile, map, or integration document that turns evidence into named meaning.
timing context cadence / gap / slot / timestamp Freshness and ordering evidence for observer reconstruction.

Visual Model

flowchart LR capture["Capture source"] --> record["Recorded artifact"] record --> timestamp["Timestamp / provenance"] timestamp --> decode["Analysis claim"]

Timing And Authority

Timing and authority depend on the log-format role: scheduled, polled, arbitrated, transmitted, or logged evidence should not be read as the same kind of truth. Semantic authority is external to the raw artifact unless the artifact is itself a description or capture format; even then, provenance determines whether the description should be trusted.

Semantic authority

Bytes rarely explain themselves. Name the source that defines meaning before naming engineering values: standard metadata, label table, DBC, PGN/SPN definition, object dictionary, register map, DID catalog, LDF, ARXML, channel metadata, or vendor profile.

Failure And Ambiguity

  • Binary log object summaries can hide parser assumptions and dropped metadata.
  • Channel labels are capture-file evidence, not hardware proof.
  • A converted summary can preserve bytes while losing original provenance.

Observer Lesson

A passive observer can usually infer artifact boundaries, repeated structure, cadence, missingness, and candidate state transitions. The observer usually cannot prove physical truth, application intent, complete system state, or engineering-unit meaning without semantic authority and timing provenance.

Python Model

schoolbus does not parse this format in this wave. This page records source posture, passive inspection questions, and metadata boundaries only. Runtime support would require a separate approved plan with concrete synthetic artifacts, tests, and source-checked parser boundaries.

Local Teaching Notes

Simplification

The artifact and diagrams are synthetic teaching material. The page intentionally omits conformance timing tables, electrical design detail, proprietary configuration, and exhaustive standard behavior.

Source Confidence

Source confidence is medium for scope and terminology, with semantic claims limited to public metadata, public source notes, and synthetic teaching artifacts.

Source Notes

Field Value
Governance tier Format Binder Page
Canonical source status yes
Public explainer status no
Open-source tool status yes
Sample-data status none listed; use synthetic teaching artifacts
Confidence medium
Citation specificity document-metadata-level
Canonical source(s) Vector logging formats context (Vector; BLF / Vector Binary Logging Format; public-web/proprietary-format; metadata-only)
Public explainer/tooling source(s) none listed in atlas
Open-source tool references python-can: CAN log inspection and offline lab context
cantools: description-file parsing and signal inspection

References

Public Sources