Tony
1342ab6aaf
- Introduced DALI-GW.security.xml to define security settings including enabling security and maximum entries for individual addresses and group keys. - Updated DALI-GW.xml to reference the new security configuration file. - Enhanced README.md to document the purpose of DALI-GW.security.xml and clarify the organization of XML fragments in the project. Signed-off-by: Tony <tonylu@tony-cloud.com>
49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# DALI-GW KNX Product XML
|
|
|
|
This folder contains the gateway-owned KNX product source for the REG1-Dali KNX-DALI gateway persona.
|
|
|
|
The source is organized as independent OpenKNXproducer XML fragments. `DALI-GW.base.xml` owns catalog, baggage, and hardware metadata; `DALI-GW.model.xml` owns the application shell and include order; `DALI-GW.common.xml` owns shared static types, scripts, messages, general UI, and the common module; `DALI-GW-address.xml`, `DALI-GW-group.xml`, `DALI-GW-scene.xml`, and `DALI-GW-hcl.xml` own their functional modules and dynamic channels; `DALI-GW.security.xml` owns the KNX Secure configuration values.
|
|
|
|
The source is self-contained in this folder and does not include XML from external OpenKNX module repositories.
|
|
|
|
Current migration targets:
|
|
|
|
- Manufacturer/OpenKNX id: `0xA4`
|
|
- Application number: `0x01`
|
|
- Application version: `0x08`
|
|
- Mask: `MV-07B0`
|
|
- Order number: `REG1-Dali`
|
|
- KNX secure: enabled
|
|
- Address channels: `64`
|
|
- Group channels: `16`
|
|
- HCL curves: `3`
|
|
|
|
The existing color type values stay stable for compatibility:
|
|
|
|
- `HSV = 0`
|
|
- `RGB = 1`
|
|
- `TW = 2`
|
|
- `XYY = 3`
|
|
- `RGBW = 4`
|
|
- `RGBCW = 5`
|
|
|
|
RGBW is exposed with standard DPT `251.600` (`DPT_Colour_RGBW`). RGBCW uses the same RGBW payload shape and maps the white and amber DT8 RGBWAF channels as cool-white and warm-white levels at runtime because the local KNX master database does not define a standard RGBCW datapoint subtype.
|
|
|
|
## Validation
|
|
|
|
Run a well-formed XML check from the repository root:
|
|
|
|
```sh
|
|
xmllint --noout gateway/components/knx_dali_gw/knxprod/DALI-GW*.xml
|
|
```
|
|
|
|
Generate the product database artifact with the local non-ETS producer build:
|
|
|
|
```sh
|
|
cd gateway/components/knx_dali_gw/knxprod
|
|
/Users/tonylu/Downloads/OpenKNXproducer-osx-arm64/OpenKNXproducer create -o test.knxprod DALI-GW.xml
|
|
```
|
|
|
|
The source is expected to pass the producer's standard `create` sanity checks directly. Generated files such as `test.knxprod`, `DALI-GW.baggages/`, and debug XML files should not be committed.
|
|
|
|
The runtime identity must stay synchronized with `gateway/apps/gateway/main/Kconfig.projbuild` and `gateway/components/knx_dali_gw/src/knx_dali_gw.cpp`. |