立即注册
查看: 1281|回复: 4

[资料] 802.15.4 MAC应用程序编程接口

已绑定手机
发表于 2021-7-20 17:42:49 | 显示全部楼层 |阅读模式 来自 广东省深圳市
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 章所述。

2.3 公共的常量和结构体
2.3.1 地址类型
MAC 地址使用以下数据类型和值:
typedef uint8 sAddrExt_t[8];
typedef struct
{
union
{
uint16 shortAddr;
sAddrExt_t extAddr;
} addr;
uint8 addrMode;
} sAddr_t;
addr.shortAddr – 短的16位MAC地址。
addr.extAddr – 扩展的64位MAC地址。
addrMode – 地址模式,使用以下值:
-SADDR_MODE_NONE:地址不存在。
-SADDR_MODE_SHORT:使用短16位地址。
-SADDR_MODE_EXT:使用扩展64位地址。

2.3.2.1 标准的状态值

名称描述
MAC_SUCCESS操作成功。
M AC BE ACON LOS S信标丢失后的同步请求。
MAC CHANNEL ACCESS FAILURE由于活动的信道操作或者数据请求失败。
MAC COUNTER ERROR接收帧的发送端使用的帧计数器是无效的。
MAC DENIEDMAC不能进入低功率模式。
MAC DISABLE TRX FAILURE未使用。
MAC_FRAME_TOO_LONG收到的帧或从操作或数据请求的帧结果太长不能被MAC处理。
MAC IMPROPER KEY TYPE密钥使用不允许接收的发送端。
MAC IMPROPER SECURITY LEVEL安全级别使用收到的帧不符合最低安全水平的发送端。
MACJNVALIDADDRESS因为源地址和目的地址的参数都不存在,数据请求失
MAC INVALID GTS未使用。
MAC INVALID HANDLE包括无效的处理的清除请求。
MACJNVALIDINDEX未使用。
MACJNVALIDPARAMETERAPI的功能参数超出范围。
MAC LIMIT REACHED因为描述符达到了存储限制,扫描结束。
MAC NO ACK操作或数据请求失败,因为没有收到确认。


更多详细内容请下载附件查看
游客,如果您要查看本帖隐藏内容请回复

已绑定手机
发表于 2021-9-29 10:19:16 | 显示全部楼层 来自 广东省广州市
好资料,感谢分享
已绑定手机
发表于 2021-10-24 09:19:47 | 显示全部楼层 来自 广东省深圳市
DINGDINGDING
已绑定手机
发表于 2022-12-11 14:44:08 | 显示全部楼层 来自 浙江省杭州市
学习学习
已绑定手机
发表于 2023-11-1 14:49:30 | 显示全部楼层 来自 广东省佛山市
802.15.4 MAC应用程序编程接口,不错
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

合作/建议

TEL: 19168984579

工作时间:
周一到周五 9:00-11:30 13:30-19:30
  • 扫一扫关注公众号
  • 扫一扫打开小程序
Copyright © 2013-2024 一牛网 版权所有 All Rights Reserved. 帮助中心|隐私声明|联系我们|手机版|粤ICP备13053961号|营业执照|EDI证
在本版发帖搜索
扫一扫添加微信客服
QQ客服返回顶部
快速回复 返回顶部 返回列表