UTI移植操作系统接口-20101020-0-zyz

UTI移植操作系统接口

Revision 1.1

Revision History

目录

1 概述 (1)

2 debug (2)

2.1print (2)

3 Memory (2)

3.1Allocate memory (2)

3.2Reallocate memory (3)

3.3Free memory (3)

3.4Set memory (3)

3.5Copy memory (4)

3.6Compare memories (4)

4 Task (4)

4.1Create task (4)

5 Message queue (5)

5.1Create a message queue (5)

5.2Destroy a message queue (5)

5.3Reset a message queue (6)

5.4Claim a message (6)

5.5Free a message (6)

5.6Send a message (7)

5.7Receive a message (7)

6 Semaphore (8)

6.1Create semaphore (8)

6.2Destroy semaphore (8)

6.3Wait a semaphore (8)

6.4Release a semaphore (9)

7 Other OS function (10)

7.1Sleep (10)

1概述

本文描述了UTI移植时的系统接口。

2debug

2.1 print

UTI_SINT32 UDRMPrint(const UTI_CHAR * format, ...);

3Memory

本节描述内存方面的函数。

3.1 Allocate memory

void *UTIMalloc(UTI_UINT32 memSize);

3.2 Reallocate memory

void *UTIReallocMem(void *ptr, UTI_UINT32 memSize);

3.3 Free memory

void UTIFree(void *memAddr);

3.4 Set memory

void *UTIMemSet(void *ptr, UTI_UINT8 val, UTI_UINT32 len);

3.5 Copy memory

void *UTIMemCopy(void *dest, const void *src, UTI_UINT32 len);

3.6 Compare memories

UTI_SINT32 UTIMemCmp(const void *ptr1, const void *ptr2, UTI_UINT32 len);

4Task

本节描述任务进程相关的函数。

4.1 Create task

UTI_SINT32 UTICreateTask(void *ppFunc, void *pID, UTI_UINT32 priority, UTI_UINT32 stackSize);

5Message queue

本节描述消息队列函数。

5.1 Create a message queue

UTI_SINT32 UTIMessageQueueCreate(UTI_UINT32 msgNum, UTI_UINT32 msgUnitSize, UTI_UINT32 *messageQueue);

5.2 Destroy a message queue

UTI_SINT32 UTIMessageQueueDestroy(UTI_UINT32 messageQueue);

5.3 Reset a message queue

UTI_SINT32 UTIMessageQueueReset(UTI_UINT32 messageQueue);

5.4 Claim a message

UTI_SINT32 UTIMessageClaim(UTI_UINT32 messageQueue, UTI_UINT32 waitMilliseconds, void **message);

注意：message是指针的指针，函数使用这个参数得到消息指针，所以在实现的时候要特别注意应该对(*message)赋值为消息指针，而不是直接给message赋值为消息指针。

5.5 Free a message

UTI_SINT32 UTIMessageFree(UTI_UINT32 messageQueue, void *message);

5.6 Send a message

UTI_SINT32 UTIMessageSendToQueue(UTI_UINT32 messageQueue, void *message);

5.7 Receive a message

UTI_SINT32 UTIMessageReceiveFromQueue(UTI_UINT32 messageQueue, UTI_UINT32 waitMilliseconds, void **message);

注意：message是指针的指针，函数使用这个参数得到消息指针，所以在实现的时候要特别注意应该对(*message)赋值为消息指针，而不是直接给message赋值为消息指针。

6Semaphore

本节描述了信号量相关函数。

6.1 Create semaphore

UTI_SINT32 UTISemaphoreCreate(UTI_UINT32 initialCount, UTI_UINT32 *semaphore);

6.2 Destroy semaphore

UTI_SINT32 UTISemaphoreDestroy(UTI_UINT32 semaphore);

6.3 Wait a semaphore

UTI_SINT32 UTISemaphoreWait(UTI_UINT32 semaphore,UTI_UINT32 ms);

6.4 Release a semaphore

UTI_SINT32 UTISemaphoreRelease(UTI_UINT32 semaphore);

7Other OS function 本节描述了其他的操作系统函数。7.1 Sleep

UTI_SINT32 UTISleep(UTI_UINT32 ms);