Repository navigation
The MAC filter
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.
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 --nowThe 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.
Homebrew utilties can clear the filter for you.
Only one of two consoles needs its filter cleared for the pair to exchange again.
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.