Part one · Chapter 2

Trace responsibilities from Home Assistant to the KNX bus

Use a plain-language diagram that does not represent a live connection to distinguish Home Assistant, KNXD, the KNX interface, and the KNX bus.

Written

Task card for this chapter

Chapter 1 distinguishes four roles. This chapter arranges the four responsibility points used in this guide: Home Assistant, KNXD, the KNX interface as the device-side gateway, and the KNX bus as the device communication path. You will learn about responsibility layers, not connections.

Purpose
Be able to identify who is responsible for each section of the data path, and know at which level to start looking for problems.
Prepare
Complete Chapter 1 first; no hardware, addresses, ETS project, or network parameters required.
Time
About 15 minutes
System change
Do not modify Home Assistant.
Expected result
State the responsibilities of Home Assistant, KNXD, the KNX interface, and the KNX bus in order without making cross-layer inferences.
Stop conditions
  • The task requires a real KNX connection.
  • The task would claim that the KNX bus works; neither upstream source content nor process status can prove that.

Keep the safety boundary first

A line in the diagram means that responsibility for one delivery request passes to the next station, not that live data has passed. The diagram does not show every possible direction of KNX data flow, so do not use it to infer other directions.

Evidence that one station exists or is running does not prove anything about the next station. For example, a running KNXD process establishes only process-layer status; it does not establish that the KNX interface is available, much less that the KNX bus is operational. This chapter contains no installation, configuration, startup, or wiring steps.

Let’s look at the responsibility path first

Think of it this way: After the building counter receives an order to be sent to the device side, it hands it to the translation desk; after the translation is completed, it is handed over to the gate leading to the device network.

Formal term: These four stations are Home Assistant, KNXD, interface and KNX bus in order.

How this chapter uses it: It is used only to identify the responsibility model adopted by this site and will not allow the data to actually flow.

The four-stage responsibility sequence used in this site guide

The diagram shows four stations in sequence: the Home Assistant control desk, the KNXD translation desk, the KNX interface gateway, and the KNX bus device network. The lines between stations indicate only the order of responsibility for this outbound request. They do not prove that any station is connected or show the direction of other KNX data.

  1. Home AssistantControl desk where requests begin
  2. KNXDTranslation desk between systems
  3. KNX interfaceThe gateway to the device network
  4. KNX busThe communication path used by the device

How to read the diagram: A connecting line marks the next responsibility point for this request; it does not mean that a live connection exists.

Just prepare a picture before you start

Just copy the four stations in the previous section into a blank flow chart. Do not write environmental connection information such as IP, address, or port on the diagram. Also don't write device and secret data, such as device paths, serial numbers, or credentials; these values are not prerequisites for understanding the hierarchy of responsibilities.

  • Leave a box under each station labeled "What can this station prove?"
  • Leave another box labeled "What can this station not prove?"
  • Follow the rules of reading schematic diagrams and treat the connecting lines as a handover of responsibilities.
  • If you still cannot distinguish ETS from KNXD, return to Chapter 1 and review the four roles.

Complete this blank image to continue.

Walk along the four stations

The following steps are only for identifying responsibilities on the diagram and are not a wiring procedure. At each stop, stop and talk about its work and evidence boundaries.

  1. Start at Home Assistant. It's where you make your requests. At this time, we only know where the request starts, and the downstream status is still unknown.
  2. Move to KNXD. It is the intermediate translator role. Even if the process layer has a known state, it cannot declare results for the interface or bus.
  3. Go to the KNX interface. It is like a gate to the device network and is responsible for the handover between the KNXD and the device side. The existence of the interface name does not prove that the hardware is ready.
  4. Finish at the KNX bus. This is the device communication path and the boundary that this tutorial does not cross. The status of the previous three stations cannot establish the status of this one.

After drawing the four stations, write "Responsibility path, not evidence of success" below the picture. This sentence can avoid cross-layer inferences in the future by just looking at a green state.

Completion check

You do not need screenshots or logs to complete this chapter. As long as you can look at the flow chart and answer the following questions, you understand the architectural responsibilities.

  • I can name Home Assistant, KNXD, KNX interface, KNX bus in order.
  • I understand that the connection line is a transfer of responsibility, not evidence of live-environment status.
  • I know that the status of the KNXD process layer cannot prove the results of the interface or bus.
  • I did not fill in connection values, start services, operate ETS, send messages, or control devices.

Next step: Go to Chapter 3, using a plain-language eight-item checklist to complete placeholder-only preflight. Passing the preflight only means that you can read the conditional process of the next chapter, but it does not prove that you can ignore isolation, approval, or artifact provenance.

When responsibilities cannot be clearly seen

What we are dealing with here is "misreading the picture", not a live-environment fault. A simple starting point is:Start classifying from the layer of responsibility closest to the symptom, rather than guessing at the entire path.

  • Can't see the Add-on management screen: Attribute symptoms to Home Assistant management first.
  • Just know that the KNXD process has no known state: It is first placed in the KNXD process layer, without inference to the interface or bus.
  • Only know that the device gate has no status: It is first classified into the KNX interface layer.
  • It remains unclear whether the device received the message: Keep it at the KNX bus/device layer. That is outside this chapter; do not attempt verification through physical control.

If you only view the connection line as a live-environment result, change the label back to "Responsibility Transfer". If KNXD and the KNX interface are combined into one station, they can be re-divided into two compartments: the translation desk and the equipment gate.

Advanced notes and FAQ

Advanced note: On which level are the three settings and interface terms placed?

Like an Add-on-managed configuration sheet: The formal term is a managed INI file. The source template shipped with Add-on 0.6.1 contains main, TCP-server, and configured-interface sections. It remains a template with placeholder content, not a configuration generated or applied for a specific host.

Like opening the counter and waiting to be asked: Officially called listener. Even if the listener state exists, it only supports observation of the waiting layer and cannot prove the downstream bus.

Like the service’s entrance address: The formal term is endpoint. The presence of endpoint-related words in the source does not prove that the entrance is reachable from any environment.

Pinned service scripts only support the process responsibility of "daemon call from generated configuration file". It is not live-environment evidence that procedures have been executed, endpoints are reachable, or buses are connected.

Why does the KNX interface need to be a separate station?

Because the process responsibilities of KNXD are different from the handover responsibilities on the device side. After disassembly, the process status will not be mistaken for hardware or bus status.

Does the connecting line in the picture mean that the message has been sent?

No. Follow the diagram-reading rule in this chapter; do not treat a connecting line as evidence of live transmission.

Will this chapter teach me to choose USB or other interfaces?

No. This chapter only retains the responsibility point of "KNX interface"; selection and inspection will be handled separately in subsequent chapters.

Can the flowchart be confirmed using the Launch Add-on?

It is not necessary, nor possible, to confirm the entire path with a single process state. Understanding the flow chart is an offline task, do not perform lifecycle actions for this purpose.

Evidence and sources

Evidence class: source-bounded

Feature crosswalk: addon-managed-ini-template, addon-service-daemon-lifecycle

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