-----------------------------
How to Install XS for Windows
-----------------------------

1. Install the driver for the USB tower (RCX 2.0 only)

   If you are using RCX 2.0, the IR tower is to be connected to the
   USB port of your PC.  In this case, you need to install the driver
   for the IR tower.  To do this, connect the IR tower to the USB port
   of your PC and install the driver that is found in the MindStorms
   package.

   If you are using RCX 1.0 or 1.5, the IR tower is to be connected to
   the serial port of your PC.  In this case, you do not need to install
   a driver.

2. Download the zip file "xs.zip" from the XS Web page and unzip it.

3. Download the brickOS (a tiny OS for RCX) and the XS evaluator to your
   RCX.

   Once downloaded, these programs will be maintained in the RCX RAM
   as long as the batteries are alive.

	* Connect the IR tower to the serial port (for RCX 1.0 and 1.5) or
	  to the USB port (for RCX 2.0) of your PC.
	  Place the IR tower so that its front side faces with the
	  IR port of your RCX, which looks like a black belt.

	* Turn on your RCX by pressing the On-Off button.
	  Make sure you hear a beep and see "1" on the LCD display.
	  If not, remove batteries, wait a while, put back batteries,
	  and try again.

	* Execute firm.bat to download the brickOS.  The batch file is for
	  RCX 2.0.  If you are using RCX 1.0 or 1.5, remove "--tty=usb" in the
	  batch file.

	  If succeeded, the following message will appear on your PC display.

	    Transferring "boot/brickOS.srec" to RCX...
        100%        
	  
      If failed, possible reasons are:

	  (a) [RCX 1.0 and 1.5 only]
	      The serial port of your Windows PC may not be the default "com1".
	      In this case, specify the serial port device by modifying
	      "--tty=usb" in the batch file.

	  (b) Your room light may cause jamming to IR communication.
	      In this case, cover the area between the IR tower and the
	      IR port of the RCX with something like a thick paper.

	  (c) [RCX 1.0 and 1.5 only]
	      The battery inside the IR tower may be dead.  In this case, you
	      receive an error message "tower not responding" on your PC
	      display.  Change the battery.

	  (d) Your PC does not have the dll file msvcr70.dll.
	      If this is the case, you will receive an appropriate message
	      from the Windows OS.
	      msvcr70.dll is a run-time library, which is distributed as part
	      of Microsoft Visual C++ .NET. Make sure your machine has the dll
	      file in the proper folder, which is usually C:\WINDOWS\system32.
	      If not, download the dll file from 
	      	http://www.xslisp.com/msvcr70.dll
	      and save it in the folder you intalled XS.

	* While the RCX brick is turned on, execute eval.bat to download
	  the XS evaluator.  The batch file is for RCX 2.0.  If you are
	  using RCX 1.0 or 1.5, remove "--tty=usb" in the batch file.

      If succeeded, you will see increasing numbers on the LCD display.
      If failed, see the remarks above for "Download the brickOS".

4. Turn off your RCX.

   As mentioned already, the brickOS and the evaluator you downloaded
   will be maintained in the RCX RAM as long as the batteries are alive.
   To save batteries, you are recommended to turn off your RCX while you
   are not using it.


--------------------------
How to Start an XS Session
--------------------------

1. Make sure the IR tower is correctly connected and placed.

2. Turn on the RCX by pressing the On-Off button.
   Make sure you see a "-" on the LCD display.

3. Start the XS evaluator by pressing the Run button.
   Make sure you hear a beep.

4. Go to the sub-directory "xs" and execute xs.exe.
   If you are using RCX 1.0 or 1.5, type "xs".
   If you are using RCX 2.0, type "xs --tty=usb".

	Welcome to XS: Lisp on Lego MindStorms
  
	>

   Make sure you see the banner and a prompt ">".

5. Type a Lisp expression following each prompt.

	>(cons 1 2)
	(1 . 2)
	>

6. To end the XS session, type "(bye)".

	>(bye)
	sayonara
	%

7. Turn off your RCX.

--------
Trouble?
--------

If you have trouble, contact Taiichi at yuasa@kuis.kyoto-u.ac.jp.

Good Luck.

Copyright 2003, Taiichi Yuasa
The project of XS was sponsored by the Information-technology Promotion
Agency (IPA) of Japan as an Exploratory Software Project.