Overview

The JPSW switching protocol is used to control source routing in AMP Standardized systems, allowing control systems to switch video sources to one or more Decoders using simple text-based commands.

In this architecture, commands are sent directly to any Just Add Power device, making each device a potential control point. Once connected, the control system can manage all sources and displays across the system without requiring switch-specific drivers.

JPSW is enabled by default on all devices in an AMP Standardized system and cannot be disabled, ensuring consistent and predictable control behavior.

This approach simplifies third-party control integration by eliminating dependency on switch drivers. Systems that do not have native driver support can still achieve full switching control using JPSW commands.

To use JPSW, a static route must be configured on the network, typically on the router. If your on-site router does not support static routes, refer to this article for alternative setup options.

---

Access any Just Add Power Device

JPSW switching commands require the control system to establish a TCP/IP or Telnet session with any Just Add Power device using Port 23. Once connected to a single device, the control system can manage all sources and displays within the system.

JPSW is enabled by default on all devices in an AMP Standardized system and cannot be disabled.

Example: Connecting to Decoder 1
Decoder 1 172.27.1.1:23

Note: All JPSW commands are case-sensitive.

---

Source Switching Command Structure

The jpsw command allows you to switch video sources to specific Decoders using the following structure:

Syntax:

jpsw -r {$DecoderRange} -t {$EncoderNumber}

• -r = Decoder Selector (specifies which Decoders will switch)
• -t = Encoder Selector (specifies which Encoder to switch to)

The Encoder (-t) and Decoder (-r) selectors can be entered in any order:

jpsw -r 2 -t 1
jpsw -t 1 -r 2

Decoder Selection {$DecoderRange}

• Single Decoder: Specify a single Decoder number (e.g., 2).
• Multiple Decoders (Non-Sequential): Use a comma , to list specific Decoders (e.g., 1,3,5).
• Range of Decoders (Sequential): Use a hyphen - to define a range (e.g., 6-9).
• All Decoders: Use all to switch all displays (introduced in JPSW v1.6.1).

Encoder Selection {$EncoderNumber}

• Specify a single Encoder number (e.g., 15).

Note: Refer to your report file to confirm the correct Encoder and Decoder values before executing commands.

Source Switching Examples

Switch all Decoders to Encoder 2

jpsw -r all -t 2

Switch Decoder 2 to Encoder 1

jpsw -r 2 -t 1

Set Encoder 3 on Decoders 6-9

jpsw -t 3 -r 6-9

Switch specific Decoders (1, 15, 34, 57, 101, and 122) to Encoder 15

jpsw -r 1,15,34,57,101,122 -t 15

Switch a 3x3 Video Wall (Decoders 10-18) to Encoder 7

jpsw -r 10-18 -t 7

Switch Decoders 10-18 plus Decoder 22 to Encoder 10

jpsw -r 10-18,22 -t 10

---

Command Table

Source Switching

Name	Command	Variable(s)	Value(s)	Description	Target Device	Example
Source Switching	jpsw -r {$DecoderRange} -t {$EncoderNumber}	{$DecoderRange}	1-3023 OR all	Range of Decoders to Switch Seperate sequential range with [-] Seperate non-sequential range with [,] all targets every Decoder	Any Device	jpsw -r1,2-20 -t5
		{$EncoderNumber}	1-101	Number of Encoder to switch Integer

Disclaimer: Attempting to issue a source switching command that references Output/Input numbers not present in the Matrix Configuration will result in a failure to execute the command.

Diagnostic and Inventory

Name	Command	Value(s)	Description	Target Device	Example
Show Help	jpsw {$Option}	-h	Provides all variables to the JPSW Command.	Any Device	jpsw -h
Show System Layout		-c	Identifies the total number of Encoder and Decoder over the total number of switches		jpsw -c
Show Decoder Range		-d	Identifies the range of all Decoder across all switches		jpsw -d
Show IP Interfaces		-i	Provides a list of all assigned Encoder and Decoder IP Addresses		jpsw -i
Show Banner		-b	Identifies the banner from the local switch		jpsw -b
Show Version		-v	Provides the current version of JPSW		jpsw -v