ioBroker.bosch-buderus-wp

🇩🇪德国安莱通

博世MX400 /博世K 40射频适配器ibroker

该适配器读取a的数据 热泵 （Buderus和其他人）通过官方 本地API 的 局域网和无线电模块Buderus MX400 /博世k40 RF． 该连接直接在您的家庭网络中运行。不需要云帐户。

Buderus LAN和无线电模块MX400（左）和博世Connect-Key k40 RF（右）。适配器与该模块通信，并与MX400进行了测试。

MX400是供暖系统的互联网网关和无线电模块。它位于热泵的插槽中，并通过局域网或Wi-Fi连接到家庭网络。根据制造商的说法，博世Connect-Key k40 RF和IVT， Vulcano和Worcester的k40 RF也提供相同的本地API。该适配器是用Buderus MX400开发和测试的。

制造商: 博世先后 · MX400的产品信息（Buderus， PDF）

注意: 制造商的API目前是 只读． 适配器可以显示所有值，但不能更改热泵的设置。

特性

• 自动读取所有可用值。 在启动时，适配器检查制造商API规范中描述的每个资源，并仅为系统实际提供的资源创建数据点。此外，读取设备本身报告的所有信号。
• 11种语言的名字 对于所有数据点（英语，德语，俄语，葡萄牙语，荷兰语，法语，意大利语，西班牙语，波兰语，乌克兰语，中文），具有正确的单位（°C, kWh, %, l/h…）和匹配的角色
• 能源计数器 （例如总消耗量、暖气、热水）作为产生的热量、压缩机和电加热器的单独数据点
• 历史数据 对于消耗，启动，工作时间和温度：过去31天的每日值，过去12个月的每月值，加上 今天 和 这个月． 温度显示为平均值，能量值显示为总数。
• 复杂的响应 例如错误消息或系统信息被分割成单独的数据点，并且完整的响应也可以作为JSON提供。
• 传感器特殊值 （短路，开路，流量过低…）不显示为测量值，数据点保持空。
• 连接指示器 （info.connection)在实例列表中
• 轻按设备： 很少改变的值（历史数据，Wi-Fi列表）每小时只读取一次。在启动期间未应答的资源每小时重试一次。存储在MX400上找到的资源列表，因此适配器在重新启动后立即准备好。它每天刷新一次，或者当你点击设置中的按钮时刷新一次。
• 只有真正的变化才会被写入： 一个值只有在它发生变化时才会写入它的数据点，这使得诸如History或InfluxDB之类的日志适配器的负载很低。

系统概述上显示的是热泵。ioBroker还提供室外温度、流量和回流温度、热水温度和操作压力等值。

需求

• Buderus热泵与 局域网和无线电模块MX400 （或其他支持的k40 RF网关） 网关固件15.00.01或更新版本
• MX400和ibroker必须在同一个本地网络中。
• 一个 API令牌 为MX400（见下文）
• iobbroker使用js-controller 6.0.11或更新版本，Admin为7.6.20或更新版本
• Node.js 22或更新版本

创建API令牌

创建令牌 一次 与 Login 和 Pass 从MX400的标签或信息页中获取值。令牌不会过期，因此可以安全地存储它并将其视为密码。

选项1：直接在适配器设置中（推荐）

1. 进入 IP地址 在MX400的设置。
2. 输入 登录 和 通过 （连字符会自动删除）。这两个值不被存储。
3. 按下 无线局域网 和 无线 同时按下MX400上的按钮，持续一秒钟。led灯短暂闪过蓝色。
4. 5分钟内,点击 请求API令牌 在设置中。令牌出现在字段中 API令牌． 若要在iobbroker外部保留令牌备份（例如在密码管理器中），请勾选 显示API令牌 在田地下面。然后显示令牌，可以使用旁边的按钮复制令牌。
5. 点击 保存。

仅请求一次令牌并保留它：每次请求都会在MX400上创建一个新令牌，并且其令牌内存有限（错误） 507 Token database full（如制造商指南中所述，可以撤销未使用的令牌）。

选项2：手动使用curl

厂家指南简短总结：

1. 在路由器中找到MX400的IP地址。

2. 删除。中的所有连字符 Pass 价值。

3. 按下 无线局域网 和 无线 同时按下MX400上的按钮，持续一秒钟。led灯短暂闪过蓝色。

4. 5分钟内请求令牌（端口9442）：

   curl --insecure --request POST "https://IP-ADDRESS:9442/auth/token" \
     --header "Content-Type: application/x-www-form-urlencoded" \
     --data-urlencode "grant_type=password" \
     --data-urlencode "username=LOGIN" \
     --data-urlencode "password=PASS-WITHOUT-HYPHENS" \
     --data-urlencode "client_name=iobroker"
   

   在Windows （PowerShell）上，写入 curl.exe 而不是 curl 并将命令放在单行中，不带 \。

5. 复制的值 access_token 从响应中输入到字段中 API令牌。

完整的指南与故障排除： k40射频API文档（Bosch Home Comfort）

安装

通过ioBroker Admin: open的适配器列表安装适配器 适配器，搜索 博世先后MX400 然后安装它。然后创建适配器的实例。

配置

在第一次启动时，适配器检查API的所有资源。这大约需要一到两分钟。然后日志显示系统提供了多少资源，例如： “搜索完成：已检查1286条路径，目前有118条路径……”。

数据点

显示哪些文件夹和值取决于您的系统。

安全笔记

• MX400使用的是自签名证书。因此，按照制造商的建议，适配器不只为这个连接验证证书。数据仍然是加密传输的。仅在受信任的本地网络中使用适配器。
• 令牌以加密方式存储在ioBroker中，并且仅对适配器本身可用。

支持发展

你喜欢这个适配器吗？你可以通过捐赠咖啡来支持它的发展：

关于AI参与的说明

这个适配器是在人工智能助手（Claude by Anthropic）的帮助下开发的。在Raspberry Pi 5上用真正的Buderus MX400进行了测试。将数据点名称翻译成俄语、葡萄牙语、荷兰语、法语、意大利语、西班牙语、波兰语、乌克兰语和中文也是在人工智能的帮助下创建的，没有经过母语人士的检查。欢迎指正。

免责声明

该适配器是一个私人项目，与Bosch Thermotechnik GmbH或Buderus无关。所有产品和公司名称均为其各自所有者的商标。使用风险自负。

更新日志

0.0.8 (2026-11-03)

• （septa-cr）新：API令牌可以显示在设置（复选框“显示API令牌”与复制按钮），以便它的备份可以保留在iobbroker之外
• （septa-cr）传感器名称PH1， PL1, TR1, TR3, TR5, TR6， TC3和TA4现在是匹配温度数据点名称的一部分

0.0.7 (2026-11-02)

• （septa-cr）适配器从buderus-mx400重命名为bosch-buderus-wp，因为它支持多个品牌（实例和数据点id更改，请创建一个新实例）
• 标题，描述和关键词现在也命名博世k40 RF（和IVT， Vulcano，伍斯特）
• （septa-cr）自述：模块的新照片，关于AI参与的说明

0.0.6 (2026-10-23)

• （sepa -cr）除德语和英语外，现在还提供所有推荐语言（俄语、葡萄牙语、荷兰语、法语、意大利语、西班牙语、波兰语、乌克兰语、中文）的数据点名称
• （septa-cr）文件名的文件更紧凑：编号名称（加热电路1到4等）是从模板生成的
• （septa-cr）田野 _pass 现在被声明为受保护并在 io-package.json

0.0.5 (2026-10-23)

• （septa-cr）新：API令牌可以在适配器设置中直接请求（MX400的登录和通过，按钮“请求API令牌”），不再需要curl
• （septa-cr）新：在MX400上发现的资源列表被存储并在下次启动时重用，它每天刷新一次或通过设置中的按钮刷新
• （septa-cr）值只有在改变时才会被写入(setStateChanged）
• （septa-cr）文档：所需的Admin版本更正（7.6.20）

0.0.4 (2026-10-22)

• （septa-cr）根据ioBroker存储库的要求进行调整：最低Node.js 22，使用Node.js 22、24和26进行测试，通过可信发布自动发布，更新联系地址和安装说明

旧的变更日志条目可以在 CHANGELOG_OLD.md。

许可证

麻省理工学院的许可

版权所有(c) 2026 sep -cr [email protected]

特此向任何获得副本的人免费授予许可 本软件及相关文档文件（“软件”），以处理 不受任何限制，包括但不限于权利 使用、复制、修改、合并、发布、分发、再许可和/或出售 本软件的副本，并允许使用本软件的人 提供这样做，但须符合以下条件：

上述版权声明和本许可声明应包括在所有 本软件的副本或实质性部分。

本软件是“按原样”提供的，没有任何形式的、明示的或明示的保证 默示，包括但不限于对适销性的保证； 适合某一特定目的和不侵权。在任何情况下都不得 作者或版权持有人应对任何索赔、损害赔偿或其他责任 在合同诉讼、侵权诉讼或其他诉讼中，因下列原因引起的责任： 不属于或与本软件或本软件的使用或其他交易有关 软件。