1. Installation

Install Home Assistant

Install either Hass OS, Hass or Container:

• see: https://www.home-assistant.io/installation/

Install HACS

Install HACS using its install script:

• see: https://hacs.xyz/docs/installation/installation/

Enable the HACS Integration:

• see: https://hacs.xyz/docs/configuration/start

If you have HA's official evohome (Honeywell TCC, https://www.home-assistant.io/integrations/evohome/) integration already configured, you may wish to disable it: otherwise, you will see two climate entities for each Controller / Zone / DHW (this isn't necessarily a problem).

Add ramses_cc as a Custom Repository to HACS

Now, check the documentation at: https://hacs.xyz/docs/faq/custom_repositories/

• select HACS (side panel), Integrations
• select the three-dots menu on the top-right, select Custom repositories
• add the repo URL (https://github.com/zxdavb/ramses_cc), Category is Integration
• click the Add button, and close the window (X in top-right)

Add ramses_cc as an Integration via HACS

• select HACS (side panel), Integrations
• click the Explore & Add Repositories button
• search for 'ramses'
• click on Ramses CC (or similar)...
• click on Install this Repository in HACS, then Install
• restart HA (the HA Core)

After restart, you will not see any climate/sensor tiles added to the UI.

Enable/configure ramses_cc (configuration.yaml)

Finally, you'll have to edit the configuration.yaml file: below is an example of an absolute minimal configuration:

ramses_cc:
  serial_port: /dev/ttyACM0

If you have successfully installed ramses_cc, and initialised the correct serial device, you will see messages from ramses_cc in the HA logs.

But you will have to add more options than the above, as described elsewhere in the wiki.