The nRF Sniffer for Bluetooth®
LE software is installed as an external capture plugin in Wireshark.
To install the nRF Sniffer capture tool, complete the following
steps:
-
Install the Python requirements:
-
Open a command window in the Sniffer_Software/extcap/ folder.
-
Install the Python dependencies listed in requirements.txt by doing one of the following:
- On Windows with Python launcher, type py -3 -m pip install -r requirements.txt.
- On Windows without Python launcher, type python -m pip install -r requirements.txt.
- On Linux or macOS, type python3 -m pip install -r requirements.txt.
-
Close the command window.
-
Copy the nRF Sniffer capture tool into Wireshark's
folder for personal external capture plugins:
-
Open Wireshark.
-
Go to (on Windows or Linux) or (on macOS).
-
Select the Folders tab.
-
Double-click the location for the Personal Extcap
path to open this folder.
-
Copy the contents of the
Sniffer_Software/extcap/
folder into this folder.
-
Make sure that the nRF Sniffer files can be run correctly:
-
Open a command window in Wireshark's
folder for personal external capture plugins.
-
Run the nRF Sniffer tool to list available interfaces.
On Windows, type nrf_sniffer_ble.bat
--extcap-interfaces. On macOS or Linux, type
./nrf_sniffer_ble.sh
--extcap-interfaces.
You should see a series of strings, similar to what is shown in
the following screenshot.
-
If the previous step returned an error, verify that Python 3 is
accessible.
On Windows, enter python --version. On macOS or
Linux, enter python3. If the command cannot be
found or the version is wrong, make sure that Python v3.6 or later is in
your path and that it is the first Python version in the path.
-
For macOS or Linux: Verify that the
nrf_sniffer_ble.sh file has the
x
permission.
If the x
permission is missing, add it using
chmod +x nrf_sniffer_ble.sh.
-
Enable the nRF Sniffer capture tool in Wireshark:
-
Refresh the interfaces in Wireshark by
selecting or pressing F5.
-
Select to enable the nRF Sniffer interface.