SimpliciTI应用程序接口.PDF

SimpliciTI应用程序接口 文档编号: SWRA221 美国加利福尼亚州圣迭哥德州仪器有限公司 版本号 说明 日期 1.0 最初版本 2008/08/01 1.1 更新到1.1.0版本 2009/01/14 1.2 最新的修改记录 2009/03/24 1 绪论 1.1 目的 本文档描述了SimpliciTI 软件的应用程序接口。应用程序接口给SimpliciTI 协 议栈工作提供了一个接口。 1.2 参考书目 1． SimpliciTI1.1.0 版本说明书。 2 ． SimpliciTI 开发者注意事项。 1.3 字体使用 一些专用的字体： 字体 用法 常规字体 用于文件名、代码段、符号和代码示例。 带下划线的蓝色正文 文件交叉引用链接 1.4 缩略语和定义 API 应用程序编程接口。 BSP 板级支持包 CCA 清除信道评估 GPIO 通用输入输出 ISR 中断服务例程 LED 发光二极管 LQI 链接情况指示 LRU 最近应用 MAC 介质访问控制。 PHY 物理层。 RSSI 接收信号强度指示器 2 应用程序接口概述 2.1 接口机制 下面的接口机制应用于SimpliciTI 的应用程序接口。 2.1.1 直接执行函数调用 这些应用程序接口函数直接执行代码进行工作，函数在执行时联系前后调用， 这些函数可能有鉴定识别的部分。 2.1.2 回调函数 在SimpliciTI 协议中又一次随意回调的机会，这样的函数必须在应用中定义和 执行，并且在初始化时要声明。在运行中断程序时,函数回调的实现应避免CPU 强 制操作，这一函数将在第7 部分做详细的描述。 2.2 数据接口 这些接口支持SimpliciTI 协议栈和应用程序之间的发送和接收数据,并最终支 持点对点通讯。 2.3 普通常量和结构体 2.3.1 公共数据类型 下面定义： typedef signed char int8_t； typedef signed short int16_t； typedef signed long int32_t； typedef unsigned char uint8_t; typedef unsigned short uint16_t ； typedef unsigned long uint32_t ； typedef unsigned char linkID_t； typedef enum smplStatus smplStatus_t； 另外一些类型和结构体用于IOCTL 接口，这些将在第6 部分中详细说明。 2.3.2 状态 下列状态值用于各种API 函数。这些都是Status_t 类型的值。每个API 象征 的相应的返回代码将会在后续章节中详细说明。 名称 描述 SMPL_SUCCESS