feedc0de/esp-idf
1
0
Fork 0
forked from espressif/esp-idf
Code Pull Requests Activity

docs(ble): Adjusted the title level in en/api-guides/ble/blufi.rst

Browse Source
This commit is contained in:
Yuhan Wei
2024-07-24 16:41:52 +08:00
committed by Wei Yu Han
parent dc6f1503c2
commit 28160ef5d6
1 changed files with 11 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/en/api-guides/ble/blufi.rst
View File

@@ -1,7 +1,10 @@
Introduction BluFi
============== ^^^^^^
:link_to_translation:`zh_CN:[中文]` :link_to_translation:`en:[English]`
Overview
----------
The BluFi for {IDF_TARGET_NAME} is a Wi-Fi network configuration function via Bluetooth channel. It provides a secure protocol to pass Wi-Fi configuration and credentials to {IDF_TARGET_NAME}. Using this information, {IDF_TARGET_NAME} can then connect to an AP or establish a SoftAP. The BluFi for {IDF_TARGET_NAME} is a Wi-Fi network configuration function via Bluetooth channel. It provides a secure protocol to pass Wi-Fi configuration and credentials to {IDF_TARGET_NAME}. Using this information, {IDF_TARGET_NAME} can then connect to an AP or establish a SoftAP.
@@ -10,7 +13,7 @@ Fragmenting, data encryption, and checksum verification in the BluFi layer are t
You can customize symmetric encryption, asymmetric encryption, and checksum support customization. Here we use the DH algorithm for key negotiation, 128-AES algorithm for data encryption, and CRC16 algorithm for checksum verification. You can customize symmetric encryption, asymmetric encryption, and checksum support customization. Here we use the DH algorithm for key negotiation, 128-AES algorithm for data encryption, and CRC16 algorithm for checksum verification.
The BluFi Flow The BluFi Flow
=============== ----------------
The BluFi networking flow includes the configuration of the SoftAP and Station. The BluFi networking flow includes the configuration of the SoftAP and Station.
@@ -43,7 +46,7 @@ The following uses Station as an example to illustrate the core parts of the pro
2. The data lengths before and after symmetric encryption/decryption must stay the same. It also supports in-place encryption and decryption. 2. The data lengths before and after symmetric encryption/decryption must stay the same. It also supports in-place encryption and decryption.
The Flow Chart of BluFi The Flow Chart of BluFi
======================== -------------------------
.. seqdiag:: .. seqdiag::
:caption: BluFi Flow Chart :caption: BluFi Flow Chart
@@ -72,7 +75,7 @@ The Flow Chart of BluFi
.. _frame_formats: .. _frame_formats:
The Frame Formats Defined in BluFi The Frame Formats Defined in BluFi
=================================== ------------------------------------
The frame formats for the communication between the mobile phone App and {IDF_TARGET_NAME} are defined as follows: The frame formats for the communication between the mobile phone App and {IDF_TARGET_NAME} are defined as follows:
@@ -428,7 +431,7 @@ The format of ACK Frame:
The **CheckSum** field takes two bytes, which is used to check "sequence + data length + clear text data". The **CheckSum** field takes two bytes, which is used to check "sequence + data length + clear text data".
The Security Implementation of {IDF_TARGET_NAME} The Security Implementation of {IDF_TARGET_NAME}
================================================= --------------------------------------------------
1. Securing Data 1. Securing Data
@@ -479,7 +482,7 @@ The data to be encrypted and decrypted must be in the same length. The IV8 is an
This function is used to compute CheckSum and return a value of CheckSum. BluFi uses the returned value to compare the CheckSum of the frame. This function is used to compute CheckSum and return a value of CheckSum. BluFi uses the returned value to compare the CheckSum of the frame.
GATT Related Instructions GATT Related Instructions
========================== ----------------------------
UUID UUID
>>>>> >>>>>