Project Assistent Help
 

Logic Module for controlling BluOS-Streaming-Devices

Introduction

The Gira logic module provides control of BluOS streaming devices via the Gira X1 Visualisation Server. This allows control and feedback via the Gira Smart Home app and G1 touchscreen, as well as more limited control from any KNX enabled keypad. 

The logic module is used to control BluOS enabled audio devices from the likes of Bluesound and NAD. 

In addition to operating the devices via the "Audio control with title picture" visualization object provided by the X1, it is also possible to operate them using a KNX push-button sensor. It is also possible to integrate the music control in scenes so that the devices become part of the building bus system, which is controlled by a KNX system. 

The following features are supported:

  • Now playing information
  • Playback & Volume/Mute controls
  • Source selection (including analog, optical, coaxial and HDMI inputs)
  • Preset selection
  • Player grouping

Equipment Setup

The BluOS Controller app (iOS or Android) must be used to initially configure the player. Using BluOS Controller, you will set up the player name, configure inputs and adjust audio settings. You also use BluOS Controller to login to streaming music services, add network music libraries, create presets etc. 

The logic module does not support device discovery. The BluOS devices must be configured to a static IP address, which is then entered in the parameters of the logic module.  

For all BluOS players, the port is set to 11000 by default. For the NAD CI580v2 4 zone player, this is different and each zone has its own port number on the same IP address. Zone 1 is Port 11000, zone 2 is Port 110010, Zone 3 is Port 11020, Zone 4 is Port 11030.  

 

Parameter

Designation

Description

IP-Adresse

The address of the BluOS system.

Port

The port of the BluOS system. Default is 11000 and should only changed when using NAD CI580 in slave-mode.

Slave System

This switch can be used to reduce the logic module to the inputs and outputs that a BluOS player makes available as a group member ( slave). If the player is only to work optionally in a group, this mode should remain switched off . Group formation is also possible if several client systems are assigned to the logic module.

Count

Sets the number of devices that can be in a group with this player (maximum 16). If clients are defined, the logic module releases the inputs for grouping or ungrouping

Slave IP-Address n

If clients have been specified via the "Count" parameter, the "IP address" for the client "n" can be entered here

Slave Port n

If clients have been specified via the "Count" parameter, the "port" for the client "n" can be entered here

Volume-Mode

The volume mode determines how the volume settings inputs work. In addition to specifying the absolute volume , the logic module also supports the gradual increase or decrease of the volume, as well as controlling the volume via a KNX 4-bit dimming data point.

Telegram Repetition

(Only visible if the volume mode is set to "Dimming object DTP3.x")

KNX push-button sensors can be configured so that they cyclically send telegrams during the dimming process, i.e ., as long as the button is pressed. If the push button sensor is operated accordingly, the telegram repetition must be switched on.

It is recommended not to switch on the telegram repetition . The definition of the KNX data point 3.x allows a start telegram to be sent at the beginning of the dimming process and a stop telegram to be sent at the end of the dimming process . This reduces unnecessary telegram load on the KNX bus.

Skip Mode

Skip mode determines whether the track is to be controlled by one input or by two separate inputs. If only one input is used, the jump back is via a "0" telegram, and the jump to the next track is via a "1" telegram.

Play Mode

The play/pause mode determines whether switching between play and pause should be controlled via one input or two separate inputs. If only one input is used, a "0" telegram triggers the pause function, a "1" telegram triggers the play function.

Inputs

Designation

Port type

Description

Volume absolute

Percent

"0%..100%" sets the volume on the player

Volume up/down

Binary

(Visible only when the Volume Mode parameter is set to Use 1-input.)

0 - decreases the volume by 2%

1 - increases the volume by 2%

Decrease Volume

Binary

(Visible only when the Volume Mode parameter is set to Use 2-input.)

Reduces volume by 2%.

Increase Volume

Binary

(Visible only when the Volume Mode parameter is set to Use 2-input.)

Increases volume by 2%

Volume Relatively

4-Bit

(Visible only when the Volume Mode parameter is set to Use 1-input.)

Changes the volume via a KNX dimming telegram. The specifications for the increment are supplied via the settings of the KNX push button sensor.

Mute

Binary

0 - mutes

1 - unmutes

Play/Pause

Binary

(Visible only when the Play Mode parameter is set to Use 1-input.)

0 - Set to pause.

1 - Set to play.

Play

Binary

(Visible only when the Play Mode parameter is set to Use 2-input2.)

Set to play.

Pause

Binary

(Visible only when the Play Mode parameter is set to Use 2-input.)

Set to pause.

Stop

Binary

Set to stop.

Skip title

Binary

(Visible only when the Skip Mode parameter is set to Use 1-input.)

0 - Skip to previous title.

1 - Skip to next title.

Previous Titel

Binary

(Visible only when the Skip Mode parameter is set to Use 2-input.)

Skip to previous title

Next Titel

Binary

(Visible only when the Skip Mode parameter is set to Use 2-input.)

Skip to next title

Shuffle

Binary

0 - Turns off Shuffle function.

1 - Turns Shuffle on.

Repeat

Byte

0 - Switches off repeating the playlist. (with DTP 1.x and DPT 5.x)

1 - Repeats the entire playlist. (with DTP 1.x and DPT 5.x)

2 - Repeats the current track. (only with DPT 5.x)

Preset

Byte

Selects the preset with the corresponding numeric index.

Preset-Skip

Binary

0 - Selects the previous preset.

1 - Selects the next preset.

Group Players

Byte

Sending the device number 1..16 includes the device that is defined under the slave parameters in the group.

Remove Player from a group

Byte

Sending the device number 1..16 takes the device that is defined under the slave parameters is released from the group and works independently again.

Outputs

Designation

Port type

Description

Artist

String

Returns Artist Name as text.

Titel

String

Returns Track Title as text.

Album

String

Returns Album Title as text.

Titelbild

String

Returns the URL under which the Album Art can be loaded from.

System connected

Binary

Returns the status of whether the player is connected to the logic module.

Volume-State

Percent

Provides the volume in the range 0% to 100%

Mute-State

Binary

Returns the mute state.

0 - The device is not muted

1 - The device is muted

Play-State

Binary

Returns the play state.

0 - The device is stopped or paused

1 - The device is in playback mode

Pause-State

Binary

Returns the pause state.

0 - The device is in playback mode or playback is stopped

1 - The device is in pause mode

Stop-State

Binary

Resturns the stop state.

0 - The player is in play or pause mode

1 - Playback is stopped

Play/Pause-State

Binary

Resturns the the state playing or pause of the device.

0 - Device is in pause mode

1 - Device is in play mode

Shuffle-State

Binary

Returns the suffle-state of the device.

0 - Random playback is switched off

1 - Random playback is active

Repeat-State

Byte

Returns the repeat-state of the device.

0 - Repeat is off

1 - All titles in the playlist are repeated

2 - Only the track being played is repeated

Status Preset

Byte

Returns the number of the selected preset.

Status gruppiert

Byte

This returns whether the device entered as the main device (master) is in a group.

0 - The device is not in any group

1 - The device is in a group

 

Notes on connecting the "Audio Control" visualization object.

Use of KNX objects

If the player is to be controlled via the KNX and the visualization of the X1 is to be used, then group address data points should be used to link the logic module with the visualization object.

Parameters of the logic module

The following parameter settings are to be selected.
  • Playback mode: 1 input (pause, play)
  • Skip mode: 1 input (0=previous track, 1=next track)

Allocation of the data points in the visualization object

  • "Play" with the data point that is assigned to the "Play/Pause" input of the logic module
  • "Previous track" and "Next track" with the data point that is assigned to the skip input of the logic module

Allocation of listening group addresses

Since the visualization object only works with one data point per function, the status information of the following functions should be assigned via the assignment of the listening address.
  • "Volume Absolute" is synchronized with the listening address of: "Volume Status"
  • "Mute" is synchronized via the listening address of: "Mute-Status"
  • "Play/Pause" is synchronized via the listening address of: "Play/Pause Status"

Use of internal objects

If only the visualization of the X1 is to be used, it is sufficient to use variable data points for linking the logic module with the visualization object. In this case, the same data point should be used for the following inputs and outputs of the logic module:
  • "Volume Absolute" and "Volume Status"
  • "Mute" and "Mute Status"
  • "Play/Pause" and "Play/Pause Status".

 

Notes on connecting a KNX push button sensor.

Controlling the volume via the "Volume relative" input can be used with the 4-bit data type for dimming.

The push button sensor should be configured in such a way that the dimming telegram sends a stop telegram and there is no telegram repetition. It is recommended to set the increment to 3%. Every 500ms, the block sends the command to increase or decrease the volume by the set percentage to the device. The dimming switching function of the push button sensor should be linked to the Volume Up/Down input.

With these specifications, a rocker of the push button sensor is given the function that the volume is changed step by step with a short press of the button and continuously with a long press of the button.