ruby-xbee 1.1.0

data/bin/apicontrol.rb

@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+$: << File.dirname(__FILE__)
+
+require 'date'
+require 'ruby-xbee'
+require 'pp'
+
+@xbee = XBee::BaseAPIModeInterface.new(@xbee_usbdev_str)
+
+puts "Testing API now ..."
+puts "====================================================="
+puts "Association Indication: 0x%02x" % @xbee.association_indication
+puts "-----------------------------------------------------"
+puts "Firmware Rev: 0x%04x" % @xbee.fw_rev
+puts "-----------------------------------------------------"
+puts "Hardware Rev: 0x%04x" % @xbee.hw_rev
+puts "-----------------------------------------------------"
+puts "Serial Number High: 0x%08x" % @xbee.serial_num_high
+puts "Serial Number Low: 0x%08x" % @xbee.serial_num_low
+puts "Serial Number: 0x%016x" % @xbee.serial_num
+puts "-----------------------------------------------------"
+puts "Detecting neighbors ..."
+response = @xbee.neighbors
+response.each do |r|
+  puts "----------------------"
+  r.each do |key, val|
+    puts case key
+      when :NI 
+        "#{key} = '#{val}'"
+      when :STATUS, :DEVICE_TYPE 
+        "#{key} = 0x%02x" % val
+      when :SH, :SL 
+        "#{key} = 0x%08x" % val
+      else "#{key} = 0x%04x" % val
+    end
+  end
+end

data/bin/apilisten.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+$: << File.dirname(__FILE__)
+
+require 'date'
+require 'ruby-xbee'
+require 'pp'
+
+@uart_config = XBee::Config::XBeeUARTConfig.new()
+@xbee = XBee::BaseAPIModeInterface.new(@xbee_usbdev_str, @uart_config, 'API')
+
+# read XBee output forever
+while 1
+  @xbee.getresponse true
+end

data/bin/ruby-xbee.rb

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+begin
+  require 'rubygems'
+  gem 'ruby-xbee'
+rescue LoadError => e
+  load_path_addition = File.dirname(File.dirname(__FILE__)) + "/lib"
+  puts "Falling back to extended load path #{load_path_addition}"
+  $: << load_path_addition
+  require 'ruby_xbee'
+end
+
+@xbee_usbdev_str = case ARGV[0]
+  when "cable" 
+    "/dev/tty.usbserial-A101KYF6"
+  else
+    "/dev/tty.usbserial-A101KYF6"
+end
+
+# default baud - this can be overridden on the command line
+@xbee_baud = 9600
+
+# serial framing
+@data_bits = 8
+@stop_bits = 1
+@parity = 0
+
+puts File.dirname(File.dirname(__FILE__)) + "/lib"

data/bin/xbeeconfigure.rb

@@ -0,0 +1,263 @@
+#!/usr/bin/env ruby
+#
+# == Synopsis
+# xbeeconfigure.rb - A utility for configuring an XBee using Ruby and the Ruby::XBee class
+#
+# :title: xbeeconfigure.rb A utility for configuring an XBee using Ruby and the Ruby::XBee class
+#
+# == Usage
+# === Syntax
+#   ./xbeeconfigure.rb [options]
+#
+# Command line help
+#
+#   ./xbeeconfigure.rb --help
+#    xbeeconfigure.rb [options]
+#    Options:
+#       [--panid new_pan_id] [-p new_pan_id]      sets the XBee PAN ID
+#       [--channel new_channel] [-c new_channel]  sets the new channel number for XBee RF
+#       [--mysrc new_address] [-M new_address]    sets MY 16-bit source address (0-0xffff)
+#       [--nodeid new_node_id] [-n new_node_id]   sets the text for the XBee node ID
+#       [--desthigh highaaddress] [-H highaddress] sets the high portion of the destination address
+#       [--destlow low_address] [-L low_address]  sets the low portion of the destination address
+#       [--parity [NEOMS]] [-P [NEOMS]]           sets new parity, N = 8bit no-parity, E = 8bit even, O = 8bit odd, M = 8bit mark, S = 8bit space
+#       [--newbaud baud_rate] [-B baud_rate]      sets a new baud rate in XBee to take effect after configuration is complete
+#       [--dev device] [-d device]                use this device to talk to XBee (ie: /dev/tty.usb-791jdas)
+#       [--baud baud_rate] [-b baud_rate]         use this baud rate for configuring the device
+#       [--save] [-s]                             write new configuration to XBee flash when finished; default is: configuration is not flashed
+#       [--help] print this command help message
+#
+#
+# Example usage
+#  ./xbeeconfigure.rb --nodeid BaseStation --panid 01 --mysrc 01 -H0 -L 2 -s
+#
+# The command above configures an XBee with a human readable node ID of "BaseStation", a PAN ID of 1, sets the device's MY 16-bit source
+# address to 1, sets the destination to point to an XBee in a 16-bit addressing mode with a low address of 2 (-L 2) and a high of 0
+# which determines this is a 16-bit address.)  Finally, the -s causes the new configuration to be saved in XBee flash when
+# the configuration is completed.  The "BaseStation" node id is reported as one of the attributes from neighboring nodes.
+#
+# Since there are both long and short versions of the same options, an equivalent, shorter command line is:
+#   ./xbeeconfigure.rb -n BaseStation -M 01 -M 01 -H0 -L 2 -s
+#
+# See conf/xbeeconfig.rb for configuration defaults
+#
+# this code is designed for the following XBee modules:
+# IEEE® 802.15.4 OEM RF Modules by Digi International
+# Series 1 XBee and XBee Pro modules
+#
+# == Copyright
+# Copyright (C) 2008-2009 360VL, Inc. and Landon Cox
+#
+# == License
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program 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 Affero General Public License version 3 for more details.
+#
+# You should have received a copy of the GNU Affero General Public License along with this program.
+# If not, see http://www.gnu.org/licenses/
+#
+# == See Also
+# xbeeinfo.rb, xbeeconfigure.rb, xbeedio.rb, xbeelisten.rb, xbeesend.rb
+#
+# == Learn More
+#
+# You can learn more about Ruby::XBee and other projects at http://sawdust.see-do.org
+#
+# see Digi product manual: "Product Manual v1.xCx - 802.15.4 Protocol"
+# for details on the operation of XBee series 1 modules.
+
+$: << File.dirname(__FILE__)
+
+require 'date'
+require 'getoptlong'
+
+require 'ruby-xbee'
+
+@xbee_config_version = "xbeeconfig 1.0"
+
+=begin rdoc
+  dump usage info to the console
+=end
+def dump_help
+
+  puts "xbeeconfigure.rb [options]"
+  puts "Options:"
+  puts "   [--panid new_pan_id] [-p new_pan_id]      sets the XBee PAN ID"                               # set panid
+  puts "   [--channel new_channel] [-c new_channel]  sets the new channel number for XBee RF"            # set channel
+  puts "   [--mysrc new_address] [-M new_address]    sets MY 16-bit source address (0-0xffff)"
+  puts "   [--nodeid new_node_id] [-n new_node_id]   sets the text for the XBee node ID"                 # set nodeid
+  puts "   [--desthigh highaddress] [-H highaddress] sets the high portion of the destination address"   # set destination high address
+  puts "   [--destlow low_address] [-L low_address]  sets the low portion of the destination address"    # set destination low address
+  puts "   [--parity [NEOMS]] [-P [NEOMS]]           sets new parity, N = 8bit no-parity, E = 8bit even, O = 8bit odd, M = 8bit mark, S = 8bit space"
+  puts "   [--newbaud baud_rate] [-B baud_rate]      sets a new baud rate in XBee to take effect after configuration is complete"
+
+  puts "   [--dev device] [-d device]                use this device to talk to XBee (ie: /dev/tty.usb-791jdas)"
+  puts "   [--baud baud_rate] [-b baud_rate]         use this baud rate for configuring the device"     # override baud
+  puts "   [--save] [-s]                             write new configuration to XBee flash when finished; default is: configuration is not flashed"
+  puts "   [--help] print this command help message"
+
+  puts "\nSee conf/xbeeconfig.rb for defaults and edit conf/xbeeconfig.rb to change the defaults used to communicate with the device"
+  puts "\nCopyright (C) 2008-2009 360VL, Inc and Landon Cox"
+  puts "\nThis program comes with ABSOLUTELY NO WARRANTY;"
+  puts "This is free software, and you are welcome to redistribute it"
+  puts "under certain conditions detailed in: GNU Affero General Public License version 3"
+
+end
+
+=begin rdoc
+  configure the command line parameters to accept
+=end
+def setup_cli_options
+
+  @options = GetoptLong.new()
+  @options.quiet = true
+
+  @options_array = Array.new
+
+  @options_array << [ "--panid", "-p", GetoptLong::REQUIRED_ARGUMENT ]    # set panid
+  @options_array << [ "--nodeid", "-n", GetoptLong::REQUIRED_ARGUMENT ]   # set nodeid
+  @options_array << [ "--desthigh", "-H", GetoptLong::REQUIRED_ARGUMENT ] # set destination high address
+  @options_array << [ "--destlow", "-L", GetoptLong::REQUIRED_ARGUMENT ]  # set destination low address
+  @options_array << [ "--channel", "-c", GetoptLong::REQUIRED_ARGUMENT ]  # set channel
+  @options_array << [ "--parity", "-P", GetoptLong::REQUIRED_ARGUMENT ]   # set parity
+  @options_array << [ "--newbaud", "-B", GetoptLong::REQUIRED_ARGUMENT ]  # set new baud rate in XBee, will not take effect until exiting command mode or AT command mode timeout
+  @options_array << [ "--mysrc", "-M", GetoptLong::REQUIRED_ARGUMENT ]    # set nodeid
+
+  @options_array << [ "--dev", "-d", GetoptLong::REQUIRED_ARGUMENT ]      # override serial /dev string
+  @options_array << [ "--baud", "-b", GetoptLong::REQUIRED_ARGUMENT ]     # use this baud to configure device
+  @options_array << [ "--save", "-s", GetoptLong::NO_ARGUMENT ]           # write new configuration to XBee flash when finished
+  @options_array << [ "--help", "-h", GetoptLong::NO_ARGUMENT ]           # help message
+  @options_array << [ "--version", "-v", GetoptLong::NO_ARGUMENT ]        # get version of xbeeconfig.rb
+
+  @options.set_options( *@options_array )
+end
+
+=begin rdoc
+  process the command line interface options and set the appropriate variables with the cli data
+=end
+def process_cli_options
+
+  @options.each do | opt, arg |
+
+      case opt
+
+      when "--panid"
+        @panid = arg
+
+      when "--nodeid"
+        @nodeid = arg
+
+      when "--mysrc"
+        @mysrc = arg
+
+      when "--dev"
+        @xbee_usbdev_str = arg
+
+      when "--baud"
+        @xbee_baud = arg
+
+      when "--newbaud"
+        @new_baud_rate = arg
+
+      when "--desthigh"
+        @dest_high = arg
+
+      when "--destlow"
+        @dest_low = arg
+
+      when "--channel"
+        @channel = arg
+
+      when "--parity"
+        @newparity = arg
+
+      when "--help"
+        dump_help
+        exit 0
+
+      when "--version"
+        puts @xbeeconfig_version
+        exit 0
+
+      when "--save"
+        @save = true
+
+      end # case
+  end # options
+end
+
+=begin rdoc
+  after the cli options have been processed, the configuration is executed
+=end
+def execute_configuration
+  # start the configuration
+
+  @xbee = XBee.new( @xbee_usbdev_str, @xbee_baud, @data_bits, @stop_bits, @parity )
+
+  # before doing anything else, put XBee into AT command mode
+
+  puts "Attention..."
+  if !@xbee.attention.match("OK")
+     puts "Can't talk to XBee.  Please check your connection or configuration: #{res}"
+     exit 1
+  end
+
+  # execute configuration
+
+  if @panid
+    puts "Setting PAN ID"
+    @xbee.pan_id!(@panid)
+    puts "PAN id: #{@xbee.pan_id}"
+  end
+
+  if @mysrc
+    puts "Setting MY 16-bit source address"
+    @xbee.my_src_address!( @mysrc.upcase )
+  end
+
+  if @nodeid
+    puts "Setting Node ID"
+    @xbee.node_id!(@nodeid)
+  end
+
+  if @dest_high && @dest_low
+    puts "Setting destination address"
+    @xbee.destination_high!(@dest_high)
+    @xbee.destination_low!(@dest_low)
+  end
+
+  if @channel
+    puts "Setting channel"
+    @xbee.channel!(@channel)
+    puts "Channel: #{@xbee.channel}"
+  end
+
+  if @new_baud_rate
+    puts "Setting new baud rate"
+    @xbee.baud!(new_baud_rate)
+  end
+
+  if @newparity
+    puts "Setting new parity"
+    @xbee.parity!( @newparity.upcase.to_sym )
+  end
+
+  if @save
+    puts "Saving configuration to XBee flash"
+    @xbee.save!
+  end
+
+  puts "Exiting AT command mode"
+  @xbee.exit_command_mode
+
+end
+
+setup_cli_options
+process_cli_options
+execute_configuration
+

data/bin/xbeedio.rb

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+# == Synopsis
+# xbeedio.rb - A Ruby utility for reading DIO port configuration and sample data
+#
+# :title:  A Ruby utility for configuring and manipulating XBee DIO ports
+# == Usage
+#  xbeedio.rb
+#
+# See conf/xbeeconfig.rb for configuration defaults
+#
+# Example output from xbeedio.rb
+#   $ ./xbeedio.rb
+#    Attention: OK
+#    Port 0: Disabled
+#    Port 1: DI
+#    Port 2: Disabled
+#    Port 3: Disabled
+#    Port 4: Disabled
+#    Port 5: Associated_Indicator
+#    Port 6: Disabled
+#    Port 7: CTS
+#    Port 8: Disabled
+#    DIO inputs:
+#    Number of Samples: 1
+#    Channel mask: 002
+#    DIO data: 002
+#
+# this code is designed for the following XBee modules:
+# IEEE® 802.15.4 OEM RF Modules by Digi International
+# Series 1 XBee and XBee Pro modules
+#
+# == Copyright
+#
+# Copyright (C) 2008-2009 360VL, Inc. and Landon Cox
+#
+# == License
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program 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 Affero General Public License version 3 for more details.
+#
+# You should have received a copy of the GNU Affero General Public License along with this program.
+# If not, see http://www.gnu.org/licenses/
+#
+# == See Also
+# xbeeinfo.rb, xbeeconfigure.rb, xbeedio.rb, xbeelisten.rb, xbeesend.rb
+
+# == Learn More
+# You can learn more about Ruby::XBee and other projects at http://sawdust.see-do.org
+#
+# see Digi product manual: "Product Manual v1.xCx - 802.15.4 Protocol"
+# for details on the operation of XBee series 1 modules.
+
+$: << File.dirname(__FILE__)
+
+require 'date'
+require 'ruby-xbee'
+require 'pp'
+
+@xbee = XBee.new( @xbee_usbdev_str, @xbee_baud, @data_bits, @stop_bits, @parity )
+
+puts "Attention: #{@xbee.attention}"
+
+0.upto(8) do | num |
+  portsym = "D#{num}".to_sym
+  puts "Port #{num}: #{@xbee.dio( portsym )}"
+end
+
+puts "DIO inputs:"
+results = @xbee.io_input
+if ( !results.nil? && results[:ERROR].nil? )
+  puts "Number of Samples: #{results[:NUM]}"
+  puts "Channel mask: #{results[:CM]}"
+  puts "DIO data: #{results[:DIO]}"
+
+  # up to 6 lines (ADC0-ADC5) of ADC could be present if all enabled
+  0.upto(5) do | adc_channel |
+    adcsym = "ADC#{adc_channel}".to_sym
+    if ( !results[adcsym].nil? )
+       puts "ADC#{adc_channel} data: #{results[adcsym]}"
+    end
+  end
+else
+  puts "No DIO input data to report"
+end

data/bin/xbeeinfo.rb

@@ -0,0 +1,110 @@
+#!/usr/bin/env ruby -rubygems
+# == Synopsis
+# xbeeinfo.rb - A Ruby utility for extracting XBee setup information using xbee ruby class (Ruby::XBee)
+#
+# :title: A Ruby utility for extracting XBee setup information using xbee ruby class (Ruby::XBee)
+# == Usage
+#  ./xbeeinfo.rb
+#
+# example output from xbeeinfo:
+#    Attention: OK
+#    Firmware: 10CD
+#    Hardware: 180B
+#    Baud: 9600
+#    Parity: None
+#    Neighbors:
+#    [{:SL=>"4008A642", :DB=>"-56", :NI=>" ", :MY=>"0", :SH=>"13A200"},
+#    {:SL=>"4008A697", :DB=>"-75", :NI=>" ", :MY=>"0", :SH=>"13A200"},
+#    {:SL=>"40085AD5", :DB=>"-64", :NI=>" ", :MY=>"0", :SH=>"13A200"}]
+#    Node ID: BaseStation
+#    Channel: C
+#    PAN ID: 1
+#    MY: 1
+#    SH: 13A200
+#    SL: 4008A64E
+#    DH: 0
+#    DL: 2
+#    Last received signal strength (dBm): -36
+#    Port 0: Disabled
+#    Port 1: DI
+#    Port 2: Disabled
+#    Port 3: Disabled
+#    Port 4: Disabled
+#    Port 5: Associated_Indicator
+#    Port 6: Disabled
+#    Port 7: CTS
+#    Port 8: Disabled
+#
+# See conf/xbeeconfig.rb for configuration defaults
+#
+# this code is designed for the following XBee modules:
+# IEEE® 802.15.4 OEM RF Modules by Digi International
+# Series 1 XBee and XBee Pro modules
+#
+# == Copyright
+# Copyright (C) 2008-2009 360VL, Inc. and Landon Cox
+#
+# == License
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program 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 Affero General Public License version 3 for more details.
+#
+# You should have received a copy of the GNU Affero General Public License along with this program.
+# If not, see http://www.gnu.org/licenses/
+#
+# == See Also
+# xbeeinfo.rb, xbeeconfigure.rb, xbeedio.rb, xbeelisten.rb, xbeesend.rb
+#
+# == Learn more
+# You can learn more about Ruby::XBee and other projects at http://sawdust.see-do.org
+#
+# see Digi product manual: "Product Manual v1.xCx - 802.15.4 Protocol"
+# for details on the operation of XBee series 1 modules.
+
+
+$: << File.dirname(__FILE__)
+
+require 'date'
+require 'ruby-xbee'
+
+STDIN.sync = 1
+STDOUT.sync = 1
+$stdin.sync = true
+$stdout.sync = true
+
+require 'pp'
+
+@xbee = XBee.new( @xbee_usbdev_str, @xbee_baud, @data_bits, @stop_bits, @parity )
+
+puts "Attention: #{@xbee.attention}"
+puts "Firmware: #{@xbee.fw_rev}"
+puts "Hardware: #{@xbee.hw_rev}"
+
+puts "Baud: #{@xbee.baud}"
+puts "Parity: #{@xbee.parity}"
+
+puts "Neighbors:"
+pp @xbee.neighbors
+
+puts "Node ID: #{@xbee.node_id}"
+puts "Channel: #{@xbee.channel}"
+puts "PAN ID: #{@xbee.pan_id}"
+puts "MY: #{@xbee.my_src_address}"
+puts "SH: #{@xbee.serial_num_high}"
+puts "SL: #{@xbee.serial_num_low}"
+puts "DH: #{@xbee.destination_high}"
+puts "DL: #{@xbee.destination_low}"
+puts "Last received signal strength (dBm): #{@xbee.received_signal_strength}"
+
+0.upto(8) do | num |
+  portsym = "D#{num}".to_sym
+  puts "Port #{num}: #{@xbee.dio( portsym )}"
+end
+
+

data/bin/xbeelisten.rb

@@ -0,0 +1,114 @@
+#!/usr/bin/env ruby
+# == Synposis
+# xbeelisten.rb - A ruby utility for listening to data output from an XBee
+#
+# :title: xbeelisten.rb - A ruby utility for listening to data output from an XBee
+#
+# == Copyright
+# Copyright (C) 2008-2009 360VL, Inc. and Landon Cox
+#
+# == License
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License version 3 as
+# published by the Free Software Foundation.
+#
+# This program 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 Affero General Public License version 3 for more details.
+#
+# You should have received a copy of the GNU Affero General Public License along with this program.
+# If not, see http://www.gnu.org/licenses/
+#
+# You can learn more about ruby for XBee and other projects at http://sawdust.see-do.org
+#
+# == Usage
+#    ./xbeelisten.rb
+#
+# Example output from xbeelisten...this example is an XBee listening to
+# a Sparkfun USB Weather board which is transmitting data through a 2nd
+# XBee:
+#    cooper:ruby-xbee lcox$ ./xbeelisten.rb
+#    #10.75,069.47,020.9,069.62,079038,612,050580$
+#    #10.22,070.46,021.5,070.70,078998,613,052232$
+#    #10.22,070.44,021.6,070.88,078993,613,052233$
+#
+# See conf/xbeeconfig.rb for configuration defaults
+#
+# == See Also
+# xbeeinfo.rb, xbeeconfigure.rb, xbeedio.rb, xbeelisten.rb, xbeesend.rb
+#
+# == Learn more
+# You can learn more about Ruby::XBee and other projects at http://sawdust.see-do.org
+#
+# see Digi product manual: "Product Manual v1.xCx - 802.15.4 Protocol"
+# for details on the operation of XBee series 1 modules.
+#
+# this code is for the following XBee modules:
+# IEEE® 802.15.4 OEM RF Modules by Digi International
+#
+
+$: << File.dirname(__FILE__)
+
+require 'date'
+require 'getoptlong'
+
+require 'ruby-xbee'
+
+def dump_help
+
+  puts "xbeelisten.rb [options]"
+  puts "Options:"
+
+  puts "   [--dev device] [-d device]                use this device to talk to XBee (ie: /dev/tty.usb-791jdas)"
+  puts "   [--baud new_baud_rate] [-b new_baud_rate] sets the baud rate with which to talk to the device"    # override baud
+  puts "   [--help] print this command help message"
+
+  puts "\nSee conf/config.rb for defaults and edit conf/config.rb to change the defaults used to communicate with the device"
+  puts "License: GNU Affero General Public License version 3"
+  puts "Copyright (C) 2008-2009 360VL, Inc"
+  puts "Copyright (C) 2008-2009 Landon Cox"
+
+end
+
+options = GetoptLong.new()
+options.quiet = true
+
+options_array = Array.new
+
+options_array << [ "--dev", "-d", GetoptLong::REQUIRED_ARGUMENT ]      # override serial /dev string
+options_array << [ "--baud", "-b", GetoptLong::REQUIRED_ARGUMENT ]     # override baud
+options_array << [ "--help", "-h", GetoptLong::NO_ARGUMENT ]           # write new configuration to XBee flash
+
+options.set_options( *options_array )
+
+options.each do | opt, arg |
+
+    case opt
+
+    when "--dev"
+      @xbee_usbdev_str = arg
+
+    when "--baud"
+      @xbee_baud = arg
+
+    when "--help"
+      dump_help
+      exit 0
+
+    when "--save"
+      @save = true
+
+    end
+
+end
+
+# start a connection to the XBee
+@xbee = XBee.new( @xbee_usbdev_str, @xbee_baud, @data_bits, @stop_bits, @parity )
+
+# read XBee output forever
+while( 1 )
+  @xbee.getresponse true
+end
+
+