README.md

Home Assistant Fingrid API

Home Assistant sensor for Fingrid open API data.

Sensors

Currently only one simple sensor:

• fingrid-power-system-state Can be used to e.g. ramp down home energy consumption (automatically or manually), when there is risk of electricity sortage. API variable ID: 209 https://data.fingrid.fi/fi/dataset/power-system-state-real-time-data

Usage

1. Register free Fingrid API key, it is easy to get. See https://data.fingrid.fi/fi/pages/api
2. Add API key to your secrets.yaml -file "fingrid_api_key: [your personal Fingrid api key]"
3. Add sensor code (separate file) to configuration.yaml -file.
4. Use entities on dashboards (see UI examples), automations, etc.

UI card examples:

type: entities
entities:
  - entity: sensor.fingrid_power_system_state

type: history-graph
entities:
  - entity: sensor.fingrid_power_system_state
    name: Fingrid

Automation examples

Send notification on all changes

alias: Fingrid status change notification
description: ""
trigger:
  - platform: state
    entity_id:
      - sensor.fingrid_power_system_state
    attribute: value
condition: []
action:
  - service: notify.notify
    data:
      message: >-
        Fingrid: Sähköjärjestelmän tila on muuttunut, tarkista Home Assistant
        dashboard.
mode: single

Links

• Fingrid open API https://api.fingrid.fi/
• Fingrdi API instructions: https://data.fingrid.fi/fi/pages/api
• Swagger https://data.fingrid.fi/open-data-api/#!/event-controller/getEventJsonUsingGET
• HAAS RESTfull sensor: https://www.home-assistant.io/integrations/rest/