Skip to content

Repository files navigation

BTDoor Security+

BTDoor Security+ is the access, video-door-entry, and security module of the broader BTDoor Platform for Home Assistant.

The current 1.x line consolidates the stable BTDoor core. Later roadmap series cover the wider BTicino/Netatmo ecosystem, the public SDK and extension framework, whole-home intelligence, and enterprise or installer capabilities. Planned capabilities are documented in the roadmap and are not presented as current runtime features.

Start here

Current release

1.1.0-rc.15

This is a release candidate on the road to 1.1.0 Final. See the RC.15 release notes, the changelog, and the release checklist for the current status and remaining validation work.

Implemented entity surface

  • button.apri_cancello: native momentary gate command for Home Assistant and Assist.
  • switch.apri_cancello_alexa: optional stateless bridge created only when Quick voice gate is enabled. It is attached to a dedicated virtual device so supported voice assistants can discover it as a controllable device instead of a scene.
  • SIP, call, media, and diagnostic entities are grouped into dedicated logical devices.

Entity IDs may be customized by users. Automations and generated dashboards should resolve stable unique IDs or documented integration contracts rather than assume a fixed entity ID.

Alexa, Alexa+, and Google Assistant

Expose only switch.apri_cancello_alexa for manual control in the assistant application. Do not expose the native button when you want to avoid the additional scene that may be generated by Alexa. The switch returns immediately to off after sending one opening impulse.

Alexa discovery and gate operation are confirmed in the current project evidence. Google Assistant exposure is documented as supported by the entity contract but still requires final real-account/device validation before 1.1.0 Final. Alexa+ follows the same exposure boundary unless a future adapter explicitly documents different behavior.

Gate opening is security-sensitive. Limit exposure to trusted households and enable voice confirmation or PIN controls where the assistant supports them. See the voice-assistant API contract and security documentation.

Installation

Install through HACS as a custom repository, or copy custom_components/btdoor_security_plus into the Home Assistant configuration directory and restart Home Assistant.

The release target is Home Assistant 2026.x and the Python version supported by that Home Assistant release line. Compatibility claims and evidence levels are maintained in the compatibility documentation.

Support

Generate the integration Support Bundle before opening an issue. Sensitive identifiers and credentials are redacted by the integration's privacy controls. Follow the support and issue-reporting guidance and the security policy.

Project governance and continuity

The repository is the source of truth. The Foundation describes how the project is built, while docs/roadmap is the only official roadmap and describes what the project may become.

Release work, documentation lifecycle, ADR requirements, validation evidence, and continuity rules are defined by:

No roadmap, handoff, or documentation index under docs/project/ should be used as the canonical source when it is marked deprecated; those files remain only as compatibility entry points.

Target Validation Pack

Final-target evidence collection is governed by docs/target-validation/README.md.

Release pipeline

Publication readiness and deterministic candidate artifacts are managed by tools/distribution/release_pipeline.py. See docs/release-pipeline/README.md.

Repository production audit

Run python tools/audit/production_audit.py to generate the Phase 7A production-readiness report. A PASS confirms repository hygiene only; Final publication remains controlled by target certification and release gates.

Phase 7B status

Home Assistant certification enablement is implemented. Live-target execution remains pending and release approval is not granted.

Home Assistant Integration Quality Scale

The repository includes a conservative self-assessment against the official Bronze, Silver, Gold and Platinum rule set. Gold is the fixed governed project target and release gate; Platinum is reported only for transparency and is out of scope. Run python tools/quality_scale/quality_scale_workflow.py check. This is not an official Home Assistant Core grade.

About

Home Assistant integration for Bticino/Legrand and Netatmo intercom systems with Cloud, SIP, TLS, diagnostics and gate control

Topics

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages