Home
Welcome to the teufel_raumfeld wiki!
- One or more physical speaker are statically grouped to a "room".
- Rooms can be dynamically grouped to a "zone" aka speaker group. Each speaker group provides a media renderer to play audio.
- A room can only be member of one speaker group at the same time.
- While rooms technically have a media renderer, it is not foreseen to use them directly. Instead a speaker group with only one room is created.
- Device and speaker group management is implemented via a web service.
- Media playing is implemented via DLNA.
- sensor entities are created for each physical speaker. Speaker entities do only expose related information and are not involved in media playing. E.g. "Speaker: Dining area".
- media_player entities are created for all rooms and the at the time of configuration (reload) existing speaker groups. E.g. "Room: ['Living room'] and "Group: ['Living room', 'Kitchen'].
- No longer existing speaker group entities remain valid and turn to the state "off". Turning them on will lead to their recreation for use.
- A single update thread is Long polling the various web service interfaces.
- Whenever an update is triggered by the web service, e.g. after crating or updating a speaker group, an internal data structure shared with all media_player instances is updated accordingly.
- Events are fired for each by the web service triggered update.
the recommended installation method is via HACS.
The integration connects to the host server of a Raumfeld Multiroom system. This host has to be entered once when the integration is added, respectively configured:
After the configuration is completed, device entities are created for all speakers and media_player entities are created for all rooms and currently existing speaker groups.
The general usage of a media_player entity is described in the documentation of the Media Player integration. It can also be used with compatible frontend cards like the Media Control Card.
- teufel_raumfeld.snapshot, to remember media, position, volume and mute status for later restore.
- teufel_raumfeld.restore, restore the state of the last snapshot.
- teufel_raumfeld.group, to create a new speaker group.
- teufel_raumfeld.abs_volume_set, to the volume of all rooms in a speaker group to the same level.
- teufel_raumfeld.set_power_state, to put speakers of a room into automatic/manual stand-by or to awaken them from stand-by.
- teufel_raumfeld.play_sound, to play the system sound "Success" or "Failure", resp. mixing it into the currently played media.
