© MuxLab Inc.
HDMI 4x8 & 8x8 Matrix Switch, HDBT, PoE Installation Guide
B. IP Control Commands
1. Notice
This section is provided for informational purposes only, and should only be used by
software developers with a thorough understanding of the HTTP and JSON
specifications.
2. Introduction
The Matrix Switch can be controlled using basic IP commands. These commands are
based on the JSON format and are sent and received in standard TCP/IP packets. To
learn more about JSON, visit
http://www.json.org
.
Only four types of JSON arrays are used to control the product:
Array of a single integer:
[2]
Array of multiple integers:
[1,2,3,4,5,6,7,8]
Array of a single string:
[“A Name”]
Array of multiple strings:
[“Name 1”, “Name 2”, “Name 3”, “Name 4”]
Any other notation is not permitted. Also, “null” values are not permitted. Use 0
instead.
3. Basic Usage
All read and write operations are performed via HTTP GET and HTTP POST
commands, respectively. While you can perform a GET at any time, a POST
command will require prior authentication.
4. Basic Authentication
Authentication is performed in two simple steps:
1.
Obtain a Session ID
Perform a
GET
request on
/var/session.json
to obtain a new session ID. The return value
will be a JSON array of a single integer, for example
[12345]
. From then on, simply
append the session to any new IP requests to use this session, e.g.,
GET
/var/conn.json?sid=12345
2.
To Open a Session ID that will not expires
Perform a
GET
request on
/var/xsession.json
to obtain a session ID
that will not expires
.
The return value will be a JSON array of a single integer, for example
[12345]
. From then on,
simply append the session to any new IP requests to use this session, e.g.,
GET
/var/conn.json?sid=12345
Page 55
