_____________________/\\\\\\\\\_______________        
 __________________/\\\////////________________       
  ___/\\\\\\\\____/\\\/_________________________      
   __/\\\////\\\__/\\\______________/\\/\\\\\\___     
    _\//\\\\\\\\\_\/\\\_____________\/\\\////\\\__    
     __\///////\\\_\//\\\____________\/\\\__\//\\\_   
      __/\\_____\\\__\///\\\__________\/\\\___\/\\\_  
       _\//\\\\\\\\_____\////\\\\\\\\\_\/\\\___\/\\\_ 
        __\////////_________\/////////__\///____\///__

               globalCALCnet Client (gCnClient) 2.0
              by Christopher Mitchell (Kerm Martian)
           September 12, 2013 | http://www.cemetech.net


I. Introduction
==+========================================================================================
CALCnet introduced extensible, robust, and simple multi-calculator networking to the world
of TI graphing calculators, but is limited to local area networks.  It allows people in the
same room or building to play calculator games together, share data and files, or chat.
However, on its own it does not permit connection of calculators across a city or across the
world, a role filled by globalCALCnet (gCn). Using inexpensive commodity hardware attached
to any computer running Windows, Mac OS X, or Linux, gCn connects CALCnet networks despite
their geographical separation. In addition, gCn allows calculators to access and use internet
resources such as chat rooms, program downloads, and more. All you need is a little hardware
and free software to connect to globalCALCnet.

This document provides a quick-start guide to the gCnClient application. Refer to gcn.pdf for
full details on using the application and on how gCn works.

Versions:
 - gcnclient.exe : 32-bit and 64-bit Windows
 - gcnclient_macos : Mac OS X (thanks to Elfprince13 for compiling)
 - gcnclient_rpi : Raspberry Pi (tested on Raspbian; thanks to Sorunome for compiling)
 - gcnclient_ubuntu : Ubuntu and other Debian-based distros

II. Using the gCnClient
===+========================================================================================
The gCnClient software is provided for Windows (gcnclient.exe), Mac OS X (gcnclient_macos)
and Linux (gcnclient_ubuntu}).  If you need the source code to compile the gcnclient
software for your own operating system, please contact the author.  Each of these gCnClient
builds can be run from the command line of the user's preferred operating system.  For
Windows, this can be accessed via Command Prompt; most Linux and Mac OS versions have a
Terminal.  There is one optional argument to the gCnClient, -v (verbose), as well as five
mandatory arguments specified below:

 -n <hubname>     Specifies the name of the virtual hub to connect to. IRCHub for CALCnet
                  Chat, FTPHub for Sandpaper, and WebHub for Gossamer. You can also make
                  up your own hub name, and your friends will be able to connect to that
                  hub too.

 -l <localname>   Specifies the name of the local gCnClient. It can be whatever you
                  want. This may be something like "KermClient" to indicate the name of
                  the user hosting the client, or it may be something like "MyschoolBridge"
                  to elucidate the location or function of the bridge.

 -s <serverhost>  Omit this unless you know you need it. It defaults to gcnhub.cemetech.net.

 -p <serverport>  Omit this unless you know you need it. It defaults to 3295.

 -d <devicetype>  This can be 'd' (direct USB), 'a' (Arduino), or 'u' (USBHID, which is not
                  direct USB). If you are using a miniUSB cable connected to a TI-84+/SE,
                  use -d d.

 -c <serialport>  Use only for -d a (Arduino). Something like COM3 or COM11 on Windows, or
                  /dev/ttyUSB0 on Linux. On Mac OS X, it might be /dev/cu.usbserial#### or
                  /dev/cu.usbmodem####.

III. Using Direct USB with a TI-84+/SE
====+========================================================================================

The direct USB solution makes it very simple to use your TI-84 Plus or TI-84 Plus Silver
Edition with globalCALCnet. You just need a mini-USB cable and your calculator. Before you
can use direct USB globalCALCnet, you need to install the libusb 0.1 filter driver. Plug
your calculator into your computer and run install-filter-win.exe (included with the
gCnClient). You install the filter driver on a per-calculator, per-port basis, so if you
connect a different calculator or connect your calculator to a different USB port, you'll
need to re-install the filter driver. After installing the filter driver, you can follow
the instructions above to run the gCnClient application.

IV. More Information
===+=========================================================================================
For help, post on the Cemetech forum ( http://www.cemetech.net/forum) or join #cemetech on
EfNet IRC. You can contact the author at gcnclient@cemetech.net with specific questions.

(c) 2002-2013 Christopher Mitchell ("Kerm Martian") and Cemetech