🖨️ 爱普生打印机 HA 集成—— 全面中文化 + 统一打印服务（其他型号应该也支持）系统自带的一直添加不成功，就自己重新写了一个。感觉不错，就分享一下。一款让 Home Assistant 深度控制爱普生打印机的自定义集成，支持墨水量监控、打印页数统计、打印机状态、IPP 实时监控，以及 RAW 9100 / IPP 631 打印控制。
📦 安装方法HACS（推荐）- 确保已安装 HACS
- HACS → 集成 → 右上角三个点 → 自定义仓库
- 添加：，分类选「集成」
- 下载安装，重启 HA
手动安装从 下载压缩包，将 custom_components/epson_printer/ 解压到 config/custom_components/ 目录，重启 HA。
✨ 功能亮点🖨️ 墨水量监控支持黑、青、品红、黄四色墨量百分比显示，实时掌握耗材余量。 📄 打印页数统计总计、黑白、彩色、双面、单面，以及按功能（打印/复印/扫描/传真）、按纸张尺寸、按打印语言的细分统计。 ✅ 打印机状态Epson Connect 状态、固件版本、序列号、MAC 地址、型号、维护箱寿命、扫描仪状态，一目了然。 🔌 IPP 实时监控打印机实时状态、运行时间、队列任务数、是否接受任务、每分钟页数。 🛠️ 统一打印服务 epson_printer.print一个服务搞定所有打印，内部智能路由： [td]内容类型 | 路由通道 | 纯文本 | RAW 9100（端口 9100） | PDF、图片 | IPP 631（格式协商 + 任务状态） | Office 文档（Word/Excel 等） | LibreOffice 转 PDF → IPP 631 |
不需要纠结用哪个服务、选哪个端口，一个 print 服务就够了。 💡 打印 Office 文档需要在「集成选项」中开启「转换 Office 文档」，并确保 HA 主机安装了 LibreOffice。
🔍 自动发现支持 mDNS / zeroconf 局域网自动发现，添加集成时输入 IP 或从发现列表选取即可。
🌐 关于中文支持v0.3.1 对中文用户做了全面优化： - HA 界面全中文：配置流程、传感器名称、服务名称和字段全部显示中文
- README 中英双语，以中文为主
之前配置集成时看到满屏英文的情况，现在彻底解决了。
📊 传感器一览集成默认添加 28 个传感器，覆盖墨水、页数、状态和 IPP 四大类： [td]类别 | 数量 | 说明 | 墨水量 | 4 | 黑/青/品红/黄百分比 | 打印页数 | 5 | 总计（默认启用）、黑白/彩色/双面/单面（需手动启用） | 分页统计 | 15+ | 按功能/尺寸/语言细分（默认禁用，按需启用） | 诊断状态 | 8 | 打印机状态、扫描仪、维护箱、固件、序列号、MAC 等 | IPP | 7 | 实时状态、队列、速度等 | 纸张来源 | 2 | 当前纸张尺寸和类型（默认禁用） |
⚠️ 并非所有打印机都支持全部 IPP 属性，缺失属性显示为 unavailable，属正常现象。
🎯 支持的打印机适用于任何带内置 Web 服务器的爱普生打印机，包括大多数 EcoTank、WorkForce、Expression 系列： - EcoTank L3250 / L4160 / L4260
- WorkForce 系列
- Expression 系列
- 其他型号（基本功能可用）
🔧 配置说明添加集成后可在「选项」中调整： - 轮询间隔：默认 5 分钟，最小 30 秒
- 转换 Office 文档：开启后才能打印 Word/Excel
- LibreOffice 路径：默认 soffice，不在 PATH 时可指定绝对路径
📝 使用示例yaml
# 打印文本service: epson_printer.printdata: content: "Hello from Home Assistant!"
yaml
# 打印 PDF 文件service: epson_printer.printdata: content: "/config/www/report.pdf" content_type: "file" job_name: "月报"
yaml
# 多台打印机时指定其中一台（按 IP）service: epson_printer.printdata: content: "打印测试" host: "192.168.3.200"
| 
发表于 2026-7-11 19:24:03
