Interfejs wiersza poleceń

Konfiguracja MeshCore CLI

Zarządzaj swoimi węzłami MeshCore za pomocą oficjalnego narzędzia MeshCore-CLI. Doskonała kontrola dla zaawansowanych użytkowników i automatyzacja.

Co to jest MeshCore CLI?

Interfejs wiersza poleceń MeshCore (MeshCore-CLI) to narzędzie oparte na języku Python, które umożliwia komunikację z radiem towarzyszącym MeshCore za pośrednictwem terminala. CLI obsługuje połączenia poprzez Bluetooth Low Energy (BLE), TCP/IP lub serial.

Ponadto repeatery i serwery pokojowe mają własne wbudowane CLI, do których można uzyskać dostęp poprzez USB/serial lub zdalnie. Dzięki temu możesz skonfigurować częstotliwość, moc transmisji, nazwę i inne ustawienia bezpośrednio na urządzeniu.

W tym przewodniku opisano obie metody: narzędzie Pythona MeshCore-CLI w języku Python dla radiotelefonów towarzyszących oraz narzędzie szeregowe CLI dla przemienników i serwerów pokojowych. Idealny dla administratorów systemów, zaawansowanych użytkowników i każdego, kto chce korzystać ze skryptów lub automatyzacji.

Dlaczego warto używać CLI?

Szybkość i wydajność

Skonfiguruj węzły w ciągu kilku sekund za pomocą zaledwie kilku poleceń, znacznie szybciej niż przy użyciu interfejsu graficznego.

🤖

Automatyzacja skryptowa

Napisz skrypty w języku bash lub Python, aby wykonywać operacje wsadowe na wielu węzłach jednocześnie.

🔧

Pełna kontrola

Dostęp do wszystkich ustawień, w tym zaawansowanych parametrów radia i konfiguracji przemiennika.

📡

Wiele połączeń

Połącz się przez Bluetooth, Wi-Fi/TCP lub port szeregowy — wybierz opcję, która najlepiej pasuje do Twojej konfiguracji.

🖥️

Zdalne zarządzanie

Zarządzaj zdalnie wzmacniakami za pomocą funkcji zdalnego administratora z poziomu CLI lub aplikacji mobilnej.

💬

Interaktywny tryb czatu

CLI ma tryb interaktywny z uzupełnianiem zakładek, historią i komunikatami w czasie rzeczywistym.

Zainstaluj MeshCore CLI

Instalujesz narzędzie MeshCore-CLI jako pakiet Pythona za pomocą pip lub pipx. Działa na systemach Windows, macOS, Linux i Raspberry Pi. Wymaga Pythona 3.10 lub nowszego.

Krok 1: Sprawdź wersję Pythona

Potrzebujesz Pythona 3.10 lub nowszego. Sprawdź swoją wersję:

python3 --version

Jeśli Python nie jest zainstalowany, pobierz go z python.org

Krok 2: Zainstaluj MeshCore-CLI

Zainstaluj oficjalne narzędzie MeshCore CLI za pomocą pipx (zalecane) lub pip:

# Via pipx (aanbevolen)
pipx install meshcore-cli
# Of via pip
pip3 install meshcore-cli

Krok 3: Sprawdź instalację

Sprawdź, czy instalacja przebiegła pomyślnie, otwierając pomoc:

meshcli -h

Podstawowe polecenia CLI

MeshCore-CLI obsługuje zarówno parametry wiersza poleceń, jak i interaktywny tryb czatu. Rozpocznij bez argumentów dla trybu interaktywnego.

Wybierz urządzenie (BLE)

Zeskanuj i wybierz swoje urządzenie MeshCore za pomocą Bluetooth. CLI zapamiętuje Twój wybór na potrzeby kolejnych sesji.

meshcli -S

Połącz się poprzez TCP/IP

Połącz się z węzłem MeshCore przez Wi-Fi/sieć, jeśli serwer TCP jest aktywny.

meshcli -t 192.168.1.100

Połącz przez port szeregowy

Połącz się przez USB/port szeregowy, aby uzyskać bezpośrednią komunikację z węzłem.

meshcli -s /dev/ttyUSB0

Wyślij wiadomość

Wyślij wiadomość tekstową do określonego kontaktu lub wyślij wiadomość do wszystkich.

meshcli send "Hallo MeshCore netwerk!"

Wyświetl kontakty

Wyświetl wszystkie znane węzły w Twojej sieci wraz z ich statusem i siłą sygnału.

meshcli contacts

Tryb interaktywny

Uruchom bez poleceń w interaktywnym trybie czatu z uzupełnianiem kart i historią.

meshcli

Repeater i serwer pokojowy CLI

Repeatery i serwery pokojowe mają wbudowane CLI, których można używać poprzez USB/serial (terminal/PuTTY) lub przez T-Deck CLI. Po flashowaniu skonfiguruj tutaj podstawowe ustawienia.

Ustaw częstotliwość (wymagane)

Po flashowaniu musisz najpierw ustawić częstotliwość dla swojego regionu. W Europie użyj 869,4 MHz lub 869,525 MHz.

set freq 869.4
reboot

Nazwa i lokalizacja

Nadaj swojemu przemiennikowi rozpoznawalną nazwę i opcjonalne współrzędne GPS dla mapy.

set name MijnRepeater
set lat 52.3676
set lon 4.9041

Skonfiguruj moc transmisji

Dostosuj moc nadawania w dBm. Użyj maksymalnie 22 dBm dla pasma UE 868 MHz.

set tx 22

Ustawienia wzmacniaka

Skonfiguruj opcje specyficzne dla przemiennika, takie jak limity przeskoków i interwały anonsów.

set flood.max 3
set advert.interval 30
set flood.advert.interval 3

Konfiguracja oparta na sieci WWW

Oprócz CLI możesz także skonfigurować wzmacniaki i serwery pokojowe za pomocą narzędzi internetowych. Często jest to łatwiejsze dla początkujących.

MeshCore Flasher

Wgraj oprogramowanie sprzętowe i skonfiguruj bezpośrednio przez przeglądarkę na stronie flasher.MeshCore.co.uk. Po flashowaniu kliknij „Konsola”, aby uzyskać dostęp CLI.

flasher.meshcore.co.uk →

MeshCore Narzędzie konfiguracyjne

Skonfiguruj istniejące wzmacniaki poprzez config.MeshCore.dev - połącz się poprzez USB i dostosuj ustawienia w przeglądarce.

config.meshcore.dev →

Minimalna konfiguracja po flashowaniu

Po wgraniu oprogramowania sprzętowego MeshCore wymagane są przynajmniej te kroki:

#1. Ustaw częstotliwość (wymagana do legalnego użytku)
ustaw częstotliwość 869,4

#2. Uruchom ponownie, aby zastosować zmiany
uruchom ponownie

#3. Opcjonalnie: nadaj swojemu wzmacniaczowi nazwę
ustaw nazwę MójRepeater

#4. Opcjonalnie: ustaw lokalizację na mapie
ustaw pasek 52,3676
ustaw lon 4.9041

Często zadawane pytania dotyczące CLI

Jaka jest różnica między MeshCore-CLI a ciągiem CLI?

meshcore-cli (meshcli) to narzędzie w języku Python, które umożliwia komunikację z towarzyszącym radiem za pośrednictwem BLE, TCP lub portu szeregowego. serial CLI jest wbudowany w wzmacniaki i serwery pokojowe i można uzyskać do niego bezpośredni dostęp poprzez USB/terminal. Oba mają różne polecenia i aplikacje.

Jak połączyć się przez Bluetooth?

W systemie Linux musisz najpierw sparować urządzenie przez bluetoothctl. Następnie użyj meshcli -S, aby wybrać swoje urządzenie. CLI pamięta Twój wybór w ~/.config/meshcore.

Czy mogę zdalnie skonfigurować wzmacniaki?

Tak! Funkcja Remote Admin umożliwia zarządzanie przemiennikami i serwerami pokojowymi poprzez LoRa. Działa to od MeshCore-CLI z poleceniami repeater lub za pośrednictwem aplikacji mobilnej z funkcją zdalnego zarządzania.

Jakiej częstotliwości powinienem używać w Polsce/Europie?

Używaj częstotliwości w paśmie 868 MHz. Najczęściej wybierane częstotliwości to 869,4 MHz lub 869,525 MHz. Nigdy nie używaj częstotliwości 915 MHz – jest ona dozwolona tylko w USA i nielegalna w Europie.

Jak zresetować wzmacniacz do ustawień fabrycznych?

Za pomocą numeru seryjnego CLI możesz użyć erase, aby usunąć system plików. Spowoduje to usunięcie wszystkich ustawień. Następnie należy ponownie ustawić częstotliwość.

Gdzie mogę znaleźć wszystkie dostępne polecenia?

Dla MeshCore-CLI: meshcli -h pokazuje wszystkie opcje. Dla wzmacniaka/serwera pokojowego CLI: help w konsoli szeregowej. Pełne informacje znajdują się na wiki MeshCore GitHub.

Opanuj wiersz poleceń

Dzięki MeshCore CLI masz profesjonalną kontrolę nad swoją siecią kratową. Idealny do zarządzania przemiennikami, tworzenia skryptów i zaawansowanej konfiguracji. Dla automatyzacji w Python sprawdź Python API.

Powiązane artykuły