Post cover image

August 27, 2026

Installion ButteRFly, a WHAD-compatible firmware for nRF52840 USB dongles

Prérequis

By ATTE-THM

3 min read

Prérequis

  • Matériel : Dongle nRF52840.
  • Logiciel : nrfutil installé et accessible dans votre terminal.
  • Fichier : Le package du firmware téléchargé (butterfly-fwupgrade.zip depuis la page des releases officielle).

INSTALLTION nrfutil

Flash instructions for nRF52840 Dongle - Nordic Developer Academy The nRF52840 Dongle, unlike our development kits, does not have a debugger on board. Therefore, the procedure for…

nRF Util nRF Util is a unified command line utility for Nordic products.

Procédure d'installation

  1. Mettez le dongle en mode DFU (Device Firmware Update) :
  • Débranchez le dongle nRF52840.
  • Appuyez sur le petit bouton RESET (situé sur le côté, du côté opposé au port USB) et maintenez-le enfoncé.
  • Branchez le dongle sur un port USB de votre ordinateur tout en continuant à maintenir le bouton RESET.
  • Relâchez le bouton. La LED du dongle doit s'allumer en rouge et pulser. Cela confirme qu'il est bien en mode DFU.
  • Pour vérifier, vous pouvez lister les périphériques série avec ls /dev/ttyACM* (sous Linux) ou regarder dans le gestionnaire de périphériques.
None None

Iinstalle aussi:

nrfutil install nrf5sdk-tools
None

Ensuite vérifie les fonctions possibles actuelles :

nrfutil list
None
  1. Effectuez le flashage avec nrfutil :
  • Télécharge le fichier zip ici

Release Version 1.1.5 · whad-team/butterfly WHAD-enabled firmware for nRF52840 dongle, allowing to sniff and inject packets from multiple wireless protocols (e.g…

Télécharge que bien le butterfly-fwupgrade.zip

  • Ouvrez un terminal.
  • Vérifie si ton Dongle est visible.
ls -l /dev/tty*
None
  • Exécutez la commande suivante pour flasher le firmware :
nrfutil dfu usb-serial -pkg butterfly-fwupgrade.zip -p /dev/ttyACM0
None None

Ensuite installe les outils WHAD:

pipx install whad

Ou si tu veux tu peux creer la veriable d'evironement python comme:

pip install whad
None

Ensuite, onfigurer automatiquement les permissions système nécessaires pour utiliser vos outils de pentesting sans fil (comme ButteRFly) sans avoir à utiliser sudo à chaque fois

winstall --rules all
None None

Verifions si la dongle est visible pour les commande WHAD

None
  • Remarques importantes :
  • L'option -p /dev/ttyACM0 spécifie le port série. Sous Linux, il est souvent /dev/ttyACM0. Sous Windows, il sera de type COM3, COM4, etc.
  • Patientez pendant le flashage. Une barre de progression s'affichera.

Testons le sniff

wsniff --interface uart0 -o capture_phy.pcap phy
None

Mode interactif:

wble-central --interface uart0 interactive
None

Test de Scan

None

Quelques explications

None None

Pourquoi c'est important

Sans ces règles, vous seriez obligé de préfixer chaque commande (comme wsniff ou wplay) avec sudo. Cela peut être fastidieux et poser des problèmes avec des outils qui s'attendent à être exécutés par un utilisateur normal.

Après avoir exécuté winstall --rules all, il est recommandé de redémarrer votre session (déconnexion/reconnexion) pour que les changements de groupe soient pris en compte

. De cette façon, votre dongle nRF52840 sera automatiquement reconnu par la suite WHAD et vous pourrez lancer vos captures ou analyses sans avoir à vous soucier des droits d'accès.