home-assistant.io/source/_components/binary_sensor.arest.markdown

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category
component	aREST Binary Sensor	Instructions how to integrate aREST binary sensors within Home Assistant.	2015-11-20 18:15	true	false	true	true	arest.png	Binary Sensor

The arest binary sensor platform allows you to get all data from your devices (like Arduinos with a ethernet/wifi connection, the ESP8266, and the Raspberry Pi) running the aREST RESTful framework.

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

# Example configuration.yaml entry
binary_sensor:
  platform: arest
  resource: http://IP_ADDRESS
  name: Office Switch
  pin: 8

Configuration variables:

• resource (Required): IP address and schema of the device that is exposing an aREST API, e.g. http://192.168.1.10.
• name (Optional): Let you overwrite the the name of the device. By default name from the device is used.
• pin (Required): Number of the pin to monitor.

Accessing the URL http://IP_ADDRESS/digital/PIN_NUMBER should give you the state of the pin inside a JSON response as return_value.

$ curl -X GET http://10.100.0.157/digital/9
{"return_value": 0, "id": "office1", "name": "Office", "connected": true}

This sensor is not suitable for fast state changes because there is a high possibility that the change took place between two update cycle.