Table of Contents

The BLETX application is intended for importing a BLE Advertisement file, parsed by the application and transmit it OTA.

The BLETX application has two modes, both which can be used after importing a file.

Single transmit mode. (This mode transmits a single BLE packet OTA given the file parameters.)
Loop Mode (This mode continuously transmits by the total number of repeats given by the file.)

A file must be present, unless moving from the BLE RX app, in order to transmit a packet. Use the Open file button to select which file to transmit. Information on file format is found below. Once loaded, the screen will update the UI with the current packet to send. If there are multiple packets in the file, the screen will update this information based on which packet is being transmitted.

The Speed setting allows the user to adjust how fast the transmit occurs.

Current Speed table is as follows:
- Speed 1: 16ms per packet.
- Speed 2: 32ms per packet.
- Speed 3: 48ms per packet.
- Speed 4: 100ms per packet.
- Speed 5: 200ms per packet.
Note: Values are approximate based on a 16ms timer period.
The Channel setting allows you to select which channel to transmit on.
The Advertisement PDU Type setting allows you to select between various types of advertisement types.
The Random toggle allows you to randomize the MAC Address that you send out with each packet.
The Save Packet saves to file the current packet list in TX format to the name you specify.
The Switch to RX button will send you to the BLE RX App. See BLE RX App for more information.

The progress bar will update, (in Loop Mode), to show how many of the current packets are left to be transmitted. This is also seen by the Packets Left indicator on screen.

Example of file:

Below is an example of how the text file show be formatted in order for it to be correctly parsed by the application. To get this transmission to show up on a BLE Scanner app set the toggle to ADV_NONCONNECT

010203040506 190953445220426c7565746f6f7468204c6f7720456e65726779 1000

010203040506 (MAC Address you want to be transmitted. Must be exactly 12 characters)

190953445220426c7565746f6f7468204c6f7720456e65726779 (Packet Data you want to be transmitted. Must be less than 62 characters, 31 byte max advertisement length per BLE spec.) In this case we are transmitting a packet with data: SDR Bluetooth Low Energy

1000 (Number of times you want the packet to be repeated.)

Its important to note all parameters must be delimited by a single space.

Note: Each line must follow this format for each packet.

010203040506 190953445220426c7565746f6f7468204c6f7720456e65726779 500 010203040507 190953445220426c7565746f6f7468204c6f7720456e65726779 500

References:

BLE Rx App: https://github.com/portapack-mayhem/mayhem-firmware/wiki/Bluetooth-Low-Energy-Receiver

Advertisement PDU Types: https://novelbits.io/bluetooth-low-energy-advertisements-part-1/

Start here

How to collaborate
How to ask questions correctly

User manual

First steps
- About firmwares
- Redirections on this manual/project
Usage cautions
Intended use and Legality
Features
PortaPack Versions (which one to buy)
HackRF Versions
- Original GSG HackRF One
- Clifford's-version
Firmware update procedure
- Updating the Xilinx CPLD on hackrf board
Description of the hardware
- Enclosure/cases
  - 3d printed enclosure
- Internal speaker
- SMD buttons and caps
- Encoder knob
- SMA Antenna connector
User interface
Powering the PortaPack
Troubleshooting
Applications
- Receivers
  - ADS-B
  - AFSK
  - AIS Boats
  - Analog TV
  - APRS
  - Audio
  - BLE RX
  - ERT Meter
  - Level
  - NRF
  - POCSAG
  - Radiosonde
  - Recon
  - Search
  - TPMS Cars
  - Weather/SubGhzD
  - Fox-Hunt
  - ProtoView
- Transmitters
  - ADS-B(S)
  - APRS
  - BHT Xy/EP
  - BLE TX
  - Burger Pager
  - GPS Sim
  - Jammer
  - LGE Tool
  - Morse
  - OOK
  - OOK Editor
  - POCSAG
  - RDS
  - Soundboard
  - Spectrum Painter
  - SSTV
  - TEDI/LCR
  - TouchTunes
  - BLESpam
- Capture
  - C16 Format
- Replay
- Remote
- Scanner
- Microphone Transceiver
- Looking Glass
- Utilities
- Settings
  - App Settings
  - Audio
  - Blacklist
  - Calibration
  - Touchscreen Threshold
  - Config Mode
  - Converter
  - Date/time
  - Encoder Dial
  - Freq. Correct
  - P.Mem Mgmt
  - QR code
  - Radio
  - User Interface
  - Brightness
  - Menu Color
- Debug
- HackRF Mode
- USB Serial Console

Developer Manual

Compilation of the firmware
Create a custom map
Code formatting
PR process
Description of the Structure
Software Dev Guides
- Code contribution rules
- Create a Simple App
- Building External Apps
- Widgets
- SD Card
- Access Radio Hardware
- Interpret Guru meditation crashes
- Create a Complex App
- Theme-system
- Debug via SWD & JTAG
- Debug with serial
- I2C drivers
Tools
Research
- Dissecting the Temperature Logger
- Differences between H1 and H2
UI Screenshots
Maintaining
- Creating a prod/stable release (Maintainers only)
- Maintaining rules
Development States Notes

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.

Main Menu:

Example of file:

References:

User manual

Developer Manual