Wed Oct 17 14:13:13 CEST 2007
practical stuff : starting a new project
I need to make my old 18F452 proto board work again, so this entry is
a seed for a "getting started" doc: how to get from nothing to a
EDIT: i'm switching to a 18F2620, so doing it over again.
* the project is part of (your branch of) the brood distribution
* you're using darcs version control
1) Make a directory in brood/prj, and add to darcs
darcs add proto
2) Copy the following files from another project. i.e. prj/CATkit and
add them to the darcs archive
cp ../CATkit/monitor.f .
darcs add *
3) Edit the init.ss file to reflect your project settings.
skip step 4-6 if you have a chip with a purrr bootloader
4) Edit monitor.f for your chip
That file includes the support for the chip in the form of a
Look in the directory brood/pic18 to see if such a file exists. If
it does, go to step 5).
If not, you need to create one and generate a constants file from
the header files provided by Microchip. I.e.:
< /usr/share/gputils/header/p18f2620.inc \
The .INC file can alternatively be found in the MPLAB distribution,
in the MPASM directory.
Now you need to create the setup file for the chip. Start from a
chip that is similar
cp 18f1220.f p18f2620.f
And edit the file to reflect changes necessary for chip startup and
serial port initialization.
Don't forget to add the files to darcs, and send a patch!
darcs add p18f2620*.f
darcs record -m 'added p18f2620 configuration files'
darcs send --to email@example.com http://zwizwa.be/darcs/brood
In case you can't send email from your host directly, replace the
"--to firstname.lastname@example.org" option with an "--output darcs.bundle" option and
send the resulting darcs.bundle file.
5) To compile the monitor in the interactive console type this:
6) Make a backup copy of the monitor state.
cp prj.ss monitor.ss
And flash the microcontroller using the monitor.hex file. In case
you're using the ICD2 together with piklab, the command line would
piklab-prog -t usb -p icd2 --debug --firmware-dir <dir> \
-c program monitor.hex
Here <dir> is the directory containing the ICD2 firmware, which can
be found in the microchip MPLAB distribution.
7) Next when you start the console, go back to the project by typing:
8) Now you can start uploading forth files using commands like:
This will erase the previously uploaded file and replace it the new
one. If you want to upload multiple files, use the 'mark' word
after upload to prevent deletion:
Now the next 'ul' will erase file2.f before uploading a new
file. To erase files manually, use the 'empty' word.
--- LIVE MODE ONLY ---