ACS 方法(翻譯 TR069 A.3.3)

A.3.3 

 ACS支持在這個章節定義的方法,只有CPE 才能調用這些方法

A.3.3.1 Inform

無論會話是否建立,CPE必須調用Inform方法來初始化一個傳輸序列(交流)。這種方法的調用論據在table37中定義,迴應的論據在table38中定義。


table37

1,DeviceId  類型爲DeviceldStruct,可以唯一標識CPE的結構體,在table39中定義

2,Event  類型爲EventStruct[64] , 一個結構體數組,表明這些事件引起了會話建立。如果一個或是多個原因存在,CPE必須列出所有原因。在這個數組的順序上ACS不能起任何作用。如果CPE需要在一個Inform中傳遞超過64個事件,它必須丟棄掉舊的“M”事件,防止超過數組數量的最大值。如果由於上一個會話沒有成功終止而建立的會話,這個事件組不能包括已經發送的事件,如果所有的事件都發出去了,這個事件組必須爲空。當一個新事件在先前會話重試失敗時產生,新的事件必須要被包括在下一個重試會話的事件組。

3,MaxEnvelopes  類型unsignedInt, 這個值必須設置爲1,因爲這個版本只能支持在一個信息中含有一個envelope,在接收的信息中這個值可以忽略。

4,CurrentTime 類型爲dateTime, CPE方的當前日期和事件,這個事件必須被本地的time zone代替,並且包括與UTC的偏移量。

5,RetryCount  類型爲unsignedInt   某個會話此前重試的次數,如果先前的會話使成功完成的,這個值必須爲0,

6,ParameterList 類型爲ParameterValueStruct[],  成對出現的參數與其值組成的結構體數組,這些參數有以下幾種情況:1)有些參數被ACS設置了Notification屬性,不管是Active 或是Passive,從上次發送成功的通知Inform後,如果這些參數的值改變了且這些改變不是由於ACS引起的;2)有些參數和數據模型相關,需要強制性主動通知,如果這些參數改變且由於ACS改變的;3)與數據模型相關的參數需要在每一個Inform包中出現。  從上次成功發送Inform通知,如果一個參數改變了多次,這個參數必須用最新的值包含在參數列表中,在這種情況下,儘管該參數會變爲原來的值也需要加在參數列表中。 無論什麼時候CPE重啓,或者是ACS的URL改變,CPE會在此時清除參數列表,這個參數列表是由於參數值發生變化而即將放在通知裏被髮送出去,但是,CPE必須保持所有參數的通知屬性的值。 如果CPE清除了因爲參數變化而將要發送的參數記錄,它必須同時丟棄掉“4 VALUE CHANGE”事件。如果在參數列表中的至少有一個參數的值發生變化且這種變化不是由ACS引起的,那麼在Inform中必須包含“4 VALUE CHANGE”事件。 如果Inform中包含“4 VALUE CHANGE”事件,那麼參數列表中的參數必須滿足以上三種標準的其中一種。  如果Inform中不包含“4 VALUE CHANGE”,CPE決定參數列表的內容。  注意,如果Inform中含有“8 DIAGNOSTICS COMPLETE”事件,包中不需要含有與診斷相關的結果參數。如上所述,如果“4 VALUE CHANGE”也包含在Inform中,參數列表的所有參數必須滿足以上三個條件中的一個。



table38--InformResponse 依據

MaxEnvelopes  類型爲unsignedInt  ,這個值必須被設置爲1,因爲此版本只是支持在一個msg裏含有一個單獨的envelope,並且在接收的信息中該值不被考慮。


table39---DeviceldStruct 定義

1,Manufacturer  類型爲string(64), 設備的製造商,這個值必須與參數DeviceInfo.Manufacturer的值相同。

2,OUI   類型爲string(6) ,設備製造商的唯一標識符,用所有大寫字母和一些前置零表示出來的十六進制的值來代表。這個值必須與參數DeviceInfo.ManufacturerOUI的值相同。

3,ProductClass   類型爲string(64), 適用於產品類別標識符的序列號,也就是說,對於給定的生產製造商,這個參數用來區分產品或者是產品類型,這個序列參數使唯一的。這個是必須與DeviceInfo.ProductClassParameter.相同。在設備的整個壽命過程中,這個值必須保持固定,包括FW的升級。任何改變都說明這是一個新的設備,需要發送一個BOOTSTARP Inform。

4,SerialNumber   類型爲string(64), 對於給定的產品製造商和產品類別,唯一的設備標識符。這個值必須與DeviceInfo.SerialNumberParameter相同。在設備的整個壽命過程中,這個值必須保持固定,包括FW的升級。任何改變都說明這是一個新的設備,需要發送一個BOOTSTARP Inform。



table40----EventStruct definiton

1,EventCode    類型爲string(64)

2,CommandKey    類型爲string(32)   如果事件列表記錄的事件代碼與特定的CommandKey有關,這個元素必須包含CommandKey的值。




按照標準,ACS在收到不含有“0 BOOTSTRAP”的Inform之前沒有收到含有“0 BOOTSTRAP”的Inform, 在這種情況下ACS會回覆8003(無效的論據)


A.3.3.2 傳輸完成


這個方法通知ACS文件傳輸的完成(無論成功與否)。文件的傳輸是由調用Download,ScheduleDownload或者是Upload方法引起的。當通過調用CancelTransfer方法成功取消文件傳輸時,該方法不必被調用。

這段只是適用於通過Download或者是Upload方法引起的文件傳輸, 它不適用於ScheduleDownload,ScheduleDownload不支持在同一個會話中下載。當相關下載或上傳回應表示傳輸沒有完成時傳輸完成方法必須被調用。在這種情況下,它會在由傳輸啓動的同一個會話中調用或者是在後續的會話中被調用。



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章