File	Date	Author	Commit
common	2009-04-17	Robert	[ddca98] Get the XBee address to the client.
libxbee	2010-01-27	Robert Spanton	[976487] Bring the cursed test utility up to date with t...
utils	2010-01-27	Robert Spanton	[6be9c9] Correct the types of the callbacks in the dump ...
xbd	2009-04-17	Robert	[b02949] Correct cast.
.shellrc	2007-12-29	rspanton	[743277] Make libxb a shared library.
CONTRIBUTORS	2007-12-18	rspanton	[8c2116] The initial import of the libxb code from the S...
COPYING	2007-12-18	rspanton	[8c2116] The initial import of the libxb code from the S...
Makefile	2007-12-29	rspanton	[743277] Make libxb a shared library.
README	2007-12-29	rspanton	[ce0e50] Update README.
shell	2008-01-31	rspanton	[5a5d34] Fix script to use bash rather than sh.
xbd.conf	2007-12-29	rspanton	[21dc26] Update the example xbd config file to contain b...

Read Me

libxb is a library for interacting with Maxstream XBee modules.

It has one main dependency, which is glib.  glib is available in most
GNU/Linux distributions and so this shouldn't be too much of a
problem.

What version of glib is required? We're not totally sure...  It's
running on my machine using 2.14.4.

Known working architectures?  Please let us know if you use libxb on
an architecture not listed here:

 * 32-bit i386, i686
 * ARM ixp425

------------------------------------------------------------
 *** Installation ***

At the moment, libxb doesn't use autotools, and so it's a little
annoying to install.  We'll hopefully be upgrading to use it soon.

To build libxb, just type 'make' in the root directory of the source
code.  This will create 2 important binaries:

 * xbd/xbd
    This is the daemon program that serves requests from other
    programs.

 * libxbee/libxbee.so*
    This is the shared object file that contains routines for
    communicating with xbd.

------------------------------------------------------------
 *** Using libxb ***

To use libxb from a client program is reasonably straight forward.
Have a look in libxbee/test.c as an example.

------------------------------------------------------------
 *** Development Shell ***

To run any of the utilities, you need to run the "shell" script
first.  This will give you a shell with the right environment
variables set to do so.

If you're in a situation where you don't want a shell, but just want
to run one of the utilities, use the shell script in a different way:

  ./shell ./utils/dump/dump -s /tmp/xbee2

The command given as an argument to shell will be run in the right
environment instead of giving you a shell.