PicoScenes Wi-Fi Sensing System

News

  • 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.

Update

  • 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.

Demo Videos

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

Demo 2: 802.11n 2×2 MIMO communication using two USRP X310 (soon)

Demo 3: Round-trip CSI measurement between QCA9300 (or IWL5300) and USRP X310

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 GPVv3 License, which means they all must be open sourced. We release PS-PDK at https://gitlab.com/wifisensing/PicoScenes-PDK/.

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

PicoScenes Platform is currently a close-sourced project.

Pricing

Resources

Credits

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)
Tom H. Luan, ๆ พๆตฉๆ•™ๆŽˆ (Xidian University)
Rui Li, ๆŽ็‘žๅ‰ฏๆ•™ๆŽˆ (Xidian University)