# DALI-GW KNX Product XML

This folder contains the gateway-owned KNX product source for the REG1-Dali KNX-DALI gateway persona.

`DALI-GW.reference.xml` is a mechanically adapted OpenKNXproducer source-form copy of the working secure OpenKNX DALI gateway application XML from `temp/OpenKNX-DALI-gateway`. The source keeps the gateway manufacturer/product identity while preserving the original parameter pages, module repeats, communication objects, group-object references, and secure application metadata.

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/*.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`.