1.1 目的
本文件描述了 802.15.4 MAC 软件的应用程序编程接口。API提供了到 802.15.4 协议栈管理和数据服务的接口。
2、API概述
2.1 接口机制
MAC API 使用以下接口机制。
2.1.1 信息传递函数调用
通过给 MAC 事件处理程序发送一个 OSAL 信息,这些 API 函数提供了一个到 MAC的信息传递接口。除非另有说明,本文件描述的 API 函数就是信息传递函数。这些函数不包括关键的部分,也不直接访问 MAC 数据。
2.1.2 直接执行函数调用
这些 API 函数直接执行那些实现一个 MAC 操作的代码。这些函数在调用程序的环境下执行。它们可能有关键的部分,并且可以直接访问 MAC 数据。
2.1.3 回调函数
这些函数必须由应用程序执行,用于从MAC传递事件和数据到应用程序。通过回调函数的参数(比如一个指向数据的指针)进行数据访问仅在该函数执行时有效,当函数返回时不应视为有效。这些函数在MAC的环境下执行。回调函数的执行必须避免使用关键部分和CPU敏感的操作。
2.2 零拷贝数据接口
这个接口用于在 MAC 和应用程序之间发送和接收数据,不需要数据拷贝,即“零拷贝”。这会使 CPU 的执行更有效。但是应用程序在分配和释放数据缓冲区时必须遵守某种规则,如第 4 章所述。