Embedded SDK(Software Development Kit)Programmer’s Guide.pdf

© Motorola, Inc., 2001. All rights reserved.

Semiconductor Products Sector

Embedded SDK

(Software Development Kit)

Programmer’s Guide

SDK122/D

Rev. 1.6, 08/16/2001

OnCE™ is a trademarks of Motorola, Inc.

This document contains information on a new product. Specifications and information herein are subject to change without notice.

applications intended to support or sustain life, or for any other application in which the failure of the Motorola product could create a situation where personal injury

or death may occur. Should Buyer purchase or use Motorola products for any such unintended or unauthorized application, Buyer shall indemnify and hold Motorola

arising out of, directly or indirectly, any claim of personal injury or death associated with such unintended or unauthorized use, even if such claim alleges that

Motorola was negligent regarding the design or manufacture of the part. Motorola and

1.2.3 SDK Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

1.2.3.1 Board Support Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

1.2.3.2 Interrupt Handling. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

1.2.3.3 Memory Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

1.2.3.4 Input/Output (I/O). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4

1.2.3.5 Timers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-4

1.2.4 SDK Rules and Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5

1.3 Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-5

2.3 Creating a New SDK Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-4

2.3.1 Embedded SDK Stationery. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6

2.3.2 SDK Configuration files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7

2.3.3 SDK Project Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8

2.3.4 Steps to Create a New Project. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8

3.1 Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1

3.1.1 Use of C Language . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-1

3.2.1.3 Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-5

3.2.2 Formatting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.2.3 Entry/Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.2.4 Conditional Compilation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.2.5 Self Modification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.2.6 Source Statements per Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.2.7 Fractional Arithmetic Calculations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.2.8 Reserve Word Redefinition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-6

3.2.9 Recursion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7

3.2.10 Data Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-7

3.2.16.1 File Headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-8

3.2.16.2 Function Headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-8

3.2.17 Data Typing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9

3.2.18 Portability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9

3.2.19 Macro Usage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9

3.2.20 Compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9

3.2.21 Reentrancy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-10

3.2.22 Interrupt Handlers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-10

3.2.23 Code Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-10

5.1 System Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-1

5.1.1 Basic Data Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-2

5.1.2 Architecture Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4

5.1.2.1 Architecture Services Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4

5.1.2.2 Architecture Services Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12

5.1.2.3 ArchIO - Architecture I/O Registers. . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-13

5.1.2.4 pArchInterrupts - Architecture Interrupts. . . . . . . . . . . . . . . . . . . . . . . . .5-14

5.1.2.5 archDelay - Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-15

5.1.2.6 archDisableInt - Disable Interrupts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-16

5.1.2.7 archEnableInt - Enable Interrupts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-17

5.1.2.14 archRemoveFastISR - Uninstall Fast ISR . . . . . . . . . . . . . . . . . . . . . . . .5-24

5.1.2.15 archRemoveSFastISR - Uninstall Super Fast ISR . . . . . . . . . . . . . . . . . .5-25

5.1.2.16 archResetLimitBit - Reset Limit Bit. . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-26

5.1.2.17 archSet2CompRound - Set Two’s-Complement Rounding Mode . . . . . .5-27

5.1.2.18 archSetConvRound - Set Convergent Rounding Mode . . . . . . . . . . . . . .5-28

5.1.2.19 archSetNoSat - Set No Saturation Mode . . . . . . . . . . . . . . . . . . . . . . . . .5-29

5.1.2.20 archSetSat32 - Set Saturation Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-30

5.1.2.21 archStart - Entry Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-31

5.1.2.22 archStop - Stop Processing State . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-32

5.1.2.23 archTrap - Software Trap State. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-33

5.1.3.5 bitSet - Set Selected Bits. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-39

5.1.3.6 bitTestHigh - Test Bit-field High . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-40

5.1.3.7 bitTestLow - Test Bit-field Low. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-41

5.1.3.8 bitWordClear - Clear Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-42

5.1.3.9 bitWordSet - Set Word . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-43

5.1.4 I/O Services. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-44

5.1.4.1 I/O Services Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-44

5.1.4.2 I/O Services Specifications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-47

5.1.4.3 open. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-48

5.1.4.4 close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-49

5.1.5.3 Timer Services Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-60