Bang & Olufsen ControlLink
This driver adds integration with the new B&O ControlLink AV products. All the products are displayed as BeoLiving Intelligence RENDERER resources.
System connection status
System connection status is shown on the BLI’s web interface, each color represents the system connection state:
- Green: the connection to all of your resources is working as expected.
- Yellow: not every resource is connected, please check your network and settings.
- Red: there is a system error.
Resources
Resources are automatically discovered on the network and can be added to Zones either using the iOS app or in the Resources tab of the web interface by clicking on “Show discovered resources”.
Available inputs vary depending on the ControlLink product, they can be found in the “Interfaces” tab under “AV Products”, where they can be hidden in the app. Every ControlLink product offers the B&O NetRadio input, where radios all over the world can be found.
The resource states include the selected input, the playing state (play, pause etc.), volume information, and information about what is currently playing such as name, artist, album and artwork.
TV resources can be configured to show the BLI Home Control panel. This configuration is done automatically by the BLI once a TV is added to any zone, and only if the TV’s Home Control configuration is not yet set. For overwriting this configuration, you can go to the “Interfaces” tab, select the device under “AV Products” and check/uncheck the Home control owner flag.
Commands:
- SEND_DIGIT
- Send a digit key
- LEFT
- Cursor command LEFT
- UP
- Cursor command UP
- RIGHT
- Cursor command RIGHT
- DOWN
- Cursor command DOWN
- ENTER
- Cursor command ENTER
- EXIT
- Send an exit command
- RETURN
- Send a return command
- SET_VOLUME
- Set the volume to a given level
- VOLUME_UP
- Increase the volume
- VOLUME_DOWN
- Decrease the volume
- SET_MUTE
- Enable or disable mute
- SET_DEFAULT_VOLUME
- Set the default volume, which the product will use on startup
- UNLINK
- Unlink from the ongoing multiroom experience
- LINK
- Perform a link to a Multiroom experience
- JOIN
- Join the first Multiroom experience found (touch to join)
- SELECT_INPUT
- Select an input (or source)
- TURN_ON
- Turn on the product
- STANDBY
- Turn off the audio product
- ALL_STANDBY
- Turn off all the audio products of the network
- CHANNEL_UP
- Send channel up command
- CHANNEL_DOWN
- Send channel down command
- RED
- Simulate the red key press
- GREEN
- Simulate the green key press
- YELLOW
- Simulate the yellow key press
- BLUE
- Simulate the blue key press
- PLAY
- Play command
- PAUSE
- Pause command
- STOP
- Stop command
- NEXT
- Next track command
- PREV
- Previous track command
- SET_CONTENT_ID
- Select the content to play from a content provider (use it with beoCloud:netRadio for radio selection)
- SET_INDEX
- Change the playing item from the playqueue by number
- SET_SHUFFLE
- Set the playqueue to shuffle or not
- SET_REPEAT
- Change the playqueue repeat mode policy (repeat all, current track, none)
- ADD_ITEM
- Add an item to the playqueue for a given provider and id. Requires the content metadata like artist, name and so on
- REMOVE_ITEM
- Remove an item from the playqueue
- MOVE_ITEM
- Move an item in the playqueue
- CLEAR
- Clear the playqueue
- AUDIO_OVERLAY_URI
- Play an audio from a URL, overlayed to whatever is playing and at the selected volume
- AUDIO_OVERLAY_TEXT
- Speak the text as overlay content. Currently, 100 unique TTS messages can be generated a day and generated messages are cached for 24 hours
- AUDIO_OVERLAY_USB
- Play an audio from a USB drive connected to the B&O speaker, overlayed to whatever is playing and at the selected volume
- HOME_CONTROL
- Request a TV to open the HOME CONTROL panel
- CUSTOM_COMMAND
- Send a custom command, each product may provide different custom commands
- _MOVE_STAND
- Move the stand position to a defined angle
- _SET_SOUND_LISTENING_MODE
- Select the listening mode
- _SET_SPEAKER_GROUP
- Set the current speaker group
- _SET_LISTENING_POSITION
- Set the listening position
- _TRIGGER_SCENE
- Trigger a specific scene
- _PRESET
- Trigger a specific preset
- _MOVE_CURTAIN
- Move the curtain to the specified position
Connecting to BeoCloud
A BeoCloud connection is needed in order to use B&O NetRadio, and requires signing into the BeoCloud account.
A connection can be established from the BLI on the “ControlLink” system in the “Systems” tab, or directly from the BeoLiving application in Settings->YOUR-BLI->Device Settings->BeoCloud.
Both means will prompt the user for a pin, which can be retrieved from the Bang & Olufsen application in Settings->Integrations, where a code with the format “XXX-XXX-XXX” can be created.
Once the BeoCloud account is linked with the BLI, all of the NetRadio content will be available.
Product Group
The ControlLink system allows you to make groups of ControlLink and NetworkLink products. By defining one product as the Main product, the rest of the group will follow the behavior of this product in terms of volume, source selection, and standby mode.
The Product Group’s configuration is shown under Systems. When you select the ControlLink system, the configured product groups will be listed below, with options for editing the existing groups or adding new ones. ControlLink products can only form part of one group, so you won’t be able to add a product to a group if it’s already in another.
For a new group to be created you need to select a Main product for the group and at least one Follower, if not, the group won’t be created.
A group can also be created from the BeoLiving application in Settings->YOUR-BLI->Device Settings->Group products where you should first choose a master and then the followers.
Changelog
v0.3 | 2022/10/31
- Documentation updates.
v0.2 | 2021/04/28
- Initial version.
Please, report any issue with this driver to: support+drivers@khimo.com