Skip to content
You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
You are viewing the article in preview mode. It is not live at the moment.

⚠️  JADConfig will reach End of Support on January 1, 2027. View the official notice!   ⚠️

Configure Video and Audio on Ultra Series Wallplate Encoders (717WP2 and 718WP4)

Last updated: Nov 03, 2026

Overview

Configure HDMI and VGA selection, startup behavior, and audio on the Ultra Series UL-717WP2 and UL-718WP4 Wallplate Encoders. These models were previously identified as VBS-HDIP-717WP2 and VBS-HDIP-718WP4.

  • 717WP2: 2-gang; HDMI, VGA, Line-In, Micro USB, source switch, and PoE network connection.
  • 718WP4: 4-gang; adds Mic-In, HDMI out, Stereo Out, and RS232 with null modem.

These instructions apply to these two models on the latest firmware. Both models support the same CLI audio-selection settings, live io_select commands, and justOS API settings and commands. Mic-In and Stereo Out controls apply to the 718WP4 hardware.

Before You Begin

  1. Identify the Encoder model and IP address.
  2. For CLI settings, open the webUI CLI or connect through Telnet on TCP port 23.
  3. Record the existing settings before changing them. Commands and values are case-sensitive.

See Startup Settings for general CLI syntax. The POST commands below are justOS API commands and can be sent through either the CLI or HTTP. For HTTP access, see the justOS HTTP API overview.

Configure Startup Behavior

Reboot required: Save startup changes and reboot to apply them. Rebooting interrupts the Encoder output.

Apply and Verify a Setting

Execute each command individually in the webUI CLI. Replace bracketed placeholders with the required parameter and value; omit the brackets.

  1. Read the existing value: astparam g [parameter].
  2. Execute the desired setting command from the tables below.
  3. Save: astparam save.
  4. Restart: reboot.
  5. Reconnect, read the value again, and test the resulting behavior.

For other startup-command syntax, see Startup Settings.

Choose the Video Switching Method

Applies to both models. Save and reboot after executing one setting command.

Method Behavior Setting Command
Front switch Default. Select HDMI or VGA using the physical switch. astparam s v_input_select auto
Auto-detection Keep the oldest connected source active. Switch to the remaining source when the active source disconnects. astparam s v_input_select detect_sync
Command control Disable front-switch and disconnect-based switching. Select video with a live command. astparam s v_input_select fixed

717WP2 front panel with VGA, HDMI, Line-In, USB, and source switch

Auto-Detection Behavior

  • Auto-detection keeps the oldest connected source active. Connecting a newer source does not interrupt it.
  • If HDMI is active and VGA is connected, HDMI remains active.
  • Disconnecting the active HDMI source switches to VGA. Reconnecting HDMI does not switch back: VGA is now the oldest connected source.
  • Moving the physical switch overrides auto-detection.

To restore front-switch selection, execute astparam s v_input_select auto, then save and reboot.

Choose the Startup Video Input

Applies to both models. Choose the startup input separately from the switching method, then save and reboot.

  • HDMI: astparam s v_type 2
  • VGA: astparam s v_type 0
  • Restore startup selection from the physical switch: astparam s v_type

Startup Audio Selection

Applies to both models. Configure audio selection using the CLI settings below or the justOS API settings. The default, auto_2, follows video selection: HDMI audio with HDMI video, or Line-In audio with VGA video. Choose a behavior below, then save and reboot.

Setting Command Behavior
astparam s a_io_select hdmi Always use HDMI audio, including when VGA video is selected.
astparam s a_io_select analog Always use Line-In audio.
astparam s a_io_select auto With HDMI video, use Line-In when connected; otherwise use HDMI audio. With VGA video, use Line-In.
astparam s a_io_select auto_1 Use Line-In when connected; otherwise use HDMI audio, regardless of the selected video input.
astparam s a_io_select auto_2 Default. Follow video selection: HDMI audio for HDMI video; Line-In audio for VGA video.

Change Inputs During Operation

Commands change behavior during operation and do not persist after a reboot. Only saved settings persist. To configure startup behavior, use the settings described above.

Select HDMI or VGA Video

Execute through the CLI on either model:

  • HDMI: e e_v_input_digital
  • VGA: e e_v_input_analog

This selection does not persist after a reboot. Configure v_type separately when a specific startup input is required.

Live Audio Selection with io_select

Applies to both models. Execute through Telnet. These commands override startup audio selection immediately and do not persist through reboot.

  • HDMI audio: echo hdmi > /sys/devices/platform/1500_i2s/io_select
  • Line-In audio: echo analog > /sys/devices/platform/1500_i2s/io_select

Audio Input Controls with the justOS API

Both models support justOS API audio controls through the CLI or HTTP. Use the HDMI and Line-In controls for either model. Mic-In controls apply to the 718WP4. Commands change the current operation; use justOS API settings when the change must persist after a reboot.

For example, to distribute only HDMI audio, execute these commands individually in the Encoder CLI:

  1. Enable HDMI audio: POST /command/audio/dsp/hdmi on.
  2. Mute Line-In audio: POST /command/audio/dsp/line mute.
  3. On the 718WP4, mute Mic-In audio: POST /command/audio/dsp/mic mute.

The final value, on, enables an input; mute mutes it. These commands take effect immediately and do not persist after a reboot.

Input Enable Mute
HDMI POST /command/audio/dsp/hdmi on POST /command/audio/dsp/hdmi mute
Line-In POST /command/audio/dsp/line on POST /command/audio/dsp/line mute
Mic-In (718WP4) POST /command/audio/dsp/mic on POST /command/audio/dsp/mic mute

718WP4 Stereo Out

Replace $A with the desired value.

  • Delay: POST /command/audio/stereo/delay $A, where $A is 0 to 175 milliseconds.
  • Volume: POST /command/audio/stereo/volume $A, where $A is 0 (lowest) to 11 (highest).

Verify Operation

  1. Test HDMI and VGA selection using the configured method.
  2. For auto-detection, connect a second source and confirm the active source stays displayed. Disconnect the active source and confirm the changeover. Reconnect it and confirm the remaining source stays displayed.
  3. Confirm the intended audio input. On either model, test with Line-In connected and disconnected when using an automatic audio mode.
  4. Reboot after saving startup changes and confirm the intended startup behavior.