SimpliciTIAPI使用指南英文翻譯.docx

SimpliciTI应用程序接口文档编号: SWRA221美国加利福尼亚州圣迭哥德州仪器有限公司版本号说明日期1.0最初版本2008/08/011.1更新到1.1.0版本2009/01/141.2最新的修改记录2009/03/241 绪论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 公共数据类型下面定义：typedefsigned char int8_t；typedefsigned short int16_t；typedefsigned long int32_t；typedefunsigned charuint8_t;typedefunsigned short uint16_t；typedefunsigned long uint32_t；typedefunsigned char linkID_t；typedefenum smplStatus smplStatus_t；另外一些类型和结构体用于IOCTL接口，这些将在第6部分中详细说明。2.3.2 状态下列状态值用于各种API函数。这些都是Status_t类型的值。每个API象征的相应的返回代码将会在后续章节中详细说明。名称描述SMPL_SUCCESS操作成功SMPL_TIMEOUT同步调用超时SMPL_BAD_PARAM在调用错误的参数值SMPL_NOMEM无可用内存。依赖于对象的APISMPL_NO_FRAME在输入帧队列中没有可用帧SMPL_NO_LINK没有收到答复的链接帧发送SMPL_NO_JOIN没有收到答复加入帧发送SMPL_NO_CHANNEL频道扫描没有1个通道响应SMPL_NO_PEER_UNLINK同行无法删除连接。在答复信息返回到中断请求（不正式支持）SMPL_TX_CCA_FAIL帧传输失败，因为清除信道评估失败SMPL_NO_PAYLOAD收到帧但没有得到有效载荷应用SMPL_NO_AP_ADDRESS我们没有收到一个接入点的地址2.3.3 专用链接标识SimpliciTI协议支持由应用程序默认的专用链接标识，下面的值表示的专用链接标识。名称描述SMPL_LINKID_USER_UUD未连接的用户数据链路标识。这是一个专用的，无连接链路的编号，它默认被所有用户应用程序所支持。3 初始化接口3.1 简介SimpliciTI初始化涉及三个初始化阶段：板级、无线和堆栈初始化，并特意把板级初始化（BSP）与无线和堆栈初始化分开：无线和堆栈的初始化作为SimpliciTI初始化调用的结果同时发生；板级初始化可以单独地调用。我们可以不考虑SimpliciTI API部分，但还是要注意到初始化的完整性。把板级的初始化分离开来，这样做是为了客户可以使用自己的目标设备的BSP。使板级的初始化明确与SimpliciTI初始化分开，可以更容易地移植到另一个目标设备。3.1.1 板级初始化SimpliciTI支持最小板级特定的板级初始化，板级初始化包括LED的GPIO引脚配置、开关配置和一个服务协议事务的计数器/定时器，它还包括双核射频设计需要的SPI初始化。3.1.2 无线初始化无线寄存器的改写和无线模块的设置都发生在供电、空闲状态。大部分无线寄存器都是基于SmartRF Studio输出代码，并且默认的通道设置在频道表的第一项。3.1.3 堆栈初始化 初始化所有的数据结构和网络应用程序，此外，该堆栈产生一个代表该设备的加入请求，在