You are using an unsupported browser. Please update your browser to the latest version on or before July 31, 2020.
close
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!   ⚠️

Home > Device Configuration > How to Name a Device (Omega, Ultra, and MaxColor Series)
How to Name a Device (Omega, Ultra, and MaxColor Series)
print icon

Overview

Omega Series, Ultra Series, and MaxColor Series devices can be assigned a custom device name. Naming devices makes it easier to identify individual Encoders and Decoders when configuring, accessing, or managing a system.

When building a new system with Advanced Matrix Programmer (AMP), device names can be assigned during the Build New workflow. Devices can also be named or renamed using the webUI, CLI, or HTTP API.

Method Applicable Series Recommended Use
AMP Omega, Ultra, and MaxColor Series Naming devices while configuring a new AMP system
webUI Omega, Ultra, and MaxColor Series Manual configuration of an individual device
CLI Omega, Ultra, and MaxColor Series Command-line configuration using Telnet or the RS232 debug port
HTTP API Omega, Ultra, and MaxColor Series Automation, scripting, and control-system integration

Name Devices Using AMP

During the Build New workflow, AMP provides the option to assign a name to each Encoder and Decoder. Naming devices during the initial system configuration helps identify them throughout the AMP project.

For the complete system-configuration workflow, see Download AMP and Configure an Omega, Ultra, and MaxColor Series System.

Set the Device Name Using the webUI

  1. Open the device webUI.

    See How to Open the webUI of a Device (Omega, Ultra, and MaxColor Series) for access instructions.

  2. Select Device from the navigation menu.

  3. In the Device Settings card, select the current Device Name.

  4. Enter the name to assign to the device, and then select Apply.

  5. In the Device Commands card, select Save to save the pending change.

  6. Select Reboot to restart the device and apply the saved name.

Device Name setting in the Omega, Ultra, and MaxColor Series webUI

Important: Rebooting the device temporarily interrupts its operation.

Set the Device Name Using the CLI

  1. Access the device CLI using Telnet or the RS232 debug port.

    See How to Telnet to a Device (Omega, Ultra, and MaxColor Series) for Telnet instructions.

  2. Enter the following command, replacing DEVICE_NAME with the name to assign to the device:

    astparam s webname "DEVICE_NAME";astparam save;sleep 1;reboot
  3. Allow the device to reboot, and then refresh or reopen the webUI.

Important: This command immediately reboots the device and temporarily interrupts its operation.

Note: Enclose names containing spaces in quotation marks.

For more information about startup settings, see CLI Settings for Omega & Ultra Series Devices.

Example

The following command assigns the device name Master Bedroom:

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

HTTP API

Device names can also be viewed and configured using the justOS HTTP API. See justOS HTTP API Overview (Omega, Ultra, and MaxColor Series) for firmware requirements, access instructions, and complete API documentation.

scroll to top icon