Overview

Startup settings determine how an Omega Series or Ultra Series device behaves after it boots. They are stored in non-volatile memory and remain active after the device is power cycled.

Most startup settings are configured through the Command Line Interface (CLI) using the astparam utility. This article applies to Omega Series and Ultra Series devices running justOS firmware version B1.0.0 or later.

For commands that change device behavior immediately without requiring a reboot, refer to CLI Commands for Omega & Ultra Series Devices.

Configure Startup Settings

Access the CLI

Connect to the device using either of the following methods:

• Telnet: Connect to the device IP address on TCP port 23.
• RS232 debug port: Connect using a Just Add Power debug cable with these settings:
  • 115200 baud
  • 8 data bits
  • No parity
  • 1 stop bit

If the device IP address is unknown, refer to:

• How to Locate a Device IP Address (Omega, Ultra, and MaxColor Series)
• How to Telnet to a Device (Omega, Ultra, and MaxColor Series)

Command Notation

A command containing variables shows the reusable command structure:

astparam s $parameter $value

A completed example shows the values substituted into the command:

astparam s ip_mode static

Command Reference

Action	Command	Description
View all settings	astparam dump	Display all startup settings and their current values.
View one setting	astparam g $parameter	Display the current value of one setting.
Set a value	astparam s $parameter $value	Assign a value to a setting.
Remove a setting	astparam s $parameter	Remove a setting and restore its default behavior.
Save settings	astparam save	Write the startup settings to permanent storage.
Wait one second	sleep 1	Allow the settings to be written before rebooting.
Reboot	reboot	Restart the device and apply the saved settings.

Standard Workflow

1. View the current setting.
2. Assign the new value.
3. Save the settings.
4. Wait one second.
5. Reboot the device.
6. Reconnect and verify the setting.

Example: Change the IP assignment mode to static.

astparam g ip_mode
astparam s ip_mode static
astparam save
sleep 1
reboot

Chain Commands

Separate commands with a semicolon (;) to execute multiple commands on one line. Include sleep 1 between astparam save and reboot.

astparam s $parameter $value;astparam save;sleep 1;reboot

Settings for All Devices

The settings in this section apply to all Omega Series and Ultra Series Encoders and Decoders.

Network Settings

Setting	Parameter	Value	Behavior
IP assignment mode	ip_mode	autoip	Assign an address in the 169.254.x.x range.
		static	Use a consistent IP address. Also configure ipaddr, netmask, and gatewayip.
		dhcp	Request an IP address from a DHCP server.
IP address	ipaddr	$ip_address	IP address used when ip_mode is set to static.
Subnet mask	netmask	$subnet_mask	Subnet mask used when ip_mode is set to static.
Default gateway	gatewayip	$gateway_address	Default gateway used when ip_mode is set to static.

Configure a Static IP Address

astparam s ip_mode static;astparam s ipaddr $ip_address;astparam s netmask $subnet_mask;astparam s gatewayip $gateway_address;astparam save;sleep 1;reboot

• $ip_address is the static IP address assigned to the device.
• $subnet_mask is the subnet mask for the Device Network.
• $gateway_address is the default gateway address.

Example: Configure the device with IP address 10.0.0.2, subnet mask 255.0.0.0, and default gateway 10.0.0.1.

astparam s ip_mode static;astparam s ipaddr 10.0.0.2;astparam s netmask 255.0.0.0;astparam s gatewayip 10.0.0.1;astparam save;sleep 1;reboot

Device Name

Parameter	Value	Description
webname	$device_name	Assign a descriptive name to the device. Enclose names containing spaces in quotation marks.

astparam s webname "$device_name";astparam save;sleep 1;reboot

Example: Name the device Master Bedroom.

astparam s webname "Master Bedroom";astparam save;sleep 1;reboot

Serial Baud Rate

Configure the RS232 port to communicate with a connected endpoint device.

Parameter	Value	Description	Common Baud Rates
s0_baudrate	$baud_rate-8n1	Set the baud rate. The default configuration is 9600-8n1.	9600 38400 115200

astparam s s0_baudrate $baud_rate-8n1;astparam save;sleep 1;reboot

• $baud_rate is the baud rate required by the connected endpoint device.

Example: Configure the RS232 port for 38400 baud, 8 data bits, no parity, and 1 stop bit.

astparam s s0_baudrate 38400-8n1;astparam save;sleep 1;reboot

Serial Modes

Mode	Communication	Usage	Settings
Passive	One-way	Send serial data into an Encoder and output it from every Decoder watching that Encoder.	soip_type2 y soip_guest_on n
Direct	Two-way with feedback	Connect to TCP port 6752 at the IP address of the device that will output the serial data.	soip_type2 y soip_guest_on y
API	One-way without feedback	Connect to TCP port 23 at the IP address of the device that will output the serial data.	soip_type2 n soip_guest_on y

Example: Enable Direct serial mode.

astparam s soip_type2 y;astparam s soip_guest_on y;astparam save;sleep 1;reboot

USB and Touchscreen Behavior

Parameter	Value	Behavior
no_kmoip	y	Default. Enable touchscreen support. Mouse movement may be less smooth.
	n	Disable touchscreen support. Mouse movement may be smoother.

Flux Capacitor IR Dongle

Parameter	Value	Behavior
flux	v1	Configure the RS232 port for Flux Capacitor Dongle v1.
	v2	Configure the RS232 port for Flux Capacitor Dongle v2.

LED Behavior

The Power and Data LEDs provide diagnostic information about the current device status.

Parameter	Value	Behavior
leds	Not set	Default. Operate the LEDs according to the current device status.
	always_off	Keep both LEDs off.
	only_on_video	Turn on both LEDs when video is present and turn them off when video is absent.

Image Pull

Capture video snapshots on an Encoder or Decoder and make them available to other devices on the network.

Parameter	Value	Behavior
pull_on_boot	n	Default. Disable Image Pull.
	$size_$priority_$frequency	Enable Image Pull using the specified image width, processing priority, and capture frequency.

astparam s pull_on_boot $size_$priority_$frequency;astparam save;sleep 1;reboot

• $size is the image width: 160, 320, or 640.
• $priority is 1 to give Image Pull a lower priority than video.
• $frequency is 0 for 10fps or 1 for 1fps.

Example: Capture a 320-pixel image once per second at a lower priority than video.

astparam s pull_on_boot 320_1_1;astparam save;sleep 1;reboot

Encoder Settings

The settings in this section apply to Omega Series and Ultra Series Encoders.

Audio Handling

Parameter	Value	Behavior	Applicable Encoders
v_rx_drv_option	0	Default. Preserve the source audio sampling rate.	Non-AVP
	2	Default. Convert audio to 48kHz.	AVP
	4	Enable audio services without a video signal.	Non-AVP
	6	Enable audio services without a video signal.	AVP

Bandwidth Control

Reduce Encoder output bandwidth when the network cannot support full-bandwidth video.

Method	Parameter	Value	Behavior
Reduce framerate	v_frame_rate	$frame_rate_value	Preserve the input resolution and set the output framerate to $frame_rate_value/60 of the input framerate. The maximum value is 60.
Reduce resolution	profile	200M	Preserve the input framerate and reduce the resolution to fit within 200Mbps.
		150M	Preserve the input framerate and reduce the resolution to fit within 150Mbps.
		100M	Preserve the input framerate and reduce the resolution to fit within 100Mbps.

HDCP Handling

Parameter	Value	Behavior
v_reject_hdcp	n	Default. Handle HDCP according to the device hardware.
	y	Report the Encoder as an HDCP non-compliant device.
hdcp_always_on	n	Default. Handle HDCP according to the device hardware.
	y	Report the Encoder as HDCP 1.4 compliant regardless of source settings.
hdcp_always_on_22	n	Default. Handle HDCP according to the device hardware.
	y	Report the Encoder as HDCP 2.2 compliant regardless of source settings.

Decoder Settings

The settings in this section apply to Omega Series and Ultra Series Decoders.

DHCP Server

Allow a Decoder to provide IP addresses to third-party devices connected through the Decoder Switchport. The DHCP server assigns addresses from x.x.x.200 through x.x.x.249.

Parameter	Value	Behavior
dhcp_server_enable	n	Default. Disable the DHCP server.
	y	Enable the DHCP server.

HDR Pass-Through

Parameter	Value	Behavior
v_hdmi_hdr_mode	0	Default. Enable HDR pass-through.
	1	Disable HDR pass-through. This may be necessary when an HLG source is connected to a non-HDR display.

HDMI Output When Video Is Lost

Setting	Parameter	Value	Behavior
HDMI output	v_turn_off_screen_on_pwr_save	n	Default. Continue HDMI output and show the debug screen.
		y	Stop HDMI output after video is lost.
Video-loss timeout	v_src_unavailable_timeout	$milliseconds	Set the delay before HDMI output stops. 1000 milliseconds equals one second.

astparam s v_turn_off_screen_on_pwr_save $state;astparam s v_src_unavailable_timeout $milliseconds;astparam save;sleep 1;reboot

• $state is y to stop HDMI output or n to continue showing the debug screen.
• $milliseconds is the delay after video is lost.

Example: Stop HDMI output five seconds after video is lost.

astparam s v_turn_off_screen_on_pwr_save y;astparam s v_src_unavailable_timeout 5000;astparam save;sleep 1;reboot

Debug Screen

Setting	Parameter	Value	Behavior
Diagnostic text	ui_show_text	y	Default. Show diagnostic text on the debug screen.
		n	Hide diagnostic text. This may make troubleshooting more difficult.
Resolution	ui_default_res	640x480@60	Set the debug screen resolution to 480p.
		1280x720@60	Default. Set the debug screen resolution to 720p.
		1920x1080@60	Set the debug screen resolution to 1080p.
		3840x2160@30	Set the debug screen resolution to 2160p.

Model-Specific Settings

UL-718AVP Startup Audio

Enable or mute individual audio paths when a UL-718AVP Encoder starts.

Audio Path	Path Value	State	Behavior
HDMI input	hdmi	on	Enable HDMI input audio at startup.
		mute	Mute HDMI input audio at startup.
Line input	line	on	Enable line input audio at startup.
		mute	Mute line input audio at startup.
Microphone input	mic	on	Enable microphone input audio at startup.
		mute	Mute microphone input audio at startup.

POST /settings/audio/dsp/$audio_path $state

• $audio_path is hdmi, line, or mic.
• $state is on or mute.

Example: Enable the HDMI audio path at startup.

POST /settings/audio/dsp/hdmi on

Ultra Series Wallplate Encoder

Audio Input Selection

Parameter	Value	Behavior
a_io_select	auto_2	Default. Use audio from the active video source.
	auto_1	Use line-in audio when connected. Otherwise, use HDMI audio.
	auto	Use line-in audio when connected. Otherwise, use audio from the active video source.
	analog	Use line-in audio only.
	hdmi	Use HDMI audio only.

Input Switching Behavior

Parameter	Value	Behavior
v_input_select	auto	Default. Use the dipswitch to determine the active input.
	detect_sync	Switch the source when an unplug event is detected.
	fixed	Disable dipswitch and unplug-event switching. Change the source using a runtime command.

Startup Source

Parameter	Value	Behavior
v_type	Not set	Default. Select the dipswitch source at startup.
	0	Select the VGA input at startup.
	2	Select the HDMI input at startup.