MCSDevice

為了連接到 MCS 伺服器、並與 MCS 上的測試裝置傳送資料，需使用 MCSDevice 類別建立運作在開發板上的 MCS 裝置物件。更多細節請參考MCS 簡介。

建構函式

MCSDevice()

建立能連接到 MCS 伺服器的裝置。

Syntax

MCSDevice device(device_id, device_key)

MCSDevice device(device_id, device_key, mcs_server_url, mcs_server_port)

Parameters

device_id：在 MCS 上建立的測試裝置 ID。

device_key：在 MCS 上建立的測試裝置 key。

mcs_server_url：MCS 伺服器的位置。此參數為選擇性帶入，若沒有提供的話，預設會連線至 "api.mediatek.com"。

• • MCS Global：欲連接至 MCS Global，請瀏覽 https://mcs.mediatek.com 頁面並在 MCS API 的伺服器 URL 指定 "api.mediatek.com"。

  • MCS China：欲連接至 MCS China，請瀏覽 https://mcs.mediatek.cn 頁面並在 MCS API 的伺服器 URL 指定 "api.mediatek.cn"。

mcs_server_port：MCS 伺服器的通訊埠。此參數為選擇性帶入，若沒有提供的話，預設連接埠為 80。

Returns

device 為 MCSDevice 類別的實體。

函式

addChannel()

將資料通道加入至 MCSDevice 實體。

Syntax

device.addChannel(data_channel_instance)

Parameters

data_channel_instance：繼承自 MCSDataChannel 的類別實體。

Returns

無

connect()

Description

連接至指定的 MCS 伺服器。

Syntax

device.connect()

Parameters

device：MCSDevice 類別實體。

Returns

若連接成功則回傳布林值 true，反之若有錯誤發生則回傳 false。

connected()

Description

檢查連線是否成功。

Syntax

device.connected()

Parameters

device：MCSDevice 類別實體。

Returns

若連線成功則回傳布林值 true，反之若連線已中止則回傳 false。

process()

Description

處理來自 MCS 伺服器的資料。

Syntax

device.process(timeout_value)

Parameters

timeout_value：此參數為選擇性帶入。用來指定多久時間後 (單位為 millisecond 毫秒) 繼續執行 loop() 函式內後續的程式碼。若沒有指定的話，則以 setDefaultTimeout() 函式的設定值為準。預設的 timeout 時間為 30 秒。

Returns

無

setDefaultTimeout()

Description

設定 process() 函式所使用的 timeout 值。

Syntax

device.setDefaultTimeout(default_timeout_value)

Parameters

default_timeout_value：欲設定的 timeout 值 (單位為 millisecond 毫秒)。

Returns

無