ZeeVee ZyPer User Manual

ZeeVee ZyPer User Manual

Management platform
Hide thumbs Also See for ZyPer:

Advertisement

Quick Links

ZyPer
Management Platform
User Manual
Updated, March 2017

Advertisement

Table of Contents
loading

Summary of Contents for ZeeVee ZyPer

  • Page 1 ZyPer Management Platform User Manual Updated, March 2017...
  • Page 2 Heed all warnings. Follow all instructions. • Refer to the Support page on the ZeeVee web site to download the latest firmware. Do not use this product near water. Clean only with a dry cloth. Do not block any ventilation openings. Install in accordance with the manufacturer’s instructions.
  • Page 3 • Pre-configured Linux O/S is maintenance-free and includes upgrades and support. • Plug & Play operation will discover and enable labeling and control of any number +1 (877) 4-ZEEVEE (1.877.493.3833) of ZyPer4K or ZyPerHD encoders and decoders. support@zeevee.com • Interface allows the independent routing of video, audio and control signals.
  • Page 4: Table Of Contents

    Contents Contents Getting Started Advanced Operation Panel Descriptions ..............2 Linux Server Management ............45 Rear View ................2 Accessing Linux using SSH ..........45 Top View ................3 Changing the Management Platform Password ....46 Front View ................4 Accessing the API ..............47 Installation ................5 Using Telnet ..............47 Using Windows®...
  • Page 5: Getting Started

    Getting Started...
  • Page 6: Panel Descriptions

    Getting Started Getting Started Panel Descriptions Top View Rear View ZyPerMP ZyPer Management Platform ZyPerMP ZyPer Management Platform Name Description Intelligent IP Distribution Power On/Off Security port This port accepts a standard computer laptop locking connector. Power receptacle Connect the included power supply to this power receptacle.
  • Page 7: Front View

    Power On/Off BEFORE YOU BEGIN: Make sure that all encoders and decoders are running the latest version of firmware. Refer to the Support page on the ZeeVee web site to download the latest firmware. Connect the included power supply to the power receptacle on the ZyPer Manage- ment Platform.
  • Page 8: Sample Application Diagram

    Getting Started Getting Started Open a web browser and enter the IP address of the ZyPer Management Platform. Management Platform Login The login screen for the Maestro Z will be displayed. At the login prompt, enter the following login name: zyper Enter admin for both the Username and Password fields.
  • Page 9: Network Configuration

    Platform. Both methods are covered in this section. zyper@zyper:~$ sudo emacs /etc/network/interfaces Fixed Mapping using DHCP Enter the password. The default password is zyper. The password will not be echoed to the screen. Before continuing, make sure that the static IP address being used does zyper@zyper:~$ sudo emacs /etc/network/interfaces not conflict with any DHCP-assigned addresses.
  • Page 10: Basic Operation

    Getting Started Save the file and exit the Emacs editor. (Ctrl+x then Crtl+c) When prompted to save changes type y Reboot the Management Platform using the following command. zyper@zyper:~$ sudo reboot Basic Operation...
  • Page 11: Accessing Maestro Z

    Basic Operation Basic Operation Accessing Maestro Z Home Page Open a web browser and enter the IP address of the Management Platform. The Home page of the Maestro Z displays all available Sources, Displays, Walls, Zones, Multiviews, Server Info, Logs and Help. The login screen for Maestro Z will be displayed.
  • Page 12: Device Status Indicators

    Basic Operation Basic Operation Device Status Indicators Meaning Indicator Color Error 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 The Ethernet cable is disconnected between the switch separate part of a building or several miles away.
  • Page 13: Displaying Devices By Status

    Basic Operation Basic Operation Displaying Devices By Status Displaying Devices By Name Both the Sources and Displays window contain a Filter by status option. There are Both the Sources and Displays windows contain a Filter by name field. Use this field to check boxes to filter by Status (Green, Yellow, Red), Device Type (4K or HD), USB enter the name of the desired device(s) to be displayed.
  • Page 14: Joining Encoders To Decoders

    Basic Operation Basic Operation Joining Encoders to Decoders Unlinking Encoders and Decoders “Joining” is the process of assigning an encoder (source) to a decoder (display) or a video As mentioned earlier, joining an encoder with a decoder that is already joined, will wall.
  • Page 15: Source Config Page

    Basic Operation Basic Operation Source Config Page Left-click the desired encoder name to display the context menu. In the example below,we will select the encoder named “Airshow4K”. A menu will appear with options for Summary, ID, Status,Config and Actions. Configuring Encoders and Decoders When an encoder or decoder is connected to the network, the Management Platform identifies each unit by its MAC address.
  • Page 16 Basic Operation Basic Operation The Manufacturer, Model, and Serial Number can also be assigned using Each encoder and decoder must have a unique name. Duplicate names are the following commands, respectively. See API Command Listing (page 54) prohibited. It should be noted that assigning a name to an encoder does not for more information.
  • Page 17 Basic Operation Basic Operation 13. Use the Baudrate section of Config to configure the RS232 settings for the control Encoder and Decoder Status Information device, such as an automation control system. Click the Baudrate drop-down list to select the desired baud rate of the control device. You can obtain status information about an encoder and its source at any time, from the Source Config page.
  • Page 18: Deleting An Encoder Or Decoder

    Basic Operation Basic Operation Click the Delete button. 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.
  • Page 19: Creating Video Walls

    Basic Operation Basic Operation Creating Video Walls This will bring up the wall Editor. 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.
  • Page 20: Bezel Compensation

    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 fix the issue.
  • Page 21: Creating A Multiview Screen

    Basic Operation Commands Creating a Multiview Screen The video wall editor will come back up onto the screen. One of the purposes of the Management Platform is to create and manage multiview screens. A multiview screen is a collection of sources arranged on a single display. There can be up to 9 sources displayed on a single display in a variety of preset patterns.
  • Page 22 Commands Commands Click on the Patterns button in the lower right corner to bring up a list of pre-defined pat- Drag sources into the various locations. Note: The same source can be dragged into terns. muliple windows as long as the windows are the same size. Dragging a source onto differnent size windows is NOT supported.
  • Page 23: Creating Zones

    Commands Basic Operation Creating Zones If desired, assign Audio from one of the Sources. This is done by clicking on one of the small Audio symbols in the top center of each Window. Note that only audio from one source is supported. In many installations, displays are placed in more than one room.
  • Page 24 Basic Operation Basic Operation This will open the Zones Editor. Drag Display and Video Walls into the Zone from the Click the Create button to save the Zone. Close the editor window to exit without sav- Displays or Walls windows. ing changes.
  • Page 25: Server Functions Page

    Basic Operation Basic Operation Server Functions Page Setting the EDID Mode By default, Auto EDID mode is enabled. This means that the Management Platform will compare the encoder EDID with the decoder EDID. If they are different, then the EDID The majority of this page is used to display general information about the Management from the decoder (sink) will be used by the encoder (source).
  • Page 26: Server Reboot, Restart, And Shutdown

    Click the desired section. As the mouse pointer moves over each section, the text will Restarts the server. Linux is not restarted. become underlined. ► Reboot Linux is rebooted. ► Shut Down Shuts down the Management Server. Trouble Report ► Generates a trouble report than can be provide to ZeeVee support.
  • Page 27: Advanced Operation

    This includes the installation of third-party Linux software packages. Accessing Linux using SSH Use the following command on a MAC or other Linux system. Andrews-MacBook-Pro:~Andrew$ ssh zyper.local -l zyper Advanced Operation zyper@zyper.local’s password: When entering the password, it will not be echoed to the screen.
  • Page 28: Changing The Management Platform Password

    Advanced Operation Changing the Management Platform Password Accessing the API To change the ZyPer account password, use the passwd command, as shown below. Using Telnet Note that passwords are not echoed to the screen. Telnet is a popular protocol that can be used on both Windows® and Mac OS® operating zyper@zyper:~$ passwd systems to connect to the programming shell.
  • Page 29: Setting The Time Zone

    The time zone must be specified in POSIX format and is case-sensitive. Refer to the following link for more information: HD Source http://wikipedia.org/wiki/List_of_tz_database_time_zones. Encoder Zyper$ set server timezone America/New_York Success Zyper$ Use the show server info command to verify the correct time zone has been set.
  • Page 30: Using Ajax/Json

    These files must remain in this directory when disabling Auto EDID mode. the zyperLogin() function within zyper.html: To force a ZyPer encoder to use the saved EDID you need to have the MP load the binary EDID file onto the desired encoder.
  • Page 31: Command Request / Response

    Command Request / Response The JavaScript object that is returned is: var jsObj = { The following code excerpt sends an AJAX request to list all ZyPer encoders and decoders: status: true | false; responses: [ {error: “errorText”, function zt(){ warning: “warningText”,...
  • Page 32: Api Command Listing

    Advanced Operation Advanced Operation API Command Listing Command Description send Sends and IR or RS232 string to the specified device Command Description set encoder analog-audio-out Sets the source of Analog audio output for create video-wallmultiview Creates a new multiview display source specified encoder create video-wall...
  • Page 33 Advanced Operation Commands Command Description Command Description set device usb-filter show device capabilities Allows restrictions to USB use on selected Shows detailed capabilities of specified device device or devices set device video-port show device config Selects active input port for ZyPer4K units Shows detailed configuration information with multiple inputs for specified device or devices...
  • Page 34 Commands Advanced Operation create multiview create video-wall Creates an empty multiview display. Once created, the new multiview will be listed under Creates an empty 2x2 video wall. Once created, the new video wall will be listed under the the Multiview menu within the built-in Maestro Z. Display Config menu within the built-in Maestro Z.
  • Page 35 Type: STRING or MAC Address argument Description The name or MAC address of the device. String names are case-sensitive. reboot Unit is automatically rebooted restart The ZyPer server service is restarted shutdown Unit is shutdown Example delete device myDevice Success Example...
  • Page 36 Commands Commands delete multiview delete multiview-window Deletes the specified multiview from the database on the Management Platform. Deletes the specified window from an existing multiview. Syntax Syntax delete multiview name delete multiview-window name window arg Parameters Parameters name name Type: STRING Type: STRING The name of the multiview.
  • Page 37 Advanced Operation Advanced Operation delete video-wall factory-defaults device Deletes the specified video wall from the database on the Management Platform. Set the specified device to the factory-default settings. Syntax Syntax delete video-wall name factory-defaults device id Parameters Parameters name Type: STRING Type: STRING or MAC Address The name of the video wall.
  • Page 38 Advanced Operation Advanced Operation flash-leds join Physically identifies the specified device on the network. When this command is executed, Joins the specified decoder (display) with the specified encoder (source). The mode the fiber LED indicators on the device will flash for 5 seconds. parameter must be specified and defines the type of join to execute.
  • Page 39 Advanced Operation Advanced Operation load encoder-edid mode Type: STRING Uploads an EDID file to the specified encoder. Supply one of the following arguments before executing this command. Syntax argument Description analog-audio Embed audio from the specified encoder load encoder-edid enc file fast-switched Join in “fast-switched”...
  • Page 40 Advanced Operation Advanced Operation restart device restart server Restarts the specified device. Restarts the server. Linux is not restarted. Syntax Syntax restart device id restart server Parameters Parameters none Type: STRING or MAC Address The name or MAC address of the device. String names are case-sensitive. Example restart server Example...
  • Page 41 Commands Advanced Operation restore device save device-edid Delete all the config settings for specified device and restore it based on the information Saves the EDID of the downstream sink to the srv/ftp/files folder on the Management stored in the database. Server.
  • Page 42 Advanced Operation Advanced Operation script send Executes the specified script. The script must exist in the /srv/ftp/files folder. Sends an IR or RS232 string to the specified device. Use the type parameter to specify Use the optional loop argument to place the script in a loop. The script will continue an IR or RS232 code.
  • Page 43 Advanced Operation Commands set encoder Example Sets the analog audio output source type for the specified encoder. send myDecoder2 ir 0000006900000015005f001700300017003000170030001 700300017001700170030001700170017001700170030001700170017003000170 030001700170017003000170017001700170017001700170030001700300017003 00200 Syntax Success set encoder id mode type Related Commands Parameters set device rs232 Type: STRING or MAC Address The name or MAC address of the encoder.
  • Page 44 Advanced Operation Commands set decoder set device ethernet-management-port Sets the audio output type for the specified decoder. Enables or disables the 1Gb Utility Ethernet port on the specified encoder or decoder. Syntax Syntax set decoder id mode type set device id ethernet-management-port arg Parameters Parameters Type: STRING or MAC Address...
  • Page 45 Advanced Operation Advanced Operation set device general name set device ip Sets the name for the specified encoder or decoder. Sets DHCP mode for the specified device. Syntax Syntax set device id general name str set device id ip arg Parameters Parameters Type: STRING or MAC Address...
  • Page 46 Advanced Operation Advanced Operation set device ip static Related Commands Sets static mode for the specified device. The IP address, subnet mask, and gateway must set device analog-audio mode be supplied. set device general name set device gig-ethernet-port mode set device ip set device ip static Syntax set device rs232...
  • Page 47 Advanced Operation Advanced Operation set device rs232 stop Type: INTEGER Sets the RS232 settings for the specified device. The stop bit setting for the device. Supply one of the following values from the table below. Syntax argument 1-stop set device id rs232 baud data stop parity 2-stop parity Parameters...
  • Page 48 Commands Advanced Operation set device send-ip-mcast-range set device source-display iconImageName Sets allowable range of multicast addresses for selected devices. Assigns an icon to the desired device. The icon will be displayed within the Maestro Z to identify the device. Syntax Syntax set device id send-ip-mcast-range first:ip last:ip set device id source-display iconImageName fname...
  • Page 49 Advanced Operation Advanced Operation set device source-display location Example Assigns a location description for the specified device. set device DVD-Wildlife source-display iconImageName HDDVD.png Success Syntax Related Commands set device id source-display location loc set device analog-audio mode set device general name set device gig-ethernet-port mode Parameters set device ip...
  • Page 50 Advanced Operation Advanced Operation set device source-display manufacturer set device source-display model Assigns a manufacturer description for the specified device. Assigns a model description for the specified device. Syntax Syntax set device id source-display manufacturer mfg set device id source-display model model Parameters Parameters Type: STRING or MAC Address...
  • Page 51 Advanced Operation Commands set device source-display serialNumber set device stream mode Assigns the manufacturer serial number for the specified device. Enable or disable multicast streams, and in the process, free the assigned multicast address assigned of that particular stream. Syntax Syntax set device id source-display serialNumber serial set device id stream type mode arg...
  • Page 52 Commands Commands set device usb-filter Example set device encoders stream all mode disabled-free-mcast Allows restrictions to USB use on selected device. Success Syntax Related Commands set device id usb-filter arg set device analog-audio mode set device general name Parameters set device gig-ethernet-port mode set device ip set device ip static set device rs232...
  • Page 53 Commands Commands set multiview set device video-port Assigns source to a position and size within a multiview display Selects active input port for ZyPer4K units with multiple inputs Syntax Syntax set multiview id window-number wn encoder-name enc position-x posx set device id video-port arg position-y posy size-x sx size-y sy layer ly Parameters Parameters...
  • Page 54 Commands Commands set multiview audio-source window number Type: Integer Selects the input source to provide Audio for multiview display Window Layer. Value from 1-9 with layer 1 being the top layer and 9 being the bottom. Syntax set multiview id audio-source window number arg Example set multiview myMview1 window-number 9 encoder-name myEnc1 position-x 50 position-y 50 size-x 25 size-y 25 layer 3...
  • Page 55 Advanced Operation Advanced Operation set responses rs232-term-chars set server api-password Specifies the termination character for an RS232 string. The default string is “\n\r”. Sets the password for Telnet. If a password is not provided, then the current password will Any character in the termination string causes the response-string to terminate and be be deleted.
  • Page 56 Advanced Operation Commands set server auto-edid-mode set server igmp-querier-mode Sets the EDID mode for the Management Platform. By default, Auto-EDID mode is Enables or disables IGMP querier mode enabled. Syntax Syntax set server auto-edid-mode mode set server igmp-querier-mode mode Parameters Parameters mode mode...
  • Page 57 Advanced Operation Advanced Operation set server timezone set video-wall Sets the time zone for the Management Platform. The time zone must be specified in Changes the size of the specified video wall and bezel parameters. Bezel values are POSIX format. measured in pixels.
  • Page 58 Advanced Operation Advanced Operation set video-wall-decoder Note: Bezel adjustment only supported on ZyPer4K Assigns the specified decoder, to the desired row and column, on the specified video wall. Example set video-wall myVideoWall 4 4 10 10 15 15 Syntax Success set video-wall-decoder id wall row col Related Commands Parameters...
  • Page 59 Advanced Operation Commands set video-wall-encoder show device capabilities Assigns the specified encoder to the desired video wall. Displays device capabilities for the specified device(s). Syntax Syntax set video-wall-encoder id wall show device capabilities id select [since] Parameters Parameters Type: STRING or MAC Address Type: STRING or MAC Address The name or MAC address of the encoder.
  • Page 60 Commands Advanced Operation show device config Example show device capabilities myEnc1 since 20 Displays device information for the specified device(s). device(d8:80:39:9a:e6:d); device.CapabilitiesVersion; values=1 device.streams-supported; values=video:video-scaled:analog- audio:hdmi-downmix-audio Syntax device.stream-mode-settable; values=video:video-scaled:analog- audio:hdmi-downmix-audio show device config id select [since] device.stream-mcast-settable; values=video:analog-audio:hdmi- downmix-audio device.join-video; values=multiview:genlocked:fast-switched device.video-port;...
  • Page 61 Advanced Operation Commands show device connections Example Shows encoder connections to decoders show device config USA4K since 20 device(d8:80:39:9a:e6:d); device.gen; model=Zyper4K, type=encoder, name=USA4K, state=Up, lastChangeId=12627 Syntax device.gen; firmware=3.1.3 device.gen; ethernet-management-port-mode=enabled show device connections device.ports; video-port=hdmi device.ip; mode=dhcp, address=172.16.6.33, mask=255.255.255.0, gateway=172.16.6.1 device.rs232;...
  • Page 62 Advanced Operation Advanced Operation show device status Example show device status USA4K since 20 Displays status information for the specified device(s). This command functions the same device(d8:80:39:9a:e6:d); as the show device config command. device.gen; model=Zyper4K, type=encoder, name=USA4K, state=Up, uptime=1d:4h:36m:37s, lastChangeId=5285 device.firmwareUpdate;...
  • Page 63 Commands Commands show multiviews config percentPosY=65, percentSizeX=30, percentSizeY=30, layer=1; multiview.window4; encoder-name=Soccer4K, percentPosX=65, percentPosY=65, percentSizeX=30, percentSizeY=30, layer=1; Shows configuration information on all multiview displays multiview.window5; encoder-name=USA4K, percentPosX=5, percentPosY=35, percentSizeX=30, percentSizeY=30, layer=1; multiview.window6; encoder-name=Airshow4K, percentPosX=35, percentPosY=5, percentSizeX=60, percentSizeY=60, layer=1; Syntax Success show multiviews config Related Commands Parameters create multiview...
  • Page 64 Commands Commands percentPosY=65, percentSizeX=30, percentSizeY=30, layer=1; show multiviews status multiview.window4; encoder-name=Soccer4K, percentPosX=65, percentPosY=65, percentSizeX=30, percentSizeY=30, layer=1; multiview.window5; encoder-name=USA4K, percentPosX=5, Shows status information for all multiview displays percentPosY=35, percentSizeX=30, percentSizeY=30, layer=1; multiview.window6; encoder-name=Airshow4K, percentPosX=35, percentPosY=5, percentSizeX=60, percentSizeY=60, layer=1; Success Syntax show multiviews status Related Commands Parameters create multiview...
  • Page 65 Advanced Operation Advanced Operation show responses Example show responses 0:1e:c0:f6:b0:8a rs232 since 10 Displays response strings from the specified device. lastChangeId(0); Success show responses 0:1e:c0:f6:b0:8a ir last-change-id Syntax lastChangeId(0); Success show responses id type param3 show responses 0:1e:c0:f6:b0:8a ir last lastChangeId(0);...
  • Page 66 Example Example show server config server(172.16.6.46); show server info server.gen; autoEdidMode=disabled server(192.168.1.8); server.multicast; startLSB:1 server.gen; hostname=zyper.local, version=1.0.29760, Success macAddress=40:8d:5c:32:45:d5, serialNumber=ZZMPFB408d5c3245d5A, uptime=0d:7h:49m:53s, freeMem=6.780GB server.time; time=Tue Feb 9 19:04:55 2016, timezone=America/ New_York server.license; limit=unlimited, devicesExceeded=0 Success Related Commands show server info...
  • Page 67 Advanced Operation Advanced Operation show video-walls shutdown server Displays all video walls that have been created and all associated information. Performs a shutdown of the Management Platform. Syntax Syntax show video-walls shutdown server Parameters Parameters none none Example Example show video-walls shutdown server videoWall(myWall);...
  • Page 68 Advanced Operation Advanced Operation sleep switch Specifies a sleep duration in milliseconds. This command is sometime required when This command is used in conjunction with the IR and RS232 switching commands. executing a series of commands within a web page, using AJAX. Often times, a pause Both the rs232 and the ir argument specify unidirectional connection between two must occur in order for a device or the Management Platform to change states before devices.
  • Page 69 Generates capture logs and system state information and is used by the ZeeVee Updates the Management Platform software. The server software file uses the .zyper support team for troubleshooting purposes. This file is in .tgz format and is written extension.
  • Page 70: Appendix

    Using Mac OS X Make sure the Management Platform is powered and is working correctly. Download the latest software from the ZeeVee website. Make note of the location of where the software was downloaded. Launch the Terminal app, found under the Applications > Utilities folder. By default, the current directory will be the Home directory.
  • Page 71: Using Windows

    Make sure the Management Platform is powered and is working correctly. ftp> put update_nuc_1.0.29943.zyper Download the latest software from the ZeeVee website. Make note of the location of where the software was downloaded. Press the [ENTER] key. Information similar to the following will be displayed.
  • Page 72: Using Mastroz

    Appendix Using MaestroZ Specifications Make sure the Management Platform is powered and is working correctly. Download the latest software from the ZeeVee website. Make note of the location of where the software was downloaded. • Intel® Celeron® Processor 3205U Operating System •...
  • Page 73 North America: +1 (347) 851-7364 • sales@zeevee.com International: +1 (347) 851-7364 • sales@zeevee.com EMEA: +44 1494 956677 • EMEAsales@zeevee.com BOSTON | DENVER | LONDON www.zeevee.com...

Table of Contents