+ This module represents a Milight LED Bulb or LED strip controller. It is controlled by a MilightBridge.
+ The Milight system is sold under various brands around the world including "LimitlessLED, EasyBulb, AppLamp"
+ The API documentation is available here: http://www.limitlessled.com/dev/
+
+
+ Define
+
+ define <name> MilightDevice <devType(RGB|RGBW|White)> <IODev> <slot>
+ Specifies the Milight device.
+ <devType> One of RGB, RGBW, White depending on your device.
+ <IODev> The MilightBridge which the device is paired with.
+ <slot> The slot on the MilightBridge that the device is paired with.
+
+
+ Readings
+
+ -
+ state
+ [on xxx|off]: Current state of the device (xxx = 0-100%).
+
+ -
+ brightness
+ [0-100]: Current brightness level in %.
+
+ -
+ brightness_on
+ [0-100]: The brightness level before the off command was sent. This allows the light to turn back on to the last brightness level.
+
+ -
+ RGB
+ [FFFFFF]: HEX value for RGB.
+
+ -
+ previousState
+ [hsv]: hsv value before last change. Can be used with restorePreviousState set command.
+
+ -
+ savedState
+ [hsv]: hsv value that was saved using saveState set function
+
+ -
+ hue
+ [0-360]: Current hue value.
+
+ -
+ saturation
+ [0-100]: Current saturation value.
+
+ -
+ transitionInProgress
+ [0|1]: Set to 1 if a transition is currently in progress for this device (eg. fade).
+
+ -
+ discoMode
+ [0|1]: 1 if discoMode is enabled, 0 otherwise.
+
+ -
+ discoSpeed
+ [0|1]: 1 if discoSpeed is increased, 0 if decreased. Does not mean much for RGBW
+
+ -
+ colourTemperature
+ [1-10]: Current colour temperature (1=Cold,10=Warm) for White devices.
+
+
+
+
+ Set
+
+ -
+ on <ramp_time (seconds)>
+
+ -
+ off <ramp_time (seconds)>
+
+ -
+ toggle
+
+ -
+ dim <percent(0..100)> [seconds(0..x)] [flags(l=long path|q=don't clear queue)]
+
+ -
+ dimup <percent change(0..100)> [seconds(0..x)]
+ Special case: If percent change=100, seconds will be adjusted for actual change to go from current brightness.
+
+ -
+ dimdown <percent change(0..100)> [seconds(0..x)]
+ Special case: If percent change=100, seconds will be adjusted for actual change to go from current brightness.
+
+ -
+ pair
+ May not work properly. Sometimes it is necessary to use a remote to clear pairing first.
+
+ -
+ unpair
+ May not work properly. Sometimes it is necessary to use a remote to clear pairing first.
+
+ -
+ restorePreviousState
+ Set device to previous hsv state as stored in previousState reading.
+
+ -
+ saveState
+ Save current hsv state to savedState reading.
+
+ -
+ restoreState
+ Set device to saved hsv state as stored in savedState reading.
+
+ -
+ hsv <h(0..360)>,<s(0..100)>,<v(0..100)> [seconds(0..x)] [flags(l=long path|q=don't clear queue)]
+ Set hsv value directly
+
+ -
+ rgb RRGGBB [seconds(0..x)] [flags(l=long path|q=don't clear queue)]
+ Set rgb value directly or using colorpicker.
+
+ -
+ discoModeUp
+ Next disco Mode setting (for RGB and RGBW).
+
+ -
+ discoModeDown
+ Previous disco Mode setting (for RGB).
+
+ -
+ discoSpeedUp
+ Increase speed of disco mode (for RGB and RGBW).
+
+ -
+ discoSpeedDown
+ Decrease speed of disco mode (for RGB and RGBW).
+
+ -
+ colourTemperature <1-10>
+ Colour temperature 1=Cold White,10=Warm White (for White devices only).
+
+ -
+ set extensions are supported.
+
+
+
+
+ Get
+
+ -
+ rgb
+
+ -
+ RGB
+
+ -
+ hsv
+
+
+
+
+ Attributes
+
+ -
+ dimStep
+ Allows you to modify the default dimStep if required.
+
+ -
+ defaultRampOn
+ Set the default ramp time if not specified for on command.
+
+ -
+ defaultRampOff
+ Set the default ramp time if not specified for off command.
+
+
+
+
+=end html
+=cut
diff --git a/fhem/HISTORY b/fhem/HISTORY
index 966712a91..1d681e188 100644
--- a/fhem/HISTORY
+++ b/fhem/HISTORY
@@ -602,3 +602,7 @@
- Wed Dec 17 2014 (Reinerlein)
- added new module 00_SONOS and 21_SONOSPLAYER to support the Sonos Multiroom Audiosystem
+- Mon Dec 22 2014 (mattwire)
+ - added new module 30_MilightBridge and 31_MilightDevice to support Milight LED lights/strips/controllers.
+
+
diff --git a/fhem/MAINTAINER.txt b/fhem/MAINTAINER.txt
index eb7eb0342..fc9882416 100644
--- a/fhem/MAINTAINER.txt
+++ b/fhem/MAINTAINER.txt
@@ -104,8 +104,10 @@ FHEM/23_WEBIO.pm sachag http://forum.fhem.de Sonstiges
FHEM/23_WEBIO_12DIGITAL.pm sachag http://forum.fhem.de Sonstiges
FHEM/24_NetIO230B.pm rudolfkoenig/orphan http://forum.fhem.de Sonstiges
FHEM/30_HUEBridge.pm justme1968 http://forum.fhem.de Beleuchtung
+FHEM/30_MilightBridge.pm mattwire http://forum.fhem.de Beleuchtung
FHEM/30_ENECSYSGW.pm akw http://forum.fhem.de Sonstige Systeme
FHEM/31_HUEDevice.pm justme1968 http://forum.fhem.de Beleuchtung
+FHEM/31_MilightDevice.pm mattwire http://forum.fhem.de Beleuchtung
FHEM/31_ENECSYSINV.pm akw http://forum.fhem.de Sonstige Systeme
FHEM/31_LightScene.pm justme1968 http://forum.fhem.de Automatisierung
FHEM/32_SYSSTAT.pm justme1968 http://forum.fhem.de Unterstuetzende Dienste