Clipsal C-Bus Betriebsanweisung PDF herunterladen (Seite 35)

CHAPTER 7

D-Bus Client API

The recommended way to interact with libcbus is through cdbusd and it’s D-Bus API.

It allows many applications, written in any language with D-Bus bindings to interact with the network with one PCI.

It abstracts away the majority of C-Bus protocol details and provides D-Bus methods and events for interacting with

the network.

This document describes the interface au.id.micolous.cbus.CBusInterface.

Included in this document is examples of syntax for use with mdbus2, a command-line D-Bus testing tool. Types are

given in D-Bus notation.

lighting_group_on(group_addr)

Turns on lights for the given group addresses.

Parameters group_addr (ay) – Group addresses to turn on lights for, up to 9.

Returns Single-byte string with code for the conﬁrmation event.

Return type s

# Turn on lights for GA 1 and 2.

mdbus2 -s au.id.micolous.cbus.CBusService / au.id.micolous.cbus.CBusInterface.lighting_group_on ’(1, 2)’

lighting_group_off(group_addr)

Turns off lights for the given group addresses.

Parameters group_addr (ay) – Group addresses to turn off lights for, up to 9.

Returns Single-byte string with code for the conﬁrmation event.

Return type s

# Turn off lights for GA 3 and 4.

mdbus2 -s au.id.micolous.cbus.CBusService / au.id.micolous.cbus.CBusInterface.lighting_group_off ’(3, 4)’

lighting_group_ramp(group_addr, duration, level)

Ramps (fades) a group address to a speciﬁed lighting level.

Note: C-Bus only supports a limited number of fade durations, in decreasing accuracy up to 17 minutes (1020

seconds). Durations longer than this will throw an error.

A duration of 0 will ramp “instantly” to the given level.

Parameters

• group_addr (y) – The group address to ramp.

• duration (n) – Duration, in seconds, that the ramp should occur over.

1 2 ... 30 31 32 33 34 35 36 37 38 39 40 ... 59 60

Keine Kommentare

Clipsal C-Bus Betriebsanweisung Seite 35