協議

 

一、 目錄

1. 版本記錄 2

2. 目錄 3

3. 軟件傳輸協議描述 5

3.1. 協議特徵 5

3.1.1. 命令幀 5

3.1.2. 應答幀 5

3.1.2.1. 正常應答幀格式 5

3.1.2.2. 狀態碼錶 6

3.1.2.3. 通訊短應答握手幀 7

3.1.3. 命令碼錶 7

3.1.3.1. Mid_CmdKind 2Bytes 7

3.1.3.2. Low_CmdKind 2Bytes 8

3.1.3.2.1. 繪畫板->數位板 8

3.1.3.2.2. 外設模塊->2.4G控制 8

3.1.3.2.3. IAP流程->通用 9

3.1.3.2.4. 繪畫板->數位屏 9

3.1.4. 器件地址約束 9

3.2. 功能實現流程圖 11

3.2.1. 設備端在線IAP升級流程圖 11

3.3. 命令實現 12

3.3.1. (0x0000_0101_xxxx) 繪畫板->數位板->A610 12

3.3.1.1. (0x0000_0101_01xx) 設置類 12

3.3.1.1.1. Cmd_0x0000_0101_0101 設置A610的關鍵算法參數 12

3.3.1.2. (0x0000_0101_02xx) 讀取類 13

3.3.1.2.1. Cmd_0x0000_0101_0201 讀取A610的關鍵算法參數 13

3.3.1.3. (0x0000_0101_03xx) 測試接口類 14

3.3.1.3.1. Cmd_0x0000_0101_0301 板載Shell接口透傳測試接口 14

3.3.2. (0x0000_0201_xxxx) 外設模塊->2.4G控制 15

3.3.2.1. (0x0000_0201_01xx) 設置類 15

3.3.2.1.1. Cmd_0x0000_0201_0101 設置RF主從模式 15

3.3.2.1.2. Cmd_0x0000_0201_0102 設置RF地址 15

3.3.2.1.3. Cmd_0x0000_0201_0103 設置RF工做信道 15

3.3.2.1.4. Cmd_0x0000_0201_0104 設置RF功率 16

3.3.2.1.5. Cmd_0x0000_0201_0105 設置RF睡眠 16

3.3.2.1.6. Cmd_0x0000_0201_0106 設置RF復位 16

3.3.2.1.7. Cmd_0x0000_0201_0107 設置RF測試模式 16

3.3.2.1.8. Cmd_0x0000_0201_0108 設置RF透傳使能 17

3.3.2.2. (0x0000_0201_02xx) 讀取類 18

3.3.2.2.1. Cmd_0x0000_0201_0201 獲取RF主從模式 18

3.3.2.2.2. Cmd_0x0000_0201_0202 獲取RF地址 18

3.3.2.2.3. Cmd_0x0000_0201_0203 獲取RF工做信道 19

3.3.2.2.4. Cmd_0x0000_0201_0204 獲取RF功率 19

3.3.2.2.5. Cmd_0x0000_0201_0205 獲取RF鏈接狀態 20

3.3.2.2.6. Cmd_0x0000_0201_0206 獲取RF信號強度 20

3.3.2.2.7. Cmd_0x0000_0201_0207 獲取RF固件版本 21

3.3.2.3. (0x0000_0201_03xx) 主動上報類 22

3.3.2.3.1. Cmd_0x0000_0201_0301 RF模塊向外部MCU上報鏈接狀態 22

3.3.3. (0x0000_0301_xxxx) IAP流程->通用 23

3.3.3.1. (0x0000_0301_01xx) 設備端IAP 23

3.3.3.1.1. Cmd_0x0000_0301_0101 獲取設備運行區間參數 23

3.3.3.1.2. Cmd_0x0000_0301_0102 設置設備運行區間參數 23

3.3.3.1.3. Cmd_0x0000_0301_0103 獲取設備預留Flash大小 23

3.3.3.1.4. Cmd_0x0000_0301_0104 向設備傳輸版本文件 24

3.3.3.1.5. Cmd_0x0000_0301_0105 向設備傳輸版本文件屬性參數 24

3.3.3.1.6. Cmd_0x0000_0301_0106 設置待升級下位機固件對象 25

3.3.3.1.7. Cmd_0x0000_0301_0107 獲取待升級下位機對象Boot區支持的數據包長度 25

 

3. 軟件傳輸協議描述

3.1. 協議特徵

本協議爲應用層協議，因爲通訊具備雙向性，所以要求通訊總線爲雙向總線（全雙工或者半雙工），能夠是無線通訊，也能夠是有線通訊（如I2C、UART、SPI、USB或者其餘）。通訊雙方地位平等，互爲主從。

數據傳輸格式：大端模式（高字節在前，低字節在後；高位在前，低位在後）。

 

1.1.1. 命令幀

下表爲命令包結構，命令包包括了設置命令以及讀取命令。對於設置命令來講，設置列表就是各類具體的設置值，其收到的返回包則是接收方對本次設置的結果彙報；對於讀取命令來講，其受到的返回包則是具體帶讀取的數據。

 

引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	設置列表	校驗
1 Byte	1Byte	1Byte	2Bytes	2Bytes	6Bytes	N Bytes	2Bytes

1) 引導碼：同步並區分不一樣的數據包：

• 0x89：命令幀
• 0x76：應答幀

2) 本機地址：用於通知對方本機地址，以便於對方知悉發送主機類型；這個適用於一對多的通訊場合，詳見「器件地址約束」章節

3) 對方地址：用於指定對方地址，以實現向特定對象發送數據（若是該地址爲廣播地址，則全部接收方均可以接收到數據）；這個適用於多對一的通訊場合，詳見「器件地址約束」章節

4) 會話ID：會話ID用於對某條命令或者某個事件的身份標識，或者說是事務的流水號。接收方將全部接收到的會話ID緩存進隊列中，而後逐個進行分析執行

5) 數據長度：命令碼 + 設置列表

6) 命令碼：表明設置列表所屬類型：

• 高2Bytes：保留，默認爲0x00
• 中2Bytes：表示業務方向與業務細則
• 低2Bytes：表示子類功能類別
• 2個字節一共能夠造成256*256=65536個具體功能。4個字節一共能夠造成256*256*256*256=42_9496_7296種命令，也就是大約43億條命令，也就是對應了43億個功能。若是再加上2個字節，範圍就更大。而實際上一家公司不管產品線有多龐大，全部產品的功能總和是毫不可能有這麼多的。此處增長2個字節的預留空間，更多的是從命令層次的角度來考慮。

7) 設置列表：表明命令碼對應的具體參數列表

8) 校驗：採用CRC16的校驗方式

 

1.1.2. 應答幀

3.1.1.1. 正常應答幀格式

引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	設置列表	校驗
1 Byte	1Byte	1Byte	2Bytes	2Bytes	6Bytes	2Bytes	N Bytes	2Bytes

1) 引導碼：同步並區分不一樣的數據包：

• 0x89：命令幀
• 0x76：應答幀

2) 本機地址：用於通知對方本機地址，以便於對方知悉發送主機類型；這個適用於一對多的通訊場合，詳見「器件地址約束」章節

3) 對方地址：用於指定對方地址，以實現向特定對象發送數據（若是該地址爲廣播地址，則全部接收方均可以接收到數據）；這個適用於多對一的通訊場合，詳見「器件地址約束」章節

4) 會話ID：會話ID用於對某條命令或者某個事件的身份標識，或者說是事務的流水號。接收方將全部接收到的會話ID緩存進隊列中，而後逐個進行分析執行

5) 數據長度：命令碼 + 執行狀態 + 設置列表

6) 命令碼：表明設置列表所屬類型：

• 高2Bytes：保留，默認爲0x00
• 中2Bytes：表示業務方向與業務細則
• 低2Bytes：表示子類功能類別
• 2個字節一共能夠造成256*256=65536個具體功能。4個字節一共能夠造成256*256*256*256=42_9496_7296種命令，也就是大約43億條命令，也就是對應了43億個功能。若是再加上2個字節，範圍就更大。而實際上一家公司不管產品線有多龐大，全部產品的功能總和是毫不可能有這麼多的。此處增長2個字節的預留空間，更多的是從命令層次的角度來考慮。

7) 執行狀態：見3.1.2.2小節列表

8) 設置列表：表明命令碼對應的具體參數列表

9) 校驗：採用CRC16的校驗方式

10) 【特別說明】：

• 該應答幀形式適用於「IAP流程->通用」類接口、「生產註冊流程->產品通用」類接口、以及其餘應用類別中的「獲取類接口」。

 

3.1.1.2. 狀態碼錶

狀態碼	內容解析
0x00	接收方正確接收並執行操做
0x01	包頭接收錯誤
0x02	本機地址與上一次接收不一致錯誤
0x03	對方地址與接收方的實際地址不一致錯誤
0x04	同一會話出現不一樣的ID或者不一樣會話之間的ID產生衝突（即ID一致）錯誤
0x05	數據長度錯誤
0x06	命令代碼錯誤
0x07	設置列表字節長度超過最大值錯誤
0x08	校驗出錯
0x09	設置列表參數錯誤
0x0A	接收超時
0x0B	執行條件不知足
0x0C	設備執行失敗

 

3.1.1.3. 通訊短應答握手幀

引導碼	本機地址	對方地址	會話ID	校驗
1 Byte	1Byte	1Byte	2Bytes	2Bytes

1) 引導碼：同步並區分不一樣的數據包：

• 0xAC：命令幀

2) 本機地址：用於通知對方本機地址，以便於對方知悉發送主機類型；這個適用於一對多的通訊場合，詳見「器件地址約束」章節

3) 對方地址：用於指定對方地址，以實現向特定對象發送數據（若是該地址爲廣播地址，則全部接收方均可以接收到數據）；這個適用於多對一的通訊場合，詳見「器件地址約束」章節

4) 會話ID：會話ID用於對某條命令或者某個事件的身份標識，或者說是事務的流水號。接收方將全部接收到的會話ID緩存進隊列中，而後逐個進行分析執行

5) 校驗：採用CRC16的校驗方式

6) 【特別說明】：

• 該應答幀只針對「特定」接口中的設置類命令以及主動上報類命令，讀取類命令其餘應用類別中設置類命令仍是採用3.1.2.1小節描述的正常應答幀格式處理
• 發送方發出數據包以後，只要接收方收到該數據包就當即返回該應答包，進而表示本次通訊完成；若是發送方在特定時間內未收到該應答包，則重傳1-2此數據包，若是任然未能接收到短應答幀，則在能力範圍內拋出異常提示

 

1.1.3. 命令碼錶

命令代碼爲6BYTES-----高2BYTES、中2BYTES和低2BYTES。

目前高2BYTE作預留，預留值爲0x0000；中間2BYTES用於規定業務方向及業務細項；低2BYTES用於規定特定業務方向和業務細項下的功能類別。

業務方向體現了產品的行業屬性或者說大方向，業務細項則是該行業方向下的具體產品類型；另外，業務方向所在的字段既能夠體現數據包的屬性（即對外設置或者向外讀取），還能體現具體的操做內容（即對外設置具體行業方向下的具體產品仍是向接收方寫其餘非功能類的信息），也就是說與具體功能狀態無關的操做命令也會在本字段定義（好比IAP升級、寫SN、讀SN、寫ID、讀ID、寫用戶名、讀用戶名、寫註冊信息、讀註冊信息等等），若是本功能字段不夠用，則能夠用預留字節來擴展。

 

 

3.1.1.4. Mid_CmdKind 2Bytes

業務方向（1Byte）		業務細則（1Byte）
CmdKind2	描述	CmdKind3	描述
0x00	預留	0x00	預留
0x01	繪畫板系列_數位板	0x00	預留
		0x01	A610
		……	預留
0x02	外設模塊	0x00	預留
		0x01	2.4G無線控制模塊
		……	預留
0x03	IAP流程	0x00	預留
		0x01	通用
		……	預留
0x04	繪畫板系列_數位屏	0x00	預留
		0x01	....
		……	預留
……	預留	……	預留

 

3.1.1.5. Low_CmdKind 2Bytes

3.1.1.5.1. 繪畫板->數位板

業務方向（1Byte）		業務細則（1Byte）
CmdKind4	描述	CmdKind5	描述
0x01	參數設置	0x00	預留
		0x01	設置A610的關鍵算法參數
		……	預留
0x02	參數讀取	0x00	預留
		0x01	讀取A610的關鍵算法參數
		……	預留
0x03	測試接口	0x00	預留
		0x01	板載Shell接口透傳測試接口
		……	預留

 

3.1.1.5.2. 外設模塊->2.4G控制

業務方向（1Byte）		業務細則（1Byte）
CmdKind4	描述	CmdKind5	描述
0x01	參數設置	0x00	預留
		0x01	設置RF主從模式
		0x02	設置RF地址
		0x03	設置RF工做信道
		0x04	設置RF功率
		0x05	設置RF睡眠
		0x06	設置RF復位
		0x07	設置RF測試模式
		……	預留
0x02	參數讀取	0x00	預留
		0x01	讀取RF主從模式
		0x02	讀取RF地址
		0x03	讀取RF工做信道
		0x04	讀取RF功率
		0x05	讀取RF鏈接狀態
		0x06	讀取RF信號強度
		0x07	去讀RF固件版本
		……	預留
0x03	主動上報	0x00	預留
		0x01	上報從設備狀態信息
		……	預留

 

3.1.1.5.3. IAP流程->通用

業務方向（1Byte）		業務細則（1Byte）
CmdKind4	描述	CmdKind5	描述
0x01	流程實現	0x00	預留
		0x01	獲取設備運行區間參數
		0x02	設置設備運行區間參數
		0x03	獲取設備預留Flash大小
		0x04	向設備傳輸版本文件
		0x05	向設備傳輸版本文件屬性參數
		……	預留

 

3.1.1.5.4. 繪畫板->數位屏

業務方向（1Byte）		業務細則（1Byte）
CmdKind4	描述	CmdKind5	描述
0x01	……	0x00	預留
		0x01	……
		……	預留

 

1.1.4. 器件地址約束

地址約束	內容解析
0x00	「PcHost」器件地址
0x01	「數位板-A610」器件地址
0x02	「數位板-A690」器件地址
0x03	「2.4G_RfControl_Master」器件地址
0x04	「2.4G_RfControl_Slave」器件地址
0xFF	「Broadcast」廣播地址

 

 

3.2. 功能實現流程圖

1.1.5. 設備端在線IAP升級流程圖

 

 

3.3. 命令實現

1.1.6. (0x0000_0101_xxxx) 繪畫板->數位板->A610

3.3.1.1. (0x0000_0101_01xx) 設置類

3.3.1.1.1. Cmd_0x0000_0101_0101 設置A610的關鍵算法參數

描述：

此命令用於設置A610數位板中算法相關的相關參數。

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	命令負載	校驗碼
							見下述表格
Bytes	1	1	1	2	2	6	N	2
描述	0x89	0x00	0x01		6+N	0x0000_0101_0101	……

 

	命令負載
	參數版本	具體各版本參數描述
Bytes	1	……
描述	此字段用於描述傳遞參數的結構版本	分別見如下表格

 

Ver 1 參數列表

A0狀態

A1狀態

A2狀態

A3狀態

A4狀態

A5狀態

On Brd

Dn Key

Up Key

On Brd

Up Key

Dn Key

Up Key

Dn Key

Dn Key

Up Key

Dn Key

Up Key

515K Adcs

515K Idx

Bytes

5

5

5

5

5

5

5

5

5

5

5

5

5

5

描述

Pressure Para Struct Unit / 1Byte for Logic Operators / 4Byets for Value

Ver 1 參數列表

7前導變頻頻點列表

頻點1

頻點2

頻點3

頻點4

頻點5

頻點6

頻點7

Bytes

4

4

4

4

4

4

4

描述

輸入頻點範圍:450000Hz ~ 540000Hz(暫不作限制)

 

返回包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

執行狀態

校驗碼

Bytes

1

1

1

2

2

6

2

2

描述

0x76

0x01

0x00

6+2

0x0000_0101_0101

參考列表

 

 

3.3.1.2. (0x0000_0101_02xx) 讀取類

3.3.1.2.1. Cmd_0x0000_0101_0201 讀取A610的關鍵算法參數

描述：

此命令用於獲取A610數位板中算法相關的相關參數。

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							見下述表格
Bytes	1	1	1	2	2	6	無	2
描述	0x89	0x00	0x01		6	0x0000_0101_0201	無

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							見下述表格
Bytes	1	1	1	2	2	6	N	2
描述	0x76	0x01	0x00		6+N	0x0000_0101_0201	……

 

	參數列表
	請詳見此接口對應的設置類接口命令
Bytes	……	……	……
描述	……	……	……

 

 

3.3.1.3. (0x0000_0101_03xx) 測試接口類

3.3.1.3.1. Cmd_0x0000_0101_0301 板載Shell接口透傳測試接口

描述：

A610產品自身支持基於串口的板載Shell調試接口，此接口用於將Shell所支持的字符串流調試信息打包下發。

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							見下述表格
Bytes	1	1	1	2	2	6	……	2
描述	0x89	0x00	0x01		6+1+N	0x0000_0101_0301	……

 

	參數列表
	字符串長度	Shell調試用的字符串流
Bytes	1	N
描述	包含’\0’

 

返回包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

執行狀態

校驗碼

Bytes

1

1

1

2

2

6

2

2

描述

0x76

0x01

0x00

6+2

0x0000_0101_0301

參考列表

 

 

 

1.1.7. (0x0000_0201_xxxx) 外設模塊->2.4G控制

3.3.1.4. (0x0000_0201_01xx) 設置類

3.3.1.4.1. Cmd_0x0000_0201_0101 設置RF主從模式

描述： 

設置模塊的工做模式，切換工做模式模塊會復位從新初始化默認配置

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							主從模式
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6+1	0x0000_0201_0101

1) 主從模式

• 0x00表示Server
• 0x01表示Client
• 復位值：0x00

 

3.3.1.4.2. Cmd_0x0000_0201_0102 設置RF地址

描述： 

總共4個地址，RF模塊地址。收、發模塊必須設置相同才能正常工做

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							模塊地址
Bytes	1	1	1	2	2	6	4	2
描述	0x89	0xFF	0xFF		6+4	0x0000_0201_0102

1) 模塊地址：

• 復位值：0xA1, 0xB2, 0xC2, 0xB4

 

3.3.1.4.3. Cmd_0x0000_0201_0103 設置RF工做信道

描述： 

設置RF模塊工做頻道CH。收、發模塊必須設置相同才能正常工做

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							工做信道
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6+1	0x0000_0201_0103

1) 工做信道：

• 復位值：0x00
• 範圍：0~15

 

3.3.1.4.4. Cmd_0x0000_0201_0104 設置RF功率

描述： 

無

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							功率列表
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6+1	0x0000_0201_0104

1) 功率列表：

• 復位值：12
• 0：-30dBm 1：-18dBm 2：-10dBm 3：-6dBm
• 4：-3dBm 5：0dBm 6：2dBm 7：4dBm
• 8：5dBm 9：7dBm 10：8dBm 11：10dBm
• 12：13dBm

 

3.3.1.4.5. Cmd_0x0000_0201_0105 設置RF睡眠

描述： 

該命令沒有參數。該命令讓RF模塊進入低功耗模式

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0105

 

3.3.1.4.6. Cmd_0x0000_0201_0106 設置RF復位

描述： 

該命令沒有參數。只復位模塊，從新初始化默認配置。EEROM 保存的RF_ADDR和RF_CH 不改變

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0106

 

3.3.1.4.7. Cmd_0x0000_0201_0107 設置RF測試模式

描述： 

測試模式頻道範圍：0~90，即2.400G~2.490G

注意：進入測試模式後，須要復位才能進入正常工做狀態

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							測試頻點
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6+1	0x0000_0201_0107

1) 測試頻點：

• 範圍：0~90

 

3.3.1.4.8. Cmd_0x0000_0201_0108 設置RF透傳使能

描述： 

該命令用來打開或者關閉RF模塊的透傳功能，當透傳功能關閉時，RF模塊僅需處理PWC類命令，當透傳功能打開時，RF模塊須要對命令碼作判斷，將非PWC類命令透傳。

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							透傳使能
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6	0x0000_0201_0108	0：Open 1：Close

 

 

3.3.1.5. (0x0000_0201_02xx) 讀取類

3.3.1.5.1. Cmd_0x0000_0201_0201 獲取RF主從模式

描述： 

設置模塊的工做模式，切換工做模式模塊會復位從新初始化默認配置

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0201

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								主從模式
Bytes	1	1	1	2	2	6	2	1	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0201_0201	參考列表

1) 主從模式

• 0x00表示Server
• 0x01表示Client
• 復位值：0x00

 

3.3.1.5.2. Cmd_0x0000_0201_0202 獲取RF地址

描述： 

總共4個地址，RF模塊地址。收、發模塊必須設置相同才能正常工做

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0202

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								模塊地址
Bytes	1	1	1	2	2	6	2	4	2
描述	0x76	0xFF	0xFF		6+6	0x0000_0201_0202	參考列表

1) 模塊地址：

• 復位值：0xA1, 0xB2, 0xC2, 0xB4

 

3.3.1.5.3. Cmd_0x0000_0201_0203 獲取RF工做信道

描述： 

設置RF模塊工做頻道CH。收、發模塊必須設置相同才能正常工做

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0203

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								工做信道
Bytes	1	1	1	2	2	6	2	1	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0201_0203	列表

1) 工做信道：

• 復位值：0x00
• 範圍：0~15

 

3.3.1.5.4. Cmd_0x0000_0201_0204 獲取RF功率

描述： 

無

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0204

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								功率
Bytes	1	1	1	2	2	6	2	1	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0201_0204	列表

1) 功率列表：

• 復位值：12
• 0：-30dBm 1：-18dBm 2：-10dBm 3：-6dBm
• 4：-3dBm 5：0dBm 6：2dBm 7：4dBm
• 8：5dBm 9：7dBm 10：8dBm 11：10dBm
• 12：13dBm

 

3.3.1.5.5. Cmd_0x0000_0201_0205 獲取RF鏈接狀態

描述： 

LINKS = 1，TX和RX 創建鏈接。LINKS = 0，TX和RX鏈接斷開

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0205

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								鏈接狀態
Bytes	1	1	1	2	2	6	2	1	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0201_0205	列表

1) 鏈接狀態：

• 復位值：0x00
• 0：非鏈接
• 1：鏈接

 

3.3.1.5.6. Cmd_0x0000_0201_0206 獲取RF信號強度

描述： 

TX和RX 創建鏈接後，能夠獲取RX 信號強度。範圍：0~0x0F。0x0F 信號最強

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0206

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								信號強度
Bytes	1	1	1	2	2	6	2	1	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0201_0206	列表

1) 信號強度：

• 復位值：0x00

 

3.3.1.5.7. Cmd_0x0000_0201_0207 獲取RF固件版本

描述： 

無

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0201_0207

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								固件版本
Bytes	1	1	1	2	2	6	2	4	2
描述	0x76	0xFF	0xFF		6+6	0x0000_0201_0207	列表

 

 

3.3.1.6. (0x0000_0201_03xx) 主動上報類

3.3.1.6.1. Cmd_0x0000_0201_0301 RF模塊向外部MCU上報鏈接狀態 

描述：

無

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							RF模塊鏈接狀態
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6+1	0x0000_0201_0301	……

1) RF模塊鏈接狀態：有效範圍[0, 1]，1表示有效鏈接

 

 

1.1.8. (0x0000_0301_xxxx) IAP流程->通用

3.3.1.7. (0x0000_0301_01xx) 設備端IAP

3.3.1.7.1. Cmd_0x0000_0301_0101 獲取設備運行區間參數

描述： 

此命令用於獲取設備端的運行區間（Boot或者App）

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0301_0101

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								運行區間
Bytes	1	1	1	2	2	6	2	1	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0301_0101	參考列表	0：Boot  1：App

 

3.3.1.7.2. Cmd_0x0000_0301_0102 設置設備運行區間參數

描述： 

此命令用於設置設備端的運行區間，讓設備跳轉到指定運行區間運行

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							運行區間
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6+1	0x0000_0301_0102	0：Boot  1：App

 

返回包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

執行狀態

校驗碼

Bytes

1

1

1

2

2

6

2

2

描述

0x76

0xFF

0xFF

6+2

0x0000_0301_0102

參考列表

 

3.3.1.7.3. Cmd_0x0000_0301_0103 獲取設備預留Flash大小

描述： 

無

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0301_0103

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								Flash大小
Bytes	1	1	1	2	2	6	2	4	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0301_0103	參考列表

 

3.3.1.7.4. Cmd_0x0000_0301_0104 向設備傳輸版本文件

描述： 

無

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							見下述表格
Bytes	1	1	1	2	2	6	……	2
描述	0x89	0xFF	0xFF		6+5+N	0x0000_0301_0104

 

	參數列表
	包結束標識	包序號	包長度	包內容
Bytes	1	2	2	N
描述	0：進行中 1：結束

1) 包結束標識：

• 1：此包爲最後一個數據包，若是此包內有效數據不足包長度限制，則填充0xFF

2) 包序號：

• 0：第一包，下位機將對整塊存儲空間作擦除操做，時間較長

 

返回包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

執行狀態

校驗碼

Bytes

1

1

1

2

2

6

2

2

描述

0x76

0xFF

0xFF

6+2

0x0000_0301_0104

參考列表

 

3.3.1.7.5. Cmd_0x0000_0301_0105 向設備傳輸版本文件屬性參數

描述： 

無

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							見下述表格
Bytes	1	1	1	2	2	6	……	2
描述	0x89	0xFF	0xFF		6+8	0x0000_0301_0105

 

	參數列表
	版本文件長度	版本文件CRC
Bytes	4	4
描述

 

返回包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

執行狀態

校驗碼

Bytes

1

1

1

2

2

6

2

2

描述

0x76

0xFF

0xFF

6+2

0x0000_0301_0105

參考列表

 

3.3.1.7.6. Cmd_0x0000_0301_0106 設置待升級下位機固件對象

描述： 

此命令用於設置下位機的待升級對象，當下位機有多個待升級板載對象時，經過此命令來告知下位機的總控對象將IAP應用流程分流處理。

命令包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	參數列表	校驗碼
							板載對象
Bytes	1	1	1	2	2	6	1	2
描述	0x89	0xFF	0xFF		6+1	0x0000_0301_0106

1) 板載對象：

• 0x01：待升級固件對象爲A610的MCU
• 0x02：待升級固件對象爲xxxx的MCU
• 0x03：待升級固件對象爲2.4G無線RF模塊
• 0x04：待升級固件對象爲半載大容量存儲器

 

返回包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

執行狀態

校驗碼

Bytes

1

1

1

2

2

6

2

2

描述

0x76

0xFF

0xFF

6+2

0x0000_0301_0106

參考列表

 

3.3.1.7.7. Cmd_0x0000_0301_0107 獲取待升級下位機對象Boot區支持的數據包長度

描述： 

此命令用於獲取設備端Boot區域支持的數據包長度參數

命令包格式：

引導碼

本機地址

對方地址

會話ID

數據長度

命令碼

校驗碼

Bytes

1

1

1

2

2

6

2

描述

0x89

0xFF

0xFF

6

0x0000_0301_0107

 

返回包格式：

	引導碼	本機地址	對方地址	會話ID	數據長度	命令碼	執行狀態	參數列表	校驗碼
								運行區間
Bytes	1	1	1	2	2	6	2	2	2
描述	0x76	0xFF	0xFF		6+3	0x0000_0301_0107	參考列表

1) 此條命令經過設備的Boot反饋所支持的數據包長度參數，由Pc動態分配不一樣固件對象所支持的數據緩存，以此作到IAP接口以及應用很廣流程的兼容性。