3.1 I'm stuck: Help me

Here is a checklist that will solve most problems:

• to start, you must have a Packet log that is being populated with data
• if you have one, check your configured Schema
• if you have one, check your configured Known List)

If required, have a look at the troubleshooting wiki.

If you still have issues, and can't find an answer on this wiki, reach out on the HA forum. If you notice any deficiencies with this wiki (that can't be addressed with a simple edit), please report them as issues.

Do you have packets being logged?

Once you have a packet log, you can confirm packets are being Rx/Tx, and get useful information from it.

For example:

> cat packet.log | grep ' 01:' | head  # for HVAC, try ' 18:' 
...
> cat packet.log | grep ' 1F09 ' | head  # for HVAC, use ' 31D' 
...

NOTE: You need to get this working before bothering with anything else.

You should start with an absolute minimal configuration, for example (i.e. your serial port name may be different):

Serial config: /dev/serial/by-id/usb-SparkFun_evofw3_atmega32u4-if00 Packet log: packet.log

Is your serial port configured correctly? For more information, see Serial port config.

If you have an evofw3-compatible dongle:

• if it isn't one of these, YMMV
• if it is NanoCUL-based, what baud rate did you flash it at?
• you could look at the evofw3 or the RAMSES_ESP wiki

Is your schema configured correctly?

Under Config flow > Schema and Known List, for CH/evohome systems, enter all devices in the proper YAML form.

For example (your device ids will be different):

"01:216136":
  orphans_heat: []
  stored_hotwater:
    heating_valve: null
    hotwater_valve: "13:042605"
    sensor: "07:050121"
  system:
    appliance_control: "10:064873"
  underfloor_heating: {}
  zones:
    "00":
      _name: Garden room
      actuators:
        - "04:034720"
        - "04:056673"
      class: radiator_valve
      sensor: "04:056673"
    "01":
      _name: Kitchen
      actuators:
        - "04:034682"
      class: radiator_valve
      sensor: "22:012299"
    "02":
      _name: Hall
      actuators:
        - "04:034716"
        - "04:034726"
      class: radiator_valve
      sensor: "04:034716"

For HVAC devices (but not so much for CH/DHW), and particularly for HVAC remotes, it can be useful to add them to the Schema as orphans so that they are instantiated during startup.

For example (your device ids will be different):

  orphans_hvac:
    "20:123456"
    "24:12356"
    "37:123456"

Except for faked devices, the above is not required (the system will be no more effective), but will be beneficial (the system will be more efficient).

Tip: You can find your:

• config schema in the attributes of the HGI 18:xxxxxx Gateway status binary sensor under Details
• working schemas in the attributes of the CTL 01:xxxxxx System status binary sensor (this is the place to find which thermostat is in which zone)

For more information, see schema configuration.

Is your Known List configured correctly?

Note: Enforcing a valid Known List is strongly recommended, but mis-configuring it will cause real headaches.

The obvious thing to do is to turn on ‘Accept packets from Known Devices Only’ once all your own devices have been discovered, and see if it works.

Before you turn on the Known List, the device ids of:

• your devices,
• all your devices (includes your gateway), and
• nothing but your devices

... must be in the Known List.

Note: your gateway device id starts with 18: but is not 18:000730 - that is a sentinel special value.

Tip: You can find your:

• working known list in the attributes of the 18:xxxxxx status binary sensor

For more information, see Known Devices configuration.