Side Band Command Channel

Note: This section only applies to the SierraNet T328, M328, and M328Q models.

TCP Port 4004 of the analyzer Ethernet host interface is defined for exclusive use as a side-band command channel. Any client may send commands to this port. There are no responses defined for these commands. The structure of a command sent on this channel is an ASCII-encoded text string with length 1-256 bytes. Commands are case-sensitive. The last character of each command must be ‘!’—the receiving port expects this character as a command delimiter.

It is the sender’s responsibility to ensure the analyzer is in the proper state for its issued command to have the expected result.

The commands defined for this channel are:

Command (ASCII text)

Description

TRIGGER_ANALYZER!

Assuming the analyzer is in the waiting-for-trigger state, this command will cause it to trigger. Otherwise, the command has no effect.

STOP_ANALYZER!

Assuming the analyzer is in the recording state, this command will stop the recording immediately and enable uploading to begin.

Otherwise, the command has no effect.

Example 1: Python

Python
import socket
HOST = '1.2.3.4' # The analyzer's IP address

PORT = 4004	# The message port used by the analyzer

s = socket.socket(socket.AF_INET, socket.SOCK_STREAM) 
s.connect((HOST, PORT)) 
s.sendall(b'TRIGGER_ANALYZER!')

Example 2: Linux shell:

Bash
echo TRIGGER_ANALYZER! | netcat 1.2.3.4 4004