LinkIt ONE：透過MediaTek Cloud Sandbox存取LED

LinkIt ONE不僅有硬體與軟體，聯發科還提供雲端服務MediaTek Cloud Sandbox，底下簡稱MCS。

這一篇要試著練習使用，在MCS上建立一台虛擬裝置，透過網頁介面可把LED設為ON，而實體裝置（LinkIt ONE板子）讀取後便會點亮真正的LED，並且會把LED狀態上傳到MCS的虛擬裝置，從網頁介面觀看顯示LED的狀態。

主要內容與程式碼，都來自於官方文件Implementing using Linkit ONE connecting to MediaTek Cloud Sandbox，並參考分享文[LinkIt One 教學] 連接 LinkIt ONE 到 MediaTek Cloud Sandbox | CAVEDU教育團隊技術部落格；關於MCS的網站操作介面，並不會詳細介紹，還請自行參閱MCS說明文件Getting Started和Key concepts。

流程如下：

1. 註冊MCS帳號，會寄一封確認郵件到你填寫的email信箱，點按其中的網址後便可啟動，然後輸入帳號密碼登入，進入MCS的Dashboard，如下圖。

2. 點按上方選單「Development」，新增Prototype。可把所謂的Prototype想像成是張藍圖，之後會以Prototype為樣板建立實際的裝置。

你可以建立多個Prototype，分別代表不同的應用，譬如收集氣溫數據、心跳讀數等等，此範例建立能存取板子內建LED的Prototype，命名為LED Commander。進入Prototype的細節頁面，上半部如下。

下半部才是重點，有Data channel，代表雲端服務與實體裝置之間想要溝通傳輸的資料；Notification可設定條件發出通知，譬如發出email，此篇不使用；User privileges設定不同使用者存取同一Prototype的權限，此篇不使用；Firmware管理韌體版本，是否進行空中更新，此篇不使用；Test device則是建立裝置，想像成存在於雲端中的虛擬裝置，與實體裝置（真正的板子）進行溝通。

3. 增加Data channel，此篇範例需要兩個，一個從實體裝置上傳LED狀態到雲端上的Test device，另一個由Test device設定LED狀態，讓實體裝置抓取並設定。目前可用的Data channel如下，其中Display是「顯示」，Controller則是「控制」，此篇分別需要一個。

建立Display的Data channel，如下，其中Data type設為On / OFF，代表LED亮滅；Data Channel Id非常重要，此範例命名為LED，之後程式碼必須使用此Id來指出想存取哪個Data channel。

再建立Controller的Data channel，如下，Data type同樣也是ON / OFF，經由網頁介面操作後，讓實體裝置抓取。Data Channel Id命名為LED_CONTROL。

Data channel建立完成後，便可看到如下的樣子。

4. 然後是建立Test device，隨便取個名字。

建立後，進入細節頁面，請記下DeviceId與DeviceKey，非常重要，代表實體裝置的身分，程式碼裡須使用，才能存取MCS雲端服務。

5. 以上便是MCS雲端介面需要做的操作動作，接下來便是程式，其中須使用程式庫HttpClient，可到此下載。底下程式碼，來自於MCS提供的範例，而我稍作修改，此處僅列出大概模樣，原始碼請到GitHub下載。

共有兩支檔案，其中settings.h記錄一些設定值：

#define WIFI_AP "__SSID__" // 填入WiFi網路名稱SSID
#define WIFI_PASSWORD "__PASSWORD__" // 填入WiFi密碼
#define WIFI_AUTH LWIFI_WPA // LWIFI_OPEN, LWIFI_WPA, LWIFI_WEP

#define SITE_URL "api.mediatek.com"
#define SITE_PORT 80
#define DEVICEID "__DeviceId__" // 填入你的DeviceId
#define DEVICEKEY "__DeviceKey__" // 填入你的DeviceKey

#define LED_ID "LED" // 填入顯示LED狀態的Data channel ID
#define LED_CONTROL_ID "LED_CONTROL" // 填入控制LED的Data channel ID

另一支檔案是主程式碼，概略如下：

// 方便輸出Serial的輔助函式
void pf(const char *fmt, ...){ /* 省略 */ }

// 初始化，連接WiFi網路
void setup(){ /* 省略 */ } 

// 取得MCS雲端服務網站的IP與連接埠
void getconnectInfo(){ /* 省略 */ }

// 建立連線，此連線負責取得控制LED的Data channel
void connectTCP(){ /* 省略 */ } 

// 上傳LED狀態
void uploadStatus(){ /* 省略 */ }

// 避免TCP斷線
void heartBeat(){ /* 省略 */ }

// 不斷上傳LED狀態，接收控制LED的資料
void loop(){ /* 省略 */ }

燒錄程式並重置開機，記得開啟序列埠監控視窗，才會開始動作；然後開啟瀏覽器進入MCS的Test device細節頁面，看到畫面如下。

點按控制頁面的LED_CONTROL，便可控制實體裝置（板子）內建的LED，其狀態會上傳到LED；可一邊觀察序列埠監控視窗的輸出訊息。

呼，完成囉。

參考資料：

• MediaTek Cloud Sandbox，入門手冊、API、論壇、各種文件；注意，註冊後可看到更多文件。
• Implementing using Linkit ONE，LinkIt ONE連接MCS的教學文件。
• [LinkIt One 教學] 連接 LinkIt ONE 到 MediaTek Cloud Sandbox | CAVEDU教育團隊技術部落格，CAVEDU教學分享文。
• [LinkIt One 教學] MediaTek Cloud Sandbox 控制 LED 並檢視狀態 – 可同時用手機與網頁來操作 | CAVEDU教育團隊技術部落格，CAVEDU教學分享文。
• LinkIt ONE IoT Demo - Hackster.io，使用Grove感測器，溫度、濕度、光、聲音。