Files
gateway/components/knx_dali_gw/knxprod/README.md
T
Tony 4fa1b3cb06 Refactor DALI-GW XML and README for clarity and accuracy
- Updated DALI-GW.xml to correct application version and product naming conventions.
- Removed unnecessary configuration parameters from XML.
- Revised README.md for improved clarity on the source and migration process.
- Adjusted application version in README to reflect changes in DALI-GW.xml.
- Enhanced instructions for generating product database artifacts.

Signed-off-by: Tony <tonylu@tony-cloud.com>
2026-05-30 14:04:22 +08:00

1.9 KiB

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:

xmllint --noout gateway/components/knx_dali_gw/knxprod/*.xml

Generate the product database artifact with the local non-ETS producer build:

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.