Autorem forka, czyli odgałęzienia standardowego firmware'u, jest jhuebert, a sam projekt można znaleźć na GitHubie (link jest na końcu artykułu). To nieoficjalny projekt, który śledzi kolejne wydania MeshCore i dokłada do nich kilka ciekawych, przydatnych funkcji. Działa na prawie wszystkich płytkach, które obsługuje oryginalne oprogramowanie, a skompilowany firmware można pobrać ze strony wydań forka. Wychodzi w dwóch gałęziach: stabilnej (tagi filter-v…-r…) i testowej (dev). Najnowsza stabilna wersja, v1.18.0-r4, ukazała się 12 listopada 2026 roku i opiera się na MeshCore 1.18.0.

Po wgraniu firmware'u wszystkie dodatkowe funkcje są wyłączone. Dopóki administrator czegoś świadomie nie ustawi, repeater działa tak samo jak z oficjalnym firmware'em.

Jak działa filtr pakietów

Filtr ma jedno zadanie: zdecydować, czy repeater przekaże pakiet dalej, czy go odrzuci. Reguły są sprawdzane po kolei, od pierwszej na liście. O losie pakietu decyduje pierwsza reguła, która do niego pasuje. Pakiet, do którego nie pasuje żadna, idzie dalej jak gdyby nigdy nic, więc filtr wycina tylko to, co wskaże operator repeatera.

Każda reguła to zestaw warunków, które muszą być spełnione jednocześnie. Warunki dotyczą między innymi:

  • rodzaju pakietu (ogłoszenie węzła, wiadomość grupowa, dane grupowe),
  • sposobu przesyłania: flood (pakiet rozsyłany przez wszystkie repeatery, które go usłyszą) albo direct (po znanej ścieżce),
  • liczby skoków, czyli tego, przez ile repeaterów pakiet już przeszedł,
  • długości pakietu i jakości odbieranego sygnału (SNR),
  • repeaterów na trasie pakietu i regionu, w którym go rozesłano,
  • kanału, nadawcy i treści wiadomości.

Trzy ostatnie warunki działają tylko na wiadomościach, które repeater potrafi odszyfrować. Kanał Public jest wbudowany, a dla kanałów z hashem (#nazwa) klucz wynika z samej nazwy, tak samo jak w aplikacji na kompanionie. Do kanałów prywatnych trzeba dodać klucz. Nadawcę i tekst opisuje się prostymi wzorcami, np. ^Bot pasuje do każdej nazwy, która zaczyna się od „Bot”.

Reguła nie musi niczego wyciszać całkowicie. Warunek throttle przepuszcza jedną pasującą wiadomość na podaną liczbę sekund, a prob odrzuca tylko część pasujących pakietów. Kilka przykładów z dokumentacji:

filter add chan=#memes
filter add chan=#wardriving hops=[2,*]
filter add chan=#test sender="^bob" throttle=60
filter ratelimit advert 48

Pierwsza reguła wycisza cały kanał #memes. Druga przepuszcza ruch z kanału #wardriving tylko z najbliższej okolicy: wiadomość, która przeszła już przez dwa repeatery albo więcej, dalej nie pójdzie. Trzecia pozwala jednemu nadawcy na kanale #test wysłać jedną wiadomość na minutę. Ostatnia linia nie jest regułą, tylko osobnym ogranicznikiem: repeater przekaże ogłoszenie każdego węzła najwyżej raz na 48 godzin. Okno można ustawić na 1–720 godzin, a zero wyłącza ogranicznik. Każdy węzeł pozostaje widoczny w sieci, ale jego częste adverty nie zalewają eteru.

Na repeaterze można skonfigurować maksymalnie 32 reguły i 32 kanały. Reguły zapisują się w pamięci flash około 3 sekund po zmianie, więc przetrwają restart. Zerują się przy nim tylko liczniki.

Zdalnie, bez wchodzenia na maszt

Polecenia filter działają zarówno przez port szeregowy, jak i zdalnie. Administrator loguje się do repeatera z aplikacji na kompanionie, hasłem admina, i wpisuje polecenia filtra tak jak każde inne polecenie konsoli. Dokumentacja podaje też przykład dla biblioteki meshcore_py. Port szeregowy jest potrzebny tylko przy pierwszym wgraniu firmware'u i w przypadku problemów z połączeniem.

Ruch adresowany do samego repeatera nie przechodzi przez filtr, więc własne reguły nie zablokują logowania. Inaczej jest z regułami na repeaterach po drodze: zbyt szeroka reguła na pośrednim węźle może zatrzymać odpowiedź, zanim dotrze do aplikacji. Dokumentacja radzi dodać wcześniej regułę przepuszczającą ruch administracyjny i sprawdzić ją, póki mamy jeszcze dostęp przez kabel.

Najpierw policz, potem blokuj

Nową regułę można uruchomić w trybie próbnym, z action=forward. Repeater przekazuje wtedy pasujące pakiety dalej i tylko je zlicza. Polecenie filter stats pokazuje liczniki dla każdej reguły i szacunek czasu nadawania, który repeater oszczędził na odrzuconych pakietach. To górna granica: filtr nie wie, czy repeater i tak nie odrzuciłby danego pakietu z innego powodu, np. limitu skoków.

Dokumentacja mówi też wprost, czym filtr nie jest. Trzeba pamiętać, że nazwę urządzenia każdy może sobie zmienić, a klucz kanału znają wszyscy, którzy do niego należą. Reguła z nadawcą albo kanałem ograniczy więc szum, ale nikogo nie zatrzyma na dobre, bo żeby ją obejść, wystarczy zmienić nazwę. To narzędzie do porządkowania ruchu na wspólnym repeaterze, a nie do jego zabezpieczania.

Co jeszcze dodaje fork

  • Odcięcie przy słabej baterii. Poniżej ustawionego napięcia repeater przestaje przekazywać pakiety, ale dalej odpowiada administratorowi i ogłasza się w sieci. Gdy akumulator się podładuje, wraca do pracy sam.
  • Zarządzanie flotą. Wiadomość na prywatnym kanale z kluczem może uruchomić polecenia konsoli na wielu repeaterach naraz, np. zmianę ustawień radia w całej sieci klubu. Klucz tego kanału daje taki sam dostęp jak kabel podłączony do każdego z nich, dlatego trzeba go dobrze chronić.
  • Zegar z sieci. Repeater bez GPS-u i internetu może ustawić czas na podstawie podpisanych ogłoszeń innych węzłów, gdy wystarczająco wiele z nich się zgadza. To czas przybliżony, a nie wzorcowy.
  • Obserwator MQTT. Osobna wersja firmware'u dla płytek z ESP32 wysyła przez Wi-Fi pakiety, które usłyszał repeater, do serwerów MQTT. Korzystają z nich mapy i narzędzia do analizy sieci, np. ogólnopolski analizator MarWoja.

Oszczędzanie energii

Od wersji stabilnej r3 z 4 listopada fork ma trzy ustawienia, które zmniejszają pobór prądu. powersaving on usypia procesor, gdy nie ma nic do roboty; to funkcja oficjalnego MeshCore. set radio.rxps usypia także układ radiowy między krótkimi oknami nasłuchu. Ta część pochodzi z nieoficjalnego forka EasySkyMesh, o którym pisaliśmy w tekście „Procesor śpi, radio słucha. Nowe komendy w MeshCore PowerSaving 18”. Trzecie ustawienie, set cpu.freq, obniża taktowanie procesora i jest pomysłem samego forka.

W pomiarze autora repeater na płytce Xiao ESP32-S3 z modułem Wio-SX1262 pobierał bez oszczędzania 54 mA, po włączeniu powersaving 6 mA, z oszczędzaniem radia na poziomie balanced około 4 mA, a po obniżeniu taktowania do 80 MHz 3,75 mA według multimetru. To wynik z jednej płytki, więc inny sprzęt może zachowywać się inaczej. Usypianie radia działa tylko z układami SX126x, LLCC68 i LR11x0, a inne radia nasłuchują cały czas.

Wersja r4 naprawia dwa błędy w oszczędzaniu radia: na układzie SX1262 krótkie okna nasłuchu mogły gubić pakiety, a w T1000-E z układem LR1110 włączone oszczędzanie blokowało nadawanie. Poza tym radio.rxps off wreszcie przywraca ciągły nasłuch, czego w r3 nie robiło.

Drugi preset radia

Nowością wersji r4 jest radio2. Repeater ma jedno radio, ale może dzielić czas między dwa zestawy ustawień, np. dla dwóch sąsiednich sieci pracujących na różnych częstotliwościach. Przez większość czasu słucha na podstawowym, a na drugi przełącza się w krótkich oknach. Z jednej sieci do drugiej przechodzą tylko ogłoszenia węzłów i wiadomości grupowe rozsyłane przez flood, a wiadomości prywatne, potwierdzenia i ślady trasy zostają po swojej stronie. Pamiętajmy jednak, że drugi preset może przegapić część ruchu, zwiększa pobór prądu i nie działa razem z trybem oszczędzania radia.

Trzeba też pamiętać, że w Polsce i całej Unii oba presety muszą mieścić się w limitach dla pasma 868 MHz. Europejskie ustawienia MeshCore (869,4–869,65 MHz) pozwalają na 500 mW e.r.p. przy 10% czasu nadawania, a w pozostałej części pasma limity są dużo niższe. Drugi preset nie zwalnia z ich przestrzegania.

Przed aktualizacją

Kto używa reguł z nadawcą, powinien je po aktualizacji dobrze przetestować. Od r4 filtr oddziela nadawcę od treści na pierwszym dwukropku ze spacją, a nie na pierwszym dwukropku, więc nazwy z dwukropkiem są rozpoznawane inaczej niż dotąd.

Wersji r4 nie ma już dla płytek z układem STM32WLE5 (Wio-E5, Wio-E5 mini, RAK3172 i Tiny Relay): firmware przestał mieścić się w ich pamięci, więc zostaje im r3. Uwaga też na powrót do starszej wersji forka: jeśli nie odczyta ona nowszego pliku z regułami, repeater wystartuje z pustym filtrem.

Powrót do oficjalnego firmware'u jest możliwy w każdej chwili przez flasher.meshcore.io. Oficjalny MeshCore nie zna ustawień forka, np. drugiego presetu, więc po prostu je pominie.

Artykuł powstał na podstawie dokumentacji i opisów wydań forka jhuebert/MeshCore.