TheArchive/mayhem-firmware
1
0
Fork 0
mirror of https://github.com/portapack-mayhem/mayhem-firmware.git synced 2024-11-23 10:05:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
Page: Bluetooth Low Energy Receiver
Pages
3d printed enclosure ADS B(S) AFSK AIS Boats APRS RX APRS TX About firmwares Access Radio Hardware Analog TV Receiver Antennas Applications At first glance Audio Receivers Automatic dependent surveillance–broadcast (ADS B) BHT BLESpam Bitmap reverse decode Bluetooth Low Energy Receiver Bluetooth Low Energy Transmitter Boot Process Building External Apps Burger Pager C16 format Capture Care ChibiOS Notes Clifford's version Code contribution rules Code formatting Compile firmware Compile on Arch based distro (exclude Asahi) Compile on WSL with ninja Completely reset Config Menu Create a Custom Map with Offline Map Maker Create a Simple App Create a custom splash screen Creating a prod stable release DFU overlay Dead Coin Cell Battery Debug via SWD & JTAG Debug with serial Debug Decoder for NRF24L01 Dev build versions Diagnose firmware update in Windows Differences Between H1 and H2 models Dissecting the Temperature logger Documentation Standards & Guidelines ERT Encoder External App Roadmap FAQ Factory Defaults Features File manager Firmware Architecture First steps Flash Utility Fox Hunt Freq manager Full reset GPS Sim H2 Enclosure H2 Plus speaker modifications HackRF Hardware overview Help! Im not receiving anything! Receive Quality Issues Home How to ask questions in correct way How to collaborate How to compile faster with WSL 2 I2C external device driver integration IQ trim Information on APRS Intended Use and Legality Internal speaker Interpret Guru meditation crashes Jammer Keyboard view LCR LGE Tool Level Looking Glass Main Controls Main Menu Maintaining rules Make airlines db Make icao24 db Microphone Tranceiver Microphone Transceiver Morse Notepad Notes About ccache OOK Editor OOK Original GSG HackRF One POCSAG Receiver POCSAG PR process Pac‐Man Persistent Memory Playlist PortaPack Versions Powering the PortaPack Preamplifier IC replacement ProtoView Push buttons and button caps RDS Radiosonde Random password Receivers Recon Redirections Remote Replay SD Card (DEV) SD Card Content SD Over USB SD card not recognized by PC with the SD card over USB selected SMA Antenna connector SSTV Scanner Screenshots Search Settings Signal Generator Sleep mode Software Dev Guides Soundboard Spectrum Painter Splash and other images Stealth Mode TPMS Cars TX Carrier Only Text Entry Theme system Title Bar TouchTunes Transmitters Troubleshooting UI Screenshots USB Serial Console Unit Tests Update firmware troubleshooting Update firmware Updating the Xilinx CPLD on hackrf board Usage cautions User interface Using MAC OS Utilities WardriveMap Wav viewer Weather SubGhzD Web USB Serial When you saw the sdcard content warning Widgets Wipe SD Card Won't boot Won Wont boot Work Needed World map generation
30 Bluetooth Low Energy Receiver
bjornjulian00 edited this page 2024-10-23 10:47:12 +02:00
Table of Contents

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.

Main Menu:

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 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 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:

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:

  1. The MAC Address
  2. The PDU Type which displays the last received PDU packet type as noted here:
Type Name Description
00 ADV_IND Scannable advertising indication for all devices
01 ADV_DIRECT_IND Directed advertising to a specific device indicating that only that device can connect
02 ADV_NONCONN_IND Advertising indication but not accepting connections or scans
03 SCAN_REQ Sent by a device to receive more info from scannable advertisers
04 SCAN_RSP Response to 03 containing more info
05 CONNECT_REQ Sent to an advertiser to initiate a connection
06 ADV_SCAN_IND Scannable advertising indication but not accepting connections
07 ADV_EXT_IND BT 5.0, points to additional data on secondary channels
09 AUX_ADV_IND BT 5.0, scannable advertising indication for all devices on secondary channels
0A AUX_SCAN_REQ BT 5.0, sent by a device to receive more info from scannable advertisers on secondary channels
0B AUX_SCAN_RSP BT 5.0, response to 0A containing more info
0C AUX_CONNECT_REQ BT 5.0, sent to an advertiser to initiate a connection
0D AUX_CHAIN_IND BT 5.0, chains advertising packets together when they get too big
0E AUX_CONNECT_RSP BT 5.0, response to 0C
10-26 Link Layer Link layer setup and operation
26-FF Data General data and proprietary

  1. The last packets received for each data type, their length, and their contents.

  2. The Send button immediately moves the user to the BLE TX app and allows the user to transmit the selected packet data.

  3. The Save button allows the user to save packets in the format used by the BLE TX app.

  4. The Done button brings the user back to the Main Menu.

Video:

Below short example on using the BLE Rx App.

https://vimeo.com/886881206?share=copy

References:

BLE Tx App: Bluetooth Low Energy Transmitter

BLE Packet Types: https://www.bluetooth.com/wp-content/uploads/Files/Specification/Assigned_Numbers.pdf?id=3

Reference Code Used in Porting Protocol: https://github.com/JiaoXianjun/BTLE

Start here

How to collaborate
How to ask questions correctly

User manual

Developer Manual

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.