命令字串

Microflex® 無線裝置透過乙太網路連線至控制系統,例如

  • AMX、Crestron 或 Extron
  • Symetrix、Biamp、其他數位訊號處理器 (DSP)
  • 特殊自訂程式

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

連接埠:2202

慣例

具有 4 種字串類型:

GET(取得) 尋找屬性狀態。在 AMX/Crestron 傳送 GET(取得)命令後,系統會以 REPORT(回報)字串回應
SET(設定) 變更屬性狀態。在 AMX/Crestron 傳送 SET(設定)命令後,系統會以 REPORT(回報)字串回應,以指示新的屬性值。
REP(回報) 系統收到 GET(取得)或 SET(設定)命令後,會以 REPORT(回報)命令回覆,以指示屬性狀態。

重要提示:除了測定屬性以外,裝置會在值變更時傳送 REPORT(回報)。因此,不必持續查詢大部分的裝置屬性。

SAMPLE(採樣) 用於測定音訊電平。

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

大部分的參數會在變更時傳送 REPORT(回報)命令。因此,不必持續查詢電池或按鈕狀態參數。在任何這些參數變更時,APT 將傳送 REPORT(回報)命令。幾乎所有命令都會來回傳送到 APT。然後,APT 會將這些命令轉發到話筒。因此,要進行控制,只需傳送命令至與該 APT 關聯的 IP 位址。

下列所有字串中的字元「x」代表頻道,且能採用 ASCII 數字 0 到 8,如以下表格。

0 所有頻道
1 到 8 個別頻道

Microflex 無線命名

  • MXW1 - 是混合腰包式發射機
  • MXW2 - 是手持式發射機
  • MXW6 - 是邊界式話筒發射機
  • MXW8 - 是鵝頸式話筒發射機
  • MXWAPT2 - 2 頻道存取點收發機
  • MXWAPT4 - 4 頻道存取點收發機
  • MXWAPT8 - 8 頻道存取點收發機
  • MXWANI4 - 4 頻道音訊網路介面
  • MXWANI8 - 8 頻道音訊網路介面
  • MXWNCS2 - 2 插槽網路充電站
  • MXWNCS4 - 4 插槽網路充電站
  • MXWNCS8 - 8 插槽網路充電站

備註:

在話筒不可用時 (TX_AVAILABLE = NO),其參數可變更。因此,最佳做法是監視 TX_AVAILABLE。在 TX_AVAILABLE 從 NO 變更為 YES 時,為這些參數傳送 GET 命令以獲得適當的頻道。

範例:

  • 使用者從充電器移除 1 號話筒
  • APT 傳送:

    < REP 1 TX_AVAILABLE NO >

  • APT 傳送:

    < REP 1 TX_AVAILABLE YES >

  • 控制系統傳送:

    < GET 1 TX_STATUS >
    < GET 1 AUDIO_GAIN >
    < GET 1 BATT_RUN_TIME >
    < GET 1 BATT_CHARGE >
    < GET 1 BATT_HEALTH >
    < GET 1 BUTTON_STS >
    < GET 1 LED_STATUS >
    < GET 1 TX_TYPE >

  • APT 回覆:

    < REP 1 TX_STATUS ACTIVE >
    < REP 1 AUDIO_GAIN 034 >
    < REP 1 BATT_RUN_TIME 00317 >
    < REP 1 BUTTON_STS OFF >
    < REP 1 LED_STATUS ON OFF >
    < REP 1 TX_TYPE MXW6 >

LED 控制

要控制話筒上的 LED,務必在 MXW GUI 中選擇「外部 LED 控制」。

備註:對於鵝頸式話筒,要在 MX400 系列雙色 LED 或 MX400R 系列紅色 LED 之間進行單獨選擇。

回波消除

MXW 無線系統是電話會議應用的絕佳選擇。在這些應用中使用的回波消除器/混音器要求:

  1. 話筒始終提供音訊。回波消除器/混音器需要恆定的音訊訊號才能正確處理音訊訊號路徑。
  2. 提供單獨的靜音命令以使話筒訊號靜音。此靜音發生在回波消除器/混音器內部,而不是話筒本機。

要使用 MXW 系統提供此功能,請從 MXWAPT 網頁應用程式選擇 Preferences 標籤。將 Mute Preference 變更為 External Mute

備註:在使用 External Mute 時,開關行為(切換與閉鎖)由 Crestron/AMX 模式決定。

範例 1:瞬時(一鍵通)按鈕

  • 使用者按下 1 號話筒上的按鈕。
  • APT 傳送:

    < REP 1 BUTTON_STS ON >

  • 控制系統向混音器傳送命令以將頻道 1 取消靜音。
  • 混音器向控制系統傳送命令以確認頻道 1 已被取消靜音。
  • 控制系統向 APT 傳送:

    < SET 1 LED_STATUS OF ON >

    (關閉 1 號話筒的紅色 LED,開啟綠色 LED)
  • 使用者釋放 1 號話筒上的按鈕。
  • APT 傳送:

    < REP 1 BUTTON_STS OFF >

    控制系統向混音器傳送命令以將頻道 1 靜音。
  • 混音器向控制系統傳送命令以確認頻道 1 已被靜音。
  • 控制系統向 APT 傳送:

    < SET 1 LED_STATUS ON OF >

    (開啟 1 號話筒的紅色 LED,關閉綠色 LED)

範例 2:閉鎖靜音開關

  • 使用者按下和釋放 1 號話筒上的按鈕。
  • APT 傳送:

    < REP 1 BUTTON_STS ON >

  • APT 傳送:

    < REP 1 BUTTON_STS OFF >

    控制系統向混音器傳送命令以將頻道 1 靜音。
  • 混音器向控制系統傳送命令以確認頻道 1 已被靜音。
  • 控制系統向 APT 傳送:

    < SET 1 LED_STATUS ON OF >

    (開啟 1 號話筒的紅色 LED,關閉綠色 LED)
  • 使用者按下和釋放 1 號話筒上的按鈕。
  • APT 傳送:

    < REP 1 BUTTON_STS ON >

    APT 傳送:

    < REP 1 BUTTON_STS OFF >

    控制系統向混音器傳送命令以將頻道 1 取消靜音。
  • 混音器向控制系統傳送命令以確認頻道 1 已被取消靜音。
  • 控制系統向 APT 傳送:

    < SET 1 LED_STATUS OF ON >

    (關閉 1 號話筒的紅色 LED,開啟綠色 LED)

MXWAPT 命令

CHAN_NAME

說明 控制頻道名稱。
命令 主要頻道命令:

< GET x CHAN_NAME >
< REP x CHAN_NAME {yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy} >

< SET x CHAN_NAME {yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy} >
< REP x CHAN_NAME {yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy} >

次要頻道命令:

< GET SEC x CHAN_NAME >
< REP SEC x CHAN_NAME {yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy} >

< SET SEC x CHAN_NAME {yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy} >
< REP SEC x CHAN_NAME {yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy} >

變數

其中 x 是頻道編號:1、2、3、4、5、6、7 或 8。

其中重複的 y 代表或填入來自下列集合的 31 個字元字串:A-Z、a-z、0-9、!"#$%&'()*+,-./:;<=>?@[\]^_`~ 和空格,亦即 {1234567890123456789012345678901}。

注釋

SET(設定)僅支援 8 個字元。

裝置永遠會以 31 個字元的名稱回應。

DEVICE_ID

說明 控制裝置 ID。
命令

< GET DEVICE_ID >
< REP DEVICE_ID {yyyyyyyyyyyyyyyyyyyyyyyyy} >

< SET DEVICE_ID {yyyyyyyyyyyyyyyyyyyyyyyyyy} >
< REP DEVICE_ID {yyyyyyyyyyyyyyyyyyyyyyyyyy} >

變數 其中重複的 y 代表裝置傳回的空間,用來填入最多 31 個字元的裝置 ID。
注釋

裝置永遠會以 31 個字元的 ID 回應。

SET(設定)接受來自下列集合的 1-8 個字元:A-Z、a-z、0-9、!"#$%&'()*+,-./:;<=>?@[\]^_`~ 和空格。

FLASH

說明 控制閃爍以識別裝置或頻道。
命令 主要裝置或頻道上的閃光燈:

< SET FLASH ON >
< REP FLASH ON >

次要裝置或頻道上的閃光燈:

< SET SEC FLASH ON >
< REP SEC FLASH ON >

裝置啟動識別,然後停止閃爍:

< REP FLASH OFF >

< SET FLASH OFF >
< REP FLASH OFF >

備註:在沒有頻道索引的情況下使用時,該命令會啟動裝置識別。若搭配頻道索引使用,該命令會啟動頻道識別。

< SET x FLASH ON >
< REP x FLASH ON >

< SET SEC x FLASH ON >
< REP SEC x FLASH ON >

變數 使用時,x 是頻道編號。
注釋 無。

METER_RATE

說明 控制測定頻率。
命令 主要話筒:

< SET x METER_RATE sssss >
< REP x METER_RATE sssss >
< SAMPLE x aaa eee >

次要話筒:

< SET SEC x METER_RATE sssss >
< REP SEC x METER_RATE sssss >
< SAMPLE SEC x aaa eee >

變數
  • 其中 x 為頻道編號。
  • 其中 sssss 是以毫秒為單位的測定速度。
  • 其中 aaa 是收到的 RF 電平的值。
  • 其中 eee 是音訊電平。
注釋
  • 測定速度是數字,5 個數字字元的固定輸出。
  • 00000 - 測定 OFF(關閉)(預設)
  • 00100 到 65535 - 每次 SAMPLE(採樣)回報的間隔時間,單位為毫秒。
例如,

00100 - 每 100 毫秒採樣一次(每秒採樣 10 次)

01000 - 每秒採樣一次

05000 - 每 5 秒採樣一次

發射機命令

這些命令要傳送到 MXWAPT IP 位址。

TX_AVAILABLE

說明 發現可用的發射機。
命令 使主要發射機可用:

< GET x TX_AVAILABLE >
< REP x TX_AVAILABLE YES >
< REP x TX_AVAILABLE NO >

使次要發射機可用:

< GET SEC x TX_AVAILABLE >
< REP SEC x TX_AVAILABLE YES >
< REP SEC x TX_AVAILABLE NO >

變數 其中 x 為頻道編號。
注釋 在話筒關閉、被取消連結或在被關閉或取消對接後仍嘗試建立通訊時,話筒不可用。

TX_STATUS

說明 發現和設定發射機狀態。
命令 發現主要發射機狀態:

< GET x TX_STATUS >
< REP x TX_STATUS ACTIVE >
< REP x TX_STATUS MUTE >
< REP x TX_STATUS STANDBY >
< REP x TX_STATUS ON_CHARGER >
< REP x TX_STATUS UNKNOWN >

設定主要發射機狀態:

< SET x TX_STATUS ACTIVE >
< SET x TX_STATUS MUTE >
< SET x TX_STATUS STANDBY >
< SET x TX_STATUS OFF >
< REP x TX_STATUS ACTIVE >
< REP x TX_STATUS MUTE >
< REP x TX_STATUS STANDBY >
< REP x TX_STATUS ON_CHARGER >
< REP x TX_STATUS UNKNOWN >

發現次要發射機狀態:

< GET SEC x TX_STATUS >
< REP SEC x TX_STATUS ACTIVE >
< REP SEC x TX_STATUS MUTE >
< REP SEC x TX_STATUS STANDBY >
< REP SEC x TX_STATUS ON_CHARGER >
< REP SEC x TX_STATUS UNKNOWN >

設定次要發射機狀態:

< SET SEC x TX_STATUS ACTIVE >
< SET SEC x TX_STATUS MUTE >
< SET SEC x TX_STATUS STANDBY >
< SET SEC x TX_STATUS OFF >
< REP SEC x TX_STATUS ACTIVE >
< REP SEC x TX_STATUS MUTE >
< REP SEC x TX_STATUS STANDBY >
< REP SEC x TX_STATUS ON_CHARGER >
< REP SEC x TX_STATUS UNKNOWN >

變數 其中 x 為頻道編號。
注釋
  • ACTIVE(使用中):連結的 TX 已取消對接、已開啟、已取消靜音。
  • MUTE(靜音):連結的 TX 已取消對接、已開啟、已靜音。在使用外部靜音時,活筒將不會回報 MUTE,因為靜音在混音器中完成。
  • STANDBY(待命):連結的 TX 已取消對接、處於待命狀態、已靜音。
  • ON_CHARGER(在充電器上):連結的 TX 已對接。
  • UNKNOWN(未知):未連結發射機或發射機已關閉。

AUDIO_GAIN

說明 控制頻道音訊增益。
命令 主要音訊增益:

< GET x AUDIO_GAIN >
< REP x AUDIO_GAIN 030 >

次要音訊增益:

< GET SEC x AUDIO_GAIN >
< REP SEC x AUDIO_GAIN 030 >

有一個偏移值 25,因此實際值 = 40 - 25 = 15 dB。

若要設定為 22 dB:

< SET x AUDIO_GAIN 47 >
< REP x AUDIO_GAIN 047 >

< SET SEC x AUDIO_GAIN 47 >
< REP SEC x AUDIO_GAIN 047 >

若要將值降低 5 dB:

< SET x AUDIO_GAIN DEC 5 >
< REP x AUDIO_GAIN 042 >

< SET SEC x AUDIO_GAIN DEC 5 >
< REP SEC x AUDIO_GAIN 042 >

若要將值增加 10 dB:

< SET x AUDIO_GAIN INC 10 >
< REP x AUDIO_GAIN 052 >

< SET SEC x AUDIO_GAIN INC 10 >
< REP SEC x AUDIO_GAIN 052 >

變數 其中 x 為頻道編號。
注釋
  • 數字
  • 3 個字元
  • 000 到 060,以 1 為增量
  • REPorted(回報)和 SET(設定)的值偏移了 25

BUTTON_STS

說明 檢視活筒按鈕狀態。
命令 主要話筒按鈕狀態:

< GET x BUTTON_STS >
< REP x BUTTON_STS ON >
< REP x BUTTON_STS OFF >

次要話筒 LED 狀態:

< GET SEC x BUTTON_STS >
< REP SEC x BUTTON_STS ON >
< REP SEC x BUTTON_STS OFF >

變數 其中 x 為頻道編號。
注釋 在使用者按下話筒上的按鈕時傳送。 On =按下,Off =釋放。在按鈕狀態變更時,APT 將始終傳送此回報。無需連續傳送 GET 命令。

LED_STATUS

說明 獲取和設定話筒 LED 狀態。
命令 主要話筒 LED 狀態:

< GET x LED_STATUS >
< REP x LED_STATUS rr gg >

< SET x LED_STATUS rr gg >
< REP x LED_STATUS rr gg >

次要話筒 LED 狀態:

< GET SEC x LED_STATUS >
< REP SEC x LED_STATUS rr gg >

< SET SEC x LED_STATUS rr gg >
< REP x LED_STATUS rr gg >

變數
  • 其中 x 為頻道編號。
  • 其中 rr 是紅色 LED 的設定,而 gg 是綠色 LED 的設定。
注釋 rr 和 gg 可採用以下 2 個數字值:
  • ON = 開
  • OF = 關
  • ST = 頻閃
  • FL = 閃爍
  • PU = 跳動
  • NC = 無變更

TX_TYPE

說明 確定話筒類型
命令 主要話筒類型:

< GET x TX_TYPE >
< REP x TX_TYPE MXW1 >
< REP x TX_TYPE MXW2 >
< REP x TX_TYPE MXW6 >
< REP x TX_TYPE MXW8 >

次要話筒類型:

< GET SEC x TX_TYPE >
< REP SEC x TX_TYPE MXW1 >
< REP SEC x TX_TYPE MXW2 >
< REP SEC x TX_TYPE MXW6 >
< REP SEC x TX_TYPE MXW8 >

變數 其中 x 為頻道編號。
注釋

TX_BATT_CHARGE

說明 搜索發射機電池充電情況。
命令 主要電池充電狀態:

< GET x TX_BATT_CHARGE >
< REP x TX_BATT_CHARGE yyy >

次要電池充電狀態:

< GET SEC x TX_BATT_CHARGE >
< REP SEC x TX_BATT_CHARGE yyy >

變數
  • 其中 x 為頻道編號。
  • 其中 yyy 是剩餘電池使用壽命,以百分比表示。
注釋 3 個數字字元的固定輸出

000 至 100 - 百分比

255 - 裝置關閉

BATT_RUN_TIME

說明 發現發射機電池運行時間(以分鐘表示)。
命令 主要電池運行時間:

< GET x BATT_RUN_TIME >
< REP x BATT_RUN_TIME yyyyy >

次要電池運行時間:

< GET SEC x BATT_RUN_TIME >
< REP SEC x BATT_RUN_TIME yyyyy >

變數
  • 其中 x 為頻道編號。
  • 其中 yyyyy 是話筒將自身關閉的時間。
注釋

話筒由牆壁充電器供電時,yyyyy=65532。

話筒在充電器上時,yyyyy=65533.

仍在計算運行時間時,yyyyy=65534。

話筒關閉時,yyyyy=65535.

BATT_HEALTH

說明 搜索發射機電池健康度。
命令 主要電池健康度:

< GET x BATT_HEALTH >
< REP x BATT_HEALTH yyy >

次要電池健康度:

< GET SEC x BATT_HEALTH >
< REP SEC x BATT_HEALTH yyy >

變數
  • 其中 x 為頻道編號。
  • 其中 yyy 是相對出廠定義的原始容量的容量百分比。
注釋 3 個數字字元的固定輸出

000 至 100 - 百分比

255 - 未知

BATT_TIME_TO_FULL

說明 發現電池於充滿電前的剩餘時間。
命令 主要電池:

< GET x BATT_TIME_TO_FULL >
< REP x BATT_TIME_TO_FULL yyyyy >

次要電池:

< GET SEC x BATT_TIME_TO_FULL >
< REP SEC x BATT_TIME_TO_FULL yyyyy >

變數
  • 其中 x 為頻道編號。
  • 其中 yyyyy是話筒充滿電的分鐘數。
注釋 5 個數字字元的固定輸出

發射機關閉時,yyyyy=65535。

發射機開啟并且不在充電器上時,yyyyy=65535。

發射機開啟并且充滿電時,yyyyy=65534。

MXWNCS 命令

這些命令要傳送到 MXWNCS IP 位址。

備註:其他充電器命令可用於查詢正在充電的未連結話筒的狀態。 請聯絡 support@shure.com 獲取幫助。

REMOTE_LINK

說明 使用任何 APT 連結任何充電器中的任何話筒
命令 連結主要話筒:

< SET PRI x REMOTE_LINK y {zzz.zzz.zzz.zzz} >
< REP PRI x REMOTE_LINK y {zzz.zzz.zzz.zzz} SUCCESS >
< REP PRI x REMOTE_LINK y {zzz.zzz.zzz.zzz} ERR >

連結次要話筒:

< SET SEC x REMOTE_LINK y {zzz.zzz.zzz.zzz} >
< REP SEC x REMOTE_LINK y {zzz.zzz.zzz.zzz} SUCCESS >
< REP SEC x REMOTE_LINK y {zzz.zzz.zzz.zzz} ERR >

變數

其中 x 是對應於發射機所在充電艙的編號。

其中 y 是對應於 MXWAPT 頻道的編號。

其中 zzz.zzz.zzz.zzz 是 MXWAPT 的 IP 位址。

注釋 韌體 4.0 版或更高版本。

代碼

所有命令都遵循一組通用的額外代碼,位於二進制數字的上端:

  • 255254253252 是用於三位數數字的代碼。
  • 65535655346553365532 是用於 5 位數數字的代碼。

這些代碼表示您嘗試控制的裝置不可用。所有命令都遵循一組通用的額外代碼。這些代碼位於二進制數字的上端。代碼的含義可在帶有適當命令的上表中找到。

還有一個 <REP ERR> 錯誤字串,表示命令無法實現。這通常是由於錯字或命令不存在。