diff --git a/docs/user/docs/actions.md b/docs/user/docs/actions.md index 636879c..59e5255 100644 --- a/docs/user/docs/actions.md +++ b/docs/user/docs/actions.md @@ -4,6 +4,30 @@ Home Assistant now surfaces these backend service endpoints as **Actions** in th You can still call them from automations, scripts, and dashboards the same way as before (`service: tibber_prices.get_chartdata`, etc.), just remember that the frontend officially lists them as actions. +## Finding Your Entry ID + +Every action requires an `entry_id` parameter that tells Home Assistant which Tibber home (integration instance) to use. If you only have one home, there is still exactly one entry ID — you just need to know where to find it. + +### In the Action UI — no lookup needed + +When you use the action through the Home Assistant interface (Developer Tools → Actions, or the Action picker inside the automation / script editor), the `entry_id` field renders as a **dropdown list** showing all your configured Tibber Prices instances. Just select your home from the drop-down and Home Assistant fills in the correct ID automatically. You never have to deal with the raw ID string. + +### In YAML — copy from the integration menu + +When you write YAML directly (automations, scripts, Lovelace dashboard cards), you need the actual ID string. The quickest way to get it: + +1. Go to **Settings → Devices & Services** +2. Find the **Tibber Prices** integration card +3. Click the **⋮** (three-dot) menu on the card +4. Choose **"Copy Config Entry ID"** +5. Paste the value wherever you see `YOUR_ENTRY_ID` in the YAML examples + +The ID looks like a long alphanumeric string, for example `01JKPC7AB3EF4GH5IJ6KL7MN8P`. + +:::tip Multiple homes? +If you have configured more than one Tibber home, each home has its own entry ID. Repeat the steps above for each integration card to get the individual IDs. +::: + ## Available Actions > **Entity ID tip:** `` is a placeholder for your Tibber home display name in Home Assistant. Entity IDs are derived from the displayed name (localized), so the exact slug may differ. Example suffixes below use the English display names (en.json) as a baseline. You can find the real ID in **Settings → Devices & Services → Entities** (or **Developer Tools → States**). diff --git a/docs/user/docs/automation-examples.md b/docs/user/docs/automation-examples.md index 8a4b2e7..a9f1160 100644 --- a/docs/user/docs/automation-examples.md +++ b/docs/user/docs/automation-examples.md @@ -467,6 +467,14 @@ automation: The `tibber_prices.get_apexcharts_yaml` service generates basic ApexCharts card configuration examples for visualizing electricity prices. +:::info Finding your Entry ID (`entry_id`) +The examples below contain `entry_id: YOUR_ENTRY_ID`. This value identifies which Tibber home (integration instance) the action targets. + +**In the Action UI (Developer Tools → Actions or the automation editor):** The `entry_id` field is a **dropdown** — just select your Tibber home and HA fills in the correct ID automatically. + +**In YAML:** Go to **Settings → Devices & Services**, find the **Tibber Prices** card, open the **⋮** (three-dot) menu, and choose **"Copy Config Entry ID"**. Paste the copied value in place of `YOUR_ENTRY_ID`. +::: + ### Prerequisites **Required:** diff --git a/docs/user/docs/chart-examples.md b/docs/user/docs/chart-examples.md index a782c50..2648378 100644 --- a/docs/user/docs/chart-examples.md +++ b/docs/user/docs/chart-examples.md @@ -6,6 +6,14 @@ This guide showcases the different chart configurations available through the `t > **Entity ID tip:** `` is a placeholder for your Tibber home display name in Home Assistant. Entity IDs are derived from the displayed name (localized), so the exact slug may differ. Example suffixes below use the English display names (en.json) as a baseline. You can find the real ID in **Settings → Devices & Services → Entities** (or **Developer Tools → States**). +:::info Finding your Entry ID (`entry_id`) +Every example below contains `entry_id: YOUR_ENTRY_ID`. This value identifies which Tibber home (integration instance) the action targets. + +**In the Action UI (Developer Tools → Actions or the automation editor):** The `entry_id` field is a **dropdown** — just select your Tibber home and HA fills in the correct ID automatically. + +**In YAML:** Go to **Settings → Devices & Services**, find the **Tibber Prices** card, open the **⋮** (three-dot) menu, and choose **"Copy Config Entry ID"**. Paste the copied value in place of `YOUR_ENTRY_ID`. +::: + ## Overview The integration can generate 4 different chart modes, each optimized for specific use cases: diff --git a/docs/user/docs/glossary.md b/docs/user/docs/glossary.md index 0e06e2f..ab5d9b5 100644 --- a/docs/user/docs/glossary.md +++ b/docs/user/docs/glossary.md @@ -24,6 +24,11 @@ Quick reference for terms used throughout the documentation. ## C +**Config Entry ID** (also: `entry_id`) +: A unique identifier assigned by Home Assistant to each configured integration instance. When this integration is used with multiple Tibber homes, each home gets its own Config Entry ID. All actions (`get_chartdata`, `get_apexcharts_yaml`, etc.) require this value as the `entry_id` parameter so that Home Assistant knows which home to query. + - **In the Action UI**: The field appears as a dropdown — select your home and HA fills in the ID automatically. + - **In YAML**: Go to **Settings → Devices & Services**, find the **Tibber Prices** card, open the **⋮** menu, and choose **"Copy Config Entry ID"**. + **Currency Display Mode** : Configurable setting for how prices are shown. Choose base currency (€, kr) or subunit (ct, øre). Smart defaults apply: EUR → subunit, NOK/SEK/DKK → base.