Teacher, a Cerebellum Download Utility for Botrics microcontrollers by Chris Atwood, catwood@botrics.com Teacher is a Cerebellum download utility, designed to quickly program the onboard microcontroller using the onboard file transfer protocol. It supports all currently released firmware versions, although features vary between firmware versions. Teacher is command line only, though a version with graphical user interface is expected in the future. ----------------------------------------------------------------------------- Teacher v1.03 Known Issues: The serial port is not correctly closed on program exit. You might see a message along the lines of "Stale lock file found, removing." on program startup, but it does not affect usage. ----------------------------------------------------------------------------- Teacher requirements: Java 1.4 (available at: http://java.sun.com/j2se/) NOTE - only the JRE is required (don't get the SDK unless you intend to do java development) Serial device (available serial port, USB->serial adapter, etc) Windows and i386 linux are currently supported. ----------------------------------------------------------------------------- Teacher v1.03 usage: teacher [options] command Options: [-d|--device ] Cerebellum is connected to . Defaults to COM1 on Windows and /dev/ttyS0 on Linux. [-f|--filter ] Will only execute command if firmware matches . Commands with 1.03b+ firmware: -p|--program Program the Cerebellum with . This action is assumed if no command is specified. -h|--help Displays this help message. Commands with 1.03c+ firmware: -v|--verify Verify the Cerebellum's program with . -e|--erase Erase the Cerebellum. -i|--info Get information on this Cerebellum. ----------------------------------------------------------------------------- Example Usage: prompt> teacher aProgram.hex Programs your Cerebellum with aProgram.hex via COM1 (assuming windows). prompt> teacher -f 1.03c aProgram.hex Programs your Cerebellum with aProgram.hex via COM1 (assuming windows) if and only if the Cerebellum is running firmware 1.03c. prompt> teacher -d COM3 -p aProgram.hex Programs your Cerebellum with aProgram.hex via COM3. prompt> teacher -d /dev/usb/ttyUSB0 -p aProgram.hex Programs your Cerebellum with aProgram.hex via ttyUSB0 (linux). prompt> teacher -v aProgram.hex Checks to see if the connected Cerebellum is programed with aProgram.hex. Will report if there is a match or not. NOTE: By default, the Cerebellum automatically verifies as it programs. Re-verification following programming is not required. prompt> teacher -e Erases all code from your Cerebellum prompt> teacher -i Prints out the Cerebellum's information string. This gives information about firmware version, code word timeout status, serial baud rate, and a few other things. See the Cerebellum user manual for more information. ----------------------------------------------------------------------------- Teacher is copyright (c) 2004 by Chris Atwood, catwood@botrics.com This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.