APPLICATION COMMON OPERATING ENVIRONMENT (APPCOE) USER MANUAL Release 1.8 Copyright (c) 2021 MapuSoft Technologies, Inc, Unit 50197 Mobile, AL 36605 www.mapusoft.com Application Common Operating Environment User Manual Table of Contents Chapter 1. About this Guide ............................................................................................. 11 Objectives ........................................................................................................................ 12 Audience .......................................................................................................................... 12 How to Use This Manual ................................................................................................. 12 MapuSoft Technologies and Related Documentation ..................................................... 14 Requesting Support .......................................................................................................... 16 Registering a New Account ...................................................................................................... 16 Submitting a Ticket ................................................................................................................... 16 Live Support.............................................................................................................................. 17 Documentation Feedback................................................................................................. 17 Chapter 2. Introduction to AppCOE ............................................................................... 18 About AppCOE ................................................................................................................ 19 Installing AppCOE........................................................................................................... 20 Uninstalling AppCOE ...................................................................................................... 21 Supported Host Platforms ................................................................................................ 21 Getting a License for AppCOE ........................................................................................ 21 Installing License for AppCOE ....................................................................................... 22 Updating APPCOE .......................................................................................................... 24 Getting Updates for AppCOE ................................................................................................... 24 Updating Software Using Remote Update Site ......................................................................... 25 Updating Software Using Local Update Site ............................................................................ 31 Chapter 3. AppCOE Components .................................................................................... 38 Introduction to AppCOE Components............................................................................. 39 AppCOE Architecture ...................................................................................................... 41 OS Simulator .................................................................................................................... 42 Cross-OS development Platform ..................................................................................... 44 Full Library Package Generator ....................................................................................... 45 Optimized Target Code Generator ................................................................................... 45 Ada-C/C++ Changer ........................................................................................................ 46 App/Platform Profiler ...................................................................................................... 46 Chapter 4. Using OS Simulator ........................................................................................ 47 List of Available OS Simulators ...................................................................................... 49 Host Development Environment...................................................................................... 49 Creating an AppCOE C/C++ Project ............................................................................... 51 AppCOE C/C++ Project Template Files ......................................................................... 58 Host System Configuration .............................................................................................. 61 Creating AppCOE C/C++ Project with Multiple Interfaces ............................................ 62 Adding Source Code Files to AppCOE C/C++Project .................................................... 69 Building Your Project ...................................................................................................... 73 Executing Binary Files ..................................................................................................... 76 Debugging the Demos Supplied by MapuSoft ................................................................ 78 Debugging Using External Console/Terminal ................................................................. 83 Inserting Application Code to Run only on Host Environment ....................................... 88 Updating Project Settings ................................................................................................ 89 Chapter 5. Using OS Changer Porting Kit ...................................................................... 91 About OS Changer ........................................................................................................... 92 Interfaces Available for OS Changer ............................................................................... 93 2 Application Common Operating Environment User Manual Using OS Changer ........................................................................................................... 94 Error Handling ................................................................................................................. 94 Porting VxWorks Applications ........................................................................................ 95 Method 1– Porting a WindRiver Workbench ‘C’ Project ......................................................... 95 Method 2–Porting VxWorks Legacy ‘C’ Code ...................................................................... 101 Porting POSIX/LINUX Legacy ‘C’ Code ..................................................................... 105 Porting Applications from Nucleus PLUS Legacy Code to Target OS ......................... 108 Porting Nucleus Legacy ‘C’ Code ................................................................................. 109 Porting micro-ITRON Legacy ‘C’ Code ....................................................................... 118 Porting Windows Legacy ‘C’ Code ............................................................................... 121 Porting µC/OS Legacy ‘C’ Code ................................................................................... 124 Porting FreeRTOS Legacy ‘C’ Code ............................................................................. 127 Building OS Abstractor Interface Library ..................................................................... 130 Building OS Abstractor Interface Demo Application ............................................................. 130 OS Changer VxWorks Interface .................................................................................... 130 Building OS Changer VxWorks Interface .............................................................................. 130 Building OS Changer VxWorks Interface Library ................................................................. 130 Building OS Changer VxWorks Interface Demo Application ................................................ 130 OS Changer POSIX/LINUX Interface........................................................................... 131 Building OS Changer POSIX/LINUX Interface ..................................................................... 131 Building OS Changer POSIX/LINUX Interface Library ........................................................ 131 Building OS Changer POSIX/LINUX Interface Demo Application ...................................... 131 OS Changer Nucleus Interface ....................................................................................... 131 Building OS Changer Nucleus Interface ................................................................................. 132 Building OS Changer Nucleus Interface Library .................................................................... 132 Building OS Changer Nucleus Interface Demo Application .................................................. 132 OS Changer ThreadX Interface ..................................................................................... 132 Building OS Changer ThreadX Interface ................................................................................ 132 Building OS Changer ThreadX Interface Library ................................................................... 132 Building OS Changer ThreadX Interface Demo Application ................................................. 132 Building OS Changer pSOS Interface ...................................................................................