Managing the display using RS‑232

You can connect a control system or terminal emulation program on your computer to the display's room control input and remotely select video inputs, change power and sleep states, and get information about the display’s current settings, such as current input source, contrast, and power state.

Display connected to a room control system using an RS-232 cable

Connect an RS-232 cable from the control system or the computer’s serial port to the RS‑232 In connector on the bottom of the display.

Important

Use only a standard RS-232 cable. Do not use a null modem cable. Null modem cables typically have ends of the same type.

Communication structure

Communication consists of a command argument, the property affected, an operator symbol, a value to apply, and a terminating carriage return character (0x0d).

Important

When manually entering commands into a terminal emulation program, commands must be terminated with only a carriage return character (0x0d). If you terminate a command with both a carriage return character (0x0d) and a line feed (0x0a), the command may not be processed, and the command prompt that indicates readiness to receive the next command may not be received.

Notes

The display won’t respond to RS-232 commands when it is in a low power state (soft off). Disable Power saving mode to prevent the display from entering a low power state.
SeePower saving mode
When you first turn on the display, the RS-232 connector operates in a special diagnostics mode instead of control mode, and the display won’t respond to control commands. In addition, the connected control system or terminal emulation program might receive unexpected data characters.
Program a connected control system to ignore the unexpected data characters and only send commands after it receives the command prompt (>).
If you haven’t disabled Power saving mode, you’ll see the unexpected characters every time you turn on the display.

Copy

Correct

>set input=HDMI1

Copy

Incorrect

>set HDMI1

To use the room control system to get information about the display or to adjust display settings, send commands after receiving a command prompt (>), and then wait for the display’s response before sending another command.

Copy

Correct

>get volume
volume=55
>

If you send a command that the room control system doesn’t recognize, you receive an invalid command response.

This example contains an extra space in the volume command.

Copy

Incorrect

>set vol ume=65
invalid cmd=set vol ume=65
>

Notes

Use ASCII formatted commands.
Commands aren’t case-sensitive.
When manually entering commands into a terminal emulation program, review each entry carefully before you press ENTER to send a carriage return (0x0d) to terminate the command.
Don’t send another command until you receive the response and the next command prompt.

To identify the current value of a setting

Use a get command.
This example shows how to get the display’s current volume setting:
Copy
```
>get volume
volume=55
>
```

To assign a value to a setting

Use a set command.
This example sets the volume to 65:
Copy
```
>set volume=65
volume=65
>
```

To increase or decrease the value of a setting

Use the set command to increase or decrease the value by a designated number.
This example increases the volume by 5:
Copy
```
>set volume+5
volume=70
>
```
This example decreases the volume by 15:
Copy
```
>set volume-15
volume=55
>
```

Commands

Get command	Set command	Response
`get powerstate`	`set powerstateValue` Where `Value` is one of the following: `= on` `= ready` Notes If the command returns an “invalid command” message, add spaces around the operator symbol (=). When the screen is in a low power state, it doesn’t respond to any RS-232 commands. Disable Power saving mode to prevent the display from entering a low power state. SeePower saving mode If the display is in UPDATEON or UPDATEREADY state, it might not change power states after it receives the command. See alsoEnergy saving modes	`powerstate=Value` Where `Value` is one of the following: `on` `ready` `updateon` `updateready`
`get input`	`set inputValue` Where `Value` is one of the following: `=OPS` `=OPSCC` `=HDMI1` `=HDMI2` `=HDMI3` `=VGA`	`input=Value` Where `Value` is one of the following: `=OPS` `=OPSCC` `=HDMI1` `=HDMI2` `=HDMI3` `=VGA` `=ANDROID` Notes =OPSCC is only available if you install an AM50 iQ appliance and compute card. =ANDROID is the display’s settings.
`get brightness`	`set brightnessValue` Where `Value` is one of the following: `+Value` `-Value` `=5–100`	`brightness=Value` Where `Value` is a number between 5 and 100 Note Enabling Auto Brightness overrides any brightness values set manually.
`get volume`	`set volumeValue` Where `Value` is one of the following: `+Value` `-Value` `=0–100`	`volume=Value` Where `Value` is a number between 0 and 100
`get mute`	`set muteValue` Where `Value` is one of the following: `=on` `=off`	`mute=Value` Where `Value` is one of the following: `on` `off`
`get fwversion`	N/A	`fwversion=Value` Where `Value` is the firmware version.
`get serialnum`	N/A	`serialnum=Value` Where `Value` is the display’s serial number. Note If multiple displays are connected, the response includes the serial numbers for all displays, separated by commas.
`get partnum`	N/A	`partnum=Value` Where `Value` is the part number, including the revision.
`get videofreeze` Note This command is only available in SMART Board MX firmware 1.8.7 or later.	`set videofreeze=Value` Where `Value` is one of the following: `=on` `=off` Note This command is only available in SMART Board MX firmware 1.8.7 or later.	`videofreeze=Value` Where `Value` is one of the following: `on` `off` Note This command is only available in SMART Board MX firmware 1.8.7 or later.

Contents

Managing the display using RS‑232

Related links

Related products