Add documentation for acaia integration

source/_integrations/acaia.markdown

@@ -0,0 +1,104 @@
+---
+title: Acaia
+description: Instructions on how to integrate your Acaia smart coffee scale with Home Assistant.
+ha_release: 2024.12
+ha_category:
+  - Button
+ha_iot_class: Local Push
+ha_config_flow: true
+ha_domain: acaia
+ha_platforms:
+  - button
+ha_bluetooth: true
+ha_codeowners:
+  - '@zweckj'
+ha_integration_type: device
+---
+
+The **Acaia** {% term integrations %} allows you to control [Acaia](https://acaia.co/) scales through Home Assistant.
+
+If your machine is within Bluetooth range to your Home Assistant host and the [Bluetooth](/integrations/bluetooth) integration is fully loaded, the scale should be discovered automatically. If you are configuring this integration, your scale needs to be turned on during setup.
+
+{% include integrations/config_flow.md %}
+
+{% configuration_basic %}
+MAC:
+  description: "The MAC address of your scale."
+{% endconfiguration_basic %}
+
+# Available platforms & entities
+
+## Buttons
+
+- **Tare**: Tares the scale.
+- **Reset timer**: Resets the timer. If the timer is running, it will continue to run.
+- **Start/stop timer**: Starts or stops the timer, depending on whether the timer is currently running. Does not reset, but continue the timer.
+
+## Supported devices
+
+The following devices have been tested successfully with this integration:
+
+- Lunar (manufactured after 2021)
+- Pyxis
+
+If you have successfully tested this integration with another Acaia model, please let us know by enhancing this documentation, or by opening an issue in GitHub.
+
+## Possible use-cases
+
+This integration can be used in combination with integrations for smart coffee machines, such as the [La Marzocco integration](https://www.home-assistant.io/integrations/lamarzocco/) integration.
+It could also be used to display the weight on secondary displays when brewing on a Pyxis or Lunar where you cannot see the display.
+
+## Automations
+
+Get started with these automation examples.
+
+### Tare & start timer when brew starts
+
+{% details "Example YAML configuration" %}
+
+{% raw %}
+
+```yaml
+alias: Start timer on scale
+description: "When a brew starts on the machine, the following actions are started: tare, reset the timer, and start the timer on the scale."
+triggers:
+  - entity_id:
+      - binary_sensor.lm001234_brewing_active
+    to: "on"
+    from: "off"
+    trigger: state
+conditions: []
+actions:
+  - action: button.press
+    target:
+      entity_id: button.lunar_tare
+    data: {}
+  - action: button.press
+    target:
+      entity_id:
+        - button.lunar_reset_timer
+    data: {}
+  - action: button.press
+    target:
+      entity_id:
+        - button.lunar_start_stop_timer
+    data: {}
+mode: single
+
+```
+
+{% endraw %}
+{% enddetails %}
+
+## Troubleshooting
+
+{% details "Problem: Not reacting to commands" %}
+
+Try toggling the **Is new style scale** setting in the reconfiguration settings. This setting tells the integration whether you have a newer model (newer than 2021) or not.
+{% enddetails %}
+
+{% details "Device not discovered or found" %}
+
+Make sure your scale is in Bluetooth range to your Home Assistant instance. [ESPHome Bluetooth Proxies](https://esphome.io/components/bluetooth_proxy.html) are a great way to increase the range, if your instance is too far away.
+{% enddetails %}
+