Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
plugins:radioscanner:start [2023/11/29 18:22] Oliver Lewaldplugins:radioscanner:start [2024/03/20 17:25] (aktuell) – Struct-Daten geändert Michael Schlenstedt
Zeile 3: Zeile 3:
 ++++ Version History... | ++++ Version History... |
  
-Version 1.0.0:+Version 1.0.0: Erste Version
  
 ++++ ++++
Zeile 11: Zeile 11:
 ===== Funktion des Plugins ===== ===== Funktion des Plugins =====
  
-Mit Hilfe des Plugins ist es möglich eine breites Spektrum an unterschiedlichsten Funk Sensoren über gängige Bandbreiten zu erfassen und die empfangenen Daten per MQTT an den MS zu schicken. Die Bandbreiten sind frei wählbar, wobei die gängigsten bereits zur Auswahl zur Verfügung stehen (315Mhz, 345Mhz, 433.92Mhz, 868.3Mhz und 915 Mhz). Dafür ist ein DVB-T USB Stick notwendig der den RTL-SDR (RTL2838) Spezifikationen entspricht.+Mit Hilfe des Plugins ist es möglich eine breites Spektrum an unterschiedlichsten Funk Sensoren über gängige Bandbreiten zu erfassen und die empfangenen Daten per MQTT an den MS zu schicken. Die Bandbreiten sind frei wählbar, wobei die gängigsten bereits zur Auswahl zur Verfügung stehen (315Mhz, 345Mhz, 433.92Mhz, 868.3Mhz und 915 Mhz). Dafür ist ein DVB-T USB Stick notwendigder den RTL-SDR (RTL2832U) Spezifikationen entspricht.
  
-Die Sticks gibt es bereits für ca. 10€, aber auch teurere bis hin zu 90€. Die Tests haben ergeben das für unseren Hausgebrauch die günstigen vollkommen ausreichend sind. Theoretisch, je nach Antenne, können hier auch Wetterdaten oder auch Flugzeugtransponder empfangen werden. Gimmick am Rande... TPMS Daten (Reifenluftdrücke) werden u.U. empfangen (433.92Mhz).+Die Sticks gibt es bereits für ca. 10€, aber auch teurere bis hin zu 90€. Die Tests haben ergeben, dass für unseren Hausgebrauch die günstigen Sticks vollkommen ausreichend sind. Theoretisch, je nach Antenne, können hier auch Wetterdaten oder auch Flugzeugtransponder empfangen werden. Gimmick am Rande... TPMS Daten (Reifenluftdrücke) werden u.U. empfangen (433.92Mhz).
  
-Die Sticks gibt es bei Alibaba aber auch bei inländischen Quellen (Update/Quellen folgen)+===== Passende USB-Sticks zum Empfang der Daten ===== 
 + 
 +Die Sticks gibt es bei Alibaba/Alixexpress, aber auch bei inländischen Quellen. %%Wichtig bei der Auswahl eines geeigneten Sticks ist nur der Chip **RTL2832U**. Der Tuner/Decoder Chip ist für unseren Einsatzzweck egal, also FC0012 oder R820T2 ist nicht relevant. Die Sticks mit FC0012 sind meist etwas günstiger.%% 
 + 
 +Folgende Sticks wurden erfolgreich getestet: [[https://www.funk-technik.info/alles-%C3%BCber-rtl-sdr/welche-dvb-t-stick-funktionieren.html]] 
 + 
 +Man kann sich aber auch einfach an der "Optik" etwas orientieren - die meisten geeigneten Sticks sehen so aus: 
 + 
 +{{plugins:radioscanner:pasted:20231130-092418.png?400}} 
 + 
 +**Quellen:** 
 + 
 +  * [[https://de.aliexpress.com/w/wholesale-RTL2832U.html]] 
 +  * [[https://www.amazon.de/s?k=RTL2832U]] 
 +  * [[https://www.google.de/search?q=RTL2832U&tbm=shop]]
  
 ===== Download ===== ===== Download =====
  
-→ verfügbare Releases [[https://github.com/Liver64/LoxBerry-Radioscanner/releases]]+Verfügbare Releases[[https://github.com/Liver64/LoxBerry-Radioscanner/releases]]
  
 ===== Konfiguration ===== ===== Konfiguration =====
Zeile 29: Zeile 43:
 == Frequenzen: == == Frequenzen: ==
  
-Es können bis zu 3 vordefinierte Frequenzen selektiert werden, eine vierte für eine spezielle Frequenz steht als Inputfeld zur Verfügung. Hier kann entweder die Frequenz in Mhz (z.B. **868.3**) oder in Hz (z.B. **868300000**) eingegeben werden.+Es können bis zu 3 vordefinierte Frequenzen selektiert werden, eine vierte für eine spezielle Frequenz steht als Inputfeld zur Verfügung. Hier kann entweder die Frequenz in Mhz (z.B. **868.3M**) oder in Hz (z.B. **868300000**) eingegeben werden.
  
 == Hop Interval == == Hop Interval ==
Zeile 37: Zeile 51:
 == Sample Rate == == Sample Rate ==
  
-Mit der Sample rate kann die Abtastfrequenz noch angepasst werden falls bei 250Khz nichts empfangen wurde. Hier stehen 4 unterschiedliche (250Khz, 1024KHz, 2048Khz und 3200Khz) zur Verfügung.+Mit der Sample Rate kann die Abtastfrequenz noch angepasst werden falls bei 250Khz nichts empfangen wurde. Hier stehen 4 unterschiedliche (250Khz, 1024KHz, 2048Khz und 3200Khz) zur Verfügung.
  
 == Sensoren == == Sensoren ==
  
-Auswahl spezifischer Sensoren für den Empfang der DatenFalls kein(e) Sensor(en) selektiert wurden wird nach allem gescannt.+Auswahl spezifischer Sensoren für den Empfang der DatenFalls kein(e) Sensor(en) selektiert wurdenwird nach allem gescannt.
  
-=== MQTT Finder ===+===== Scanner ===== 
 + 
 +<WRAP center round important 100%> 
 + 
 +Während der Nutzung des Scanners wird die MQTT-Übertragung des Plugins gestoppt! 
 + 
 +</WRAP> 
 + 
 +Den Scanner kann man nutzen um verschiedene Einstellungen zu testen und zu schauen, welche Sensoren in der Umgebung empfangbar sind. Für den Scanner ist es notwendig, sich an einem Terminal am LoxBerry anzumelden. Dazu nutzt man entweder das neue [[konfiguration:widget_help:widget_terminal|Terminal-Widget]] (ab LB3.0) oder eine [[haufig_gestellte_fragen_faq:eine_sshverbindung_mit_putty_aufbauen_shellzugriff|Verbindung über PuTTY]]. 
 + 
 +{{plugins:radioscanner:pasted:20231209-081932.png?500}} 
 + 
 +Nachdem ihr Euch auf dem LoxBerry am Terminal angemeldet habt, gebt ihr folgenden Befehl und anschließend ENTER ein: 
 + 
 +''rascanner'' 
 + 
 +Der Scanner läuft dann ohne weitere Angaben mit den Einstellungen, die ihr in der Plugin-Konfiguration eingestellt habt. Beendet wird er mit ''<STRG>+C'' 
 + 
 +Der Scanner ist praktisch, um verschiedene Einstellungen zu testen und zu schauen, mit welchen Einstellungen man möglichst viele Sensoren (oder die gewünschten Sensoren) am Besten empfängt. Dazu kann man den Scanner auch mit Einstellungen über Optionen starten, die nicht in der Pluginkonfiguration definiert worden sind. Der Scanner versteht [[https://github.com/merbanan/rtl_433#running|alle Optionen der Software rtl_433]]. Die wichtigsten sind: 
 + 
 +^ Option ^ Beschreibung ^ Hinweise ^ 
 +| ''-f'' | Zu scannende Frequenz, Mehrfachangaben möglich | Meist genutzt: ''-f 433.92M'' ''-f 868,3M'' und in der EU eher selten ''-f 915M''
 +| ''-H'' | Hopping-Intervall. Nach diesem Intervall wechselt der Scanner auf die nächste Frequenz (siehe -f). Wählt zum Testen das Intervall nicht zu kurz, falls Sensoren relativ selten senden "verpasst" ihr sonst diese Sensoren. | Sinnvoll zum Testen mindestens ''-H 120'', eventuell sogar ''-H 300'' oder ''-H 600''
 +| ''-s'' | Sampling Rate | Meist ''-s 250k'' oder ''-s 1024k''
 + 
 +Weitere Optionen findet ihr in der Doku zu rtl_433: [[https://github.com/merbanan/rtl_433#running|https://github.com/merbanan/rtl_433#running]] 
 + 
 +Ein Aufruf des Scanners mit speziellen Einstellungen könnte zum Beispiel so aussehen: 
 + 
 +''rascanner -f 433.92M -f 868.3M -H 300 -s 250k'' 
 + 
 +(Scannt die Frequenzen 433.92 Mhz und 868.3 Mhz und wechselt zwischen diesen Frequenzen alle 5 Minuten (300s). Die Samplingrate ist 250.000 Hz) 
 + 
 +===== MQTT Finder =====
  
 Im **MQTT Finder** werden alle empfangenen Daten/Sensoren direkt gelistet und können anschließend in den MS eingebunden werden. Im **MQTT Finder** werden alle empfangenen Daten/Sensoren direkt gelistet und können anschließend in den MS eingebunden werden.
  
-=== MQTT Beispieldaten einer Bresser Wetterstation: ===+== MQTT Beispieldaten einer Bresser Wetterstation: ==
  
 {{:plugins:radioscanner:rs4.png?800}} {{:plugins:radioscanner:rs4.png?800}}
  
 ===== Hardware bzw. Sensoren ===== ===== Hardware bzw. Sensoren =====
- 
-Folgende Hardware wurde erfolgreich getestet: [[https://www.funk-technik.info/alles-%C3%BCber-rtl-sdr/welche-dvb-t-stick-funktionieren.html|Funktechnik]] 
  
 Folgende Sensoren werden derzeit supported: Folgende Sensoren werden derzeit supported:
  
 +^ ID ^ Sensor ^
 | [01]  | Silvercrest Remote Control  | | [01]  | Silvercrest Remote Control  |
 | [02]  | Rubicson, TFA 30.3197 or InFactory PT-310 Temperature Sensor  | | [02]  | Rubicson, TFA 30.3197 or InFactory PT-310 Temperature Sensor  |
Zeile 302: Zeile 348:
 | [250]  | Schou 72543 Day Rain Gauge  | | [250]  | Schou 72543 Day Rain Gauge  |
  
-Die mit * gekennzeichneten müssen manuell hinzugefügt werden.+Die mit * gekennzeichneten Sensoren müssen manuell hinzugefügt werden. 
 + 
 +===== Troubleshooting / getting started =====
  
 ===== Einrichtung in der Loxone Config Software ===== ===== Einrichtung in der Loxone Config Software =====
  
-→ Die Daten werden über MQTT dem Miniserver zur Verfügung gestellt. Um diese dann zu nutzen bitte den MQTT Richtlinien folgen.+Die Daten werden über MQTT dem Miniserver zur Verfügung gestellt. Um diese dann zu nutzen bitte den MQTT Richtlinien folgen: [[konfiguration:widget_help:widget_mqtt]]
  
 ===== Roadmap ===== ===== Roadmap =====
  
-→ Multi Dongles (bis zu 3 USB Sticks/Dongles)+  * Multi Dongles (bis zu 3 USB Sticks/Dongles)
  
 ===== Fragen stellen und Fehler melden ===== ===== Fragen stellen und Fehler melden =====
Zeile 321: Zeile 369:
 pluginuebersicht.logo : :plugins:radioscanner:icon_128.png pluginuebersicht.logo : :plugins:radioscanner:icon_128.png
 pluginuebersicht.status : BETA pluginuebersicht.status : BETA
-pluginuebersicht.version : 1.0.0 +pluginuebersicht.version : 1.0.3 
-pluginuebersicht.min_lb_version : 3 +pluginuebersicht.min_lb_version : 3.0 
-pluginuebersicht.url_release : https://github.com/Liver64/LoxBerry-Radioscanner/archive/refs/tags/v1.0.0.zip+pluginuebersicht.url_release : https://github.com/Liver641/LoxBerry-Radioscanner/archive/refs/tags/v1.0.3.zip
 pluginuebersicht.url_prerelease :  pluginuebersicht.url_prerelease : 
 pluginuebersicht.description : Plugin um verschiedenste Funk Sensoren zu empfangen und die Daten per MQTT dem Loxone Miniserver zur Verfügung zu stellen. Dazu wird ein DVB-T USB-Empfänger benötigt der über einen RTL-SDR Chip (RTL2838) verfügt. pluginuebersicht.description : Plugin um verschiedenste Funk Sensoren zu empfangen und die Daten per MQTT dem Loxone Miniserver zur Verfügung zu stellen. Dazu wird ein DVB-T USB-Empfänger benötigt der über einen RTL-SDR Chip (RTL2838) verfügt.
-pluginuebersicht.languages : EN,DE +pluginuebersicht.languages : EN, DE 
-pluginuebersicht.discussion : +pluginuebersicht.discussion : https://www.loxforum.com/forum/projektforen/loxberry/plugins/412617-radioscanner
 ---- ----