Skip to content
Neu erstelltes Hue Plugin für smarthome.py
Python HTML
Branch: develop
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
README.md
__init__.py
html_example.txt
widget_hue.html

README.md

Phillips HUE

###New development of Hue plugin for use in smarthome.py (C) Michael Würtenberger 2014, 2015 version 1.6 develop Updated on v1.7 Hue API

Supported Hardware

Philips hue bridge, multiple bridges allowed

Configuration

plugin.conf

Typical configuration for 3 bridges

[HUE]
    class_name = HUE
    class_path = plugins.hue
    hue_user = 38f625a739562a8bd261ab9c7f5e62c8, 38f625a739562a8bd261ab9c7f5e62c8, 38f625a739562a8bd261ab9c7f5e62c8
    hue_ip = 192.168.2.2,192.168.2.3,192.168.2.4
    hue_port = 80,80,80
    cycle_lamps = 3
    cycle_bridges = 30
    default_transitionTime = 0.4

Minimal configuration for single bridge an default settings

[HUE]
    class_name = HUE
    class_path = plugins.hue
    hue_user = 38f625a739562a8bd261ab9c7f5e62c8
    hue_ip = 192.168.2.2

hue_user

A user name for the hue bridge. Usually this is a hash value of 32 hexadecimal digits. If you would like to use more than on bridge, you have to specify all ip addresses, ports and users accordingly. All users are separated with comma (',') ! If the user/hash is not yet authorized, you can use sh.hue.authorizeuser() (via interactive shell or via logic) to authorize it. The link button must be pressed before.

hue_ip

IP or host name of the hue bridge. There is no default, please us a valid ip address. If you would like to use more than on bridge, you have to specify all ip addresses, ports and users accordingly. All ip's are separated with comma (',') !

hue_port

Port number of the hue bridge. Default 80. Normally there is no need to change that. If you would like to use more than on bridge, you have to specify all ip addresses, ports and users accordingly. All ports are separated with comma (',') !

cycle_lamps

Cycle in seconds to how often update the state of the lights in smarthome. Default value is 10 seconds. Note: The hue bridge has no notification feature. Therefore changes can only be detected via polling.

cycle_bridges

Cycle in seconds to how often update the state of the bridges in smarthome. Default value is 60 seconds Note: The hue bridge has no notification feature. Therefore changes can only be detected via polling.

default_transitionTime

Time in seconds how fast check states of the lamps are changed through the bridge itself. If you don't set a value in the item, this value is used. Note: The hue bridge has no notification feature. Therefore changes can only be detected via polling.

items.conf

hue_bridge_id (formerly hue_bridge !)

Specify the number of the hue_bridge_id. Via this parameter the right hue connection is established. The numbers start with 0. There must be no missing number in between !

hue_lamp_id (formerly hue_id)

Specify the lamp id. Via this parameter the right lamp on the hue connection is established. The numbers are the corresponding numbers of the lamp Id in the bridge. They normally start with 0. There must be a hue_bridge_id attached to this item as well. If not, a default value of 0 will be set.

hue_group_id

Specify the group id. Via this parameter the right group on the hue connection is established. The numbers are the corresponding numbers of the lgroup Id in the bridge. They normally start with 1. There must be a hue_bridge_id attached to this item as well. If not, a default value of 1 will be set.

hue_lamp_type

Specify the lamp type because of different color garamut parameters Default would be 0 if not defined. There are currently two groups of lamps: Group 0 consists of hue bulb lamps, there hue_lamp_type = 0 Group 1 consists of LivingColors Bloom, Aura and Iris lamps, there hue_lamp_type = 1 Group 2 consists of standard - non known type recommended by Philips, there hue_lamp_type = 2

Commands and Parameters supported

Please refer to the specs of the API 1.4 of the hue at http://www.developers.meethue.com/documentation/lights-api. Readable means you can set a hue_listen attribute in a item with the corresponding name Writable means you can set a hue_send attribute in a item with the corresponding name

Lights API (Light state)

All Attributes for the Light state (besides 'on') can only be set, if the light is on!

Attribute            Type   Range                           Readable    Writable
'on'                 bool   False / True                    yes         yes
'bri'                num    0-255                           yes         yes
'hue'                num    0-65535                         yes         yes
'sat'                num    0-255                           yes         yes
'ct'                 num    153 - 500                       yes         yes
'alert'              str    'none' or 'select' or 'lselect' yes         yes
'effect'             str    'none' or 'colorloop'           yes         yes
'reachable'          bool   False / True                    yes         no
'hue_transitionTime' num    0-65535                         no          yes
'col_r'              num    0-255                           no          yes
'col_g'              num    0-255                           no          yes
'col_b'              num    0-255                           no          yes

Instead of implementing the 'xy' state attribute, 'col_r', 'col_g' and 'col_b' have been implemented to allow the color control directly from a SmartVISU widget (e.g. Colordisc).

For a basic control of the the lights you only need to implement the first 4 to 5 attributes of the Lights API ('on', 'bri', 'hue', 'sat' and 'ct'). The rest of the attributes is only needed, if you want to do MORE.

Lights API (Lamp attributes)

Attribute            Type   Range                           Readable    Writable
'type'               str    text                            yes         no
'name'               str    text                            yes         no
'modelid'            str    text                            yes         no
'uniqueid'           str    text                            yes         no
'manufacturername'   str    text                            yes         no
'swversion'          str    text                            yes         no

Groups API

Attribute            Type   Range                           Readable    Writable
'scene'              str    scene name in bridge            no          yes

Configuration API (Bridge related)

Attribute            Type   Range                           Readable    Writable
'bridge_name'        str    text                            yes         no
'swupdate'           dict   object                          yes         no
'whitelist'          dict   object                          yes         no
'apiversion'         str    text                            yes         no
'bridge_swversion'   str    text                            yes         no
'linkbutton'         bool   False / True                    yes         no

'ipaddress'          str    text                            yes         no
'mac'                str    text                            yes         no
'netmask'            str    text                            yes         no
'gateway'            str    text                            yes         no
'dhcp'               bool   False / True                    yes         no

'portalservices'     bool   False / True                    yes         no
'portalconnection'   str    text                            yes         no
'portalstate'        dict   object                          yes         no

'UTC'                str    text                            yes         no
'localtime'          str    text                            yes         no
'timezone'           str    text                            yes         no

'zigbeechannel'      num    1-13                            yes         no
'errorstatus'        bool   False / True                    yes         no

Configuration API (Plugin related)

Attribute            Type   Range                           Readable    Writable
'errorstatus'        bool   False / True                    yes         no

hue_listen = errorstatus

errorstatus represents the status of the link between sm.hy plugin and bridge. A status True reflects and error state in the communication.

hue_send

Specifies the writable attribute which is send to the lamp when this item is altered. In addition to hue_send an hue_lamp_id and hue_bridge_id (optional for one bridge) has to be set.

hue_listen

Specifies the readable attribute which is updated on a scheduled timer from the lamps and bridges. In addition to hue_send an hue_lamp_id and hue_bridge_id (optional for one bridge) has to be set.

hue_transitionTime

This parameter specifies the time, which the lamp take to reach the a newly set value. This is done by interpolation of the values inside the lamp. This parameter is optional. If not set the time default is 0.1 second. In addition to hue_send an hue_lamp_id and hue_bridge_id has to be set. This could be done in upper layers. If it's missing the parameter is removed.

Using DPT3 dimming

If you would like to use a DPT3 dimmer, you have to specify a subitem to the dimmed hue item. To this subitem you link the knx DPT3 part. You can control the dimming via some parameters, which have to be specified in this subitem.

DPT3 dimming could be use with every item which has the type = num (even if it's not hue related !)

If you are using the DPT3 dimmer, please take into account that there is a lower limit of timing. A lower value than 0.2 seconds should be avoided, regarding the performance of the overall system. Nevertheless to get nice and smooth results of dimming, please set the parameters of hue_transitionTime and hue_dim_time equally. In that case, the lamp interpolates the transition as quick as the steps of the dimmer function happen. If the lamp is set to off (e.g. attribute 'on' = False), changes could be not written to the lamp. Warnings in the log will appear. The lamp doesn't support this behaviour. In case of starting dimming the brightness of the lamp, the plugin automatically sets the lamp on and starts dimming with the last value.

hue_dim_max

Parameter which determines the maximum of the dimmer range. Without this parameter DPT3 dimming will not work.

hue_dim_step

Parameter which determines the step size. In addition to hue_dim_max this parameter has to be set. If not a warning will be written and a default value of 25 will be set.

hue_dim_time

Parameter which determines the time, the dimmer takes for making on step. In addition to hue_dim_max this parameter has to be set. If not a warning will be written and a default value of 1 will be set.

Example

items/test.conf

[keller]
    [[hue]]
        # if hue_lamp_id and hue_bridge_id is not set, it is searched in a higher layer
        hue_lamp_id = 1
        hue_bridge_id = 0
        hue_lamp_type = 0
        [[[bridge_name]]]
            type = str
            hue_listen = bridge_name
        [[[zigbeechannel]]]
            type = num
            hue_listen = zigbeechannel
        [[[mac]]]
            type = str
            hue_listen = mac
        [[[dhcp]]]
            type = bool
            hue_listen = dhcp
        [[[ipaddress]]]
            type = str
            hue_listen = ipaddress
        [[[netmask]]]
            type = str
            hue_listen = netmask
        [[[gateway]]]
            type = str
            hue_listen = gateway
        [[[utc]]]
            type = str
            hue_listen = UTC
        [[[localtime]]]
            type = str
            hue_listen = localtime
        [[[timezone]]]
            type = str
            hue_listen = timezone
        [[[whitelist]]]
            type = dict
            hue_listen = whitelist
        [[[bridge_swversion]]]
            type = str
            hue_listen = bridge_swversion
        [[[apiversion]]]
            type = str
            hue_listen = apiversion
        [[[swupdate]]]
            type = dict
            hue_listen = swupdate
        [[[linkbutton]]]
            type = bool
            hue_listen = linkbutton
        [[[portalservices]]]
            type = bool
            hue_listen = portalservices
        [[[portalconnection]]]
            type = str
            hue_listen = portalconnection
        [[[portalstate]]]
            type = dict
            hue_listen = portalstate
        [[[power]]]
            type = bool
            hue_send = on
            hue_listen = on
            knx_dpt = 1
            knx_cache = 8/0/1
        [[[reachable]]]
            type = bool
            hue_listen = reachable
        [[[ct]]]
            type = num
            hue_send = ct
            hue_listen = ct
        [[[scene]]]
            type = str
            hue_send = scene
            enforce_updates = true
        [[[bri]]]
            type = num
            cache = on
            hue_send = bri
            hue_listen = bri
            hue_transitionTime = 0.2
            [[[[dim]]]]
                type = list
                knx_dpt = 3
                knx_listen = 8/0/2
                hue_dim_max = 255
                hue_dim_step = 10
                hue_dim_time = 0.2
        [[[sat]]]
            type = num
            cache = on
            hue_send = sat
            hue_listen = sat
        [[[col_r]]]
            type = num
            cache = on
            hue_send = col_r
        [[[col_g]]]
            type = num
            cache = on
            hue_send = col_g
        [[[col_b]]]
            type = num
            cache = on
            hue_send = col_b
        [[[hue]]]
            type = num
            cache = on
            hue_send = hue
            hue_listen = hue
            hue_transitionTime = 0.2
            [[[[dim]]]]
                type = list
                knx_dpt = 3
                knx_listen = 8/0/12
                hue_dim_max = 65535
                hue_dim_step = 2000
                hue_dim_time = 0.2
        [[[effect]]]
            type = str
            hue_send = effect
            hue_listen = effect
        [[[alert]]]
            type = str
            hue_send = alert
            hue_listen = alert
        [[[modeltype]]]
            type = str
            hue_listen = type
        [[[lampname]]]
            type = str
            hue_listen = name
        [[[modelid]]]
            type = str
            hue_listen = modelid
        [[[swversion]]]
            type = str
            hue_listen = swversion

Please note that knx_cache is wrong in the old example for [[[dim]]], the right setting is knx_listen

logic.conf

No logic attributes.

Methodes

get_config()

Drops the list of stored scenes in the bridge. Parameter the bridge id as string !

sh.hue.get_config(hue_bridge_id)

authorizeuser()

Authorizes the user configured by hue_user config property. You have to press the link button.

sh.hue.authorizeuser()
You can’t perform that action at this time.