Skip to content

The MAC filter

Fin edited this page Nov 14, 2026 · 2 revisions

The MAC filter (console)

The rule

A console will StreetPass a given peer address once. After an exchange it writes that address down and declines the next approach from it. This is the most common "it worked and then it stopped" report.

The list lives in data:/CEC/MacFilter___ on the console. It is a 20-byte header followed by a one-byte count and up to 255 six-byte peer addresses. The header holds the console's own current session address and a timestamp in the console's own clock, set when that address was adopted.

The two ways around it

1. Rotate identity (no homebrew needed)

Tuxchange can present a new address on a schedule. A console that has never seen the new address has nothing written down about it.

python3 /opt/tuxchange/tuxchange/sp_relay.py ctl rotate --store /var/lib/tuxchange --seconds 3600 --now

The daemon has to be running for that command. It saves the period for later restarts. You can also set SP_ROTATE=3600 in /etc/default/tuxchange, but a value saved by the GUI or ctl overrides that file. Zero, the default, never rotates.

  • The change happens at a pass boundary, never inside an exchange.
  • The schedule is persisted, so a restart resumes it and does not fall back to a fixed address consoles have already blocked.
  • The minimum period is 60 seconds.
  • --rotate-identity, a different flag, takes a new address for every pass. No real console can do that. It defeats the peer's rate limit completely, which is occasionally useful for testing and otherwise impolite, so leave it off unless you mean it.

Real consoles rotate too, on their own schedule, measured between 0.65 and 6.06 hours. A cooldown keyed on a peer's address is therefore only a hint about identity.

2. Clear the filter on the console

Homebrew utilties can clear the filter for you.

Only one of two consoles needs its filter cleared for the pair to exchange again.

How to tell this is what is happening

The pass runs, the console is heard on the air, and the exchange never engages, repeatedly and with no other symptom, from a machine that worked earlier. If rotating identity fixes it, the filter was the cause.

tools/macfilter_decode.py decodes a filter file if you have dumped one.

Clone this wiki locally