System Configuration Guide Release 1.3.9 Copyright (c) 2014 MapuSoft Technologies 1301 Azalea Road Mobile, AL 36693 www.mapusoft.com System Configuration Guide Table of Contents Chapter 1.About this Guide ................................. 6 Objectives ..................................................................................................... 7 Audience ....................................................................................................... 7 Document Conventions ................................................................................ 7 MapuSoft Technologies and Related Documentation .................................. 8 Requesting Support..................................................................................... 10 Registering a New Account ........................................................................................... 10 Submitting a Ticket ....................................................................................................... 10 Live Support Offline ...................................................................................................... 11 Documentation Feedback ........................................................................... 11 Chapter 2.System Configuration ........................ 12 System Configuration ................................................................................. 13 Target OS Selection .................................................................................... 14 OS HOST Selection .................................................................................... 15 Target 64 bit CPU Selection ....................................................................... 15 User Configuration File Location ............................................................... 16 OS Changer Components Selection ........................................................... 17 POSIX OS Abstractor Selection ................................................................. 18 OS Abstractor Process Feature Selection ................................................... 19 OS Abstractor Task-Pooling Feature Selection .......................................... 20 OS Abstractor Profiler Feature Selection ................................................... 22 OS Abstractor Output Device Selection ..................................................... 23 OS Abstractor Debug and Error Checking ................................................. 23 OS Abstractor ANSI API Mapping ............................................................ 24 OS Abstractor External Memory Allocation .............................................. 25 OS Abstractor Resource Configuration ...................................................... 25 OS Abstractor Minimum Memory Pool Block Configuration ................... 28 OS Abstractor Application Shared Memory Configuration ....................... 28 OS Abstractor Clock Tick Configuration ................................................... 30 OS Abstractor Device I/O Configuration ................................................... 31 SMP Flags ..................................................................................................................... 31 OS Abstractor Target OS Specific Notes ................................................... 33 Nucleus PLUS Target .................................................................................................... 33 ThreadX Target.............................................................................................................. 33 Precise/MQX Target ...................................................................................................... 33 Linux Target ............................................................................................... 34 User Vs ROOT Login .................................................................................................... 34 System Resource Configuration .................................................................................... 34 Time Resolution ............................................................................................................ 34 Memory Heap ................................................................................................................ 35 Priority Mapping Scheme .............................................................................................. 35 2 System Configuration Guide Memory and System Resource Cleanup ........................................................................ 35 Single-process Application Exit .................................................................................... 36 Multi-process Application Exit ...................................................................................... 36 Manual Clean-up ........................................................................................................... 36 Multi-process Zombie Cleanup ..................................................................................... 36 Task’s Stack Size ........................................................................................................... 36 Windows Target ......................................................................................... 37 Android Target ........................................................................................... 37 Installing and Building the Android Platform ............................................................... 37 Adding Mapusoft Products to the Android Platform ..................................................... 37 Running the Demos from the Android Emulator ........................................................... 38 QNX Target ................................................................................................ 38 User Vs ROOT Login .................................................................................................... 38 Time Resolution ............................................................................................................ 39 Memory Heap ................................................................................................................ 39 Priority Mapping Scheme .............................................................................................. 39 Memory and System Resource Cleanup ........................................................................ 39 Task’s Stack Size ........................................................................................................... 39 Dead Synchronization Object Monitor .......................................................................... 39 VxWorks Target ......................................................................................... 40 Version Flags ................................................................................................................. 40 Unsupported OS Abstractor APIs .................................................................................. 40 Application Initialization ............................................................................ 42 Example: OS Abstractor for Windows Initialization ................................. 42 Example: POSIX Interface for Windows Target Initialization .................. 45 Runtime Memory Allocations .................................................................... 47 OS Abstractor Interface ................................................................................................. 47 POSIX Interface ............................................................................................................ 48 micro-ITRON Interface ................................................................................................. 48 VxWorks Interface ........................................................................................................ 49 pSOS Interface ............................................................................................................... 49 Nucleus Interface ........................................................................................................... 49 ThreadX Interface .......................................................................................................... 50 OS Abstractor Process Feature ................................................................... 51 Simple (single-process) Versus Complex (multiple-process) Applications52 Memory Usage ........................................................................................... 53 Memory Usage under Virtual memory model based OS ........................... 53 Multi-process Application ............................................................................................. 53 Single-process Application ............................................................................................ 54 Memory Usage under Single memory model based OS ............................. 55 Multi-process Application ............................................................................................. 55 Single-process Application ............................................................................................ 56 Chapter 3: Ada System Configuration ................. 57 Interfacing to C and Machine ..................................................................... 57 Code ............................................................................................................................... 57 Data Layout ..................................................................................................................