Skip to content

nexmonster/nexmon_csi

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 

Repository files navigation

⢀⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⠀⣠⣤⣶⣶
⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⢰⣿⣿⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧⣀⣀⣾⣿⣿⣿⣿
⣿⣿⣿⣿⣿⡏⠉⠛⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⣿
⣿⣿⣿⣿⣿⣿⠀⠀⠀⠈⠛⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⠛⠉⠁⠀⣿
⣿⣿⣿⣿⣿⣿⣧⡀⠀⠀⠀⠀⠙⠿⠿⠿⠻⠿⠿⠟⠿⠛⠉⠀⠀⠀⠀⠀⣸⣿
⣿⣿⣿⣿⣿⣿⣿⣷⣄⠀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣴⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⣿⠏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠠⣴⣿⣿⣿⣿               Nexmonster / Nexmon_CSI
⣿⣿⣿⣿⣿⣿⣿⣿⡟⠀⠀⢰⣹⡆⠀⠀⠀⠀⠀⠀⣭⣷⠀⠀⠀⠸⣿⣿⣿⣿               =======================
⣿⣿⣿⣿⣿⣿⣿⣿⠃⠀⠀⠈⠉⠀⠀⠤⠄⠀⠀⠀⠉⠁⠀⠀⠀⠀⢿⣿⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⢾⣿⣷⠀⠀⠀⠀⡠⠤⢄⠀⠀⠀⠠⣿⣿⣷⠀⢸⣿⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⡀⠉⠀⠀⠀⠀⠀⢄⠀⢀⠀⠀⠀⠀⠉⠉⠁⠀⠀⣿⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⣧⠀⠀⠀⠀⠀⠀⠀⠈⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢹⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⣿⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿

Nexmonster / nexmon_csi

Nexmonster is a group of people trying to provide excellent documentation, and an easy installation experience for seemoo-lab/nexmon_csi.

We primarily support Raspberry Pi (3B+ and 4), and Asus RT-AC86U. If you need help with other devices, please create an Issue :)

If you're using Nexmon_CSI, please let me know via email (aravind.reddy@iiitb.org) or Discussions and I'll feature your work.

Collecting CSI

Raspberry Pi

Checkout https://github.com/nexmonster/nexmon_csi_bin for pre-compiled nexmon_csi binaries.

Pi Version Kernel Version Link Notes
Pi 3B+ and 4 5.10.92 https://github.com/nexmonster/nexmon_csi/tree/pi-5.10.92 This is the recommended version with RSSI and FC.
Pi 3B+ and 4 5.4.51 https://github.com/nexmonster/nexmon_csi/tree/pi-5.4.51 Uses the legacy 5.4.51 Kernel with old packet format.
Pi 3B+ and 4 5.4.51 https://github.com/nexmonster/nexmon_csi/tree/pi-5.4.51-plus Like 5.4.51, but includes more data like RSSI, Source and Destination Mac ID. Use https://github.com/zeroby0/csi-explorer to plot data.
Pi 3B+ and 4 4.19.97 https://github.com/nexmonster/nexmon_csi/tree/pi-4.19.97 Uses the legacy 4.19.97 Kernel. Use this if you're facing problems with other versions, or you need to use Kernel v4.19.97 for some reason.

Asus RT-AC86U

Device Link Notes
RT-AC86U #2 Short and Quick guide using precompiled binaries
RT-AC86U #7 Longer guide that shows how to compile from source

Analysing CSI

Name Devices Language Link Notes
CSIKit Several devices Python https://github.com/Gi-z/CSIKit A feature rich decoder supporting many input formats and sources
CSI Explorer 2.0 Raspberry Pi 3B+ and 4B Python https://github.com/nexmonster/nexmon_csi/tree/feature/python/utils/python CSI decoder and plotter optimised for speed. You can embed it into your scripts to read CSI and process it
CSI Explorer Raspberry Pi 3B+ and 4B Python https://github.com/zeroby0/csi-explorer CSI reader designed for 5.4.51-plus branch

Publications using CSI

Email me at aravind.reddy@iiitb.org to have your work featured here.

Members, Crediting, Contribution, and other stuff

Currently we are

I'm looking for PhD Positions in Wireless research. Please let me know if you're interested: https://www.avoggu.com/contact/ Thanks :)

If you would like to help out, please create a Discussion. Please create an Issue before starting a Pull Request.

If the documentation and scripts here helped you, I would really appreciate it if you credit this repo and the seemoo-lab/nexmon_csi project :)