Salvo User Manual

8/8/2019 Salvo User Manual

1/528

8/8/2019 Salvo User Manual

2/528

(inside front cover)

8/8/2019 Salvo User Manual

3/528

User Manualversion 4.2.2

for all distributions

8/8/2019 Salvo User Manual

4/528

8/8/2019 Salvo User Manual

5/528

Quick Start Guide

Thanks for purchasing Salvo, The RTOS that runs in tiny places.Pumpkin is dedicated to providing powerful, efficient and low-costembedded programming solutions. We hope you'll like what we'vemade for you.

If this is the first time you've encountered Salvo, please reviewChapter 1 Introduction to get a flavor for what Salvo is, what itcan do, and what other tools you'll need to use it successfully. SeeChapter 2 RTOS Fundamentals if you haven't used an RTOSbefore. Then try the steps below in the order listed.

Note You don't need to purchase Salvo to run the demo pro-grams, try the tutorial or use the freeware libraries to build yourown multitasking Salvo application they're all part of Salvo Lite,the freeware version of Salvo.

Running on Your Hardware

If you have a compatible target environment, you can run one of

the standalone Salvo example applications contained in Pump-

kin\Salvo\Example on your own hardware. Open the demo's pro-

ject, build it, download or program it into your hardware, and let itrun. Most demo programs provide real-time feedback. If it's aSalvo Lite demo and uses commonly available hardware, you caneven build your own application by modifying the source and re-building it.

See Appendix C File and Program Descriptions for more infor-mation on the demo programs.

Trying the Tutorial

Chapter 4 Tutorialbuilds a multitasking, event-driven Salvo ap-plication in six easy steps. The tutorial will familiarize you withSalvo's terminology, user services, and the process of building aworking application. A set of tutorial projects is included withevery Salvo distribution for embedded targets, enabling you tobuild each tutorial application by simply loading and building theproject in the appropriate development environment.

8/8/2019 Salvo User Manual

6/528

Salvo Lite

A compiler that's certified for use with Salvo is all you need to useSalvo Lite, the freeware version of Salvo. You can write your own,small multitasking application with calls to Salvo services and linkit to the freeware libraries. See Chapter 4 Tutorialand the SalvoApplication Notefor your compiler and/or target for more informa-tion.

Salvo LE

Salvo LE adds the standard Salvo libraries to Salvo Lite. Thismeans that the numbers of tasks, events, etc. in your applicationare limited only by the available RAM.

Salvo Pro

With Salvo Pro, you'll have full access to all its source code, stan-dard libraries, test programs and priority support. If you haven'tdone so already, try the tutorial in Chapter 4 Tutorialas a firststep towards creating your own application. Then use the configu-ration options in Chapter 5 Configuration and the services out-lined in Chapter 7 Reference, along with their examples, to fine-tune Salvo to your application's requirements. If you run into prob-lems or have questions, you'll find lots of useful information in

Chapter 6 Frequently Asked Questions (FAQ) and Chapter 11 Tips, Tricks and Troubleshooting.

Getting Help

Some of the best resources for new and experienced Salvo usersare the Salvo User Forums, hosted on Pumpkin's web site,http://www.pumpkininc.com/. Check there for up-to-date informa-tion on the latest Salvo releases.

8/8/2019 Salvo User Manual

7/528

Contact Information & TechnicalSupport

Contacting Pumpkin

Pumpkin's mailing address and phone and fax numbers are:

Pumpkin, Inc.750 Naples StreetSan Francisco, CA 94112 USAtel: 415-584-6360fax: 415-585-7948

[email protected]@[email protected]

Time Zone: GMT0800 (Pacific Standard Time)

Connecting to Pumpkin's Web Site

Use your web browser to access the Pumpkin web site at

http://www.pumpkininc.com/

Information available on the web site includes

Latest News Software Downloads & Upgrades User Manuals Compiler Reference Manuals Application Notes

Assembly Guides Release Notes User Forums

8/8/2019 Salvo User Manual

8/528

Salvo User Forums

Pumpkin maintains User Forums for Salvo at Pumpkin's web site.The forums contain a wealth of practical information on usingSalvo, and is visited by Salvo users as well as Pumpkin technicalsupport.

How to Contact Pumpkin for Support

Pumpkin provides online Salvo support via the Salvo Users Fo-rums on the Pumpkin World Wide Web (WWW) site. Files andinformation are available to all Salvo users via the web site. Toaccess the site, you'll need web access and a browser (e.g. Net-scape, Opera, Internet Explorer).

Internet (WWW)

The Salvo User Forums are located at:

http://www.pumpkininc.com

and are the preferred method for you to post your pre-sales, gen-eral or technical support questions.

Email

Normally, we ask that you post your technical support questions tothe Salvo User Forums on our website. We monitor the forums andanswer technical support questions on-line.

In an emergency, you can reach technical support via email:

[email protected]

We will make every effort to respond to your email requests fortechnical support within 1 working day. Please be sure to provide

as much information about your problem as possible.

Mail, Phone & Fax

If you were unable to find an answer to your question in this man-ual, check the Pumpkin website and the Salvo user Forums (see below) for additional information that may have been recently

8/8/2019 Salvo User Manual

9/528

posted. If you are still unable to resolve your questions, please con-tact us directly at the numbers above.

What To Provide when Requesting Support

Registered users requesting Salvo technical support should supply:

The Salvo version number The compiler name and version number The user's source code snippet(s) in question

The user's salvocfg.h file All other relevant files, details, etc.

Small code sections can be posted directly to the Salvo User Fo-rums see the on-line posting FAQ on how to use the UBB code

tags ([code] and [/code]) to preserve the code's formatting andmake it more legible.

If the need arises to send larger code sections, or even a complete,buildable project, please compress the files and email them directlyto Salvo Technical support (see below). Please be sure to provideall necessary files to enable Technical Support to build your Salvoapplication locally in an attempt to solve your problem. Keep inmind that without the appropriate target system hardware, supportin these cases is generally limited to non-runtime problem solving.Technical Support will keep all user code in strictest confidence.

8/8/2019 Salvo User Manual

10/528

8/8/2019 Salvo User Manual

11/528

Salvo User Manual

Copyright 1995-2010 by Pumpkin, Inc.

All rights reserved worldwide. No part of this publication may be reproduced, stored in a retrieval system, or trans-mitted in any form or by any means, electronic, mechanical, photocopying, recording or otherwise, without priorpermission of Pumpkin, Inc.

Pumpkin, Inc.750 Naples StreetSan Francisco, CA 94112 USA

tel: 415-584-6360fax: 415-585-7948web: www.pumpkininc.comemail: [email protected]

DisclaimerPumpkin, Incorporated ("Pumpkin") has taken every precaution to provide complete and accurate information in this

document. However, due to continuous efforts being made to improve and update the product(s), Pumpkin and itsLicensor(s) shall not be liable for any technical or editorial errors or omissions contained in this document, or forany damage, direct or indirect, from discrepancies between the document and the product(s) it describes.

The information is provided on an as-is basis, is subject to change without notice and does not represent a commit-ment on the part of Pumpkin, Incorporated or its Licensor(s).

TrademarksThe Pumpkin name and logo, the Salvo name and logo, the CubeSat Kit name and logo, "The RTOS that runs in tinyplaces." and "Dont leave Earth without It." are trademarks of Pumpkin, Incorporated.

The absence of a product or service name or logo from this list does not constitute a waiver of Pumpkin's trademark

or other intellectual property rights concerning that name or logo.

All other products and company names mentioned may be trademarks of their respective owners. All words andterms mentioned that are known to be trademarks or service marks have been appropriately capitalized. Pumpkin,Incorporated cannot attest to the accuracy of this information. Use of a term should not be regarded as affecting thevalidity of any trademark or service mark.

This list may be partial.

Patent InformationThe software describe