Skip to content

OSNT SUME applications

Gianni Antichi edited this page Mar 14, 2017 · 9 revisions

The code base (located in OSNT/util/app/) has been organized primarily into five folders:

|-- lib
`-- gui  
`-- cli
`-- tools

The lib directory is used for storing C and Python function to enable User Space software interaction with the board through registers (register write, register read..).

The gui directory stores the python GUIs for both OSNT Traffic Monitor and OSNT Traffic Generator. Please, refer to the README file included in ~/OSNT/code/osnt_sw to learn how to run the GUIs. The GUIs are built with functions provided in monitor.py/generator.py, which are used to operate the monitor/generator (reading/writing registers).

The sample_traces directory provides different lenght one-packet PCAP traces which can be used with the OSNT Traffic Generator.

The tools directory is organized as follow:

`-- tools
|-- osnt_generator
|  |-- apps  
|  `-- cli  
|-- osnt_monitor  
|  |-- apps  
|  `-- cli  

Currently, we do not provide any official app for the OSNT Generator project. The system can be entirely run through the provided GUI. As for the OSNT Monitor project, the user app may vary depending on the used OSNT version. A user application able to dump received packets into pcap/pcapng files has been provided up to OSNT version 1.5. From OSNT version 2.0, the user space application does not provide pcap/pcapng support. The CLIs are being used for configuration. As for the generation side, the CLI can be used to enable the HW TX Timestamp Feature (10G MAC Interface v1.20), while for the monitoring side to set up HW Filtering Rules, Enable GPS correction, etc.. .

N.B. The TX Timestamp Feature can be ONLY used in the OSNT project (it will NOT work if the OSNT Generator bitfile is loaded).

The utilities directory provides C APIs to interact with the board (standalone C programs used to read and write HW registers) and a python script to generate PCAP traces to use with the OSNT traffic generator.