Installing the Tools

To Compile the Source:

• Extract the files from this GZIPped TAR archive file. For example, in a shell terminal:

  tar -xzf bstamp-VERSION.tar.gz


  (Where "VERSION" is the version number. e.g., 2003.04.10).

  A directory named bstamp-VERSION should be created.

• In a shell terminal, go into that directory and compile the program:

  cd bstamp-VERSION
make


• Then, as the system's "root" super-user, install it:

  su
(enter root password)
make install


• Finally, create a 'symbolic link' in your system's "/dev" directory that points to the serial port where your BASIC Stamp will be connected:

  (Note: you will need to do this as "root" super-user, as well.)

  cd /dev
ln -s ttyS# bstamp


  For example, if it's connected to your PC's "COM1" port, use ttyS0. If it's on "COM2", use ttyS1.

Install the Tokenizer Library:

• Download the Tokenizer library from Parallax, Inc.'s website. (For Linux on i386-compatible systems, you want 'tokenizer.so'.)

• In a shell terminal, go into the directory where you downloaded the file, and switch to the system's "root" super-user:

  su
(enter root password)


• Now, copy the file into a library directory on your system, for example '/usr/local/lib/':

  cp tokenizer.so /usr/local/lib/libbstamptokenizer.so


• If the directory you chose (e.g., '/usr/local/lib/') isn't in your system's library path, add the library directory:

  echo "/usr/local/lib" >> /etc/ld.so.conf
ldconfig


• Now you should be able to run "bstamp_tokenize", and it will successfully find and load the Parallax Tokenizer Library!

PBASIC is a trademark and BASIC Stamp is a registered trademark of Parallax, Inc.
Linux is a trademark of Linus Torvalds.