ExternalVendorCode/openwifi
1
0
Fork 0
mirror of https://github.com/open-sdr/openwifi.git synced 2025-04-23 18:03:33 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Improve radar-self-csi.md with waterfall

Browse Source
This commit is contained in:
Xianjun Jiao 2023-09-12 14:37:46 +02:00
parent 8cfbbc8e8d
commit 3712d8b7b8
1 changed files with 38 additions and 24 deletions

62
doc/app_notes/radar-self-csi.md

@ -13,43 +13,57 @@ One super power of the openwifi platform is "**Full Duplex**" which means that o
```
ssh root@192.168.10.122
(password: openwifi)
cd openwifi
./wgd.sh
./fosdem.sh
(After the AP started by above command, you can connect a WiFi client to this openwifi AP)
(Or setup other scenario according to your requirement)
ifconfig
(Write down the openwifi AP MAC address. For example 66:55:44:33:22:5a)
insmod side_ch.ko num_eq_init=0
```
- On computer, build the latest driver and FPGA package after clone/update openwifi and openwifi-hw-img repository:
```
export XILINX_DIR=your_Xilinx_install_directory
(Example: export XILINX_DIR=/opt/Xilinx. The Xilinx directory should include sth like: Downloads, Vitis, etc.)
export OPENWIFI_HW_IMG_DIR=your_openwifi-hw-img_directory
(The directory where you get the open-sdr/openwifi-hw-img repo via git clone)
export BOARD_NAME=your_board_name
(Check the BOARD_NAME definitions in README)
cd openwifi/user_space
./drv_and_fpga_package_gen.sh $OPENWIFI_HW_IMG_DIR $XILINX_DIR $BOARD_NAME
scp drv_and_fpga.tar.gz root@192.168.10.122:openwifi/
scp ./side_ch_ctl_src/side_ch_ctl.c root@192.168.10.122:openwifi/
scp ./inject_80211/* root@192.168.10.122:openwifi/inject_80211/
```
- On SDR board (/root/openwifi directory):
```
cd /root/openwifi/
./wgd.sh drv_and_fpga.tar.gz
./monitor_ch.sh sdr0 1
insmod ./drv_and_fpga/side_ch.ko
gcc -o side_ch_ctl side_ch_ctl.c
./side_ch_ctl wh1h4001
./side_ch_ctl wh7h4433225a
(Above two commands ensure receiving CSI only from XX:XX:44:33:22:5a. In this case, it is the openwifi self-TX)
(Above two commands ensure receiving CSI only from XX:XX:44:33:22:5a, which will be set by our own packet injector later)
./sdrctl dev sdr0 set reg xpu 1 1
(Above unmute the baseband self-receiving to receive openwifi own TX signal/packet)
./side_ch_ctl g0
```
You should see on board outputs like:
- Open another ssh session on SDR board:
```
loop 64 side info count 4
loop 128 side info count 5
...
cd /root/openwifi/inject_80211
make
./inject_80211 -m g -r 4 -t d -e 0 -b 5a -n 99999999 -s 20 -d 1000 sdr0
(Above command injects the 802.11a/g packet, for 802.11n packet please use:
./inject_80211 -m n -r 4 -t d -e 8 -b 5a -n 99999999 -s 20 -d 1000 sdr0)
```
If the second number (4, 5, ...) keeps increasing, that means the CSI is going to the computer smoothly.
- On your computer (NOT ssh onboard!), run:
- Now you should see the increasing numbers in the previous ssh terminal of the SDR board.
- On your computer (NOT ssh session!), run:
```
cd openwifi/user_space/side_ch_ctl_src
python3 side_info_display.py 0
python3 side_info_display.py 8 waterfall
```
The python script needs "matplotlib.pyplot" and "numpy" packages installed. Now you should see figures showing run-time **CSI** and **frequency offset**. Meanwhile the python script prints the **timestamp**.
![](./csi-screen-shot-radar.jpg)
While running, all CSI data is also stored into a file **side_info.txt**. A matlab script **test_side_info_file_display.m** is offered to help you do CSI analysis offline. In this case, run **test_side_info_file_display(0)** in Matlab.
![](./csi-screen-shot-radar-matlab.jpg)
The following picture is generated by data processing on the captured openwifi CSI while people move in front of two directional antennas (Tx/Rx antenna).
The python script needs "matplotlib.pyplot" and "numpy" packages installed. Now you should see figures showing run-time **CSI**, **CSI waterfall**, **Equalizer out** and **frequency offset**. The following photo shows the CSI change in the waterfall plot when I left my seat in front of two directional antennas (Tx/Rx antenna).
![](./sensing.png)
While running, all CSI data is also stored into a file **side_info.txt**. A matlab script **test_side_info_file_display.m** is offered to help you do CSI analysis offline. In this case, run **test_side_info_file_display** in Matlab.
![](./csi-screen-shot-radar-matlab.jpg)
Please learn the python and Matlab script for CSI data structure per packet according to your requirement.
Do read the [normal CSI app note](csi.md) to understand the basic implementation architecture.