ansible4ozw 0.0.1

data/lib/ansible/knx/dpt/dpt6.rb

@@ -0,0 +1,73 @@
+=begin
+Project Ansible  - An extensible home automation scripting framework
+----------------------------------------------------
+Copyright (c) 2011 Elias Karakoulakis <elias.karakoulakis@gmail.com>
+
+SOFTWARE NOTICE AND LICENSE
+
+Project Ansible is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published
+by the Free Software Foundation, either version 3 of the License,
+or (at your option) any later version.
+
+Project Ansible is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with Project Ansible.  If not, see <http://www.gnu.org/licenses/>.
+
+for more information on the LGPL, see:
+http://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License
+=end
+
+#
+# DPT6.*: 8-bit signed value
+#
+
+module Ansible
+    
+    module KNX
+        
+        module DPT6
+            
+            # Bitstruct to parse a DPT6 frame. 
+            # Always 8-bit aligned.      
+            class DPT6_Frame < DPTFrame
+                int8 :data, :display_name => "Signed value -128..127"
+            end
+
+            # DPT Basetype info
+            Basetype = {
+                :bitlength => 8,
+                :valuetype => :basic,
+                :desc => "8-bit signed value",
+                :range => -128..127
+            }            
+            # DPT subtypes info
+            Subtypes = {
+                # 6.001 percentage (-128%..127%)
+                "001" => {
+                    :name => "DPT_Switch", :desc => "percent",
+                    :unit => "%",  
+                },
+                
+                # 6.002 counter pulses (-128..127)
+                "002" => {
+                    :name => "DPT_Bool", :desc => "counter pulses",
+                    :unit => "pulses"
+                },
+                # 
+            }
+            
+        end
+        
+    end
+    
+end
+=begin
+puts KNX_DPT6.bit_length
+puts KNX_DPT6.new([0x32].pack('c')).inspect # 50
+puts KNX_DPT6.new([0xce].pack('c')).inspect # -50
+=end

data/lib/ansible/knx/dpt/dpt7.rb

@@ -0,0 +1,146 @@
+=begin
+Project Ansible  - An extensible home automation scripting framework
+----------------------------------------------------
+Copyright (c) 2011 Elias Karakoulakis <elias.karakoulakis@gmail.com>
+
+SOFTWARE NOTICE AND LICENSE
+
+Project Ansible is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published
+by the Free Software Foundation, either version 3 of the License,
+or (at your option) any later version.
+
+Project Ansible is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with Project Ansible.  If not, see <http://www.gnu.org/licenses/>.
+
+for more information on the LGPL, see:
+http://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License
+=end
+
+#
+# DPT7.*: 2-byte unsigned value
+#
+
+module Ansible
+    
+    module KNX
+        
+        module DPT7
+            
+            # Bitstruct to parse a DPT7 frame. 
+            # Always 8-bit aligned.
+            class DPT7_Frame < DPTFrame
+                uint16 :data, :display_name => "Value"
+            end        
+            
+            # DPT basetype info
+            Basetype = {
+                :bitlength => 16,
+                :valuetype => :basic,
+                :desc => "16-bit unsigned value"
+            }
+            
+            # DPT subtypes info
+            Subtypes = {
+                # 7.001 pulses
+                "001" => { :use => "G",
+                    :name => "DPT_Value_2_Ucount", 
+                    :desc => "pulses", 
+                    :unit => "pulses"
+                },
+                
+                # 7.002 time(ms)               
+                "002" => { :use => "G",
+                    :name => "DPT_TimePeriodMsec", 
+                    :desc => "time (ms)",
+                    :unit => "milliseconds"
+                },
+                
+                # 7.003 time (10ms)
+                "003" => { :use => "G",
+                    :name => "DPT_TimePeriod10Msec", 
+                    :desc => "time (10ms)",
+                    :unit => "centiseconds"
+                },
+                
+                # 7.004 time (100ms)
+                "004" => { :use => "G",
+                    :name => "DPT_TimePeriod100Msec", 
+                    :desc => "time (100ms)",
+                    :unit => "deciseconds"
+                },
+                
+                # 7.005 time (sec)
+                "005" => { :use => "G",
+                    :name => "DPT_TimePeriodSec", 
+                    :desc => "time (s)",
+                    :unit => "seconds"
+                },
+                
+                # 7.006 time (min)
+                "006" => { :use => "G",
+                    :name => "DPT_TimePeriodMin", 
+                    :desc => "time (min)",
+                    :unit => "minutes"
+                },
+                
+                # 7.007 time  (hour)
+                "007" => { :use => "G",
+                    :name => "DPT_TimePeriodHrs", 
+                    :desc => "time (hrs)",
+                    :unit => "hours"
+                },
+                
+                # 7.010 DPT_PropDataType
+                # not to be used in runtime communications!
+                "010" => { :use => "FB",
+                    :name => "DPT_PropDataType",
+                    :desc => "Identifier Interface Object Property data type "
+                },
+                
+                # 7.011
+                "011" => { :use => "FB SAB",
+                    :name => "DPT_Length_mm",
+                    :desc => "Length in mm",
+                    :unit => "mm"
+                },
+                
+                # 7.012
+                "012" => { :use => "FB",
+                    :name => "DPT_UEICurrentmA",
+                    :desc => "bus power supply current (mA)",
+                    :unit => "mA"
+                },
+                
+                # 7.013
+                "013" => { :use => "FB",
+                    :name => "DPT_Brightness",
+                    :desc => "interior brightness",
+                    :unit => "lux"
+                }
+            }
+            
+        end
+
+    end
+    
+end
+
+
+=begin
+puts KNX_DPT2.bit_length
+puts KNX_DPT2.new([0x00].pack('c')).inspect #
+puts KNX_DPT2.new([0x01].pack('c')).inspect #
+puts KNX_DPT2.new([0x02].pack('c')).inspect #
+puts KNX_DPT2.new([0x03].pack('c')).inspect #
+
+puts [0x02].pack('c').inspect
+
+=begin
+
+=end

data/lib/ansible/knx/dpt/dpt8.rb

@@ -0,0 +1,118 @@
+# encoding: ISO-8859-1
+=begin
+Project Ansible  - An extensible home automation scripting framework
+----------------------------------------------------
+Copyright (c) 2011 Elias Karakoulakis <elias.karakoulakis@gmail.com>
+
+SOFTWARE NOTICE AND LICENSE
+
+Project Ansible is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published
+by the Free Software Foundation, either version 3 of the License,
+or (at your option) any later version.
+
+Project Ansible is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with Project Ansible.  If not, see <http://www.gnu.org/licenses/>.
+
+for more information on the LGPL, see:
+http://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License
+=end
+
+module Ansible
+    
+    module KNX
+
+        #
+        # DPT8.*: 2-byte signed value
+        #
+        module DPT8 
+        
+            # Bitstruct to parse a DPT8 frame. 
+            # Always 8-bit aligned.
+            class DPT8_Frame < DPTFrame
+                int16  :data, :display_name => "Value"
+            end
+
+            # DPT8 basetype info
+            Basetype = {
+                :bitlength => 16,
+                :valuetype => :basic,
+                :desc => "16-bit signed value"
+            }
+            
+            # DPT8 subtypes info
+            Subtypes = {
+                # 8.001 pulses difference
+                "001" => {
+                    :name => "DPT_Value_2_Count", 
+                    :desc => "pulses", 
+                    :unit => "pulses"
+                },
+                
+                # 8.002 time lag (ms)
+                "002" => {
+                    :name => "DPT_DeltaTimeMsec", 
+                    :desc => "time lag(ms)",
+                    :unit => "milliseconds"
+                },
+                
+                # 8.003 time lag (10ms)
+                "003" => {
+                    :name => "DPT_DeltaTime10Msec", 
+                    :desc => "time lag(10ms)",
+                    :unit => "centiseconds"
+                },
+                
+                # 8.004 time lag (100ms)
+                "004" => {
+                    :name => "DPT_DeltaTime100Msec", 
+                    :desc => "time lag(100ms)",
+                    :unit => "deciseconds"
+                },
+                
+                # 8.005 time lag (sec)
+                "005" => {
+                    :name => "DPT_DeltaTimeSec", 
+                    :desc => "time lag(s)",
+                    :unit => "seconds"
+                },
+                
+                # 8.006 time lag (min)
+                "006" => {
+                    :name => "DPT_DeltaTimeMin", 
+                    :desc => "time lag(min)",
+                    :unit => "minutes"
+                },
+                
+                # 8.007 time lag (hour)
+                "007" => {
+                    :name => "DPT_DeltaTimeHrs", 
+                    :desc => "time lag(hrs)",
+                    :unit => "hours"
+                },
+                
+                # 8.010 percentage difference (%)
+                "010" => {
+                    :name => "DPT_Percent_V16", 
+                    :desc => "percentage difference", 
+                    :unit => "%"
+                },
+
+                # 8.011 rotation angle (deg)
+                "011" => {
+                    :name => "DPT_RotationAngle", 
+                    :desc => "angle(degrees)",
+                    :unit => "°"
+                },
+            }
+            
+        end
+         
+    end
+    
+end

data/lib/ansible/knx/dpt/dpt9.rb

@@ -0,0 +1,204 @@
+# encoding: ISO-8859-1
+=begin
+Project Ansible  - An extensible home automation scripting framework
+----------------------------------------------------
+Copyright (c) 2011 Elias Karakoulakis <elias.karakoulakis@gmail.com>
+
+SOFTWARE NOTICE AND LICENSE
+
+Project Ansible is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published
+by the Free Software Foundation, either version 3 of the License,
+or (at your option) any later version.
+
+Project Ansible is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with Project Ansible.  If not, see <http://www.gnu.org/licenses/>.
+
+for more information on the LGPL, see:
+http://en.wikipedia.org/wiki/GNU_Lesser_General_Public_License
+=end
+
+module Ansible
+    
+    module KNX
+        
+        #
+        # DPT9.*: 2-byte floating point value
+        #        
+        module DPT9
+    
+            # special Bindata::Primitive class required 
+            # for non-standard 16-bit floats used by DPT9
+            class DPT9_Float < BinData::Primitive
+                endian :big
+                #
+                bit1 :sign,  :display_name =>  "Sign"
+                bit4 :exp,   :display_name => "Exponent"
+                bit11 :mant,   :display_name => "Mantissa"
+                #
+                def get
+                    # puts "sign=#{sign} exp=#{exp} mant=#{mant}"
+                    mantissa = (self.sign==1) ? ~(self.mant^2047) : self.mant
+                    return Math.ldexp((0.01*mantissa), self.exp)
+                end
+                #
+                DPT9_Range = -671088.64..670760.96
+                #
+                def set(v)
+                    raise "Value (#{v}) out of range" unless DPT9_Range === v
+                    mantissa, exponent = Math.frexp(v)
+                    #puts "#{self}.set(#{v}) with initial mantissa=#{mantissa}, exponent=#{exponent}"
+                    # find the minimum exponent that will upsize the normalized mantissa (0,5 to 1 range)
+                    # in order to fit in 11 bits (-2048..2047)
+                    max_mantissa = 0
+                    minimum_exp = exponent.downto(-15).find{ | e |
+                        max_mantissa = Math.ldexp(100*mantissa, e).to_i
+                        max_mantissa.between?(-2048, 2047)
+                    } 
+                    self.sign = (mantissa < 0) ?  1 :  0 
+                    self.mant  = (mantissa < 0) ?  ~(max_mantissa^2047) : max_mantissa 
+                    self.exp = exponent - minimum_exp  
+                end # set
+            end
+
+            # DPTFrame to parse a DPT9 frame. 
+            # Always 8-bit aligned.
+            class DPT9_Frame < DPTFrame
+                dpt9_float :data
+            end
+        
+            # DPT9 basetype info
+            Basetype = {
+                :bitlength => 16,
+                :valuetype => :basic,
+                :desc => "16-bit floating point value"
+            }
+            
+            # DPT9 subtypes
+            Subtypes = {    
+                # 9.001 temperature (oC)
+                "001" => {
+                    :name => "DPT_Value_Temp", :desc => "temperature", 
+                    :unit => "°C", :range => -273..670760
+                },
+                
+                # 9.002 temperature difference (oC)
+                "002" => {
+                    :name => "DPT_Value_Tempd", :desc => "temperature difference", 
+                    :unit => "°C", :range => -670760..670760
+                },
+
+                # 9.003 kelvin/hour (K/h)
+                "003" => {
+                    :name => "DPT_Value_Tempa", :desc => "kelvin/hour", 
+                    :unit => "°K/h", :range => -670760..670760
+                },
+
+                # 9.004 lux (Lux)
+                "004" => {
+                    :name => "DPT_Value_Lux", :desc => "lux", 
+                    :unit => " lux", :range => 0..670760
+                },
+                
+                # 9.005 speed (m/s)
+                "005" => {
+                    :name => "DPT_Value_Wsp", :desc => "wind speed", 
+                    :unit => "m/s", :range => 0..670760
+                },
+                
+                # 9.006 pressure (Pa)
+                "006" => {
+                    :name => "DPT_Value_Pres", :desc => "pressure", 
+                    :unit => "Pa", :range => 0..670760
+                },
+                
+                # 9.007 humidity (%)
+                "007" => {
+                    :name => "DPT_Value_Humidity", :desc => "humidity", 
+                    :unit => "%", :range => 0..670760
+                },
+                
+                # 9.008 parts/million (ppm)
+                "008" => {
+                    :name => "DPT_Value_AirQuality", :desc => "air quality", 
+                    :unit => "ppm", :range => 0..670760
+                },
+                
+                # 9.010 time (s)
+                "010" => {
+                    :name => "DPT_Value_Time1", :desc => "time(sec)", 
+                    :unit => "s", :range => -670760..670760
+                },
+                
+                # 9.011 time (ms)
+                "011" => {
+                    :name => "DPT_Value_Time2", :desc => "time(msec)", 
+                    :unit => "ms", :range => -670760..670760
+                },
+                
+                # 9.020 voltage (mV)
+                "020" => {
+                    :name => "DPT_Value_Volt", :desc => "voltage", 
+                    :unit => "mV", :range => -670760..670760
+                },
+                
+                # 9.021 current (mA)
+                "021"  => {
+                    :name => "DPT_Value_Curr", :desc => "current", 
+                    :unit => "mA", :range => -670760..670760
+                },
+                
+                # 9.022 power density (W/m2)
+                "022" => {
+                    :name => "DPT_PowerDensity", :desc => "power density", 
+                    :unit => "W/m²", :range => -670760..670760
+                },
+                
+                # 9.023 kelvin/percent (K/%)
+                "023" => {
+                    :name => "DPT_KelvinPerPercent", :desc => "Kelvin / %", 
+                    :unit => "K/%", :range => -670760..670760
+                },
+                
+                # 9.024 power (kW)
+                "024" => {
+                    :name => "DPT_Power", :desc => "power (kW)", 
+                    :unit => "kW", :range => -670760..670760
+                },
+                
+                # 9.025 volume flow (l/h)
+                "025" => {
+                    :name => "DPT_Value_Volume_Flow", :desc => "volume flow", 
+                    :unit => "l/h", :range => -670760..670760
+                },
+                
+                # 9.026 rain amount (l/m2)
+                "026" => {
+                    :name => "DPT_Rain_Amount", :desc => "rain amount", 
+                    :unit => "l/m²", :range => -670760..670760
+                },
+                
+                # 9.027 temperature (Fahrenheit)
+                "027" => {
+                    :name => "DPT_Value_Temp_F", :desc => "temperature (F)", 
+                    :unit => "°F", :range => -459.6..670760
+                },
+                
+                # 9.028 wind speed (km/h)
+                "028" => {
+                    :name => "DPT_Value_Wsp_kmh", :desc => "wind speed (km/h)", 
+                    :unit => "km/h", :range => 0..670760
+                },
+            }
+
+        end
+
+    end
+    
+end
+