View Assist device configuration

View Assist (VA) 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.

NOTE This page is under alpha testing review. This information is subject to change. You have been warned

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-view_livingroom
      state: ""
      attributes:
        type: view_audio
        mic_device: "sensor.streamassist-view_livingroom_stt"
        mediaplayer_device: "media_player.browsermod-view_livingroom"
        display_device: "sensor.browsermod-view_livingroom_browser_path"
        timer_device: "timer.viewassist-view_livingroom"
        mode: "normal"
        view_timeout: "20"
        title: ""
        message: ""
        message_font_size: "3vw"
        image: ""
        timer: ""
        alarm: "idle"
        cycle_view: ""
        do_not_disturb: false

Definitions:

• name: Device name (eg AssistSat_ViewLR = Assist Satellite: View Living Room)
• state: Required

User defined:

• 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

Default values (do not change)

• mode: Used to control actions based on conditions (current modes "normal", "music", "night", "hold", "cycle". Default "normal")
• view_timeout: Amount of time (seconds) before switching views as controlled by mode (Default 20 seconds)
• 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-view_livingroom) must be created for each VA satellite of type "view_audio" or "view_only".