Epson Workforce


The epson workforce platform allows you to monitor the ink levels of a Epson Workforce printer from Home Assistant.

To add Epson Workforce to your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
sensor:
   - platform: epsonworkforce
     host: IP_ADDRESS
     monitored_conditions:
     - black
     - photoblack
     - yellow
     - magenta
     - cyan
     - clean   

Configuration Variables

host

(string)(Required)

The host name or address of the Epson workforce printer

monitored_conditions

(list)(Required)

The cartridge colours to monitor.

black

The black ink cartridge

photoblack

The photo black ink cartridge (not supported by all printers).

yellow

The yellow ink cartridge.

magenta

The magenta (=red) ink cartridge.

cyan

The cyan (=blue) ink cartridge.

clean

The cleaning cartridge.

Supported devices:

  • Epson Workforce (and some EcoTank) printers who publish a HTTP page containing the ink cardridge levels

Tested devices:

  • Epson WF3540
  • Epson WF3620
  • Epson WF3640
  • Epson EcoTank ET-77x0
  • Epson ET-2650

To make this module work you need to connect your printer to your LAN. The best is to navigate to the status page of the printer to check if it shows the page with the ink levels on the URL http://<IP_ADDRESS>/PRESENTATION/HTML/TOP/PRTINFO.HTML