当我写下第一份 将Ajax警报连接到Home Assistant的指南时，需要在SIA、Jeedom、MQTT、主题之间周旋……结果运行得非常好，但必须喜欢复杂的系统。今天，场景完全改变：开发者开发了一种 Ajax Home Assistant原生集成，通过HACS安装，可以直接与Ajax官方Cloud API进行对话。布防、撤防、通知、传感器、继电器……所有内容几乎实时地出现在Home Assistant中！
在我家安装了几天后，我提议大家更详细地了解这个期待已久的插件……
关于旧方法的快速回顾
到目前为止，谈论Ajax Home Assistant有两种方法。
第一种是通过Home Assistant的SIA报警系统集成。Ajax警报被配置为Home Assistant是一个监控中心。我们可以获取系统状态、一些火灾/淹水信息，仅此而已。无法控制警报，也没有有关每个传感器的详细信息。这主要用于根据警报的整体状态触发一些场景，例如在离开家时将加热器切换到节能模式。
第二种方法是在我的上一份指南中详细介绍的，使用Jeedom上的Ajax插件，然后通过MQTT将所有信息重新发布到Home Assistant。要全面得多，几乎可以获取到所有Ajax传感器，但需要一个额外的智能家居服务器，一个MQTT代理，映射数十个主题……简而言之，功能强大，但显然不是每个人都能做到。
新插件完全改变了游戏规则：Ajax Home Assistant成为一个更易于设置的组合。
新Ajax Home Assistant插件的功能
集成 ajax-hass 是一个自定义的Home Assistant组件，直接通过API和gRPC流连接Ajax云，正如Ajax移动应用一样。实际上，您的Ajax Hub在Home Assistant中成为一个“一级公民”，拥有真实的警报面板和用于传感器、警报器、继电器、插座等的实体。
您获得了完全的安全控制。Home Assistant警报面板允许完全布防、撤防、夜间模式、分组部分布防，甚至在某些传感器保持开放时的强制布防。一个专用服务管理紧急按钮，可以放在仪表板上或虚拟遥控器上。
在信息反馈方面，插件暴露了布防/撤防事件，用户Ajax的姓名，警报通知，运动检测，门窗开启，火灾或淹水警报，以及电池电量、信号质量、温度或连接状态等“技术”传感器。这非常全面。
集成可以根据需要管理多个Ajax Hub，并且界面已经翻译为中文。就设备范围而言，开发者优先测试Hub 2 Plus和MotionCam，但架构基于Ajax官方API，并且社区已经验证了相当多的键盘、警报器、开门触点、烟雾探测器等。
因此，我们得到了一个真正的Ajax Home Assistant组合，能够精细控制和观察警报系统，无需绕路。
准备您的Ajax和Home Assistant安装
在开始之前，最好检查一些先决条件。
您的Ajax系统必须正常运行，Hub在官方应用中进行配置，所有检测器被正确添加和命名，并且如果可能，已经定义组（底层、楼层、车库等）。Ajax配置越干净，Home Assistant部分的使用体验将越愉快。
在智能家居方面，需要一个最新版本的Home Assistant，已经安装并正常工作的HACS，因为Ajax Home Assistant插件作为自定义集成分发。还要确保您的Home Assistant实例可以正常访问Ajax服务器，因为通信通过HTTPS和gRPC通过Cloud进行。
最后，确保您的Home Assistant安装得到妥善保护：强密码、受保护的远程访问（反向代理、认证、TLS证书）和定期备份。将警报系统集成到智能家居中非常实用，但这意味着对整体基础设施的安全性需要更加严格。
通过HACS安装Ajax集成
让我们开始实际操作。HACS已经在您的Home Assistant上就位了？完美，我们可以开始安装Ajax Home Assistant插件。
第一步是将插件的GitHub仓库声明在HACS中。在Home Assistant的界面中，打开HACS，然后转到集成部分。在右上角，有一个带三个小点的按钮，可以访问高级菜单。选择“自定义仓库”选项，您将能够添加一个新仓库。
在URL字段中，输入仓库地址 https://github.com/foXaCe/ajax-hass，并选择“Integration”作为类别。确认，然后关闭窗口。下次您在HACS中查找集成时，“Ajax Security System”将出现在列表中。
仍然在HACS中，搜索“Ajax Security System”，打开相应卡片，然后安装它。
HACS将下载ajax-hass组件并将其放置在您Home Assistant安装的 custom_components/ajax 目录中。
安装完成后，需要重新启动Home Assistant以加载新的集成。
将Ajax Home Assistant集成到Home Assistant中
重新启动Home Assistant后，可以开始配置。一切都可以通过界面完成，而无需必需的YAML，这真是一件好事！
打开“设置”菜单，然后选择“设备和服务”。在页面底部，使用“添加集成”按钮。在搜索框中输入“Ajax”。您应该看到“Ajax Security System”及其相应图标。选择它以启动配置助手。
集成会要求您输入您的Ajax账户的凭据，即在官方应用中使用的电子邮件地址和密码。插件不需要Hub的本地IP地址，也无需杂项端口，一切通过Ajax Cloud进行。
接下来是一个非常实用的设置：通知过滤器。您可以选择不在Home Assistant中推送任何通知，仅推送入侵警报、安全事件（布防/撤防、技术警报），或绝对所有，包括实时传感器事件。如果您计划创建大量Ajax Home Assistant自动化，通常至少从安全事件开始会很有趣，然后再调整。
确认，等待几秒钟：集成联系Ajax云，获取您的Hub列表。在这里，我有3个不同的Ajax系统：我可以全部添加或仅选择我感兴趣的一个，比如这里的“家”。
我们确认。系统会从所选的Hub中获取组和所有设备，然后在Home Assistant中创建相应的实体。如果需要，您可以分配一个房间：
集成后Home Assistant中的内容
将Ajax Home Assistant集成放置后，查看“设备和服务”可以看到结果。每个Ajax Hub都作为一个设备出现，主警报面板以及一组传感器和执行器。
警报面板以 alarm_control_panel 实体的形式呈现，允许对整个房屋进行布防、切换到夜间模式、撤防，并在您在Ajax应用中配置的情况下使用分组部分布防。此实体成为您安全场景的中心。
运动传感器作为传统的 binary_sensor 进行展示，当检测到运动时状态变为“开”，并在休眠时间后恢复为“关”。门窗接触传感器也以二进制传感器的形式报告，非常适合在窗户打开过久时触发相关场景以切断供暖。
烟雾、二氧化碳或水浸探测器同样会变为可直接使用的实体。
Ajax插座和继电器作为开关或执行器浮现，可以从Home Assistant进行控制。例如，可以在发生故障时通过Ajax继电器切断设备的电源。
对于比较挑剔的用户，还有一系列“技术”传感器出现：电池电量、无线信号强度、温度、连接状态等。这些都是在Home Assistant中创建“Ajax系统健康”仪表板的良好基础。
Ajax Home Assistant情景示例
一旦所有内容都被反馈到Home Assistant中，最有趣的部分就开始了：自动化。这个Ajax Home Assistant集成的强大之处，就在于事件反馈的反应速度和对警报的控制能力。
第一个非常有用的场景是当所有人离开家时自动布防。我们使用Home Assistant移动应用或其他出席系统中的人员存在，通过“not_home”状态触发总布防，当最后一个人离开时。
一个最简单的YAML示例可能类似于：
automation:
- alias: "当所有人离开时布防Ajax"
trigger:
- platform: state
entity_id: group.famille
to: "not_home"
action:
- service: alarm_control_panel.alarm_arm_away
target:
entity_id: alarm_control_panel.ajax_alarm_home
我们可以设想相反的情况：当一个人到达时自动撤防，并伴随一些灯光渐亮，以及某些模拟出席的场景的禁用。
另一个常见的用例是关于加热。Ajax上报到Home Assistant的开窗传感器可以在窗户打开超过五分钟时切断电加热或空调，当窗户关闭后再重新激活系统。无需多次使用Zigbee或Z-Wave传感器来有效处理开窗问题。
Ajax运动传感器还可以参与照明管理。我们可以决定，在晚上，仅在走廊的运动传感器前经过时会触发夜灯或床边的LED带，低亮度，持续几分钟。警报不会被触发，但我们重新利用基础架构以提供舒适。这是良好集成的智能家居的小乐趣之一。
最后，Ajax的紧急按钮以“button”实体形式展现在仪表板上，可以放置在专为成人设计的仪表板上，甚至可以藏在受密码保护的卡片后，用于触发全局警报：警报器、外部照明100%、发送智能手机通知，甚至通过第三方服务拨打给亲友。在这种场景中，最好在真实条件下测试，但事先告知所有人……
与Ajax Home Assistant的安全性和最佳实践
通过此插件将Ajax集成到Home Assistant意味着Home Assistant成为安全链中的一部分。开发者关注隐私部分：凭据存储在Home Assistant的加密系统中，密码在发送到Ajax服务器前被哈希处理，通信通过TLS传递，且没有数据发送到第三方服务。集成是开源且可审计的，这对于安全系统而言是令人放心的。
不过，仍需保持一些警觉。无论如何将Home Assistant暴露于互联网都成为警报系统的入口。因此，确保锁定外部访问、及时更新Home Assistant和Ajax集成，避免增加多个管理员账户是至关重要的。尤其是强制布防应谨慎使用，因为它允许在传感器开放或故障时仍然布防系统。
最后一点：这个插件依赖于Ajax云。如果您的互联网连接中断或Ajax服务器无法访问，Hub仍然可以保护住宅，但与Home Assistant的实时连接将被中断。
实际上，为什么要采用这个Ajax Home Assistant插件
总结起来，我们从一个“拼凑”的集成转变到一个专用的Ajax Home Assistant插件，该插件维护良好，并在设备管理方面功能非常强大。安装通过HACS进行，配置仅通过界面完成，您可以对警报进行完全控制，事件反馈几乎是即时的。
在日常生活中，这意味着更智能的场景、安全与舒适之间的真正一致性，同时减少了整个房子中的传感器重复。对于安装人员来说，这也是一个重要的卖点，特别是对那些已经配备Ajax的客户，他们希望通过Home Assistant实现全屋控制。
而这个故事中最令人愉快的是，“更全面”不再与“更复杂”相关。
