View Assist device configuration

View Assist devices are created using custom template devices. These devices contain important information like browser mod ID, media_player device, microphone device, and timer device. Additionally this configuration sets the attributes needed for different modes, data to displayed and more. These attributes are consumed by control automations and display views.

Satellite Custom Device Configuration

Here is an example and definitions for the View Assist devices. Each additional device would have a separate configuration. This allows for setting properties for each device that may have a unique condition for that device (eg night mode for a device in a dark room). These devices are set up in YAML as a template device in configuration.yaml. Do not include the 'template:' line more than once when setting up additional devices. The Home Assistant service must be restarted any time a change is made to the configuration.yaml file.

template:
  - sensor:
    - name: ViewAssist-livingroom
      state: ""
      attributes:
        type: view_audio
        mic_device: "sensor.streamassist-livingroom_stt"
        mediaplayer_device: "media_player.browsermod-livingroom"
        display_device: "sensor.browsermod-livingroom_browser_path"
        timer_device: "timer.viewassist-livingroom"
        view_timeout: "20"
        mode: "normal"
        title: ""
        message: ""
        message_font_size: "3vw"
        image: ""
        timer: ""
        alarm: "idle"
        cycle_view: ""
        do_not_disturb: false

Definitions:

User defined:

• name: Device name (eg ViewAssist-livingroom)
• type: Used to determine a/v capabilities ("view_audio", "view_only", "audio_only". Default "view_audio")
• mic_device: Used to assign microphone to View Assist device
• mediaplayer_device: Used to assign the media player used for View Assist audio playback
• timer_device: Used to assign the timer helper device used for screen time outs
• display_device: Used to determine the correct Browser Mod instance to use for display
• view_timeout: Amount of time (seconds) before switching views as controlled by mode (Default 20 seconds)

Default values (do not change)

• state: Required
• mode: Used to control actions based on conditions (current modes "normal", "music", "night", "hold", "cycle". Default "normal")
• title: Text for displaying title of multiuse cards
• message: Blob text for displaying to informational views
• message_font_size: Text containing size of font to be used in message for informational views (Default "3vw")
• image: Text containing image path for display on informational views
• timer: Array containing timer helpers associated with all Assist devices Planned
• alarm: Used to trigger alarm sound and display (values "idle", "alarming". Default "idle")
• cycle_view: List containing view names to cycle through using view_timeout when in "cycle" mode (must be in Python list format eg "[ 'weather', 'frontcamera' ]")
• dnd: Do not disturb mode. Do not broadcast or play sounds when in DND mode (Default "false")

A timer helper device (eg timer.viewassist-livingroom) must be created for each VA satellite of type "view_audio" or "view_only".

A group containing all View Assist Satellite devices (eg group.viewassist_satellites) must be created and all VA Satellite devices must be added to this group. This group must be added to the configuration.yaml file similar to the View Assist device configuration above.

group:
  viewassist_satellites:
    name: View Assist Satellites
    entities:
      - ViewAssist-livingroom
      - ViewAssist-kitchen
      - ViewAssist-masterbedroom

The group configuration must be reloaded after any edits by way of Home Assistant restart.

Example configuration

Here is the example configuration. You can copy paste this into your configuration.yaml file, modify the values to those of your satellite sensors and timer, save the file and then restart Home Assistant for the configuration to be loaded. You will repeat the sensor definition for any additional satellites. All View Assist satellites must be added to the View Assist Satellite group as described above.

Example device configuration