Kai Kreuzer
parent
26dc4daafd
commit
fb63ee4f34
|
|
@ -7,6 +7,7 @@ ntp,NTP,"The NTP binding is used for displaying the local date and time based up
|
|||
sonos,Sonos,"This binding integrates the [Sonos Multi-Room Audio system](http://www.sonos.com)."
|
||||
wemo,Belkin Wemo,"This binding integrates the [Belkin WeMo Family](http://www.belkin.com/us/Products/c/home-automation/)."
|
||||
yahooweather,YahooWeather,"This binding uses the [Yahoo Weather service](https://developer.yahoo.com/weather/) for providing current weather information."
|
||||
amazondashbutton,Amazon Dash Button,"The Amazon Dash Button is a very cheap device in order to integrate it in your home automation setup. In openHAB it can be used as a simple switch."
|
||||
astro,Astro,"The Astro binding is used for calculating many DateTime and positional values for sun and moon."
|
||||
autelis,Autelis Pool Control,"Autelis manufactures a network enabled pool interface for many popular pool systems. See [the Autelis website](http://www.autelis.com) and the [Autelis Command Protocol](http://www.autelis.com/wiki/index.php?title=Pool_Control_(PI)_HTTP_Command_Reference) for more information."
|
||||
avmfritz,AVM FRITZ!,"The binding integrates the AHA ( [AVM Home Automation](http://avm.de/ratgeber/smart-home/) ) system."
|
||||
|
|
|
|||
|
|
|
@ -0,0 +1,84 @@
|
|||
---
|
||||
layout: documentation
|
||||
---
|
||||
|
||||
{% include base.html %}
|
||||
|
||||
# Amazon Dash Button Binding
|
||||
|
||||
The Amazon Dash Button is a very cheap device in order to integrate it in your home automation setup. In openHAB it can be used as a simple switch.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
The binding uses pcap4j (https://www.pcap4j.org/) in order to capture ARP requests send by the Amazon Dash Button. The code is inspired by https://github.com/hortinstein/node-dash-button.
|
||||
|
||||
|
||||
## Install Native Library
|
||||
|
||||
Let’s start with installing libpcap (for Mac/Linux/UNIX) or WinPcap (for Windows) on your computer. They are native libraries that powers the core functionalities of Pcap4J.
|
||||
|
||||
### Ubuntu
|
||||
|
||||
```
|
||||
apt-get install libpcap-dev
|
||||
```
|
||||
|
||||
### CentOs
|
||||
|
||||
```
|
||||
yum install libpcap-devel
|
||||
```
|
||||
|
||||
### Mac
|
||||
|
||||
```
|
||||
brew install libpcap
|
||||
```
|
||||
|
||||
### Windows
|
||||
|
||||
```
|
||||
choco install winpcap
|
||||
```
|
||||
|
||||
|
||||
Pcap4J needs administrator/root privileges.
|
||||
Or, if on Linux, you can run Pcap4J with a non-root user by granting capabilities `CAP_NET_RAW` and `CAP_NET_ADMIN`
|
||||
to your java command by the following command:
|
||||
|
||||
```
|
||||
setcap cap_net_raw,cap_net_admin=eip /path/to/java
|
||||
```
|
||||
|
||||
Source: [https://www.pcap4j.org/](https://www.pcap4j.org/)
|
||||
|
||||
## Setup Dash Button
|
||||
|
||||
Setting up your Dash button is as simple as following the instructions provided by Amazon **EXCEPT FOR THE LAST STEP**. Just follow the instructions to set it up in their mobile app. When you get to the step where it asks you to pick which product you want to map it to, just quit the setup process.
|
||||
|
||||
## Block Internet access for the Dash Button
|
||||
|
||||
Completely deny internet access for the Amazaon Dash Button in your router. You need to find out the Dash button's IP address first of all. This is not explained as this job depends on your environment.
|
||||
|
||||
|
||||
## Supported Things
|
||||
|
||||
There is one supported thing:
|
||||
|
||||
* Amazon Dash Button: Thing
|
||||
|
||||
## Discovery
|
||||
|
||||
Background discovery is supported. Just press the button in order to put it into your inbox.
|
||||
|
||||
## Thing Configuration
|
||||
|
||||
### Amazon Dash Button
|
||||
|
||||
* MAC address: The MAC address of the Amazon Dash Button
|
||||
* Network interface: The network interface which receives the packets of the Amazon Dash Button
|
||||
* Packet processing interval: Often a single button press is recognized multiple times. You can specify how long any further detected button pressed should be ignored after one click is handled (in ms).
|
||||
|
||||
## Channels
|
||||
|
||||
* Press: Channel for recognizing presses on the Amazon Dash Button
|
||||
|
|
@ -28,9 +28,16 @@ CUxD: 8701
|
|||
TclRegaScript: 8181
|
||||
|
||||
**Note:** The binding tries to identify the gateway with XML-RPC and uses henceforth:
|
||||
- BIN-RPC for a Homegear gateway
|
||||
- BIN-RPC for a gateway NOT supporting Homematic IP
|
||||
- XML-RPC for a gateway supporting Homematic IP (Homematic IP does not support BIN-RPC)
|
||||
|
||||
* **CCU**
|
||||
* **RF**: BIN-RPC
|
||||
* **WIRED**: BIN-RPC
|
||||
* **HMIP**: XML-RPC
|
||||
* **CUxD**: BIN-RPC (CUxD version >= 1.6 required)
|
||||
* **Homegear**
|
||||
* BIN-RPC
|
||||
* **Other**
|
||||
* XML-RPC
|
||||
|
||||
## Supported Things
|
||||
|
||||
|
|
|
|||
|
|
@ -48,13 +48,22 @@ TV's support the following channels:
|
|||
| brightness | Dimmer | Brightness of the TV picture. |
|
||||
| contrast | Dimmer | Contrast of the TV picture. |
|
||||
| sharpness | Dimmer | Sharpness of the TV picture. |
|
||||
| colortemperature | Number | Color temperature of the TV picture. Minimum value is 0 and maximum 4. |
|
||||
| sourcename | String | Name of the current source. |
|
||||
| sourceid | Number | Id of the current source. |
|
||||
| colorTemperature | Number | Color temperature of the TV picture. Minimum value is 0 and maximum 4. |
|
||||
| sourceName | String | Name of the current source. |
|
||||
| sourceId | Number | Id of the current source. |
|
||||
| channel | Number | Selected TV channel number. |
|
||||
| programtitle | String | Program title of the current channel. |
|
||||
| channelname | String | Name of the current TV channel. |
|
||||
| programTitle | String | Program title of the current channel. |
|
||||
| channelName | String | Name of the current TV channel. |
|
||||
| url | String | Start TV web browser and go the given web page. |
|
||||
| stopbrowser | Switch | Stop TV's web browser and go back to TV mode. |
|
||||
| stopBrowser | Switch | Stop TV's web browser and go back to TV mode. |
|
||||
| power | Switch | TV power. Some of the Samsung TV models doesn't allow to set Power ON remotely. |
|
||||
| keycode | String | The key code channel emulates the infrared remote controller and allows to send virtual button presses. |
|
||||
| keyCode | String | The key code channel emulates the infrared remote controller and allows to send virtual button presses. |
|
||||
|
||||
|
||||
E.g.
|
||||
|
||||
```
|
||||
Dimmer TV_Volume { channel="samsungtv:tv:livingroom:volume" }
|
||||
Switch TV_Mute { channel="samsungtv:tv:livingroom:mute" }
|
||||
String TV_KeyCode { channel="samsungtv:tv:livingroom:keyCode" }
|
||||
```
|
||||
|
|
|
|||
Loading…
Reference in New Issue