Clipsal C-Bus User's Guide download pdf (Page 27)

cbus Documentation, Release 0.1-dev

• locations: A dictionary of locations, with the key representing the ID of the location, and the value repre-

senting the name to display. Location 0 must exist, and is shown by default.

• widgets: A dictionary of group addresses describing what widgets to display.

– The key is the group address to control.

– The option name sets the name to display in the UI.

– The option type selects the type of widget to use:

switch displays a simple switch

slider displays a slider.

switch_slider displays both a switch and a slider.

– The option locations is a dictionary which sets the locations where the widget should be displayed

(indicated by the key), and the order in which it should be shown (indicated by the value, higher values are

shown lower in the list).

Note: By default, constraints shown here about widget types are not enforced on the server side, and any group

address may be sent commands.

If there are group addresses you wish to restrict access to, use the -a option to sage to only allow certain group

addresses and deny all others (whitelist), or -d to deny certain group addresses and allow all others (blacklist).

5.3.2 Other options

sage‘s daemon also supports some other options:

• -H and -p control the listening IP address and port that sage uses.

• -W turns off sage’s own internal web server for static ﬁles, and makes the WebSockets resource the root of the

web server. Normally, the WebSockets server is located at /saged.

• -r allows you to specify the root directory of the web server for static resources, if -W is not speciﬁed.

• -a allows specifying a comma-seperated list of group addresses to allow control of through sage, and deny all

others.

• -d allows specifying a comma-seperated list of group addresses to deny control of through sage, and allow all

others.

• -S connects to cdbusd through the D-Bus Session Bus rather than the System Bus. This is useful for unprivi-

leged testing.

• -P allows you to specify a .htpasswd-format password ﬁle for saged to authenticate users against. This does

not work in Chrome due to a bug (#123862).

• -R allows you to set the HTTP Basic authentication realm (when using -P).

5.3. sage 23

1 2 ... 22 23 24 25 26 27 28 29 30 31 32 ... 59 60

No comments

Clipsal C-Bus User's Guide Page 27