展訊升級工具featurelist

1、WriteSN、WriteIMEI Tool FeatureListVer: 1.0.0Date: 2009-09-28重要本文檔中的任何內(nèi)容受著作權(quán)法的保護 2009, 展訊通信，保留所利，但注明其他方的內(nèi)容除外。商標展訊通信和展訊通信的產(chǎn)品是展訊通信專有。在提及其他公司及其產(chǎn)品時將使用各自公司所擁有的商標，這種使用的目的僅限于。不作保證展訊通信不對此文檔中的任何內(nèi)容作任何明示或暗示的陳述或保證，而且不對特定目的的適銷性及適用性或者任何間接、特殊或連帶的損失承擔(dān)任何責(zé)任。本文檔（包括任何附件）包含的信息是信息。接收人了解其獲得的本文檔是的，除用于規(guī)定的目的外不得用于任何目的，也不得將本文檔泄

2、露給任何第。前言文檔說明本文檔描述了 WriteSN 和WriteIMEI 兩個工具的需求。閱讀對象本文檔的針對范圍是WriteSN、WriteIMEI 編碼者和使用者。內(nèi)容介紹本文檔包括三個章節(jié)，分別為：第一章：概述。第二章：界面要求。第三章：功能要求文檔約定本文檔采用下面醒目標志來表示在操作過程中應(yīng)該特別注意的地方。注意：提醒操作中應(yīng)注意的事項。相關(guān)文檔目錄第1章 總體功能1-11.1 概述1-1第2章 界面要求2-1第3章 功能要求3-2WriteSN3-2WriteIMEI3-3附錄A ReviHistoryA-1第1章 總體功能1.1 概述WriteSN、WriteIMEI 是兩個功

3、能獨立的工具，他們實現(xiàn)的功能如下：WriteSN：寫入 SN、藍牙（BT）地址。WriteIMEI： 寫入 IMEI、藍牙地址。WriteSN 和 WriteIMEI 基于快速寫號（FastWrite）模式協(xié)議。FastWrite 模式數(shù)據(jù)交互采用同步方式，即 PC 發(fā)送命令之后必須收到發(fā)送下一個命令，數(shù)據(jù)包結(jié)構(gòu)描述如下：返回的ACK 后才可以一.R/W NV ITEM：(一) PC MSMSG_HEAD_T 定義:typedef struct msg_head_tagu32seq_num; / Message sequence number, used for flow controlu16

4、len;/ The total sizeof packet: / sizeof(MSG_HEAD_T) + sizeof(MSG_BODY) + sizeof(CRC)u8type;/ Maind type:DIAG_DIRECT_NV:0 x5Eu8subtype; / Subtype, separatedo two parts:/ part1:Bit7 indicate operate mode (0: Read, 1:Write)/ part2:Bit6 Bit0 represent date type such as IMEI1, IMEI2etcMSG_HEAD_T;0 x7E1 B

5、yteMSG_HEAD_T8 BytesMSG_BODY= 0 BytesCRC2 Bytes0 x7E1 Byte1)len ：數(shù)據(jù)包長度，包括 MSG_HEAD、MSG_BODY 和 CRC 校驗，不包括包頭和包尾 0 x7E。2)type: DIAG_DIRECT_NV ( 0 x5E )3)subtype：分為兩個部分：BIT 7 代表操作的模式：0 表示從中讀數(shù)據(jù)，1 表示將數(shù)據(jù)寫入。BIT 6 BIT0 代表操作的類型，比如讀寫 IMEI 等。操作類型定義如下：typedef enum MSG_SUBTYPE_TAGRM_CALI_NV_IMEI1_MASK = 0 x01, RM

6、_CALI_NV_IMEI2_MASK = 0 x02, RM_CALI_NV_BT_MASK = 0 x04, RM_CALI_NV_GPS_MASK = 0 x08,RM_CALI_NV_SN_MASK = 0 x10,MSG_SUBTYPE_E;4)CRC： 只對 MSG_BODY 的數(shù)據(jù)進行 CRC 校驗。CRC 校驗方法請參看 Dloader 中關(guān)于 CRC 校驗的相關(guān)說明(二) MS PCtypedef struct msg_head_taguu32seq_num; / Message sequence number, used for flow control16len;/ Th

7、e total sizeof packet: / sizeof(MSG_HEAD_T) + sizeof(MSG_BODY) + sizeof(CRC)u8type;/ Maind type:0 x5Eu8subtype; / Subtype, Indicate operator result：1, Sucsful0, FailedMSG_HEAD_T;0 x7E1 ByteMSG_HEAD_T8 BytesMSG_BODY= 0 BytesCRC2 Bytes0 x7E1 Byte注意：PC 回給的 ACK 數(shù)據(jù)包中的 subtype 表示命令的執(zhí)行結(jié)果:1：命令成功執(zhí)行， 0：命令執(zhí)行失敗

8、。CRC：只對 MSG_BODY 的數(shù)據(jù)作 CRC 校驗，若無 MSG_BODY 數(shù)據(jù)則 CRC 為 0。二.R/W Product Info(一) PC MSMSG_HEAD_T 定義:typedef struct msg_head_tagu32seq_num; / Message sequence number, used for flow controlu16len;/ The total sizeof packet: / sizeof(MSG_HEAD_T) + sizeof(MSG_BODY) + sizeof(CRC)u8type;/ Maind type:DIAG_DIRECT_

9、PRODINFO:0 x5Fu8subtype; / 0: Read, 1 : Write MSG_HEAD_T;1)type: DIAG_DIRECT_PRODINFO ( 0 x5F )2)subtype： 0 表示從中讀數(shù)據(jù)，1 表示將數(shù)據(jù)寫入。3)CRC： 只對 MSG_BODY 的數(shù)據(jù)進行 CRC 校驗。CRC 校驗方法請參看 Dloader 中關(guān)于 CRC 校驗的相關(guān)說明(二) MS PC0 x7E1 ByteMSG_HEAD_T8 Bytes0 x7E1 ByteMSG_HEAD_T8 BytesMSG_BODY= 0 BytesCRC2 Bytes0 x7E1 Bytetype

10、def struct msg_head_tagu32seq_num; / Message sequence number, used for flow controlu16len;/ The total sizeof packet: / sizeof(MSG_HEAD_T) + sizeof(MSG_BODY) + sizeof(CRC)u8type;/ Maind type:0 x5Fu8subtype; / Subtype, Indicate operator result：1, Sucsful0, FailedMSG_HEAD_T;注意：PC 回給的 ACK 數(shù)據(jù)包中的 subtype

11、表示命令的執(zhí)行結(jié)果:1：命令成功執(zhí)行， 0：命令執(zhí)行失敗。CRC：只對 MSG_BODY 的數(shù)據(jù)作 CRC 校驗，若無 MSG_BODY 數(shù)據(jù)則 CRC 為 0。MSG_BODY= 0 BytesCRC2 Bytes0 x7E1 Byte第2章 界面要求WriteSN 和 WriteIMEI 的工具界面總體要求簡單、便捷，適用于產(chǎn)線：1.要求區(qū)分工程師和操作員權(quán)限：工程師允許修改所有配置和設(shè)定，但操作員只允許修改端和儀器選擇、儀器地址設(shè)置。2.工作按鈕要求醒目。3.操作需要有操作提示，比如提示用戶上電開機，提示用戶輸入 IMEI 等。4.IMEI、SN 等輸入長度需要提示，比如 SN 允許輸入

12、的總長度，當前輸入的長度和剩余輸入長度。5.用戶輸入的 IMEI、SN 等數(shù)字顯示要求醒目。6.狀態(tài)顯示要求醒目，以不同顏色予以區(qū)分。比如 PASS 顯示綠色，F(xiàn)AIL 顯示紅色。7.狀態(tài)在下一次測試開始之前要求一直顯示。8.界面操作提示、按鈕要求采用簡體中文，編譯使用 UNICODE。第3章 功能要求3.1 WriteSN1.支持 SN 寫入：A)要求 SN 的輸入長度可配置，SN 長度范圍0, 24。B)要求支持掃描和自動生成兩種方式。自動生成的 SN 長度固定為 20 字節(jié)：SNAUTOYYYYMMDDhhmmssSNAUTO 為固定前綴字符，標示是自動生成的 SN。緊跟著的 14 個字

13、節(jié)是當前的系統(tǒng)時間：YYYY 代表當前年份，MM 代表月份，DD 代表天hh 代表小時，mm 代表分鐘，ss 代表秒C)WriteSN 默認輸入模式是掃描方式。D)SN 要求在界面上醒目的顯示。E)支持強制轉(zhuǎn)換 SN 所有字符為大寫字符的功能，默認打開該功能。F)SN 掃描輸入方式要求檢查 SN，不合法給出提示。SN 只支持數(shù)字和英文字母。2.支持 PhaseCheck 功能。A)PhaseCheck 檢查的站位要求在配置文件中可配置。B)如果 WriteSN 是首站，則要求初始化生產(chǎn)信息區(qū)域。C)WriteSN 默認為首站。3.支持藍牙地址掃描和自動生成寫入，藍牙地址自動生成：%04d%02

14、d%02d%02d%02drand 隨機數(shù), day, hour, minute, second隨機數(shù)以 GUID 為。WriteSN 默認藍牙輸入方式為自動生成方式。WriteSN 默認寫入藍牙地址。3.2 WriteIMEI1.IMEI 寫入支持掃描輸入和自動生成輸入兩種方式。默認掃描輸入方式。掃描輸入方式必須要求輸入完整的 IMEI（十五位數(shù)字 0-9）。自動生成方法：A)以基準的前十四位 + 1，最后一位根據(jù) CRC 自動生成。B)基準 IMEI 在設(shè)置界面中客戶預(yù)選配置。C)基準 IMEI 更新為最后一個成功寫入的 IMEI，并寫入文件保存。2.單個 IMEI 寫入A)單個 IMEI

15、 寫入只支持主卡輸入，副卡不允許用戶輸入。B)支持 IMEI 自動遞增：遞增規(guī)則為基準 IMEI 的前十四位 + 1，最后一位根據(jù) CRC 自動生成?；鶞?IMEI 在設(shè)置界面中客戶預(yù)先配置，同時將輸入界面鎖定只讀。IMEI 自動遞增時，如果輸入失敗，該 IMEI 不再遞增，繼續(xù)下個成功寫入后方可遞增。寫入，直至基準 IMEI 自動更新為最后一個成功寫入的 IMEI，并寫入文件保存。C)支持 IMEI檢查（CRC 檢查），默認開啟檢查。3.雙 IMEI 寫入A)支持副卡 IMEI 和主卡 IMEI 相同。B)支持自動遞增方式，遞增規(guī)則如下：主卡 IMEI 遞增以基準 IMEI 的前十四位 + 2，最后一位根據(jù) CRC 自動生成。副卡 IMEI 遞增以主卡 IMEI 的前十四位 + 1，最后一位根據(jù) CRC 自動生成?；鶞?IMEI 在設(shè)置界面中客戶預(yù)見配置，同時將輸入界面鎖定只讀。IMEI 自動遞增時，如果主卡或者副卡輸入失敗，那么該主卡和副卡的 IMEI 均不再遞增，繼續(xù)下個寫入，直至成功寫入后方可遞增。基準 IMEI 自動更新為最后一個成功寫入的副卡 IMEI，并寫入文件保存。C)支持 IMEI檢查（CRC 檢查），默