Skip to content

Hardware

Fin edited this page Nov 14, 2026 · 5 revisions

Hardware

Wi-Fi chipset

You need an compatible 2.4GHz wireless card that supports active monitor or mixed mode.

Look at COMPATIBILITY to check if your chipset/adapter is compatible.

A 3DS will not complete a StreetPass with something that does not acknowledge its frames. 802.11 ACKs are generated by the card's own hardware within microseconds, far too fast for software. A plain monitor interface picks up everything but acknowledges nothing, so when the console retries, gets nothing back, it gives up partway through the handshake.

An active monitor interface has a MAC address the hardware answers to. The console's frames get ACKed and the exchange proceeds.

Checking your card

lspci -k | grep -A3 -i network
iw list | grep -A10 'Supported interface modes'
iw list | grep -i 'active monitor'

If your adapter or chipset is listed as compatible in COMPATIBILITY then proceed to getting the keys from your console.

Getting your keys.

Recovering a stuck radio

Tear the interface down and build it again:

sudo <Tuxchange root>/scripts/sp_monitor.sh down
sudo <Tuxchange root>/scripts/sp_monitor.sh up

The service does the same on every restart (ExecStartPre), so restarting can recover a stuck radio. The daemon also has a 120-second watchdog: if the daemon's sniffing loop stops reporting, systemd restarts it.

NetworkManager

sp_monitor.sh takes the adapter away from NetworkManager while it runs, and gives it back on down, including when the service stops or fails. If NetworkManager had to be stopped outright, a flag file at /run/Tuxchange.nm-stopped records that so it gets restarted.

Without NetworkManager, down removes the monitor interface and brings the real adapter back up, if it was up before up ran.

With no adapter interface named, sp_monitor.sh picks the "best" option for you. To use another interface, set SP_IFACE. If there is no suitable adapter then it exits without modifying any of them.

Channels

StreetPass discovery happens on channels 1, 6 and 11, and the bulk transfer moves to a channel the host picks during the handshake. Tuxchange watches all three by default (SP_CHANNELS) if your driver supports switching channels while the interface is up, if not or using Mixed mode, channel 1 is used by default.

Clone this wiki locally