描述

?

概述

本文檔將描述構(gòu)建一個(gè) Google 表格，該表格從 Particle Photon 接收家庭電流數(shù)據(jù)。在每 24 小時(shí)結(jié)束時(shí)，數(shù)據(jù)將被復(fù)制到一張新表中，該表將由一個(gè)腳本進(jìn)行分析，該腳本將樣本之間的電流幅度變化與已知設(shè)備簽名進(jìn)行比較，以確定給定設(shè)備消耗了多少電量。然后將當(dāng)天的總用電量以及每個(gè)設(shè)備消耗的電量復(fù)制到“DailyLog”表中，該表跟蹤每天的總電量。本指南假定您使用的是 Particle Photon 并已按照其有關(guān)初始設(shè)置等的說(shuō)明進(jìn)行操作。您還需要訪(fǎng)問(wèn) Google Drive 并對(duì)電子表格有一些基本的了解。

?

?

?

?

?

谷歌電子表格設(shè)置

首先轉(zhuǎn)到您的云端硬盤(pán)并創(chuàng)建一個(gè)新的 Google 表格，它將從您的 Particle Photon 收集數(shù)據(jù)。給你的電子表格一個(gè)名字，任何你喜歡的名字。第一列標(biāo)題必須稱(chēng)為“時(shí)間戳”（區(qū)分大小寫(xiě)）。可以為后續(xù)列指定任何名稱(chēng)，但出于本項(xiàng)目的目的，我們將它們填寫(xiě)為：

?

?

第 1 行必須與本文檔稍后描述的 JSON 鍵完全匹配。第 2 行是信息性的，因此用戶(hù)可以看到每列中代表的頻率。這是可由用戶(hù)配置的，將在本文檔的 Photon 代碼部分進(jìn)行描述。

第 3 行將包含一些有助于跟蹤總功耗的公式。單元格 A3 應(yīng)包含以下公式：

=sum(-1*A4,INDEX(A4:A, COUNT(A4:A)))*24

此公式從最后一個(gè)時(shí)間戳中減去第一個(gè)時(shí)間戳，然后乘以 24，得到從第一個(gè)樣本到最后一個(gè)樣本的總時(shí)間量（以小時(shí)為單位）。單元格 B3 和 M3 應(yīng)分別包含公式：

=average(B4:B)*A3*120/1000
=average(M4:M)*A3*120/1000

這些公式計(jì)算出平均電流，乘以小時(shí)數(shù) (A3)，乘以 120V，然后除以 1000，得到當(dāng)天每個(gè)相位消耗的千瓦時(shí)總數(shù)。

突出顯示 A 列并單擊格式>數(shù)字>日期時(shí)間以顯示時(shí)間戳上的日期和時(shí)間。然后，突出顯示單元格 A3 并將其格式更改為“數(shù)字”>“數(shù)字”，因?yàn)樗切r(shí)數(shù)而不是時(shí)間戳。

你應(yīng)該得到這樣的結(jié)果：

記下文檔中特定工作表的名稱(chēng)（默認(rèn)情況下為“Sheet1”），因?yàn)樯院竽鷮⑿枰糜谀_本。Photon將向此電子表格發(fā)送數(shù)據(jù)，每次添加一個(gè)新行。在此電子表格中添加一個(gè)附加表并將此函數(shù)插入??第一個(gè)單元格 (A1)：

=SORT(QUERY(Sheet1!A:Z,"order by A desc limit 90"),1,1)

?

這將從 Sheet1 復(fù)制最后 90 個(gè)條目并不斷更新它們，這將使我們能夠創(chuàng)建動(dòng)態(tài)更新的圖表。您可以創(chuàng)建額外的工作表，將 90 更改為您想要的任何值，從而允許您創(chuàng)建不同時(shí)間段的圖表。

像這樣：

?

排序功能

查詢(xún)功能

Google 表格 注意：有時(shí)，當(dāng)您更改表格中的一個(gè)單元格時(shí)，它似乎不會(huì)生效，直到您在另一個(gè)單元格中執(zhí)行某些操作。如果添加此“排序”功能時(shí)沒(méi)有任何反應(yīng)，請(qǐng)?jiān)陔S機(jī)單元格中鍵入一個(gè)隨機(jī)字符，然后按回車(chē)鍵。（不要忘記稍后將其刪除。）或者，繼續(xù)執(zhí)行此操作方法并相信它會(huì)彈出。

Google 表格腳本

為了設(shè)置電子表格以接收來(lái)自 Photon 的數(shù)據(jù)，我們將創(chuàng)建此處描述的腳本。在 Google 表格中單擊工具>腳本編輯器。這將在新選項(xiàng)卡中打開(kāi)腳本編輯器。給你的項(xiàng)目任何你喜歡的名字。然后將 Code.gs 中的默認(rèn)文本替換為 Google 表格 JavaScript（附在下面）。

你應(yīng)該得到這樣的結(jié)果：

?

請(qǐng)注意，在第二行中，變量 SHEET_NAME 必須與電子表格中接收數(shù)據(jù)的特定工作表的名稱(chēng)一致。因此，如果您更改它的默認(rèn)值“Sheet1”，請(qǐng)務(wù)必在此處也進(jìn)行更改。

單擊保存圖標(biāo)，然后通過(guò)單擊“運(yùn)行”>“運(yùn)行功能”>“設(shè)置”來(lái)運(yùn)行設(shè)置功能。您將獲得一個(gè)彈出窗口來(lái)查看權(quán)限。單擊“審查權(quán)限”，然后在下一個(gè)窗口中單擊您的 Google 帳戶(hù)。之后，您可能會(huì)收到一條提示，提示“此應(yīng)用未經(jīng)驗(yàn)證，”如果是，請(qǐng)單擊“高級(jí)”，然后單擊“轉(zhuǎn)到 GenericScriptName(unsafe)”。然后您可以單擊“允許”以授予腳本編輯電子表格的權(quán)限。

?

仍在腳本編輯器中時(shí)，單擊文件>管理版本以創(chuàng)建腳本的初始版本。給它一個(gè)描述，例如“InitialVersion”，然后單擊“保存新版本”，然后“確定”。

接下來(lái)我們需要為這些腳本設(shè)置觸發(fā)器。為此，請(qǐng)單擊“編輯”>“當(dāng)前項(xiàng)目的觸發(fā)器”，這將在新選項(xiàng)卡中打開(kāi) G Suite 開(kāi)發(fā)人員中心。單擊右下角的“+ 添加觸發(fā)器”按鈕，在彈出的窗口中，從下拉列表中選擇“doPost”、“Head”、“From Spreadsheet”和“On form submit”，然后單擊保存. 失敗通知設(shè)置可以根據(jù)您希望在腳本失敗時(shí)收到通知的頻率的偏好來(lái)設(shè)置。可能會(huì)有另一個(gè)彈出窗口讓您再次選擇您的 Google 帳戶(hù)，然后請(qǐng)求允許腳本編輯工作表的權(quán)限，單擊“允許”。

您還需要?jiǎng)?chuàng)建一個(gè)觸發(fā)器來(lái)每天運(yùn)行 copy_delete 函數(shù)，該函數(shù)復(fù)制 Sheet1，用當(dāng)天的日期重命名復(fù)制的工作表，然后刪除 Sheet1 上的所有行以開(kāi)始新的一天的數(shù)據(jù)。再次單擊“+ 添加觸發(fā)器”，然后從下拉選項(xiàng)中選擇“復(fù)制_刪除”、“頭部”、“時(shí)間驅(qū)動(dòng)”、“日間計(jì)時(shí)器”和“晚上 10 點(diǎn)至晚上 11 點(diǎn)”（或任何您喜歡的時(shí)間）。請(qǐng)注意，該腳本將使用當(dāng)天的日期重命名工作表，因此您希望時(shí)間在午夜之前。再次，失敗通知可以設(shè)置為您的偏好。

同樣，為 appliance_id 和 getDailyTotal 函數(shù)添加觸發(fā)器。這些腳本應(yīng)該在 copy_delete 函數(shù)運(yùn)行后運(yùn)行，因此如果您選擇“晚上 10 點(diǎn)到晚上 11 點(diǎn)”，您可以為 appliance_id 選擇“午夜到凌晨 1 點(diǎn)”，為 getDailyTotal 選擇“凌晨 1 點(diǎn)到凌晨 2 點(diǎn)”，這必須最后運(yùn)行。

你應(yīng)該得到這樣的結(jié)果：

?

返回到您的腳本（腳本編輯器選項(xiàng)卡）并單擊發(fā)布>部署為 Web 應(yīng)用程序。從下拉列表中選擇相關(guān)的項(xiàng)目版本（可能是 1），以“我”的身份執(zhí)行應(yīng)用程序，以及誰(shuí)有權(quán)訪(fǎng)問(wèn)“任何人，甚至是匿名的”。單擊“部署”，您將獲得一個(gè) url，您將需要它來(lái)使用您的 webhook。復(fù)制它并單擊“確定”。（您可以將鏈接保存在記事本或類(lèi)似的東西中。）

?

網(wǎng)絡(luò)鉤子

對(duì)于webhook，我們將詳細(xì)說(shuō)明本教程中描述的方法。在Particle Console 中，轉(zhuǎn)到 Integrations 頁(yè)面，然后單擊“+ NEW INTEGRATION”框，然后單擊“Webhook”。為 webhook 指定一個(gè)事件名稱(chēng)，這將是啟動(dòng) webhook 的Particle.publish事件。出于我們的目的，它將被稱(chēng)為“GenericWebhookName”（區(qū)分大小寫(xiě)）。對(duì)于 url，粘貼您將腳本發(fā)布為 Web 應(yīng)用程序時(shí)獲得的地址。請(qǐng)求類(lèi)型是“POST”，請(qǐng)求格式是“Web Form”，Device 可以保留為“Any”。底部的小下拉菜單是“高級(jí)設(shè)置”——

單擊底部的“高級(jí)設(shè)置”菜單并切換“自定義”單選按鈕。開(kāi)始填寫(xiě)表單字段。行的順序在這里不是特別重要。值得注意的是，左列與電子表格中的列標(biāo)題相關(guān)，右列是您將要發(fā)送的 JSON 鍵/值對(duì)中的鍵。為簡(jiǎn)單起見(jiàn)，我給它們起了相同的名字。下圖中未顯示所有行，但請(qǐng)繼續(xù)填寫(xiě)，直到電子表格中除“時(shí)間戳”之外的每一列都有一行。

其他一切都可以保留為默認(rèn)設(shè)置。單擊“創(chuàng)建 Webhook”。完整的 webhook 應(yīng)如下所示：

固件

首先將您的光子更新到最新版本的固件。單擊設(shè)備的build.particle.io網(wǎng)頁(yè)左下角的十字準(zhǔn)線(xiàn)（設(shè)備） 。單擊要使用的設(shè)備的下拉菜單，然后選擇最新的系統(tǒng)固件。推薦使用 0.8.0-rc.14 或更新版本，盡管舊版本的 rc 也可以。所選固件目標(biāo)將在下次刷新時(shí)下載到您的設(shè)備。

對(duì)于我們的項(xiàng)目，您可以使用此代碼上傳到您的 Photon。然而，對(duì)于一般情況，使用此 webhook 將數(shù)據(jù)發(fā)布到電子表格的格式如下所示：

Particle.publish("GenericWebhookName","{"IrmsA":"" + tIrmsA + "","A1":"" + A_1 + "","A2":"" + A_2 + "","A3":"" + A_3 + "","A4":"" + A_4 + "","A5":"" + A_5 + "","A6":"" + A_6 + "","A7":"" + A_7 + "","A8":"" + A_8 + "","A9":"" + A_9 + "","A10":"" + A_10 + "","IrmsB":"" + tIrmsB + "","B1":"" + B_1 + "","B2":"" + B_2 + "","B3":"" + B_3 + "","B4":"" + B_4 + "","B5":"" + B_5 + "","B6":"" + B_6 + "","B7":"" + B_7 + "","B8":"" + B_8 + "","B9":"" + B_9 + "","B10":"" + B_10 + ""}",5,PRIVATE);

關(guān)于下面的 Photon 固件中定義的常量，有幾點(diǎn)需要牢記。樣本數(shù)必須是2的冪，采樣頻率必須是樣本數(shù)的整數(shù)倍。我們發(fā)現(xiàn) 4096 似乎是 Photon 可以可靠達(dá)到的最大采樣率。常量“harm”是每相捕獲的諧波數(shù)，“base_harm”是最低的。例如，我們將“base_harm”定義為 20，并且每相有 10 個(gè)諧波（20-200 是 20 的倍數(shù)）。我們的測(cè)試表明，這大致是我們項(xiàng)目有用信息的范圍。

驗(yàn)證并刷新您的固件（將代碼下載到您的設(shè)備）。此命令發(fā)布一個(gè)名為“GenericWebhookName”的事件，并生成一串 JSON 格式的文本，發(fā)送到我們之前創(chuàng)建的腳本。附加到上面字符串的變量是字符串類(lèi)型。如果一切順利，在您的Particle 控制臺(tái)中，您應(yīng)該會(huì)看到如下內(nèi)容：

?

現(xiàn)在返回您的電子表格，您應(yīng)該開(kāi)始看到添加了數(shù)據(jù)的行。在您設(shè)置為顯示 Sheet1 的最后 X 個(gè)條目的 Sheet2 上，您可以通過(guò)選擇列來(lái)創(chuàng)建圖表，并且圖表將隨著您的數(shù)據(jù)不斷更新。

附加工作表設(shè)置

現(xiàn)在您的工作表正在接收數(shù)據(jù)，您需要設(shè)置一個(gè)工作表來(lái)保存您將要測(cè)試的各個(gè)設(shè)備簽名。創(chuàng)建一個(gè)新工作表并將其命名為“Appliances”（appliance_id 腳本需要這個(gè)確切的名稱(chēng)才能工作）。第 1 行應(yīng)該是用于標(biāo)識(shí)列的標(biāo)題。

要獲取設(shè)備簽名，請(qǐng)打開(kāi)設(shè)備并在 Sheet1 上記下電流變化的位置。您可能需要多次打開(kāi)和關(guān)閉同一設(shè)備，記下時(shí)間，以便找到它的簽名。單相電器（如您的微波爐）只會(huì)出現(xiàn)在“A”相或“B”相下。像你的空調(diào)這樣的電器會(huì)在整排發(fā)生變化。一旦您在觀(guān)看 Sheet1 時(shí)“看到”您的設(shè)備打開(kāi)：

突出顯示并復(fù)制您注意到的更改前后的行：

?

接下來(lái)，返回 Appliances 工作表并將數(shù)據(jù)粘貼到一些空白單元格中：

在此數(shù)據(jù)下方插入一個(gè)計(jì)算差異的函數(shù)：

并將該公式復(fù)制到每一列下。完成整行后，突出顯示并將其粘貼到列表中的下一個(gè)空行中。使用“Ctrl+shift+V”粘貼以便僅粘貼值而不是公式。這種差異是您設(shè)備的特征。

將簽名數(shù)據(jù)復(fù)制到適當(dāng)?shù)男泻?，您可以刪除多余的數(shù)據(jù)并填寫(xiě)設(shè)備名稱(chēng)。您還可以在每個(gè)空白列中放置 0。appliance_id 腳本無(wú)論如何都會(huì)忽略幅度變化小于 1 的頻率（因?yàn)?a target='_blank' class='arckwlink_none'>信號(hào)被噪聲淹沒(méi)），因此為了整潔起見(jiàn)，您可以用 0 替換任何小于 1 的數(shù)字。完成后，它應(yīng)該看起來(lái)像這樣：

接下來(lái)，您需要一張表來(lái)記錄每日用電量。創(chuàng)建一個(gè)名為“DailyLog”的新工作表。對(duì)于第 1 行，AE 列應(yīng)標(biāo)記為“日期”、“A 階段”、“B 階段”、“總功率”和“總成本”，后續(xù)列與您的各個(gè)設(shè)備名稱(chēng)匹配，順序與它們列出的順序相同在您的設(shè)備表上。它看起來(lái)像這樣：

結(jié)束語(yǔ)

您現(xiàn)在應(yīng)該有一個(gè) Google Sheet 文檔，它正在從您的 Particle Photon 接收實(shí)時(shí)數(shù)據(jù)到 Sheet1。每天一次，在您指定的時(shí)間，應(yīng)該首先運(yùn)行 copy_delete 腳本，然后是 appliance_id 腳本，最后是 getDailyTotal 腳本。開(kāi)始項(xiàng)目時(shí)，因?yàn)槲覀儽Ａ袅?7 天的數(shù)據(jù)（如果您完全按照本教程進(jìn)行操作），getDailyTotal 腳本將刪除左側(cè)的第七個(gè)工作表（或選項(xiàng)卡）。因?yàn)槟幌Ｍ_本意外刪除您的“DailyLog”或“Appliances”工作表，所以您需要向文檔中添加七個(gè)空白工作表。該腳本從左側(cè)開(kāi)始計(jì)算表格并按位置刪除第七張表格，因此將您要保留的表格一直移到右側(cè)。有點(diǎn)像這樣：

?

copy_delete 觸發(fā)器，該工作表將被復(fù)制并重命名為當(dāng)天的日期，Sheet1 將被清除以開(kāi)始新的一天。

然后 appliance_id 腳本將梳理當(dāng)天的數(shù)據(jù)，并將每行中的幅度變化與 Appliances 表上的每個(gè)設(shè)備簽名進(jìn)行比較。它將為每個(gè)設(shè)備創(chuàng)建一個(gè)新列。該腳本基本上是從僅比較當(dāng)前更改開(kāi)始的。如果電流變化在電器簽名電流變化的 2 安培范圍內(nèi)，則它會(huì)繼續(xù)比較該電器簽名上幅度變化大于 1 的每個(gè)頻率。如果它們?cè)诒舜酥付ǖ墓罘秶鷥?nèi)（這可以在 appliance_id 腳本（Google 腳本中的第 104 行）的變量“公差”中更改），則腳本將插入該特定的消耗功率（以 kWh 為單位）該設(shè)備列下該行中的示例。一旦它被指定為“開(kāi)”，它只是根據(jù)設(shè)備簽名中的數(shù)量來(lái)查找電流，以確定它是否“關(guān)閉”。每個(gè)設(shè)備消耗的總功率被累加并放置在該設(shè)備列的第 3 行。腳本運(yùn)行后，當(dāng)天的數(shù)據(jù)將如下所示：

查看第 3 行，我們?cè)?A 列中有總小時(shí)數(shù)，在 B 和 M 列中有 A 相和 B 相消耗的功率（以千瓦時(shí)為單位），以及從 X 列開(kāi)始的每個(gè)設(shè)備消耗的功率。

最后，getDailyTotal 腳本將運(yùn)行并將這些總數(shù)復(fù)制到我們的 DailyLog 頁(yè)面。它應(yīng)該看起來(lái)像這樣：

?

您需要考慮 getDailyTotal 腳本中的幾個(gè)變量。第一個(gè)是成本變量，您需要將其定義為供應(yīng)商的成本/千瓦時(shí)電力。第二個(gè)是 days2keep 變量，它是您要保留數(shù)據(jù)的天數(shù)。Google 表格允許文檔中最多有 500 萬(wàn)個(gè)單元格（Google 云端硬盤(pán)支持），因此您無(wú)法無(wú)限期地存儲(chǔ)它們。在上面的代碼中，它被賦值為 7 以存儲(chǔ) 7 天。

當(dāng)您想出新的和創(chuàng)造性的方法來(lái)進(jìn)行計(jì)算、更有效地移動(dòng)數(shù)據(jù)或創(chuàng)建圖表和圖形來(lái)打動(dòng)您的朋友時(shí)，請(qǐng)分享您的想法！（不要忘記將這些新床單移到右邊！）

?

?