abstract.txt

Real Time Operating System for Hi-Tech C compiler.

/************************************************************ 
Copyright (C) 1995-2002 Pumpkin, Inc. and its
Licensor(s). Freely distributable.

$Source: C:\\RCS\\d\\salvo\\demo\\d4\\sysp\\abstract.txt,v $
$Author: aek $
$Revision: 3.1 $
$Date: 2002-08-04 22:44:19-07 $

Abstract file for Salvo demo d4 project and IAR PIC18C.

************************************************************/

Demo d4 is for use on the Microchip PICDEM-2 demonstration
board. Three tasks are running with low, medium and high
priorities. The LED on RB7 flashes at 1Hz -- this is the
high-priority task. The low-priority task rotates a single
LED from RB0 to RB6 and repeats indefinitely. The rate at 
which the LEDs move can be controlled by the potentiometer 
on RA0. Pressing the button on RA1 causes the medium-priority
task to display a binary countdown timer on RB[0..6]. While
it does this, the low-priority task cannot run. The high-
priority is not affected by the other two.

The Salvo tutorial projects for IAR PIC18C EW + C-SPY were 
built using the Full version of the IAR PIC18C C compiler 
and follow these naming conventions:

  d4lite.qpj    Salvo Lite project, built with Salvo library
  d4le.qpj      Salvo LE   project, built with Salvo library
  d4prolib.qpj  Salvo Pro  project, built with Salvo library
  d4pro.qpj     Salvo Pro  project, built with Salvo source
  
The IAR KickStart PIC18C package can build and debug all of the 
Salvo Lite and Salvo LE tutorial projects. The IAR BaseLine or 
Full PIC18C packages are required for the Salvo Pro projects.

After opening a project, select Project > Build All, then 
Project > Debug. This should launch C-SPY. You can 
set breakpoints in the tasks, watch port PORTB change, use the
Profiler, etc. as you step through or run the application. 

To examine CODE, DATA and NEARDATA requirements for this Salvo 
application, open the .map file in the Listings group folder of 
the project window.

These tutorials can be used with any PIC18 variant. To use a 
processor other than the PIC18C452, be sure to change:

  * Project > Options > General > Target > Processor Variant > 18C452
  * Project > Options > XLINK > Include > XCL file name 
     (if overriding default)
  * Project > Options > C-SPY > C-SPY Settings > Sfr description file 
     (if overriding default)
  * #include <io18c452.h> in the project's salvocfg.h
  * #include <io18c452.h> in the project's main.h
	
to the filenames appropriate for your PIC18 PICmicro(R) MCU.

Salvo Lite and LE libraries do not contain source-level 
debugging information. Therefore you cannot step through their
Salvo services at the source level. Salvo Pro libraries are
built with embedded debugging information, allowing you to 
step through Salvo libraries at the source level. If you
installed Salvo into a directory other than c:\salvo, you may
need to steer C-SPY to your salvo\src directory when prompted.

Select Project > Options > C-SPY > C-SPY Settings > Driver >
ICE2000 Simulator if you prefer to run on real hardware instead 
of in the simulator. Realtime mode should be used.

C-SPY does not simulate the PIC18's timer interrupts. Therefore
you'll need to use Control > Interrupt > Vector > TMR2IF to force 
a TMR2 interrupt in order to fully simulate the actions of OSTimer() 
and delayed tasks in these tutorials.