Home Assistant HACS Integration for Gaggiuino

Repository: https://github.com/ALERTua/hass-gaggiuino

Gaggiuino Repository: https://github.com/Zer0-bit/gaggiuino/releases

Blueprints Readme: link

API Library:

• PyPi: https://pypi.org/project/gaggiuino_api/
• Repository: https://github.com/ALERTua/gaggiuino_api

Table of Contents

1. Installation
2. Troubleshooting
3. Blueprint Library

Installation

Adding the integration to HACS manually

1. Add HACS Custom Repository for this project

2. The integration can now be found in the HACS Community Store

3. Open the integration in the HACS Community Store and download it using the corresponding button in the lower right corner.

4. Restart your Home Assistant

Adding the integration to Home Assistant

Adding the integration to Home Assistant

5. Open your Settings→Devices&Services, press Add Integration button in the lower right corner, search for this integration, and select it.

Integration setup

1. Enter your Gaggiuino web address

Integration setup complete. Your Gaggiuino is now available as a device.

FAQ / Troubleshooting

Q: ERROR (MainThread) [custom_components.gaggiuino.coordinator] Error fetching gaggiuino data: Unhandled exception

A: Make sure you are on the latest firmware; make sure API Endpoints are available for Home Assistant. E.g. http://gaggiuino.local/api/system/status

Q: The states get updated only this frequently.

A: Home Assistant integrations have a fixed update period. This one is fixed at 30 seconds. Due to this long refresh period, the integration can not be used to monitor shots.

Q: Why do the profiles have their IDs in the Profile Selector?

A: While the Gagguino Profile IDs are unique, their names are not, you can have multiple profiles with the same name, but their IDs will be different. The profile selection method calls for a profile ID to be provided, that's why I decided to visually represent the selector items as both Profile Names and their corresponding IDs. I know this is not very convenient in automation, but I am open to your ideas.

Note: I always implement features from the latest Gaggiuino Releases. Please make sure your machine is on the latest firmware available.

You can always find me on the official Gaggiuino Discord.

Feel free to post your automations in https://github.com/ALERTua/hass-gaggiuino/discussions/categories/ideas

I will gather the most valuable posts in a pinned one.

❤️