Home Assistant

IBM Watson IoT Platform

The watson_iot integration enables you to link the devices in Home Assistant with an IBM Watson IoT Platform instance.

Configuration

To use this integration, you first need to register a gateway device type and then a gateway device in your IoT platform instance. For instructions on how to do this check the official documentation which provides the details on doing this. After you register the gateway device for your Home Assistant instance you’ll need four pieces of information:

  • Organization ID
  • Gateway device Type
  • Gateway device ID
  • Authentication Token

With this basic information you can configure the integration:

# Example configuration.yaml entry:
watson_iot:
  organization: "organization_id"
  type: "device_type"
  id: "device_id"
  token: "auth_token"

Configuration Variables

Looking for your configuration file?
organization string Required

The Organization ID for your Watson IoT Platform instance.

type string Required

The device type for the gateway device to use.

id string Required

The device id for the gateway device to use.

token string Required

The authentication token for the gateway device.

exclude map (Optional)

Configure which integrations should be excluded from recording to Watson IoT Platform.

entities list (Optional)

The list of entity ids to be excluded from recording to Watson IoT Platform.

domains list (Optional)

The list of domains to be excluded from recording to Watson IoT Platform.

include map (Optional)

Configure which integrations should be included in recordings to Watson IoT Platform. If set, all other entities will not be recorded to Watson IoT Platform. Values set by the exclude option will prevail.

entities list (Optional)

The list of entity ids to be included from recordings to Watson IoT Platform.

domains list (Optional)

The list of domains to be included from recordings to Watson IoT Platform.

Examples

Full configuration

watson_iot:

  exclude:
    entities:
       - entity.id1
       - entity.id2
    domains:
       - automation
  include:
    entities:
       - entity.id3
       - entity.id4