c0ffeeca7 85c91b3c5e
j-k-integrations: restart HA after config change (#32644)
* i-integrations:
- add note to restart HA after changing config
- add related topics
- rename 'platform' or 'sensor' to 'integration' to streamline terminology
- add glossary reference to Configuration file

* Undo formatting
2024-05-09 18:03:43 +02:00

2.2 KiB

title, description, ha_iot_class, ha_category, ha_release, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, related
title description ha_iot_class ha_category ha_release ha_codeowners ha_domain ha_platforms ha_integration_type related
Kaiterra Instructions on how to integrate your Kaiterra device into Home Assistant. Cloud Polling
Health
0.100
@Michsior14
kaiterra
air_quality
sensor
integration
docs title
/docs/configuration/ Configuration file

The kaiterra {% term integration %} allows you to view the readings from your Laser Egg or Sensedge device using the Kaiterra REST API.

To use the {% term integration %}, you need to get the API key by signing up at Kaiterra dashboard, registering the device and create the key under Settings -> Profile -> Developer.

Configuration

To enable kaiterra in your installation, add the following to your {% term "configuration.yaml" %} file. {% include integrations/restart_ha_after_config_inclusion.md %}

# Example configuration.yaml entry
kaiterra:
  api_key: YOUR_API_KEY
  devices:
    - device_id: YOUR_DEVICE_ID
      type: YOUR_DEVICE_TYPE

{% configuration %} api_key: description: Your personal API key from Kaiterra Dashboard. required: true type: string aqi_standard: description: The standard of Air Quality Index. Available values us, in, cn. required: false type: string default: us scan_interval: description: The interval to scan for sensor state changes in seconds. required: false type: integer default: 30 preferred_units: description: The list of preferred units. Available values in the list x, %, C, F, mg/m³, µg/m³, ppm, ppb. required: false type: list devices: description: The devices you want to get reading from. required: true type: list keys: device_id: description: The UUID of the device you want to monitor. You can take it from Kaiterra Dashboard. required: true type: string type: description: The device type. Available values laseregg and sensedge. required: true type: string name: description: The custom name of your device. required: false type: string {% endconfiguration %}