EasyManua.ls Logo

Lightware MMX2 Series - Protocol Rules; Command Structure Example; General Rules; Legend for the Control Commands

Lightware MMX2 Series
126 pages
To Next Page IconTo Next Page
To Next Page IconTo Next Page
To Previous Page IconTo Previous Page
To Previous Page IconTo Previous Page
Loading...
๎˜›๎˜’๎˜„๎˜ฐ๎™๎™‹๎™Œ๎™˜๎™›๎™…๎™–๎™‰๎˜„๎˜ถ๎˜ฉ๎˜ท๎˜ธ๎˜„๎˜ฅ๎˜ด๎˜ญ๎˜„๎˜ถ๎™‰๎™Š๎™‰๎™–๎™‰๎™’๎™‡๎™‰๎˜„ ๎˜ฑ๎˜ฑ๎˜ผ๎˜–๎˜„๎™—๎™‰๎™–๎™๎™‰๎™—๎˜„๎ฉ๎˜„๎˜น๎™—๎™‰๎™–๎˜‹๎™—๎˜„๎˜ฑ๎™…๎™’๎™™๎™…๎™๎˜„ ๎˜˜๎˜›
๎˜ฅ๎™”๎™”๎™๎™๎™‰๎™ˆ๎˜„๎™Š๎™๎™–๎™‘๎™›๎™…๎™–๎™‰๎˜„๎™”๎™…๎™‡๎™๎™…๎™‹๎™‰๎˜ž๎˜„๎™š๎˜•๎˜’๎˜—๎˜’๎˜—๎™†๎˜—๎ž๎™ ๎ž๎˜ฐ๎˜จ๎˜ง๎˜„๎™—๎™“๎™Š๎™˜๎™›๎™…๎™–๎™‰๎˜ž๎˜„๎™š๎˜–๎˜’๎˜™๎˜’๎˜•๎˜˜๎™†๎˜™
๎˜š๎˜’๎˜—๎˜’๎ฃProtocol Rules
๎˜š๎˜’๎˜—๎˜’๎˜•๎˜’๎ฃCommand Structure Example
The examples below show how to apply the REST API in different environments:
Curl in Command Line Terminal
ษฏ ๎™‡๎™™๎™–๎™๎˜„๎˜‘๎˜ผ๎˜„๎˜ด๎˜ณ๎˜ท๎˜ธ๎˜„๎˜‘๎™๎˜„๎™Œ๎™˜๎™˜๎™”๎˜ž๎˜“๎˜“๎˜•๎˜๎˜–๎˜’๎˜•๎˜š๎˜œ๎˜’๎˜”๎˜’๎˜™๎˜™๎˜“๎™…๎™”๎™๎˜“๎˜บ๎˜•๎˜“๎˜ฑ๎˜ฉ๎˜จ๎˜ญ๎˜ฅ๎˜“๎˜บ๎˜ญ๎˜จ๎˜ฉ๎˜ณ๎˜“๎˜ผ๎˜ด๎˜“๎™—๎™›๎™๎™˜๎™‡๎™Œ๎˜„๎˜‘๎˜‘๎™ˆ๎™…๎™˜๎™…๎˜„๎˜ญ๎˜–๎˜ž๎˜ณ๎˜•
REST API Client in Mozilla
Method: POST
URL:๎˜„๎™Œ๎™˜๎™˜๎™”๎˜ž๎˜“๎˜“๎˜•๎˜๎˜–๎˜’๎˜•๎˜š๎˜œ๎˜’๎˜”๎˜’๎˜™๎˜™๎˜“๎™…๎™”๎™๎˜“๎˜บ๎˜•๎˜“๎˜ฑ๎˜ฉ๎˜จ๎˜ญ๎˜ฅ๎˜“๎˜บ๎˜ญ๎˜จ๎˜ฉ๎˜ณ๎˜“๎˜ผ๎˜ด๎˜“๎™—๎™›๎™๎™˜๎™‡๎™Œ๎˜„
Body content type:๎˜„๎™˜๎™‰๎™œ๎™˜๎˜“๎™”๎™๎™…๎™๎™’๎˜„
Body: I2:O1
๎˜š๎˜’๎˜—๎˜’๎˜–๎˜’๎ฃGeneral Rules
โ–ช All names and parameters are case-insensitive.
โ–ช ๎˜ธ๎™Œ๎™‰๎˜„๎™‘๎™‰๎™˜๎™Œ๎™“๎™ˆ๎™—๎˜๎˜„๎™’๎™“๎™ˆ๎™‰๎™—๎˜„๎™…๎™’๎™ˆ๎˜„๎™”๎™–๎™“๎™”๎™‰๎™–๎™˜๎™๎™‰๎™—๎˜„๎™…๎™–๎™‰๎˜„๎™—๎™‰๎™”๎™…๎™–๎™…๎™˜๎™‰๎™ˆ๎˜„๎™†๎™๎˜„๎™…๎˜„๎™—๎™๎™…๎™—๎™Œ๎˜„๎˜Œ๎ฌ๎˜“๎ญ๎˜๎˜„๎™‡๎™Œ๎™…๎™–๎™…๎™‡๎™˜๎™‰๎™–๎˜’
โ–ช The node name consists of letters of the English alphabet and numbers.
โ–ช ๎˜ฅ๎™๎™๎˜„๎™”๎™–๎™“๎™”๎™‰๎™–๎™˜๎™๎™‰๎™—๎˜„๎™…๎™’๎™ˆ๎˜„๎™‘๎™‰๎™˜๎™Œ๎™“๎™ˆ๎™—๎˜„๎™…๎™–๎™‰๎˜„๎™…๎™š๎™…๎™๎™๎™…๎™†๎™๎™‰๎˜„๎˜ฌ๎˜ธ๎˜ธ๎˜ด๎˜Œ๎˜ท๎˜๎˜„๎™†๎™‰๎™๎™“๎™›๎˜„๎˜“๎™…๎™”๎™๎˜„๎™…๎™—๎˜„๎™…๎™’๎˜„๎˜น๎˜ถ๎˜ฐ๎˜’
โ–ช ๎˜ธ๎™Œ๎™‰๎˜„๎˜ฌ๎˜ธ๎˜ธ๎˜ด๎˜„๎™—๎™‰๎™–๎™š๎™‰๎™–๎˜„๎™๎™—๎˜„๎™…๎™š๎™…๎™๎™๎™…๎™†๎™๎™‰๎˜„๎™“๎™’๎˜„๎™”๎™“๎™–๎™˜๎˜„๎˜œ๎˜”๎˜๎˜„๎™˜๎™Œ๎™‰๎˜„๎˜ฌ๎˜ธ๎˜ธ๎˜ด๎˜ท๎˜„๎™—๎™‰๎™–๎™š๎™‰๎™–๎˜„๎™๎™—๎˜„๎™…๎™š๎™…๎™๎™๎™…๎™†๎™๎™‰๎˜„๎™“๎™’๎˜„๎™”๎™“๎™–๎™˜๎˜„๎˜˜๎˜˜๎˜—๎˜’
โ–ช ๎˜ซ๎˜ฉ๎˜ธ๎˜„๎˜“๎˜„๎˜ด๎˜น๎˜ธ๎˜“๎˜„๎˜ด๎˜ณ๎˜ท๎˜ธ๎˜„๎™‘๎™‰๎™˜๎™Œ๎™“๎™ˆ๎™—๎˜„๎™…๎™–๎™‰๎˜„๎™—๎™™๎™”๎™”๎™“๎™–๎™˜๎™‰๎™ˆ๎˜’
โ–ช Header contains the IP address (or hostname) and the nodepath.
โ–ช Arguments and property values should be given in the HTTP requestโ€™s body as a plain text.
โ–ช ๎˜ถ๎˜ฉ๎˜ท๎˜ธ๎˜„๎˜ฅ๎˜ด๎˜ญ๎˜„๎˜‘๎˜„๎˜ฐ๎˜ป๎˜—๎˜„๎™‡๎™“๎™’๎™š๎™‰๎™–๎™˜๎™‰๎™–๎˜„๎™ˆ๎™“๎™‰๎™—๎˜„๎™‰๎™—๎™‡๎™…๎™”๎™๎™’๎™‹๎˜„๎™…๎™™๎™˜๎™“๎™‘๎™…๎™˜๎™๎™‡๎™…๎™๎™๎™๎˜’
โ–ช The node paths describe the exact location of the node, listing each parent node up to the root.
โ–ช ๎˜ธ๎™Œ๎™‰๎˜„๎™—๎™™๎™”๎™”๎™“๎™–๎™˜๎™‰๎™ˆ๎˜„๎˜ฌ๎˜ธ๎˜ธ๎˜ด๎˜„๎™”๎™–๎™“๎™˜๎™“๎™‡๎™“๎™๎˜ž๎˜„๎™—๎™˜๎™…๎™’๎™ˆ๎™…๎™–๎™ˆ๎˜„๎˜ฌ๎˜ธ๎˜ธ๎˜ด๎˜“๎˜•๎˜’๎˜•
โ–ช There is no maxiumum size or character length of the request.
๎˜Ÿ header: POST http://192.168.0.50/api/V1/MEDIA/VIDEO/XP/switch HTTP/1.1
๎˜Ÿ body: I2:O1
๎˜ž header: 200 OK
Part of the HTTP structure
Request
HTTP method
(GET/POST/PUT)
IP address or hostname of
the target device
Response
Part of the HTTP structure
Nodepath
Supported HTTP
version
Method
/property
HTTP status code
Value of the property/method
๎˜š๎˜’๎˜—๎˜’๎˜—๎˜’๎ฃLegend for the Control Commands
Command and Response โ€“ Example
ษฏ header: GETยท<ip>๎˜“๎™…๎™”๎™๎˜“๎˜บ๎˜•๎˜“๎˜ฑ๎˜ฉ๎˜จ๎˜ญ๎˜ฅ๎˜“๎˜บ๎˜ญ๎˜จ๎˜ฉ๎˜ณ๎˜“<in>๎˜“๎˜ท๎™๎™‹๎™’๎™…๎™๎˜ด๎™–๎™‰๎™—๎™‰๎™’๎™˜๎™ธ๎˜ฌ๎˜ธ๎˜ธ๎˜ด๎˜“๎˜•๎˜’๎˜•
ษฎ body: <status code>
Format Description
<ip> IP address or hostname of the target device
<in> Input port number
<out> Output port number
<port> Input or output port number
<loc> ๎˜ฐ๎™“๎™‡๎™…๎™˜๎™๎™“๎™’๎˜„๎™’๎™™๎™‘๎™†๎™‰๎™–
<parameter> ๎˜บ๎™…๎™–๎™๎™…๎™†๎™๎™‰๎˜„๎™ˆ๎™‰๎žค๎™’๎™‰๎™ˆ๎˜„๎™…๎™’๎™ˆ๎˜„๎™ˆ๎™‰๎™—๎™‡๎™–๎™๎™†๎™‰๎™ˆ๎˜„๎™๎™’๎˜„๎™˜๎™Œ๎™‰๎˜„๎™‡๎™“๎™‘๎™‘๎™…๎™’๎™ˆ
<expression>
Batched parameters: the underline means that more
expressions or parameters can be placed by using a
semicolon, e.g. I2;I4 or F27:E1;F47:E2
ษฏ
Sent request
ษฎ
Received response
ยท Space character
Further, not listed <parameters>๎˜„๎™…๎™–๎™‰๎˜„๎™ˆ๎™‰๎žค๎™’๎™‰๎™ˆ๎˜„๎™…๎™˜๎˜„๎™‰๎™…๎™‡๎™Œ๎˜„๎™‡๎™“๎™‘๎™‘๎™…๎™’๎™ˆ๎™—๎˜’
๎˜š๎˜’๎˜—๎˜’๎˜˜๎˜’๎ฃLightware REST API vs. LW3 Protocol
๎˜ฅ๎™๎™๎˜„๎™‘๎™‰๎™˜๎™Œ๎™“๎™ˆ๎™—๎˜„๎™…๎™’๎™ˆ๎˜„๎™”๎™–๎™“๎™”๎™‰๎™–๎™˜๎™๎™‰๎™—๎˜„๎™“๎™Š๎˜„๎™˜๎™Œ๎™‰๎˜„๎˜ฐ๎˜ป๎˜—๎˜„๎™˜๎™–๎™‰๎™‰๎˜„๎™—๎™˜๎™–๎™™๎™‡๎™˜๎™™๎™–๎™‰๎˜„๎™…๎™”๎™”๎™‰๎™…๎™–๎˜„๎™†๎™‰๎™๎™“๎™›๎˜„๎˜“๎™…๎™”๎™๎˜„๎™…๎™—๎˜„๎™…๎˜„๎˜ฌ๎˜ธ๎˜ธ๎˜ด๎˜Œ๎™—๎˜๎˜„๎˜น๎˜ถ๎˜ฐ๎˜’๎˜„๎˜ธ๎™Œ๎™‰๎˜„๎™—๎™‰๎™”๎™…๎™–๎™…๎™˜๎™“๎™–๎˜„
character is always a ๎™—๎™๎™…๎™—๎™Œ๎˜„๎˜Œ๎ฌ๎˜“๎ญ๎˜๎˜„๎™‡๎™Œ๎™…๎™–๎™…๎™‡๎™˜๎™‰๎™–๎˜„๎™๎™’๎™—๎™˜๎™‰๎™…๎™ˆ๎˜„๎™“๎™Š๎˜„๎™”๎™“๎™๎™’๎™˜๎˜„๎˜Œ๎˜‹๎˜’๎˜‹๎˜๎˜„๎™…๎™’๎™ˆ๎˜„๎™‡๎™“๎™๎™“๎™’๎˜„๎˜Œ๎˜‹๎˜ž๎˜‹๎˜๎˜’๎˜„๎˜ธ๎™Œ๎™‰๎˜„๎˜น๎˜ถ๎˜ฐ๎˜„๎™๎™—๎˜„๎™‡๎™…๎™—๎™‰๎˜‘๎™๎™’๎™—๎™‰๎™’๎™—๎™๎™˜๎™๎™š๎™‰๎˜’
Example
๎˜ธ๎™Œ๎™‰๎˜„๎˜ฐ๎˜ป๎˜—๎˜„๎™”๎™–๎™“๎™”๎™‰๎™–๎™˜๎™๎˜ž
๎˜„๎˜“๎˜บ๎˜•๎˜“๎˜ฑ๎˜ฉ๎˜จ๎˜ญ๎˜ฅ๎˜“๎˜บ๎˜ญ๎˜จ๎˜ฉ๎˜ณ๎˜“๎˜ญ๎˜–๎˜’๎˜ฅ๎™‡๎™˜๎™๎™š๎™‰๎˜ถ๎™‰๎™—๎™“๎™๎™™๎™˜๎™๎™“๎™’
Available in REST API:
๎˜•๎˜๎˜–๎˜’๎˜•๎˜š๎˜œ๎˜’๎˜”๎˜’๎˜•๎˜“๎™…๎™”๎™๎˜“๎˜บ๎˜•๎˜“๎˜ฑ๎˜ฉ๎˜จ๎˜ญ๎˜ฅ๎˜“๎˜บ๎˜ญ๎˜จ๎˜ฉ๎˜ณ๎˜“๎˜ญ๎˜•๎˜“๎˜ฅ๎™‡๎™˜๎™๎™š๎™‰๎˜ถ๎™‰๎™—๎™“๎™๎™™๎™˜๎™๎™“๎™’
๎˜•๎˜๎˜–๎˜’๎˜•๎˜š๎˜œ๎˜’๎˜”๎˜’๎˜•๎˜“๎˜ฅ๎˜ด๎˜ญ๎˜“๎™š๎˜•๎˜“๎™‘๎™‰๎™ˆ๎™๎™…๎˜“๎™š๎™๎™ˆ๎™‰๎™“๎˜“๎™๎˜•๎˜“๎™…๎™‡๎™˜๎™๎™š๎™‰๎™–๎™‰๎™—๎™“๎™๎™™๎™˜๎™๎™“๎™’
๎˜ธ๎™Œ๎™‰๎˜„๎™Š๎™“๎™๎™๎™“๎™›๎™๎™’๎™‹๎˜„๎™Š๎™‰๎™…๎™˜๎™™๎™–๎™‰๎™—๎˜„๎™…๎™–๎™‰๎˜„๎™๎™‘๎™”๎™๎™‰๎™‘๎™‰๎™’๎™˜๎™‰๎™ˆ๎˜„๎™“๎™’๎™๎™๎˜„๎™๎™’๎˜„๎˜ถ๎˜ฉ๎˜ท๎˜ธ๎˜„๎˜ฅ๎˜ด๎˜ญ๎˜๎˜„๎™†๎™™๎™˜๎˜„๎™’๎™“๎™˜๎˜„๎™๎™’๎˜„๎˜ฐ๎˜ป๎˜—๎˜„๎™”๎™–๎™“๎™˜๎™“๎™‡๎™“๎™๎˜ž
โ–ช Sending a Message via RS-232
๎˜ธ๎™Œ๎™‰๎˜„ ๎™‘๎™“๎™—๎™˜๎˜„ ๎™๎™‘๎™”๎™“๎™–๎™˜๎™…๎™’๎™˜๎˜„ ๎™‡๎™“๎™‘๎™‘๎™…๎™’๎™ˆ๎™—๎˜„ ๎™…๎™–๎™‰๎˜„ ๎™๎™๎™—๎™˜๎™‰๎™ˆ๎˜„ ๎™๎™’๎˜„ ๎™˜๎™Œ๎™๎™—๎˜„ ๎™‡๎™Œ๎™…๎™”๎™˜๎™‰๎™–๎˜’๎˜„ ๎˜ณ๎™˜๎™Œ๎™‰๎™–๎˜„ ๎™‡๎™“๎™‘๎™‘๎™…๎™’๎™ˆ๎™—๎˜„ ๎™‡๎™…๎™’๎˜„ ๎™†๎™‰๎˜„ ๎™๎™’๎™Š๎™‰๎™–๎™–๎™‰๎™ˆ๎˜„๎™†๎™๎˜„๎™˜๎™Œ๎™‰๎˜„ ๎˜ฐ๎˜ป๎˜—๎˜„
tree structure, where the read-only (eg. pr๎˜„ ๎˜“๎˜บ๎˜•๎˜“๎˜ฑ๎˜ฉ๎˜จ๎˜ญ๎˜ฅ๎˜“๎˜บ๎˜ญ๎˜จ๎˜ฉ๎˜ณ๎˜“๎˜ญ๎˜˜๎˜’๎˜ง๎™“๎™’๎™’๎™‰๎™‡๎™˜๎™‰๎™ˆ๎˜๎˜„ ๎™…๎™’๎™ˆ๎˜„ ๎™–๎™‰๎™…๎™ˆ๎˜‘๎™›๎™–๎™๎™˜๎™‰๎˜„ ๎™”๎™–๎™“๎™”๎™‰๎™–๎™˜๎™๎™‰๎™—๎˜„
(pw๎˜„ ๎˜“๎˜บ๎˜•๎˜“๎˜ฑ๎˜ฉ๎˜จ๎˜ญ๎˜ฅ๎˜“๎˜บ๎˜ญ๎˜จ๎˜ฉ๎˜ณ๎˜“๎˜ญ๎˜˜๎˜’๎˜ฒ๎™…๎™‘๎™‰๎˜๎˜„ ๎™‡๎™…๎™’๎˜„ ๎™†๎™‰๎˜„ ๎™๎™๎™—๎™˜๎™‰๎™ˆ๎˜’๎˜„ ๎˜ช๎™“๎™–๎˜„ ๎™‘๎™“๎™–๎™‰๎˜„ ๎™ˆ๎™‰๎™˜๎™…๎™๎™๎™—๎˜„ ๎™…๎™†๎™“๎™™๎™˜๎˜„ ๎˜ฐ๎˜ป๎˜—๎˜„ ๎™˜๎™–๎™‰๎™‰๎˜„ ๎™—๎™˜๎™–๎™™๎™‡๎™˜๎™™๎™–๎™‰๎˜๎˜„ ๎™—๎™‰๎™‰๎˜„ ๎™˜๎™Œ๎™‰๎˜„
๎˜ฐ๎˜ป๎˜—๎˜„๎˜ด๎™–๎™“๎™‹๎™–๎™…๎™‘๎™‘๎™‰๎™–๎™—๎ญ๎˜„๎˜ถ๎™‰๎™Š๎™‰๎™–๎™‰๎™’๎™‡๎™‰ section or the๎˜„๎˜ฅ๎™ˆ๎™š๎™…๎™’๎™‡๎™‰๎™ˆ๎˜„๎˜บ๎™๎™‰๎™›๎˜„๎˜ป๎™๎™’๎™ˆ๎™“๎™›๎˜’
๏„ข
๏“
๏”
๏€•

Table of Contents

Related product manuals