慶科云

概述

FogCloud是慶科云提供的一個物聯(lián)網(wǎng)智能云平臺。FogCloud提供功能強大的云端服務(wù)。這些服務(wù)包括 產(chǎn)品/APP管理 ，消息通道，數(shù)據(jù)存儲，設(shè)備狀態(tài) 數(shù)據(jù)遠(yuǎn)程同步 到手機設(shè)備，以及第三方 微信平臺開發(fā)，代碼托管，在線調(diào)試等功能。主要特點為：數(shù)據(jù)統(tǒng)計，智能觸發(fā)，OTA。FogCloud宣稱平臺提供完完全全的開發(fā)，徹徹底底的接地氣，真真正正的安全。

功能

1、產(chǎn)品(設(shè)備)與APP(用戶)管理
開發(fā)者可以在FogCloud網(wǎng)站創(chuàng)建自己的智能產(chǎn)品和對應(yīng)的App，并自定義產(chǎn)品屬性與數(shù)據(jù)模型，為每個App提供獨立的用戶管理系統(tǒng)。
2、消息通道
FogCloud使用開源的MQTT通信協(xié)議建立穩(wěn)定高速的消息通道，為設(shè)備和App提供高并發(fā)，高可用，低延遲，低功耗的通信服務(wù)，并提供簡單方便的API以及在線調(diào)試工具。
使用FogCloud的消息管理接口，開發(fā)者還可以實現(xiàn)數(shù)據(jù)遠(yuǎn)程同步，定時發(fā)送消息，以及計劃任務(wù)等擴展功能。
3、數(shù)據(jù)模型與數(shù)據(jù)存儲
數(shù)據(jù)模型
開發(fā)者可以在FogCloud控制臺針對不同硬件產(chǎn)品類型靈活地自定義數(shù)據(jù)模型，打造自己專屬的智能硬件產(chǎn)品。
FogCloud提供豐富的數(shù)據(jù)模型模板，極大地方便了開發(fā)者為不同的智能硬件類型迅速建立完善的數(shù)據(jù)模型。
數(shù)據(jù)存儲
基于FogCloud的數(shù)據(jù)模型，我們?yōu)殚_發(fā)者們提供了一套完整的數(shù)據(jù)存儲系統(tǒng)。讓開發(fā)者能夠快速、方便的將設(shè)備和App接入，而不必關(guān)心數(shù)據(jù)倉庫的建立和維護成本。
除了常規(guī)的數(shù)據(jù)儲存服務(wù)，F(xiàn)ogCloud還提供 按時間序列存儲 功能，以及簡單的 數(shù)據(jù)處理 和 數(shù)據(jù)按條件導(dǎo)出 功能，會保存數(shù)據(jù)更新的歷史記錄，進(jìn)行簡單的數(shù)據(jù)處理并自定義導(dǎo)出，方便開發(fā)者利用FogCloud的數(shù)據(jù)進(jìn)行數(shù)據(jù)分析。
4、云端轉(zhuǎn)碼
針對硬件發(fā)送的數(shù)據(jù)和app端數(shù)據(jù)格式不一樣的場景，F(xiàn)ogCloud還提供云端轉(zhuǎn)碼功能，您可以將轉(zhuǎn)碼代碼使用git倉庫托管并部署在FogCloud上，幫你自動轉(zhuǎn)碼。
5、OTA
FogCloud為硬件開發(fā)者提供查詢ROM最新版本信息的接口，開發(fā)者可以方便的為自己的智能硬件產(chǎn)品實現(xiàn)OTA功能，也可以讓阿里云等第三方托管在Fogcloud上的實現(xiàn)OTA。對于OTA更詳細(xì)的介紹您可以前往OTA頁面
6、計劃任務(wù)
FogCloud還提供計劃任務(wù)功能，通過此功能，我們可以為智能設(shè)備設(shè)定很多計劃任務(wù)。比如：為您的智能窗簾設(shè)定一個“每天晚上9：00放下窗簾；每天早上9：00拉起窗簾”的任務(wù)。如果您想更深入了解請前往計劃任務(wù)

交互

簡介
FogCloud是一個通用的開放平臺，為設(shè)備和App提供靈活的接入方式。要使用FogCloud將設(shè)備接入網(wǎng)絡(luò)，首先需要了解設(shè)備/App與FogCloud的交互流程。
設(shè)備/App使用FogCloud服務(wù)的流程分為三個步驟：
1，注冊： 設(shè)備/用戶注冊FogCloud，獲得在云平臺的唯一身份id。
2，綁定： 通過該流程完成某一用戶和某一設(shè)備的綁定關(guān)系。
3，通信： 使用FogCloud的消息服務(wù)傳輸數(shù)據(jù)及發(fā)送指令。
其中，注冊和綁定兩個過程使用FogCloud的Open API，而通信則使用FogCloud的MQTT服務(wù)器。
1，注冊
注冊包括產(chǎn)品下的設(shè)備注冊和App下的用戶注冊。如圖：

設(shè)備/用戶注冊

設(shè)備/用戶綁定

設(shè)備/用戶通信

使用方法

使用慶科云主要有四個步驟：注冊登錄-創(chuàng)建產(chǎn)品及APP-設(shè)備與APP通訊-APP/Device連接mqtt服務(wù)器
創(chuàng)建完產(chǎn)品及APP后就可以對其進(jìn)行管理了。

產(chǎn)品管理

慶科云的產(chǎn)品管理頁面提供產(chǎn)品信息頁面、設(shè)備列表頁面、數(shù)據(jù)模型頁面、觸發(fā)器頁面、ROM發(fā)布頁面、云端轉(zhuǎn)碼頁面、開發(fā)者管理頁面。

APP管理

慶科云的APP管理頁面提供App信息頁面、用戶列表頁面、開發(fā)者管理頁面。若是微信APP，還提供git部署 ， 微信菜單。

設(shè)備與APP的通訊

配置了產(chǎn)品與APP之后，就可以進(jìn)行代碼配置和調(diào)試了。
FogCloud的接口使用 HTTP 協(xié)議，請求響應(yīng)都使用 JSON 格式。
具體的調(diào)試方法請見設(shè)備和App與云交互概要
總結(jié)來說，設(shè)備與APP通訊主要有四個步驟：APP用戶注冊并登錄-Device配網(wǎng)-Device注冊-APP與Device綁定。

注：慶科云的APP與設(shè)備綁定必須在同一WiFi環(huán)境下

慶科云的APP與設(shè)備綁定使用的是FogCloud的HTTP OpenAPI。

App/Device的即時通信不需要再調(diào)用FogCloud的HTTP OpenAPI，而是使用FogCloud的MQTT服務(wù)器。

用戶與APP管理功能詳解

用戶管理

點擊 產(chǎn)品圖標(biāo)，可以進(jìn)入該產(chǎn)品詳情頁，其中包含七個頁面，頁面依次是：產(chǎn)品信息、設(shè)備列表、數(shù)據(jù)模型、觸發(fā)器、ROM發(fā)布、云端轉(zhuǎn)碼、開發(fā)者管理，當(dāng)中包含了設(shè)備詳情頁面：設(shè)備信息、MQTT測試、數(shù)據(jù)點統(tǒng)計、在線統(tǒng)計。
1、產(chǎn)品信息
產(chǎn)品信息： 列出了產(chǎn)品的基本信息。點擊 紅色筆 按鈕，可以對產(chǎn)品的基本信息進(jìn)行修改。點擊 刪除此產(chǎn)品 可以將該產(chǎn)品刪除，包括該產(chǎn)品下的所有設(shè)備都會被刪除。下面的地圖顯示該產(chǎn)品下的設(shè)備的地址。
2、設(shè)備列表
設(shè)備列表： 展示該產(chǎn)品下已經(jīng)注冊的設(shè)備。如果該產(chǎn)品下的設(shè)備比較多，你可以根據(jù)mac地址來對該設(shè)備進(jìn)行 搜索 。導(dǎo)出 按鈕可以導(dǎo)出csv格式的設(shè)備列表信息。同步到微信 按鈕可以選擇你的產(chǎn)品及對應(yīng)的微信app，點擊 同步 后，可獲取對應(yīng)微信號下的設(shè)備二維碼。點擊 紅色+ 按鈕，創(chuàng)建注冊一臺或者多臺新設(shè)備，注冊多臺新設(shè)備時，MAC地址換行支持批量創(chuàng)建。
點擊 設(shè)備圖標(biāo) 進(jìn)入該設(shè)備的詳情頁面。在設(shè)備詳情頁面中包含4個頁面，依次為：設(shè)備信息、MQTT測試、數(shù)據(jù)點統(tǒng)計、在線統(tǒng)計。
2.1、設(shè)備信息
設(shè)備信息： 顯示設(shè)備的基本信息。可以點擊 刪除該設(shè)備 按鈕將該設(shè)備從產(chǎn)品中完全刪除，刪除后設(shè)備信息會被注銷，且該設(shè)備與其他用戶的綁定關(guān)系會全部丟失。
2.2、MQTT測試
MQTT測試: 針對當(dāng)前設(shè)備的MQTT頻道進(jìn)行調(diào)試，頁面自動為你訂閱了device_id/in和device_id/out頻道，這兩個頻道內(nèi)有消息時會自動顯示在請求日志下面。
2.3、數(shù)據(jù)點統(tǒng)計
數(shù)據(jù)點統(tǒng)計: 如果你的數(shù)據(jù)模型設(shè)置為按時間序列存儲，并且使用MQTT服務(wù)器的device _id/out頻道發(fā)布了該數(shù)據(jù)模型的信息，數(shù)據(jù)點統(tǒng)計頁面就會顯示數(shù)據(jù)模型的時間序列信息統(tǒng)計圖。提供的統(tǒng)計方式是一天、一周、30天。

2.4、在線統(tǒng)計
在線統(tǒng)計: 顯示設(shè)備的在線狀態(tài)統(tǒng)計信息，有藍(lán)色顯示的時間范圍為設(shè)備在線，設(shè)備離線時段圖標(biāo)顯示為空白。
3、數(shù)據(jù)模型
數(shù)據(jù)模型: 這是FogCloud的核心功能。我們建議開發(fā)者為產(chǎn)品的所有數(shù)據(jù)點創(chuàng)建數(shù)據(jù)模型，如果設(shè)置該數(shù)據(jù)點的時間序列屬性為true，則可以使用datapoints接口查詢到該數(shù)據(jù)點的歷史數(shù)據(jù)(時間序列的數(shù)據(jù)點建議不超過5個)。點擊 紅色+ 按鈕，添加新的數(shù)據(jù)點。
其包括以下幾個屬性：

a. 數(shù)據(jù)模型參數(shù)：必填項，屬性變量名。
b. 屬性名：屬性實際代表的描述名稱，例如：“溫度、舉例、重量等”。
c. 時間序列：選擇是，表示屬性存儲將會以時間為順序，全部記錄下來。例如：空氣凈化器的PM值，都將按照時間戳先后順序，存儲在云端。選擇否，則表示，之后的數(shù)據(jù)存儲將以覆蓋形式存儲，適用于一些只有最終狀態(tài)有意義的屬性，例如：設(shè)備當(dāng)前在線狀態(tài)，等等。
d. 參數(shù)類型：int、bool等類型
e. 描述：關(guān)于數(shù)據(jù)模型的說明。

4、觸發(fā)器
觸發(fā)器:此功能基于產(chǎn)品的數(shù)據(jù)模型功能，可以選擇一個數(shù)據(jù)點并設(shè)置數(shù)據(jù)點的數(shù)值監(jiān)聽條件，如果條件觸發(fā)則訪問指定的url實現(xiàn)自定義的功能。點擊 紅色+ 按鈕，創(chuàng)建新的觸發(fā)器。
您可以根據(jù)自己產(chǎn)品的需求，對之前創(chuàng)建的某些數(shù)據(jù)模型進(jìn)行監(jiān)控，達(dá)到您設(shè)置的臨界點時，事件觸發(fā)。包括以下幾個屬性：

a.名字：你的事件觸發(fā)的名字
b.數(shù)據(jù)模型：選擇你在上一步中創(chuàng)建的數(shù)據(jù)模型
c.時間間隔：如果事件發(fā)生，希望去執(zhí)行的時間，若為0就是立即執(zhí)行
d.比較：5種條件選擇，自己根據(jù)需求挑選
e.閾值：事件觸發(fā)達(dá)到的極限值，自己定義
f.調(diào)用URL(POST)：調(diào)用觸發(fā)器的地址

5、ROM發(fā)布
ROM發(fā)布:設(shè)備固件的開發(fā)者在這將新版rom發(fā)送到云端，實現(xiàn)設(shè)備的遠(yuǎn)程自動升級。點擊紅色+按鈕上傳固件。
需要填寫以下幾個參數(shù)：

a. version（必須）：您發(fā)布ROM的版本號
b. 版本類別：分為alpha、beta、release和eol。可以根據(jù)您目前ROM的情況自由選擇
c. corename：發(fā)布代號（別名）
d. 上傳文件（必須）：請選擇要上傳的ROM固件的文件

最后點擊上傳，即可完成ROM在線托管。并附有下載地址。
6、云端轉(zhuǎn)碼
云端轉(zhuǎn)碼:該功能就是針對設(shè)備端和App端消息不一致的場景，F(xiàn)ogCloud會使用開發(fā)者上傳的轉(zhuǎn)碼腳本將消息轉(zhuǎn)換格式后發(fā)送。添加git倉庫地址來部署自定義的轉(zhuǎn)碼腳本。
需要填寫以下幾個參數(shù)：

a. Repo（必須）：如果您的項目在git上是公開的，請?zhí)顚戫椖縣ttp地址；如果是加密的，請?zhí)顚慡SH地址
b. Deploy Key（參考）：只有在項目是加密的情況下，需要在git的deploy_keys中將FogCloud的SSH Key加入您的項目，這樣FogCloud就能自動讀取您的代碼。
c. Web Hook Url：請將此項加入您Git項目的Web Hooks中，以便在您更新您的代碼時，F(xiàn)ogCloud能自動獲取發(fā)布。否則您需要手動到FogCloud發(fā)布。

最后點擊發(fā)布即可完成云轉(zhuǎn)碼托管。
7、開發(fā)者管理
開發(fā)者管理: 點擊 紅色+ 按鈕，輸入其他開發(fā)者的用戶名，點擊添加，即為您的產(chǎn)品添加了協(xié)同開發(fā)者，我們建議固件開發(fā)者和App開發(fā)者互相添加，更有利于協(xié)作開發(fā)。

APP管理

點擊 App圖標(biāo) 進(jìn)入該App的詳情頁，其包含三個頁面：App信息、用戶列表、開發(fā)者管理。
1、App信息
App信息:展示App基本屬性信息。你可以點擊 紅色筆 編輯按鈕編輯App的基本信息。SMS Server為可配置項，如果你的App支持手機號碼注冊，可以在這里配置短信服務(wù)器，F(xiàn)ogCloud現(xiàn)在支持yuntongxun.com的短信服務(wù)，你需要在云通訊網(wǎng)站注冊并配置app與短信模板，并在這里配置對應(yīng)的信息。 點擊 刪除此App 按鈕，可以將該App刪除，同時該產(chǎn)品下所有用戶也會被刪除。
2、用戶列表
用戶列表: 展示該App下已經(jīng)注冊的用戶。
點擊編輯按鈕可以進(jìn)入用戶管理頁面。
2.1、用戶信息
用戶信息:展示用戶基本信息，App的客服可以點擊 紅色筆 為用戶修改密碼。
2.2、用戶設(shè)備
用戶設(shè)備:展示該用戶綁定的設(shè)備列表。App的客服可以在這里為用戶解綁設(shè)備。點擊設(shè)備可以進(jìn)入設(shè)備管理頁面。
3、開發(fā)者管理
開發(fā)者管理:點擊 紅色+ 按鈕，輸入其他開發(fā)者的用戶名，點擊添加，即可以為你的產(chǎn)品添加協(xié)同開發(fā)者，建議固件開發(fā)者和App開發(fā)者互相添加，更有利于協(xié)作開發(fā)。