📄 nucleus.h
字号:
/*************************************************************************/
/* */
/* Copyright (c) 1993-1994 Accelerated Technology, Inc. */
/* */
/* PROPRIETARY RIGHTS of Accelerated Technology are involved in the */
/* subject matter of this material. All manufacturing, reproduction, */
/* use, and sales rights pertaining to this subject matter are governed */
/* by the license agreement. The recipient of this software implicitly */
/* accepts the terms of the license. */
/* */
/*************************************************************************/
/*************************************************************************/
/* */
/* FILE NAME VERSION */
/* */
/* nucleus.h PLUS/68HC11/I 1.2 */
/* */
/* COMPONENT */
/* */
/* System Constants */
/* */
/* DESCRIPTION */
/* */
/* This file contains system constants common to both the */
/* application and the actual Nucleus PLUS components. This file */
/* also contains data structure definitions that hide internal */
/* information from the application. */
/* */
/* AUTHOR */
/* */
/* William E. Lamie, Accelerated Technology, Inc. */
/* */
/* DATA STRUCTURES */
/* */
/* NU_DRIVER I/O Driver control block */
/* NU_EVENT_GROUP Event group control block */
/* NU_HISR HISR control block */
/* NU_MAILBOX Mailbox control block */
/* NU_MEMORY_POOL Memory Pool control block */
/* NU_PARTITION_POOL Partition Pool control block */
/* NU_PIPE Pipe control block */
/* NU_QUEUE Queue control block */
/* NU_SEMAPHORE Semaphore control block */
/* NU_TASK Task control block */
/* NU_TIMER Timer control block */
/* NU_PROTECT Protection structure */
/* */
/* FUNCTIONS */
/* */
/* None */
/* */
/* DEPENDENCIES */
/* */
/* None */
/* */
/* HISTORY */
/* */
/* NAME DATE REMARKS */
/* */
/* W. Lamie 08-09-1993 Created initial version 1.0 */
/* D. Lamie 08-09-1993 Verified version 1.0 */
/* K. Homer 03-01-1994 Added logic to use the actual */
/* Nucleus PLUS data structures */
/* when NU_DEBUG flag is turned */
/* on, changed various function */
/* names due to re-organization */
/* of various files, added */
/* register variable capability, */
/* added two interrupt functions, */
/* and general cleanup, */
/* resulting in version 1.1 */
/* D. Lamie 03-18-1994 Verified version 1.1 */
/* K. Homer 10-20-1994 Added #ifdef for C++ */
/* resulting in version 1.1a */
/* D. Lamie 10-25-1994 Verified version 1.1a */
/* U. Pollock 03-22-1996 Changed TCF_Current_HISR_Pointer */
/* to TCC_Current_HISR_Pointer in */
/* function mappings, */
/* Changed MBC_Mailbox_Pointers to */
/* NU_Mailbox_Pointers in */
/* function prototype list, */
/* resulting in version 1.1+2 */
/* (spr 40,51) */
/* M. Trippi 06-12-1996 Released version 1.2 */
/* */
/*************************************************************************/
/* Check to see if this file has been included already. */
#ifndef NUCLEUS
#ifdef __cplusplus
extern "C" { /* C declarations in C++ */
#endif
#define NUCLEUS
/* Define standard data types. These definitions allow Nucleus PLUS to
perform in the same manner on different target platforms. */
typedef unsigned long UNSIGNED;
typedef long SIGNED;
typedef unsigned char DATA_ELEMENT;
typedef DATA_ELEMENT OPTION;
typedef int STATUS;
typedef unsigned char UNSIGNED_CHAR;
typedef char CHAR;
typedef int INT;
typedef void VOID;
typedef unsigned long * UNSIGNED_PTR;
typedef unsigned char * BYTE_PTR;
/* Define register defines. R1, R2, R3, and R4 are used in the Nucleus PLUS
source code in front of variables that are referenced often. In some
ports, defining them as "register" will improve performance. */
#define R1 register
#define R2 register
#define R3 register
#define R4 register
/* Define the number of accesses required to read or write a pointer data
type. This value is used to make optimizations in some ports of Nucleus
PLUS. */
#define NU_POINTER_ACCESS 1
/* Define the padding required for usage of the DATA_ELEMENT type within
Nucleus PLUS structures. These values insure proper alignment for the
next structure member. */
#define PAD_1 1
#define PAD_2 0
#define PAD_3 1
/* Define constants that are target dependent and/or are used for internal
purposes. */
#define NU_MIN_STACK_SIZE 40
#define NU_MAX_NAME 8
#define NU_MAX_VECTORS 21
#define NU_MAX_LISRS 30
/* Define constants for the number of UNSIGNED words in each of the basic
system data structures. */
#define NU_TASK_SIZE 31
#define NU_HISR_SIZE 18
#define NU_MAILBOX_SIZE 11
#define NU_QUEUE_SIZE 13
#define NU_PIPE_SIZE 13
#define NU_SEMAPHORE_SIZE 8
#define NU_EVENT_GROUP_SIZE 7
#define NU_PARTITION_POOL_SIZE 12
#define NU_MEMORY_POOL_SIZE 13
#define NU_TIMER_SIZE 13
#define NU_PROTECT_SIZE 2
#define NU_DRIVER_SIZE 2
/* Define what an interrupt vector looks like on the target processor. */
typedef struct NU_VECTOR_STRUCT
{
VOID *pointer;
} NU_VECTOR;
/* Define constants for use in service parameters. */
#define NU_AND 2
#define NU_AND_CONSUME 3
#define NU_DISABLE_TIMER 4
#define NU_ENABLE_TIMER 5
#define NU_FALSE 0
#define NU_FIFO 6
#define NU_FIXED_SIZE 7
#define NU_NO_PREEMPT 8
#define NU_NO_START 9
#define NU_NO_SUSPEND 0
#define NU_NULL 0
#define NU_OR 0
#define NU_OR_CONSUME 1
#define NU_PREEMPT 10
#define NU_PRIORITY 11
#define NU_START 12
#define NU_SUSPEND 0xFFFFFFFFUL
#define NU_TRUE 1
#define NU_VARIABLE_SIZE 13
/* Define interrupt lockout and enable constants. */
#define NU_DISABLE_INTERRUPTS 1
#define NU_ENABLE_INTERRUPTS 0
/* Define task suspension constants. */
#define NU_DRIVER_SUSPEND 10
#define NU_EVENT_SUSPEND 7
#define NU_FINISHED 11
#define NU_MAILBOX_SUSPEND 3
#define NU_MEMORY_SUSPEND 9
#define NU_PARTITION_SUSPEND 8
#define NU_PIPE_SUSPEND 5
#define NU_PURE_SUSPEND 1
#define NU_QUEUE_SUSPEND 4
#define NU_READY 0
#define NU_SEMAPHORE_SUSPEND 6
#define NU_SLEEP_SUSPEND 2
#define NU_TERMINATED 12
/* Define service completion status constants. */
#define NU_SUCCESS 0
#define NU_END_OF_LOG -1
#define NU_GROUP_DELETED -2
#define NU_INVALID_DELETE -3
#define NU_INVALID_DRIVER -4
#define NU_INVALID_ENABLE -5
#define NU_INVALID_ENTRY -6
#define NU_INVALID_FUNCTION -7
#define NU_INVALID_GROUP -8
#define NU_INVALID_HISR -9
#define NU_INVALID_MAILBOX -10
#define NU_INVALID_MEMORY -11
#define NU_INVALID_MESSAGE -12
#define NU_INVALID_OPERATION -13
#define NU_INVALID_PIPE -14
#define NU_INVALID_POINTER -15
#define NU_INVALID_POOL -16
#define NU_INVALID_PREEMPT -17
#define NU_INVALID_PRIORITY -18
#define NU_INVALID_QUEUE -19
#define NU_INVALID_RESUME -20
#define NU_INVALID_SEMAPHORE -21
#define NU_INVALID_SIZE -22
#define NU_INVALID_START -23
#define NU_INVALID_SUSPEND -24
#define NU_INVALID_TASK -25
#define NU_INVALID_TIMER -26
#define NU_INVALID_VECTOR -27
#define NU_MAILBOX_DELETED -28
#define NU_MAILBOX_EMPTY -29
#define NU_MAILBOX_FULL -30
#define NU_MAILBOX_RESET -31
#define NU_NO_MEMORY -32
#define NU_NO_MORE_LISRS -33
#define NU_NO_PARTITION -34
#define NU_NOT_DISABLED -35
#define NU_NOT_PRESENT -36
#define NU_NOT_REGISTERED -37
#define NU_NOT_TERMINATED -38
#define NU_PIPE_DELETED -39
#define NU_PIPE_EMPTY -40
#define NU_PIPE_FULL -41
#define NU_PIPE_RESET -42
#define NU_POOL_DELETED -43
#define NU_QUEUE_DELETED -44
#define NU_QUEUE_EMPTY -45
#define NU_QUEUE_FULL -46
#define NU_QUEUE_RESET -47
#define NU_SEMAPHORE_DELETED -48
#define NU_SEMAPHORE_RESET -49
#define NU_TIMEOUT -50
#define NU_UNAVAILABLE -51
/* Define system errors. */
#define NU_ERROR_CREATING_TIMER_HISR 1
#define NU_ERROR_CREATING_TIMER_TASK 2
#define NU_STACK_OVERFLOW 3
#define NU_UNHANDLED_INTERRUPT 4
/* Define I/O driver constants. */
#define NU_IO_ERROR -1
#define NU_INITIALIZE 1
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -