物聯(lián)網辦公室清潔跟蹤系統(tǒng)

ExtendRoomIfCleaned 操作：將到期時間設置為 +1 小時后

?

ExtendRoomIfCleaned 操作：將狀態(tài)設置回打開

?

然后讓我們創(chuàng)建UpdateLogTable事件，如果到期日期被更改（例如通過ExtendRoomIfCleaned事件） ，它將在L_Log表中創(chuàng)建一行。這將用于生成報告數(shù)據(jù)。

UpdateLogTable 觸發(fā)器：如果到期已更改

?

新行的列填充如下：

• 從：=[Title] 獲取數(shù)據(jù)并寫入：=[Title]
• 從：=[Notes] 獲取數(shù)據(jù)并寫入：=[Notes]
• 從：=[Agent] 獲取數(shù)據(jù)并寫入：=[Agent]
• 從：=[$PREVIOUS] 獲取數(shù)據(jù)并寫入：=[Due] ——我們保存之前的 Due 值，即 Due to clean 的時間
• 從：=NOW() 獲取數(shù)據(jù)并寫入：=[Cleaned] - 我們保存當前時間，因此我們可以將其與報告中的到期時間進行比較

UpdateLogTable 操作：將數(shù)據(jù)復制到 L_Log 表

?

測試

導航到 A_WorkOrders 表，并將其中一個房間的狀態(tài)更改為已清潔。

• 從現(xiàn)在起應將到期時間更改為 1 小時
• 狀態(tài)應該變回打開
• 應該在 L_Log 表中創(chuàng)建一個新的日志行

第 3 步：適用于清潔人員的 AWS Honeycode 應用程序

在下一步中，我們根據(jù)我們的目標修改 Field Service Agent 應用程序。

有一個名為 WorkOrdersList 的控件，其來源應為：=Filter(A_WorkOrders, "ORDER BY A_WorkOrders[Due]")。這將按截止時間顯示和排序A_WorkOrders表中的工作訂單。

如果“代理”被添加到個性化，這意味著只有登錄用戶的房間會顯示在應用程序上。

清潔人員工具 - WorkOrdersList - 數(shù)據(jù)源

?

可以為Segment1設置彩色背景。遵循以下條件格式規(guī)則：

• 紅色：=60*HOUR(MAX(0, [Due]-$[LocalNow]))+MINUTE(MAX(0, [Due]-$[LocalNow]))=0
• 黃色：=60*HOUR(MAX(0, [Due]-$[LocalNow]))+MINUTE(MAX(0, [Due]-$[LocalNow]))<=15
• 綠色：=60*HOUR(MAX(0, [Due]-$[LocalNow]))+MINUTE(MAX(0, [Due]-$[LocalNow]))>15

清潔人員工具 - Segment1 - 顏色編碼

?

設置截止時間，以便清潔人員可以看到：

清潔人員工具 - 設置截止時間

?

設置剩余時間以快速瀏覽任務：

清潔人員工具 - 設置剩余時間

?

如果我們?yōu)樵摲块g安裝了 IoT Thing，則應該隱藏完成按鈕。

清潔人員工具 - 設置完成按鈕可見性

?

配置完成按鈕的操作以將房間狀態(tài)設置為已清潔：

清潔人員工具 - 設置完成按鈕操作

?

測試

應用程序應該在您的手機上運行，??并且應該顯示房間，如果單擊完成按鈕，應該很快更新屏幕，將該房間設置為綠色，并將其放在列表的末尾：

第 4 步：適用于 Manager 的 AWS Honeycode 應用程序

您可以為經理創(chuàng)建一個新的應用程序，該應用程序在日志中顯示事件，以查看它們是否合規(guī)。（您可以復制清潔人員工具，并刪除不需要的控件。）

將 WorkOrdersList 的數(shù)據(jù)源設置為 =FILTER( L_Log , "ORDER BY L_Log[Due] DESC")，這將顯示L_Log表中的項目：

管理工具 - WorkOrdersList - 數(shù)據(jù)源

?

您可以為經理 UI 添加過濾器，例如房間名稱或清潔人員姓名，這將使經理能夠過濾 App 中的結果列表：

管理器工具 - 啟用過濾

?

然后添加顏色編碼：

• 紅色：=([到期]-[已清理])<0
• 綠色：=([到期]-[已清理])>=0

管理器工具 - 顏色編碼

?

測試

應用程序應在您的手機上運行，??并應將房間和代理以及符合顏色編碼的清潔顯示為綠色，將不合規(guī)的清潔顯示為紅色：

第 5 步：連接 AWS 賬戶和 Honeycode 賬戶

由于我們的數(shù)據(jù)存儲在 AWS Honeycode 中，我們需要使用本頁描述的步驟將 AWS 賬戶連接到它：將 Honeycode 連接到 AWS 賬戶

測試

以下 AWS CLI 命令應列出 Honeycode 工作簿的表：

aws honeycode list-tables --workbook-id=ecf97bf3-57d1-48c2-a1e4-2886fe4df3ff

當您在 Honeycode 中編輯工作簿中的一個表時，工作簿 ID 是 url 的 %3A 和 %2F 之間的指導：

從 Honeycode url 獲取工作簿 ID

?

?

第 6 步：創(chuàng)建 Lambda 函數(shù)

從 GitHub 克隆代碼（鏈接在底部）。在 Lambda 文件夾中有一個 python 代碼，如果 IoT Shadow 發(fā)生變化（當清潔人員單擊 IoT Thing 上的 Cleaned 按鈕時），IoT Rule 將執(zhí)行該代碼

因此，在us-west-2（俄勒岡）AWS 區(qū)域中創(chuàng)建一個新的 lambda 函數(shù)，稱為clean-tracker-lambda和Python運行時。使用俄勒岡州，因為 Honeycode 和 IoT Core 在該地區(qū)都可用。將 lambda 代碼粘貼到編輯器中。此代碼將處理稍后將由 IoT 規(guī)則發(fā)送的消息，然后從中提取 IoT clientId，使用該 Id 過濾 WorkOrders 表，然后將該行的 Status 列更新為“Cleaned”。

?

它在代碼中定義了 3 個變量，這些變量應根據(jù)您的 AWS Honeycode Id 預先填充：

workbookId = 'ecf97bf3-57d1-48c2-a1e4-2886fe4df3ff' # NOTE: Your Workbook Id in Honeycode
tableId = '654cf941-7739-40fc-a43e-c8609132c9c5' # NOTE: Your WorkOrders Table Id within the Workbook
columnId = 'b983ffd4-61a7-4f89-944b-13916cb13803' # NOTE: The Status column within the WorkOrders table

workbookId與上面第 5 步中的相同。

tableId可以通過運行 AWS CLI 命令來確定，該命令將列出您的 tableIds 以及 tableNames。您將需要 WorkOrders 表：

aws honeycode list-tables --workbook-id=ecf97bf3-57d1-48c2-a1e4-2886fe4df3ff

---
{
    "tables": [
        {
            "tableId": "654cf941-7739-40fc-a43e-c8609132c9c5",
            "tableName": "A_WorkOrders"
        },
        {
            "tableId": "36135fdc-27ed-436a-9237-21c35def5f20",
            "tableName": "D_Customers"
        },
        {
            "tableId": "112369af-6ac1-446f-8fd1-0118f8120c74",
            "tableName": "D_Properties"
        },
        {
            "tableId": "d25fb00c-3ef9-4f88-9a72-54d962b7c66f",
            "tableName": "L_Log"
        },
        {
            "tableId": "070cde25-b179-4462-ab8a-18bed5fc91dd",
            "tableName": "M_Status"
        },
        {
            "tableId": "19f86da4-6232-43b2-ab23-9d67be644fb4",
            "tableName": "Z_Icons"
        }
    ],
    "workbookCursor": 618391759
}

columnId可以通過以下命令確定，該命令顯示 1 行數(shù)據(jù)以及響應開頭的 columnId，如下所示。您將需要 Status columnId：

aws honeycode list-table-rows --workbook-id=ecf97bf3-57d1-48c2-a1e4-2886fe4df3ff --table-id=654cf941-7739-40fc-a43e-c8609132c9c5 --max-results=1

---
{
    "columnIds": [
        "9083184e-02d3-4bcb-b957-d139792451f5",
        "f8526acf-bc65-4d2c-ab39-755f520fff56",
        "b983ffd4-61a7-4f89-944b-13916cb13803",
        "d372ed0a-cb8b-4960-8175-505b736c334c",
        "bf1404fa-54af-49d2-86ac-ea1d53dd127e",
        "ab0a2808-e5e7-4380-9e1d-ed3b6ba92b69",
        "2a1106c5-a7de-41cc-92ce-5dfcef59be69",
        "1322a4a4-c465-4973-9a52-361a8078068a"
    ],
    ...

修改變量后，您可以單擊 Deploy 按鈕，lambda 代碼已準備就緒。

仍然需要授予 Lambda 角色訪問權限才能讀取和寫入 Honeycode 表，所以讓我們：

• 導航到配置/權限
• 點擊cleaning-tracker-lambda-role
• 在 IAM 管理控制臺上，單擊附加策略按鈕
• 搜索 AmazonHoneycodeWorkbookFullAccess 策略，并勾選旁邊的框
• 單擊附加策略按鈕

?

?

測試

如果您配置新的測試事件并將以下 JSON 作為內容粘貼，則可以在 AWS 上測試 Lambda。確保將 clientidStatus 替換為 IoT clientid。

{
    "state": {
        "reported": {
            "timestampStatus": "2021-08-15 09:38:42",
            "clientidStatus": "0123456789abcdef",
            "cleaningStatus": "CLEANED"
        }
    },
    "metadata": {
        "reported": {
            "timestampStatus": {
                "timestamp": 1629020386
            },
            "clientidStatus": {
                "timestamp": 1629020386
            },
            "cleaningStatus": {
                "timestamp": 1629020386
            }
        }
    },
    "version": 7348,
    "timestamp": 1629020386,
    "clientToken": "0123456789abcdef-4"
}

您應該獲得 200 成功。這也應該在 WorkOrders 表中將相應行的狀態(tài)更新為已清理。當然，我們的 Honeycode 事件會將其設置回 Opened，但您仍然可以在 Due 列中看到更改。

?

第 7 步：設置 IoT 規(guī)則以調用 Lambda 函數(shù)

AWS IoT Shadow 是 MQTT 消息之上的一層。它在 AWS 和 IoT Thing 端都有 JSON 格式的狀態(tài)。無論哪個更新其中的任何值，都會將其發(fā)送給對方，以便他們做出反應。

在這里，如果 IoT Thing 更新了 Shadow，我們想調用我們的 Lambda 函數(shù)。

導航到 AWS IoT > Act > Rules 并創(chuàng)建一個新規(guī)則：

• 名稱：cleaning_tracker_rule
• 帶有 IoT 客戶端 ID 的查詢語句：SELECT * FROM '$aws/things/ 0123456789abcdef /shadow/update/accepted'
• 添加操作：向 Lambda 函數(shù)發(fā)送消息
• 選擇cleaning-tracker-lambda

規(guī)則將連接到 Lambda 并在某些時候啟用。此規(guī)則將對物聯(lián)網事物狀態(tài)變化做出反應，并使用消息詳細信息調用我們的 lambda。

?

?

第 8 步：將代碼實現(xiàn)到 IoT Thing

最后，我們?yōu)樽钪匾牟糠譁蕚淞艘磺?，?IoT Thing 的代碼。從 GitHub 克隆代碼（鏈接在底部）。在 IoT 文件夾中有用 C 編寫的代碼，這是需要的。

這是根據(jù)智能恒溫器示例構建的，因此您將在此處找到實施的內容、方式和原因。閱讀 git 提交也可以跟蹤我們的更改。

首先，將您預先配置的sdkconfig文件從 Smart Thermostat 文件夾復制到 IoT 文件夾。此文件不是我們的 repo (by.gitignore) 的一部分，因為它包含 WiFi SSID 和密碼以及您的 IoT 事物的 MQTT 隊列的唯一 AWS url。

清理

刪除了一些不需要的文件和模塊，例如 FFT.c，因為我們不處理語音。

ui.c

創(chuàng)建了以下 UI 方法：

// sets wifi label text and state
void ui_wifi_label_update(bool state, char *ssid);

// sets date label based on date value
void ui_date_label_update(rtc_date_t date);

// queries whether the Cleaned button is already clicked & resets its state to false
bool is_cleaned_button_clicked();

// sets the value of the due bar ( 0 .. 100 )
void ui_set_due_bar(int16_t value);

// sets the color of the leds ( example: 0x00FF00 )
void ui_set_led_color(uint32_t color);

按鈕點擊事件設置了一個全局變量，后面可以查詢：

// called if the user clicks the Cleaned button
static void cleaned_button_event_handler(lv_obj_t * obj, lv_event_t event)
{
    if(event == LV_EVENT_CLICKED) {
        cleaned_button_clicked = true;  // store that the button was clicked
        ESP_LOGI(TAG, "Done button clicked");
    }
}

// queries whether the Cleaned button is already clicked & resets its state to false
bool is_cleaned_button_clicked() {
    bool ret = cleaned_button_clicked;  // return state
    cleaned_button_clicked = false;     // set back to current state to false
    return ret;
}

cleaned_button = lv_btn_create(lv_scr_act(), NULL);
    lv_obj_add_style(cleaned_button, LV_BTN_PART_MAIN, &cleaned_button_style);
    lv_obj_set_event_cb(cleaned_button, cleaned_button_event_handler);  // handler
    lv_obj_set_width(cleaned_button, 200);
    lv_obj_align(cleaned_button, NULL, LV_ALIGN_IN_BOTTOM_MID, 0, -20);

在這里，我們也使用樣式，例如：

static lv_style_t cleaned_button_style;
    lv_style_set_border_color(&cleaned_button_style, LV_STATE_DEFAULT, LV_COLOR_GREEN);
    lv_style_set_border_color(&cleaned_button_style, LV_STATE_FOCUSED, LV_COLOR_GREEN);

static lv_style_t title_style;  // create title style (big font)
    lv_style_init(&title_style);
    lv_style_set_text_font(&title_style, LV_STATE_DEFAULT, LV_THEME_DEFAULT_FONT_TITLE);
    lv_style_set_text_color(&title_style, LV_STATE_DEFAULT, LV_COLOR_BLACK);

    static lv_style_t subtitle_style;   // create title style (medium size font)
    lv_style_init(&subtitle_style);
    lv_style_set_text_font(&subtitle_style, LV_STATE_DEFAULT, LV_THEME_DEFAULT_FONT_SUBTITLE);
    lv_style_set_text_color(&subtitle_style, LV_STATE_DEFAULT, LV_COLOR_BLACK);

重要提示：我們還修改了樣式的字體大小，這可以在sdkconfig文件中完成，如下所示：

CONFIG_LV_FONT_MONTSERRAT_32=y

CONFIG_LV_FONT_MONTSERRAT_48=y


# CONFIG_LV_FONT_DEFAULT_SUBTITLE_MONTSERRAT_16 is not set
CONFIG_LV_FONT_DEFAULT_SUBTITLE_MONTSERRAT_32=y


# CONFIG_LV_FONT_DEFAULT_TITLE_MONTSERRAT_16 is not set
CONFIG_LV_FONT_DEFAULT_TITLE_MONTSERRAT_48=y

以下部分顯示了如何打印 WiFi 符號以及如何更改同一文本中的文本顏色：

// sets wifi label text and state
void ui_wifi_label_update(bool state, char *ssid){
    xSemaphoreTake(xGuiSemaphore, portMAX_DELAY);
    if (state == false) {   // if there is no wifi signal
        lv_label_set_text(wifi_label, LV_SYMBOL_WIFI);  // black wifi symbol
    } 
    else{
        char buffer[100];
        sprintf (buffer, "#0000ff %s # %s", LV_SYMBOL_WIFI, ssid);
        lv_label_set_text(wifi_label, buffer);
    }
    xSemaphoreGive(xGuiSemaphore);

LVGL UI 文檔可以在這里找到。這顯示了所有可用的控件、樣式和屬性設置，例如對齊方式。

LED的設置如下：

// sets the color of the leds ( example: 0x00FF00 )
void ui_set_led_color(uint32_t color) {
    Core2ForAWS_Sk6812_SetSideColor(SK6812_SIDE_LEFT, color);
    Core2ForAWS_Sk6812_SetSideColor(SK6812_SIDE_RIGHT, color);
    Core2ForAWS_Sk6812_Show();
}

?

主程序

IoT 項目的主文件也進行了清理，并添加了我們的邏輯。此外，許多地方都添加了日志記錄，并將日志記錄到控制臺輸出而不是 UI。

所做的更改之一是，如果 IoT Thing 無法連接到影子，我們不會重新啟動。有時我們會遇到超時問題，并且 Thing 重啟需要很長時間。

// Connect to shadow in infinite loop until connected successfully
while(true) {
    ESP_LOGI(TAG, "Shadow Connect");
    rc = aws_iot_shadow_connect(&iotCoreClient, &scp);
    if(SUCCESS != rc) {
        ESP_LOGE(TAG, "aws_iot_shadow_connect returned error %d, retrying...", rc);
    } else {
        ESP_LOGI(TAG, "Connected to AWS IoT Device Shadow service");
        break;  // exit from the loop
    }
}

當 Thing 連接到 WiFi 和 IoT Shadow 時，我們也在 Thing 上設置當前時間 + 1 小時的到期時間：

// initialize cleaning due date to current time + 1 hour
BM8563_GetTime(&dueDate);
dueDate.hour+=1;

然后我們開始一個無限循環(huán)，它獲取時間并在 UI 上顯示時間，計算剩余時間，根據(jù)差異設置 LED，并設置進度條（不會低于零）：

// START get sensor readings + update UI

BM8563_GetTime(&date);          // get current date time
ui_date_label_update(date);     // show time on UI

// minutes between now and cleaning due time
int timediff = (dueDate.hour * 60 + dueDate.minute) - (date.hour * 60 + date.minute);   ESP_LOGI(TAG, "timediff: %d", timediff);

if (timediff < 0)
    ui_set_led_color(0xFF0000); // set LED strips to RED if no time left
else if (timediff < 15)
    ui_set_led_color(0xFFFF00); // set LED strips to YELLOW if 15 or less mins left
else
    ui_set_led_color(0x00FF00); // set LED strips to GREEN otherwise

if (timediff < 0)
    timediff = 0;
ui_set_due_bar(timediff * 100 / 60);    // show remaining time on the progressbar as well

// END get sensor readings

我們檢查按鈕是否在此期間被點擊，如果是，那么我們將到期時間增加到 +1 小時。還應構建 JSON 消息，并更新 IoT Shadow。為了節(jié)省成本，我們僅在真正需要時才更新 IoT Shadow（當單擊“已清理”按鈕時）：

// if room is cleaned
if (is_cleaned_button_clicked()) { // send message only if Cleaned

    BM8563_GetTime(&dueDate);
    dueDate.hour+=1;    // update cleaning due date to current time + 1 hour

    // set values for shadow document
    sprintf(timestampStatus, "%d-%02d-%02d %02d:%02d:%02d", date.year, date.month, date.day, date.hour, date.minute, date.second);  // date time stamp
    sprintf(clientidStatus, "%s", client_id);   // IoT id
    sprintf(cleaningStatus, "CLEANED");         // Cleaning status

    // log
    ESP_LOGI(TAG, "****************************************************************");
    ESP_LOGI(TAG, "On Device: timestampStatus %s", timestampStatus);
    ESP_LOGI(TAG, "On Device: clientidStatus %s", clientidStatus);
    ESP_LOGI(TAG, "On Device: cleaningStatus %s", cleaningStatus);

    // compose and update shadow document with: timestamp + clientid + cleaningstatus
    rc = aws_iot_shadow_init_json_document(JsonDocumentBuffer,
        sizeOfJsonDocumentBuffer);
    if(SUCCESS == rc) {
        rc = aws_iot_shadow_add_reported(JsonDocumentBuffer,
            sizeOfJsonDocumentBuffer, 3,
            ×tampStatusActuator,
            &clientidStatusActuator,
            &cleaningStatusActuator);
        if(SUCCESS == rc) {
            rc = aws_iot_finalize_json_document(JsonDocumentBuffer,
                sizeOfJsonDocumentBuffer);
            if(SUCCESS == rc) {
                ESP_LOGI(TAG, "Update Shadow: %s", JsonDocumentBuffer);
                rc = aws_iot_shadow_update(&iotCoreClient, client_id,
                    JsonDocumentBuffer, ShadowUpdateStatusCallback, NULL, 4, true);
                shadowUpdateInProgress = true;
            }
        }
    }
    ESP_LOGI(TAG, "****************************************************************");
}

然后我們等待 1 秒，無限循環(huán)繼續(xù)。

vTaskDelay(pdMS_TO_TICKS(1000));    // wait 1 sec, then loop

就是這樣！

備注：cleaningStatus_Callback方法當前為空。在以后的增強中，它可用于例如從 AWS 更新到期日期，因為只要 AWS 端的 IoT Shadow 發(fā)生更改，就會調用此日期。

測試

讓我們在 PlatformIO 終端中發(fā)出以下命令：

pio run --environment core2foraws --target upload --target monitor

它將編譯項目、創(chuàng)建固件并將其上傳到 IoT Thing。Thing 將重新啟動并執(zhí)行代碼，而您可以在 PlatformIO 終端中看到它的控制臺日志。

日志中的一些重要里程碑是：

客戶編號：

?[0;32mI (3425) MAIN: Device client Id: >> 0123456789abcde01 <

無線網絡連接：

?[0;32mI (3235) WIFI: Setting Wi-Fi configuration to SSID: ultrix?[0m
?[0;32mI (9135) WIFI: Wi-Fi connected. Device IP address: 192.168.0.213?[0m

連接到 AWS IoT Shadow：

?[0;32mI (9135) MAIN: Shadow Init?[0m
?[0;32mI (9135) MAIN: Shadow Connect?[0m
?[0;32mI (16265) MAIN: Connected to AWS IoT Device Shadow service?[0m

循環(huán)顯示剩余時間：

?[0;32mI (16765) MAIN: timediff: 60?[0m
:
:
?[0;32mI (16765) MAIN: timediff: 59?[0m

單擊“已清除”按鈕后，將顯示以下日志：

?[0;32mI (31945) UI: Done button clicked?[0m
?[0;32mI (32365) MAIN: *****************************************************************************************?[0m
?[0;32mI (32365) MAIN: On Device: timestampStatus 2021-09-15 17:24:56?[0m
?[0;32mI (32375) MAIN: On Device: clientidStatus 0123456789abcde01 ?[0m
?[0;32mI (32385) MAIN: On Device: cleaningStatus CLEANED?[0m
?[0;32mI (32385) MAIN: Update Shadow: {"state":{"reported":{"timestampStatus":"2021-09-15 17:24:56","clientidStatus":"0123456789abcde01 ","cleaningStatus":"CLEANED"}}, "clientToken":"0123456789abcde01 -0"}?[0m
?[0;32mI (35065) MAIN: *****************************************************************************************?[0m
?[0;32mI (35065) MAIN: Stack remaining for task 'aws_iot_task' is 2044 bytes?[0m
?[0;32mI (36095) MAIN: Update accepted?[0m

AWS 控制臺上也可以看到相同的 JSON：

?

?

第 9 步：測試物聯(lián)網

啟動后，IoT Thing 上的 LED 將呈藍色。很快它將連接到 WiFi，其 SSID 將顯示在左上角。一段時間后，它將連接到 AWS IoT Shadow，并開始循環(huán)，因此：將顯示當前時間，LED 將變?yōu)榫G色，進度條將顯示從 1 小時開始的剩余時間百分比。如果只剩下 15 分鐘，LED 將呈黃色。如果剩余時間，LED 將變?yōu)榧t色。每當您按下“已清除”按鈕時，1 小時倒計時再次開始，進度條應重置為 100%，LED 應再次變?yōu)榫G色，并且還會通過 AWS IoT Shadow 發(fā)送一條消息，這將觸發(fā) IoT 規(guī)則，等等上。

未來的可能性

為合規(guī)報告匯總數(shù)據(jù)。

將系統(tǒng)連接到公司 AD，因此：

• IoT Thing 可以在其 UI 上顯示下一次會議名稱和開始時間
• 系統(tǒng)可以在房間沒有會議時計劃清潔周期