diff --git a/docs/zh_CN/api-guides/blufi.rst b/docs/zh_CN/api-guides/blufi.rst index 1f9ec8905..043b24e57 100644 --- a/docs/zh_CN/api-guides/blufi.rst +++ b/docs/zh_CN/api-guides/blufi.rst @@ -81,35 +81,64 @@ BluFi 传输格式 帧不分片情况下的标准格式 (8 bit): -+------------+---------------+-----------------+-------------+----------------+----------------+ -| LSB - Type | Frame Control | Sequence Number | Data Length | Data | MSB - CheckSum | -+============+===============+=================+=============+================+================+ -| 1 | 1 | 1 | 1 | ${Data Length} | 2 | -+------------+---------------+-----------------+-------------+----------------+----------------+ ++-----------------+----------------+ +| Description | Value | ++=================+================+ +| LSB - Type | 1 | ++-----------------+----------------+ +| Frame Control | 1 | ++-----------------+----------------+ +| Sequence Number | 1 | ++-----------------+----------------+ +| Data Length | 1 | ++-----------------+----------------+ +| Data | ${Data Length} | ++-----------------+----------------+ +| MSB - CheckSum | 2 | ++-----------------+----------------+ 如果 **Frame Control** 帧中的 **More Frag** 使能,则 **Total Content Length** 为数据帧中剩余部分的总长度,用于报告终端需要分配多少内存。 帧分片格式(8 bit): -+------------+--------------------+----------------+------------+-------------------------------------------+----------------+ -| LSB - Type | FrameControl(Frag) | SequenceNumber | DataLength | Data | MSB - CheckSum | -+ + + + +----------------------+--------------------+ + -| | | | | Total Content Length | Content | | -+============+====================+================+============+======================+====================+================+ -| 1 | 1 | 1 | 1 | 2 | ${Data Length} - 2 | 2 | -+------------+--------------------+----------------+------------+----------------------+--------------------+----------------+ ++--------------------+-------------------------------------------+ +| Description | Value | ++====================+===========================================+ +| LSB - Type | 1 | ++--------------------+-------------------------------------------+ +| FrameControl(Frag) | 1 | ++--------------------+-------------------------------------------+ +| SequenceNumber | 1 | ++--------------------+-------------------------------------------+ +| DataLength | 1 | ++--------------------+----------------------+--------------------+ +| | Total Content Length | 2 | ++ Data +----------------------+--------------------+ +| | Content | ${Data Length} - 2 | ++--------------------+----------------------+--------------------+ +| MSB - CheckSum | 2 | ++--------------------+-------------------------------------------+ 通常情况下,控制帧不包含数据位,Ack 帧类型除外。 Ack 帧格式(8 bit): -+------------------+---------------+-----------------+-------------+-----------------------+----------------+ -| LSB - Type (Ack) | Frame Control | SequenceNumber | Data Length | Data | MSB - CheckSum | -+ + + + +-----------------------+ + -| | | | | Acked Sequence Number | | -+==================+===============+=================+=============+=======================+================+ -| 1 | 1 | 1 | 1 | 1 | 2 | -+------------------+---------------+-----------------+-------------+-----------------------+----------------+ ++------------------+--------------------------------------------+ +| Description | Value | ++------------------+--------------------------------------------+ +| LSB - Type (Ack) | 1 | ++------------------+--------------------------------------------+ +| Frame Control | 1 | ++------------------+--------------------------------------------+ +| SequenceNumber | 1 | ++------------------+--------------------------------------------+ +| DataLength | 1 | ++------------------+-----------------------+--------------------+ ++ Data + Acked Sequence Number + 2 + +| | | | ++------------------+-----------------------+--------------------+ +| MSB - CheckSum | 2 | ++------------------+--------------------------------------------+ 1. Type @@ -424,4 +453,4 @@ BluFi (ESP32 -> 手机) 特性:0xFF02,主要权限:可读可通知 1. 目前 Ack 机制已经在该 Profile 协议中定义,但是还没有代码实现。 - 2. 其他部分均已实现。 + 2. 其他部分均已实现。 \ No newline at end of file