Download Print this page
osprey video MSS-8 Api Manual

osprey video MSS-8 Api Manual

Rackmount matrix switcher
Hide thumbs Also See for MSS-8:

Advertisement

Quick Links

API Guide MSS-8 and MVS-16
- 8 Channel Matrix Switcher MSS-8
Page 2
- 16 Channel Matrix Switcher and Multi Viewer MVS-16
Page 13
www.ospreyvideo.com
1

Advertisement

loading
Need help?

Need help?

Do you have a question about the MSS-8 and is the answer not in the manual?

Questions and answers

Summary of Contents for osprey video MSS-8

  • Page 1 API Guide MSS-8 and MVS-16 - 8 Channel Matrix Switcher MSS-8 Page 2 - 16 Channel Matrix Switcher and Multi Viewer MVS-16 Page 13 www.ospreyvideo.com...
  • Page 2 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 API Instructions for RS232 RS232 Connection: Port Settings: Bps 9600, Data bits 8, Parity None, Stop Bits 1, Flow Control None Communication Protocol: The protocol has 3 formats as below. It is sent as ASCII Code and not processed back (no feedback results) [x]v[y].
  • Page 3 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Configuration and Control API Guide for LAN Description: This document describes the Osprey Matrix Switch Configuration and Control API (OMSCC API). The API uses HTTP UDP packet transmissions utilizing both broadcast and unicast addresses. All Osprey Matrix Switchers are shipped with the OMSCC API pre-installed. This API can be used in C++, C#, Java, IOS, etc.
  • Page 4 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Configuring Output Ports Description: The following commands configure the output ports to output based on the configured input port. Method: UDP Unicast Destination Address: IP address of the matrix switcher Destination Port: 7000 Commands Table: All commands must be sent as ASCII code to the IP address of the matrix switch on port 7000.
  • Page 5 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Broadcast from PC to MSS-8 Data Packet Value Byte Description Packet Header 0xA5 The beginning of data packet 0x6C Data Length 0x0000~0x0420 The length of the entire data packet from packet header to end (including header and end). The lower byte stays head.
  • Page 6 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Command List Function Command Description Read Status of Switcher 0x53 Read the current status of switcher, including IP status, input and output information, and device name. Read Status of LCD 0x50 Read the current status of LCD information, including LCD backlight time and LCD brightness.
  • Page 7 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Examples Read the current status of switcher Broadcast a5 6c 14 00 82 01 01 00 00 00 00 00 00 00 00 00 fc 01 ae Response Payload: Read Status of LCD Broadcast a5 6c 14 00 03 01 01 00 00 00 00 00 00 00 00 00...
  • Page 8 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Setting LCD Backlight Time to “Always On” Broadcast a5 6c 15 00 03 ff 01 00 00 00 00 00 00 00 00 00 04 7e 02 ae Response Payload: a5 6c 15 00 03 01 02 00 00 00 00 00 00 00 00 00...
  • Page 9 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Sample C# Application using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Net.Sockets; using System.Net; using System.Globalization; namespace OspreyMatrixSwitcher class Program static void Main(string[] args) Sender OspreyMatrixSwitcher.Sender(); s.Send(); public class Sender public void...
  • Page 10 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 Sample C# Application // A success bit of 0 indicates data returned successfully. Byte success = ((byte[])ServerResponseData)[17]; bool bSuccess = false; (success == 0) bSuccess = true; Console.WriteLine(@"Response from with IP address: {0} with type: {1} and success of: {2}",...
  • Page 11 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 bytes = Encoding.ASCII.GetBytes("3all."); client.Send(bytes, bytes.Length, matrixSwitcherConnectionAddress); /* Pause the client, view the matrix switcher and note that all output * ports have a source port of 3*/ PrintPortStatus(ref client, matrixSwitcherConnectionAddress, ServerEp); System.Console.WriteLine("Press any key to continue.");...
  • Page 12 RACKMOUNT 8x8 MATRIX SWITCHER MSS-8 // Wait for a response ServerResponseData = client.Receive(ref ServerEp); // Type 0x82 is the matrix switcher Byte Port1 = ((byte[])ServerResponseData)[18]; Byte Port2 = ((byte[])ServerResponseData)[19]; Byte Port3 = ((byte[])ServerResponseData)[20]; Byte Port4 = ((byte[])ServerResponseData)[21]; Byte Port5 = ((byte[])ServerResponseData)[22];...
  • Page 13: Communication Mode

    RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Configuration and Control API Guide for LAN Description: This document describes the Osprey Matrix Switch Configuration and Control API (OMSCC API). The API uses HTTP UDP packet transmissions utilizing both broadcast and unicast addresses. All Osprey Matrix Switchers are shipped with the OMSCC API pre-installed.
  • Page 14 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Response from MVS-16 to PC Data Packet Value Byte Description 0xA5 Packet Header The beginning of data packet. 0x6C Data Length 0x0000~0xFFFF The length of the entire data packet from packet header to end (including the packet header and end).
  • Page 15 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Device Type and Commands Device Type: 0xa3 Commands: Function Command Description (hex) Scanning 0xff Broadcast to scan the multiviewer from the LAN. Reading All the Data 0x0a After device scanned, reading all status data of the device.
  • Page 16 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Partial Parameter List: Response Format typedef struct unsigned char value:6; // output resolution unsigned char signal:1; //OSD enable 1 on 0 off unsigned char res:1; //Reserved }Reso_Byte; typedef struct unsigned char uEn:1; unsigned char Color:4;...
  • Page 17 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 unsigned char tInputInfoOnOff:1; //OSD enable unsigned char tTimeCodeOnOff:1; //Time code enable unsigned char tAudioAlarmOnOff:1; //Audio alarm enable unsigned char tBorderOnOff:1; //Border enable unsigned char tLockStatus:1; //Front panel lock status unsigned char tDhcpStatus:1; //DHCP status unsigned char tMatrixFlag:1;...
  • Page 18 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Output Layout List: www.ospreyvideo.com...
  • Page 19 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 www.ospreyvideo.com...
  • Page 20 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 www.ospreyvideo.com...
  • Page 21 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Output Resolution List: Output Resolution Broadcast Value 1080p60 0x07 1080p50 0x0b 1080p30 0x03 1080p25 0x0d 1080p24 0x05 1080i60 0x09 1080i50 0x01 720p60 0x0e 720p50 0x06 Examples: Note 1: Following examples are through LAN port. If using the serial port just change the interface byte and recalculate the Checksum.
  • Page 22 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 4.2 Read All Data of the Device’s Current Status Broadcast a5 6c 14 00 a1 ff 01 00 00 00 00 00 00 00 00 00 d0 02 ae Above Response Description: a5 6c 09 03 a1 ff 01 00 00 00 00 00 00 00 00 00 From packet header to reserve Command byte...
  • Page 23 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 continued 01 03 0d 0f 0d 0f 0f 02 Display information of 16 windows, including resolution, audio meter, 01 03 0d 0f 0d 0f 0f 02 OSD, time code, audio alarm 01 03 0d 0f 0d 0f 0f 02 01 03 0d 0f 0d 0f 0f 02 01 03 0d 0f 0d 0f 0f 02...
  • Page 24 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Continued WIN 7 UMD length 53 00 44 00 49 00 20 00 30 00 37 00 00 00 00 00 00 00 WIN 7 UMD text 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 WIN 8 UMD length 53 00 44 00 49 00 20 00 30 00 38 00 00 00 00 00 00 WIN 8 UMD text...
  • Page 25 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 4.3 Output Format Setting E.g.: Setting the output resolution to 1080p50. Broadcast a5 6c 16 00 a1 ff 01 00 00 00 00 00 00 00 00 00 00 0b ec 02 ae Response Payload a5 6c 15 00 a1 ff 01 00 00 00 00 00 00 00 00 00 e0 02 ae...
  • Page 26 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 4.9 Switch between Multiviewer and Matrix Switcher Mode E.g.: Switch to Multiviewer mode Broadcast a5 6c 15 00 a1 ff 01 00 00 00 00 00 00 00 00 00 29 03 ae Response Payload a5 6c 15 00 a1 ff 01 00 00 00 00 00 00 00 00 00 29 03 ae...
  • Page 27 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Sample C# Application using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Net.Sockets; using System.Net; using System.Globalization; namespace OspreyMatrixSwitcher class Program static void Main(string[] args) Sender OspreyMatrixSwitcher.Sender(); s.Send(); public class Sender public void Send()
  • Page 28 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Sample C# Application // A success bit of 0 indicates data returned successfully. Byte success = ((byte[])ServerResponseData)[17]; bool bSuccess = false; (success == 0) bSuccess = true; Console.WriteLine(@"Response from with IP address: {0} with type: {1} and success of: {2}", ServerEp.Address.ToString(),...
  • Page 29 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Sample C# Application /* Configure the Matrix switcher for multiviewer mode*/ Console.WriteLine("\r\n Configure the Matrix switcher for matrix switcher mode using command 0x62 ..."); bytes = HexToByte("a56c1500a1ff0100000000000000000062012a03ae"); client.Send(bytes, bytes.Length, matrixSwitcherConnectionAddress); System.Console.WriteLine("Press any key to continue.");...
  • Page 30 RACKMOUNT 16x16 MATRIX SWITCHER 16 CHANNEL MULTI VEWER MVS-16 Sample C# Application public static byte[] HexToByte(string hexString) (hexString.Length % 2 != 0) throw new ArgumentException(String.Format(CultureInfo.InvariantCulture, "The binary key cannot have an odd number of digits: {0}", hexString)); byte[] HexAsBytes = byte[hexString.Length / 2];...

This manual is also suitable for:

Mvs-16