佈建參數類型

本節說明根據功能大致編排的佈建參數。

一般用途參數

一般用途參數 GPP_* (管理員登入 > 進階 > 語音 > 佈建) 會在配置電話時用作為免費字串註冊,以便與特定的佈建伺服器解決方案互動。 GPP_* 參數預設為空。 可將它們設定為包含不同的值,其中包括:

  • 加密金鑰

  • URL

  • 多階段佈建狀態訊息。

  • Post 請求範本

  • 參數名稱別名對映

  • 最終並入完整的參數值的部分字串值。

GPP_* 參數可在其他佈建參數內用於宏指令擴展。 出於此目的,一個字母的大寫宏指令名稱 (A 至 P) 足以識別 GPP_A 至 GPP_P 的內容。 另外,當用作以下 URL 選項的參數時,兩個字母的大寫宏指令名稱 SA 至 SD 將 GPP_SA 至 GPP_SD 標識為特殊情况:

keyuidpwd

這些參數可在佈建和升級規則中用作變數。 引用它們時需在變數名稱前新增「$」字元,例如 $GPP_A。

啟用參數

Provision_Enable 和 Upgrade_Enable 參數控制著所有設定檔重新同步和韌體升級操作。 這些參數彼此獨立控制重新同步和升級。 這些參數還控制透過管理 Web 伺服器發出的重新同步和升級 URL 指令碼。 這兩個參數預設都設定為

Resync_From_SIP 參數控制重新同步操作請求。 SIP NOTIFY 事件從服務提供者代理伺服器發送到電話。 如果啟用,代理可以請求重新同步。 為此,代理會傳送 SIP NOTIFY 訊息到裝置,其中包含 Event: resync 標頭。

裝置以 401 回應訊息質詢請求(授權遭拒,因憑證已被使用)。 裝置在支援來自代理的重新同步請求之前,預期會出現經過驗證的後續請求。 Event: reboot_now 和 Event: restart_now 標頭會分別執行冷重啟和熱重啟,也會遭到質詢。

其餘兩個會啟用 Resync_On_Reset 和 Resync_After_Upgrade_Attempt。 這些參數確定在開機軟體重新啟動後以及每次升級嘗試後,裝置是否執行重新同步操作。

啟用 Resync_On_Reset 後,在執行重設之前,裝置在啟動序列後引入隨機延遲。 延遲時間是隨機的,上限為 Resync_Random_Delay 指定的值 (以秒為單位)。 在同時開機的電話池中,這一延遲將傳播到每個裝置重新同步請求的開始時間。 在大型住宅部署中,如果發生地區性電力故障,此功能將十分有用。

觸發條件

電話允許您按特定時間間隔或在特定時間重新同步。

在特定時間間隔重新同步

電話可定期與佈建伺服器重新同步。 重新同步間隔在 Resync_Periodic (秒)中設定。 如果此值為空,裝置不會定期重新同步。

重新同步通常在語音線路閒置時執行。 如果語音線路處於活動狀態且需要重新同步,電話將延遲重新同步過程,直到線路再次變為閒置。 重新同步可能導致組態參數的值更改。

因為電話不能從伺服器擷取設定檔、下載的檔案損壞或者出現內部錯誤,重新同步操作可能會失敗。 Resync_Error_Retry_Delay (秒)中指定的時間後,裝置將嘗試再次重新同步。 如果 Resync_Error_Retry_Delay 設定為 0,在嘗試重新同步失敗後,裝置不會再嘗試重新同步。

如果升級失敗,會在 Upgrade_Error_Retry_Delay 中指定的秒數後重試。

有兩個可設定參數可用於有條件觸發重新同步:Resync_Trigger_1 和 Resync_Trigger_2。 每個參數都可以使用經過宏指令擴展的條件運算式設定。 重新同步時間間隔逾期時 (下次重新同步的時間),觸發器 (如有設定) 將阻止重新同步,除非一個或多個觸發器的評估為 true。

以下範例條件將觸發重新同步。 在此範例中,最後一次電話升級嘗試已過超過 5 分鐘 (300 秒),並且自上次重新同步嘗試以來已過至少 10 分鐘 (600 秒)。

$UPGTMR gt 300 和 $PRVTMR ge 600

在特定時間重新同步

Resync_At 參數可讓電話在特定時間重新同步。 此參數使用 24 小時制 (hhmm) 指定時間。

Resync_At_Random_Delay 參數允許電話在未指定的延遲時間重新同步。 此參數用於正整數格式指定時間。

應避免來自多部電話、設定為在相同時間重新同步的重新同步請求湧入伺服器。 為此,電話會在指定時間後最多 10 分鐘觸發重新同步。

例如,如果您將重新同步時間設定為 1000 (上午 10:00),電話會在上午 10:00 與 10:10 之間的任何時間觸發重新同步。

預設停用此功能。 如果佈建了 Resync_At 參數,Resync_Periodic 參數會被忽略。

可設定的排程

您可以設定排程以定期執行重新同步,並且可以使用以下佈建參數指定重新同步和升級失敗時的重試間隔:

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

每個參數接受單一的延遲值 (秒)。 新的擴展語法允許以逗號分隔的連續延遲元素清單。 序列中的最後一個元素會永久暗中重複。

(可選) 您可以使用 + 號指定附加隨機額外延遲的另一個數值。

範例 1

在此範例中,電話會每 2 小時定期重新同步一次。 如果重新同步失敗,裝置將按這些時間間隔重試:30 分鐘、1 小時、2 小時、4 小時。 之後,裝置會繼續每隔 4 小時嘗試一次,直至重新同步成功。

 Resync_Periodic=7200 Resync_Error_Retry_Delay=1800,3600,7200,14400 

範例 2

在此範例中,裝置每小時 (加上最多 10 分鐘的額外隨機延遲) 定期重新同步一次。 如果重新同步失敗,裝置將按以下時間間隔重試:30 分鐘 (最多再加 5 分鐘)。 1 小時 (最多再加 10 分鐘)、2 小時 (最多再加 15 分鐘)。 之後,裝置會繼續每隔 2 小時(最多再加 15 分鐘) 嘗試一次,直至重新同步成功。

 Resync_Periodic=3600+600 Resync_Error_Retry_Delay=1800+300,3600+600,7200+900 

範例 3

在此範例中,如果遠端升級嘗試失敗,裝置會依次間隔 30 分鐘、1 小時、2 小時重試升級。 如果升級仍然失敗,裝置會每隔 4 至 5 小時重試,直至升級成功。

升級錯誤重試延遲  =  1800,3600,7200,14400+3600

設定檔規則

電話提供多個遠端組態檔參數 (Profile_Rule*)。 因此,每個重新同步操作都可以擷取由不同伺服器管理的多個檔案。

在最簡單的情形中,裝置會定期重新同步到中央伺服器上的單個設定檔,從而更新所有相關內部參數。 也可以將設定檔拆分成多個不同的檔案。 有一個適用於部署中的所有電話的常用檔案。 還會為每個帳戶提供單獨、唯一的檔案。 加密金鑰和憑證訊息仍可由儲存在單獨伺服器上的另一個設定檔提供。

只要重新同步操作到期,電話就會按順序評估四個「Profile_Rule*」參數:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

每次評估可能會導致自遠端佈建伺服器擷取設定檔,其中可能會更新一定數量的內部參數。 如果評估失敗,重新同步序列將中斷,並按照 Resync_Error_Retry_Delay 參數(秒)指定的值從頭再次重試。 如果所有評估都成功,裝置將等待 Resync_Periodic 參數指定的秒數,然後執行另一個重新同步。

每個 Profile_Rule* 參數內容中都包含一組備用值。 備用值之間以 |(豎線) 字元分隔。 每個備用值包含一個條件運算式、一個賦值運算式、一個設定檔 URL 和任何關聯的 URL 選項。 在每個備用值中,所有這些要素都是可選的。 以下是有效的組合,並且必須依此順序顯示 (如有的話):

[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]

在每個 Profile_Rule* 參數內,除最後一個備用值外,其他所有備用值都必須提供一個條件運算式。 系統會按如下方式評估及處理此運算式:

  1. 從左到右評估條件,直到找到評估結果為 true 的值 (或直至找到一個不含條件運算式的備用值)。

  2. 評估任何隨同的賦值運算式 (如有的話)。

  3. 如果 URL 被指定為該備用值的一部分,將嘗試下載位於指定 URL 的設定檔。 系統會嘗試相應更新內部參數。

如果所有備用值都有條件運算式且沒有條件被評估為 true (或者如果整個設定檔規則為空),則會跳過整個 Profile_Rule* 參數。 接下來會評估序列中的下一個設定檔規則參數。

範例 1

本範例將無條件重新同步到指定 URL 上的設定檔,並執行到遠端佈建伺服器的 HTTP GET 請求:

http://remote.server.com/cisco/$MA.cfg

範例 2

在本例中,裝置重新同步到兩個不同的 URL,具體取決於第 1 行的註冊狀態。在遺失註冊的情况下,裝置針對 CGI 指令碼執行 HTTP POST。 裝置將傳送宏指令擴展 GPP_A 的內容,可能提供有關裝置狀態的更多訊息:

 ($PRVTMR GE 600)?http://p.tel.com/has-reg.cfg |[-- 帖子 A] http://p.tel.com/lost-reg? 

範例 3

在此範例中,裝置將重新同步到相同伺服器。 如果未在裝置上安裝憑證 (對於 2.0 版之前的舊裝置),裝置將提供更多訊息:

 (“$CCERT”等式“已安裝”)?https://p.tel.com/config? |https://p.tel.com/config?cisco$MAU 

範例 4

在此範例中,在將 GPP_A 設定為透過第一個 URL 佈建的值之前,線路 1 會一直停用。 然後,它會重新同步到第二個 URL:

(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov| https://p.tel.com/configs

範例 5

在此範例中,假設伺服器返回的設定檔包含 XML 元素標籤。 這些標籤必須按照 GPP_B 中儲存的別名對映圖,重新對映到適當的參數名稱:

[--alias b] https://p.tel.com/account/$PN$MA.xml

如果未從伺服器收到請求的設定檔,重新同步通常被視為失敗。 Resync_Fails_On_FNF 參數可以覆寫此預設行為。 如果 Resync_Fails_On_FNF 設定為「否」,裝置收到伺服器發回的「找不到檔案」回應視為重新同步成功。 Resync_Fails_On_FNF 的預設值為「是」。

升級規則

升級規則是通知裝置啟動一個新的載入,以及必要時從哪裡獲得載入。 如果載入已在裝置上,則其不會嘗試獲取載入。 因此,當所需的載入處於非活動分區時,載入位置的有效性並不重要。

Upgrade_Rule 指定不同於目前載入時將下載和應用的韌體載入,除非被條件運算式限制或 Upgrade_Enable 設定為

電話提供一個可設定遠端升級參數 Upgrade_Rule。 此參數接受與設定檔規則參數類似的語法。 升級不支援 URL 選項,但可以使用條件運算式和賦值運算式。 如果使用條件運算式,此參數可填充為多個以 | 字元分隔的備用值。 每個備用值的語法如下:

[ conditional-expr ] [ assignment-expr ] URL

如果採用 Profile_Rule* 參數,Upgrade_Rule 參數將評估每個備用值,直到滿足條件運算式或備用值無條件運算式。 評估隨同的賦值運算式 (如有指定)。 然後,嘗試升級到指定的 URL。

如果 Upgrade_Rule 包含無條件運算式的 URL,裝置將升級到 URL 指定的韌體影像。 宏指令擴展和規則評估後,裝置不會重新嘗試升級,直到規則遭修改或方案 + 伺服器 + 連接埠 + 檔案路徑的有效組合被更改。

要嘗試進行韌體升級,裝置將在程序開始時停用音訊,並在程序結束時重新啟動。 僅當所有語音線路目前都處於非活動狀態時,裝置才會自動開始由 Upgrade_Rule 的內容驅動的升級。

例如:

https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads

在此範例中,Upgrade_Rule 將韌體升級到指定 URL 中儲存的影像。

以下為另一個範例:

(“$F” ne “beta-customer”)? http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads| http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads

本例將指示裝置根據一般用途參數 GPP_F 的內容,下載兩幅圖像中的一幅。

佈建參數

您可以在電話網頁中的佈建標籤尋找佈建參數。

組態設定檔參數

下表定義了佈建標籤組態檔參數區段中每個參數的功能和用途。

表格 1 組態設定檔參數

參數名稱

說明和預設值

佈建啟用

控制獨立於韌體升級操作的所有重新同步操作。 設定為將啟用遠端佈建。

預設值為「是」。

重設時重新同步

除參數更新和韌體升級導致的重新啟動外,每次重新啟動之後都觸發重新同步。

預設值為「是」。

重新同步隨機延遲

執行重設之前,啟動序列後的隨機延遲指定以秒為單位。 在安排要同時接通電源的 IP 電話裝置池中,這會在每個裝置向佈建伺服器傳送重新同步請求的時間中引入一個時間差。 在大型住宅部署中,如果發生地區性電力故障,此功能將十分有用。

此欄位的值必須為介於 0 到 65535 之間的整數。

預設值為 2。

重新同步時間 (HHmm)

裝置與佈建伺服器重新同步的時間 (HHmm)。

此欄位的值必須為介於 0000 到 2400 之間的四位數字,以 HHmm 格式表示時間。 例如,0959 年表示 09:59。

預設值為空白。 如果值無效,該參數會被忽略。 如果此參數設定為有效值,則重新同步週期參數會被忽略。

隨機延遲重新同步

防止佈建伺服器在大量裝置同時接電時出現超載情況。

為避免來自多部電話的大量重新同步請求湧入伺服器,電話的重新同步範圍介於小時和分鐘,以及小時、分鐘加上隨機延遲之間 (hhmm, hhmm+random_delay)。 例如,如果隨機延遲 = (隨機延遲時重新同步 + 30)/60 分鐘,以秒為單位輸入的值會轉換為分鐘,四捨五入計入下一分鐘以計算最終的 random_delay 間隔。

有效值介於 600 到 65535 之間。

如果值小於 600,則內部隨機延遲介於 0 到 600 之間。

預設值為 600 秒 (10 分鐘)。

重新同步週期

與佈建伺服器定期重新同步的時間間隔。 僅在第一次成功同步伺服器後,相關重新同步計時器才會啟動。

有效格式如下所示:

  • 一個整數

    範例:輸入 3000 即表示下次重新同步將在 3000 秒後發生。

  • 多個整數

    範例:輸入 600、1200、300 即表示第一次重新同步將在 600 秒後發生,第二次重新同步將在第一次重新同步之後的 1200 秒後發生,第三次重新同步將在第二次重新同步之後的 300 秒後發生。

  • 時間範圍

    範例:輸入 2400+30 即表示下次重新同步將在重新同步成功後的 2400 到 2430 秒之間發生。

此參數設定為零,以停用定期重新同步。

預設值為 3600 秒。

重新同步錯誤重試延遲

如果因為 IP 電話裝置無法從伺服器擷取設定檔而導致重新同步操作失敗,或者下載的檔案已損壞或發生內部錯誤,裝置將在指定的時間 (以秒為單位) 之後再次嘗試重新同步。

有效格式如下所示:

  • 一個整數

    範例:輸入 300 即表示下次重新同步重試將在 300 秒後發生。

  • 多個整數

    範例:輸入 600、1200、300 即表示第一次重試將在失敗之後的 600 秒後發生,第二次重試將在第一次重試失敗之後的 1200 秒後發生,第三次重試將在第二次重試失敗之後的 300 秒後發生。

  • 時間範圍

    範例:輸入 2400+30 即表示下次重試將在重新同步失敗後的 2400 到 2430 秒之間發生。

如果延遲設定為 0,在嘗試重新同步失敗後,裝置不會再嘗試重新同步。

強制重新同步延遲

執行重新同步之前電話等待的最長延遲 (以秒為單位)。

如果有一條電話線路處於活動狀態,裝置不會重新同步。 因為重新同步可能需要數秒鐘的時間,所以最好等待,直至裝置在重新同步之前長時間處於閒置狀態。 這可讓使用者連續發起通話而不受中斷。

裝置有一個計時器,當其所有線路變為閒置時便會開始倒數。 此參數是計數器的初始值。 重新同步事件會延遲直至此計數器遞減為零。

有效值介於 0 到 65535 之間。

預設值為 14,400 秒。

從 SIP 重新同步

啟用將透過 SIP NOTIFY 訊息觸發的重新同步。

預設值為「是」。

嘗試升級後重新同步

在發生任何升級之後啟用或停用重新同步操作。 如果選擇「是」,將觸發同步。

預設值為「是」。

重新同步觸發器 1、重新同步觸發器 2

可設定重新同步觸發器條件。 當這些參數中的邏輯等式計算結果為 TRUE 時,將會觸發重新同步。

預設值為 (空白)。

FNF 重新同步失敗

如果未從伺服器收到請求的設定檔,重新同步會被視為失敗。 這會被該參數覆蓋。 如果設定為,當收到伺服器發回的找不到檔案回應時,裝置會認為重新同步成功。

預設值為「是」。

設定檔規則

設定檔規則 B

設定檔規則 C

設定檔規則 D

每條組態檔規則會通知電話應從哪個來源獲取設定檔 (組態檔)。 每個重新同步操作期間,電話會依次序套用所有設定檔。

預設值:/$PSN.xml

如要對組態檔套用 AES-256-CBC 加密,請如下所示採用 --key 關鍵字指定加密金鑰:

[--key <encryption key>]

您可以將加密金鑰括在雙引號 (") 內。

該使用的 DHCP 選項

DHCP 選項用逗號分隔,用於擷取韌體和設定檔。

預設值為 66,160,159,150,60,43,125。

記錄請求訊息

此參數包含嘗試開始重新同步時發送到系統記錄伺服器的訊息。

預設值為 $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH

記錄成功訊息

成功完成重新同步後發出的系統記錄訊息。

預設值為 $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR

記錄失敗訊息

嘗試重新同步失敗後發出的系統記錄訊息。

預設值為 $PN $MAC -- Resync failed: $ERR

使用者可設定重新同步

允許使用者在 IP 電話螢幕上重新同步電話。

預設值為「是」。

韌體升級參數

下表定義了佈建標籤韌體升級區段中每個參數的功能和用途。

表格 2 韌體升級參數

參數名稱

說明和預設值

啟用升級

允許韌體升級操作獨立於重新同步操作。

預設值為「是」。

使用以下方法之一配置此參數:

  • 在包含 XML(cfg.xml) 的電話設定檔中,依以下格式輸入字串: <Upgrade_Enable ua =“na”>是</Upgrade_Enable>

  • 在電話管理網頁中,將此欄位設定為“是”或“否”。

升級錯誤重試延遲

如果升級失敗,應用升級重試間隔 (以秒為單位)。 裝置有一個韌體升級錯誤計時器,會在韌體升級嘗試失敗後啟動。 計時器使用此參數中的值進行初始化。 當此計時器倒數至零時,會再次嘗試進行韌體升級。

預設值為 3600 秒。

使用以下方法之一配置此參數:

  • 在含 XML(cfg.xml) 的電話設定檔中,輸入以下格式的字串: <Upgrade_Error_Retry_Delay ua=“na”>3600</Upgrade_Error_Retry_Delay>

  • 在電話管理網頁中,設定值。

升級規則

定義升級條件及相關韌體 URL 的韌體升級指令碼。 參數使用相同的語法,作為設定檔規則。

使用以下格式輸入升級規則:

<tftp|http|https>://<ip address><:port>/<path>/<load name>

例如:

tftp://192.168.1.5/firmware/PHONEOS-8875.1-0-1-0001-1.loads
http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads

如未指定任何通訊協定,系統會假設您指定了 TFTP。 如果未指定 server-name,則使用請求 URL 的主機作為伺服器名稱。如果未指定連接埠,則使用預設連接埠 (TFTP 為 69,HTTP 為 80,HTTPS 為 443)。

預設值為空白。

使用以下方法之一配置此參數:

  • 在含 XML(cfg.xml) 的電話設定檔中,輸入以下格式的字串: <Upgrade_Rule ua =“na”>http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • 在電話管理網頁中,輸入載入檔案的儲存路徑。

記錄升級請求訊息

韌體升級嘗試開始時發出的系統記錄訊息。

預設值:$PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH

使用以下方法之一配置此參數:

  • 在含 XML(cfg.xml) 的電話設定檔中,輸入以下格式的字串: <Log_Upgrade_Request_Msg ua =“na”>$PN $MAC -- 正在請求升級 $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • 在電話管理網頁中,視需要自訂參數。

記錄升級成功訊息

成功完成韌體升級嘗試後發出的系統記錄訊息。

預設值為 $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR

使用以下方法之一配置此參數:

  • 在含 XML(cfg.xml) 的電話設定檔中,依以下格式輸入字串: <Log_Upgrade_Success_Msg ua =“na”>$PN $MAC -- 成功升級 $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • 在電話管理網頁中,視需要自訂參數。

記錄升級失敗訊息

韌體升級嘗試失敗後發出的系統記錄訊息。

預設值為 $PN $MAC -- 升級失敗:$ERR

使用以下方法之一配置此參數:

  • 在含 XML(cfg.xml) 的電話設定檔中,輸入以下格式的字串: <Log_Upgrade_Failure_Msg ua =“na”>$PN $MAC -- 升級失敗:$ERR</Log_Upgrade_Failure_Msg>

  • 在電話管理網頁中,視需要自訂參數。

對等韌體共用

啟用或禁用對等固件共用 (PFS) 功能。 選擇 “是 ”或 “否 ”以啟用或禁用該功能。

預設值:是

使用以下方法之一配置此參數:

  • 在含 XML(cfg.xml) 的電話設定檔中,依以下格式輸入字串: <Peer_Firmware_Sharing ua =“na”>是</Peer_Firmware_Sharing>

  • 在電話管理網頁中,將此欄位設定為“是”或“否”。

對等韌體共用紀錄伺服器

指示 UDP 消息發送到的 IP 位址和埠。

例如:10.98.76.123:514 其中,10.98.76.123 是 IP 位址,514 是埠號。

使用以下方法之一配置此參數:

  • 在含 XML(cfg.xml) 的電話設定檔中,依以下格式輸入字串: <Peer_Firmware_Sharing_Log_Server ua =“na”>10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • 在電話管理網頁中,輸入紀錄伺服器位址。

一般用途參數

下表定義了佈建標籤一般用途參數區段中每個參數的功能和用途。

表格 3 一般用途參數

參數名稱

說明和預設值

GPP A - GPP P

當將電話設定為與特定佈建伺服器解決方案進行互動時,一般用途參數 GPP_* 用作免費字串寄存器。 可將它們設定為包含不同的值,其中包括:

  • 加密金鑰。

  • URL。

  • 多階段佈建狀態訊息。

  • POST 請求範本。

  • 參數名稱別名對映。

  • 最終並入完整的參數值的部分字串值。

預設值為空白。

宏指令擴展變數

以下佈建參數內識別了特定的宏指令變數:

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_*

  • GPP_*(特定情况下)

這些參數內識別和擴展了 $NAME 或 $(NAME) 等語法類型。

可以透過表示法 $(NAME:p) 和 $(NAME:p:q) 指定宏指令可變子字串,其中 p 和 q 是非負整數 (修訂版 2.0.11 及以上版本中可用)。 產生的宏指令擴展是從字元偏移量 p 開始的子字串,長度為 q (如果未指定 q,則直到字串結尾)。 例如,如果 GPP_A 包含 ABCDEF,則 $(A:2) 將擴展到 CDEF,$(A:2:3) 將擴展到 CDE。

無法識別的名稱不會轉換,擴展後參數值中 $NAME 或 $(NAME) 的格式仍將保持不變。

參數名稱

說明和預設值

$

$$ 擴展為單個 $ 字元。

A 至 P

替換為一般用途參數 GPP_A 至 GPP_P 的內容。

SA 至 SD

替換為專用參數 GPP_SA 至 GPP_SD。 這些參數存有在佈建過程中使用的密鑰或密碼。

$SA 至 $SD 被認為是傳遞给可選重新同步 URL 限定符 — 密鑰 — 的參數。

MA

使用小寫十六進制數字的 MAC 位址,例如 000e08aabbcc。

MAU

使用大寫十六進制數字的 MAC 位址,例如 000E08AABBCC。

MAC

使用小寫十六進制數字並用冒號分隔十六進制數字對的 MAC 位址。 例如 00:0e:08:aa:bb:cc。

PN

產品名稱。例如 CP-8875、DP-9851、DP-9871。

PSN

產品序號。 例如 V03。

SN

序號字串;例如 88012BA01234。

CCERT

SSL 用戶端憑證狀態:安裝或未安裝。

IP

電話在其本地子網中的 IP 位址。 例如 192.168.1.100。

EXTIP

電話的外部 IP (在網際網路上顯示的 IP)。 例如 66.43.16.52。

SWVER

軟體版本字串。 例如:

電話 3-1-1-0104-37

HWVER

硬體版本字串。 例如 2.0.1

PRVST

佈建狀態 (數字字串):

-1 = 明顯重新同步請求

0 = 接通電源時重新同步

1 = 定期重新同步

2 = 重新同步失敗,重試

UPGST

升級狀態 (數字字串):

1 = 第一次升級嘗試

2 = 升級失敗,重試

UPGERR

上次升級嘗試的結果訊息 (錯誤);例如,http_get 失敗。

PRVTMR

距離上次重新同步嘗試的秒數。

UPGTMR

距離上次升級嘗試的秒數。

REGTMR1

線路 1 遺失在 SIP 伺服器的註冊訊息後經歷的秒數。

REGTMR2

線路 2 遺失在 SIP 伺服器的註冊訊息後經歷的秒數。

UPGCOND

原來的宏指令名稱。

SCHEME

檔案存取方案,TFTP、HTTP 或 HTTPS 之一,在剖析重新同步或升級 URL 後獲得。

SERV

請求目標伺服器主機名稱,在剖析重新同步或升級 URL 後獲得。

SERVIP

請求目標伺服器 IP 位址,在剖析重新同步或升級 URL 後獲得,可能在 DNS 查詢之後。

PORT

請求目標 UDP/TCP 連接埠,在剖析重新同步或升級 URL 後獲得。

PATH

請求目標檔案路徑,在剖析重新同步或升級 URL 後獲得。

ERR

重新同步或升級嘗試的結果訊息。 只有助於生成結果系統記錄訊息。 嘗試升級時,值將保留在 UPGERR 變數中。

UIDn

線路 n UserID 組態參數的內容。

EMS

Extension Mobility 狀態

MUID

Extension Mobility 使用者 ID

MPWD

Extension Mobility 密碼

內部錯誤代碼

電話定義多個內部錯誤代碼 (X00–X99),以便加強設定,從而在某些錯誤條件下更好地控制裝置行為。

表格 4 內部錯誤代碼

參數名稱

說明和預設值

X00

傳送 SIP 請求時出現傳輸層 (或 ICMP) 錯誤。

X20

等待回應時,SIP 請求超時。

X40

一般 SIP 通訊協定錯誤 (例如,200 和 ACK 訊息中,SDP 的編解碼器不可接受;或等待 ACK 時超時)。

X60

根據指定的撥號方案,撥出號碼無效。