Skip to content

ashokkumar-t/ha-knx-ir-framework

Home Assistant KNX IR Framework

CI CodeQL License: MIT

A Home Assistant custom integration framework for translating KNX events into infrared commands. The project is at its repository-foundation stage; runtime device support will arrive in later sprints.

Goals

  • Keep Home Assistant, KNX transport, and IR hardware concerns independently testable.
  • Model commands and mappings without coupling them to a particular IR controller.
  • Make new device profiles and transport adapters straightforward to add.
  • Ship changes through repeatable quality and security checks.

Repository layout

custom_components/knx_ir_framework/
  application/      Use cases and orchestration
  domain/           Transport-independent models and contracts
  infrastructure/   KNX, IR, and persistence adapters
  manifest.json     Home Assistant integration metadata
framework/          Reusable YAML core, engines, transports, and utilities
examples/           Portable device definitions and package composition
docs/               Architecture and development guidance
tests/              Automated tests mirroring the integration layers

See Architecture for dependency rules and Development for local setup.

Status

Sprint 2 provides the v0.2.0-alpha device-agnostic core, including command dispatch, transport and helper contracts, validation, logging, templates, scripts, examples, and tests. It remains an alpha release and is not yet recommended for production installations.

Contributing

Read CONTRIBUTING.md before opening a change. By participating, you agree to follow the Code of Conduct. Please report vulnerabilities using the process in SECURITY.md.

License

Licensed under the MIT License.

About

A modular Home Assistant framework for KNX, Global Caché, and IR-controlled devices.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages