Publications Command Strings MXCWNCS (Chinese)

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