Chapter overview
Bottom line: This chapter creates only a candidate-classification table without identifying information. You will neither list devices visible to a computer nor identify suitable hardware. Completing the form does not establish hardware compatibility.
- Purpose
- Classify interface candidates by documented characteristics without guessing whether the hardware is suitable.
- Prepare
- A blank offline classification sheet, and safety boundaries for Chapters 3 and 4.
- Time
- About 15 minutes
- System change
- Do not modify Home Assistant; create only an offline interface-classification table without real device paths or serial numbers.
- Expected result
- Classify interface candidates by de-identified characteristics while keeping hardware availability unproven.
- Stop conditions
- The task would copy or publish real device paths, USB serial numbers, or host identifiers.
- The task requires access to a KNX interface, KNX bus, or physical device.
Scope and safety boundaries
You are organizing only how data should be classified. Do not enumerate devices, view real device paths, or copy serial numbers. Do not publish real hostnames, IP addresses, endpoints, credentials, or time clues. If existing material contains any of these, stop transferring it and follow the safe log-sharing guidance.
This chapter does not add the repository, install or start it. These actions may only be evaluated separately after complete isolation, written approval, and approved immutable artifact/image provenance are established. This site currently lacks an approved artifact/image digest and must not be executed.
Also do not connect the interface or the KNX bus. Group reading, group writing, telegram transmission, ETS programming or downloads and physical control are prohibited.
Core concepts
First classify the candidate records, then decide what needs review. Do not reverse that process by guessing.
Number-only claim ticket
Think of it this way: The cloakroom gives you two tickets, "Candidate A" and "Candidate B". The ticket is only used to distinguish two items and does not include name, brand or locker location.
Formal term: Candidate classification of serial interfaces for de-identification.
The candidate code answers only whether two entries refer to the same record. It does not answer the hardware model, driver compatibility or KNX bus status.
There are only three judgments in the classification table: the source document has been explained, manual review is needed, and it is beyond this chapter. When seeing the existence of candidates, the most we can say is "there is a record to classify." Do not write "interface found" or "available".
Preparation and prerequisites
Prepare a blank sheet. Only create the following fields without filling in any environment values:
- Candidate codenames: Use meaningless labels like "Candidate A".
- Data categories: document facts, issues to be reviewed, or information prohibited from being disclosed.
- Field role: Whether this data may be an interface input.
- Current conclusion: Always start with "hardware applicability not proven".
- Reasons for stopping: unapproved records, data that may identify an environment, or a source-version mismatch.
Don't prepare terminal commands, device lists, or screenshots. There is no live enumeration program in this chapter.
Steps
The following are all classified on offline paper. You do not need to touch the execution environment.
- Write the common conclusion first. Write in the header "This list is only for candidate classification; hardware compatibility, driver operation and bus status have not been confirmed."
- Create a neutral code name. When you need to distinguish between existing de-identified records, write candidate A and candidate B in order. Do not generate codes from path, serial number, model, or location.
- Classify each record by role. Put each content into "Document Facts", "Pending Manual Review" or "Not to be Disclosed". If there is not enough content, mark it as unknown.
- Write down things that are not proven. For each candidate, mark hardware identity, driver family, usability, and KNX bus status as unconfirmed.
- Apply the stop condition. If classification requires reviewing an actual path, serial number, host, or live device list, stop. Do not probe step by step to find the answer.
- Give it to another person to review. Only de-identified classification sheets are delivered. Reviewers are asked to confirm that there is no environment-identifying information and no compatibility claims.
Verification and evidence
The correct result is a classification table, not an installation answer. Use the checklist below to keep the document within scope.
- My table only has candidate codenames, no real paths, serial numbers, hosts, IPs, or endpoints.
- I did not perform live enumeration, nor did I provide related programs.
- Each candidate remains "hardware suitability unproven".
- I did not install or start anything, connect to the bus, perform group or ETS operations, or control physical equipment.
Next step: Go to Chapter 6. Select only a driver-family candidate documented by the pinned source for later manual review; do not try to start it.
Troubleshooting
- Not sure where the candidates come from: Mark "Unknown Source" and stop. Don't go back to the live system to find answers.
- Candidate codenames imply model or location: Change it back to a meaningless letter code and delete the old copy.
- A colleague asked for the real path: Do not provide it. Convert the requirement into "Which field role needs to be reviewed?"
- The table looks like a compatibility list: Add "hardware suitability not confirmed" to each column and remove words such as "recommended" or "confirmed."
- Someone suggests starting candidates one by one: Stop. Starting software is outside this chapter's classification exercise and cannot bypass isolation, approval, or artifact-provenance gates.
FAQ
Advanced note: Where is the actual support for pinned sources?
Pinned initialization sources for Add-on 0.6.1 include interface classification, device-field handling, USB-value conversion, and template-replacement logic. These describe source-code behavior. They neither provide a live device inventory nor prove that any candidate hardware exists or is compatible.
When you need to check version boundaries, see Version and Compatibility Notes. Different versions cannot be directly extrapolated.
Does candidate A actually have a device?
No. It is just a classification ticket used to distinguish existing de-identified records.
Can you provide instructions for finding the device?
No. This chapter intentionally does not provide a live enumeration program, nor does it require access to the running environment.
Can I choose a driver after seeing the candidates?
No. The existence of a candidate is different evidence than the driver file. Chapter 6 also only makes file-level candidates and does not prove compatibility.
Can the serial number be hashed and used as a code number?
No. Codenames derived from identification values may still be correlated. Just use meaningless candidate letters.
When will the classification table be completed?
It is complete only when the data has been de-identified, the source hierarchy is clear, and unconfirmed matters and reasons for stopping are present. The hardware remains unverified.
Evidence and sources
Evidence class: source-bounded
Feature crosswalk: addon-init-configuration-lifecycle
Pinned sources support only the documented scope. This page does not represent validation of any local environment, hardware, network, or KNX bus.