自定义命令词变量配置¶

问题描述¶

在配置自定义命令词时，对变量名的命名规则和变量类型的选择存在疑问，特别是如何正确填写变量名和选择合适的类型。

解决方案¶

1. 变量命名规则¶

变量名必须满足C语言变量名规则：

• 只能包含字母（a-z, A-Z）、数字（0-9）和下划线（_）
• 必须以字母或下划线开头，不能以数字开头
• 区分大小写（如：LED与led是不同的变量）
• 不能使用C语言关键字（如：int、char、if、for等）
• 建议使用有意义的命名，如：led_state、motor_speed、door_status

2. 变量类型选择¶

根据存储的数据类型选择合适的变量类型：

注意：平台暂不支持枚举（enum）类型。如需表示有限个数的离散状态（如开关状态、模式选择等），可以使用 int 或 char 类型代替，并通过数值映射到具体状态。

示例： - 开关状态：char 类型，0=关，1=开 - 模式选择：int 类型，0=自动模式，1=手动模式，2=睡眠模式

3. 行为与变量的关系¶

在基础信息页面看到的"行为"列（如on1、off1、on2、off2）是预设的行为标识符，不是变量名。这些行为标识符用于：

• on1/on2：通常表示开启动作
• off1/off2：通常表示关闭动作
• 可以与定义的变量配合使用，实现状态控制

4. 配置步骤¶

1. 定义变量：

   • 进入"变量定义"页面
   • 点击添加变量
   • 输入符合规范的变量名
   • 选择合适的数据类型
   • 设置默认值（可选）

2. 关联行为：

   • 在"基础信息"页面配置命令词
   • 为每个命令词选择对应的行为
   • 通过变量设置来控制具体动作

3. 使用变量：

   • 在控制详情中引用定义的变量
   • 设置变量的值或操作方式
   • 实现命令词与变量的联动

注意事项¶

• 变量一旦定义，其类型不可修改，如需修改需删除后重新创建
• 变量名在同一个项目中必须唯一
• 建议在定义变量时添加备注，说明变量的用途
• 合理使用变量可以有效减少重复的命令词配置

变量下拉选项刷新说明¶

问题现象：

• 在"变量定义"页面删除了变量，但控制详情的下拉选项中仍显示该变量
• 在"变量定义"页面添加了新变量，但控制详情的下拉选项中没有显示

解决方案：

• 删除变量后的残留：控制详情中的变量下拉选项会缓存已删除的变量。需要重新点击该下拉框，选项列表会自动刷新，已删除的变量将不再显示
• 新增变量不显示：必须先在"变量定义"页面添加变量，添加成功后，在控制详情中重新选择下拉框，新变量才会出现在选项列表中
• 切换下拉选项后，记得保存配置

操作步骤：

1. 进入"变量定义"页面，完成变量的添加或删除操作
2. 返回"控制详情"页面
3. 点击包含变量选择的下拉框（如"变量设置"中的变量选择）
4. 下拉框会刷新并显示最新的变量列表
5. 选择需要的变量后保存配置