3. Troubleshooting & Logging

Troubleshooting

Note that log files will be required if you are requesting help. There are two such logs - the HA log, and a packet log.

If you are stuck, first look here, then ask for help at the HA forum if you remain stuck.

Packet Logs

You'll need to configure the location of the packet log.

Unavailable State

Some evohome devices - particularly battery-powered devices like TRVs - will not send packets frequently.

Thus, the state of some HA entities will not be known until the corresponding packet is next sent. Some of these (e.g. battery state) are cast only once per 24 hours (and if you miss it...).

Logging

To investigate configuration issues, you can turn on Debug level detailed logging for Ramses RF in the HA Integrations > Ramses RF page at top right. To view the HA System log, go to Settings > Systems > Log, and select "Show Full Log" at the right.

In the console, you can try: cat home-assistant.log | grep -E 'ramses_cc.* Schema. It may be worth searching for combinations of:

• ramses_ccand Found, Schema, Params, or Status, or:
• ramses_rf

Check the version numbers

In particular, check the version numbers, and confirm you are running the latest version:

2021-02-21 10:29:49 ERROR (MainThread) [custom_components.ramses_cc] ramses_cc v0.57.6, using ramses_rf v0.57.5 - versions don't match (this is bad)

Get the system schema

You can fetch the system schema from a packet log:

> cat home-assistant.log | grep Schema
2020-09-18 21:50:58 INFO (MainThread) [custom_components.ramses_cc] Schema = {'controller': '01:145038', 'system': {'heating_control': '13:035462', 'orphans': []}, 'stored_hotwater': {'hotwater_sensor': '07:045960', 'hotwater_valve': '13:081807', 'heating_valve': '13:106039'}, 'ufh_controllers': {}, 'zones': {'01': {'heating_type': 'radiator_valve', 'sensor': '04:189082', 'devices': ['04:189078', '04:056053', '04:189082']}, '02': {'heating_type': 'radiator_valve', 'sensor': '04:056057', 'devices': ['04:056057']}, '03': {'heating_type': 'electric_heat', 'sensor': '03:183434', 'devices': ['03:183434']}, '04': {'heating_type': 'zone_valve', 'sensor': '12:010740', 'devices': ['12:010740']}, '05': {'heating_type': 'underfloor_heating', 'sensor': '34:092243', 'devices': ['34:092243']}, '06': {'heating_type': 'mixing_valve', 'sensor': None, 'devices': []}, '07': {'heating_type': 'mixing_valve', 'sensor': None, 'devices': []}, '08': {'heating_type': 'underfloor_heating', 'sensor': None, 'devices': []}, '09': {'heating_type': 'electric_heat', 'sensor': None, 'devices': []}, '0B': {'heating_type': 'zone_valve', 'sensor': None, 'devices': []}}, 'device_info': {'01:145038': {'description': 'Evo Color', 'firmware': '2020-08-11', 'manufactured': '2013-08-01', 'unknown': '000002FF0163FFFFFFFF'}}}

... which will give you:

{
    "controller": "01:145038",
    "system": {
        "heating_control": "13:035462",
        "orphans": []
    },
    "stored_hotwater": {
        "hotwater_sensor": "07:045960",
        "hotwater_valve": "13:081807",
        "heating_valve": "13:106039"
    },
    "ufh_controllers": {},
    "zones": {
        "01": {
            "heating_type": "radiator_valve",
            "sensor": "04:189082",
            "devices": [
                "04:189078",
                "04:056053",
                "04:189082"
            ]
        },
        "02": {
            "heating_type": "radiator_valve",
            "sensor": "04:056057",
...

Logging at lower layers

... if required, you may want to consider logging at lower layers of the ramses_rf protocol stack:

logger:
  default: warn  # prefer warn over info, avoid debug
  logs:
    homeassistant.core: debug             # to see: call_service & state_changed

    custom_components.ramses_cc: info     # for: Devices, Schema, Params, Status, etc.

    ramses_rf.dispatcher: info            # for: Tx/Rx at app layer, probably the logging you want (no RQs for readability), e.g.:
    # || CTL:145038 |            |  I | system_sync      |      || {'remaining_seconds': 185.5, '_next_sync': '15:59:38'}

    ramses_rf.protocol.protocol: info   # for: (rcvd) PKTs (raw packets), e.g.:
    # SENT: RQ --- 18:000730 30:082155 --:------ 22E5 001 00
    # rcvd: RQ --- 18:006402 30:082155 --:------ 22E5 001 00

    ramses_rf.protocol.transport: info  # for: Rx, Tx of PKTs, e.g.:
    # RF Tx:     b'RQ --- 18:000730 30:082155 --:------ 2210 001 00'
    # RF Rx: b'000 RQ --- 18:006402 30:082155 --:------ 2210 001 00'