Repository navigation
Hardware
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.
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.
Tear the interface down and build it again:
sudo <Tuxchange root>/scripts/sp_monitor.sh down
sudo <Tuxchange root>/scripts/sp_monitor.sh upThe 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.
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.
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.