樂鑫原廠參考資料3-cld-espressif cloud introduction_v3

1、樂鑫信息科技EspressifSystemsEspressif Cloud IntroductionBy Yu FeiJun. 25, 2014Agenda 概述 產(chǎn)品管理 設(shè)備開發(fā) 如何新建設(shè)備？ 如何新建產(chǎn)品？ 創(chuàng)建master-device-key.binEspressif Systems Confidential2018年10月4日概述智能家電控制Espressif Systems Confidential2018年10月4日Espressif Cloud基于網(wǎng)絡(luò)互連，通過Espressif 云端服務(wù)實(shí)現(xiàn)家電的網(wǎng)絡(luò)化、智能化，人們不用在家里便可遙控掌握家中電器，讓生活更加優(yōu)質(zhì)便捷。 隨

2、時(shí)隨地了解家電的狀況。 遠(yuǎn)程控制家中電器運(yùn)行關(guān)閉。 海量存儲(chǔ)歷史記錄。Espressif Systems Confidential2018年10月4日Espressif Cloud4網(wǎng)址： /Espressif Systems Confidential2018年10月4日Espressif Cloud1、設(shè)備開發(fā) 顯示用戶常用于開發(fā)的設(shè)備列表。 針對(duì)開發(fā)者調(diào)試單個(gè)設(shè)備。2、產(chǎn)品管理 依據(jù)產(chǎn)品名稱分類，顯示產(chǎn)品列表。 針對(duì)商業(yè)管理各類產(chǎn)品。3、開始 “開發(fā)者API”： 提供API說明。 “幫助”： 提供使用指南。Espressif Systems Co

3、nfidential2018年10月4日產(chǎn)品 VS 設(shè)備“產(chǎn)品”是同一款“設(shè)備”的合集。例如： 針對(duì)產(chǎn)品類型“燈”，開發(fā)兩款不同的燈，產(chǎn)品命類名為型“宙斯”和“赫拉”。燈“說產(chǎn)明品：管理”中顯示: “宙斯”、“赫拉”產(chǎn)兩品款名產(chǎn)稱品，?？梢园葱枞我饷！霸O(shè)備開發(fā)”顯示：產(chǎn)品列表“宙斯”“赫拉”經(jīng)常調(diào)試的設(shè)備，處于“開發(fā)中”狀態(tài)的設(shè)備。適用于開發(fā)者調(diào)試。設(shè)備列表“宙斯”1“宙斯”2“赫拉”1Espressif Systems Confidential2018年10月4日產(chǎn)品管理產(chǎn)品管理(1/4)顯示當(dāng)前用戶下的產(chǎn)品列表。例那如么，我我開在發(fā)Es了pressif假設(shè)“humiture”“whue

4、mbsitituer登e”（陸溫后濕，度就計(jì)能）在（溫濕度計(jì)）生產(chǎn)了552個(gè)，投放市場(chǎng)， 在產(chǎn)品管理中可以看和“產(chǎn)“l(fā)品igh管t”（理燈”中），看兩到這款兩產(chǎn)款品產(chǎn)。品。到產(chǎn)，品該名產(chǎn)稱品：一“h共um5i5tu2re”個(gè)狀，態(tài)其：中de8p6lo個(gè)y已ed經(jīng)在客已戶經(jīng)端發(fā)被布激，活投使放用市。場(chǎng)。產(chǎn)品名稱：“l(fā)ight”狀態(tài)：developing開發(fā)中Espressif Systems Confidential2018年10月4日產(chǎn)品管理(2/4)在列表中，點(diǎn)擊任一產(chǎn)品，獲取該產(chǎn)品信息： 獲取當(dāng)前產(chǎn)品下的已激活設(shè)備數(shù)量 編輯或新創(chuàng)建當(dāng)前產(chǎn)品的屬性值 更新ROM BIN 獲取當(dāng)前產(chǎn)品下的所有

5、設(shè)備列表（產(chǎn)品管理）（數(shù)據(jù)模型）（ROM發(fā)布）（設(shè)備列表）例如，點(diǎn)擊產(chǎn)品“humiture”Espressif Systems Confidential2018年10月4日產(chǎn)品管理(3/4)產(chǎn)品名稱：“humiture”產(chǎn)品狀態(tài)：Deployed 已發(fā)布已激活數(shù)量/總數(shù)量：86/552ROM BIN用于軟件升級(jí)“數(shù)據(jù)模型”中顯示產(chǎn)品有哪些屬性。Espressif Systems Confidential2018年10月4日產(chǎn)品管理(4/4)該產(chǎn)品的設(shè)備列表列沒出有產(chǎn)顯品示出來的設(shè)備，“怎hu么m辦itu？re”的設(shè)備可以通過設(shè)備信息導(dǎo)出產(chǎn)品批量創(chuàng)建列表，因數(shù)量較大（552個(gè)），會(huì)僅列出100個(gè)

6、。（名稱、序列號(hào)等），“humitu“rheu”的miture”搜索設(shè)備。設(shè)備列表設(shè)。備。Espressif Systems Confidential2018年10月4日設(shè)備開發(fā)設(shè)備開發(fā)(1/4)設(shè)備列表，便于開發(fā)者調(diào)試單個(gè)設(shè)備。通過設(shè)備信息選擇導(dǎo)列創(chuàng)出出建設(shè)某一備產(chǎn)個(gè)列品新表設(shè)。備。（名稱、序列號(hào)下的設(shè)備。等），搜索設(shè)備例。如，列出產(chǎn)品“humiture”的設(shè)備。Espressif Systems Confidential2018年10月4日設(shè)備開發(fā)(2/4)在列表中，點(diǎn)擊任一設(shè)備，提供以下內(nèi)容： 獲取當(dāng)前設(shè)備的device key 獲取當(dāng)前設(shè)備的歷史數(shù)據(jù) 修改當(dāng)前設(shè)備的數(shù)據(jù)值 查看指令日志

7、（密鑰）（數(shù)據(jù)模型）（數(shù)據(jù)模型）（請(qǐng)求日志）在列表中，點(diǎn)擊任一設(shè)備Espressif Systems Confidential2018年10月4日設(shè)備開發(fā)(3/4)設(shè)備本名設(shè)稱備：屬t于es產(chǎn)t-d品em“hou。miture”。設(shè)備與Server之間的請(qǐng)求記錄。用于開發(fā)者調(diào)試設(shè)備的屬性。例如，“開關(guān)”屬性(plug-status)?！熬庉嫛笨梢孕薷膶傩灾?。例如，更改“開關(guān)”的狀態(tài)。Device key、owner key 。用于設(shè)備控制。點(diǎn)擊“數(shù)據(jù)”，查 看“開關(guān)”歷史數(shù) 據(jù)。如，9點(diǎn)42分開關(guān)打開；9點(diǎn)43分開關(guān)關(guān)閉。Espressif Systems Confidential2018年1

8、0月4日設(shè)備開發(fā)(4/4)數(shù)據(jù)模型中的“編輯”，可以修改當(dāng)前設(shè)備的數(shù)據(jù)值。例如，將開關(guān)的值改為1，則開關(guān)打開； 將開關(guān)的值改為0，則開關(guān)關(guān)閉。“開設(shè)關(guān)置將數(shù)x據(jù)=1值選到擇設(shè)“設(shè)備置”：數(shù)修據(jù)改值D”，ev則iceS的erv數(shù)er據(jù)記。用錄于的支開持關(guān)反數(shù)向據(jù)控變制為的1，設(shè)備但，De如vic開e開關(guān)關(guān)。并不會(huì)打開。開關(guān)應(yīng)當(dāng)選擇“設(shè)置數(shù)據(jù)值到設(shè)備”。“設(shè)置數(shù)據(jù)值”：修改Server中存儲(chǔ)的數(shù)據(jù)。用于不能反向控制的設(shè)備，如溫濕度計(jì)。Espressif Systems Confidential2018年10月4日定時(shí)器功能FIXEDTIME 精確時(shí)間定時(shí)器。在固定的某時(shí)間執(zhí)行某動(dòng)作。LOOP_PE

9、RIOD 周期定時(shí)器。每隔多久執(zhí)行一次某動(dòng)作。LOOP_IN_WEEK 按周循環(huán)定時(shí)器。每周的某時(shí)間執(zhí)行某動(dòng)作。創(chuàng)建定時(shí)器。定時(shí)器的詳細(xì)介紹，請(qǐng)參見文檔“Espressif 定時(shí)器功能”。Espressif Systems Confidential2018年10月4日RPC - 靈活的反向控制提例供如靈自活定的義反ac向tio控n“制lev。el_up”,控制調(diào)開節(jié)發(fā)燈者光可更以亮自。定義action，來控制在設(shè)sd備k的。代碼中需實(shí)現(xiàn)對(duì)“l(fā)evel_up”的響應(yīng)Owner key自定義的action名稱，可帶參數(shù)。發(fā)送請(qǐng)求RPC的詳細(xì)介紹，參見文檔“Espressif IoT Demo使用手

10、冊(cè)”。Espressif Systems Confidential2018年10月4日云端升級(jí)功能某產(chǎn)品的軟件更新時(shí)（產(chǎn)品管理 -某產(chǎn)品-ROM發(fā)布），該產(chǎn)品下的設(shè)備都會(huì)收到消息行選擇是否升級(jí)。，用戶可自新消息。設(shè)備頁面“ROM發(fā)布”。可選擇是否升級(jí)，升級(jí)哪個(gè)版本的軟件。云端升級(jí)的詳細(xì)介紹，請(qǐng)參見文檔“云端升級(jí)實(shí)現(xiàn)方案”。Espressif Systems Confidential2018年10月4日如何新建設(shè)備？創(chuàng)建設(shè)備(1/4)在“設(shè)備開發(fā)”中點(diǎn)擊“創(chuàng)建”，創(chuàng)建一個(gè)新設(shè)備。創(chuàng)建一個(gè)新設(shè)備。Espressif Systems Confidential2018年10月4日設(shè)備名稱。例如，命名為

11、新建設(shè)備屬于哪種產(chǎn)品；“my-test-01”可以選擇已有產(chǎn)品，也可私有設(shè)備，無法分享。 以新建一種產(chǎn)品。公開設(shè)備，可以將設(shè)備分例如，本設(shè)備仍是創(chuàng)建一享給其他用戶。個(gè)“humiture”產(chǎn)品的設(shè)建議設(shè)置為“公開設(shè)備”。備。創(chuàng)建設(shè)備(2/4)配置完成后，點(diǎn)擊“創(chuàng)建”。支持批量創(chuàng)建。批量創(chuàng)建時(shí)，可生成master-device-key.bin，后文詳述。Espressif Systems Confidential2018年10月4日創(chuàng)建設(shè)備(3/4)創(chuàng)新建設(shè)完備成屬新于設(shè)產(chǎn)備品“mhuym-teitsutr-e0”1?！薄Ｐ略O(shè)備“my-test-01”具有產(chǎn)品“humiture”的各項(xiàng)屬性，例如

12、“開關(guān)”屬性（plug-status）。Espressif Systems Confidential2018年10月4日創(chuàng)建設(shè)備(4/4)產(chǎn)品管理中，“humiture”的總數(shù)量增加，變?yōu)?53。產(chǎn)品“humiture”的設(shè)備列表中， 增加了設(shè)備“my-test-01”。Espressif Systems Confidential2018年10月4日如何新建產(chǎn)品？新建產(chǎn)品Espressif 無法抽象的新建一個(gè)產(chǎn)品，創(chuàng)建新產(chǎn)品，還是得從創(chuàng)建一個(gè)新產(chǎn)品的設(shè)備開始?！霸O(shè)備開發(fā)” - “創(chuàng)建”，創(chuàng)建設(shè)備。創(chuàng)建設(shè)備。Espressif Systems Confidential2018年10月4日新設(shè)備名

13、稱。例如，命名為“new-test”私有設(shè)備，無法分享。 公開設(shè)備，可以將設(shè)備分享給其他用戶。建議設(shè)置為“公開設(shè)備”。新建設(shè)備屬于哪種產(chǎn)品可以選擇已有產(chǎn)品，也以新建一種產(chǎn)品。此時(shí)我們選擇新產(chǎn)品的名字?！皠?chuàng)建新的產(chǎn)品假設(shè)，我們創(chuàng)建一個(gè)亞”。牌的空調(diào)，產(chǎn)品命名為“Adam-Air-Conditioner產(chǎn)品類型。選擇“空調(diào)”；可當(dāng)”配置完成后，點(diǎn)擊“創(chuàng)建”。支持批量創(chuàng)建。Espressif Systems Confidential2018年10月4日創(chuàng)建完成設(shè)備本名設(shè)稱備：屬n于ew產(chǎn)-te品s“t。Adam-Air-Conditioner”。Espressif Systems Confident

14、ial2018年10月4日產(chǎn)品管理在“產(chǎn)品管理”中，會(huì)看到新創(chuàng)建的產(chǎn)品“Adam-Air- Conditioner”。產(chǎn)品ID：42產(chǎn)品名稱： Adam-Air-Conditioner 狀 態(tài) ：developing 開 發(fā) 中 A/T：目前該產(chǎn)品共有1個(gè)設(shè)備， 其中0個(gè)被激活使用。點(diǎn)擊新產(chǎn)品，進(jìn)入該產(chǎn)品頁面。Espressif Systems Confidential2018年10月4日產(chǎn)品信息管那理么產(chǎn)，品針屬對(duì)性本數(shù)產(chǎn)據(jù)品。為空調(diào)， 例為如其，創(chuàng)點(diǎn)目建擊前“開“數(shù)創(chuàng)關(guān)據(jù)建”和?！薄！靶蜏貫榭铡穸取眱蓚€(gè)數(shù)據(jù)模型。軟件的云端升級(jí)更新。本產(chǎn)品的設(shè)備列表。例如，前述創(chuàng)建的“new-test”設(shè)

15、備Espressif Systems Confidential2018年10月4日名稱“plug-status”。維度：表示帶幾個(gè)參同理，開發(fā)者可以自定義數(shù)據(jù)模在esp_iot_sdk的代碼中，可搜開關(guān)數(shù)據(jù)，僅帶1個(gè)型名稱，并在“plug-statussdk代碼中實(shí)現(xiàn)?！币虼耸且痪S。索到針對(duì)的實(shí)現(xiàn)。單位、符號(hào)、標(biāo)簽、描述，均為說明性質(zhì)的信息，可選填。設(shè)置完成后，點(diǎn)擊創(chuàng)建。創(chuàng)建控制開關(guān)的數(shù)據(jù)模型。再創(chuàng)建一個(gè)溫濕度的數(shù)據(jù)模型。點(diǎn)擊“創(chuàng)建”。溫濕度數(shù)據(jù)模型名稱：tem_hum。同樣，在sdk的代碼中，能找到由于帶溫度、濕度兩“tem_hum”的解析。 因此是“二維”。設(shè)置完成后，點(diǎn)擊“創(chuàng)建”。數(shù)。參

16、數(shù)（開/關(guān)），數(shù)據(jù)模型創(chuàng)建完成。之后，每創(chuàng)建 一個(gè)Adam-Air-Conditioner的個(gè)設(shè)參備數(shù)，設(shè)備都會(huì)有這兩個(gè)屬性。在調(diào)試過 程中，也可按需創(chuàng)建其他數(shù)據(jù)模型。Espressif Systems Confidential2018年10月4日創(chuàng)建master-device-key.binmaster-device-key.bin如果使用 Espressif 的云端服務(wù)，需要登陸網(wǎng)站，申請(qǐng) master-device-key.bin，燒錄到設(shè)備 flash 中（位置： 0x3e000），標(biāo)示設(shè)備身份ID。Master-device-key.bin 實(shí)際名稱為長度40位的key值， 如下圖所

17、示。Espressif Systems Confidential2018年10月4日創(chuàng)建Master-device-key.bin表示設(shè)備唯一的身份信息，與設(shè)備是一一對(duì)應(yīng)的，因此需要在創(chuàng)建設(shè)備的時(shí)候獲取Master-device-key.bin 。點(diǎn)擊創(chuàng)建在設(shè)備開發(fā)頁面，點(diǎn)擊“創(chuàng)建”。Espressif Systems Confidential2018年10月4日點(diǎn)擊“批量創(chuàng)建”選擇生成哪個(gè)產(chǎn)品的設(shè)備。例如，溫濕度計(jì)。產(chǎn)品屬性。點(diǎn)擊“批量創(chuàng)建”。Espressif Systems Confidential2018年10月4日產(chǎn)品數(shù)量。支持創(chuàng)建多個(gè)。自定義產(chǎn)品批次。批次名稱自動(dòng)添加上時(shí)間戳。批次為：年月日-時(shí)分秒-自定義批次名稱。點(diǎn)擊“zip”，下載