Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/omriiluz/NRF24-BTLE-Decoder

Sniff and decode NRF24L01+ and Bluetooth Low Energy using RTL-SDR
https://github.com/omriiluz/NRF24-BTLE-Decoder

Last synced: 3 days ago
JSON representation

Sniff and decode NRF24L01+ and Bluetooth Low Energy using RTL-SDR

Host: GitHub
URL: https://github.com/omriiluz/NRF24-BTLE-Decoder
Owner: omriiluz
License: mit
Created: 2014-01-19T11:15:05.000Z (over 10 years ago)
Default Branch: master
Last Pushed: 2017-02-03T05:38:25.000Z (over 7 years ago)
Last Synced: 2024-04-18T05:12:05.795Z (2 months ago)
Language: C
Size: 12.7 KB
Stars: 300
Watchers: 34
Forks: 73
Open Issues: 2
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-avr - NRF24-BTLE-Decoder - Sniff and decode NRF24L01+ and Bluetooth Low Energy using RTL-SDR. (Wireless)

README

NRF24-BTLE-Decoder
==================

Sniff and decode NRF24L01+ and Bluetooth Low Energy using RTL-SDR.
These protocols use the ISM 2.4Ghz frequency range, which is beyond the capabilities of the cheap rtl-sdr, a down convertor is necessary. See http://blog.cyberexplorer.me/2014/01/sniffing-and-decoding-nrf24l01-and.html for more details.

The main repository is at https://github.com/omriiluz/NRF24-BTLE-Decoder

Compile
-------
`make`
or directly
`gcc -std=gnu99 -Wall -O3 -o nrf24-btle-decoder nrf24-btle-decoder.c`

Usage
-----
`nrf24-btle-decoder [-t nrf|btle] [-d 1|2|8] [-l len]`
-t packet_type (nrf or btle), defaults to nrf. Using packet type btle implies -d 2
-d downsample_rate (1 for 2mbps, 2 for 1mbps, 8 for 256kbps), default to 2
-l len (1-32). Sets a fixed packet length

Important - this program input is a 2M samples per second bitstream generated by rtl_fm or equivalent e.g. rtl_fm.exe -f 428m -s 2000k | nrf24-btle-decoder.exe -t nrf -s 2

Dependencies
------------
* working rtl-sdr library. See http://sdr.osmocom.org/trac/wiki/rtl-sdr
* working hardware - rtl-sdr, downconverter, antenna

Limitations
-----------
* The NRF24L01+ protocol decoder is missing 0/1 byte CRC. It should be trivial to implement, please open an issue if you need that capability.
* The BTLE protocol decoder currently supports only advertisement packets on channel 38 and not data packets / frequency hopping. I am still evaluating whether the rtl-sdr hardware is fast enough to track the frequency hopping.

Troubleshooting
-----------------
* Biggest problem is noise, avoid rf auto gain and set as low as possible. I usually get best results with 0-10 db gain.
* Second biggest problem is frequency drift. Use kalibrate for a good base line then fine tune the frequency in 50Khz steps until perfect

License
-------
All of the code contained here is licensed by the MIT license.

Credit
------
Dmitry Grinberg, CRC and Whiten code for BTLE - http://goo.gl/G9m8Ud
Open Source Mobile Communication, RTL-SDR information - http://sdr.osmocom.org/trac/wiki/rtl-sdr
Steve Markgraf, RTL-SDR Library - https://github.com/steve-m/librtlsdr

-----------------