Changes between Version 6 and Version 7 of Proposal

Timestamp:

May 27, 2013, 12:46:01 PM (11 years ago)

Author:

Frédéric

Comment:

--

Proposal

@@ -17 +17 @@
 == Virtual Device ==
 
-This is a central feature of '''pKNyX''', allowing user to create virtual devices which mimics real KNX devices. They follow the same architecture, like having '''Datapoints''' (aka as Communication Objects), which have to be linked to '''Group Address''' to communicate.
+This will be the central feature of '''pKNyX''', allowing user to create virtual devices which mimics real KNX devices. They will follow the same architecture, like having '''Datapoints''' (aka as Communication Objects), which have to be linked to '''Group Address''' to communicate.
 
-Here is a very simple example:
+Here is a very simple example of what I have in mind: creating a virtual weather station, which uses informations from a non-KNX real weather-station, or even from a web site, like Weather Underground or so:
 
 {{{
@@ -25 +25 @@
 from pknyx.api import Device, ETS
 
-class Vent(Device):
-    DP_01 = ("temp_1", "9.001", "cwtu", "low", 0)
-    DP_02 = {'name': "temp_2", dptId: "9.001", 'flags': "cwtu", 'priority': "low", 'initValue': 0}
-    DP_03 = dict(name="temp_3", dptId="9.001", flags="cwtu", priority="low", initValue=0)
+# Weather station class definition
+class WeatherStation(Device):
 
-myVent = Vent("1.2.3")
-ETS.link(myVent, "temp_1", "1/1/1")
-ETS.link(myVent, "temp_2", "1/1/2")
-ETS.link(myVent, "temp_3", "1/1/3")
+    # Datapoints (= Communication objects) definition
+    DP_01 = dict(name="temperature", dptId="9.001", flags="crt", priority="low", initValue=0.)
+    DP_02 = dict(name="humidity", dptId="9.007", flags="crt", priority="low", initValue=0.)
+    DP_03 = dict(name="wind_speed", dptId="9.005", flags="crt", priority="low", initValue=0.)
+    DP_04 = dict(name="wind_alarm", dptId="1.005", flags="crt", priority="high", initValue=""No alarm")
+    DP_05 = dict(name="wind_limit", dptId="9.005", flags="cwtu", priority="low", initValue=15.)
+    DP_06 = dict(name="wind_alarm_enable", dptId="1.003", flags="cwtu", priority="low", initValue="Disable")
+
+# Instanciation of the weather station device object
+station = WeatherStation(name="weather", address="1.2.3")
+
+# Linking weather station Datapoints to Group Address
+ETS.link(device=station, dp="temperature", gad="1/1/1")
+ETS.link(device=station, dp="humidity", gad="1/1/2")
+ETS.link(device=station, dp="wind_speed", gad="1/1/3")
+ETS.link(device=station, dp="wind_alarm", gad="1/1/4")
+ETS.link(device=station, dp="wind_limit", gad="1/1/5")
+ETS.link(device=station, dp="wind_alarm_enable", gad="1/1/6")
+
 }}}
 
-That's it! 
+That's it! Ok, that device does not do much things...