Z-Stack ZCL API 开发文档

"Z-Stack ZCL API文档是关于Zigbee Cluster Library的应用程序编程接口，由Texas Instruments公司发布。此文档覆盖了多个版本的更新，包括从1.0到1.9，主要针对Zigbee协议栈的开发，涉及到CC2530芯片的使用。" ZigbeeClusterLibrary（ZCL）是Z-Stack中的一个核心组件，用于构建基于Zigbee网络的设备应用。ZCL提供了一组预定义的簇（Cluster），这些簇代表了特定的功能或服务，如照明控制、温度测量等。它为开发人员提供了在Zigbee设备之间进行通信的标准接口。 ApplicationProgrammingInterface（API）是ZCL的核心部分，允许开发者通过编程来控制和交互Zigbee设备。API包含了各种函数、结构体、常量和枚举，使得开发者能够轻松地实现Zigbee应用的特定功能。例如，通过ZCL API，开发者可以创建新的簇，发送和接收命令，以及处理数据。 文档中的"CompileOptions"部分指的是在编译ZCL应用程序时可选择的配置选项，这可能包括针对特定设备或场景的优化设置。例如，版本1.1增加了编译选项，这可能允许开发者根据需要启用或禁用某些特性。 "LogicalClusterIDs"在1.4版本中被移除，可能是因为这些ID不再需要，或者已经被更高效或简洁的方式来管理簇的标识。 1.5版本引入了"ProtocolInterfaces功能域"，这可能表示ZCL API扩展了对其他协议的支持，比如添加了对特定协议栈的操作接口。 "11073ProtocolTunnelCluster"在1.6版本被添加，这是对11073标准（个人健康设备互操作性）的隧道支持，意味着ZCL可以处理与医疗设备相关的数据传输。 版本1.7增加了获取原始AF消息的接口，这增强了设备处理底层Zigbee帧的能力。 1.9版本的重要变化包括添加了"Closures"功能域，这可能涉及到门窗、窗帘等家居自动化领域的簇。同时，新增了`zclGeneral_ReadSceneCountCB()`回调函数，可能用于处理场景计数的读取。此外，这个版本还从编译选项中移除了与Smart Energy特定相关的选项，这可能是为了简化配置或与其他Zigbee Pro特性更好地集成。 Z-Stack ZCL API文档是Zigbee开发者的重要参考资料，它详细阐述了如何利用ZCL库来创建、管理和控制Zigbee网络中的设备，同时也记录了随着技术发展而进行的多次更新和改进。