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\\ex\\ex1\\syse\\abstract.txt,v $
$Author: aek $
$Revision: 3.1 $
$Date: 2003-06-16 23:31:17-07 $

Abstract file for Salvo MPLAB-C18 on MPLAB v5.x/v6.x 
example projects.

*************************************************************

The examples are for the PIC18C452 on the PICDEM-2 demo
board. The Salvo portions will work on any member of the
PIC18 family.

These Salvo example projects were built using MPLAB-C18 
v2.2 and its associated command-line tools.

The examples follow these naming conventions:

  ex[1-n]lite.pjt/mcp   Salvo Lite project, built with Salvo library
  ex[1-n]le.pjt/mcp     Salvo LE   project, built with Salvo library
  ex[1-n]pro.pjt/mcp    Salvo Pro  project, built with Salvo source
 
Projects are provided for MPLAB v5.5 and later (*.pjt), and 
MPLAB v6.2 and later (*.mcp). The directions below are for 
MPLAB v6.x.
  
Example program ex1 runs on the PIC18C452 and uses the following
features of the Salvo RTOS:

  multitasking with task priorities
  task delays
  binary semaphore events
  waiting with timeouts
  system timer
  idling function
  
ex\ex1 has three tasks and one event. One task simply toggles a
port bit over and over again, one task waits for a binSem to be
signaled before toggling a port bit, and the remaining task
delays itself before signaling a binSem.

The PORT (see main.c) that the task(s) write to is PORTB.

After opening a project or its associated workspace, select 
Project -> Build All. If you have selected a debugger (e.g.
MPLAB-ICE2000), the program will be loaded into memory 
at the end of a successful build. Choose Debugger -> Run to 
run the program. You can set breakpoints in the tasks, watch 
the variable PORTB pins change, etc. as you step through or 
run the application. 

To examine the memory requirements for this Salvo application,
open the .map file in the project folder.

To use the example projects with an alternate processor 
(e.g. the PIC18F452), select a different device (Configure 
-> Select Device) and replace the linker script file with
the one that's appropriate for your device.

Salvo Lite and LE users cannot step through the Salvo services 
contained in the libraries at the source level because the 
Salvo source files are not present in these distributions. 
Salvo Pro users can step through Salvo source code and Salvo 
libraries at the source-code level.

See Pumpkin Application Note AN-12 for more information
on using Salvo with MPLAB-C18.

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