Már írtam korábban az USB-s RTLSDR vevő felhasználási lehetőségéről a rádiós eszközök adatainak begyűjtésével, a gyári Domoticz plugin használatával. Aminek annyi apró szépséghibája van/volt, hogy az egyszerű RF433 nyomógombokkal nem nagyon tudott mit kezdeni, inkább a rádiós hőmérőkre van kihegyezve.

A korábban használt rtl_433 alkalmazásra továbbra is szükségünk lesz, ha nincs még fent azon a gépen, amire az USB-s RTLSDR-t akarjuk csatlakoztatni, tegyük meg az eredeti cikkben leírtak szerint. (ez fizikailag lehet másik gépen is, vagy akár ugyanazon, amelyiken a Domoticz fut)

Az rtl_433 telepítését követően a /usr/local/etc/rtl_433/ mappában létrejött egy rtl_433.example.conf nevű beállításokat tartalmazó állomány, ezt nevezzük át rtl_433.conf-ra, az ebben tárolt beállítások a program minden indulásakor használatra kerülnek. Ez hasznos dolog, ha a FLEX dekóder segítségével akarunk jelsorozatokat felismertetni a programmal. A Flex dekóderről annyit kell tudni, hogy akkor van rá szükség, ha olyan RF433-as eszköz jelét akarjuk fogni, ami a programban szereplő körülbelül 130-féle eszközdefinícióban nem szerepel. Gyakorlatilag a legtöbb csengőkapcsoló, valamint az egyszerű mozgás és nyitásérzékelők 99%-a ebbe a kategóriába esik.
A conf fájl legnagyobb részét a használt protokollok listája teszi ki (protocol xx sorok), amiből úgy tudunk kizárni sorokat, hogy # jelet írunk elé, vagy egyszerűen töröljük azt. A végén pedig a "decoder n=..." sorok tartalmazzák a mintaként szereplő Flex dekóder számára értelmezhető sorokat, ezeket nyugodtan zárjuk ki, ha egyik eszközünket sem ismerik, minél kevesebb protocol és decoder sor van a konfigurációs állományban, annál gyorsabb a jelek értelmezése. (és a téves pozitívok száma is)
De hogyan tudjuk meg az eszközünk főbb paramétereit, ha nem vagyunk lelkes rádióamatőrök?

Az alábbi parancs indítását követően az rtl_433 megpróbálja analizálni a bejövő rádiójeleket:

Ha valami ehhez hasonlót látunk:

No akkor nyert ügyünk van, mert sikerült találnia egy olyan beállítást, amit ha bemásolunk a conf állomány végére, akkor mindig ugyanazt a számot társítja a bejövő jelhez utána, tehát tudjuk használni azonosításra.

A fenti példánál maradva a conf-ba az alábbi sort kell beilleszteni:

Ez után, ha futtatjuk az rtl_433 parancsot és az előző eszköz jelet ad, akkor azt jelenti majd, hogy "EzATipusNeve" modelltől kapott adatot. Több dekóder sor használata esetén természetesen egyre nagyobb a téves pozitív felismerések aránya, még az is lehet, hogy jobban járunk egy másik eszköz dekóder sorával, ami többet is felismer az eszközök közül, ez meglehetősen "próba és hiba" játék.

Ha ez a része megvan, akkor gondolkozhatunk a Domoticz felé történő adatközlésen. Az újonnan megjelent MQTT továbbítási módot használjuk, ami rugalmasabb, mint a Domoticz saját illesztője által használt "CSV kinyerése végtelen ciklusban" eljárás:

Ha az MQTT szerver ugyanazon a gépen van, akkor a fenti sorban egyszerűen az mqtt://localhost:1883 lesz a cím, egyébként az MQTT szerver IP címét kell behelyettesíteni a megfelelő helyre. Annyi a feladatunk, hogy a fenti parancsot valamilyen módon automatikusan indítsuk a rendszer indulásával, mivel e nélkül nem fognak érkezni az adatok...
Alapértelmezetten az "rtl_433/gépneve/events" MQTT témába küldi a jeleket, JSON formában.

Figyelem: mivel az rtl_433 programnak kizárólagos hozzáférésre van szüksége az USB tunerhez, egyidőben pontosan egy példány futhat belőle!

A Domoticz-ban ezúttal nem a gyárilag benne levő vevőt alkalmazzuk, hanem le kell tölteni egy külső Python plugint (ami fogadja a fentebb írt adatokat!), ám mielőtt használatba tudnánk venni egy - bármilyen - python plugint, érdemes az alábbi paranccsal feltelepíteni a függőségeket a Domoticz szervergépre:

Ha ez megvan, lépjünk be a Domoticz alatti plugins könyvtárba és töltsük le a PyRTL433 plugint:

Majd a Domoticz újraindítása után a hardverek között immár megtalálható a "PyRtl433 RTL-SDR MQTT receiver" eszköz: (Beállítás->Hardver)

Eszközt nem lehet és nem is kell felvenni bele, öntanuló módon felveszi azokat az eszközöket, amiket az rtl_433 lejelent erre az MQTT brókerre, megjelenik a Beállítás->Eszközök közé. (megj: ha minden szükséges eszközt megtanítottunk a pluginnek, érdemes az "Enable new device creation" opciót lekapcsolni, hagy az RF zajok ne készítsenek egy rakat felesleges eszközt)

Az eszköz neve a modell és flex szenzor esetén a küldött azonosító, amit átnevezhetünk a későbbiekben tetszés szerint, viszont alapértelmezetten nem engedélyezi az új eszközt, ezt kézzel kell elvégeznünk a zöld körben jobbra mutató nyílra kattintva a megfelelő soron.

Amennyiben mozgásérzékelő vagy csengőnyomógomb az eszköz, akkor a kapcsolók között, a Szerkesztés gombjára kattintva elérhetjük a beállításait:

És ezen beállítások között érdemes a "Késleltetett kikapcsolás" funkciót beállítani pl 2-3 másodpercre, mivel ezek az eszközök csak egyetlen jelet adnak: amikor aktiválják őket, ezen a módon tudjuk beállítani, hogy nyugalmi állapotba kerüljön az eszköz a jelzés vétele után, és készen álljon a következő vételére.

Olyan nyitásérzékelő esetén, ami mindkét állapotát küldi, kicsit bonyolultabb a helyzet, bár annyiban jobb, hogy mindig tudható melyik állapotban van éppen. Ha ilyet akarunk készíteni, első lépésben vegyük fel a mind a két állapotát (Nyitott és Csukott) két külön kapcsolóként/nyomógombként késleltetett kikapcsolással, ahogy az előző példában.
Majd vegyünk fel egy Dummy hardware-t, ahogy a legelső Domoticz használatát bemutató cikkben írtam róla. (Virtuális érzékelők létrehozása)

Majd a Beállítás->Több lehetőség->Felhasználói szkripteknél a + jelre kattintva hozzunk létre egy új LUA Device szkriptet az alábbi tartalommal:

commandArray = {}

for deviceName,deviceValue in pairs(devicechanged) do
    if (deviceName=='Door1-Opened') then
        if deviceValue == "On" then
            commandArray['Door1'] = "On"
        end
    end
    if (deviceName=='Door1-Closed') then
        if deviceValue == "On" then
            commandArray['Door1'] = "Off"
        end
    end
end
return commandArray

Ez annyit tesz, hogyha a Door1-Opened nevű rádiós eszköz aktiválódik, akkor a Door1 nevű virtuális eszközt Be állapotba, ha a Door1-Closed nevű aktiválódik, akkor pedig Ki állapotba kapcsolja, így a Door1 státuszában a nyitásérzékelő aktuális állapotát követhetjük, ezt az egy ikont kell felvinni a térképre az ajtó helyére.

Természetesen ugyanez a plugin tudja kezelni az RTL által ismert hőmérőket is:

Az eljárás még aránylag béta, erős tesztelése szükséges, illetve az RTL által közölt RSSI adatok Domoticz által elfogadható értékké konvertálása még várat magára...