yujianyuanhaha / nexmon_csi

Channel State Information for Raspberry Pi. Use the pi-4.19.97 branch.

⢀⣠⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⠀⣠⣤⣶⣶
⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⢰⣿⣿⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧⣀⣀⣾⣿⣿⣿⣿
⣿⣿⣿⣿⣿⡏⠉⠛⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡿⣿
⣿⣿⣿⣿⣿⣿⠀⠀⠀⠈⠛⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠿⠛⠉⠁⠀⣿
⣿⣿⣿⣿⣿⣿⣧⡀⠀⠀⠀⠀⠙⠿⠿⠿⠻⠿⠿⠟⠿⠛⠉⠀⠀⠀⠀⠀⣸⣿
⣿⣿⣿⣿⣿⣿⣿⣷⣄⠀⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣴⣿⣿
⣿⣿⣿⣿⣿⣿⣿⣿⣿⠏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠠⣴⣿⣿⣿⣿               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 :)

Collecting CSI

Raspberry Pi

Pi Version	Kernel Version	Link	Notes
Pi 3B+ and 4	5.4.51	https://github.com/nexmonster/nexmon_csi/tree/pi-5.4.51	This is the recommended version.
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	nexmonster#2	Short and Quick guide using precompiled binaries
RT-AC86U	nexmonster#7	Longer guide that shows how to compile from source

Plotting 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

Members, Crediting, Contribution, and other stuff

Currently we are

• @zeroby0 - Aravind Voggu
• @Gi-z - Glenn Forbes
• @tweigel-dev - Thomas Weigel

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 :)