# homebridge-blinds-wired 中文文档

规范地址：https://npmcn.com/package/homebridge-blinds-wired/

版本：2\.0\.2
npm 元数据更新时间：2026-11-03T19:19:48.267Z
中文译文更新时间：2026-11-03T20:51:43.150Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/homebridge-blinds-wired
原文对照：https://npmcn.com/package/homebridge-blinds-wired/?lang=original
项目主页：https://github.com/adrianmihai83/homebridge-blinds-wired#readme
源码仓库：https://github.com/adrianmihai83/homebridge-blinds-wired

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

- 包体积（解压后）：54.7 kB，15 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：^22\.12\.0 \|\| ^24\.0\.0
- 运行依赖：0 个
- 首次发布：2023-08-28T19:38:43.438Z
- 最新版本发布：2026-11-03T19:19:48.090Z
- 已发布版本数：13（近 12 个月 3 个）

## 中文简介

HomeKit支持非智能电动百叶窗通过有线连接。

## 安装

```sh
npm install homebridge-blinds-wired
```

也可以使用：`pnpm add homebridge-blinds-wired`、`yarn add homebridge-blinds-wired`、`bun add homebridge-blinds-wired`

## README

[![homebridge-blinds-wired: Native HomeKit support for non-smart motorized blinds through wires](https://github.com/adrianmihai83/homebridge-blinds-wired/blob/main/homebridge-blinds-wired.svg)](https://github.com/adrianmihai83/homebridge-blinds-wired)

# Homebridge百叶窗有线

[![Downloads](https://img.shields.io/npm/dt/homebridge-blinds-wired?color=%23333333&logo=icloud&logoColor=%23FFFFFF&style=for-the-badge)](https://www.npmjs.com/package/homebridge-blinds-wired) [![Version](https://img.shields.io/npm/v/homebridge-blinds-wired?label=Homebridge%20Blinds%20Wired&color=%23333333&style=for-the-badge&logoColor=%23FFFFFF&logo=data:image/svg%2bxml;base64,PHN2ZyB3aWR0aD0iMTAyNHB4IiBoZWlnaHQ9IjEwMjRweCIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayI+CjxnIHN0eWxlPSIiPiAgPHBhdGggZD0iTTg2LjI5MTAwMCwyMjIuNTIyOTk1IEwzNy41MDA5OTksMjk3LjE1OTk5NiBMOTg2LjUwMDAyMywyOTcuMTU5OTk2IEw5MzcuNzEwMDIyLDIyMi41Mjg5OTkgTDg2LjI4NzA0OCwyMjIuNTI4OTk5IEw4Ni4yOTEwMDAsMjIyLjUyMjk5NSBaICIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHlsZT0iZmlsbDogcmdiYSgyNTUsIDI1NSwgMjU1LCAxLjAwMDAwMCk7IHN0cm9rZS13aWR0aDogNDEuMTA3NDk4cHg7IHN0cm9rZTogKG51bGwpOyAiIGZpbGw9IiNmZWZmZmYiIHN0cm9rZT0iIyhudWxsKSIgc3Ryb2tlLXdpZHRoPSI0MS4xMDc0OTgiIC8+CiAgPHBhdGggZD0iTTg2LjI5MTAwMCwzOTAuNjI4OTk4IEwzNy41MDA5OTksNDY1LjI2NTk5OSBMOTg2LjUwMDAyMyw0NjUuMjY1OTk5IEw5MzcuNzEwMDIyLDM5MC42MzUwMDIgTDg2LjI4NzA0OCwzOTAuNjM1MDAyIEw4Ni4yOTEwMDAsMzkwLjYyODk5OCBaICIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHlsZT0iZmlsbDogcmdiYSgyNTUsIDI1NSwgMjU1LCAxLjAwMDAwMCk7IHN0cm9rZS13aWR0aDogNDEuMTA3NDk4cHg7IHN0cm9rZTogKG51bGwpOyAiIGZpbGw9IiNmZWZmZmYiIHN0cm9rZT0iIyhudWxsKSIgc3Ryb2tlLXdpZHRoPSI0MS4xMDc0OTgiIC8+CiAgPHBhdGggZD0iTTg2LjI5MTAwMCw1NTguNzM0MDA5IEwzNy41MDA5OTksNjMzLjM3MTAxMCBMOTg2LjUwMDAyMyw2MzMuMzcxMDEwIEw5MzcuNzEwMDIyLDU1OC43NDAwMTMgTDg2LjI4NzA0OCw1NTguNzQwMDEzIEw4Ni4yOTEwMDAsNTU4LjczNDAwOSBaICIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHlsZT0iZmlsbDogcmdiYSgyNTUsIDI1NSwgMjU1LCAxLjAwMDAwMCk7IHN0cm9rZS13aWR0aDogNDEuMTA3NDk4cHg7IHN0cm9rZTogKG51bGwpOyAiIGZpbGw9IiNmZWZmZmYiIHN0cm9rZT0iIyhudWxsKSIgc3Ryb2tlLXdpZHRoPSI0MS4xMDc0OTgiIC8+CiAgPHBhdGggZD0iTTg2LjI5MTAwMCw3MjYuODQwMDI3IEwzNy41MDA5OTksODAxLjQ3NzAyOCBMOTg2LjUwMDAyMyw4MDEuNDc3MDI4IEw5MzcuNzEwMDIyLDcyNi44NDYwMzEgTDg2LjI4NzA0OCw3MjYuODQ2MDMxIEw4Ni4yOTEwMDAsNzI2Ljg0MDAyNyBaICIgc3Ryb2tlLWxpbmVqb2luPSJyb3VuZCIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHlsZT0iZmlsbDogcmdiYSgyNTUsIDI1NSwgMjU1LCAxLjAwMDAwMCk7IHN0cm9rZS13aWR0aDogNDEuMTA3NDk4cHg7IHN0cm9rZTogKG51bGwpOyAiIGZpbGw9IiNmZWZmZmYiIHN0cm9rZT0iIyhudWxsKSIgc3Ryb2tlLXdpZHRoPSI0MS4xMDc0OTgiIC8+CjwvZz48L3N2Zz4=)](https://www.npmjs.com/package/homebridge-blinds-wired)

## HomeKit支持非智能电动百叶窗。

`homebridge-blinds-wired` 是一个 [Homebridge](https://homebridge.io/) 插件，允许您提高，降低，并停止您的百叶窗电线。它为你提供了一个HomeKit窗口覆盖配件，可以报告状态并完全通过电线控制。 如今，市场上有很多带有原生HomeKit支持的百叶窗可供选择。然而，也有一些盲目的系统，比如Somfy，它们没有任何有意义的HomeKit支持。再加上专有的远程协议，您将面临一个挑战，试图使百叶窗成为您的 [HomeKit](https://www.apple.com/ios/home) 智能家居。

## 安装

如果您是第一次使用Homebridge，请先阅读 [Homebridge](https://homebridge.io/) [文档](https://github.com/homebridge/homebridge/wiki) 以及安装说明。

如果您已安装 [Homebridge配置界面](https://github.com/oznu/homebridge-config-ui-x)，您可以通过进入 `Plugins` TAB和搜索 `homebridge-blinds-wired` 然后安装它。

如果你喜欢安装 `homebridge-blinds-wired` 在命令行中，你可以这样做：

```sh
sudo npm install -g homebridge-blinds-wired
```

## 依赖项

确保在树莓派上安装了libgpiod：

```sh
sudo apt install -y build-essential python3 make g++ gpiod libgpiod-dev
```

2.0.2版本支持Homebridge 2。在Node.js 22.12或Node.js 24上安装。

## 配置

我强烈建议使用 [Homebridge配置界面](https://github.com/oznu/homebridge-config-ui-x) 而不是编辑你的配置。直接json。它很好地显示了所有的选项，并总是生成一个有效的配置，这样你就不会被错别字困住，或者在你的 `config.json`。

对于那些喜欢直接配置的人，可以添加平台 `config.json` 在你的主目录里面 `.homebridge`。

```js
   "platforms": [
     {
       "platform": "Blinds Wired",

       "blinds": [
         {
            "name": "Livingroom Curtains",
            "upPin": 17,
            "downPin": 27,
            "stopPin": 99,
            "gpioChip": 0,
            "pulseDuration": 200,
            "activeLow": true,
            "transitionInterval": 15,
            "manufacturer": "Somfy",
            "model": "DCT",
            "serial": "1234-5678"
         }
      ]
    }
  ]
```

### 选项

-   `upPin`， `downPin` 和 `stopPin` 应该指向BCM GPIO / libgpiod线号，而不是物理板引脚。
-   `gpioChip` 是可选的，默认为 `0`，这是树莓派上常用的GPIO芯片编号。
-   设置一个 `stopPin` 与 `transitionInterval` 允许部分位置，例如要求HomeKit打开30%的盲眼。对于Somfy DCT，停止是通过脉冲来完成的 `upPin` 和 `downPin`;使用 `99` 为 `stopPin`． 这也是默认值。
-   `pulseDuration` 以毫秒为单位的脉冲长度。默认为 `200`，适用于Somfy DCT。
-   `activeLow` 选择继电器极性，默认为 `true`。
-   `transitionInterval` 是一个可选设置，允许您模拟在打开和关闭之间的盲目过渡移动。如果百叶窗需要15秒才能打开，请输入 `15` 这里, `homebridge-blinds-wired` 将模拟在HomeKit中完成转换所需的时间。缺省值是10秒。
-   `manufacturer`， `model`, `serial` 是可选设置，允许您在HomeKit中进一步识别您的百叶窗。

每个盲人必须有一个唯一的名字。 `upPin` 和 `downPin` 必须是不同的；一个物理 `stopPin` 还必须使用单独的GPIO线。

## 从v1.x升级

版本2.0.0将GPIO后端从 `rpi-gpio`/ sysfs `node-libgpiod`． 引脚选项现在使用BCM GPIO / libgpiod线号，而不是物理板引脚。

例如:

-   树莓派的物理引脚11是BCM GPIO 17，所以使用 `"upPin": 17`。
-   树莓派物理引脚13是BCM GPIO 27，所以使用 `"downPin": 27`。
-   `stopPin: 99` 是不变的Somfy DCT，仍然脉冲两个向上和向下引脚。

安装v2之前。安装libgpiod开发头文件：

```sh
sudo apt install -y build-essential python3 make g++ gpiod libgpiod-dev
```

## 笔记

这个插件不能查询百叶窗的物理位置。它根据配置的旅行时间估计位置，记住最近的估计，并将该值报告给HomeKit。校准 `transitionInterval` 以实际全行程时间为最佳偏位精度。

当 `transitionInterval` 和 `stopPin` 配置，插件可以估计部分位置。例如，打开20%的盲区，它会跳动 `upPin`，计算运动时间 `transitionInterval`，然后脉冲配置的停止命令。准确的校准产生相当精确的位置，即使是系统，如Somfy DCT不报告其物理位置。

## 插件开发

[![License](https://img.shields.io/npm/l/homebridge-blinds-wired?color=%23333333&logo=open%20source%20initiative&logoColor=%23FFFFFF&style=for-the-badge)](https://github.com/adrianmihai83/homebridge-blinds-wired/blob/main/LICENSE.md)

## 常见问题

### homebridge-blinds-wired 是什么？

HomeKit支持非智能电动百叶窗通过有线连接。

### 如何安装 homebridge-blinds-wired？

在项目目录运行 npm install homebridge-blinds-wired，或使用 pnpm add / yarn add / bun add。

### homebridge-blinds-wired 支持 TypeScript 吗？

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

### homebridge-blinds-wired 支持 ESM 还是 CommonJS？

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

### homebridge-blinds-wired 需要什么版本的 Node\.js？

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

### homebridge-blinds-wired 可以商用吗？

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

### homebridge-blinds-wired 还在维护吗？

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