4. Zigbee应用程序框架开发指南 - 生成应用程序配置文件

1 Zigbee应用程序框架开发指南 - 概述

2 Zigbee应用程序框架开发指南 - 应用程序框架结构

3 Zigbee应用程序框架开发指南 - 应用程序框架目录结构

4 Zigbee应用程序框架开发指南 - 生成应用程序配置文件

5 Zigbee应用程序框架开发指南 - 应用程序框架API

6 Zigbee应用程序框架开发指南 - 应用程序框架Callback接口

7 Zigbee应用程序框架开发指南 - 时间处理

8 Zigbee应用程序框架开发指南 - 事件

9 Zigbee应用程序框架开发指南 - 属性管理

10 Zigbee应用程序框架开发指南 - 命令处理和生成

11 Zigbee应用程序框架开发指南 - 命令行接口（CLI）

12 Zigbee应用程序框架开发指南 - 调试打印接口

13 Zigbee应用程序框架开发指南 - 多网络支持

14 Zigbee应用程序框架开发指南 - 睡眠设备

15 Zigbee应用程序框架开发指南 - 应用程序框架插件

16 Zigbee应用程序框架开发指南 - 扩展ZigBee Cluster Library (ZCL)

17 Zigbee应用程序框架开发指南 - 使用Ember AppBuilder设计应用程序

18 Zigbee应用程序框架开发指南 - 应用框架V6

4 生成应用程序配置文件

Zigbee应用程序框架使用相同的预处理器指令来配置要包含和排除在框架之外的代码。除了主app头文件之外，AppBuilder还生成一个后缀为suffixendpoint_configuration.h的“endpoint configuration”头文件。

<DeviceName>_endpoint_configuration.h
生成的文件配置了Zigbee应用程序框架的静态数据结构。这允许跨endpoint共享属性元数据，并且每个endpoint都有自己的属性存储空间。<DeviceName>_endpoint_config.h文件中的#define被app/framework/util/attribute-storage.c文件用于配置应用程序的所有与属性相关的数据。

每次在AppBuilder中修改应用程序配置时，必须重新生成该文件。Silicon Labs建议不要手工编辑<DeviceName>_endpoint_config.h文件，因为文件中的每个宏定义都有一个复杂的关系。
endpoint配置文件的角色在9.1节ZCL属性配置中有更详细的描述。

<DeviceName>.h
应用程序的主头文件。它包含了所有的#defines，这些定义开启了您在框架中需要的特性。

<DeviceName>_callbacks.c
生成的存根回调文件，其中包含您选择在项目中包含的所有回调的默认实现。这就是你要实现代码的地方。您不受限于在代码中使用这个文件。如果将其他文件添加到生成的项目文件中，则可以包括这些文件，以便编译器可以找到它们。

<DeviceName>.hwconf
为您的部分生成的外设配置文件。simple Studio为修改外设配置提供了用户友好的界面。请参见AN1115: Configuring Peripherals 中Simplicity Studio为32位设备定义的更多信息。

<DeviceName>_tokens.h
如果要在支持令牌的平台的tokens (持久内存)中包含任何属性，AppBuilder将生成此文件来配置tokens存储。

<DeviceName>.ewp, eww, .xip, .xiw, .mak
为您的应用程序生成项目文件。AppBuilder只生成与您选择的平台相匹配的项目文件。这些文件可能会被加载到IDE中并进行编辑，以构建项目的其余部分。

4.1 应用程序框架文件

除了设备特定的文件之外，AppBuilder还将应用程序框架文件生成到/< device-name >目录中。

生成的文件数量取决于所支持的插件和这些插件所需的文件数量。生成的Zigbee应用程序框架文件包括但不限于以下内容:

af-structs.h: 定义Zigbee应用程序框架用于解析通过空中发送的数据的结构。

att-storage.h: 定义在Zigbee应用程序框架内的属性存储机制中使用的。

attribute-id.h: 所有属性id由Zigbee Cluster Library规范定义，用于装载到Zigbee应用程序框架中的所有配置文件。

attribute-size.h: 在ZigBee Cluster Library规范中使用的属性类型的大小(以字节为单位)

attribute-type.h: 定义用于表示在Zigbee集群库规范中使用的数据类型的空中值。

call-command-handler.c: 命令处理代码为所有非通用命令收到的空中值。这生成的代码封送Cluster命令从它们的over the air格式发送到回调接口。如果没有为它们实现回调，它还会处理命令。

call-command-handler.h: call-command-handler c代码的头文件。这个文件为call-command-handler.c中实现的所有函数提供了定义。

callback-stub.c: 为Zigbee应用程序框架实现的自定义回调提供存根。只有当客户的应用程序没有单独定义回调存根时，才会编译回调存根。

callback.h: 为所有可能在Zigbee应用程序框架或用户应用程序中实现的回调提供定义。定义了整个回调接口，它是Zigbee应用程序框架在与用户应用程序通信时使用的主接口。

znet-cli.c: 这个文件提供了为命令行接口生成的所有处理程序。

znet-cli.h: 此文件仅由文档引擎doxygen用于文档通用应用程序框架cli命令，它没有其他目的。

client-command-macro.h: 宏，作为Zigbee应用程序框架接口的一部分，方便地用于填充将通过空中发送的包缓冲区。用户的应用程序配置中配置的Zigbee Cluster Library支持的每个命令在这里用一个宏表示，该宏将对Zigbee应用程序框架进行适当的调用，以填充包缓冲区，以便通过空中发送该命令。

cluster-id.h: 为从ZigBee Cluster Library加载到ZigBee应用程序框架的所有Cluster id提供了定义。

command-id.h: 为从ZigBee Cluster Library加载到Ember应用程序框架中的所有command id提供了定义。

debug-printing-test.h: 定义用于在ZigBee应用程序框架中打开调试打印。

debug-printing.h: 宏用于调试ZigBee应用程序框架内的打印。

enums.h: 为ZigBee应用程序框架中使用的所有与ZigBee Cluster Library相关的枚举提供定义。

print-cluster.h: 定义用于在ZigBee应用程序框架的每个Cluster的基础上打开打印。

stack-handler-stub.c: 所有可在ZigBee应用程序框架中重写的stack处理程序的存根。