Appendix B: Installing Codevision and The Mech - Lib
Appendix B: Installing Codevision and The Mech - Lib
Appendix B: Installing Codevision and The Mech - Lib
Mechlib is an open source library developed by the TekBots team at Oregon State University to aid users in programming
an Atmel AVR microcontroller board. This library is released under the GPL; for source code, license info, and
supporting materials please grab the tarball: mechlib-0.1.0.tar.gz.
To set up CodeVision AVR for the first time, follow the instructions below.
1. To get started with CodeVision AVR and mechlib, download the CodeVision Installer from
http://eecs.oregonstate.edu/tekbots/mechlib_html/files/setup.exe. Run the executable. Agreeing to the default
options will install CodeVision in c:\cvavre\; the rest of these instructions will assume this location.
2. To make the mechlib available to CodeVision, save mechlib.h and mega8535asm.h to c:\cvavr\inc\. Copy
mechlib.lib to c:\cvavr\lib\. These three files can be found in the zip file at
http://eecs.oregonstate.edu/tekbots/mechlib_html/files/mechlib.zip.
3. Here is a step by step example of creating a CodeVision project, and using mechlib functions to program the
mx_ctlr.0 microcontroller board:
a. Switch the board off using the slide switch. Connect the 7.2V power supply or batteries to the power
input marked with a “+” and “-.” Connect the small fitting on the programming dongle to the board.
Connect the larger end of the programming dongle to your PC’s parallel port.
b. Turn the board on and confirm that the “on” light illuminates. Note that you may need to disconnect
any motors if don’t want them running and moving around while you are programming the board. The
following example should demonstrate everything you need to know to use CodeVision to compile a
program and transmit that program to your board. Start CodeVision and create a new project (File →
New → Project → OK). Use the code generation wizard: a tabbed interface with many options should
be displayed. For our purposes, you can ignore most of this and simply choose the chip type as
“ATmega8535” with a clock speed of 16MHz. Choose File → Generate Save and Exit. Change to the
directory where you want to save your programming, then enter the name “example” and hit “OK”
each time you are prompted.
c. You should now be looking at an editor window with a lot of C code (this is the example.c file that
you created). Click anywhere in this editor window and then press CTRL-A, BACKSPACE this will
delete all the code generated by CodeVision. Go to the mechlib website and choose the “forward” link
from the menu on the left. After the description of the forward function, there are two examples. Copy
and paste the second example in to the CodeVision editor window; don’t include the word “Example”
when you copy the code. Set up the programmer: Settings → Programmer → Kanda Systems (from
drop down menu). Change the CodeVision setting that will allow you to compile your code and
program the board at the same time: choose Project → Configure → After Make → program the chip
→ OK. Now press SHIFT-F9 to compile the code and program your board. After a few seconds, the
board should begin running motors 1 and 3, and then motors 2 and 4, alternating every second. You
can verify this function by watching for the green lights next to the motor outputs.
Useful Links
Programs
CodeVisionAVR
Library Functions
http://eecs.oregonstate.edu/tekbots/mechlib_html/
Mechlib Library
Mech_lib: http://eecs.oregonstate.edu/tekbots/mechlib_html/