2025.3.4
首页 ▸ Integrations ▸

CUPS

cups传感器平台使用开源打印系统CUPS来显示有关打印机的详细信息，包括墨水水平。它可以通过CUPS服务器获取信息，也可以通过互联网打印协议直接与打印机通信。

设置

您需要手动在系统上安装python3-dev或python3-devel包以及CUPS的开发文件（libcups2-dev或cups-devel），并安装编译器（gcc）（例如，sudo apt-get install python3-dev libcups2-dev或sudo dnf -y install python3-devel cups-devel）。该集成在基于容器的设置中无法开箱即用。

要设置传感器，需要打印机的“队列名称”。获取它的最快方法是访问CUPS Web界面，地址为 “http://[IP ADDRESS PRINT SERVER]:631”，并进入“打印机”部分。

配置

要启用CUPS传感器，请将以下行添加到您的configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more]文件中。 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下，需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后，重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# 示例配置.yaml条目
sensor:
  - platform: cups
    printers:
      - C410
      - C430

Configuration Variables

Looking for your configuration file?
printers list Required

要添加的打印机列表。如果您不使用CUPS服务器，请在此处添加您的“打印机名称”。

host string (Optional, default: 127.0.0.1)

CUPS打印服务器或打印机的IP地址。

port integer (Optional, default: 631)

CUPS打印服务器或打印机的端口号。

is_cups_server boolean (Optional, default: true)

如果您想使用CUPS打印服务器，请设置为true；否则请设置为false。

示例

IPP打印机的默认配置：

# IPP打印机的示例配置.yaml条目
sensor:
  - platform: cups
    host: PRINTER_IP
    is_cups_server: false
    printers:
      - ipp/print

相关主题