# homebridge-brother-printer 中文文档

规范地址：https://npmcn.com/package/homebridge-brother-printer/

版本：0\.2\.2
npm 元数据更新时间：2026-11-03T19:44:55.245Z
中文译文更新时间：2026-11-03T20:43:24.729Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：57.2 kB，12 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：^18\.20\.0 \|\| ^20\.15\.0 \|\| ^22\.0\.0 \|\| ^24\.0\.0
- 运行依赖：1 个
- 首次发布：2026-11-03T15:52:15.830Z
- 最新版本发布：2026-11-03T19:44:54.995Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

HomeKit中的兄弟激光和喷墨打印机：打印状态，问题警报和碳粉或墨水水平，通过SNMP本地读取。

## 安装

```sh
npm install homebridge-brother-printer
```

也可以使用：`pnpm add homebridge-brother-printer`、`yarn add homebridge-brother-printer`、`bun add homebridge-brother-printer`

## README

# homebridge-brother-printer

[![npm](https://badgen.net/npm/v/homebridge-brother-printer)](https://www.npmjs.com/package/homebridge-brother-printer) [![license](https://badgen.net/github/license/zmanuel1234/homebridge-brother-printer)](https://npmcn.com/package/homebridge-brother-printer/LICENSE)

展示了HomeKit中的Brother激光或喷墨打印机：它是否在打印，是否 需要注意的是，还剩下多少墨粉或墨水。所有内容都是通过SNMP本地读取的， 没有云账户和兄弟账户。

通用的AirPrint/IPP插件不能在许多兄弟打印机上显示真实的碳粉水平， 因为标准的Printer MIB只报告“一些剩余的”。兄弟节点自己的SNMP 记录携带实际百分比显示在打印机的网页上，这个插件 读这些东西。

每台打印机都有这些传感器：

-   **打印机** （占用传感器）：作业打印时检测到。在自动化中使用它。
-   **打印机的问题** （接触式传感器）：打开堵塞，打开盖子，空托盘或其他 错误。在Home应用中为它打开通知。
-   **碳粉/墨水** （打印机附件上的电池电量）：碳粉或墨水%，带Home's 本地低电量警报等于或低于您的阈值。在彩色打印机上显示 最低颜色，所以当任何颜色低时警报触发。
-   **墨粉/墨瓦** （可选湿度传感器）：液位作为一个数字放在自己的瓷砖上， 在彩色打印机上每种颜色一个。

虽然无法联系到打印机，但它们都显示为“无响应”。

## 需求

-   带有SNMP协议的Brother打印机。在真实的 **MFC-L2750DW**，并反对SNMP 从这些模型(从 [哥哥](https://github.com/bieniu/brother) Home Assistant's Brother集成使用的图书馆)：
    
    | 种类 | 模型 | 读什么 |
    | --- | --- | --- |
    | Mono激光 | Mfc-l2750dw、hl-l2340dw、dcp-l2540dn、dcp-7070dw、dcp-1618w | 碳粉,鼓 |
    | 彩色激光 | DCP-L3550CDW, dcp - 9020车损险 | 每个颜色的墨粉，滚筒，皮带，熔断器，送纸套件 |
    | 喷墨 | Mfc-j680dw, mfc-j5110dw, dcp-j132w, dcp-t735dw, mfc-5490cn | 油墨分色，油墨废盒 |
    | 旧/墨缸 | Hl-2270dw, hl-5350dn, mfc-t910dw | 状态、问题、页数；这些不报告水平 |
    
    其他兄弟模型通常使用相同的记录。报告，带有探针输出 下面，欢迎大家。
    
-   在打印机的网页中打开了SNMP： **网络→协议→SNMP** (v1 / v2c, 只读就足够了)。缺省团体字为 `public`。
    
-   打印机的固定地址：在路由器中保留其IP，或者使用其mDNS 主机名(例如 `brn3c2af4919dfc.local`）.
    
-   Homebridge 1.6或更高版本(包括2。x), Node.js 18,20,22或24。
    

## 安装

搜索 **兄弟打印机** 在Homebridge UI的Plugins选项卡中，或者运行：

```bash
npm install -g homebridge-brother-printer
```

建议将其作为子桥运行。

## 配置

设置它在插件的设置屏幕，或在 `config.json`：

```json
{
  "platform": "BrotherPrinter",
  "printers": [
    {
      "name": "Printer",
      "host": "10.0.4.150"
    }
  ]
}
```

| 选项 | 默认的 | 描述 |
| --- | --- | --- |
| `name` | `Printer` | 附件的名字。每个打印机必须是唯一的。 |
| `host` |  | 打印机IP地址或主机名。没有配置的打印机将被忽略。 |
| `community` | `public` | SNMP团体字。 |
| `port` | `161` | SNMP端口。 |
| `snmpVersion` | `auto` | `auto` 尝试v2c，然后v1。集 `1` 对于只回答v1的旧打印机。 |
| `pollInterval` | `60` | 民意调查之间的秒数（10-3600）。 |
| `lowTonerThreshold` | `10` | 墨粉或油墨%等于或低于Home显示的低值（任何颜色，在彩色打印机上）。 |
| `faultSensor` | `true` | 添加打印机问题接触传感器。 |
| `tonerTile` | `false` | 在彩色打印机上增加湿度传感器，显示每种颜色的碳粉或油墨百分比。它们也在Home的气候总结中有所体现。 |
| `showDrum` | `false` | 增加鼓的寿命作为第二个电池。见下文。 |
| `lowDrumThreshold` | `10` | 滚筒和零件%（皮带、熔断器、激光装置、送纸装置、废墨盒）达到或低于该值时记录警告，且滚筒电池显示电量不足。 |
| `offlineAfter` | `3` | 在打印机显示无响应之前，连续失败的轮询。 |
| `debug` | `false` | 在信息级别记录每个民意调查。 |

## Home应用显示了什么

HomeKit没有打印机附件类型，所以插件使用最近的传感器和Home 用自己的方式表达；

-   打印传感器读取 **检测到** / **没有检测到**。
-   低墨粉或油墨被宣布为 **“电池电量不足”**． 为了让信息更清晰，可以添加Home 自动触发发送你自己的通知。
-   家里显示每个配件只有一个电池。与 `showDrum` On，它可以显示鼓 而不是墨粉，所以默认情况下滚筒是关闭的。它还在读，而且 插件在生命周期接近尾声时记录一个警告。像Eve这样的应用程序显示了这两点。
-   页面计数是一个自定义特性，在Eve， Controller和Homebridge中可见 UI，而不是Apple Home。

## 级别和低警报

兄弟印刷商报告每批货的两个读数：一个是粗糙的读数（标签上的数字） 打印机的网页和显示)和一个更好的。电池和瓦片都很粗糙 一个，所以它们和打印机匹配。当读数等于或低于该值时，供应被视为低 `lowTonerThreshold`，或者当打印机本身标记低碳粉时，就会显示墨盒 10%，但实际上是2%，这仍然引起了警惕。

没有电平报告的打印机（一些旧型号和墨槽打印机）没有 电池;状态、问题和页数仍然有效。

## 脱机

打印机显示无响应之前的时间是大约 `offlineAfter` ×(`pollInterval` + 10秒)，其中10秒为SNMP超时时间。与 默认是3.5分钟； `pollInterval: 30` 与 `offlineAfter: 1` 把它带到 大约40岁。与 `offlineAfter: 1`在美国，一个丢失的数据包可能会使它闪现“无响应” 一项调查显示。

兄弟激光器通常在睡眠和深度睡眠状态下仍然应答SNMP。

## 检查打印机的报告

该包包含一个命令，用于打印插件读取的内容：

```bash
npx -p homebridge-brother-printer brother-printer-probe 10.0.4.150
```

比较 `tonerPercent` 与 **剩下的生活** 在打印机的网页上。如果没有 匹配，或者值是 `null`请打开探针输出和打印机的问题 模型。

## 故障排除

-   **“无法到达…请求超时”**打印机上SNMP关闭，地址错误。 或者防火墙阻断UDP端口161。测试从Homebridge机器 `snmpget -v2c -c public <printer-ip> 1.3.6.1.2.1.1.1.0` (从 `snmp` 包)。
-   **另一种语言的状态文本**插件读取打印机的字符集，所以 日志显示打印机显示的显示文本。问题和印刷是 从语言中立的状态代码中检测到，用英语显示文本作为备用。
-   **旧打印机不能连接**:设置 `snmpVersion` 来 `1`。
-   **墨盒满时墨粉显示0%**有些非正品墨盒无法识别 由打印机，然后报告没有级别。

## 它是如何工作的

兄弟打印机将维护数据作为打包记录公开在其私有MIB中 （`1.3.6.1.4.1.2435.2.3.9.4.2.1.5.5.8`， `.5.10` 和 `.5.11`）. 每条记录是一个1字节 代码, `0x01`，一个长度字节和一个大端值；旧型号使用双字节 当前/ max形式。主要代码：

| 代码 | 意义 |
| --- | --- |
| `0x81`\-`0x84` | 黑色、青色、品红、黄色墨粉或油墨，%（粗） |
| `0x6f`\-`0x72`， `0xa1`\-`0xa4` | 同样的，更好的阅读 |
| `0x41`， `0x80`， `0x79`\-`0x7b` | 鼓寿命（单色；黑色、青色、品红、黄色） |
| `0x69`\-`0x6d`， `0x85` | 胶带、熔丝器、激光装置、送纸包、废墨盒 |
| 下一个护理 `0x82`， `0xa4`\-`0xa7` | 鼓页剩余 |
| 计数器 `0x00` | 打印总页数 |

打印和问题状态来自标准主机资源MIB (`hrPrinterStatus`， `hrPrinterDetectedErrorState`)，以显示文本作为回退。

记录代码跟在 [哥哥](https://github.com/bieniu/brother) Python库 由Maciej Bieniek （Apache-2.0）编写，测试使用其测试套件中的SNMP捕获。

## 许可证

麻省理工学院

## 常见问题

### homebridge-brother-printer 是什么？

HomeKit中的兄弟激光和喷墨打印机：打印状态，问题警报和碳粉或墨水水平，通过SNMP本地读取。

### 如何安装 homebridge-brother-printer？

在项目目录运行 npm install homebridge-brother-printer，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 brother-printer-probe，可以用 npx brother-printer-probe 直接运行。

### homebridge-brother-printer 支持 TypeScript 吗？

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

### homebridge-brother-printer 支持 ESM 还是 CommonJS？

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

### homebridge-brother-printer 需要什么版本的 Node\.js？

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

### homebridge-brother-printer 可以商用吗？

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

### homebridge-brother-printer 还在维护吗？

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