Interface With The JNIOR
The JNIOR has a strong list of methods that allow you to monitor, control, and configure the unit.
JNIOR Web Server
The JNIOR Web Server implements multiple features. HTTP, HTTPS, PH,P and WebSockets. WebSocket allows for bidirectional, real-time communication. This allows our DCP (Dynamic Configuration Page) to work. Use the DCP for manual monitoring, control, and configuration.
JMP Protocol
The JMP Protocol is available in JANOS 1.8! The JMP protocol shares the messaging JSON structure that is used by the DCP (Dynamic Configuration Page) and the web-socket protocol but on port 9220, by default.
To make processing easier we wrapped the JSON message in a two-element JSON Array.
[ number, object ]
Where number is the size in bytes/characters of the JSON object that follows.
Doing this relieves us of needing to count braces to see when an entire JSON message was received. To parse the structure we can do the following:
- Look for the opening ‘[‘.
- Then process numeric values until a ‘,’ is found. White space is ignored.
- White space is again ignored and N bytes are read.
- Finally, the remaining white space is ignored and the trailing ‘]’ is confirmed.
If the numeric value is invalid, the comma missing, or the trailing ‘]’ bracket is not found, the entire message is to be ignored. The extracted JSON Object can then be validated as well.
| Name | Version | Release Date | Size | MD5 |
|---|---|---|---|---|
| JMP Protocol Manual | v2.0 | Mar 14 2024 | 230.0 KB | 905f124811e438ea93ccd542bdd66f41 |
JNIOR Protocol via WebSockets
Using WebSockets and the Web Server you can monitor, control, and configure the JNIOR via JSON-formatted JNIOR Protocol packets. This is how the DCP works. The DCP is open source.
This is recommended for new development
Connecting to the JNIOR via WebSockets has many advantages
- Bidirectional real-time TCP connection. IO State is sent from the JNIOR when it
occurs without the need to poll. Less overhead! - Uses JSON for message format. Easy to read and implement.
- Uses wss:// over port 443 to be secure!
TLS v1.0 AES/256 SHA1 - Monitor, Control, and Configure as well as File System, Command Line, and Syslog functionality.
Replaces JNIOR protocol, FTP, and Telnet.
| Name | Version | Release Date | Size | MD5 |
|---|---|---|---|---|
| Websocket Access | v1 | Feb 19 2025 | 108.7 KB | 858c4ea3dd27e0dfdff8fdefcd354b1a |
A quick example using java-script in the client browser
View Example »
C# WebSocket Example using the JniorWebSocket Library
View Example »
JNIOR Protocol
Using WebSockets and the Web Server you can monitor, control, and configure the JNIOR. This is a binary protocol. This is carried over from the Series 3.
This is NOT recommended for new development. Please use the JNIOR Protocol via WebSockets
| Name | Version | Release Date | Size | MD5 |
|---|---|---|---|---|
| JNIOR-Protocol.pdf | v1 | Jul 25 2018 | 834.7 KB | 745465d75bcc8319607da1e5336a953f |
| Windows DLL | v5.0 | Feb 15 2019 | 8.9 MB | 97e02a18245994c59c96bb94c6f40fa1 |
| JNIOR DLL Manual | v1 | Jul 08 2014 | 320.1 KB | e83ac1ef1dd15044f78f92521a8e2965 |
MODBUS
MODBUS is a master/slave protocol. That means that the master is responsible for polling the JNIOR frequently to get data. There are a few variations of MODBUS that are implemented on the JNIOR; MODBUS RTU, MODBUS ASCII, and MODBUS TCP.
| Name | Version | Release Date | Size | MD5 |
|---|---|---|---|---|
| Modbus_Protocol.pdf | v1 | Jul 25 2018 | 123.4 KB | 9faa9832028e4df6bd44ec2f07a109f7 |
Serial-to-Ethernet
Serial-to-Ethernet is a software application that runs on the JNIOR that allows the JNIOR to act as a converter between a serial device connected to the JNIOR serial port and a remote application. Communication to the JNIOR is via the Ethernet network using TCP/IP.
| Name | Version | Release Date | Size | MD5 |
|---|---|---|---|---|
| Serial to Ethernet Manual | v1 | Oct 26 2021 | 208.4 KB | 0bc19c4f473728cdf0b20cfd6193de23 |
SNMP
The JNIOR supports SNMP (Simple Network Management Protocol) for querying the JNIOR I/O status, controlling the relay outputs, and configuring the I/O to be ‘traps’. The JNIOR MIB and SNMP application notes are available for download in the Support section of our website.
| Name | Version | Release Date | Size | MD5 |
|---|---|---|---|---|
| SNMP | v3.0 | May 14 2020 | 116.0 KB | 2f6f4b7686a9df9a119048a87ce174a4 |
| SNMP MIB | v3.2 | Oct 10 2024 | 2.4 KB | f07a7653ac934bea2adbdc0faed01d76 |
| JNIOR SNMP Application Note | v1 | Nov 04 2020 | 258.3 KB | 4c80489af3e84b67fcb3fcfc3b354c6a |
Beacon Protocol
The Beacon Protocol is for discovery and initial configuration. It utilizes UDP. Discovery is performed via UDP broadcasts while configuration is done using UDP point-to-point.
| Name | Version | Release Date | Size | MD5 |
|---|---|---|---|---|
| BEACON-UDP-packets.pdf | v1 | Jul 25 2018 | 103.8 KB | 34336c16f961fcebce79ce23b8df3983 |