# iobroker\.bosch-buderus-wp 中文文档

规范地址：https://npmcn.com/package/iobroker.bosch-buderus-wp/

版本：0\.0\.8
npm 元数据更新时间：2026-11-03T20:20:15.586Z
中文译文更新时间：2026-11-04T00:05:54.252Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/iobroker.bosch-buderus-wp
原文对照：https://npmcn.com/package/iobroker.bosch-buderus-wp/?lang=original
项目主页：https://github.com/septa-cr/ioBroker.bosch-buderus-wp
源码仓库：https://github.com/septa-cr/ioBroker.bosch-buderus-wp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：490 kB，21 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-11-02T21:05:51.242Z
- 最新版本发布：2026-11-03T20:20:15.234Z
- 已发布版本数：4（近 12 个月 4 个）

## 中文简介

通过Buderus MX400 / Bosch K 40射频局域网和无线电模块的本地API读取热泵的所有数据

## 安装

```sh
npm install iobroker.bosch-buderus-wp
```

也可以使用：`pnpm add iobroker.bosch-buderus-wp`、`yarn add iobroker.bosch-buderus-wp`、`bun add iobroker.bosch-buderus-wp`

## README

![Logo](https://npmcn.com/package/iobroker.bosch-buderus-wp/admin/bosch-buderus-wp.png)

# ioBroker.bosch-buderus-wp

![Test and Release](https://github.com/septa-cr/ioBroker.bosch-buderus-wp/workflows/Test%20and%20Release/badge.svg) [![License](https://img.shields.io/github/license/septa-cr/ioBroker.bosch-buderus-wp)](https://npmcn.com/package/iobroker.bosch-buderus-wp/LICENSE) [![Donate](https://img.shields.io/badge/Donate-PayPal-ffc439.svg)](https://www.paypal.com/donate/?hosted_button_id=BW2WL8QCH2AMU)

**[🇩🇪德国安莱通](https://npmcn.com/package/iobroker.bosch-buderus-wp/docs/de/README.md)**

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

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

![Buderus LAN and radio module MX400 (left) and Bosch Connect-Key K 40 RF (right)](https://npmcn.com/package/iobroker.bosch-buderus-wp/docs/img/mx400.png)

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

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

制造商: [博世先后](https://www.buderus.de/) · [MX400的产品信息（Buderus， PDF）](https://www.buderus.de/resource/blob/84532/5f174d97fdbaf3201210da560b2364a7/18_Buderus_ISH-2025_LAN-%20und-Funkmodul-MX400.pdf)

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

## 特性

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

![System overview on the display of the heat pump](https://npmcn.com/package/iobroker.bosch-buderus-wp/docs/img/display.jpg)

_系统概述上显示的是热泵。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）：
    
    ```bash
    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）](https://github.com/bosch-home-comfort/api-docs/blob/main/docs/k-40-rf.md)

## 安装

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

## 配置

| 设置 | 描述 |
| --- | --- |
| MX400的IP地址 | 网络中MX400的IP地址，例如： `192.168.178.xxx` |
| API令牌 | 如上所述创建的令牌。它是加密存储的。 |
| 登入/通行证 | 只需要一次请求令牌。它们没有被存储。 |
| 轮询间隔（秒） | 读取值的频率。默认60，最小10 |

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

## 数据点

| 文件夹 | 内容 |
| --- | --- |
| `info.connection` | 连接到MX400（真/假） |
| `info.discoveredPaths` | 在MX400上找到的资源的内部列表（JSON） |
| `signals.*` | 设备报告的所有信号，如室外温度、流量温度、压缩机转速 |
| `heatSources.*` | 热泵：温度、压缩机功率、系统压力、能量计数器 |
| `heatingCircuits.hc1.*` | 加热回路1：室温、设定值、泵和状态 |
| `dhwCircuits.dhw1.*` | 热水：温度，设定值，状态 |
| `devices.device1.*` | 配对无线电设备，如房间控制器 |
| `recordings.*` | 历史数据(`daily`， `monthly`， `today`， `thisMonth`） |
| `system.*`， `gateway.*`， `notifications.*` | 系统信息、网关、错误消息 |

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

## 安全笔记

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

## 支持发展

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

[![Donate via PayPal](https://img.shields.io/badge/Donate%20a%20coffee-PayPal-ffc439.svg?style=for-the-badge)](https://www.paypal.com/donate/?hosted_button_id=BW2WL8QCH2AMU)

## 关于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](https://npmcn.com/package/iobroker.bosch-buderus-wp/CHANGELOG_OLD.md)。

## 许可证

麻省理工学院的许可

版权所有(c) 2026 sep -cr [septamobile@gmail.com](mailto:septamobile@gmail.com)

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

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

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

## 常见问题

### iobroker\.bosch-buderus-wp 是什么？

通过Buderus MX400 / Bosch K 40射频局域网和无线电模块的本地API读取热泵的所有数据

### 如何安装 iobroker\.bosch-buderus-wp？

在项目目录运行 npm install iobroker\.bosch-buderus-wp，或使用 pnpm add / yarn add / bun add。

### iobroker\.bosch-buderus-wp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/iobroker\.bosch-buderus-wp 是否存在。

### iobroker\.bosch-buderus-wp 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### iobroker\.bosch-buderus-wp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### iobroker\.bosch-buderus-wp 可以商用吗？

iobroker\.bosch-buderus-wp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### iobroker\.bosch-buderus-wp 还在维护吗？

最新版本 0\.0\.8 发布于 2026/11/04（1 天前）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/11/03。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。