-
-
Notifications
You must be signed in to change notification settings - Fork 601
Bluetooth Low Energy Receiver
As of 10/31/23, the previous BLE implementation has been updated, and improved to correct some of the issues in the previous BTLE app.
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.
- 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).
- Once found the user can then select an individual MAC Address entry to pull up a more detailed view of the captured data packet.
- The Sort Knob will sort the list of MAC indices by either Ascending MAC Address, dB, or by most recently updated entry.
- 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.
- 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.
- The Clear button allows the user to clear entries as they fill up the screen.
- 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.
- The Tx button allows the user to switch to the BLE Tx app. See BLETX for more information.
This menu is a more single detailed view on a specific entry selected by the Main Menu. More specific packet information is laid out here such as:
MAC Address, Packet Type, and Data
- The Send button immediately moves the user to the BLE TX app, and allows the user to transmit the selected packet data.
- The Save button allows the user to save a packet in the format used by the BLE TX app.
- The Done button brings the user back to the Main Menu.
Below short example on using the BLE Rx App.
https://vimeo.com/886881206?share=copy
BLE Tx App: https://github.com/eried/portapack-mayhem/wiki/BLETX
BLE Packet Types: https://www.bluetooth.com/wp-content/uploads/Files/Specification/Assigned_Numbers.pdf?id=3
Note
The wiki is incomplete. Please add content and collaborate.
Important
- This is a public wiki. Everything is visible to everyone. Don't use it for personal notes.
- Avoid linking to external tutorials/articles; they may become outdated or contain false information.
How to collaborate
How to ask questions correctly
- First steps
- Usage cautions
- Intended use and Legality
- Features
- PortaPack Versions (which one to buy)
- HackRF Versions
- Firmware update procedure
- Description of the hardware
- User interface
- Powering the PortaPack
-
Troubleshooting
- Won't boot
- Config Menu
- Firmware upgrade
- Diagnose firmware update in Windows
- Receive Quality Issues
- No TX/RX
- TX Carrier Only
- H2+ speaker modifications
- Dead Coin Cell Battery
- Factory Defaults
- SD card not recognized by PC with the SD-card over USB selected
- DFU overlay
- Full reset
- SolveBoard
- How to Format SDCard
- Applications
-
Compilation of the firmware
- Compile on WSL with ninja
- How to compile on Windows faster with WSL 2
- Using Docker and Kitematic
- Docker command-line reference
- Using Buddyworks and other CI platforms
- Notes for Buddy.Works (and other CI platforms)
- Using ARM on Debian host
- All in one script for ARM on Debian host
- Compile on Arch based distro (exclude Asahi)
- Dev build versions
- Notes About ccache
- Create a custom map
- Code formatting
- PR process
- Description of the Structure
- Software Dev Guides
- Tools
- Research
- UI Screenshots
- Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
- Development States Notes