ZigBee PRO API错误处理与返回代码详解

"返回代码和扩展错误处理-cfa level 1 notes 电子版" 这篇资料主要涉及ZigBee PRO API的返回代码和扩展错误处理机制，这些是NXP ZigBee 3.0堆栈用户指南的一部分。ZigBee PRO API在执行功能后会返回一个代码来表示其完成情况，这些代码包括`zps_E_SUCCESS`以及不同层次（如APS、NWK、MAC）的返回代码，它们分别在第10.2.2至10.2.4节中详述。 扩展错误处理机制提供了一个更详细的错误信息获取途径，特别是对于在功能执行过程中出现的特定错误，例如`zps_APL_APS_E_ILLEGAL_REQUEST`、`zps_APL_APS_E_INVALID_PARAMETER`等。要启用这个机制，开发者需要使用`zps_vExtendedStatusSetCallback()`函数注册一个回调函数。这个回调函数会在API函数执行期间遇到上述错误时被调用，返回一个扩展错误代码，这些代码在第10.2.5节中定义。值得注意的是，虽然API函数只会返回基础错误代码，但回调函数则能提供更详细的扩展代码。 文档中还提到了一个警告：如果一个节点在重新加入同一个安全网络之前清除了堆栈上下文（比如通过调用`PDM_vDelete()`），其发送的数据可能会因为源节点的帧计数器重置而被拒绝。因此，建议不要在重新加入前清除堆栈上下文数据。更多相关信息和建议可以在附录B.3中找到。 ZigBee 3.0堆栈用户指南涵盖了ZigBee网络的基本概念，包括网络节点、网络拓扑、应用领域、无线射频操作、电池供电组件的考虑、易安装配置、高可靠性、安全性、共存和互操作性，以及设备类型和集群。它详细解释了ZigBeePRO协议架构、网络和应用层的操作，包括网络创建、寻址、路由、通信以及绑定等，并介绍了ZigBee协议栈的软件组成和开发环境资源。