ZeeVee ZyPer User manual

User Manual
Updated, March 2017
ZyPer
Management Platform

ii
1. Read these instructions.
2. Keep these instructions.
3. Heed all warnings.
4. Follow all instructions.
5. Do not use this product near water.
6. Clean only with a dry cloth.
7. Do not block any ventilation openings. Install in accordance with the manufacturer’s
instructions.
8. Do not install or place this product near any heat sources such as radiators, heat
registers, stoves, or other apparatus (including ampliers) that produce heat.
9. Do not defeat the safety purpose of a polarized or grounding-type plug. A polarized
plug has two blades with one wider than the other. A grounding type plug has two
blades and a third grounding prong. The wide blade or the third prong are provided for
your safety. If the provided plug does not t into your outlet, consult an electrician for
replacement of the obsolete outlet.
10. Protect the power cord from being walked on or pinched particularly at plugs,
convenience receptacles, and the point where they exit from the apparatus.
11. Only use attachments/accessories specied by the manufacturer.
12. To reduce the risk of electric shock and/or damage to this product, never handle or
touch this unit or power cord if your hands are wet or damp. Do not expose this
product to rain or moisture.
13. Unplug this apparatus during lightning storms or when unused for long periods of time.
14. Refer all servicing to qualied service personnel. Servicing is required when the
apparatus has been damaged in any way, such as power-supply cord or plug is
damaged, liquid has been spilled or objects have fallen into the apparatus,
the apparatus has been exposed to rain or moisture, does not operate normally,
or has been dropped.
15. Batteries that may be included with this product and/or accessories should never be
exposed to open ame or excessive heat. Always dispose of used batteries
according to the instructions.
Safety Instructions
• The Management Platform includes the Maestro Z web interface. The following
browsers are supported:
►Google Chrome version 40 or greater
• Refer to the Support page on the ZeeVee web site to download the latest rmware.
iii
Operating Notes

iv v
Contacting ZeeVee
Support
Contact us for installation and technical support, repairs, and warranty service:
+1 (877) 4-ZEEVEE (1.877.493.3833)
[email protected]
Representatives are available from 9:00 AM to 6:00 PM, Monday through Friday (USA East
Coat Time).
Sales
North America:
[phone] Phone
[email protected]
EMEA:
[phone] Phone
[email protected]
Features and Package Contents
Features
• Pre-congured Linux O/S is maintenance-free and includes upgrades and support.
• Plug & Play operation will discover and enable labeling and control of any number
of ZyPer4K or ZyPerHD encoders and decoders.
• Interface allows the independent routing of video, audio and control signals.
• The feature-rich API makes ZyPer4K / ZyPerHD the perfect add-on to existing
distribution systems without the time and dollars usually required for custom
programming.
• Presets enable signal routing and scheduling of saved, pre-dened source-display
settings for easy duplication and recall.
• Real time system monitoring includes generating alerts for ofine or disconnected
ZyPer4K / ZyPerHD devices, sources and displays.
• Auto detection/discovery of additional encoders and decoders make system scaling
a snap.
• Easily create and manage video walls of any pattern or congurations up to a 5x5
array.

Contents
1 Getting Started
Panel Descriptions ....................................................................2
Rear View ...........................................................................2
Top View ............................................................................3
Front View ..........................................................................4
Installation ................................................................................5
Using Windows®................................................................5
Using OS X® .......................................................................5
Sample Application Diagram...............................................6
Management Platform Login .....................................................7
Network Conguration ..............................................................8
Fixed Mapping using DHCP ................................................8
Static IP Conguration ........................................................9
2 Basic Operation
Accessing Maestro Z ..............................................................12
Home Page .............................................................................13
Device Status Indicators ...................................................14
Displaying Devices By Status............................................16
Displaying Devices By Name.............................................17
Joining Encoders to Decoders...........................................18
Unlinking Encoders and Decoders.....................................19
Source Cong Page.................................................................20
Conguring Encoders and Decoders .................................20
Deleting an Encoder or Decoder........................................26
Creating Video Walls.........................................................28
Bezel Compensation .........................................................31
Creating a Multiview Screen .............................................33
Creating Zones .................................................................37
Server Functions Page ............................................................40
Server Information ............................................................40
Setting the EDID Mode .....................................................41
Server Reboot, Restart, and Shutdown .............................42
Help Page ...............................................................................43
vi vii
Contents
3 Advanced Operation
Linux Server Management ......................................................45
Accessing Linux using SSH ..............................................45
Changing the Management Platform Password ................46
Accessing the API ...................................................................47
Using Telnet .....................................................................47
Getting Help .....................................................................47
Setting the Time Zone.......................................................48
EDID Management..................................................................49
Auto EDID Mode...............................................................49
Using Custom EDID Data ..................................................49
Using AJAX/JSON...................................................................51
Login Authentication.........................................................51
Command Request / Response .........................................52
API Command Listing .............................................................54
4 Appendix
Updating the Software ..........................................................131
Using Mac OS X .............................................................131
Using Windows ..............................................................133
Using MastroZ................................................................134
Specications........................................................................135

1 Getting Started

3
Getting Started
Panel Descriptions
Rear View
ID Name Description
1Security port This port accepts a standard computer
laptop locking connector.
2 Power receptacle Connect the included power supply to this
power receptacle.
3 HDMI Connect an HDMI cable from this port
on the Management Platform to an HD
display. (optional)
4 Mini DisplayPort Connect a Mini DisplayPort cable from this
port to a DisplayPort interface (optional).
5Ethernet port Connect an Ethernet cable from this port to
a switch on the Local Area Network.
6USB port Connect up to two USB 2.0 devices, such
as a keyboard and mouse, to these USB
ports.
Top View
ID Name Description
7 Power On/Off Press this button to manually power-off
the Management Platform. When the
Management Platform is connected to a
power source, it will automatically power-
on. In addition, if power is lost or the
power is disconnected, the Management
Platform will automatically power-on when
power is restored.
Getting Started
2
ZyPerMP
ZyPer Management Platform
Intelligent IP Distribution
Power On/Off
ZyPerMP
ZyPer Management Platform
Intelligent IP Distribution
Power On/Off
6
3 4 5
7
2
1

4
Getting Started
Front View
ID Name Description
8USB port Connect up to two USB 3.0 devices, such
as a keyboard and mouse, to these USB
ports.
9 Headphone / Mic jack Not used.
ZyPerMP
ZyPer Management Platform
Intelligent IP Distribution
Power On/Off
8 9
Getting Started
5
Installation
BEFORE YOU BEGIN: Make sure that all encoders and decoders are running the latest
version of rmware. Refer to the Support page on the ZeeVee web site to download the
latest rmware.
1. Connect the included power supply to the power receptacle on the ZyPer Manage-
ment Platform.
2. Connect the included AC power cord from the power supply to an available electrical
outlet.
3. Connect an Ethernet cable from the ZyPer Management Platform to a switch that
is on the same LAN that will be hosting the ZyPer devices. Although the ZyPer
Management Platform can be connected anywhere on the LAN, it is recommended
that it is connected to the primary switch where the ZyPer endpoints are connected.
NOTE: If the ZyPer Management Platform does not detect a DHCP server within 60
seconds, a link-local address of 169.254.xxx.xxx will be assigned to the ZyPer
Management Platform. If you wish to use static or xed-mapping using DHCP, then
see Network Conguration (page 8).
Using Windows®
a. Connect an Ethernet cable from your computer to the same switch as above.
b. Go to the Network folder.
c. Locate the icon titled “ZyPer Management Server” followed by an IP address.
This is the IP address of the ZyPer Management Platform.
Using OS X®
a. Connect an Ethernet cable from your computer to the same switch as above.
b. Open the Terminal application.
c. At the prompt, enter ping zyper.local.
d. The IP address of the ZyPer Management Platform will be displayed.

6 7
Getting Started
HDMI Ethernet
Display/Projector
LAN
Display/Projector
Automation
Control System
Computers
Zyper
Management
Platform
Managed
Switch
HD Source
HD Source
Decoders
Encoders
4. Open a web browser and enter the IP address of the ZyPer Management Platform.
5. The login screen for the Maestro Z will be displayed.
6. Enter admin for both the Username and Password elds.
See Management Platform Login (page 7)for more information.
7. Click the Login button.
Sample Application Diagram
Management Platform Login
1. At the login prompt, enter the following login name: zyper
After entering the login name, the password prompt will be displayed.
zyper login: zyper
Password:
2. Enter the password. The default password is zyper. Note that the password will
not be echoed to the screen. Once the password is entered, the screen will appear
similar to the following:
zyper login: zyper
Password:
Last login: Mon Mar 28 16:36:11 EDT 2016 on tty1
Welcome to Ubuntu 14.04.2 LTS (GNU/Linux 3.16.0-49-generic
x86_64)
* Documentation: https://help.ubuntu.com/
494 packages can be updated.
268 updates are security updates.
zyper@zyper:~$
3. At the prompt, type ifcong to display Management Platform network conguration.
The current IP address will be located on the second line of information, as shown:
zyper@zyper:~$ ifcong
eth0 Link encap: Ethernet HWaddr 40:8d:5c:32:45:d5
inet addr: 192.168.1.6 Bcast:192.168.1.255
Mask:255.255.255.0
...
...
Getting Started

8 9
Network Conguration
The default conguration of the Management Platform will use DHCP with link-local
addressing support. Link-local addressing allows the Management Platform to have an IP
address on a network, even if the Management Platform has not been manually congured
or automatically congured by a DHCP server. If a DHCP server is not detected within 60
seconds, a link-local address of 169.254.xxx.xxx will be assigned to the Management
Platform.
If you wish to use a static IP address, this can be done in one of two ways: Add a xed
mapping to the DHCP server or by directly assigning a static address to the Management
Platform. Both methods are covered in this section.
Fixed Mapping using DHCP
1. Use the ifcong command, from the Linux prompt to identify the MAC address of the
Management Platform.
zyper@zyper:~$ ifcong
eth0 Link encap: Ethernet HWaddr 40:8d:5c:32:45:d5
inet addr: 192.168.1.6 Bcast:192.168.1.255
Mask:255.255.255.0
...
...
2. Use the HWaddr value when conguring the DHCP server to assign a xed IP.
Using Telnet, the show server info command can also be used to obtain the MAC
address of the Management Platform. Refer to API Command Listing (page 54)for
a full listing of available commands.
3. Reboot the Management Platform, using the following command, to use the new IP
address.
zyper@zyper:~$ sudo reboot
Getting Started
Before continuing, make sure that the static IP address being used does
not conict with any DHCP-assigned addresses. Contact your system
administrator for assistance.
Getting Started
Static IP Conguration
1. At the prompt, launch the Emacs editor using the following command.
zyper@zyper:~$ sudo emacs /etc/network/interfaces
2. Enter the password. The default password is zyper. The password will not be
echoed to the screen.
zyper@zyper:~$ sudo emacs /etc/network/interfaces
[sudo] password for zyper:
3. Once the correct password is entered, the screen will display the Emacs editor.
4. Information, similar to the following, will be contained in the interfaces le.
auto eth0
allow-hotplug eth0
iface eth0 inet dhcp
#auto eth0
#iface eth0 inet static
#address 192.168.1.8
#netmask 255.255.255.0
#gateway 192.168.1.1
Lines that have the # symbol are not executed. So, we need to remove them and
place them at the beginning of the rst three lines.
5. Change the le so it appear as follows, making sure that your own IP settings are
used.
#auto eth0
#allow-hotplug eth0
#iface eth0 inet dhcp
auto eth0
iface eth0 inet static
address 10.5.68.100
netmask 255.255.255.0
gateway 10.5.68.1
Before continuing, make sure that the static IP address being used does
not conict with any DHCP-assigned addresses. In addition, the following
steps make use of the Linux Emacs editor which is beyond the scope of
this manual. If you are unfamiliar with this editor, contact your system
administrator for assistance.

10
Getting Started
6. Save the le and exit the Emacs editor. (Ctrl+x then Crtl+c) When prompted to save
changes type y
7. Reboot the Management Platform using the following command.
zyper@zyper:~$ sudo reboot
2 Basic Operation

12 13
Accessing Maestro Z
1. Open a web browser and enter the IP address of the Management Platform.
2. The login screen for Maestro Z will be displayed.
3. Enter the required information in the Username and Password elds. The default
username and password is admin. The username and password are case-sensitive.
4. Click the Sign In button.
5. The Home page will be displayed. See the next section for more information.
Basic Operation
Home Page
The Home page of the Maestro Z displays all available Sources, Displays, Walls, Zones,
Multiviews, Server Info, Logs and Help.
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more informa-
tion.
2. The Home page will be displayed. The Sources pane displays all available
encoders . The Displays pane displays available decoders. Walls, Multiview and
Zones will be covered in upcoming sections.
Basic Operation

14 15
Basic Operation
Device Status Indicators
Each Source and Display contains a status indicator border color, displaying current
information about the device. This is particularly useful for devices that may be in a
separate part of a building or several miles away.
Meaning Indicator Color
OK Green
1. Indicates that an HDMI cable is connected between
the encoder and the source or between the decoder
and a display or other sink device.
2. The encoder / decoder is powered.
3. The Ethernet cable is connected between the switch
and the encoder / decoder.
Meaning Indicator Color
Warning Yellow
1. HDMI cable may not be connected between the
encoder and the source or between the decoder and a
display or other sink device.
Note that this indicator may also indicate a faulty
HDMI cable.
2. The encoder / decoder is powered.
3. The Ethernet cable is connected between the switch
and the encoder / decoder.
Basic Operation
Meaning Indicator Color
Error Red
1. The Ethernet cable is disconnected between the switch
and the encoder / decoder.
2. The encoder / decoder may not be powered.

16 17
Basic Operation
Displaying Devices By Status
Both the Sources and Displays window contain a Filter by status option. There are
check boxes to lter by Status (Green, Yellow, Red), Device Type (4K or HD), USB
(Present, Not present) There is also an option to lter Sources or Displays by name.
1. Click the Filter Icon.
2. Only those devices with the selected status will be displayed. As illustrated in this
example, only ZyPer4K devices are shown in the Sources window. ZyPerHD source
are ltered out.
3. Select every box from the Filter to show all devices.
Basic Operation
Displaying Devices By Name
Both the Sources and Displays windows contain a Filter by name eld. Use this eld to
enter the name of the desired device(s) to be displayed.
As text is entered, the interface automatically begins a search of the current string for each
recognized device. Devices that are displayed must contain the text (in sequence) that is
currently in the Filter by name eld. Text searches are case-sensitive.
1. Click in the Filter by name eld.
This example uses the following named sources. For more information on naming
sources see Conguring Encoders and Decoders (page 20).
2. Type the desired sequence of characters in the Filter by name eld to search. In this
example, we want to only display the “Wildlife” source devices. To do this, we can en-
ter part of the name, such as “Wild” or even “W” (since no other device name contains
the character “W”). All text entries are case-sensitive.

18 19
Joining Encoders to Decoders
“Joining” is the process of assigning an encoder (source) to a decoder (display) or a video
wall. Before starting the join process, we recommend that you congure the encoder and
decoder settings. Refer to Conguring Encoders and Decoders (page 20).
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more informa-
tion.
2. Drag and drop the desired source on to the desired display.
3. The display icon will change to show that it has now been joined with a source. (Small
chain link icon) Hover over the chain link for additional status info.
4. Continue the join process as desired. Note that joining an encoder with a decoder
that is already joined, will replace the previous join operation.
The join command can also be used to perform the same operation.
See API Command Listing (page 54)for more information.
Basic Operation Basic Operation
Unlinking Encoders and Decoders
As mentioned earlier, joining an encoder with a decoder that is already joined, will
replace the previous join operation. However, there may be situations where you want
to completely remove any source from being shown on a display. To do this, use the
Disconnect AV feature.
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more informa-
tion.
2. On the Sources window, left-click on any Source. Select Disconnect AV.
3. Drag that source onto the Display that you would like to unlink
4. The display icon will change to show that it has been unlinked and no longer joined
with any encoder. (Small chain link icon is gone)

20 21
Basic Operation
Source Cong Page
Conguring Encoders and Decoders
When an encoder or decoder is connected to the network, the Management Platform
identies each unit by its MAC address. This is the default setting. However, when dealing
with several units, it is much easier to identify a unit by a string name. It is also possible to
assign a preset image to each icon, set the network mode, RS232 settings, and more.
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more informa-
tion.
2. Click the Source or Displays tab at the left of the page. Joining Encoders to Decod-
ers (page 18)
3. All available encoders will be displayed under the Sources window.
Basic Operation
4. Left-click the desired encoder name to display the context menu. In the example
below,we will select the encoder named “Airshow4K”.
5. A menu will appear with options for Summary, ID, Status,Cong and Actions.
6. Selecting the ID option will allow you to manually give the Source a name.
7. Enter a description for the source in the Name eld. By default, the Management
Platform will use the MAC address of the encoder. This eld cannot be blank.
Names cannot contain spaces. In this example, we will use “Airshow4K”.
Naming a device can also be done using the set device general name
command. See API Command Listing (page 54)for more information.

22 23
8. Click the Cong-Icon drop-down list to select the desired icon for this source. This is
optional. If no icon is selected, then the default icon will be used. In this
example, we will select DVD, since a DVD player is connected to this encoder.
The set device source-display iconImageName command can also be
used to assign an icon to a device. See API Command Listing (page 54)for more
information.
9. Enter the Manufacturer, Model, and Serial Number of the source or display in the
appropriate elds. By default, these elds are set to “Unknown”. These elds must
not be blank. If a custom value is provided, it must not contain spaces.
Basic Operation
Each encoder and decoder must have a unique name. Duplicate names are
prohibited. It should be noted that assigning a name to an encoder does not
actually replace the MAC address. The Name eld provides a descriptive
identier, rather than a MAC address.
The Manufacturer, Model, and Serial Number can also be assigned using
the following commands, respectively. See API Command Listing (page 54)
for more information.
►set device source-display manufacturer
►set device source-display model
►set device source-display serialNumber
10. Enter the location of the source or display device in the Location eld. By default, this
eld is set to “Unknown”. This eld must not be blank. If a custom value is provided, it
must not contain spaces.
11. The set device source-display location command can also be used to set
these values. See API Command Listing (page 54)for more information for
more information.
12. Use the Cong-IP Mode section to congure the IP setting for the encoder. By de-
fault, both encoders and decoders are set to DHCP mode and will be discovered
automatically by the Management Platform. To manually congure the IP settings
of the encoder, click the Mode drop-down list and select static. Once in static
mode, the information in the Address, Mask, and Gateway elds can be edited.
Basic Operation

24 25
13. Use the Baudrate section of Cong to congure the RS232 settings for the control
device, such as an automation control system. Click the Baudrate drop-down list to
select the desired baud rate of the control device.
The Device IP settings can also be assigned using the set device ip dhcp and
set device ip static commands. When assigning RS232 settings from the
command line, use the set device rs232 command. See API Command Listing
(page 54)for more information.
Basic Operation Basic Operation
Encoder and Decoder Status Information
You can obtain status information about an encoder and its source at any time, from the
Source Cong page.
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more
information.
2. Left-click the desired source and select the Status option from the context menu.

26 27
Basic Operation
Deleting an Encode or Decoder
If an encoder or decoder is disconnected from the network, the Management Platform
will continue to display the encoder within the Maestro Z until it is removed. Note that;
reconnecting the encoder will cause it to once again be displayed in the Maestro Z.
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more informa-
tion.
2. Click the Source tab at the left of the page.
►To delete an encoder:
a. Left-click on the desired encoder and select Actions from the context menu.
Basic Operation
b. Click the Delete button.
3. The following prompt will be displayed when deleting a source.
4. Click the Delete button to conrm the operation. Click the Cancel button to cancel
the operation.
5. Decoders are deleted in exactly the same manner as Encoders.

28 29
Creating Video Walls
One of the purposes of the Management Platform is to create and manage video walls.
A video wall is a collection of displays or projectors arranged in a square or rectangular
fashion. The source is then “mapped” to each display, thereby creating one large display
from multiple, smaller displays.
1. Login to the Maestro Z. Refer to Accessing Maestro Z (page 12)for more informa-
tion.
2. Click the Walls tab at the left of the page.
3. In the Walls pane, click on the +button to create a new video wall.
Basic Operation Basic Operation
4. This will bring up the wall Editor.
5. Enter the number of display columns in the Number of Columns eld.
6. Enter the number of display rows in the Number of Rows eld.
In this example, we have arranged our displays in two rows and two
columns. This is a blank 2x2 video wall:

30 31
Basic Operation
7. Drag Displays from the Display pane into the Editor to populate the wall. Provide a
name for the new video wall in the Name eld. Values in this eld cannot contain
spaces. Since more than one video wall can be created, always be sure to provide a
descriptive name. This eld cannot be blank.
8. Leave the Bezel Top, Bezel Bottom, Bezel Left, and Bezel Right set to 0.
Bezel compensation will be covered in the next section.
9. Click the Create button.
10. The new Wall will now be available within the Walls window.
11. Video Walls are deleted by clicking on the small Trash Can icon. The user will be
prompted to conrm deletion.
Basic Operation
Bezel Compensation
Every video output device has an area where video is not displayed. This area is called
the bezel. Bezel compensation takes this area into account when a single video source is
divided and displayed on multiple output devices.
1. Check the output on the video wall and identify any misaligned edges. For best
results, it is recommended to use a static video pattern for this test.
In the illustration on the left, we have a 2x2 video wall without bezel compensation.
Note the ZeeVee logo is not aligned correctly across all four displays. On the right,
bezel compensation is used to x the issue.
It is recommended that when the video wall is set up for the rst time, that these
values be set to zero. Bezel compensation can be changed at any time.
2. Left click the edit video wall button in the lower left corner of the desired wall.
Without Bezel Compensation With Bezel Compensation
Bezel compensation is always measured in pixels.