mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-13 20:36:52 +00:00
Update La Marzocco Documentation (#35290)
* Update lamarzocco.markdown * dropdowns are not rendered nicely * Update lamarzocco.markdown * Update lamarzocco.markdown Co-authored-by: Franck Nijhof <frenck@frenck.nl> * Update lamarzocco.markdown Co-authored-by: Franck Nijhof <frenck@frenck.nl> * Update lamarzocco.markdown Co-authored-by: Franck Nijhof <frenck@frenck.nl> * Update lamarzocco.markdown Co-authored-by: Franck Nijhof <frenck@frenck.nl> * Update lamarzocco.markdown Co-authored-by: Franck Nijhof <frenck@frenck.nl> * Update lamarzocco.markdown Co-authored-by: Franck Nijhof <frenck@frenck.nl> * Newline * tiny tweak * add remark to coffee temp * add automation example * Update lamarzocco.markdown * use details for troubleshooting section * missing % --------- Co-authored-by: Franck Nijhof <frenck@frenck.nl> Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Josef Zweck
GitHub
parent
78c888a6f0
commit
a10d830504
@ -3,6 +3,11 @@ title: La Marzocco
|
||||
description: Instructions on how to integrate your La Marzocco coffee machine with Home Assistant.
|
||||
ha_release: 2024.2
|
||||
ha_category:
|
||||
- Binary sensor
|
||||
- Calendar
|
||||
- Number
|
||||
- Select
|
||||
- Sensor
|
||||
- Switch
|
||||
- Update
|
||||
ha_iot_class: Cloud Polling
|
||||
@ -24,12 +29,15 @@ ha_codeowners:
|
||||
ha_integration_type: device
|
||||
---
|
||||
|
||||
This integration interacts with [La Marzocco coffee machines](https://lamarzocco.com/it/en/) through calls to the LaMarzocco cloud API. Optionally, local API calls, which include a WebSocket connection for (near) real-time updates and a Bluetooth connection, can be utilized for local connections.
|
||||
|
||||
To be able to configure your machine in Home Assistant, your machine needs to be added to your account using the official La Marzocco app first. Currently, only login with username & password is supported. If you are currently using a social login, you need to create a new LaMarzocco account and transfer your machine to it to be able to use this integration.
|
||||
This integration interacts with [La Marzocco](https://lamarzocco.com/it/en/) coffee machines through calls to the La Marzocco cloud API. Optionally, local API calls, which include a WebSocket connection for (near) real-time updates and a Bluetooth connection, can be utilized for local connections.
|
||||
|
||||
If your machine is in Bluetooth range to your Home Assistant host and the [Bluetooth](/integrations/bluetooth) integration is fully loaded, the machine will be discovered automatically.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
- To be able to configure your machine in Home Assistant, your machine needs to be added to your account using the official La Marzocco app first.
|
||||
- Only login with username & password is supported. If you are currently using a social login, you need to create a new La Marzocco account and transfer your machine to it to be able to use this integration.
|
||||
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
@ -48,6 +56,7 @@ Host:
|
||||
type: boolean
|
||||
{% endconfiguration_basic %}
|
||||
|
||||
# Available platforms & entities
|
||||
|
||||
## Buttons
|
||||
|
||||
@ -88,7 +97,7 @@ Host:
|
||||
|
||||
| Sensor name | Description | Available for machines | Remarks |
|
||||
|-------------|-------------| ---------------------- | ------- |
|
||||
| Current coffee temperature | Current temperature of the coffee boiler | all | - |
|
||||
| Current coffee temperature | Current temperature of the coffee boiler | all | When the machine reaches temperature, this will be approximately 3 degrees higher than the `Coffee target temperature`, due to different measurement points. |
|
||||
| Current steam temperature| Current temperature of the steam boiler | Linea Micra, GS3 AV, GS3 MP | - |
|
||||
| Total coffees made | Counter for total coffees made| all | - |
|
||||
| Total flushes made | Counter for total flushes done | all | - |
|
||||
@ -107,3 +116,73 @@ Host:
|
||||
|-------------|-------------| ------------------------| ---------------------- |
|
||||
| Prebrew/-infusion mode | Whether to use prebrew, preinfusion, or neither | Disabled, Prebrew, Preinfusion | Linea Micra, Linea Mini, GS3 AV |
|
||||
| Steam level | The level your steam boiler should run at | 1,2,3 | Linea Micra |
|
||||
|
||||
## Supported devices
|
||||
|
||||
Currently, only devices from the **"Home"** range are supported:
|
||||
|
||||
- Linea Mini
|
||||
- Linea Mini R
|
||||
- Linea Micra
|
||||
- GS3 AV
|
||||
- GS3 MP
|
||||
|
||||
## Possible use-cases
|
||||
|
||||
- Control your machine through voice, allowing you to change boiler temperatures quickly without opening the app.
|
||||
- Control your smart coffee scales (tare/timer start) when a brew starts.
|
||||
- Turn on lights next to the machine while a brew is running.
|
||||
|
||||
## Automations
|
||||
|
||||
Get started with these automation examples.
|
||||
|
||||
### Turn steamboiler on when machine is turned on
|
||||
|
||||
I often drink milk beverages in the morning and espresso in the afternoon, but forget to re-enable the steamboiler again, so this automation ensures that the steam boiler is always turned on, when the machine is turned on.
|
||||
|
||||
{% details "Example YAML configuration" %}
|
||||
|
||||
{% raw %}
|
||||
|
||||
```yaml
|
||||
alias: Turn steamboiler on when machine is turned on
|
||||
description: Ensure the steamboiler is on, when the machine gets turned on
|
||||
triggers:
|
||||
- trigger: state
|
||||
entity_id:
|
||||
- switch.mr000000
|
||||
from: "off"
|
||||
to: "on"
|
||||
conditions:
|
||||
- condition: state
|
||||
entity_id: switch.mr000000_steam_boiler
|
||||
state: "off"
|
||||
actions:
|
||||
- action: switch.turn_on
|
||||
target:
|
||||
entity_id: switch.mr000000_steam_boiler
|
||||
data: {}
|
||||
mode: single
|
||||
|
||||
```
|
||||
{% endraw %}
|
||||
{% enddetails %}
|
||||
|
||||
## Known Limitations
|
||||
|
||||
- Only La Marzocco native app accounts are supported, social logins (Google, Apple & WeChat) are not supported
|
||||
- Currently it is only possible to view the schedules configured in the La Marzocco Home app, but not to edit the schedules from Home Assistant. You can, of course, build Home Assistant native automations to reflect the same functionality in Home Assistant.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
{% details "Problem: Connection to machine is not possible" %}
|
||||
|
||||
Check the La Marzocco Home app to see if you can connect to your machine there. If not, remove the machine and add it again (follow the instructions in the La Marzocco App).
|
||||
{% enddetails %}
|
||||
|
||||
{% details "Real time updates are not available" %}
|
||||
|
||||
Check the La Marzocco Home app to see if your machine is connected to Wi-Fi. Ensure Home Assistant can reach the machine. Ensure you configured the host option in the integration options.
|
||||
{% enddetails %}
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user