PicoScenes Wi-Fi Sensing System


  • 2020.12.31 Add a short Chinese introduction PPT for PicoScenes.
  • 2020.12.10 We are working on adding the support for ESP32 IOT board.
  • 2020.11.16 We open-source the core Modular PicoScenes Frame structure and its binary parser (rxs-parsing-core).
  • 2020.11.12 We release the second demo video of PicoScenes. Here.
  • 2020.10.22 We open-source the PicoScenes Plug-in Development Kit (PS-PDK).
  • 2020.10.21 We release the first demo video of PicoScenes. Here.
  • 2020.10.21 We submit the first regular paper of PicoScenes. The pre-print version is here.


  • 2020.11.3 Add Progress section
  • 2020.10.25 Add Demo Videos section
  • 2020.10.22 Open-source PSPDK
  • 2020.10.22 Add license information
  • 2020.10.20 Add News and Update sections to this page.

What Is PicoScenes?

PicoScenes platform is a powerful, multi-hardware supporting and user extensible Wi-Fi sensing platform.It fully unleashes the potential of QCA9300 along with IWL5300. It even embeds a high-performance software implementation of 802.11a/g/n/ac/ax baseband processing, which is an out-of-the-box solution for software defined radio (SDR) to transmit and receive the 11a/g/n/ac/ax rate packets, measure CSI and obtain much richer PHY layer information than on COTS platform.

Much beyond a simple CSI data extractor, PicoScenes adopts the `drivers + platform + plug-ins’ design to support upcoming new CSI-ready hardwares and SDR. The following is an in-exhaustive feature comparison between PicoScenes and the previous CSI extraction tools.

For more information, please refer to our paper.

A short Chinese version introduction PPT

Demo Videos

Demo 1: Spectrum stitching using two QCA9300 Wi-Fi NICs

Demo 2: Spectrum stitching using USRP X310 and QCA9300

Development Progress

development status.

How To Install PicoScenes?

Step 1: Confirm your Operating System

Ubuntu 20.04 and its variants(Linux Mint, Kubuntu, Xubuntu, etc.) are the only OSes supported by PicoScenes.

Still using the deprecated version? Go get the latest!😂

Step 2: Download & Install PicoScenes Source Updater

run the following commands in CLI:

wget https://zpj.io/PicoScenes/picoscenes-source-updater.deb 
sudo dpkg -i picoscenes-source-updater.deb

The above two lines download the .deb using wget, followed by .deb installation using the Debian dpkg command.

Why source updater?

picoscenes-source-updater.deb inserts PicoScenes Debian source URL into your system source list. In this way, PicoScenes can be install & auto-update by the handy apt command.

Step 3: Install PicoScenes by apt command

Run the following commands in CLI:

sudo apt update
sudo apt install picoscenes-all

The first line retrieves the necessary information from our source repository by updating your local repo list. The second line performs the actual PicoScenes installation.

Uninstall PicoScenes? No problem!

Run the following command and PicoScenes will get away.

sudo apt remove picoscenes-all picoscenes-driver picoscenes-source-updater

How To Use PicoScenes?

How To Use PicoScenes Plug-in Development Kit to Develop Your Own Plug-ins?

Open Source & License

We release PicoScenes Plug-in Development Kit (PS-PDK) under GPLv3 License. This means PS-PDK and all the derived works, such as EchoProbe plug-in and all plug-ins developed by PicoScenes users, inherit GPLv3 License, which means they all must be open sourced. We release PS-PDK at https://gitlab.com/wifisensing/PicoScenes-PDK/.

We release the core data structure and the binary parser of Modular PicoScenes Frame, which defines the .csi file format that PicoScenes uses. The code is release under MIT License at https://gitlab.com/wifisensing/rxs_parsing_core.

We release PicoScenes MATLAB Toolbox under MIT License. (will be released soon)

PicoScenes Platform is currently a close-sourced project.

PicoScenes Drivers, the modified kernel drivers for QCA9300 and IWL5300, follow the GPLv2 License and will be released soon.





Dr. Zhiping Jiang, 蒋志平 (Xidian University)
Xincheng Ren, 任新承 (Xidian University)
Han Hao, 蒿翰 (Xi’an Jiaotong University)
Dongtao Lv, 吕东涛 (Xidian University)
Xuetao Li, 李薜滔 (Xidian University)
Jing Wang, 王璟 (Xidian University)
Anran Zhai, 翟安然 (Xidian University)
Xu Wang, 王旭 (Xidian University)
Prof. Tom H. Luan, 栾浩教授 (Xidian University)
Prof. Rui Li, 李瑞教授 (Xidian University)

Translate »