This repository contains a description of the NanoSEC switch matrix, as well as all the relevant source code, to control the board. The material in this repository corresponds to the paper:
The circuit is subdivided into two parts, a control part and a measurement part. The measurement part consists of a 12 V power supply forwarded to four darlington arrays (ULN2003APW), which are responsible for switching the Finder 40.41 relays. Single lines on the darlington arrays are controlled by two 2/16 ADG726 multiplexers. The multiplexer transform a four bit input address signal to a parallel output signal which selects a specific row and column relay over the Darlington arrays. The multiplexers are controlled by a Arduino Nano.
The measurement part consists of four BNC connectors I_D, V_DS, V_GS and GND. V_DS connects is forwarded to each CNT_FETs on the matrix not switched. I_D is forwarded to the selected row. GND is forwarded to the selected column. V_GS is connected to the global gate.
This table contains an overview of the components on the Motherboard. Each component is identified by a Symbol ID.
| Symbol | Component | Description |
|---|---|---|
| U1 | 5-1634556-0-1 . | PCI-E M.2 Key M connector to mount the daugher boards |
| U2 | ALN2003APW. | Darlington arrays consists of two transistors to forward 12V to the relays controlled by a 3V control signal (Responsible for relay 19 - 23 column). |
| U3 | ALN2003APW. | Darlington arrays consists of two transistors to forward 12V to the relays controlled by a 3V control signal (Responsible for relay 7 - 12 column). |
| U4 | ADG726 Multiplexer. | 2x16 Multiplexer to forward parallel lines to the Darlington Arrays controlled by a 4-bit column address. |
| U5 | ALN2003APW. | Darlington arrays consists of two transistors to forward 12V to the relays controlled by a 3V control signal (Responsible for relay 1 - 6 row). |
| U6 | ALN2003APW. | Darlington arrays consists of two transistors to forward 12V to the relays controlled by a 3V control signal (Responsible for relay 13 - 18 row). |
| U7 | 5-1634556-0-1 . | Angled BNC connector to connect the V_GS signal. |
| U8 | 5-1634556-0-1 . | Angled BNC connector to connect the V_DS signal. |
| U9 | 5-1634556-0-1 . | Angled BNC connector to connect the I_D signal. |
| U10 | 5-1634556-0-1 . | Angled BNC connector to connect the GND signal. |
| U11 | ADG726 Multiplexer. | 2x16 Multiplexer to forward parallel lines to the Darlington Arrays controlled by a 4-bit row address. |
| K1-K12 | Finder 0.51.9.012.0000 | Single Pole Double Throw Relay to select a column on the daugherboard and forward GND to the CNT FET if not switched V_DS is forwarded |
| K13-K24 | Finder 0.51.9.012.0000 . | Single Pole Double Throw Relay to select a row on the daugherboard and forward I_D to the CNT FET if not switched V_DS is forwarded |
| R1 | Diode xx | |
| C1 | Capacitor xx | Stabilizes possible variations caused by the DC power supply |
| A1 | Arduino Nano Connector. | Pin Socket connector Pitch 2.54 to connect an Arduino Nano to the board |
| J1 | DA selector | Debugging Pin to connect the Data output (here data output serves as input and is forwarded to the parallel lines) connectors of U4 (Lower Row) and CS signal of U11 (Upper Row) with the 3.3V pin of the Arduino. The rows must be connected horizontally by a 2.54mm Jumper |
| J2 | CS selector | Debugging Pin to connect the CS signal of U4 (Lower Row) and CS signal of U11 (Upper Row) with D3 and D2 pin of the Arduino. The rows must be connected horizontally by a 2.54mm Jumper |
| J3 | WE selector | Debugging Pin to connect the WE signal of U4 (Lower Row) and CS signal of U11 (Upper Row) with D9 and D10 pin of the Arduino. The rows must be connected horizontally by a 2.54mm Jumper |
| J4 | EN selector | Debugging Pin to connect the EN signal of U4 (Lower Row) and EN signal of U11 (Upper Row) with A4 and A5 pin of the Arduino. The rows must be connected horizontally by a 2.54mm Jumper |
| J5 | Arduino additional pin header | Additional pin header to access UART TX and RX pins as well as GND and the SPI interface of the Arduino Nano |
| J6 | BarrelJack Wuerth 6941xx301002 . | Wuerth electronics barrel jack connector (5.5mm outher diameter, inner diameter 2.55mm) used to connect a 12V power supply used to switch the relays |
| J7 | Shielding connector | Pin header to connect the GND BNC connector U10 with the shielding of all other BNC connectors by using a 2.54mm Jumper. |
| J9 | Ground Pad connector | Pin header to connect the daughter board ground connector with the GND BNC connector U10. |
| J10 | V_DS connector | Connector to forward V_DS to the row and column relays. Must be connected by a 2.54mm jumper. |
| MP* | Mounting holes | To mount the board using M2 or M3 screws to a holder or case. The four mounting holes in the vicinity of the M.2 interface are used to mount holders for the daugherboard. The hole are placed according to the PC/104 EBX standard. |
The following tables contain the connections between the components described in 1.1.
| Pin Arduino | Description | ADG726 (U4) | Description |
|---|---|---|---|
| Pin 16 | 3.3V | Pin 13 | VDD |
| Pin 16 | 3.3V | Pin 14 | VDD |
| Pin 4/29 | GND | Pin 23 | GND |
| Pin 4/29 | GND | Pin 24 | VSS |
| Pin 5 | A2 | Pin 19 | CSA |
| Pin 5 | A2 | Pin 20 | CSB |
| Pin 12 | D9 | Pin 21 | WR |
| Pin 23 | A4 | Pin 22 | EN |
| Pin 16 | 3.3V | Pin 43 | DA |
| Pin 19 | A0 | Pin 15 | A0 |
| Pin 20 | A1 | Pin 16 | A1 |
| Pin 21 | A2 | Pin 17 | A2 |
| Pin 22 | A3 | Pin 18 | A3 |
| Darlington U3 | Description | Pin ADG726 (U4) | Description |
|---|---|---|---|
| Pin 1 | I1 | Pin 1 | S12A |
| Pin 2 | I2 | Pin 2 | S11A |
| Pin 3 | I3 | Pin 3 | S10A |
| Pin 4 | I4 | Pin 4 | S9A |
| Pin 5 | I5 | Pin 5 | S8A |
| Pin 6 | I6 | Pin 6 | S7A |
| Pin 8 | GND | Pin 4/29 | GND |
| Darlington U2 | Description | Pin ADG726 (U4) | Description |
|---|---|---|---|
| Pin 1 | I1 | Pin 7 | S8A |
| Pin 2 | I2 | Pin 8 | S7A |
| Pin 3 | I3 | Pin 9 | S6A |
| Pin 4 | I4 | Pin 10 | S5A |
| Pin 5 | I5 | Pin 11 | S4A |
| Pin 6 | I6 | Pin 12 | S3A |
| Pin 8 | GND | Pin 4/29 | GND |
| Pin Arduino | Description | ADG726 (U11) | Description |
|---|---|---|---|
| Pin 16 | 3.3V | Pin 13 | VDD |
| Pin 16 | 3.3V | Pin 14 | VDD |
| Pin 4/29 | GND | Pin 23 | GND |
| Pin 4/29 | GND | Pin 24 | VSS |
| Pin 6 | D3 | Pin 19 | CSA |
| Pin 6 | D3 | Pin 20 | CSB |
| Pin 13 | D10 | Pin 21 | WR |
| Pin 24 | A5 | Pin 22 | EN |
| Pin 16 | 3.3V | Pin 43 | DA |
| Pin 8 | D5 | Pin 15 | A0 |
| Pin 9 | D6 | Pin 16 | A1 |
| Pin 10 | D7 | Pin 17 | A2 |
| Pin 11 | D8 | Pin 18 | A3 |
| Pin U6 | Description | Pin ADG726 (U11) | Description |
|---|---|---|---|
| Pin 1 | I1 | Pin 6 | S7A |
| Pin 2 | I2 | Pin 5 | S8A |
| Pin 3 | I3 | Pin 4 | S9A |
| Pin 4 | I4 | Pin 3 | S10A |
| Pin 5 | I5 | Pin 2 | S11A |
| Pin 6 | I6 | Pin 1 | S12A |
| Pin 8 | GND | Pin 4/29 | GND |
| Pin U5 | Description | Pin ADG726 (U11) | Description |
|---|---|---|---|
| Pin 1 | I1 | Pin 12 | S3A |
| Pin 2 | I2 | Pin 11 | S4A |
| Pin 3 | I3 | Pin 10 | S5A |
| Pin 4 | I4 | Pin 9 | S6A |
| Pin 5 | I5 | Pin 8 | S7A |
| Pin 6 | I6 | Pin 7 | S8A |
| Pin U2, U3, U5, U6 | Description | Component (Pin) | Description |
|---|---|---|---|
| Pin 8 | GND | Arduino Pin (Pin 4/29), J6 (GND) | GND |
| Pin 9 | COM | J6 (VDD) | 12 V Power Supply |
| Pin J1 | Description | Component | Description |
|---|---|---|---|
| Pin 1 | GND Pad | J9 | Connected with ground pad connector forwarded to BNC GND (U10) |
| Pin 3 | Row 1 | K13 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 5 | Row 2 | K14 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 7 | Row 3 | K15 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 9 | Row 4 | K16 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 11 | Row 5 | K17 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 13 | Row 6 | K18 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 15 | Column 1 | K1 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 17 | Column 2 | K3 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 19 | Column 3 | K5 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 21 | Column 4 | K7 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 23 | Column 5 | K9 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 25 | Column 6 | K11 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 27 | Row 7 | K19 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 29 | Row 8 | K20 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 31 | Row 9 | K21 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 33 | Row 10 | K22 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 35 | Row 11 | K23 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 37 | Row 12 | K24 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 39 | Column 7 | K2 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 41 | Column 8 | K4 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 43 | Column 9 | K6 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 45 | Column 10 | K8 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 47 | Column 11 | K10 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 49 | Column 12 | K12 | Connected to Relay output (Pin 11). Line length: 318 mm |
| Pin 53 | V_GS | U7 | Connected to the V_GS BNC connector. Line length: 180 mm |
| Pin U7 | Description | Component | Description |
|---|---|---|---|
| V_GS | Gate Source connector | J1 (Pin 53) | Connects to the common ground via the M.2 connector Pin 53 |
| Pin U8 | Description | Component | Description |
|---|---|---|---|
| V_DS | Drain Source connector | K 1 - K24 | Connected to the permanently connected input Pin 12 |
Routed on the Backside. Common length of 316 mm.
| Pin U9 | Description | Component | Description |
|---|---|---|---|
| I_D | - | K 13 - K24 | Forwarded to a specific row when a row relay is switched. |
Routed on the Backside. Common length of 140 mm.
| Pin U9 | Description | Component | Description |
|---|---|---|---|
| GND | - | K 1 - K12 | Forwarded to a specific column when a column relay is switched. |
| Pin A1 | Description | Pin J5 | Description |
|---|---|---|---|
| Pin 1 | Tx0 | Pin 1 | UART TX (Transmission) Pin. |
| Pin 2 | Rx0 | Pin 2 | UART Rx (Receive) Pin. |
| Pin 14 | SPI MOSI | Pin 3 | SPI Master out Slave in signal. |
| Pin 15 | SPI MISO | Pin 4 | SPI Slave in Master out signal. |
| Pin 16 | SPI SCK | Pin 5 | SPI clock signal. |
| Pin 7 | SPI CS | Pin 6 | SPI chip select signal. |
| Pin 4/29 | GND | Pin 7 | Ground connection. |
Connect the Arduino Nano to the NanoSEC Switch Matrix like shown in the following picture. Use a Micro USB cable to connect the arduino to the computer. The Arduino is working if the green 'ON' led is green. If the Arduino was flashed once the firmware is automatically restarted on the device when it's connected to the power supply of the computer. The Arduino should show up in the device manager. On linux the device should be registered as '/dev/ttyUSB0'.
A DC power supply must be connected to drive the relays. The power supply can be connected by the barrel jack connector on the left buttom of the board or by connecting jumper cables to the power supply pins below the barrel jack connector.
Please check the maximum ratings like described in the following table.
| Unit | Minimum | Maximum |
|---|---|---|
| Voltage | 12 | 12 |
| Current | 83mA | 500mA |
When two relays are switched a current of 83mA can be observed on a DC power supply like shown in the subsequent figure.
The board contains several Jumpers for debugging purposes or to execute differnt types of measurements.
TODO add jumper descriptions.
The code is basically subdivided into two different components.
- The Arduino Firmware which is the code executed on the Arduino Nano.
It accepts commands via an UART interface and forwards the commands to the multiplexers, which switch the corresponding rows and columns.
- The Client Side API is executed on the computer responsible for the test execution and communicates the commands to the Arduino Nano via an UART interface.
On Windows:
Follow the link:
https://git-scm.com/download/win
And install the executable.
On Linux:
# apt-get install git
$ git clone https://github.com/FlorianFrank/measurement_switch_matrix.git
Cloning into 'measurement_switch_matrix'...
Username for 'https://github.com': test
Password for 'https://[email protected]': test123
$ git pull
Updates the current working copy to the current version on the repo.
First hte avr-gcc compiler must be installed. Therefore, go to Arduino_Firmware/Toolchain/SysGCC and execute avr-gcc5.3.0.exe . You see an installation dialog. Like shown the in the figure below. Select the Arduino_firmware/Toolchain/ directory and install the compiler.
Further tools like cmake and ninja are already included in the repository in the Toolchain folder and do not have to be installed manually.
We are using AVRDude to flash the firmware image on the Arduino Nano. You can find the installation under Toolchain/AVRDude.
On Windows:
There is alredy a precompiled version under AVRDude/bin/Win32 so the files don't need to be compiled
On Linux:
Go to AVRDude and run:
./compile_linux.sh
Afterwareds you will find the avr compilation under bin/amd64.
Press the windows button on the keyboard and go to the device manager. The device should be listed as "USB Serial Port (COM[ID])". In a next step adjust the settings.cmake.
In the Arduino_Firmware folder you can find a settings.cmake file.
These contain the most important properties of the firmware.
To build and flash the Arduino firmware. Only the USB_Port must be adjusted. You can check out the correct
'COM' port in the device manager.
option(BUILD_DOCUMENTATION "BUILD_DOCUMENTATION" OFF)
option(ARDUINO_NANO_OLD "BUILD for old Arduino Nano Board (blue)" ON)
option(USB_PORT "Set the USB port on Linux /dev/ttyUSB0 on windows COM<comID>" "COM6")
option(ARDUINO_PROGRAMMER "Set the programmer to be used to flash the Arduino Nano" "avrispmkii")
option(ETHERNET_SUPPORT "Enable Ethernet utilizing using the AZ delivery ENC28J60 Ethernet Shield. Disable UART" ON)
When using the old version of the Arduino Nano (blue PCB) the flag ARDUINO_NANO_OLD must be set to ON.
option(ARDUINO_NANO_OLD "BUILD for old Arduino Nano Board (blue)" OFF)
# uses the atmega328 programmer
option(ARDUINO_NANO_OLD "BUILD for old Arduino Nano Board (blue)" ON)
# uses the atmega328old programmer
When using the old version of the Arduino Nano (blue PCB) the flag ARDUINO_NANO_OLD must be set to ON. To compile the firmware for the new version (green PCB) this flag must be disabled. Set the BUILD_DOCUMENTATION option to automatically build the Code Documentation as HTML and Latex files.
On Linux run:
cd ./Arduino_Firmware
./compile.sh
On Windows run:
cd ./Arduino_Firmware
./compile.bat
After comiling you find a folder ./build in the Arduino Firmware directory containing the firmware to be flashed on the Arduino Nano.
The firmware is build sucessfully when you see an output similar to the command line output below:
[100%] Linking CXX executable nanosec_crossbar_controller.elf
Generating EEP image
Generating HEX image
Calculating image size
Firmware Size: [Program: 8186 bytes (25.0%)] [Data: 641 bytes (31.3%)] on atmega328p
EEPROM Size: [Program: 0 bytes (0.0%)] [Data: 0 bytes (0.0%)] on atmega328p
[100%] Built target nanosec_crossbar_controller
On Linux run after compiling:
cd ./Arduino_Firmware
./flash.sh
On Windows after compiling:
cd ./Arduino_Firmware
./flash.bat
fterwards you should see following output:
avrdude: Version 6.4
Copyright (c) Brian Dean, http://www.bdmicro.com/
Copyright (c) Joerg Wunsch
System wide configuration file is "/home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/Toolchain/AVRDude/config/avrdude.conf"
User configuration file is "/home/florianfrank/.avrduderc"
User configuration file does not exist or is not a regular file, skipping
Using Port : /dev/ttyUSB0
Using Programmer : arduino
Overriding Baud Rate : 115200
AVR Part : ATmega328P
Chip Erase delay : 9000 us
PAGEL : PD7
BS2 : PC2
RESET disposition : dedicated
RETRY pulse : SCK
serial program mode : yes
parallel program mode : yes
Timeout : 200
StabDelay : 100
CmdexeDelay : 25
SyncLoops : 32
ByteDelay : 0
PollIndex : 3
PollValue : 0x53
Memory Detail :
Block Poll Page Polled
Memory Type Mode Delay Size Indx Paged Size Size #Pages MinW MaxW ReadBack
----------- ---- ----- ----- ---- ------ ------ ---- ------ ----- ----- ---------
eeprom 65 20 4 0 no 1024 4 0 3600 3600 0xff 0xff
flash 65 6 128 0 yes 32768 128 256 4500 4500 0xff 0xff
lfuse 0 0 0 0 no 1 1 0 4500 4500 0x00 0x00
hfuse 0 0 0 0 no 1 1 0 4500 4500 0x00 0x00
efuse 0 0 0 0 no 1 1 0 4500 4500 0x00 0x00
lock 0 0 0 0 no 1 1 0 4500 4500 0x00 0x00
calibration 0 0 0 0 no 1 1 0 0 0 0x00 0x00
signature 0 0 0 0 no 3 1 0 0 0 0x00 0x00
Programmer Type : Arduino
Description : Arduino
Hardware Version: 3
Firmware Version: 4.4
Vtarget : 0.3 V
Varef : 0.3 V
Oscillator : 28.800 kHz
SCK period : 3.3 us
avrdude: AVR device initialized and ready to accept instructions
Reading | ################################################## | 100% 0.01s
avrdude: Device signature = 0x1e950f (probably m328p)
avrdude: safemode: lfuse reads as 0
avrdude: safemode: hfuse reads as 0
avrdude: safemode: efuse reads as 0
avrdude: reading input file "/home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.hex"
avrdude: writing flash (8186 bytes):
Writing | ################################################## | 100% 3.07s
avrdude: 8186 bytes of flash written
avrdude: verifying flash memory against /home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.hex:
avrdude: load data flash data from input file /home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.hex:
avrdude: input file /home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.hex contains 8186 bytes
avrdude: reading on-chip flash data:
Reading | ################################################## | 100% 2.75s
avrdude: verifying ...
avrdude: 8186 bytes of flash verified
avrdude: reading input file "/home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.eep"
avrdude: writing eeprom (0 bytes):
Writing | ################################################## | 100% 0.00s
avrdude: 0 bytes of eeprom written
avrdude: verifying eeprom memory against /home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.eep:
avrdude: load data eeprom data from input file /home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.eep:
avrdude: input file /home/florianfrank/Documents/Research/Projects/NanoSec/measurement_switch_matrix/Arduino_Firmware/build/nanosec_crossbar_controller.eep contains 0 bytes
avrdude: reading on-chip eeprom data:
Reading | ################################################## | 100% 0.00s
avrdude: verifying ...
avrdude: 0 bytes of eeprom verified
avrdude: safemode: lfuse reads as 0
avrdude: safemode: hfuse reads as 0
avrdude: safemode: efuse reads as 0
avrdude: safemode: Fuses OK (E:00, H:00, L:00)
avrdude done. Thank you.
A lightweight communication protocol is implemented on the Arduino Nano tunneled over the USB UART interface. A UART connection is established by simply plugin in the Mini USB cable. On linux for example, the device is typically available under "/dev/ttyUSB0" on Windows the device can be seen in the device manager under "COMxx".
| Properties | Values |
|---|---|
| Baudrate | 115200 |
| Data bits | 8 |
| Stop Bits | 8 |
| Parity | None |
| Flow control | None |
| Command | Description | Allowed values |
|---|---|---|
| connect | Connect to the Arduino controller | - |
| disconnect | Disconnect the connection | - |
| r: | Select a row | 1- 12 |
| c: | Select a column | 1- 12 |
| ack | Command was acknowledged by the Arduino controller | - |
| error: | Error code returned by the Arduino controller | Any error message |
Sample accessing the protocol on linux:
$ serial /dev/ttyUSB0
$ connect
-> ack
$ r: 1
ack
$ c: 1
ack
$ column: 15
error: Invalid index
$ disconnect
ackIn the folder python_tester you can find a python test application, which switches all relays in an infinite loop.
-
On Windows:
- Install Python3 (e.g. 3.10.2) from the official home page.
- Install pyserial from the official home page
-
On Linux
# Install python3 $ sudo apt-get install python3 $ sudo apt-get install pip3 $ sudo pip install pyserial
To run the program execute following command. Thereby <serial_port> must be replaced with the actual port to which the Arduino is connected. On Linux this is typically /dev/ttyUSB0 on Windows computers you can look up the port in the device manager.
$ python3 switch_matrix_tester.py "<serial_port>"The switch matrix includes TCP communication capabilities, leveraging the ENC28J60 Ethernet Shield. Ethernet support can be activated using the following command within the settings.cmake file:
option(ETHERNET_SUPPORT "Enable Ethernet utilizing using the AZ delivery ENC28J60 Ethernet Shield. Disable UART" ON)in the settings.cmake file.
This configuration will deactivate the UART interface and enable the Ethernet shield for communication.
The default ethernet configuration is defined in the file /Include/ethernet/EthernetDefines.h.
/**
* @brief This file contains all definition required to execute the Ethernet Controller.
*/
#define MAC_ADDRESS 0x00,0x10,0xFA,0x6E,0x38,0x4A
#define IP_SIZE 4
#define DEFAULT_IP 192,168,0,2
#define DEFAULT_PORT 2000
#define ETHERNET_LOOP_DELAY_MS 1
#define ETH_MAX_MSG_SIZE 64
#define ETH_MAX_RESPONSE_SIZE 64The Ethernet interface supports multiple commands that must be transmitted to the endpoint 192.168.0.2:2000 in the default configuration. The following commands are supported:
The following commands are supported.
Request: {"cmd": "*IDN?"}
Response: {"status":"ok","idn":"NANOSec Crossbar Controller"}This command is used to identify the switch matrix. The identification string can be customized within the EthernetCommandParser implementation.
It additionally supports setting only the row selector:
Request: {"cmd": "SET_ROW", "row": "10"}
Response: b'{"status":"ok","row":"10"}'If the command was successful it returns a status: ok and the set row.
Simultanously the column can be set:
Request: {"cmd": "SET_COLUMN", "column": "10"}
Response: b'{"status":"ok","column":"2"}'Furthermore it also supports a JSON command setting both the row and column at the same time:
Request: {"cmd": "SET_ROW_COLUMN", "row": "1", "column": "2"}
Response: b'{"status":"ok","row":1,"column":2}'In case of any error an error string is returned, e.g.
Request: {"cmd": "INVALID_COMMAND", "row": "1", "column": "2"}
Response: {"status":"err","msg":"Could not parse cmd INVALID_COMMAND"}'A Python testing script is available under python_tester/ethernet_tester for verifying the functionality of the switch matrix's different commands. You can execute the script using the following command:
$ python3 ethernet_tester
**********************
Run NANOSec Switch Matrix TCP tester
**********************
Send: {"cmd": "*IDN?"}
Received: b'{"status":"ok","idn":"NANOSec Crossbar Controller"}'
Send: {"cmd": "SET_ROW", "row": "4"}
Received: b'{"status":"ok","row":"4"}'
Send: {"cmd": "SET_COLUMN", "column": "10"}
Received: b'{"status":"ok","column":"10"}'
Send: {"cmd": "SET_ROW_COLUMN", "row": "1", "column": "2"}
Received: b'{"status":"ok","row":1,"column":2}'
Execution finished! Exit program!