-
Notifications
You must be signed in to change notification settings - Fork 0
/
rfxbnz.txt
executable file
·122 lines (69 loc) · 4.57 KB
/
rfxbnz.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.. _index:
===================
Plugin rfxbnz
===================
Purpose
=======
The **rfxbnz** plugin is used to handle xPL messages sent by xPL clients **xpl-rfxcom-rx** of lib
`xpl-perl <https://github.com/beanz/xpl-perl>`_ interfacing the **old usb rfxcom receiver**.
.. image:: rfxcom_usb_2.jpg
The **rfxbnz** plugin contains only the description of the xPL messages to catch and so **there is nothing to start/stop and nothing to configure**.
.. image:: Domogik_Plugin-rfxbnz_2.png
You just have to install the plugin, check it is present in the clients list and create some devices.
.. note::
You must see your **xpl-rfxcom-rx** clients in the clients list as **xPL clients**. If you don't see them, it means that the xPL hub doesn't see them and so the plugin won't be able to catch the xPL messages.
This "virtual" plugin (info.json only) can cath this message type:
* **sensor.basic** (Oregon / OWL sensor)
* **x10.basic** (X10 RF or old Chacon emitter)
* **homeeasy.basic** (Chacon / DIO RF emitter)
* **remote.basic** (ATI RF remote)
Example of xPL messages send by the bnz-rfxcom-rx program : ::
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } sensor.basic { device=thgr228n.de type=temp current=21.4 }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } sensor.basic { device=thgr228n.de type=humidity current=46 string=comfortable }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } sensor.basic { device=thgr228n.de type=battery current=90 units=% }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } x10.basic { command=on device=d1 }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } x10.basic { command=on device=m8 }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } x10.basic { command=off device=m8 }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } homeeasy.basic { address=0x94339a unit=1 command=on }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } homeeasy.basic { address=0x94339a unit=0 command=off }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } homeeasy.basic { address=0x94339a unit=2 command=on }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } remote.basic { keys=5 device=ATI_Remote }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } remote.basic { keys=6 device=ATI_Remote }
xpl-trig { hop=1 source=bnz-rfxcomrx.jdom target=* } remote.basic { keys=right device=ATI_Remote }
You can check if a xPL message is received on Domogik side by launching the **dmg_dump** tool.
Dependencies
============
There is no dependency.
Plugin configuration
====================
There is nothing to configure.
Create the domogik devices
==========================
Create device by device type
----------------------------
There is different sensors devices type:
* basic sensors: Temperature, Humidity, Luminosity ...
* x10 swith
* homeeasy switch
* ATI remote keys
.. image:: Domogik_Plugin-rfxbnz_3.png
One parameter are needed for a **basic sensor**, **x10 switch** and **remote** domogik device creation:
===================== =========================== ======================================================================
Key Type Description
===================== =========================== ======================================================================
device string xPL device parameter (Ex.:thgr228n.de , d3, ATI_Remote)
===================== =========================== ======================================================================
Two parameters are needed for a **homeeasy** domogik device creation:
===================== =========================== ======================================================================
Key Type Description
===================== =========================== ======================================================================
address string xPL device parameter (Ex.:0x94339a)
--------------------- --------------------------- ----------------------------------------------------------------------
unit string xPL device parameter (Ex.:2)
===================== =========================== ======================================================================
Some rfxbnz device created:
---------------------------
.. image:: Domogik_Plugin-rfxbnz_1.png
Set up your widgets on the user interface
=========================================
You can now place the widgets of your devices features on the user interface.