From 35ba8e644cd0560da12649baa1637318e7f8e146 Mon Sep 17 00:00:00 2001 From: "Dongping Guo (Donny)" <107092000+Donny-Guo@users.noreply.github.com> Date: Fri, 23 Aug 2024 09:59:10 -0700 Subject: [PATCH] Update Main Menu overview in BLE Receiver Markdown --- Bluetooth-Low-Energy-Receiver.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/Bluetooth-Low-Energy-Receiver.md b/Bluetooth-Low-Energy-Receiver.md index ec6452f..6095853 100644 --- a/Bluetooth-Low-Energy-Receiver.md +++ b/Bluetooth-Low-Energy-Receiver.md @@ -6,14 +6,15 @@ This BLE app has several features which I will highlight in a brief overview. This is the main view which provides the user with incoming packet entries captured by the BLE Scanning. -1. The BLE app upon entry will scan for BLE advertisement packets, and report them on the screen. The **Channel** knob can be used to select which advertisement channel to listen on. There is an Auto feature which will switch channels upon receiving a new packet. (Randomized from 37-39). -2. Once found the user can then select an individual MAC Address entry to pull up a more detailed view of the captured data packet. -3. The **Sort Knob** will sort the list of MAC indices by either Ascending MAC Address, dB, or by most recently updated entry. +1. The BLE app upon entry will scan for **only** BLE advertisement packets, and report them on the screen. The **Channel** knob can be used to select which advertisement channel to listen on. There is an Auto feature which will switch channels randomly from Channel 37-39 every 100ms. +2. Once found the user can then select an individual MAC Address entry to pull up a more detailed view of most recently captured data packet from this MAC Address. +3. The **Sort Knob** will sort the list of MAC indices by either Ascending MAC Address, device name, number of hits, dB, or by most recently updated entry. 4. The **Filter** button allows the user to filter based on the hex data of each packet. It also allows for filtering based on the ASCII name of the device (if found). More on that below. 5. The **Name** toggle allows the user to toggle off and on name display, if there is a name associated with the device. Not all devices have a name string. This name string is being parse from the Shortened and Complete Local Name packet type. See BLE Spec for information on packet types. -6. The **Clear** button allows the user to clear entries as they fill up the screen. -7. The **Export CSV** file allows the user to export the current list of packet entries into a csv style file. Upon resaving the file, the file will update the existing entries with new data, as well as append new entries to the existing file. -8. The **Tx** button allows the user to switch to the BLE Tx app. See BLETX for more information. +6. The **Log** toggle allows BLE app to write all filtered packet data into SD card under `/BLERX/Logs`. Each log entry contains timestamp, packet type, length of the packet, MAC address, and packet data. +7. The **Clear** button allows the user to clear entries as they fill up the screen. +8. The **Export CSV** file allows the user to export the current list of packet entries into a csv style file. Upon resaving the file, the file will update the existing entries with new data, as well as append new entries to the existing file. +9. The **Tx** button allows the user to switch to the BLE Tx app. See BLETX for more information. # Packet Detail Menu: