hello，伙伴們最近一直在弄AiPi-Eyes-R3的資料，渲染、3D 外殼設(shè)計(jì)......一直沒(méi)時(shí)間開(kāi)發(fā)新的 HomeAssistant MQTT 實(shí)體，最新的實(shí)體估計(jì)也是在本月初開(kāi)發(fā)完的，一直沒(méi)來(lái)得及給大家寫(xiě)使用教程！

不過(guò)在寫(xiě)教程之前，有必要給大家看看上周的成果：

Text 實(shí)體介紹

Text 實(shí)體，也就是文本實(shí)體，它支持在 HomeAssistant 輸入文字之后，通過(guò) MQTT 下發(fā)內(nèi)容到設(shè)備當(dāng)中?？梢岳斫獬梢粋€(gè)文本輸入框，我們可以輸入任意文字，然后發(fā)給設(shè)備。

也可以利用自動(dòng)化，更新文本，例如：天氣信息更新到設(shè)備。之所以叫它文本輸入框，是因?yàn)樵?HomeAssitant 它呈現(xiàn)的方式是這樣的：

Text 實(shí)體創(chuàng)建

1.開(kāi)啟資源

和其他實(shí)體一樣，在 HomeAssistant-C 當(dāng)中，默認(rèn)不開(kāi)啟 Text 資源，需要自行啟用，在 homeAssistantDevConfig.h 中把 #define CONFIG_ENTITY_ENABLE_TEXT 置 1，就能啟用 Text 資源:

2.實(shí)體創(chuàng)建

創(chuàng)建 Text 實(shí)體也是在連接上 MQTT 服務(wù)器之后創(chuàng)建，只需要對(duì) name 和 unique_id 就行，然后添加以下實(shí)體：

static ha_text_entity_t text_1 = {
.name = "文字",
.unique_id = "text1",
};
homeAssistant_device_add_entity(CONFIG_HA_ENTITY_TEXT, &text_1);

燒錄并啟動(dòng)之后，就能看到 HomeAssistant 有文本實(shí)體。

Text 實(shí)體使用

1.接收 Text 內(nèi)容

同樣的 Text 內(nèi)容下發(fā)也會(huì)觸發(fā)事件，Text 的內(nèi)容下發(fā)事件為 HA_EVENT_MQTT_COMMAND_TEXT_VALUE，所以需要在 HA 事件回調(diào)函數(shù)（ha_event_cb）當(dāng)中添加 HA_EVENT_MQTT_COMMAND_TEXT_VALUE 的事件處理，并打印內(nèi)容：

case HA_EVENT_MQTT_COMMAND_TEXT_VALUE:
LOG_I("entity_text->command_text->text_value);
break;

有細(xì)心的同學(xué)可能發(fā)現(xiàn)了，信息獲取的來(lái)源都是通過(guò)一個(gè)以 command_xx 命名的結(jié)構(gòu)體來(lái)獲取的！所以以后獲取信息內(nèi)容，就是用對(duì)應(yīng)結(jié)構(gòu)體的 command_xx 成員來(lái)讀取就行。

驗(yàn)證示例：

2.Text 內(nèi)容更新

和其他實(shí)體更新的方法一樣，也是用 homeAssistant_device_send_entity_state 函數(shù)進(jìn)行發(fā)布，只不過(guò)需要重新給 Text 實(shí)體的 text_value 參數(shù)進(jìn)行賦值

使用示例：

讀取到 HomeAssistant 下發(fā)的內(nèi)容之后，返回 12345678 給 HomeAssistant。

case HA_EVENT_MQTT_COMMAND_TEXT_VALUE:
LOG_I("entity_text->command_text->text_value);
//查找實(shí)體
ha_text_entity_t* text = homeAssistant_fine_entity(CONFIG_HA_ENTITY_TEXT, "text1");
//清空原有的內(nèi)容
memset(text->text_value, 0, strlen(text->text_value));
//賦值內(nèi)容為 12345678
sprintf(text->text_value, "%d", 12345678);
//更新內(nèi)容
homeAssistant_device_send_entity_state(CONFIG_HA_ENTITY_TEXT, text, 0);
break;

驗(yàn)證結(jié)果

輸入之后下發(fā)，然后刷新一下網(wǎng)頁(yè)就能發(fā)現(xiàn)，文字備改變了。

總結(jié)

Text 實(shí)體的使用和其他實(shí)體差不多，沒(méi)有什么特殊的參數(shù)需要配置，所以簡(jiǎn)單說(shuō)說(shuō)就行，這周給大家開(kāi)發(fā) number 實(shí)體！

審核編輯 黃宇