Comfort2MQTT with Home Assistant Part1

[slychiu]

This topic is a step-b-step  by step guide to installing the Comfort2MQTT Add-on with Home Assistant on Raspberry Pi for Novices (like myself). Many thanks to koochyrat and Ingo for their efforts in developing this add-on as an Open Source project.
This will be a closed topic, no replies allowed as it should be for instructions only. Start a new topic for questions.

My set up is;

1. Raspberry Pi 5 8GB (raspberry pi 4 will also work - in fact it may be better as it requires less current). Home assistant Green or Yellow also works
2. MicroSD card 16GB or above (8GB may work but not tested).
   
3. MicroSD card Reader for your PC if it does not have a built in SD card slot
   
4. USB Type C Power Supply 5V / 5A
5. HDMI Monitor (Optional)
6. Micro-HDMI to HDMI cable for Monitor
7. CM9001-ULT with UCM/ETH03 or  ETH03 Plugin on CM9001 PCB

Raspberry Pi with 2 LAN Port, 4 USB-A, 1 USB C port, Micro HDMI port, Micro-SD card slot. You need a USB power supply with Type C connector able to supply 5A.
A HDMI Monitor would be useful during the setup as it allows you to see the progress of installing the OS. For this you need a Micro HDMI to HDMI cable. The monitor will notbe needed in operation after setup. 

Note:
We have tested with Raspberry Pi4 which requires less current. It works just as well
Comfort: UCM/ETH03 or ETH03 submodule plugged in on CM9001 is required. There are 2 ports available to connect to Comfort which cn be seen in Comfort Server Manager. see http://www.comfortforums.com/forum113/3695.html

It is recommended that the 2nd port (default 1002) is used for Home Assistant to log in nd Port 1 (port 1001) be used for Comfigurator. The 2nd Port time out should be set to 0 so that it does not log out after a few minutes

[slychiu]

Download RPI Imager from https://www.raspberrypi.com/software/. This allows you to format the Micro SD card and install the Home Assistant OS.

• Insert the Micro SD card into the MicroSD Card reader to yourPC
  
• Run the RPI Imager software
  
• select Raspbery Pi device = Raspberry Pi5,Operating System =  Other Automation Operating systems  > Home Assistant OS (13.2) is the current version at this time), and select the SD Drive detected in Storage 
  

• Press start and wait for the OS to be written and verified which takes about  minutes
• when completed with no errors, remove the SD card from the reader and insert into the RPi. Note that the SD card will not be detected or readable on your PC anymore. It can be rewritten by RPI imager if needed
  

Short video on How to Install Home Assistant in 10 minutes https://www.youtube.com/watch?v=sPCQx0NFSvU

[slychiu]

• Insert the Micro SD card into the slot at the back of the Rpi
  
• Connect the HDMI cable from the Monitor to the Micro HDMI connector on RPi (optional - this allows you to see the booting up sequence). HDMIshould not be required after this
• Connect the USB power supply to the RPi Type C Connector, and turn on power.
• The LED on RPi should initially be Red and will change to green, flashing as the OS is installed
• The monitor will show many lines of text during the installation. This will take many minutes.
• when complete, the monitor will show the Home assistant logo, the IP addresses, S version 13.2 Home assistant Core Date, Home Assistant URL http://homeassistant.local.8123 and Observer URL http://homeassistant.local.8123

• When completed, browse to http://homeassistant.local:8123/
  

Press Create My Smart Home. The next screen will start the initialisation, which may take up to 20 minutes.





If the boot-up keeps resetting as seen on the  monitor, this may be dueto using a power supply that does not suppy enough current, or a bad Micro SD card. Use a reputable brand of Micro SD card with at least 16 GB capacity

[slychiu]

When completed, go to Settings in the sidebar, -> Add-ons and click the ADD-ON STORE.   look for File Editor and install it. This is needed to edit the configuration files later.


Enable the buttons as shown



You should be able to see File Editor in the Sidebar

[slychiu]

In Home Assistant, go to Settings -> Add-ons and click the ADD-ON STORE button. Once in the ADD-ON STORE, click the three dots ... in the top-right corner and select Repositories.  Paste  https://github.com/djagerif/comfort2mqtt URL on the line provided


 and click ADD.



Pres ADD
wait a few seconds, you should see comfort2mqtt in addons



Press INSTALL


Press the Configuration Tab on top to go to the Options. Enter an MQTT Borker User and password that you choose.You can leave the other fields unchanged



Scroll down to other fields;

• Comfort IP address and  port
• comfort login user id (user code eg 1234) used to log in to Comfort
• Comfort configuration File (.cclx) file to be used for object enrichment EG. Zone Names etc. Place this file in the Home Assistant /addon_configs/<comfort2mqtt slug> folder using the File Editor. <comfort2mqtt slug> is a folger with the name which includes comfort2mqtt.
  
  
• global log verbosity DEBUG
• Press Save
• back to Info and press Start to start the ADDON
  

[slychiu]

Go to Settings > Add-On > Add-on Store and look for Mosquitto Broker.



Press INSTALL

after installed,




In the ADD-ONs page there should be 3 Add-Ons at this stage

1. Comfort2MQTT
2. File Editor
3. Mosquitto Broker

[slychiu]

If you have any problem with the SD card not installing Home Assistant, check that the Power supply is sufficent. if the power source is a USB adaptor. make sure that the current is sufficient to support the Raspberry PI. For RPi5, the specs is 5V / 5A but you may need more current


For Part 2. see http://www.comfortforums.com/forum27/5575.html 
Questions and comments in http://www.comfortforums.com/forum27/5579.html as the original topics are closed

[slychiu]

Integration with Zigbee http://www.comfortforums.com/forum143/5612.html

Integration with Zwave  http://www.comfortforums.com/forum143/5610.html