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\\tut\\tu1\\sysp\\abstract.txt,v $
$Author: aek $
$Revision: 3.6 $
$Date: 2003-07-19 20:12:00-07 $

Abstract file for Salvo IAR PIC18C tutorial projects.

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

See the the Tutorial chapter of the Salvo User Manual for 
an explanation of what the tutorial projects illustrate.

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:

  tu[1-6]lite.pew    Salvo Lite project, built with Salvo library
  tu[1-6]le.pew      Salvo LE   project, built with Salvo library
  tu[1-6]prolib.pew  Salvo Pro  project, built with Salvo library
  tu[1-6]pro.pew     Salvo Pro  project, built with Salvo source
  
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 \salvo\tut\tu1\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 > TMR0IF to force 
a TMR0 interrupt in order to fully simulate the actions of OSTimer() 
and delayed tasks in these tutorials.