alien 0.1.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZjlhN2ZjMjUyYzgxYzE4NzAyYjdjNDEwMWJlMmYyNzQ5NDYwZDQ2NQ==
+  data.tar.gz: !binary |-
+    Njc2NjNkMGJkOTBhNmQ2YzY0OTQ5ODk1NzMyYWI2NjY1OTk1NjFjOA==
+SHA512:
+  metadata.gz: !binary |-
+    MjViNGZmYTIwNzk1NTY0YzFhZDE0NGJiOGE5YWVmY2NhNmUyYTlmYmFjNDY3
+    ZjhjZDFlOGViNzYyNjdlMjMyMmY3Yjg4YTBhYzlkODMwZmVkZDVhZWEyM2Qx
+    NTAxYWVjYWRjZjJmYzAyZDIwMjNiOTU1NGEzNzQ2NjhlYWE0OGI=
+  data.tar.gz: !binary |-
+    MDM3NDg2MjIzMDI4MDRlMmQ5YjA5N2IyNDcyN2EyZGQxZDA1NjJkN2Y4NjQ0
+    MGFmYzExY2FkNDkwYmIzOTJhMjgxODU3YTA4OWRiMDgzOGM3ZDliZmRhNGZm
+    MDdmYmRkZTI5NzUyMjQ0NGJlZTNlMDNiZDA1NDgwNmQyOWJlZjk=

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in alien.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,29 @@
+Copyright (c) 2009, Alien Technology Corporation
+Copyright (c) 2014, Artur Rodrigues
+All rights reserved
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. All advertising materials mentioning features or use of this software
+   must display the following acknowledgement:
+   This product includes software developed by the <organization>.
+4. Neither the name of the <organization> nor the
+   names of its contributors may be used to endorse or promote products
+   derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL ALIEN TECHNOLOGY CORPORATION OR ITS CONTRIBUTORS
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,48 @@
+# Alien
+
+Interface to Alien Technology ARCA enabled readers, patched to be compatible with Ruby 1.9.3
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'alien'
+```
+
+And then execute:
+
+```bash
+$ bundle
+```
+
+Or install it yourself as:
+
+```bash
+$ gem install alien
+```
+
+## Usage
+
+Fetching the taglist
+
+```ruby
+require 'alien'
+
+r = Alien::AlienReader.new
+r.open('150.164.9.34')
+taglist_string = r.taglist
+lines = taglist_string.split "\r\n"
+tl = Array.new
+lines.each { |line| tl.push Alien::AlienTag.new(line) }
+puts tl
+r.close
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/alien/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/alien.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'alien/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "alien"
+  spec.version       = Alien::VERSION
+  spec.authors       = ["Artur Rodrigues"]
+  spec.email         = ["arturhoo@gmail.com"]
+  spec.summary       = %q{Interface to Alien Technology ARCA enabled readers.}
+  spec.description   = %q{Ruby interface to Alien Technology ARCA enabled readers.}
+  spec.homepage      = ""
+  spec.license       = "BSD"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+end

data/lib/alien.rb

@@ -0,0 +1,11 @@
+require "alien/version"
+require "alien/alienblocktimer"
+require "alien/alienconfig"
+require "alien/alienconnection"
+require "alien/alienreader"
+require "alien/alientag"
+require "alien/alientaglist"
+
+module Alien
+  # Your code goes here...
+end

data/lib/alien/alienblocktimer.rb

@@ -0,0 +1,113 @@
+=begin rdoc
+=Alien Ruby RFID Library
+==alienblocktimer.rb
+
+A tiny little class to help me time code blocks. Ruby has a 'profiler' library that is
+much more powerful, but I've found this handy for quick timing checks.
+
+Returns elapsed time for an operation and an optional description.
+
+
+Example 1):
+
+  You can just create the timer in place and use it.
+
+  puts AlienBlockTimer.new("Time for this block: "){
+    ... Some lengthy operation in the block ...
+  }
+
+  Results in:
+
+  Time for this block: 0.123
+
+
+Example 2):
+
+  Alternatively, create an instance and use it later.
+
+  t=AlienBlockTimer.new("")
+
+  puts t.measure("Time for this block: "){
+    ... Some lengthy operation in the block ...
+  }
+
+  ...or...
+
+  t.measure("Time for this other block: "){
+  ... Some lengthy operation in the block ...
+  }
+
+  puts t
+
+Example 3):
+
+  You can also use the class to make a series of elapsed time measurements.
+
+  puts "Starting measurment..."
+
+  t.start
+
+  (code here...)
+
+  puts "So far: #{t.elapsed}"
+
+  (more code...)
+
+  puts "Done!: #{t.elapsed}"
+
+
+
+Copyright 2007 Alien Technology Corporation. All rights reserved.
+=end
+
+#A class to measure the execution time for blocks of code.
+module Alien
+  class AlienBlockTimer
+
+
+    #Setup the timer and pass in an optional description. If there is an associated block with the
+    #call, execute a timing measurment.
+    def initialize (description="",&block)
+      @t1=Time.now
+      @measurement = "Timer initialized."
+      unless block.nil?
+        measure(description){yield}
+      end
+    end
+
+
+    #Measure the execution time for an asscociated code block.
+    def measure(description="", &block)
+
+      start
+
+      unless block.nil?
+        yield
+        @measurement =  description + elapsed.to_s
+      else
+        #Error message Haiku. :)
+        @measurement = "No block to measure. Your timer waits patiently. Give him one to use."
+      end
+
+    end
+
+    #Grab a start time
+    def start
+      @t1=Time.now
+    end
+
+    #The time since we called start or since the class was initialized.
+    def elapsed
+      Time.now - @t1
+    end
+
+    def inspect
+      @measurement
+    end
+
+    def to_s
+      @measurement
+    end
+
+  end
+end

data/lib/alien/alienconfig.rb

@@ -0,0 +1,69 @@
+=begin rdoc
+=Alien Ruby RFID Library
+==alienconfig.rb
+
+A class to load/save application configuration data in a simple text file.
+
+Minimal error handling.
+
+Configuration parameters are maintained as a hash.
+
+Copyright 2008, Alien Technology Corporation. All rights reserved.
+=end
+
+module Alien
+  class AlienConfig < Hash
+
+    def initialize(fn)
+      super(nil)
+      load(fn)
+    end
+
+    private
+  # Open a file and read out the configuration parameters. Save into a hash structure.
+  # Blank lines and comment lines, beginning with '#' are ignored.
+    def load(fn)
+      if File.file?(fn)
+        begin
+        File.open(fn).each do |line|
+        #peel off terminators/leading spaces, etc.
+          line.strip!
+
+        #ignore comment lines...
+          if (line[0..0]!="#")
+            keyval = line.split("=") # split on equal sign
+
+          #ignore blank lines
+            if keyval.size>0
+              key   = keyval[0].strip
+              value = keyval[1].strip
+              self[key] = value
+            end
+          end
+        end
+        rescue
+          raise "Error: trouble loading data from file: #{fn}.\nDetails: #{$!}"
+        end
+      else
+        raise "Error: cannot find configuration file: #{fn}.\nDetails: File not found."
+      end
+    end
+
+    #Save the hash data to a file.
+    def save(fn)
+      begin
+      File.open(fn,"w") do |file|
+        output = ""
+        self.each do |key, value|
+          output << key.to_s + "=" + value.to_s + "\r\n"
+        end
+
+        file.print output
+        file.close
+        end
+      rescue
+        raise "Error: trouble saving configuration file: #{fn}.\nDetails: #{$!}"
+      end
+    end
+  end
+end

data/lib/alien/alienconnection.rb

@@ -0,0 +1,186 @@
+=begin rdoc
+=Alien Ruby RFID Library
+==alienconnection.rb
+
+A simple class to handle the basics of socket communication with RFID readers from Alien Technology Corporation.
+
+Copyright 2008, Alien Technology Corporation. All rights reserved.
+=end
+
+require 'socket'
+require 'timeout'
+
+# Handles socket communication w/an Alien RFID Reader.
+module Alien
+  class AlienConnection
+
+    attr_accessor :raise_errors
+
+    def initialize
+      @connected = false
+      @raise_errors = true
+    end
+
+    # Returns the connected status of this AlienReader.
+    def connected
+      return @connected
+    end
+
+
+    # Read from the open socket until a null character is found.
+    # Strips off the trailing \r\n from the response
+    def receive(opts={})
+      timeout = opts.fetch(:timeout, 40).to_i
+      wait_for_null = opts.fetch(:wait_for_null, true)
+
+      s = ""
+
+      # Wait for data to become available on the socket
+      res = select([@sock], nil, nil, timeout)
+      if (res == nil)
+        raise "Timeout waiting for reader response." if @raise_errors
+      end
+
+      if (wait_for_null)
+        # Some readers don't put a null on the end of the 'call back later' message.
+        # Check for 'later' to know when to punt on the read.
+        begin
+          timeout(timeout) {
+            char = @sock.recv(1)
+            while (char != "\0")
+              s << char
+              char = @sock.recv(1)
+            end
+          }
+        rescue Timeout::Error
+          raise "Timeout waiting for reader response." if @raise_errors
+        end
+
+        s.strip!
+
+        if s.include? "Error"
+          raise s if @raise_errors
+        end
+
+        # If this is a response to a Quit command, the reader will close the socket.
+        # If there is an active connection, the reader will reject our attempt to connect.
+        # Either way, we're not connected anymore...
+        if (s.include? "Goodbye!")
+          close(false)
+        end
+
+        return s
+      else
+        # Simply try to read up to 1 kB and return it
+        return @sock.recv(1024)
+      end
+    end
+
+
+    # Send a message over an open socket (Alien terse msg format to suppress prompts on reply)
+    def send (msg="")
+      if @connected
+        @sock.write "\1#{msg}\r\n" # leading \1 for terse reply
+      end
+    end
+
+
+    # Send a message over an open socket and wait for a reply
+    def sendreceive(msg="", opts={})
+      timeout = opts.fetch(:timeout, 40)
+      wait_for_null = opts.fetch(:wait_for_null, true)
+
+      begin
+        if @connected
+          send(msg)
+          receive(:timeout=>timeout, :wait_for_null=>wait_for_null)
+        else
+          raise "Not connected to reader."
+        end
+      rescue
+        err = "Error in alienconnection:\nTried to send:\"#{msg}\"\nand got:\n\"" + String($!) +"\""
+        raise err
+      end
+    end
+
+
+    # Try to open a socket connection to the reader.
+    def connect(ipaddress='localhost', port=23)
+      @connected = false
+
+      #connect to a reader and grab the welcome message...
+      begin
+        timeout(3) {
+          @sock = TCPSocket.new(ipaddress, port)
+        }
+
+        s = receive() #Grab the welcome message
+        if s.include?("later.")  #Reader is busy. Please call back later.
+          raise "Trouble Connecting to #{ipaddress}. (Someone else is talking to the reader.)"
+        end
+        @connected = true
+      rescue RuntimeError
+        raise
+      rescue Timeout::Error, Errno::ETIMEDOUT
+        raise "Trouble Connecting to #{ipaddress}. (No reader at this IP?)"
+      rescue Errno::ECONNREFUSED
+        raise "Trouble Connecting to #{ipaddress}. (Connection refused.)"
+      end
+
+      return @connected
+    end
+
+
+    private
+    # Login to the reader on an open socket connection. Call connect first.
+    def login (username="alien", password="password")
+      if @connected
+        begin
+          @sock.write "#{username}\r\n"
+          receive()
+          @sock.write "#{password}\r\n"
+          s = receive()
+
+          if s.include? "Error:"
+            err_msg = s.scan(/(Error: )(.*)/).flatten[1]
+            close()
+            raise "Trouble logging in. " << err_msg
+            @connected = false
+          end
+        rescue
+          raise
+        end
+      end
+
+      return @connected
+    end
+
+    public
+    # Execute both the connect and login methods in one call.
+    def open(ipaddress="localhost", port=23, username="alien", password="password")
+      connect(ipaddress,port)
+
+      if @connected
+        login(username,password)
+      end
+
+      return @connected
+    end
+
+
+    # Close the socket.
+    def close(send_quit=true)
+      if @connected
+        if send_quit
+          @sock.write("quit\r\n")
+          sleep 1
+        end
+        @sock.close()
+      end
+
+      @connected = false
+      return true
+    end
+
+  end #class AlienConnection
+end

data/lib/alien/alienreader.rb

@@ -0,0 +1,169 @@
+=begin rdoc
+=Alien Ruby RFID Library
+==alienreader.rb
+
+AlienReader is a fairly lightweight class that inherits from AlienConnection. It provides methods that map attributes to reader functions like readername, readertype, etc, and exposes the execute method to send/receive an arbitrary command to the reader.
+
+This class uses a metaprogramming hack to dynamically build methods for many of the simple reader attributes from a file. This is a pretty flexible way to create the class and avoid lots of repetitive coding.
+
+
+Copyright 2008, Alien Technology Corporation. All rights reserved.
+=end
+
+require File.join(File.dirname(__FILE__), 'alienconnection')
+require File.join(File.dirname(__FILE__), 'alientaglist')
+
+module Alien
+  class AlienReader< AlienConnection
+    @@methods_needed = true
+
+    #call the AlienConnection initializer and build lots of the Getters/Setters from a reader methods file. Default value for the methods file will be the file, readermethods.txt found in the same directory as this file, alienreader.rb.
+    def initialize(methodsfile=File.join(File.dirname(__FILE__) , "readermethods.dat"))
+      super()
+      if @@methods_needed
+        build_methods(methodsfile)
+      end
+    end
+
+    #execute a sendreceive and pull off the 'y' payload for messages that
+    #return with an 'x = y' style reply
+  	private
+  	def execute (cmd)
+      s = sendreceive(cmd)
+      if s.include? '='
+        return s.split('=')[1].strip!
+      else
+        return s
+      end
+    end
+
+    def add_get(cmd)
+      method_name = cmd.to_sym
+      self.class.instance_eval {
+        send :define_method, method_name do |*val|
+          if val.nil? || val.to_s.size==0
+            execute("#{cmd}?")
+          else
+            puts "sending val"
+            execute("#{cmd} [#{val.join}]?")
+          end
+        end
+      }
+    end
+
+    def add_set(cmd)
+      method_name = (cmd+"=").to_sym
+      self.class.instance_eval {
+        send :define_method, method_name do |*val|
+          execute("#{cmd}=#{val.join}")
+        end
+      }
+    end
+
+    def add_do(cmd)
+      method_name = cmd.to_sym
+      self.class.instance_eval {
+        send :define_method, method_name do |*val|
+          if val.nil? || val.to_s.size==0
+          	sendreceive("#{cmd}")
+          else
+            sendreceive("#{cmd} #{val.join}")
+          end
+        end
+      }
+    end
+
+    def add_do_set(cmd)
+      method_name = cmd.to_sym
+      self.class.instance_eval {
+        send :define_method, method_name do |*val|
+          if val.nil? || val.to_s.size==0
+            execute("#{cmd}")
+          else
+            execute("#{cmd}=#{val.join}")
+          end
+        end
+      }
+    end
+
+    def add_getset(cmd)
+      add_get(cmd)
+      add_set(cmd)
+    end
+
+  #Build lots of the simple get/set methods supported by the class from a configuration file...
+  	private
+    def build_methods(fn)
+      #puts "building methods from: #{fn}"
+      #open the file and read out the methods to be supported
+      if File.file?(fn)
+        File.open(fn).each do |line|
+          #puts line
+          #ignore comment lines...
+          if (line[0..0]!="#")
+            dat = line.split
+
+            #ignore blank lines
+            if dat.size>0
+              method_name = dat[0].strip
+              use = dat[1].strip
+
+              #puts "Method: #{dat[0]} Use: #{dat[1]}"
+              case dat[1].downcase
+                when "getset"
+                  add_getset(dat[0])
+                when "get"
+                  add_get(dat[0])
+                when "set"
+                  add_set(dat[0])
+                when "do"
+                  add_do(dat[0])
+                when "doset"
+                  add_do_set(dat[0])
+              end
+            end
+          end
+        end
+        @@methods_needed = false
+      else
+        raise "Error: cannot find method definition file: #{fn}."
+      end
+    end
+
+  	public
+  # Makes the reader blink its LEDs.
+  #
+  # _blinkled_ is a more complicated function call than an attribute.
+  # We just put the method in here rather than try to generate it dynamically.
+    def blinkled (state1, state2, duration, count)
+      execute('blinkled=' + state1.to_s  + ' ' +  state2.to_s + ' ' + duration.to_s + ' ' +count.to_s)
+    end
+
+  # Returns the state of the reader's external inputs
+    def gpio
+      execute('externalinput?')
+    end
+
+  # Sets reader's external outputs
+    def gpio=(newvalue)
+      execute('externaloutput='+newvalue)
+    end
+
+  # Executes the Alien _UpgradeNow_ command. The _opts_ parameter correspondst to the standard
+  # values passed to the _UpgradeNow_ command. For example
+  #  rdr.upgradenow("force http://server.ip/firmware")
+  	def upgradenow(opts="")
+      sendreceive("upgradenow #{opts}", :timeout=>120)
+    end
+
+  # Implements the Alien _service_ command
+    def service(service_name ="all", command="status")
+      sendreceive("service #{service_name} #{command}")
+    end
+
+    def alien_tag_list
+      tl = AlienTagList.new(self.taglist)
+      return tl
+    end
+  end
+end

data/lib/alien/alientag.rb

@@ -0,0 +1,165 @@
+=begin rdoc
+=Alien Ruby RFID Library
+==alientag.rb
+
+A simple class to hold taglist data elements. Allows construction of Tag objects from taglist entries. (The format of strings handled by the 'create' method is assumed to be compatible with Alien's 'text' taglist format.)
+
+Copyright 2007, Alien Technology Corporation. All rights reserved.
+=end
+
+require 'date'
+
+module Alien
+  # A storage class for RFID tag data elements.
+  class AlienTag
+
+    #By mixing in Comparable we can easily sort arrays of tags.
+    include Comparable
+
+    attr_accessor :id    # EPC code of the tag that was read
+    attr_accessor :ant   # Antenna on which the last read was made
+    attr_accessor :count # Number of times the tag has been read since discovery
+    attr_accessor :disc  # Time of discovery
+    attr_accessor :last  # Time of latest read
+    attr_accessor :proto # Protocol used to read the tag. A bit map where Gen2 = 16.
+
+    attr_accessor :rssi
+    attr_accessor :speed
+    attr_accessor :freq  #:nodoc:
+
+  # Populate the instance variables from a taglist entry string.
+  # The following field separators are supported in the taglist entry string:
+  #  'tag:', 'disc:', 'last:', 'count:', 'ant:', 'proto:', 'speed:', 'rssi:'
+    def initialize(taglist_entry)
+      @disc = @last  = @last_last = 0
+      @ant  = @count = @proto = @rssi = @speed = @freq = 0
+      @speed_smooth  = @speed_last = 0
+      @pos_smooth    = @pos_last = @pos_min = 0
+
+      create(taglist_entry)
+    end
+
+  # (*Deprecated*) Returns tag *id*.
+  #
+  # This method is for backward compatibility with an earlier version of this API.
+  # Use _id_ instead.
+    def tag
+      @id
+    end
+
+  # (*Deprecated*) Sets tag *id*.
+  #
+  # This method is for backward compatibility with an earlier version of this API.
+  # Use <i>id=</i> instead.
+    def tag=(val)
+      @id = val
+    end
+
+  # Return the contents of the tag object as a string (returns tag *id* as a string)
+    def inspect
+      @id.to_s
+    end
+
+  # The 'spaceship' operator allows us to compare tags for sorting, etc.
+    def <=>(s)
+      @id <=> s.id
+    end
+
+  # Returns a printable version of the tag object (returns tag *id* as a string)
+    def to_s
+      @id.to_s
+    end
+
+  # Try to parse a taglist entry into a set of Tag object variables.
+  #
+  # Uses a simple mapping from Alien 'text' format:
+  #
+  #  Tag:0102 0304 0506 0708 0900 0A0B, Disc:2008/10/28 10:49:35, Last:2008/10/28 10:49:35, Count:1, Ant:3, Proto:2
+  #
+  # *rssi* and *speed* attributes are not included in the default text format.
+  # In order to have them parsed correctly the _TagListFormat_ must be set to _custom_ and
+  # the _TagListCustomFormat_ fields must be separated by the following text tokens:
+  #
+  #  'tag:', 'disc:', 'last:', 'count:', 'ant:', 'proto:', 'speed:', 'rssi:'
+  #
+  # For example:
+  #
+  #  @rdr.taglistcustomformat("Tag:%i, Disc:${DATE1} ${TIME1}, Last:${DATE2} ${TIME2}, Count:${COUNT}, Ant:${TX}, Proto:${PROTO#}, Speed:${SPEED}, rssi:${RSSI})"
+  #  @rdr.taglistformat("custom")
+    def create(taglist_entry)
+      @id = ""
+      return self if (taglist_entry=="(No Tags)")
+
+      tagline = taglist_entry.split("\r\n")[0]
+      tagbits = Hash.new("0")
+
+      tagline.split(", ").each do |keyval|
+        key, val = keyval.split(":", 2)
+        if key.nil?
+          raise "Trouble parsing taglist string. Text format expected. This string was: #{taglist_entry}"
+        end
+        tagbits[key.downcase] = val
+      end
+
+      if (!tagbits.empty?)
+        #zero length ids can cause funny behavior
+        if tagbits['tag'] != nil
+          @id = tagbits['tag']
+        end
+
+        @ant       = tagbits['ant']
+        @count     = tagbits['count']
+        @disc      = tagbits['disc']
+        @last      = DateTime.parse(tagbits['last'])
+        @last_last = @last
+        @proto     = tagbits['proto']
+        @rssi      = tagbits['rssi']
+        @freq      = tagbits['freq']
+        @speed     = tagbits['speed']
+      end
+      return self
+    end
+
+  # Updates an existing tag object from the new one by incrementing the *count* and setting the new *last* time
+    def update(new_tag)
+      # Copy the last timestamp and increment the counts
+      @last      = new_tag.last
+      @count    += new_tag.count
+      @last_last = @last
+=begin
+    # Update the speed, smooth it, calculate distance
+    dt = (@last - @last_last) * 86400.0
+    smooth_coef   = 5
+    smooth_factor = Math.exp(-smooth_coef*dt)
+    thresh_zero1  = -0.01 # Any speeds between these thresholds are considered 0
+    thresh_zero2  = +0.01
+    puts
+    #printf("\ndt=%0.000010f, smooth_factor(init)=%0.00005f\n", dt, smooth_factor)
+
+    # Update the speed, smooth out jitter
+    @speed = new_tag.speed
+    if @speed.to_f > thresh_zero1 && @speed.to_f < thresh_zero2
+    # @speed = 0
+    end
+
+    #printf("speed_smooth(initial)=%+0.003f\n", @speed_smooth)
+    @speed_smooth = @speed_smooth*smooth_factor + @speed.to_f*(1 - smooth_factor)
+    @pos_last     = @pos_smooth
+    @pos_smooth  += @speed_last * dt/1000
+    @speed_last   = @speed_smooth
+
+    printf("speed=%+0.003f", @speed.to_s)
+    printf(", speed_smooth=%+0.003f", @speed_smooth.to_s)
+    printf(", pos=%+0.005f\n", @pos_smooth.to_s)
+
+    # Update new pos_min, if needed
+    @pos_min = @pos_smooth if (@pos_smooth < @pos_min)
+    printf("pos_last=%+0.5f, pos_min=%0.5f\n", @pos_last.to_s, @pos_min.to_s)
+    # If last position was the min and tag is moving away --> TopDeadCenter
+    if @pos_last == @pos_min && @pos_smooth > @pos_last
+      puts "********************************************"
+    end
+=end
+    end
+  end
+end

data/lib/alien/alientaglist.rb

@@ -0,0 +1,65 @@
+=begin rdoc
+=Alien Ruby RFID Library
+==alientaglist.rb
+
+A simple class to hold an array of taglist data elements.
+
+(The format of strings handled by the build_tag method is assumed to be compatible with Alien's 'text' taglist format.)
+
+Copyright 2008, Alien Technology Corporation. All rights reserved.
+=end
+
+#Takes a string returned from a Taglist function call and builds an array of tags.
+
+module Alien
+  class AlienTagList < Array
+
+    def initialize(taglist_string="")
+      super()
+      string_to_taglist(taglist_string) if taglist_string != ""
+    end
+
+
+    # Takes a taglist string from a reader and appends it to the array.
+    def string_to_taglist(taglist_string)
+      lines = taglist_string.split("\r\n")
+
+      lines.each do |line|
+        if line != "(No Tags)"
+          add_tag(AlienTag.new(line))
+        end
+      end
+
+      return self
+    end
+
+    # Adds an AlienTag to the list.
+    def add_tag(t)
+      self.push(t)
+      return self
+    end
+
+    # A little regular expression scanner. Looks at the list of tags and returns a
+    # new taglist containing those tag IDs that match a regular expression filter.
+    def filter(filter)
+      tl = AlienTagList.new
+
+      self.each do |ele|
+        if ele.tag =~ filter
+          tl.add_tag(ele)
+        end
+      end
+
+      return tl
+    end
+
+    # A self-modifying version of filter_taglist.
+    # Excercise caution. Elements in the taglist array that do not match
+    # the regular expression are deleted.
+    def filter!(filter)
+      self.delete_if { |ele| !(ele.tag =~ filter)}
+      return self
+    end
+
+  end #class AlienTagList
+end

data/lib/alien/readermethods.dat

@@ -0,0 +1,204 @@
+#**************************************************************
+#general commands
+#**************************************************************
+function getset
+readername getset
+readertype get
+readerversion get
+dspversion get
+readernumber getset
+baudrate getset
+uptime get
+username getset
+maxantenna get
+antennasequence getset
+antennastatus get
+rfattenuation getset
+rflevel getset
+rfmodulation getset
+reboot do
+factorysettings do
+info get
+save do
+quit do
+mydata getset
+
+#**************************************************************
+#network commands
+#**************************************************************
+macaddress get
+dhcp getset
+dhcptimeout getset
+ipaddress getset
+hostname getset
+upgradeaddress getset
+networkupgrade getset
+gateway getset
+netmask getset
+dns getset
+networktimeout getset
+commandport getset
+commandportlocal getset
+heartbeataddress getset
+heartbeatport getset
+heartbeattime getset
+heartbeatcount getset
+heartbeatnow do
+wwwport getset
+acceptconnections getset
+ping do
+
+#**************************************************************
+#time commands
+#**************************************************************
+timeserver getset
+time getset
+timezone getset
+
+#**************************************************************
+#taglist commands
+#**************************************************************
+persisttime getset
+taglistformat getset
+taglistantennacombine getset
+taglistcustomformat getset
+taglistmillis getset
+streamheader getset
+tagstreammode getset
+tagstreamaddress getset
+tagstreamkeepalivetime getset
+tagstreamformat getset
+tagstreamcustomformat getset
+t do
+taglist get
+acquire do
+tag get
+clear do
+
+#**************************************************************
+#acquire commands
+#**************************************************************
+acquiremode getset
+tagtype getset
+acqmask getset
+acqg2cycles getset
+acqg2count getset
+acqg2q getset
+acqg2qmax getset
+acqg2select getset
+acqg2session getset
+acqg2mask getset
+acqg2maskaction getset
+acqg2accesspwd getset
+acqg2tagdata getset
+acqg2target getset
+speedfilter getset
+rssifilter getset
+
+#**************************************************************
+#i/o commands
+#**************************************************************
+externalinput getset
+externaloutput getset
+invertexternalinput getset
+invertexternaloutput getset
+initexternaloutput getset
+iotype getset
+iolistformat getset
+iolistcustomformat getset
+iostreammode getset
+iostreamaddress getset
+iostreamkeepalivetime getset
+iostreamformat getset
+iostreamcustomformat getset
+
+#*************************************************************
+#automode commands
+#**************************************************************
+automode getset
+autowaitoutput getset
+autoworkoutput getset
+autotrueoutput getset
+autofalseoutput getset
+autostarttrigger getset
+autostoptrigger getset
+autostoptimer getset
+autostartpause getset
+autostoppause getset
+autotruepause getset
+autofalsepause getset
+autoaction getset
+automodetriggernow do
+automodereset do
+
+#**************************************************************
+#notify commands
+#**************************************************************
+notifyformat getset
+notifyheader getset
+notifyaddress getset
+notifytime getset
+notifytrigger getset
+notifykeepalivetime getset
+mailserver getset
+mailfrom getset
+notifymode getset
+notifyretrycount getset
+notifyretrypause getset
+notifyqueuelimit getset
+notifyinclude getset
+notifynow do
+
+#**************************************************************
+#program commands
+#**************************************************************
+progdataunit getset
+progprotocol getset
+progantenna getset
+progepcdata getset
+progepcdatainc getset
+progg2killpwd getset
+progg2accesspwd getset
+proguserdata getset
+proguserdatainc getset
+progg2locktype getset
+progattempts getset
+progsuccessformat getset
+progalienimagemap getset
+progalienimagensi getset
+
+programepc doset
+programuser doset
+programaccesspwd doset
+programkillpwd doset
+programandlockepc doset
+programandlockuser doset
+programalienimage doset
+
+erase do
+g2write doset
+g2read doset
+g2erase doset
+
+lockepc doset
+lockuser doset
+lockkillpwd doset
+lockaccesspwd doset
+unlockepc doset
+unlockuser doset
+unlockkillpwd doset
+unlockaccesspwd doset
+
+lockuserblocks doset
+hidealienuserblocks doset
+
+#**************************************************************
+#experimental commands
+#**************************************************************
+automodetype getset
+autoseektimer getset
+autoseekpause getset
+autoseekrflevel getset
+lbt getset
+lbtlimit getset
+lbtvalue get

data/lib/alien/version.rb

@@ -0,0 +1,3 @@
+module Alien
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: alien
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Artur Rodrigues
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby interface to Alien Technology ARCA enabled readers.
+email:
+- arturhoo@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- alien.gemspec
+- lib/alien.rb
+- lib/alien/alienblocktimer.rb
+- lib/alien/alienconfig.rb
+- lib/alien/alienconnection.rb
+- lib/alien/alienreader.rb
+- lib/alien/alientag.rb
+- lib/alien/alientaglist.rb
+- lib/alien/readermethods.dat
+- lib/alien/version.rb
+homepage: ''
+licenses:
+- BSD
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.1
+signing_key: 
+specification_version: 4
+summary: Interface to Alien Technology ARCA enabled readers.
+test_files: []
+has_rdoc: