連接到 MCS

Previous使用 MCS 函式庫 Next連接到 MCSLite

Last updated 3 years ago

連接到 MCS

MediaTek已經於 2021.4.16 停止 MCS 服務，如要使用請使用MCSLite

以下範例將介紹如何使用 MCS 函式庫提供的 MCSDevice 類別連接到 MCS 伺服器，並透過 MCS 網頁控制介面操縱 LinkIt 7697 板上的 USR LED。

建立 MCS 測試裝置

開啟建立新的產品原型、資料通道、以及測試裝置。在本範例中，需要建立兩個資料通道：

一個 "開/關" 類型的控制器通道。
以及一個 "開/關" 類型的顯示器通道。

若不清楚如何產生產品原型、資料通道、以及測試裝置，請參考頁面。

完成設置後，會產生如下的測試裝置頁面。需特別留意 Data channel Id、DeviceId、和 DeviceKey 欄位 (如下圖箭頭所指)，後續撰寫程式碼的過程中會使用這些資訊。

使用 MCS 函式庫連接 MCS

下列步驟將說明如何在程式裡，使用 device key 和 device ID 產生 MCSDevice 物件，並設置對應的資料通道，以連接到 MCS 平台服務。

1.點選 Arduino IDE 的 File > Examples > MCS > LED_control 選單。

2.由於需要 Wi-Fi 網路以連接 MCS，請依照使用的 AP 設定修改程式中的 Wi-Fi SSID 與 password 資訊

// Assign AP ssid/password here
#define _SSID "your_ssid"
#define _KEY  "your_password"

3.將 device ID 與 device key 填入 MCSDevice 類別的建構函式中：

// Assign device id/key of your test device
MCSDevice mcs("your_device_id", "your_device_key");

Device ID 和 device key 可從上述的 MCS 測試裝置頁面取得：

4.同樣地將 channel ID 填入資料通道類別的建構函式：

// Assign data channel ID 
MCSControllerOnOff led("your_channel1_id");
MCSDisplayOnOff    remote("your_channel2_id");

Channel IDs 可在 MCS 測試裝置頁面的資料通道資訊下方取得：

執行 Sketch

1.點選 Upload 按鈕並等待 Done Uploading 訊息顯示完成。

2.點選工具列的 Serial Monitor 按鈕開啟 Serial Monitor 視窗並將 Baud rate 設定為 9,600。

程式碼說明

在以上範例中，使用了 MCS 函式庫處理開發板與 MCS 伺服器之間的連線。使用函式庫需先加入 MCS 的 header file：

#include <MCS.h>

接著建立 MCSControllerOnOff 與 MCSDisplayOnOff 類別實體，用來控制事先在 MCS 網頁控制介面定義的兩個開/關資料通道 (控制器與顯示器)。建立時需將各資料通道所對應的 channel ID 傳入類別建構函式當中。

MCSControllerOnOff led("your_channel1_id");
MCSDisplayOnOff    remote("your_channel2_id")

下一步利用 device ID 與 device key 產生 MCSDevice 類別實體，使開發板對應到之前在 MCS 網頁控制介面產生的測試裝置。

MCSDevice mcs("your_device_id", "your_device_key");

相關實體建立完成後，使用 addChannel() 將資料通道加入至測試裝置，並呼叫 connect() 來連接至 MCS 伺服器。

  // setup MCS connection
  mcs.addChannel(led);
  mcs.addChannel(remote);
  while(!mcs.connected())
  {
    Serial.println("MCS.connect()...");
    mcs.connect();
  }

在 Arduino 的 loop() 裡，呼叫 updated() 檢查是否有來自開/關控制器通道的新資料，若有新的資料，則根據該數值設定 LED_PIN 所對應的 LED 明滅，並同時更新顯示器通道的數值，以在網頁控制介面正確呈現出開發板的狀態。

if(led.updated())
  {
    Serial.print("LED updated, new value = ");
    Serial.println(led.value());
    digitalWrite(LED_PIN, led.value() ? HIGH : LOW);
    if(!remote.set(led.value()))
    {
      Serial.print("Failed to update remote");
      Serial.println(remote.value());
    }
  }

Previous使用 MCS 函式庫 Next連接到 MCSLite

Last updated 3 years ago