deCONZ REST 插件安装与使用指南

1. 项目目录结构及介绍

deCONZ REST 插件位于 GitHub，其核心功能是通过RESTful API控制Zigbee设备。以下是关键的目录结构概览：

• BUILDING.md: 编译插件的详细步骤。
• CMakeLists.txt: CMake构建系统的主配置文件。
• LICENSE.txt: 许可证文件，明确软件遵循BSD-3-Clause协议。
• README.md: 项目介绍和快速入门指南。
• src: 源代码文件夹，包含了处理Zigbee设备通信的主要逻辑。
  • cpp: 各种功能的C++实现文件。
  • h: 对应的头文件，定义接口和结构。
  • events, devices, groups, lights, sensors等子目录，分别管理相应类型的Zigbee实体。
• .gitignore: Git版本控制中忽略的文件或目录列表。
• 其他: 还包括一些脚本文件、资源文件和用于特定功能如数据库操作的代码。

2. 项目的启动文件介绍

deCONZ应用本身不直接从这个仓库中的源码启动，而是需要编译或使用预编译包来安装。对于开发环境，通常通过以下步骤启动插件：

1. 编译: 首先，遵循BUILDING.md中的指示来编译插件。
2. 安装: 编译成功后，根据平台（Raspbian, Ubuntu, Windows等）进行相应的安装步骤。
3. 运行: 在Linux系统上，可以通过服务管理工具（如systemd）启用deCONZ服务，确保它随系统启动。

若在开发过程中直接调试，可能需要手动加载插件到deCONZ应用中或配置开发环境以自动加载编译后的插件库。

3. 项目的配置文件介绍

deCONZ及其REST插件的配置主要是通过Phoscon App或者通过API直接设置完成的。不过，从技术角度讲，具体的配置文件信息并不直接体现在上述GitHub仓库的文件结构中，因为许多配置是在运行时动态生成或通过应用程序界面调整的。

• 网络配置: 如网络ID、绑定信息等通常是由deCONZ应用程序管理，通过图形界面或REST API设置。
• 设备配置: 每个添加到网络的Zigbee设备都会在其内部存储配置信息，也可以通过API进行调优。
• 高级设置: 包含日志级别、数据库路径等，这些可能依赖于安装过程中的选项或系统环境变量。

对于开发人员，可能还需要关注的是deCONZ的应用级配置文件（如果存在），这通常位于系统特定的位置，例如用户的家目录下的隐藏配置文件夹，但具体位置和内容需要查看deCONZ的官方文档或使用手册来获取详细说明。

综上所述，直接参与插件运行的“启动文件”和“配置文件”更多是系统级别的交互和程序内部管理，而非直接编辑的文本文件，开发者和使用者需依循官方提供的工具和文档进行操作和配置。