README.convert_results_to_ellisys.txt
1This is a postprocessing utility which converts bsim Phy dumps of the Tx
2activity of 1 or several devices into the import format for the Ellisys
3Bluetooth Analyzer SW (.bttrp).
4This way the BLE standard traffic (and some industry propietary extensions)
5can be analyzed by this Ellisys tool.
6
7You can call it for example as:
8 components/ext_2G4_phy_v1/dump_post_process/csv2bttrp results/<sim_id>/d_2G4*.Tx.csv > ~/Trace.bttrp
9
10This trace can then be *imported* into the Ellisys SW:
11 File > Import ; Select Bluetooth packets ; Click Next ; Click Browse ; and select/open the file.
12
13Note that all packets which are not BLE modulated won't be coverted (will be ignored).
14
15Note that the Ellisys analyzer SW is _very_ picky, and ignores many packets which are
16in some way malformed.
17
18Note: convert_results_to_ellisys.sh is deprecated, please use csv2bttrp (or convert_results_to_ellisysv2.sh) instead.
19
README.csv2pcap.txt
1These are postprocessing utility scripts which convert
2the phy dumps in csv format to pcap (or pcapng) files.
3This way the BLE & 15.4 traffic can be analyzed by Wireshark and other tools.
4
5Currently the following scripts exist:
6* csv2pcap : Encapsulate bsim BLE traffic into pcap format
7* csv2pcap_15.4.py : Encapsulate bsim 15.4 traffic into pcap format
8* csv2pcapng : Encapsulate bsim traffic (all types) into pcapng format
9
10To merge the TX activity from all devices into a single pcap trace do:
11
12$ dump_post_process/csv2pcapng -o mytrace.pcap results/<sim_id>/d_2G4*.Tx.csv
13
14Replace paths as necessary.
15
16Alternatively one can merge RX and TX activity from a single device
17to get a trace as seen by that device:
18
19$ dump_post_process/csv2pcapng -o mytrace.pcap results/<sim_id>/d_2G4_00.{Rx,Tx}.csv
20
21However be careful not to merge Rx and Tx files from different devices
22or you'll get duplicated records.
23