ESPHome Smart Coffee (Philips Series 2200)

This project integrates a Philips Series 2200 Coffee Machine into into Home Assistant through ESPHome. This component has been developed on a Philips EP2220 and an ESP8266.

This component provides a Power Switch, a Status sensor and various Buttons which simulate user input. The Power Switch can be used to turn on the coffee machine with and without a cleaning cycle during startup.

You might break/brick your coffee machine by modifying it in any way, shape or form. If you want to use this component, do so at your own risk.

Configuration variables

A example configuration can be found here

Philips Series 2200

id(Required, string):Controller ID which will be used for entity configuration.
display_uart(Required, string): ID of the UART-Component connected to the display unit
mainboard_uart(Required, string): ID of the UART-Component connected to the mainboard
power_pin(Required, Pin): Pin to which the MOSFET/Transistor is connected. This pin is used to temporarily turn of the display unit.

Philips Power switch

controller_id(Required, string): The Philips Series 2200-Controller to which this entity belongs
clean(Optional: boolean): If set to true the machine will perform a cleaning cycle during startup. Otherwise the machine will power on without cleaning. Defaults to true.
All other options from Switch

Philips Action Button

controller_id(Required, string): The Philips Series 2200-Controller to which this entity belongs
action(Required, int): The action performed by this button. Select one of MAKE_COFFEE, SELECT_COFFEE, SELECT_ESPRESSO, MAKE_ESPRESSO, SELECT_HOT_WATER, MAKE_HOT_WATER, SELECT_STEAM, MAKE_STEAM, BEAN, SIZE, AQUA_CLEAN, CALC_CLEAN, PLAY_PAUSE.
All other options from Button

Philips Status Sensor

controller_id(Required, string): The Philips Series 2200-Controller to which this entity belongs
All other options from Text Sensor

Fully automated coffee

The following script can be used to make a fully automated cup of coffee. The power switch used in this case does not perform a cleaning cycle. The cleaning check is required since after power loss the machine always cleans. This script will only continue to brew coffee under 2 conditions:

There was no cleaning cycle during start-up
A Mug is present

script:
  - id: coffee_script
    then:
      - if:
          condition:
            lambda: 'return id(status).state == "OFF";'
          then:
            - switch.turn_on: power
            - wait_until:
                condition:
                  lambda: 'return (id(status).state == "Idle") || (id(status).state == "Cleaning");'
                timeout: 120s
            - if:
                condition:
                  lambda: 'return (id(status).state == "Idle") && id(mug_sensor).state;'
                then:
                  - delay: 5s
                  - button.press: make_coffee_button
          else:
            if:
              condition:
                lambda: 'return (id(status).state == "Idle") && id(mug_sensor).state;'
              then:
                - button.press: make_coffee_button

Wiring

The coffee machines display unit is connected to the mainboard via a 8-pin ribbon cable with Picoflex connectors. The display is powered by the mainboard and the two units communicate using a serial bus. The ESP is placed in between this bus to perform a man-in-the-middle attack. The RX/TX lines are piped through the ESP such that messages can be read, intercepted and injected.

When injecting a 'turn coffee machine on' command, the coffee machine does turn on, but the display unit does not. To circumvent this behavior we can re-boot the display unit by temporarily removing it's power. Thus the display will power on and operate normally. To perform this operation a transistor or MOSFET can be used.

The following wiring guideline can be used to add a Wemos D1 Mini to the coffee machine. The unlabeled wires should be connected without changes.

The ribbon cable wires have the following functionalities.

Pin	Mainboard	Functionality
0	5V	5V
1	GND	GND
2	GND	GND
3	unused	unused
4	TX/RX	Messages from mainboard to display
5	RX/TX	Messages from display to mainboard
6	0V	unknown - very noisy
7	5V

Voltage regulation

The Wemos D1 Mini has a built in Voltage regulator, thus connecting it to the 5V provided by the mainboard is no problem. If you use a different ESP Module/Board please make sure it is 5V tolerant or use a Voltage regulator. Otherwise you might release magic smoke.

Communication protocol

More information on the communication protocol used by this component can be found here.

Related Work

SmartPhilips2200 by @chris7topher
- The commands used in this Project are different. This is likely due to different model revisions.

Troubleshooting

Make sure your wiring is correct
The UART debug function can be used to analyze communication and verify correct wiring
The commands used by the display unit may be different between different revisions/models (see Related Work)

schlunsen / ESPHome-Philips-Smart-Coffee