Skip to content

First StreetPass

Fin edited this page Nov 11, 2026 · 1 revision

Your first StreetPass

Before you start

  • Keys are in place: python3 tools/lp_extract_keys.py says all key material present.
  • The service is running, or sudo ./scripts/linuxpass is running in a terminal.
  • A 3DS is asleep, with StreetPass enabled for at least one title.
    • It is recommended to disconnect from the Internet on the 3DS, as this slows StreetPass down.

Awake works too, but sleep mode is often more reliable from my testing.

Watch it

journalctl -u linuxpass -f

Bring the console near the machine, leave it there, and wait several minutes.

What a good pass looks like

Roughly in order:

  1. The daemon reports it is listening on channels 1, 6 and 11.
  2. A console's StreetPass probe is heard, and its address is logged.
  3. The handshake: probe response, action frame, directed probe, link BSS.
  4. The link comes up and the console's first encrypted frame decrypts.
  5. Objects are exchanged: a title list, then the offer, then the messages.
  6. The console's notification LED blinks green.

The green LED means cecd accepted the message. A game then applies its own validation, so the game may still reject it.

"It took three tries"

Over 365 runs across two consoles, 34 to 44 percent of completed exchanges needed more than one engagement. A console that aborts an attempt goes quiet and will not rescan on its own for a while, so LinuxPass sends a synthesised probe object to nudge it back. That recovery worked on 139 of 142 stalled onsets, against 0 of 35 without it.

If the first pass does nothing, leave it running. If ten minutes pass with the console clearly on the air and nothing engaging, something is wrong, so go to Troubleshooting.

The second pass may do nothing at all

A console exchanges with a given address once, as it does with any other 3DS. See The MAC filter.

Clone this wiki locally