Home Assistant ESPHome Wavin Setup

Introduction

This tutorial provides a step-by-step guide to setting up the ESPHome Wavin module with Home Assistant. This process is applicable to both the AHC9000 and Sentio models. By following these instructions, you will be able to connect your ESPHome module to Home Assistant effectively.

Step 1: Gather Necessary Components

Before starting the setup, ensure you have the following items:

• ESPHome Modbus Module (available for purchase here)
• Home Assistant installed on your device
• USB cable for uploading code (if needed)

Step 2: Attach the Module

1. Connect the ESPHome module to your network.
2. Ensure that all necessary power connections are secure.
3. If applicable, connect any additional sensors or devices to the module.

Step 3: Enter Credentials

1. Access the ESPHome dashboard.
2. Create a new node for your module.
3. Enter the Wi-Fi credentials:
   • SSID (network name)
   • Password
4. Save the configuration.

Step 4: Uploading the Code

1. If the module doesn’t come online, you may need to upload the code manually.
2. Connect the module via USB to your computer.
3. Open your terminal or command prompt.
4. Use the following command to upload the code:

   esphome <your_configuration_file>.yaml run
   

5. Replace <your_configuration_file> with the name of your YAML configuration file.

Step 5: Reset the Module

If the module fails to connect:

1. Locate the reset button on the back of the module.
2. Press the reset button once to restart the module.

Step 6: Verify Connection in Home Assistant

1. Open your Home Assistant interface.
2. Navigate to the integrations section.
3. Look for your ESPHome device to confirm it is online and successfully integrated.
4. If it appears offline, double-check your Wi-Fi credentials and the physical connections.

Conclusion

You have now successfully set up the ESPHome Wavin module with Home Assistant. Remember to ensure all connections are secure and verify your Wi-Fi settings. If you encounter any issues, refer back to the reset process or consider re-uploading the code. For further enhancements, explore additional features of Home Assistant to maximize the functionality of your module.