Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for Bang & Olufsen device triggers #34924

Draft
wants to merge 4 commits into
base: next
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions source/_integrations/bang_olufsen.markdown
Original file line number Diff line number Diff line change
Expand Up @@ -250,6 +250,16 @@ data:

WebSocket notifications received from the device are fired as events in Home Assistant. These can be received by listening to `bang_olufsen_websocket_event` event types, where `device_id` or `serial_number` can be used to differentiate devices.


### Device triggers
Device triggers for most of the physical controls are available for all devices.

Device triggers for the [Beoremote One](https://www.bang-olufsen.com/en/dk/accessories/beoremote-one) are supported. Enter the submenus __Control__ or __Light__ by pressing __Right__ and trigger any of the renamable functions. Additionally, the __Control__ and __Light__ submenus can be entered by pressing __Select__, which will make most of the buttons trigger an event. Each compatible button press will send a __KeyPress__ and a __KeyRelease__ event, and therefore also a __KeyPress__ and a __KeyRelease__ device trigger.

{% tip %}
Enable debug logging to see what IDs are associated with the different functions.
{% endtip %}

### Getting Deezer URIs

To find Deezer playlist, album URIs, and user IDs for Deezer flows, the Deezer website has to be accessed. When navigating to an album, the URL will look something like: <https://www.deezer.com/en/album/ALBUM_ID>, and this needs to be converted to: `album:ALBUM_ID` and the same applies to playlists, which have the format: `playlist:PLAYLIST_ID`.
Expand Down