home-assistant.io/source/_components/switch.arest.markdown
Fabian Affolter b726f0e94b Minor update
2015-10-29 09:36:30 +01:00

1.4 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category
layout title description date sidebar comments sharing footer logo ha_category
component aREST switch Instructions how to integrate aREST switches within Home Assistant. 2015-09-11 23:15 true false true true arest.png Switch

The arest switch platform allows you to toggle pins of your devices (like Arduino boards with a ethernet/wifi connection, ESP8266 based devices, and the Raspberry Pi) running the aREST RESTful framework.

To use your aREST enabled device in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
switch:
  platform: arest
  resource: http://IP_ADDRESS
  name: Office
  pins:
    11:
      name: Fan
    12:
      name: Light Desk

Configuration variables:

  • resource (Required): IP address and schema of the device that is exposing an aREST API, eg. http://192.168.1.10.
  • name (Optional): Let you overwrite the the name of the device. By default name from the device is used.
  • pins array (Required): An array with all used pins of your board.
    • name (Required): The name of the pin you wish to toggle.

You can still switch your pins with a web browser or a command line tool. Use the http://192.168.1.10/digital/8/1 to set pin 8 to high/on, the JSON response will give you some feedback.

{"message": "Pin D8 set to 1", "id": "sensor02", "name": "livingroom", "connected": true}