C01. MCS 雲端控制 LED 開關

專案說明

透過控制 MCS (MediaTek Cloud Sandbox) 的 "開關"控制通道,來遠端操控 LinkIt 7697 開發板上的 USR LED 明暗。

實作此案例時, 必須先要先註冊一個 MCS 帳號 (免費)。

MCS 相關教學可以到 MCS > 資源 來學習, 在使用此範例前, 需先確認了解 MCS 的主要幾個主要概念

  • MCS 的通道(Data Channel) 有分兩種。 控制通道 (稱為 ControllerChannel, 從雲端控制開發板, 方向主要是 雲 → 開發板) 還有 顯示通道 (稱為 DisplayChannel, 在開發板收集資料丟到雲端顯示, 方向主要是 開發板 → 雲)
  • MCS 要先創建 產品原型 (Prototype), 再由這原型創建多個 測試裝置 (Test Device)
  • 每個 測試裝置 都有一個獨特的 DeviceIdDeviceKey, 開發板上執行的軟體透過這 Id 和 Key 和雲端的這測試裝置連接

目前 Blockly 有開出的資料通道為以下這些

雲端設定

在 MCS 建立一個含有 "開關控制通道" 的 (Prototype), 並使用這原型來創建一個使操作使用的測試裝置 (Test Device)
 

▼ 點選 創建 原型


▼ 幫原型取個名稱版本硬體平台選擇 "LinkIt 7697" , 產業和應用程式隨意選擇。 填完後按下 儲存



▼ 原型已創建成功, 點選 詳情


▼ 點選 新增 來新增 資料通道


▼ 原型已創建成功, 接下來就是 新增 "控制器型態" 的資料通道


▼幫資料通道取個名稱(隨意), 並取一個 Id (此 Id 會用於程式中來控制此通道), 然後選擇 "開關" 資料型態。 最後 儲存 此通道。


 
紅色圈圈為新增的 開關控制通道 , 紅色箭頭為這 資料通道 Id (會用在程式內)。 接下來就要用這原型創建一個測試裝置 (橘色箭頭)


▼幫這測試裝置取個裝置名稱, 並按下 創建 


測試裝置新增完成, 畫面上的三個紅色箭頭所指的 "資料通道 Id", "DeviceId", "DeviceKey" 為之後開發板上軟體開發時會用到的三個重要資料



 積木畫布

初始化

  • 建立 Wi-Fi 連線, 連到 AP (Wi-Fi SSID 和密碼請填寫要連接的 AP 的資料)
  • 建立 MCS 連線, 填入 DeviceID 和 DevieKey, 和前面建立的雲端測試物件做連接
  • 新增一個 "開關控制通道" (Switch ControllerChannel) 物件, 填入 控制通道 Id

重複執行

  • 第一步要加上 和 MCS 同步。 每次執行這一個積木, 程式會去和雲端做資料同步 
  • 檢查此 "開關控制通道" 是否有跟新資料
  • 若有新資料, 則讀取最新資料來開關板子上的 LED
     



產生出的 Arduino 程式如下

#include <LWiFi.h>
#include "MCS.h"

char _lwifi_ssid[] = "MediaTek_Labs";
char _lwifi_pass[] = "84149961";

MCSDevice mcs("DLg6BkHM", "BL60hjNKCHThyrW4");
MCSControllerOnOff MySwitch("MySwitch");

void setup()
{
  Serial.begin(9600);

  mcs.addChannel(MySwitch);
  Serial.println("Wi-Fi 開始連線");
  while (WiFi.begin(_lwifi_ssid, _lwifi_pass) != WL_CONNECTED) { delay(1000); }
  Serial.println("Wi-Fi 連線成功");
  while(!mcs.connected()) { mcs.connect(); }
  Serial.println("MCS 連線成功");
  Serial.begin(9600);
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop()
{
  while (!mcs.connected()) {
  	mcs.connect();
  	if (mcs.connected()) { Serial.println("MCS 已重新連線"); }
  }
  mcs.process(100);

  if (MySwitch.updated()) {
    Serial.print("控制通道更新 :");
    Serial.println(MySwitch.value());

    if (MySwitch.value()) {
      digitalWrite(LED_BUILTIN, HIGH);

    } else {
      digitalWrite(LED_BUILTIN, LOW);
    }
  }
  delay(1000);
}


於範例中插入一些 logs, 可以幫助了解目前狀態和除錯。


FAQ

Q: 如何確定 Wi-Fi 連線成功?

A: 可以加一些 log 來幫忙確認程式跑到哪裡了, 確定 Wi-Fi 有正確連線。 檢查 Wi-Fi SSID 和密碼是否正確, 大小寫是有差的



Q: 為何我的 Device 不會和雲端連動?

A: 先檢查下面三個值 (DeviceId, DeviceKey, 資料通道 ID) 是否都有正確複製貼上並沒有打錯字


 

Q: 為何我在 MCS 的開關按半邊都沒反應? 

A: 請先檢查你點的開關是不是在產品原型頁面。  實際和開發板連接的會是測試裝置頁面的資料通道點選產品原型內的那些資料通道是沒有用的~