Part two · Chapter 10

Understand link-layer and driver diagnostic boundaries

Build a link-layer mental model from documented terminology without treating startup messages as bus evidence.

Written

Chapter overview

Bottom line: Draw only a handover checklist. Each checkpoint represents a documentation category, not a local observation or KNX bus result.

Purpose
Use handover checkpoints to separate the evidence layers of programs, drivers, interfaces, and buses.
Prepare
Chapter 9's offline responsibility map with a blank classification sheet; no hardware or logs required.
Time
About 20 minutes
System change
Do not modify Home Assistant; only use pinned sources to establish offline link layer and driver diagnostic models.
Expected result
Distinguish process, driver, interface, and bus evidence without treating startup messages as bus results.
Stop conditions
  • The task requires diagnostic mode, hardware access, or a service restart.
  • Telegram transmission and physical control are prohibited as driver-verification methods.

Scope and safety boundaries

This chapter only organizes the responsibilities in pinned documents. Do not enable diagnostic mode, do not read local logs, do not access hardware, and do not restart services. The states on the table are category names, not local observations.

This chapter does not add the repository, install or start it. This site lacks approved immutable artifact/image digest and source-to-build proof, so all execution is blocked.

Do not connect to the interface or bus. Group reading is prohibited. Group writing is prohibited. Telegram transmission is prohibited. ETS programming or downloads is prohibited. Physical control is prohibited. No program or driver class can certify bus, integration, or device performance.

Core concepts

Each station is only responsible for its own handover. Stamping at the previous station does not prove that it has been received at the last station.

Package handover checkpoint

Think of it this way: Packages must go through collection, distribution, delivery and signature. The completion of the receipt classification only means that the documents at the first station can be compared, but it cannot be claimed that the package has been delivered.

Formal term: A layered diagnostic model for the driver and link layer.

Program, driver, interface and KNX bus are the four checkpoints. Each layer requires its own evidence. This chapter only establishes categories and does not collect local evidence.

You can use three paper labels: "Document can be compared", "Document describes failure boundary" and "Insufficient evidence". These words only classify source content. They are not observing start, stop, retry, or hardware reactions.

Preparation and prerequisites

Draw four handover boxes: program, driver, interface, bus. Each box is further divided into two columns: "Pinned Document Description" and "Still Unable to Infer".

  • Sources only use locked versions of pinned INI files.
  • Use only category labels; do not write "observed on this system" or "occurred on site."
  • Do not include paths, endpoints, addresses, hardware names, serial numbers, or log fragments.
  • The bus column always remains "No evidence of this chapter".

If data comes from an execution environment, do not put it in this table. Handle it separately under the safe log-sharing guidance; do not rewrite it as a source claim for this chapter.

Steps

  1. Draw four stations first. Write the program, driver, interface and bus in order. Write only the name of the responsibility.
  2. Classify file relationships. Put each responsibility cited by the pinned source in the document-supported column. Do not claim that settings have been loaded.
  3. Classify activation semantics. Place pinned source descriptions of driver settings and failures in the documented-boundary column. Do not write that the system has started or failed.
  4. Block interface inference. Noting the driver family name does not prove that the interface exists, is compatible, or is available.
  5. Block bus inferences. Note that neither the program nor the driver class can prove telegram, group operations, or bus results.
  6. Complete the handover form. The conclusion simply states "Source classification has been completed" or "Insufficient evidence". Do not include local diagnostic conclusions.

Verification and evidence

The finished product is a document-classification table. It divides responsibility among checkpoints and separates supported claims from unsupported ones.

  • I divided the process, driver, interface, and bus into four checkpoints.
  • My diagnostic statuses are all source classifications, not local observations.
  • I put no logs, devices, addresses, paths, endpoints, serial numbers, or live values.
  • I did not upgrade the startup or failure semantics to driver, hardware, interface, bus or integration results.

Next step: Go to Chapter 11, use only classification to create an ETS offline preflight table.

Troubleshooting

  • Write file semantics into local events: Change back to "Pinned File Description". Remove time, host and observations.
  • The driver names seem to match: Only file family categories are retained. Don't claim hardware compatibility.
  • Someone provided a forward log: Don't put it in the table. Forward messages also cannot prove the next handover point.
  • Someone provides an error log: Don't determine the root cause. It will be handled separately according to the security log process.
  • Someone asked for restart confirmation: Stop. This chapter performs offline classification only.
  • Someone asked to use the bus to verify: Stop. Verification using telegram, group operations or physical control is prohibited.

FAQ

Advanced note: Driver technology boundaries supported by pinned sources

Locked upstream 0.14.72 INI file description: The main section refers to the driver section by name; the section in turn specifies the driver family. The document also describes handling configured drivers at startup, as well as preset failure boundaries. These are file models within a version.

The pinned sources in this chapter support terminology and option roles for some serial-driver families. There is no source for local observations. Therefore, "syntactically comparable," "startup processing," and "failure boundaries" are classifications only, not observations of a local daemon, driver, adapter, interface, or bus.

Does syntax comparison mean that the driver has been loaded?

No. File syntax and actual execution are different kinds of evidence.

Does the file description failure mean that the system has failed?

No. This is only a pinned version of behavioral classification, not local observation.

Can an error-free log prove the next checkpoint?

No. This chapter does not observe logs at all; even if there is additional information, it cannot automatically prove the driver, interface or bus.

Can I take turns trying driver families?

No. This chapter does not start, switch, or retry procedures.

Does this table prove that the KNX bus is operational?

No. The bus column must remain marked “No evidence in this chapter”.

Evidence and sources

Evidence class: source-bounded

Feature crosswalk: upstream-driver-families

Pinned sources support only the documented scope. This page does not represent validation of any local environment, hardware, network, or KNX bus.