Apr 09, 2018
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.
http://www.pumpkininc.com/http://www.pumpkininc.com/http://www.pumpkininc.com/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
mailto:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]://www.pumpkininc.com/http://www.pumpkininc.com/http://www.pumpkininc.com/mailto:[email protected]:[email protected]:[email protected]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.
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:
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
http://www.pumpkininc.com/cgi-bin/Ultimate.cgi?action=introhttp://www.pumpkininc.com/cgi-bin/Ultimate.cgi?action=intromailto:[email protected]:[email protected]:[email protected]://www.pumpkininc.com/cgi-bin/Ultimate.cgi?action=intro8/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