obd 0.0.1

data/lib/obd.rb

@@ -0,0 +1,10 @@
+require "serialport"
+
+require_relative "obd/command"
+require_relative "obd/connection"
+
+module OBD
+  def self.connect *args
+    self::Connection.new(*args)
+  end
+end

data/lib/obd/command.rb

@@ -0,0 +1,73 @@
+module OBD
+  class Command
+
+    def initialize
+      
+    end
+
+    def self.format_result command, result
+      if is_command?(command) && result != "NO DATA"
+        pids[command.to_sym].call h(result)
+      else
+        result
+      end
+    end
+
+    def self.to_hex command
+      if is_command? command
+        "01%02x" % pids.keys.index(command.to_sym)
+      else
+        command
+      end
+    end
+
+    def self.is_command? command
+      pids.keys.include? command.to_sym
+    end
+
+    def self.pids
+      { 
+        pids_supported_1:                      lambda {|x| x.to_s(2).split('').each_with_index.map{|b,i| pids.keys[i] if b == '1'}},
+        monitor_status_since_clear:            lambda {|x| x.to_s},
+        freeze_dtc:                            lambda {|x| x.to_s},
+        fuel_system_status:                    lambda {|x| x.to_s},
+        calculated_engine_load:                lambda {|x| "%0.2f" % (x * 100.0 / 255.0) + '%'},
+        engine_coolent_temperature:            lambda {|x| "%0.2f" % (x * 1.8 - 104) + '*F'},
+        short_term_fuel_trim_bank_1:           lambda {|x| "%0.2f" % (x * 0.78125 - 100) + '%'},
+        long_term_fuel_trim_bank_1:            lambda {|x| "%0.2f" % (x * 0.78125 - 100) + '%'},
+        short_term_fuel_trim_bank_2:           lambda {|x| "%0.2f" % (x * 0.78125 - 100) + '%'},
+        long_term_fuel_trim_bank_2:            lambda {|x| "%0.2f" % (x * 0.78125 - 100) + '%'},
+        fuel_pressure:                         lambda {|x| "%0.2f" % (x * 3 * 0.145) + 'psi'},
+        intake_manifold_absolute_pressure:     lambda {|x| "%0.2f" % (x * 0.145) + 'psi'},
+        engine_rpm:                            lambda {|x| "%0.2f" % (x / 4.0) + 'rpm'},
+        vehicle_speed:                         lambda {|x| "%0.2f" % (x * 0.621371192) + 'mph'},
+        timing_advance:                        lambda {|x| "%0.2f" % (x / 2.0 - 64) + '*'},
+        intake_air_temperature:                lambda {|x| "%0.2f" % (x * 1.8 - 104) + '*F'},
+        maf_air_flow_rate:                     lambda {|x| "%0.2f" % (x / 100.0) + 'grams/sec'},
+        throttle_position:                     lambda {|x| "%0.2f" % (x * 100 / 255.0) + '%'},
+        commanded_secondary_air_status:        lambda {|x| x}, # bit encoded
+        oxygen_sensors_present:                lambda {|x| x}, # [A0..A3] == Bank 1,Sensors 1-4.[A4..A7]
+        bank_1_sensor_1_oxygen_sensor_voltage: lambda {|x| x},
+        bank_1_sensor_2_oxygen_sensor_voltage: lambda {|x| x},
+        bank_1_sensor_3_oxygen_sensor_voltage: lambda {|x| x},
+        bank_1_sensor_4_oxygen_sensor_voltage: lambda {|x| x},
+        bank_2_sensor_1_oxygen_sensor_voltage: lambda {|x| x},
+        bank_2_sensor_2_oxygen_sensor_voltage: lambda {|x| x},
+        bank_2_sensor_3_oxygen_sensor_voltage: lambda {|x| x},
+        bank_2_sensor_4_oxygen_sensor_voltage: lambda {|x| x},
+        obd_standards_vehicle_conforms_to:     lambda {|x| x}, # bit encoded
+        oxygen_sensors_present_2:              lambda {|x| x}, # complicated...
+        aux_input_status:                      lambda {|x| (x == 1).inspect}, # Power Take Off (PTO) status is active?
+        run_time_since_engine_start:           lambda {|x| x}, # seconds
+        pids_supported_2:                      lambda {|x| x.to_s(2).split('').each_with_index.map{|b,i| pids.keys[i+33] if b == '1'}}, # bit encoded
+        distance_traveled_with_mil_on:         lambda {|x| x.to_s + 'km'}
+      }
+    end
+
+    def self.h response
+      response[4..-1].to_i(16)
+    end
+
+
+  end
+end

data/lib/obd/connection.rb

@@ -0,0 +1,44 @@
+module OBD
+  class Connection
+    def initialize port, baud = 9600
+      @port = port
+      @baud = baud
+
+      connect
+    end
+    
+    def voltage
+      send("AT RV")
+    end
+    
+    def connect
+      @serial_port = SerialPort.new @port, @baud # , data_bits: 8, stop_bits: 1, parity: SerialPort::NONE
+      @serial_port.read_timeout = 5000
+      read
+      send("AT E0")    # turn echo off
+      send("AT L0")    # turn linefeeds off
+      send("AT S0")    # turn spaces off
+      send("AT AT2")   # respond to commands faster
+      send("AT SP 00") # automatically select protocol
+    end
+
+    def [] command
+      OBD::Command.format_result(command, send(OBD::Command.to_hex(command)))
+    end
+    
+    def send data
+      write data
+      read
+    end
+    
+    private
+
+    def read
+      return @serial_port.gets("\r\r>").to_s.chomp("\r\r>")
+    end
+    
+    def write data
+      @serial_port.write data.to_s + "\r"
+    end
+  end
+end

data/lib/obd/response.rb

@@ -0,0 +1,18 @@
+module OBD
+  class Response
+    attr_accessor :type
+    
+    def initialize _hex_response, last_command
+      @hex_response = _hex_response
+    end
+    
+    def to_s
+      value.to_s
+    end
+    
+    def value
+      @hex_response.[4..-1]
+    end
+      
+  end
+end

metadata

@@ -0,0 +1,60 @@
+--- !ruby/object:Gem::Specification
+name: obd
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Jeff Peterson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-16 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: serialport
+  requirement: &70153807947280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70153807947280
+description: A Ruby API that interfaces with ELM327 compatible devices over serial.
+email: jeff@petersonj.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.markdown
+- lib/obd.rb
+- lib/obd/command.rb
+- lib/obd/connection.rb
+- lib/obd/response.rb
+homepage: http://petersonj.com/obd
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.13
+signing_key: 
+specification_version: 3
+summary: A Ruby OBD-II API
+test_files: []