Skip to content

Latest commit

 

History

History
147 lines (115 loc) · 7.1 KB

README.md

File metadata and controls

147 lines (115 loc) · 7.1 KB
Raw

Huevent - Events for Philips-Hue buttons and sensors

Handle events from hue sensors

Example

huevent - get events from buttons and sensors
Usage: ./huevent [OPTIONS] 
  -config string
    	path to config file (default "~/.huevent/huevent.yml")
  -debug
    	enable some debug output
  -exit
    	exit on event
  -pair
    	pair hue bridge
  -sensors
    	print sensors response and exit

./huevent 
00:00:00:00:00:42:43:2f-f3      buttonevent	16
00:17:88:01:10:33:35:98-02-fc00	buttonevent	1000
00:17:88:01:03:29:57:55-02-0402	temperature	2134
00:17:88:01:03:29:57:55-02-0406	presence	false
00:17:88:01:03:29:57:55-02-0400	lightlevel	19888

Supported Device and Event Types

Device Event-Type (eventType) Event-Data (triggerOn) Description
Hue Tap buttonevent 34 1 Dot Key
buttonevent 16 2 Dot Key
buttonevent 17 3 Dot Key
buttonevent 18 4 Dot Key
Hue Dimmer Switch buttonevent 1000 Hard press ON, followed by Event-Data 1002
buttonevent 1001 Long press ON (send while hold the button)
buttonevent 1003 Release ON (after Long press)
buttonevent 1002 Soft press ON
buttonevent 2000 Hard press BRIGHTER, followed by Event-Data 2002
buttonevent 2001 Long press BRIGHTER (send while hold the button)
buttonevent 2003 Release BRIGHTER
buttonevent 2002 Soft press BRIGHTER
buttonevent 3000 Hard press DARKER, followed by Event-Data 3002
buttonevent 3001 Long press DARKER
buttonevent 3003 Release DARKER
buttonevent 3002 Soft press DARKER
buttonevent 4000 Hard press OFF, followed by Event-Data 4002
buttonevent 4001 Long press OFF
buttonevent 4003 Release OFF
buttonevent 4002 Soft press OFF
Hue Motion Sensor presence true Motion detected
presence false No Motion detected
temperature xxxx Temperature in °C multiplied by 100 (2655 == 26.55°C)
lightlevel xxxxx Lightlevel (0 ~ dark, 20000 ~ normal, 40000 ~ very bright)

Configuration

Run huevent -pair to pair a local Hue Bridge.

Configfile

config: Hue Bridge IP with Token

hooks: Execute commands on specific events

deviceFilter: Array(string) of deviceIds, ignore all other devices

config:
  ip: 192.168....
  user: nEh...
hooks:
- deviceId: 00:17:88:01:10:33:35:98-02-fc00
  eventType: buttonevent
  triggerOn: 1002
  cmd: echo echo
- deviceId: 00:00:00:00:00:42:43:2f-f2
  eventType: buttonevent
  triggerOn: 18
  cmd: echo $HUEVENT_PAYLOAD NOOOOPE
- deviceId: 00:17:88:01:03:29:57:55-02-0406
  eventType: presence
  triggerOn: 'true'
  cmd: echo SOMEBODY BECOMES PRESENT
- deviceId: 00:17:88:01:03:29:57:55-02-0406
  eventType: presence
  triggerOn: 'false'
  cmd: echo SOMEBODY IS ABSENT
- deviceId: 00:17:88:01:03:29:57:55-02-0402
  eventType: temperature
  cmd: python -c 'import os; print(str(float(os.environ["HUEVENT_PAYLOAD"])/100.0) + "°C")'
deviceFilter: []

The default Hue-Bridge polling rate is 333ms. You can set a > 1ms rate via

config:
  ip: 192.168....
  user: nEh...
  pollingRateMs: 200

Manual Pairing

# Press Hue Bridge Button before you ran these commands
BRIDGE_IP=$(curl https://www.meethue.com/api/nupnp -s | grep -E -o "([0-9]{1,3}[.]){3}[0-9]{1,3}")
USERNAME=$(curl -s -X POST -d'{"devicetype":"huevent"}' "http://$BRIDGE_IP/api" | grep -P -o '":"(.*)"' | cut -d '"' -f3)

echo "$BRIDGE_IP $USERNAME"

Build

git clone https://github.com/mperlet/huevent.git && cd huevent
docker run --rm -v "$PWD":/huevent:Z -w /huevent -e GOOS=linux -e GOARCH=amd64 golang:1.15.2-buster go build huevent.go

Examples

  • A Remote for Fritz Dect200 Power-Sockets
  • Trigger

Goreleaser

docker run --rm --privileged -v $PWD:/go/src/github.com/user/repo -v /var/run/docker.sock:/var/run/docker.sock -w /go/src/github.com/user/repo goreleaser/goreleaser release --skip-publish --skip-validate --rm-dist

Licence

Copyright (c) 2019 Mathias Perlet

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.