OSAL-API中文版.pdf

OS抽象层

应用程序接口

文件编号：SWRA194

德州仪器

圣迭戈，加利福尼亚州美国

目录

1.简介 .............................................................................................................................. 2

1.1目的.............................................................................................................................2

3.2 osal_msg_allocate（） ................................................................................................ 4

3.3 osal_msg_deallocate（） ............................................................................................ 4

3.4 osal_msg_send（） ...................................................................................................... 4

3.5 osal_msg_receive（ ...................................................................................................... 5

3.6 osal_msg_find（） ........................................................................................................5

4，任务同步API .................................................................................................................6

4.1简介.................................................................................................................................6

4.2 osal_set_event（） .........................................................................................................6

5.定时器管理API ................................................................................................................6

5.1简介..................................................................................................................................6

6.2 osal_int_enable（） ......................................................................................................9

6.3 osal_int_disable（） .....................................................................................................9

7.任务管理API .................................................................................................................10

7.1简介...............................................................................................................................10

7.2 osal_init_system（） ..................................................................................................10

7.3 osal_start_system（） ..................................................................................................11

7.4 osal_run_system（） ....................................................................................................11

7.5 osal_self（） ..............................................................................................................11

8.内存管理API ................................................................................................................12

8.1简介..............................................................................................................................12

9.2 osal_pwrmgr_init（） ..............................................................................................13

9.3 osal_pwrmgr_powerconserve（） ...........................................................................14

9.4 osal_pwrmgr_device（） .........................................................................................14

9.5 osal_pwrmgr_task_state（） ....................................................................................14

10.非挥发性内存API .....................................................................................................15

10.1简介.........................................................................................................................15

10.2 osal_nv_item_init（） ...........................................................................................16

10.3 osal_nv_read（） ....................................................................................................17

11.2 osal_snv_read（） ....................................................................................................20

11.3 osal_snv_write（） ...................................................................................................20

12. OSAL时钟系统 ..........................................................................................................21

12.1简介...........................................................................................................................21

12.2 osalTimeUpdate（） ...............................................................................................21

12.3 osal_setClock（） ...................................................................................................22

12.4 osal_getClock（） ...................................................................................................22

12.5 osal_ConvertUTCTime（） ....................................................................................22

12.6 osal_ConvertUTCSecs（） .....................................................................................23

13. OSAL杂项 ................................................................................................................23

本文件的目的是定义在OS抽象层（OSAL）的API。这个API允许的TI堆叠产品的软件组件

，例如Z-

堆栈™，的RemoTI™和BLE，可以独立于操作系统的具体的书面，内核或任务环境（包括控

制回路或连接-于─中断系统）

1.2适用范围

实现它们。

1.3缩略语

API应用程序接口 BLE蓝牙低能量 NV非易失

OSAL操作系统（OS）抽象层 RF4CE射频消费电子

的RemoTI德州仪器（TI）的RF4CE协议栈 的Z-Stack德州仪器ZigBee协议栈

2，API概述 2.1概述

理环境的以下功能。

5.计时器

6.内存分配

消息管理API提供了一种机制用于交换具有不同处理环境的任务或处理元件之间的消息（

要将此功能与osal_mem_alloc（），这个函数是用来分配一个缓冲区的任务之间发送消息[

使用osal_msg_send（）。使用osal_mem_alloc（）分配的内存块。

3.2.2原型

UINT8 * osal_msg_allocate（UINT16 LEN）

3.2.3详细参数

len是这个消息的长度。

3.2.4返回

返回值是一个指向分配给消息的缓冲区。返回NULL表示信息分配操作失败。

3.3 osal_msg_deallocate（）

此功能用于解除分配的消息缓冲器。这个功能是由一个任务（或处理元件）称为后处理完

接收到的消息。

3.3.2原型

UINT8 osal_msg_deallocate（UINT8 * msg_ptr）

3.3.3详细参数

msg_ptr是指向需要被解除分配的消息缓冲器。

3.3.4返回

返回值指示该操作的结果。 返回值 说明

SUCCESS 德分配成功

3.4 osal_msg_send（）

3.4.1简介

所述osal_msg_send函数由一个任务发送一个命令或数据消息到另一任务或处理元件。该des

tination_task标识符字段必须指向一个有效的系统任务。该osal_msg_send（）函数也将设置

目标任务事件列表中的SYS_EVENT_MSG事件。

3.4.2原型

UINT8 osal_msg_send（UINT8 destination_task，UINT8 * msg_ptr）

3.4.3详细参数

destination_task是任务的ID来接收该消息。

msg_ptr是指向包含消息的缓冲器。

3.5 osal_msg_receive（）

3.5.1简介

该功能称为由任务来检索接收的命令消息。使用osal_msg_deallocate（）调用处理消息后，

3.5.2原型

UINT8 * osal_msg_receive（UINT8 TASK_ID）

3.5.3详细参数

TASK_ID是调用任务（该消息注定）的标识。

3.5.4返回

3.6.1简介

此功能搜索现有的OSAL信息匹配TASK_ID和事件的参数。

3.6.2原型

osal_event_hdr_t * osal_msg_find（UINT8 TASK_ID，UINT8 event）

3.6.3详细参数

TASK_ID是标识符的入队OSAL信息必须匹配。 事件是OSAL事件ID的入队OSAL信息必须

4，任务同步API

4.1简介

这个API使得任务等待事件的发生，控制返回在等待。该API中的函数可以被用来设置为任

4.2 osal_set_event（）

4.2.1简介

这个函数被调用来设置事件标志的任务。

4.2.2原型

4.2.4返回

返回值指示该操作的结果。 返回值 说明

SUCCESS 成功

INVALID_TASK 无效的任务

5.定时器管理API

5.1简介

该API允许通过内部（TI堆栈）的任务和外部的（应用层）任务使用定时器。该API提供的

功能来启动和停止计时器。该定时器可在1millisecond的增量进行设置。