README 
Teleo Max for Windows XP 
Release 2.2
        

Contents

0. Before You Start
1. Installation
2. Mailing List
3. Known Issues
4. Release Notes
5. List of Files


0. Before you start

   Do not plug in the USB Translator until you have installed the
   FTDI USB Driver.

1. Installation

   There are five files/directories to place in the appropriate locations:

      Teleo_externals
      Teleo_help
      TeleoMaxWXPLib.dll
      teleo_objectlist.txt
      FTDI_USB_Driver

   1. Place the Teleo_externals directory in:
	C:\Program Files\Common Files\Cycling '74\externals\

   2. Place the Teleo_help directory in:
	C:\Program Files\Cycling '74\MaxMSP 4.3\max-help\

 
   3. Place the TeleoMaxWXPLib.dll in:
	C:\Program Files\Cycling '74\MaxMSP 4.5\

   4. Place the teleo_objectlist.txt file in:
	C:\Program Files\Common Files\Cycling'74\init

   5. Connect the Intro Module to the power supply, plug in, and use 
	the USB cable to connect the Translator to your 
	computer. After a few moments you should be told that new hardware
	has been detected and the system is searching for a driver. This
	process might take a few minutes. Eventually you will be asked
	where to search for the driver; at this point select the  browser
	and point it at the FTDI_USB_Driver folder.

2. Mailing List

   You are encouraged to join the MakingThings mailing list at
   http://groups.yahoo.com/group/makingthings/ for the latest
   updates, bug reports, and general exchange of ideas and 
   solutions.

3. Known Issues

    1. A missspelled attribute is not identified as such and
       is simply ignored 

       Workaround: double-check spelling of attributes

    2. In newer Teleo Max External objects, for example  t.ain, the 
       sample period is correctly named as such. Earlier Teleo Max 
       external objects still refer to this property as samplerate.

    3. Setting Min and Max via messages on the t.ain Teleo Max 
       external object for the Teleo Analog In module doesn't
       work. This is a bug and will be fixed in an upcoming
       release.

       Workaround: set Min and Max via attributes or inlets

    4. Setting Speed via a message on the motor controller
       t.mc2 Teleo Max external object for the 
       Teleo Motor Controller module does not work.
       This is a bug and will be fixed in an upcoming 
       release.

       Workaround: set Speed via attributes or inlets

    5. The help patches are missing instructions for changing the 
       module address. The printed and online documentation for this
       is summarized below for convenience:

       1. A new address is chosen. Any unused address between 2 
          and 63 may be used.  It would be wise to avoid the default 
          addresses of any Teleo modules, but there is no conflict 
          if that module is not used on this particular Teleo Network.

          (Default addresses for Teleo modules are available in the
          Teleo help patches by double-clicking on the 
          "p argument.help" message.)

       2. A Teleo Max object for any device on that module is 
          created, with the additional parameter of the new address.
          e.g. if a second Digital Out module is to be added at 
          address 10, you might create the object:

	      t.dout @address=10

       3. Connect a Max message box with the message t.address.set 
          to the leftmost inlet of the t.dout object.

       4. Press and hold the push button on the module for around 3 
          seconds, until you see the LED flashing rapidly.

       5. Once the rapid flashing starts the button can be released.
          The rapid flashing will continue until the next step is
          successful:

       6. Send the Max message by clicking on the message box. The 
          LED should cease flashing rapidly and should return to its 
          normal rate of about once a second. In addition, the Max 
          window will say something like "setting address to 30".

       Although only one particular device is used to send the 
       t.address.set message to the module, the address affects all 
       devices on that module. There is only one, common, address 
       for the entire module.

    8. The device parameter can not be set via a message.

       This is a known deficiency and will be fixed in a future release.

    9. Setting Min and Max via messages or attributes on the t.intro.ain 
       Teleo Max external object for the Analog In devices on the Teleo 
       Introductory Module doesn't work. 
       
       This is a bug and will be fixed in an upcoming release.

       Workaround: set Min and Max via inlets

    10.Setting Min and Max via messages on the t.intro.pwm Teleo Max 
       external object for the PWM devices on the Teleo Introductory 
       Module doesn't work. 
       
       This is a bug and will be fixed in an upcoming release.

       Workaround: set Value and Max via inlets or attributes


4. Release Notes

    2.2 
    -----
    Split the downloads up into their separate files for ease of update.

    1.0 
    -----
    First release

    0.1 
    -----
    First beta release

5. List of files included in this release

    README - this document.

    Externals - Teleo_externals 
      Ain 
        t.ain          
      DOut 
        t.dout          
      Intro 
        t.intro.ain  
        t.intro.din  
        t.intro.dout 
        t.intro.pwm
      MC2
        t.mc2           
      MultiIO
        t.mio.ain  
        t.mio.din  
        t.mio.dout 
        t.mio.pwm
      Servo
        t.servo
      Video
        t.vid.move

    Help - Tele0_help
      t.ain.help
      t.dout.help
      t.intro.ain.help
      t.intro.din.help
      t.intro.dout.help
      t.intro.pwm.help
      t.mc2.help
      t.mio.ain.help
      t.mio.din.help
      t.mio.dout.help
      t.mio.pwm.help
      t.servo.help
      t.vid.move.help

    Max Library - TeleoMaxWXPLib.dll 

    FTDI USB Driver - FTDI_USB_Driver