1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
|
/******************************************************************************
*
* Copyright (c) 1994-1999 Palm Computing, Inc. or its subsidiaries.
* All rights reserved.
*
* File: PalmTypes.h
*
* Description:
* Common header file for all Palm OS components.
* Contains elementary data types
*
* History:
* 10/19/94 Created by Ron Marianetti
* 04/24/97 SCL Changes for PalmOS 2.0 SDK
* 08/21/98 SCL Merged WChar & WCharPtr typedefs from Sumo.
* 07/13/99 bob Created from Common.h, lots of cleanup of types
*
*****************************************************************************/
#ifndef __PALMTYPES_H__
#define __PALMTYPES_H__
/************************************************************
* Environment configuration
*************************************************************/
// <BuildDefaults.h> must be included here, rather than in <PalmOS.h>
// because they must be included for ALL builds.
// Not every build includes <PalmOS.h>.
// To override build options in a local component, include <BuildDefines.h>
// first, then define switches as need, and THEN include <PalmTypes.h>.
// This new mechanism supercedes the old "AppBuildRules.h" approach.
// More details available in <BuildDefaults.h>.
#include <BuildDefaults.h>
/************************************************************
* Useful Macros
*************************************************************/
#if defined(__GNUC__) && defined(__UNIX__) // used to be in <BuildRules.h>
// Ensure that structure elements are 16-bit aligned
// Other [host] development platforms may need this as well...
#ifndef PUBLIC_STUFF_STRIPPED
// DOLATER - Do NOT remove without talking to TLW first!!
#endif // PUBLIC_STUFF_STRIPPED
#pragma pack(2)
#endif
/********************************************************************
* Elementary data types
********************************************************************/
// Determine if we need to define our basic types or not
#ifndef __TYPES__ // (Already defined in CW11)
#ifndef __MACTYPES__ // (Already defined in CWPro3)
#define __DEFINE_TYPES_ 1
#endif
#endif
// Fixed size data types
typedef signed char Int8;
typedef signed short Int16;
typedef signed long Int32;
#if __DEFINE_TYPES_
typedef unsigned char UInt8;
typedef unsigned short UInt16;
typedef unsigned long UInt32;
#endif
// Logical data types
#if __DEFINE_TYPES_
typedef unsigned char Boolean;
#endif
typedef char Char;
typedef UInt16 WChar; // 'wide' int'l character type.
typedef UInt16 Err;
typedef UInt32 LocalID; // local (card relative) chunk ID
typedef Int16 Coord; // screen/window coordinate
typedef void * MemPtr; // global pointer
typedef struct _opaque *MemHandle; // global handle
#if __DEFINE_TYPES_
typedef Int32 (*ProcPtr)();
#endif
/************************************************************
* Useful Macros
*************************************************************/
#define min(a, b) (((a) < (b)) ? (a) : (b))
#define max(a, b) (((a) > (b)) ? (a) : (b))
#define OffsetOf(type, member) ((UInt32) &(((type *) 0)->member))
/************************************************************
* Common constants
*************************************************************/
#ifndef NULL
#define NULL 0
#endif // NULL
#ifndef bitsInByte
#define bitsInByte 8
#endif // bitsInByte
// Include the following typedefs if types.h wasn't read.
#if __DEFINE_TYPES_
#ifdef __MWERKS__
#if !__option(bool)
#ifndef true
#define true 1
#endif
#ifndef false
#define false 0
#endif
#endif
#else
#ifndef __cplusplus
#ifndef true
enum {false, true};
#endif
#endif
#endif
#endif /* __TYPES__ */
/************************************************************
* Misc
*************************************************************/
// Standardized infinite loop notation
// Use in place of while(1), while(true), while(!0), ...
#define loop_forever for (;;)
// Include M68KHwr.h:
#if EMULATION_LEVEL == EMULATION_NONE
#if CPU_TYPE == CPU_68K
#include <M68KHwr.h>
//#pragma warn_no_side_effect on
#endif
#endif
/************************************************************
* Metrowerks will substitute strlen and strcpy with inline
* 68K assembly code. Prevent this.
*************************************************************/
#ifdef __MC68K__
#define _NO_FAST_STRING_INLINES_ 0
#endif
/************************************************************
* Define whether or not we are direct linking, or going through
* traps.
*
* When eumulating we use directy linking.
* When running under native mode, we use traps EXCEPT for the
* modules that actually install the routines into the trap table.
* These modules will set the DIRECT_LINK define to 1
*************************************************************/
#ifndef EMULATION_LEVEL
#error "This should not happen!"
#endif
#ifndef USE_TRAPS
#if EMULATION_LEVEL == EMULATION_NONE
#define USE_TRAPS 1 // use Pilot traps
#else
#define USE_TRAPS 0 // direct link (Simulator)
#endif
#endif
/********************************************************************
* Palm OS System and Library trap macro definitions:
********************************************************************/
#define _DIRECT_CALL(table, vector)
#define _DIRECT_CALL_WITH_SELECTOR(table, vector, selector)
#define _DIRECT_CALL_WITH_16BIT_SELECTOR(table, vector, selector)
#ifndef _STRUCTURE_PICTURES
#define _SYSTEM_TABLE 15
#define _HAL_TABLE 15
#ifdef __GNUC__
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95)
#ifndef _Str
#define _Str(X) #X
#endif
#define _OS_CALL(table, vector) \
__attribute__ ((__callseq__ ( \
"trap #" _Str(table) "; dc.w " _Str(vector))))
#define _OS_CALL_WITH_SELECTOR(table, vector, selector) \
__attribute__ ((__callseq__ ( \
"moveq #" _Str(selector) ",%%d2; " \
"trap #" _Str(table) "; dc.w " _Str(vector))))
#define _OS_CALL_WITH_16BIT_SELECTOR(table, vector, selector) \
__attribute__ ((__callseq__ ( \
"move.w #" _Str(selector) ",-(%%sp); " \
"trap #" _Str(table) "; dc.w " _Str(vector) "; " \
"addq.w #2,%%sp")))
#else
#define _OS_CALL(table, vector) __attribute__ ((systrap (vector)))
#define _OS_CALL_WITH_SELECTOR(table, vector, selector)
#define _OS_CALL_WITH_16BIT_SELECTOR(table, vector, selector)
#endif
#elif defined (__MWERKS__) /* The equivalent in CodeWarrior syntax */
#define _OS_CALL(table, vector) \
= { 0x4E40 + table, vector }
#define _OS_CALL_WITH_SELECTOR(table, vector, selector) \
= { 0x7400 + selector, 0x4E40 + table, vector }
#define _OS_CALL_WITH_16BIT_SELECTOR(table, vector, selector) \
= { 0x3F3C, selector, 0x4E40 + table, vector, 0x544F }
#endif
#else
#define _SYSTEM_TABLE "systrap"
#define _HAL_TABLE "hal"
#define _OS_CALL(table, vector) \
__SPIC__("simple", table, vector, 0)
#define _OS_CALL_WITH_SELECTOR(table, vector, selector) \
__SPIC__("selector", table, vector, selector)
#define _OS_CALL_WITH_16BIT_SELECTOR(table, vector, selector) \
__SPIC__("16bit_selector", table, vector, selector)
#endif
#if EMULATION_LEVEL != EMULATION_NONE
#define _HAL_API(kind) _DIRECT##kind
#define _SYSTEM_API(kind) _DIRECT##kind
#elif USE_TRAPS == 0
#define _HAL_API(kind) _OS##kind
#define _SYSTEM_API(kind) _DIRECT##kind
#else
#define _HAL_API(kind) _OS##kind
#define _SYSTEM_API(kind) _OS##kind
#endif
/************************************************************
* Palm specific TRAP instruction numbers
*************************************************************/
#define sysDbgBreakpointTrapNum 0 // For soft breakpoints
#define sysDbgTrapNum 8 // For compiled breakpoints
#define sysDispatchTrapNum 15 // Trap dispatcher
#ifndef PUBLIC_STUFF_STRIPPED
/* DOLATER:jwm: @@@ move us to CoreTraps.h */
#endif // PUBLIC_STUFF_STRIPPED
#define SYS_TRAP(trapNum) _SYSTEM_API(_CALL)(_SYSTEM_TABLE, trapNum)
#define ASM_SYS_TRAP(trapNum) \
DC.W m68kTrapInstr+sysDispatchTrapNum; \
DC.W trapNum
#endif //__PALMTYPES_H__
|
