Spectronix Eye-BERT 40G Software Programming Instructions
- July 27, 2024
- Spectronix
Table of Contents
Spectronix Eye-BERT 40G Software Programming
Product Information
Specifications
- Remote control and monitoring via USB or optional Ethernet connection
- USB driver installation is required for Windows operating systems
- The default IP address for Ethernet communication: 192.168.1.160
- Communication protocol: TCP/IP on port 2101
Product Usage Instructions
USB Interface
- Copy the file cdc_NTXPV764.inf from the supplied CD to the hard drive.
- Plug the Eye-BERT 40G into a free USB port and install the driver.
- Locate the assigned COM port number in Device Manager for communication.
Optional Ethernet Interface
The Eye-BERT 40G communicates using TCP/IP on port number 2101 with a default IP address of 192.168.1.160.
- Use the Digi Device Discovery utility to retrieve and change the IP address.
- Disable the Windows Firewall and start the program to configure network settings.
Commands
The Eye-BERT 40G communicates using ASCII data with the following command.
| Command | Response |
|---|---|
| ? (Get Unit Information) | Start of response Command Echo Unit name Firmware |
Rev
Notes:
- All communication is initiated by the host.
- Commands are not case-sensitive.
- A space or equal sign should be inserted between the command and any parameters.
- All commands should be terminated with a.
- Any response should be ignored.
FAQ
Q: How do I change the IP address of the Eye-BERT 40G?
A: Use the Digi Device Discovery utility to retrieve and change the IP address. Refer to the installation program for detailed steps.
Q: What is the default IP address for Ethernet communication?
A: The default IP address is 192.168.1.160.
Overview
- The Eye-BERT 40G allows remote control and monitoring via either a USB or optional Ethernet connection.
- Once a connection is made to the Eye-BERT using one of these interfaces, all commands and controls are the same regardless of which interface is used.
USB Interface:
- In order for Windows to recognize the Eye-BERT 40G USB port the USB driver must first be installed, after which the Eye-BERT 40G appears as an additional COM port on the computer. Currently, Windows XP, Vista, 7, and 8 are supported.
- Windows 7 requires the extra step listed below; Windows 8 requires additional steps which can be found in the following application note: http://www.spectronixinc.com/Downloads/Installing%20Under%20Windows%208.pdf
- Copy the file “cdc_NTXPV764.inf” from the supplied CD to the hard drive.
- Plug the Eye-BERT 40G into a free USB port. When the hardware installation wizard asks for the driver location, browse to the “cdc_NTXPVista.inf” file on the hard drive.
- After the driver has been installed right click “my computer” and select “properties”. In the properties window select the “hardware” tab. Click on “device manager” and expand the “Ports (COM & LPT)” item. Locate the “Spectronix, Inc.” entry and note the assigned COM number, (ie “COM4”). This is the COM port that the software will use to communicate with the Eye-BERT 40G.
- Note, that on some operating systems such as Windows 7, manual USB driver installation may be necessary.
- If the hardware installation wizard fails, go to “My Computer” > “Properties” > “Hardware” Device Manager”, and find the “Spectronix” or “SERIAL DEMO” entry under “Other Devices” and select “Update Driver”.
- At this point, you will be able to browse to the location of the driver.
Optional Ethernet Interface:
- The Eye-BERT 40G communicates using TCP/IP on port number 2101 and is shipped with a default IP address of 192.168.1.160. Connection to this port is illustrated below using HyperTerminal, TeraTerm, and RealTerm.
Changing the IP Address
- The Digi Device Discovery utility allows the user to retrieve and change the Eye-BERT IP address. The installation program “40002265_G.exe” can be found on the Spectronix or Digi websites.
- After installing the utility, disable Windows Firewall and any other virus or firewall programs and start the program. The program will report the IP and MAC addresses of all compatible devices on the network.
- Right-click on the device and select “Configure
- Network Settings” to change the network settings.
Commands
- The Eye-BERT 40G uses ASCII data to communicate with a host computer; the tables below list the individual commands, parameters, and responses from the Eye-BERT 40G.
Notes:
- All communication is initiated by the host.
- Commands are not case-sensitive.
- A space or equal sign should be inserted between the command and any parameters.
- All commands should be terminated with a
. - Any
response should be ignored
Get Unit Information
Command:| Parameters:
“?”| (none)
Response:| Parameters:
Start of response| {
Command Echo| ?:
Unit name| Eye-BERT 40G 100400A
Firmware Rev| V1.0
Termination| }
---|---
Notes:|
Set the data rate
Command:| Parameters:
“SetRate”| “########” (Bit Rate in Kbps)
Response:| Parameters:
(none)|
Notes:| Sets to the closest standard bit rate Example:
“setrate=39813120” for 39.813120Gbps.
Set the pattern (generator and detector)
Command:| Parameters:
“SetPat”| “7” (PRBS 2 7-1)
“3” (PRBS 2 31-1)
“x” (K28.5 pattern)
Response:| Parameters:
(none)|
Notes:| Example: “setpat=7”
Reset error counters, BER, and test timers
Command:| Parameters:
“Reset”| (none)
Response:| Parameters:
(none)|
Notes:|
Read the status and settings
Command:| Parameters:
“Stat”| (none)
Response:| Parameters:
Start of response| {
Command Echo| STAT:
SFP Tx wavelength (nm)| 1310.00
SFP temperature (°C)| 42
---|---
Bit rate (bps)| 39813120000
Pattern| 3
(per “setpat” command)
Termination| }
Notes:| All parameters are separated by “,”
Example:
{STAT: 1310.00, 42, 39813120000, 3}
Read the measurements
Command:| Parameters:
“meas”| (none)
Response:| Parameters:
Start of response| {
Command Echo| MEAS:
Channel Number| 1
“1 through 4”
Tx polarity or off| X
“+ or – or X = off”
Rx polarity| +
“+ or -”
Rx power (dBm)| – 21.2
Signal Status| Sig
“Sig” or “LOS”
Lock Status| Lock
“Lock” or “LOL”
Error count| 2.354e04
Bit count| 1.522e10
BER| 1.547e- 06
Test Time (seconds)| 864
Termination| }
Tests the transceiver and returns a test report
Command:| Parameters:
“Test”|
Response:| Parameters:
Test Report| (ASCII text formatted information about the QSFP including
Vendor, Model, Serial Number, Power Levels, and data from all registers)
Start of response| {
Command Echo| Test:
QSFP Registers:|
Termination| }
Notes:| Testing consists of the following:
1. Receiver power level <= -10dBm with the transmitter off
2. QSFP must report LOS with the transmitter off
3. Receiver power level > -10dBm with the transmitter on
4. QSFP must not report LOS with the transmitter on
5. If the BER is > 0, an error is reported if the test rate is within 100Mbps of the advertised rate, otherwise a warning is reported.
In the example above, channel 3 reported low receive power when the transmitter was enabled resulting in an error. The BER test failed at 41.25Gbps since the device is rated for 41.2Gbps (10.3*4) and warnings were flagged for each other rate that reported errors.
Note these tests may not be appropriate for all transceivers.
---|---
Prints Transceiver Register Information and Values
Command:| Parameters:
“PrintQSFP”|
Response:| Parameters:
QSFP information| (ASCII text formatted information about the QSFP
including Vendor, Model, Serial Number, Power Levels, and data from all
registers)
Start of response| {
Command Echo| PRINTQSFP:
QSFP Registers:|
Read QSFP Register
Command:| Parameters:
“RdQSFP”| “P” “A” “P”: register page – 0 through 3, “A”: register
number in hex – 0 through FF
Example: ”RdQSFP 0 0xC4”
Reads the first byte of the serial number from the information register at address 0xC4 in page 0.
Response:| Parameters:
Start of response| {
Command Echo| RDQSFP:
Register type, register number, value| Example: ”P00:c4 = 4d”
(page 0, address 0xC4= 0x4d (“M” ASCII)
Termination| }
Notes:| All values passed in and returned are in hex, preceding “0x” is
optional. Input parameters should be separated by a space. Note, not all QSFP
vendors support reading and writing all locations. See SFF-8438 for more
information.
Write SFP Register, then respond with read read-back value
Command:| Parameters:
“WrQSFP”| “P” “A” “D” “P”: register page – 0 through 3, “A”:
register number in hex – 0 through FF, “D”: value to be written in hex.
Example: ”WrQSFP 0 0x56 0x0F”
Writes 0x0F to address 0x56 to turn all four transmitters off. Note, since address 0x56 is in the lower address space the page number is irrelevant.
Response:| Parameters:
Start of response| {
Command Echo| WRQSFP:
Register type, register number, value| Example: ”P00:56 = 0F”
(diagnostic register (0xA2), register number (0x80), value read back (0x55)
Termination| }
Notes:| All values passed in and returned are in hex, preceding “0x” is
optional. Input parameters should be separated by a space. Note, not all QSFP
vendors support reading and writing all locations. See SFF-8438 for more
information.
www.spectronixinc.com Eye-BERT 40G Software Programming Guide V 1.1