MeshCore Repeater Filter Builder

Click-build packet-filter rules, then copy the commands and paste them into the repeater console.

✨ Packet-filter engine by gjelsoe · original PR #9

⬇ Pre-built firmware with this filter (Proton Drive)

Defaults

Default mode (no rule matches) Start with filter clear

Rules are evaluated top-to-bottom; the first match wins. If none match, the default mode applies.

Rules

On the repeater a rule is disabled the moment it is added. Tick “enabled” on a rule to append a filter enable <id> command that activates it. Rule IDs assume the list was cleared first.

Generated commands

Filter command cheatsheet

Reference for the repeater packet-filter engine. Rules are evaluated top-to-bottom; the first match wins, otherwise the default mode applies.

Subcommands

Command	Description
`filter mode <allow\|drop>`	Set the default policy when no rule matches.
`filter add <action> <field> <op> <value> [and <field> <op> <value>]`	Create a new filtering rule.
`filter list [page]`	Display rules (page is 0-indexed; omit for page 0).
`filter enable <id>`	Reactivate a disabled rule.
`filter disable <id>`	Temporarily suspend a rule.
`filter del <id>`	Remove a rule by its numeric ID.
`filter clear`	Delete all rules at once.

Actions & default mode

`drop`	Discard the packet; do not forward.
`allow`	Forward the packet normally.
`mode allow`	Forward when no rule matches (default at first boot).
`mode drop`	Discard when no rule matches.

Whitelist: mode drop + explicit allow rules. Blacklist: mode allow + drop rules.

Match fields

Field	Meaning	Operators	Notes
`route`	Packet routing type	eq, neq	See route values.
`payload`	Payload / message type	eq, neq, gt, lt	Named token or numeric (dec/hex).
`hops`	Hops traversed	eq, neq, gt, lt	Integer.
`pathsize`	Hash bytes per hop	eq, neq, gt, lt	Range 1–3.
`path`	Last-hop repeater hash	eq, neq	Space-separated hex; OR logic. Not allowed as AND field.
`channel`	Channel hash byte	eq, neq	Hex (with/without 0x); grptxt/grpdata only.
`snr`	Signal-to-noise (dB)	eq, neq, gt, lt	Signed integer.
`rssi`	Signal strength (dBm)	eq, neq, gt, lt	Signed integer.

Operators: eq equals · neq not equals · gt greater than · lt less than (gt/lt are ignored for path).

Value formats

route

tflood    transport flood
flood     flood
direct    direct
tdirect   transport direct

payload

req   resp   txt    ack
advert  grptxt  grpdata
anonreq  path   trace
multi   ctrl   raw
(or decimal / 0x.. hex)

`path`	One or more space-separated hex hashes; each 2, 4, or 6 hex chars (1–3 bytes), all the same length, matching the network hash size. Matches if the last hop equals any listed hash (max 4).
`channel`	Single hex byte, e.g. `0xAB` or `AB`. Applies to grptxt/grpdata only.
`snr`	Signed whole dB, e.g. `-10`, `5`.
`rssi`	Signed dBm, e.g. `-110`, `-90`.

AND conditions

filter add <action> <field> <op> <value> and <field> <op> <value>

Max 1 AND condition per rule; both conditions must match.
path cannot be the AND field (it can be the primary field).
The AND field must be different from the primary field.

Limits

Maximum rules	8
AND conditions per rule	1
Path hashes per rule	4
Path hash size	3 bytes (2, 4, or 6 hex chars)
Rules persistence	`/filter_rules.bin`

The rule file has no version field — when upgrading from a build without AND support, delete /filter_rules.bin and re-enter the rules.

List output format

mode:allow rules:6/8 p1/2
0 drop payload eq grptxt
1 drop route eq tflood and hops gt 5
2* drop snr lt -10

First line: mode, rule count, current/total pages (1-indexed).
The leading number is the rule ID used with del / disable / enable.
An asterisk (*) marks a disabled rule.

Examples

Drop group-text messages

filter add drop payload eq grptxt

Drop transport-flood packets

filter add drop route eq tflood

Drop packets exceeding 5 hops

filter add drop hops gt 5

Drop SNR below −10 dB

filter add drop snr lt -10

Drop weak signal (RSSI < −110)

filter add drop rssi lt -110

Drop via a specific repeater

filter add drop path eq AB

Drop via multiple repeaters

filter add drop path eq AB 12 CD

Drop on a specific channel

filter add drop channel eq 0xAB

Channel 0x11 only if > 8 hops

filter add drop channel eq 0x11 and hops gt 8

Poor SNR AND weak signal

filter add drop snr lt -10 and rssi lt -100

Via repeater AB only if > 4 hops

filter add drop path eq AB and hops gt 4

Allow only flood (whitelist)

filter mode drop
filter add allow route eq flood

Allow only direct text with good signal

filter mode drop
filter add allow payload eq txt and rssi gt -90

Manage rules

filter disable 2
filter enable 2
filter list 1
filter del 1

Clear all and reset default

filter clear
filter mode allow