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.
-
Type pip3 install -r requirements.txt to install
the requirements.
-
Close the command window.
-
Copy the Sniffer capture tool into Wireshark's folder for external capture
plugins:
-
Open Wireshark.
-
Go to (on Windows or Linux) or (on macOS).
-
Select the Folders tab.
-
Double-click the location for the 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 external capture
plugins.
-
Run the 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.
You should see that nRF Sniffer is displayed as one of the interfaces
on the start page.
-
Select to enable the Sniffer interface.