uBug12  Java Edition
 ======================

Update: The Ubug12 installer has been changed to be an
executable so that it will install on Windows 8/8.1/10.
There should no longer be a need to modify the UAC setting
to install.  The Windows installer has been placed in a 'rar'
archive file.  It will have to be extracted from the archive
first to be run.  The WinRar utility is available as a free
trial version at http://www.rarlab.com/download.htm

 =========
 uBug12 works best with the latest version of the Java
 JRE installed.  (i.e. Java 6 Update 30)  When you 
 upgrade your JRE, you MUST uninstall all older JRE
 versions first!

 uBug12 requires the use of the RXTX library to function.
 This library allows uBug12 to use a Serial Port to 
 communicate with an S12 MCU. Your system must already have
 its native drivers installed to use the serial port for
 general communication.  RXTX just allows Java to access
 that native OS driver.

 The installer can attempt to install the RXTX library for
 you. There are several variations available, so if one does
 not work, uninstall uBug12 and reinstall with another 
 version. If none of these work, try installing it manually
 onto your system.  (You can deselect installation of the
 library in the installer to do this.) 

 The RXTX website is at:
 http://rxtx.qbang.org/wiki/index.php/Main_Page

 On some systems the port search variation of the CON
 command may not work.  This is not an issue with uBug12,
 but is due to the Operating system and its interaction
 with its native serial port drivers. Instead, first 
 EXIT uBug12, then specify the port explicitly with CON.
 Note:  Port name IS CASE SENSITIVE, EVEN FOR WINDOWS!

 Linux installation may require RXTX be installed manually
 by the root account. For Ubuntu, installing the
 librxtx-java package should be enough.

 =======================
 Windows:
 ALL - If USB-to-Serial is being done, first plug in the USB
   cable between the computer and the S12 board. Windows will
   prompt that it has found new hardware, and is searching
   for a driver.  On Vista, this Microsoft Update for the
   driver will seem to take forever. Be patient.

 XP - Works well with standard RXTX install.

 Vista - Works with RXTX 2.2 Prerelease.

 Windows 7 Starter - Works with RXTX 2.2 Prerelease.

 7 with 64 bit - Works best with the default 32 bit version
   of the Java JRE installed, and 32 bit RXTX drivers, such as
   the Prerelease 2.2 version. (The default JRE is 32 bit
   because the default browser is the 32 bit version of IE.)
   Reliability issues have occurred with the 64 bit JRE and
   64 bit RXTX on some systems. Again, not an issue with 
   uBug12 itself.

 Mac:
   You may need to install RXTX manually.

 Linux:
   Be sure there are native drivers installed first for the
   serial port, especially if it is a USB-to-serial port.

========================================================
 Copyright stuff:

 uBug12 source code has been released under the GNU License,
 Version 3, and is included so you can see what was done.
 You are free to change it, as you wish, for your platform.

 RXTX is released under LGPL 2.1. (GNU Lesser General Public
 License) See http://users.frii.com/jarvi/rxtx/license.html

 RXTX 64 bit binary builds for Windows and Linux provided as
 a courtesy of Cloudhopper, Inc.
 Please see http://rxtx.cloudhopper.net/ for more information.

 Serial library from Processing.
 Copyright (c) 2004 Ben Fry and Casey Reas
 This is released under the GNU Lesser General Public
 License, as published by the Free Software Foundation.

 AS12 included under Mozilla Public License 1.1
 Copyright 1996-2003 by Karl Lunt, Tom Almy, Eric Engler

 HSW12ASM included by permission of Dirk Heisswolf,
 under the same License as used by Perl.

 JTerminal Copyright (c) 2009-2011 Graham Edgecombe.
 (See License file in src directory. This is open source
 software.)

 Other third party utilities/drivers may be downloaded
 from the Internet by uBug12 and called by the program.
 These include, but are not limited to, Strawberry Perl
 for Windows, USBDM drivers, MiniIDE and asm12.
 The copyrights for these remain with their copyright
 holders. You always have the option to cancel the
 installers when they run, should you choose not to
 install that software.
========================================================

 Technological Arts would like to express thanks to those
 who helped develop previous versions of uBug12.  Those
 efforts provided a substancial launching point for this
 Java Edition.

 Alex Harvey
 Carl Barnes
 Exequiel Erarama