MXCWNCS Microflex® Complete Wireless 命令字串

裝置透過乙太網路連線至控制系統,例如 AMX、Crestron 或 Extron。

連線:乙太網路(TCP/IP;在 AMX/Crestron 程式中選擇「用戶端」)

連接埠:2202

慣例

具有 4 種字串類型:

GET(取得) 尋找參數狀態。在 AMX/Crestron 傳送 GET(取得)命令後,裝置會以 REPORT(回報)字串回應
SET(設定) 變更參數狀態。在 AMX/Crestron 傳送 SET(設定)命令後,裝置會以 REPORT(回報)字串回應,以指示新的參數值。
REP(回報) 裝置收到 GET(取得)或 SET(設定)命令時,會以 REPORT(回報)命令回覆,以指示參數狀態。在 MXCWNCS 上或透過 GUI 變更參數時,該裝置也會傳送 REPORT(回報)。
SAMPLE(採樣) 用於測定音訊電平。

傳送和接收的所有訊息都是 ASCII。請注意,電平指示器和增益指示器也是使用 ASCII。

大部分的參數會在變更時傳送 REPORT(回報)命令。因此,不必持續查詢參數。裝置將會在任何這些參數變更時傳送 REPORT(回報)命令。

索引

索引專門用來識別哪個命令字串目前正在運作。

0 全部
1 到 10 艙數

Command Strings

ALL

說明 擷取所有支援的命令
支援的命令 GET(取得)和 REP(回報)
索引

0:所有裝置或艙屬性

n:所有裝置或艙 n 屬性

範例

< GET 0 ALL >:以 REP(回報)回應所有特定裝置屬性和 ALL(所有)索引相關屬性,包括所有測定屬性。

< GET n ALL >:以 REP(回報)回應所有特定裝置屬性和 ALL(所有)索引 n 相關屬性,包括所有測定屬性。

MODEL

說明 擷取型號名稱
支援的命令 GET(取得)和 REP(回報)
索引

格式:32 個字元字串

範例

< GET MODEL >
< REP MODEL {MXCWNCS} >

FLASH

說明 開啟閃爍以識別裝置
支援的命令 GET(取得)、SET(設定)和 REP(回報)
索引

格式:固定字串

OFF

ON

範例

< GET FLASH >
< REP FLASH OFF >

< SET FLASH ON >
< REP FLASH ON >

< SET FLASH OFF >
< REP FLASH OFF >

FW_VER

說明 擷取韌體版本
支援的命令 GET(取得)和 REP(回報)
索引

格式:24 個字元字串

以點分十進位標記法表示的套件版本號碼:Maj.Min.Pack.Build<SelfTestFailed=*>

範例 通過自行測試的範例:

< GET FW_VER >
< REP FW_VER {2.0.15.2} >

自行測試失敗的範例:

< GET FW_VER >
< REP FW_VER {2.0.15.2*} >

DEVICE_ID

說明 擷取和設定裝罝 ID
支援的命令 GET(取得)、SET(設定)和 REP(回報)
索引

格式:REP(回報)的 31 個字元字串

來自下列集合的 1-31 個字元:-0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

所有 DNS 名稱和標籤長度最多為 31 個字元

名稱和標籤比較不必區分大小寫;"Guitar" 和 "guitar" 視為相同的標籤來處理。不支援萬國碼和非羅馬字元。

裝置名稱應遵守網域名稱系統 (DNS) 主機名稱規則。法定字元為 A-Z、a-z、0-9 和 "-"(破折號或連字號)。

裝置名稱必須以 A-Z(或 a-z)或 0-9 開頭。

範例

< GET DEVICE_ID >
< REP DEVICE_ID {MXCWNCS} >

< SET DEVICE_ID {4 Pop} >
< REP DEVICE_ID {4 Pop} >

STORAGE_MODE

說明 擷取和設定存放模式
支援的命令 GET(取得)、SET(設定)和 REP(回報)
索引

格式:固定字串

OFF

ON

切換(僅限 SET(設定))

範例

< GET STORAGE_MODE >
< REP STORAGE_MODE OFF >

< SET STORAGE_MODE ON >
< REP STORAGE_MODE ON >

< SET STORAGE_MODE TOGGLE >
< REP STORAGE_MODE OFF >

BATT_DETECTED

說明 偵測電池
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:固定字串

YES

NO

範例

< GET 10 BATT_DETECTED >
< REP 10 BATT_DETECTED YES >

BATT_STATE

說明 擷取電池狀態
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:固定字串

FULL

CALCULATING

NORMAL

WARM

WARM_FULL

HOT

COLD

PRECHARGE

READY_TO_STORE

DISCHARGE_CALC

DISCHARGING

DISCHARGING_WARM

DISCHARGING_COLD

ERROR(錯誤):在此情況可看見對應錯誤代碼的 BATT_ERROR

NO_BATT

範例

< GET 1 BATT_STATE >
< REP 1 BATT_STATE NORMAL >

一段時間後,電池電量已滿:

< REP 1 BATT_STATE FULL >

BATT_ERROR

說明 檢視電池錯誤
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:3 個數字

000:無作用中的錯誤

001:未知模組

002:無法辨識的電池

003:深度放電復原失敗

004:充電失敗

005:檢查電池

006:檢查充電器

007:通訊失敗

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例

< GET 1 BATT_ERROR >
< REP 1 BATT_ERROR 000 >

BATT_BARS

說明 擷取電池艙數
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:3 個數字

000-005:回報的條數

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例

< GET 1 BATT_BARS >
< REP 1 BATT_BARS 003 >

一段時間後,會產生非同步報告:

< REP 1 BATT_BARS 004 >

BATT_TIME_TO_FULL

說明 充飽電的目標時間
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:5 個數字

備註:可以視為目標時間,其中:

  • 充電模式:值是距離充飽電的預計時間
  • 存放模式:值是距離最佳存放電壓的預計時間

00000 - 65528:達到目標的預計分鐘數

65529:電池已充飽電

65530:電池過熱

65531:電池溫熱

65532:電池涼冷

65533:計算正在進行中

65534:發生錯誤,該值此時不適用

65535:未知,或不適用

範例 電池被放入充電器艙 4:

< REP 4 BATT_TIME_TO_FULL 65533 >

< REP 4 BATT_TIME_TO_FULL 00060 >

< REP 4 BATT_TIME_TO_FULL 00001 >
< REP 4 BATT_TIME_TO_FULL 00000 >
< REP 4 BATT_TIME_TO_FULL 65529 >

電池已取出:

< REP 4 BATT_TIME_TO_FULL 65535 >

BATT_CHARGE

說明 檢視電池充電狀態
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:3 個數字

000-100:充電狀態百分比

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例

< GET 1 BATT_CHARGE >
< REP 1 BATT_CHARGE 027 >
< REP 1 BATT_CHARGE 028 >

< REP 1 BATT_CHARGE 099 >
< REP 1 BATT_CHARGE 100 >

BATT_HEALTH

說明 監控電池健康度百分比
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:3 個數字

000-100:健康度狀態百分比

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例

< GET 1 BATT_HEALTH >
< REP 1 BATT_HEALTH 099 >

BATT_CYCLE

說明 監控各個電池循環
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:5 個數字

00000 - 65533:充電循環次數

65534:發生錯誤,該值此時不適用

65535:未知,或不適用

範例 電池被放入充電器艙 4:

< REP 4 BATT_CYCLE 00006 >

< GET 4 BATT_CYCLE >
< REP 4 BATT_CYCLE 00006 >

BATT_CURRENT_CAPACITY

說明 檢視目前電池容量
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:5 個數字

00000 至 65533:目前的電池容量,以 mAh 為單位

65534:發生錯誤,該值此時不適用

65535:未知,或不適用

範例

< GET 1 BATT_CURRENT_CAPACITY >
< REP 1 BATT_CURRENT_CAPACITY 02189 >

BATT_CURRENT_CAPACITY_MAX

說明 檢視目前電池最大容量
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:5 個數字

00000 至 65533:目前的電池最大容量,以 mAh 為單位

65534:發生錯誤,該值此時不適用

65535:未知,或不適用

範例

< GET 1 BATT_CURRENT_CAPACITY_MAX >
< REP 1 BATT_CURRENT_CAPACITY_MAX 02393 >

BATT_CAPACITY_MAX

說明 檢視電池最大容量
支援的命令 GET(取得)和 REP(回報)
索引 艙數
格式:5 個數字

00000 至 65533:電池最大容量,以 mAh 為單位

65534:發生錯誤,該值此時不適用

65535:未知,或不適用

範例

< GET 1 BATT_CAPACITY_MAX >
< REP 1 BATT_CAPACITY_MAX 02393 >

BATT_TEMP_C

說明 檢視電池的攝氏溫度
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:3 個數字

ActualValue = ReportedValue - 40

000 至 253:攝氏溫度

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例

< GET 1 BATT_TEMP_C >
< REP 1 BATT_TEMP_C 033 >

BATT_TEMP_F

說明 檢視電池的華氏溫度
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:3 個數字

ActualValue = ReportedValue - 40

000 至 253:華氏溫度

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例

< GET 1 BATT_TEMP_F >
< REP 1 BATT_TEMP_F 091 >

BATT_ERROR

說明 檢視電池錯誤
支援的命令 GET(取得)和 REP(回報)
索引 艙數

格式:3 個數字

000:無作用中的錯誤

001:未知模組

002:無法辨識的電池

003:深度放電復原失敗

004:充電失敗

005:檢查電池

006:檢查充電器

007:通訊失敗

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例

< GET 1 BATT_ERROR >
< REP 1 BATT_ERROR 000 >

BATT_MODULE_TYPE

說明
支援的命令 GET(取得)和 REP(回報)
索引 模組編號:視型號而定

格式:3 個數字

對應於模組型號的巨集:

000:未安裝模組

001:MXCWNCS

254:發生錯誤,該值此時不適用

255:未知,或不適用

範例 用於 SBC840:

< GET 1 BATT_MODULE_TYPE >
< REP 1 BATT_MODULE_TYPE 128 >

用於 3 個設備的 SBC240 成組系統:

< GET 0 BATT_MODULE_TYPE >
< REP 1 BATT_MODULE_TYPE 129 >
< REP 2 BATT_MODULE_TYPE 129 >
< REP 3 BATT_MODULE_TYPE 129 >
< REP 4 BATT_MODULE_TYPE 000 >

注釋 上面列出的索引和值是所有值的超集。

對於 SBCx40 充電,預期會有下列值:

SBC220:

  • 索引:1-4
  • 值:主要 - 133,次要 - 133 或 129

SBC240:

  • 索引:1-4
  • 值:主要 - 129,次要 - 133 或 129

SBC840:

  • 索引:1
  • 值:128

SBC840M:

  • 索引:1
  • 值:130