Installing SerialUSB
====================

To test out SerialUSB it can be loaded by double clicking on the module.

To load in your program

    rmensure SerialUSB x.xx rmload <path to serialusb>.SerialUSB

    where x.xx is the supplied version eg 0.15

To add SerialUSB to !SeriallDev

    Put the module in '!SerialDev.modules.SerialUSB' and alter
    '!SerialDev.modules.SerialUSB.!boot' so that the version (x.xx) in the line

    RMensure SerialUSB x.xx RMLoad <Obey$Dir>.SerialUSB

    is the new version of SerialUSB eg x.xx is 0.15

    After altering the file double click on !SerialDev to load the new SerialUSB - or reboot.

    Works best with BlockDriver 0.21 or later.


SerialUSB
=========

SerialUSB provides a DeviceFS serial interface (SerialUSB<n>:) for USB serial devices 

It supports the following USB serial devices:

CH340
CP210x
PL2303
FTDI
CDC

The first device found will be called 'SerialUSB:'. If more than 1 serial usb device
is plugged in they will be given names 'SerialUSB1:' 'SerialUSB2:' etc. To see if the
device is recognised

*SerialUSBDevices

will list the recognised devices.

SerialUSB supports the standard RISC OS DeviceFS serial interface so you can test
output with:

echo test { > SerialUSB: }

which will send 'test ' to 'SerialUSB:' by default 'SerialUSB:' is equivalent to:

SerialUSB#baud=115200;nohandshake;data=8;stop=1;noparity:

So if you only want to change the baud rate/handshake you just need to use:

SerialUSB#baud=9600:
SerialUSB#baud=19200;rts:
SerialUSB#xon:


You can read the devices in a program by enumerating the devices:$ directory
using a "SerialUSB*" wildcarded leaf name. and read the device description with

Commands
========

*SerialUSBDevices

Lists connected devices.

SerialTerminal:
===============

SerialTerminal is a simple taskwindow demonstration program. Running it will 
connect to the first unused USBSerial device. Typing in the window will send data
and it will receive any data sent to it. Sources are included and you are free
to modify it. 