| 要说的话 最近一直在搞 AiPi-Eyes-R3 的资料，搞渲染，搞 3D 外壳设计，就一直没时间开发新的 HomeAssistant MQTT 实体，最新的实体估计也是在月初开发完的，一直没来得及给大家写使用教程！有必要给大家看看上周的成果：
Text 实体介绍Text 实体，也就是文本实体，它支持在 HomeAssistant 输入文字之后，通过 MQTT 下发内容到设备当中。可以理解成一个文本输入框，我们可以输入任意文字，然后发给设备。
也可以利用自动化，更新文本，例如：天气信息更新到设备。之所以叫它文本输入框，是因为在 HomeAssitant 它呈现的方式是这样的：
Text 实体创建
1.开启资源和其他实体一样，在 HomeAssistant-C 当中，默认不开启 Text 资源，需要自行启用，在 homeAssistantDevConfig.h 中把 #define CONFIG_ENTITY_ENABLE_TEXT 置 1，就能启用 Text 资源:
2.实体创建创建 Text 实体也是在连接上 MQTT 服务器之后创建，只需要对 name 和 unique_id 就行，然后添加以下实体：
static ha_text_entity_t text_1 = {
.name = "文字",
.unique_id = "text1",
};
homeAssistant_device_add_entity(CONFIG_HA_ENTITY_TEXT, &text_1);
烧录并启动之后，就能看到 HomeAssistant 有文本实体。
Text 实体使用
1.接收 Text 内容同样的 Text 内容下发也会触发事件，Text 的内容下发事件为 HA_EVENT_MQTT_COMMAND_TEXT_VALUE，所以需要在 HA 事件回调函数（ha_event_cb）当中添加 HA_EVENT_MQTT_COMMAND_TEXT_VALUE 的事件处理，并打印内容：
static ha_text_entity_t text_1 = {
.name = "文字",
.unique_id = "text1",
};
homeAssistant_device_add_entity(CONFIG_HA_ENTITY_TEXT, &text_1);
有细心的同学可能发现了，信息获取的来源都是通过一个以 command_xx 命名的结构体来获取的！所以以后获取信息内容，就是用对应结构体的 command_xx 成员来读取就行。 验证示例：
2.Text 内容更新和其他实体更新的方法一样，也是用 homeAssistant_device_send_entity_state 函数进行发布，只不过需要重新给 Text 实体的 text_value 参数进行赋值， 使用示例：
读取到 HomeAssistant 下发的内容之后，返回 12345678 给 HomeAssistant
case HA_EVENT_MQTT_COMMAND_TEXT_VALUE:
LOG_I("<<<<<<<<<< HA_EVENT_MQTT_COMMAND_TEXT_VALUE,value=%s", ha_dev->entity_text->command_text->text_value);
//查找实体
ha_text_entity_t* text = homeAssistant_fine_entity(CONFIG_HA_ENTITY_TEXT, "text1");
//清空原有的内容
memset(text->text_value, 0, strlen(text->text_value));
//赋值内容为 12345678
sprintf(text->text_value, "%d", 12345678);
//更新内容
homeAssistant_device_send_entity_state(CONFIG_HA_ENTITY_TEXT, text, 0);
break;
输入之后下发，然后刷新一下网页就能发现，文字备改变了
总结Text 实体的使用和其他实体差不多，没有什么特殊的参数需要配置，所以简单说说就行，这周给大家开发 number 实体！
| 
发表于 2024-6-26 10:15:34
楼主