1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
|
/*
* light.go
* GoHue library for Philips Hue
* Copyright (C) 2016 Collin Guarino (Collinux) collin.guarino@gmail.com
* License: GPL version 2 or higher http://www.gnu.org/licenses/gpl.html
*/
// http://www.developers.meethue.com/documentation/lights-api
package hue
import (
"fmt"
"time"
)
// Light struct defines attributes of a light.
type Light struct {
State struct {
On bool `json:"on"` // On or Off state of the light ("true" or "false")
Bri int `json:"bri"` // Brightness value 1-254
Hue int `json:"hue"` // Hue value 1-65535
Saturation int `json:"sat"` // Saturation value 0-254
Effect string `json:"effect"` // "None" or "Colorloop"
XY [2]float32 `json:"xy"` // Coordinates of color in CIE color space
CT int `json:"ct"` // Mired Color Temperature (google it)
Alert string `json:"alert"`
ColorMode string `json:"colormode"`
Reachable bool `json:"reachable"`
} `json:"state"`
Type string `json:"type"`
Name string `json:"name"`
ModelID string `json:"modelid"`
ManufacturerName string `json:"manufacturername"`
UniqueID string `json:"uniqueid"`
SWVersion string `json:"swversion"`
Index int // Set by index of light array response // TODO: change to smaller int
Bridge *Bridge
}
// LightState used in Light.SetState to amend light attributes.
type LightState struct {
On bool `json:"on"`
Bri uint8 `json:"bri,omitempty"`
Hue uint16 `json:"hue,omitempty"`
Sat uint8 `json:"sat,omitempty"`
XY *[2]float32 `json:"xy,omitempty"`
CT uint16 `json:"ct,omitempty"`
Effect string `json:"effect,omitempty"`
Alert string `json:"alert,omitempty"`
TransitionTime string `json:"transitiontime,omitempty"`
SaturationIncrement int16 `json:"sat_inc,omitempty"`
HueIncrement int32 `json:"hue_inc,omitempty"`
BrightnessIncrement int16 `json:"bri_inc,omitempty"`
CTIncrement int32 `json:"ct_inc,omitempty"`
XYIncrement *[2]float32 `json:"xy_inc,omitempty"`
Name string `json:"name,omitempty"`
}
// Light.SetName assigns a new name in the light's
// attributes as recognized by the bridge.
func (light *Light) SetName(name string) error {
uri := fmt.Sprintf("/api/%s/lights/%d", light.Bridge.Username, light.Index)
body := make(map[string]string)
body["name"] = name
_, _, err := light.Bridge.Put(uri, body)
if err != nil {
return err
}
return nil
}
// Light.Off turns the light source off
func (light *Light) Off() error {
return light.SetState(LightState{On: false})
}
// Light.Off turns the light source on
func (light *Light) On() error {
return light.SetState(LightState{On: true})
}
// Light.Toggle switches the light source on and off
func (light *Light) Toggle() error {
if light.State.On {
return light.Off()
} else {
return light.On()
}
return nil
}
// Light.Delete removes the light from the
// list of lights available on the bridge.
func (light *Light) Delete() error {
uri := fmt.Sprintf("/api/%s/lights/%d", light.Bridge.Username, light.Index)
err := light.Bridge.Delete(uri)
if err != nil {
return err
}
return nil
}
// Light.Blink increases and decrease the brightness
// repeatedly for a given seconds interval and return the
// light back to its off or on state afterwards.
// Note: time will vary based on connection speed and algorithm speed.
func (light *Light) Blink(seconds int) error {
originalPosition := light.State.On
originalBrightness := light.State.Bri
blinkMax := LightState{On: true, Bri: uint8(200)}
blinkMin := LightState{On: true, Bri: uint8(50)}
// Start with near maximum brightness and toggle between that and
// a lesser brightness to create a blinking effect.
err := light.SetState(blinkMax)
if err != nil {
return err
}
for i := 0; i <= seconds*2; i++ {
if i % 2 == 0 {
err = light.SetState(blinkMax)
if err != nil {
return err
}
} else {
err = light.SetState(blinkMin)
if err != nil {
return err
}
}
time.Sleep(time.Second/2)
}
// Return the light to its original on or off state and brightness
if light.State.Bri != originalBrightness || light.State.On != originalPosition {
light.SetState(LightState{On: originalPosition, Bri: uint8(originalBrightness)})
}
return nil
}
// Light.ColorLoop sets the light state to 'colorloop' if `active`
// is true or it sets the light state to "none" if `activate` is false.
func (light *Light) ColorLoop(activate bool) error {
var state = "none"
if activate {
state = "colorloop"
}
return light.SetState(LightState{On: true, Effect: state})
}
// Light.SetState modifyies light attributes. See `LightState` struct for attributes.
// Brightness must be between 1 and 254 (inclusive)
// Hue must be between 0 and 65535 (inclusive)
// Sat must be between 0 and 254 (inclusive)
// See http://www.developers.meethue.com/documentation/lights-api for more info
func (light *Light) SetState(newState LightState) error {
uri := fmt.Sprintf("/api/%s/lights/%d/state", light.Bridge.Username, light.Index)
_, _, err := light.Bridge.Put(uri, newState)
if err != nil {
return err
}
// Get the new light state and update the current Light struct
*light, err = light.Bridge.GetLightByIndex(light.Index)
if err != nil {
return err
}
return nil
}
|
