USER’ S MANUAL INtime® 4.0 Software TenAsys Corporation 1400 NW Compton Drive, Suite 301 Beaverton, OR 97006 USA +1 503 748-4720 FAX: +1 503 748-4730 31001-6 [email protected] September 2009 www.tenasys.com September 2009 Copyright © 2009 by TenAsys Corporation. All rights reserved. INtime, iRMX, and TenAsys are registered trademarks of TenAsys Corporation. † All other trademarks, registered trademarks, service marks, and trade names are the property of their respective owners. Before you begin This guide describes INtime® software, both as an extension for Microsoft Windows or as a stand-alone RTOS (Real Time Operating System) running on an Intel architecture PC, that provides the tools you need to create and run real-time (RT) applications— robust, high-performance applications with predictable responses to external events. This guide assumes that you know how to develop programs for Windows and understand RT system concepts. Note In this guide, the term “Windows” means any supported version of Windows. For a complete listing of supported Windows versions, see page 3. About this guide Guide contents This guide introduces you to INtime software: how it makes RT applications possible and how to use the INtime development tools. Use this guide to get acquainted with INtime software, then refer to INtime Help for detailed information about INtime components. For more information about accessing help, see Where to get more information later in this chapter. Note For a quick start, read the following: • Chapter 1, Overview to introduce you to all the basic INtime software concepts and to learn where to find detailed information about INtime software. • Chapter 10, INtime application development, to learn about developing RT applications using INtime software. iii INtime 4.0 Software Part I: Introducing INtime software This part introduces INtime software and explains how INtime software and Windows work together to create RT applications. Chapter Description 1 Overview Describes how INtime software works together with Windows to create and run RT applications, and lists INtime software’s features. It also tells you where to find detailed information about INtime software topics. 2 Understanding INtime Explains how INtime’s RT kernel works with Windows to provide software architecture RT functionality. It also lists and describes INtime components. 3 About INtime software’s Describes the RT kernel and its objects, the basic building blocks RT kernel that application programs manipulate. 4 About RT programming Describes processes unique to RT programming. 5 Designing RT applications Provides general guidelines for RT system design. Part II: Using INtime software This part explains how to start INtime software and how to use the INtime software development tools. Chapter Description 6 Installation Explains how to install and uninstall INtime software. 7 Configuration Describes how to configure INtime software. 8 Connecting to an INtime Explains how to set up an NTX connection to an INtime host or a host runtime system for remote debugging. 9 Operation Describes how to start and run INtime software. Part III: Appendices The appendices provide additional information about INtime software. Appendix Description A INtime software Lists and describes system calls that threads in the RT portion of system calls INtime applications use to communicate with each other and with Windows threads. You can find detailed information, including syntax and parameter values, in INtime Help. B The iwin32 subsystem Describes the iwin32 subsystem, which provides a Win32 API for the INtime kernel. It is a parallel API to the INtime API that makes porting of existing Win32 applications easier. C INtime directory structure Describes the INtime directory structure. D INtime software Lists and describes INtime software program files. components iv Before you begin Appendix Description E Visual Studio debugging for Describes how to upgrade existing INtime projects to use the older INtime projects Visual Studio product and its debugger. F Adding INtime software Lists and describes how to add INtime components to a Windows to an XP Embedded XP Embedded development environment so you can produce XP configuration Embedded images that include these INtime components. G Troubleshooting Lists problems you may encounter while running INtime software, and explains how to avoid or resolve those problems. Glossary The glossary defines terms used to describe INtime software. Notational conventions This manual uses the following conventions: • All numbers are decimal unless otherwise stated. • Bit 0 is the low-order bit. If a bit is set to 1, the associated description is true unless otherwise stated. • Data structures and syntax strings appear in this font. Note Indicates important information about the product. Indicates alternate techniques or procedures that you can use to save time Tip or better understand the product. Indicates potentially hazardous situations which, if not avoided, may result CAUTION in minor or moderate injury, or damage to data or hardware. It may also alert you about unsafe practices. Where to get more information About INtime software You can find out more about INtime software from these sources: • World Wide Web: TenAsys maintains an active site on the World Wide Web. The site contains current information about the company and locations of sales offices, new and existing products, contacts for sales, service, and technical support information. You can also send e-mail to TenAsys using the web site: www.tenasys.com You can contact TenAsys by email: [email protected] You can contact TenAsys technical support by email: v INtime 4.0 Software [email protected] Note When sending e-mail for technical support, please include information about both the hardware and software, including Windows and INtime versions, plus a detailed description of the problem, including how to reproduce it. Requests for sales, service, and technical support information receive prompt response. • INtime Help: Describes INtime software concepts and explains how to use INtime tools. INtime Help includes all system calls, including their syntax which you can cut and paste directly into your code. To access Intime Help, do one of these: • Within Microsoft Visual Studio: INtime content is integrated with the Visual Studio help collections. INtime content may be filtered with the keyword “INtime”. • Within source code: Highlight a system call in your source code, then press F1. Help for that system call displays. • Readme file: Lists features and issues that arose too late to include in other documentation. • Other: If you purchased your TenAsys product from a third-party vendor, you can contact that vendor for service and support. About Windows For more information about Windows operation and program development, see these documents: • Documentation that came with Windows. • Documentation that came with Microsoft Visual Studio. vi Contents Part I Introducing INtime software Chapter 1 Overview How does INtime software work? ........................................................................................ 3 Running an INtime application in conjunction with Windows ................................. 4 Communication between Windows and RT threads ............................................ 4 Considerations for INtime applications running on a single processor PC ......... 5 Considerations for INtime applications running on a multiprocessor PC ........... 6 Developing an INtime application ....................................................................................... 7 Design considerations.................................................................................................... 7 Code development......................................................................................................... 7 Features ................................................................................................................................. 8 Development environment............................................................................................ 8 Wizards ................................................................................................................... 8 Libraries .................................................................................................................. 9 Debuggers................................................................................................................ 9 Sample applications............................................................................................... 10 Runtime environment ................................................................................................... 12 RT enhancements to Windows .............................................................................. 12 Memory protection................................................................................................. 12 “Blue screen” protection........................................................................................ 13 Chapter 2 Understanding INtime software architecture Terminology .......................................................................................................................... 15 How INtime software and Windows work together to run RT applications ...................... 16 Transport mechanisms .................................................................................................. 17 About the OSEM....................................................................................................