Dokumentacja Oprogramowania

Kompletny przewodnik po wszystkich funkcjach i interfejsach RF433-MQTT-SNIFFER

🌟 Co wyróżnia to urządzenie

RF433-MQTT-SNIFFER to profesjonalny analizator sygnałów 433MHz z wbudowanym interfejsem webowym i integracją z Home Assistant. Najważniejsze cechy:

📊 Panel Statusu

Główny ekran monitorowania pokazuje kompletny przegląd urządzenia na pierwszy rzut oka. Wszystkie informacje aktualizują się automatycznie co 5 sekund.

Panel Statusu

Co zobaczysz

📡 Status urządzenia

Tryb pracy pokazuje aktualny stan: uruchamianie, konfiguracja WiFi, łączenie lub pełna praca z MQTT.

Czas pracy wyświetla ile czasu minęło od ostatniego restartu - przydatne do monitorowania stabilności.

Wolna pamięć wskazuje dostępną pamięć RAM dla płynnego działania.

📶 Status sieci

WiFi pokazuje status połączenia - zielony (połączono) lub czerwony (rozłączono).

Adres IP to miejsce, z którego możesz uzyskać dostęp do interfejsu webowego z innych urządzeń.

Siła sygnału (RSSI) pokazuje jakość WiFi: -30 to świetnie, -70 akceptowalne, poniżej -80 mogą być problemy.

🔬 Status modułu RF

Status CC1101 potwierdza, że transceiver RF działa. Pokazuje wersję chipa (zazwyczaj "v14") gdy OK.

Liczniki sygnałów śledzą całkowitą liczbę odebranych (RX) i wysłanych (TX) sygnałów RF od startu.

Przycisk Restart reinicjalizuje moduł RF bez restartowania całego urządzenia.

🔬 Monitor Diagnostyczny

Monitorowanie sygnałów RF w czasie rzeczywistym ze szczegółową analizą protokołów. Tu widzisz każdy sygnał, który urządzenie przechwytuje.

Monitor Diagnostyczny

Log sygnałów RF

Przewijana lista pokazuje ostatnie 100 sygnałów RF ze wszystkimi szczegółami:

Szybkie akcje

Dane RAW impulsów

Kliknij dowolny wpis oznaczony [+RAW] aby rozwinąć i zobaczyć surowe dane czasowe impulsów. Przydatne do analizy nieznanych protokołów lub debugowania problemów z odbiorem.

Log systemowy

Pod logiem RF znajdziesz komunikaty diagnostyczne systemu z kolorowym oznaczeniem ważności:

🏷️ Menedżer Aliasów

Przypisuj przyjazne nazwy do kodów RF aby łatwo identyfikować urządzenia. Zamiast widzieć "0x554FF0", zobacz "Czujnik Drzwi Wejściowych" lub "Pilot Garaż".

Lista Aliasów

Jak działają aliasy

Dodawanie aliasu

Dodaj Alias

Dwa sposoby dodawania aliasów:

Odkrywanie unikalnych kodów

Unikalne Kody

Urządzenie automatycznie śledzi każdy unikalny kod RF jaki odbierze (do 200 kodów). Pomaga to odkryć wszystkie urządzenia RF w Twoim otoczeniu:

Kopia zapasowa i przywracanie

Backup

Backup - Pobierz wszystkie aliasy jako plik JSON

Przywracanie

Przywracanie - Importuj aliasy z pliku kopii zapasowej

Użyj backupu przed aktualizacją firmware lub przy migracji na nowe urządzenie. Funkcja przywracania automatycznie pomija duplikaty.

📊 Analizator Widma RF

Wizualizuj aktywność RF wokół 433MHz w czasie rzeczywistym. Zobacz które częstotliwości są zajęte, znajdź źródła zakłóceń i sprawdź czy antena działa poprawnie.

Analizator Widma

Zrozumienie wyświetlacza

Praktyczne zastosowania

🔬 Diagnostyka sprzętowa CC1101

Wbudowane testy sprzętowe do weryfikacji czy moduł RF jest prawidłowo podłączony i skonfigurowany. Uruchom te testy jeśli masz problemy z odbiorem.

Test CC1101

Wyniki testów

Wszystkie testy powinny pokazać zielone znaczniki. Czerwony X oznacza problem, który wymaga uwagi - zazwyczaj to problem z okablowaniem lub zasilaniem.

🔗 Sieć Mesh UNIKALNA FUNKCJA

To jest wyróżniająca funkcja, która odróżnia RF433-MQTT-SNIFFER od każdego innego odbiornika 433MHz. Połącz wiele urządzeń w konfiguracji Master-Satelita aby pokryć całą nieruchomość jednym zunifikowanym systemem.

Sieć Mesh

Dlaczego Mesh ma znaczenie dla RF433

Tradycyjne odbiorniki RF pokrywają tylko obszar wokół siebie. Jedno urządzenie w piwnicy nie usłyszy czujnika na drugim piętrze. Z siecią mesh rozstawiasz urządzenia Satelitarne w całej nieruchomości, a wszystkie przekazują sygnały do jednego urządzenia Master. Twój Home Assistant widzi JEDNO urządzenie z pełnym pokryciem.

Jak to działa

🎯 Urządzenie Master

Centralne urządzenie odbierające sygnały ze wszystkich Satelitów. Tylko Master łączy się z MQTT i Home Assistant. Umieść go gdziekolwiek jest wygodne - nie musi być centralnie.

📡 Urządzenia Satelitarne

Zdalne czujniki umieszczone tam, gdzie potrzebne jest pokrycie RF. Gdy Satelita odbierze sygnał RF, natychmiast przekazuje go do Mastera przez WiFi. Typowy czas odpowiedzi poniżej 100ms.

🔍 Auto-wykrywanie

Funkcja Skanowania znajduje wszystkie urządzenia RF433 w Twojej sieci. Kliknij "Paruj" aby natychmiast skonfigurować urządzenie jako Satelitę połączonego z Masterem.

♻️ Inteligentna deduplikacja

Jeśli ten sam sygnał RF zostanie odebrany przez wiele urządzeń (częste w obszarach nakładających się), Master automatycznie filtruje duplikaty. Tylko jedno zdarzenie trafia do Home Assistant.

Przykład wdrożenia

Rezultat: Pełne pokrycie RF 3-piętrowego domu z jedną integracją MQTT. Żaden sygnał nie zostanie pominięty niezależnie od miejsca pochodzenia.

Monitorowanie stanu

Master stale monitoruje wszystkie Satelity:

⚙️ Ustawienia i konfiguracja

Kompletna konfiguracja urządzenia przez interfejs webowy. Wszystkie ustawienia są zapisywane do pamięci flash i zachowują się między restartami.

📶 Ustawienia WiFi

Skonfiguruj nazwę sieci (SSID) i hasło. Opcjonalnie ustaw statyczny adres IP jeśli wolisz, by urządzenie miało zawsze ten sam adres.

Jeśli połączenie WiFi się nie powiedzie, urządzenie tworzy własny punkt dostępu "RF433-Config" do konfiguracji.

🔌 Ustawienia MQTT

Wprowadź adres brokera MQTT (zazwyczaj IP Twojego Home Assistant). Skonfiguruj nazwę użytkownika/hasło jeśli broker wymaga uwierzytelniania.

Przycisk Test Połączenia sprawdza czy broker jest osiągalny przed zapisaniem.

🔗 Ustawienia Mesh

Wybierz tryb pracy: Samodzielny (jedno urządzenie), Master (koncentrator) lub Satelita (zdalny czujnik).

Dla Satelitów wprowadź adres IP Mastera i przypisz unikalny ID urządzenia.

🏷️ Tożsamość urządzenia

Ustaw przyjazną nazwę urządzenia, która pojawia się w Home Assistant i interfejsie webowym.

Skonfiguruj strefę czasową dla prawidłowych znaczników czasu w logach i wiadomościach MQTT.

Ustawienia WiFi Ustawienia MQTT

🔄 Aktualizacja firmware (OTA)

Aktualizuj urządzenie bezprzewodowo bez podłączania kabli. Nowe wersje firmware dodają funkcje i naprawiają błędy.

Aktualizacja OTA

Proces aktualizacji

Wybierz plik

1. Wybierz plik firmware.bin

Postęp

2. Obserwuj postęp przesyłania

Funkcje bezpieczeństwa

Najlepsze praktyki

🏠 Integracja z Home Assistant

Integracja bez konfiguracji z Home Assistant przez MQTT Discovery. Podłącz i wszystkie sensory pojawią się automatycznie.

Automatyczne wykrywanie

Gdy urządzenie połączy się z brokerem MQTT, automatycznie ogłasza się do Home Assistant. W ciągu sekund zobaczysz:

Zdarzenia sygnałów RF

Każdy odebrany sygnał RF wyzwala zdarzenie z kompletnymi informacjami:

Pomysły na automatyzacje

💾 Przechowywanie danych

Wszystkie ustawienia i dane są trwale zapisywane w pamięci flash. Nic nie jest tracone po odłączeniu zasilania.

Co jest zapisywane

⚙️ Konfiguracja

Dane WiFi, ustawienia MQTT, konfiguracja mesh, nazwa urządzenia, strefa czasowa - wszystko zapisane.

🏷️ Aliasy

Do 255 aliasów kodów RF z ich nazwami. Zapisywane natychmiast po każdej zmianie.

📜 Historia sygnałów

Ostatnie 100 sygnałów RF zachowane do przeglądu po restarcie. Automatycznie odświeżane przy nowych sygnałach.

🔢 Unikalne kody

Do 200 odkrytych unikalnych kodów RF ze statystykami - zachowane na stałe.

Reset fabryczny

Jeśli potrzebujesz zacząć od nowa, przytrzymaj przycisk BOOT przez 10 sekund. To wymaże wszystkie ustawienia i przywróci urządzenie do ustawień fabrycznych. Urządzenie utworzy punkt dostępu do początkowej konfiguracji.

← Specyfikacja sprzętowa Powrót do strony głównej Repozytorium GitHub →