Copyright (C) 2026 BI3BJU
Android native implementation of the FT8 Plus 1.0 protocol demo. It is based on the
FT8 Plus desktop/Python project and uses a Java UI plus a JNI bridge to a C
ft8_lib decoder/encoder.
- Upstream protocol demo: https://github.com/BI3BJU/FT8_Plus_Desktop
- Email: guerilla1949@gmail.com
| Main |
|---|
![]() |
- Real-time FT8 receive: 12 kHz mono
AudioRecord, 15 s slots, JNI decoder. A slot scheduler triggers decoding after each slot; decoded DT is tracked with an EMA and a jump-snap rule to compensate audio input latency. - Transparent single-frame TX: i3=6, f2=0, up to 9 UTF-8 bytes,
0x20padding, no CRC/EOT. - Transparent continuous-frame TX: i3=6, f2=1, 9 bytes per frame,
CRC8 + EOT
0x04, up to 64 frames / 574 bytes. RX groups frames by frequency within +/-10 Hz and reassembles them with slot tracking; missing slots are shown as[frame missing]. - Free text TX/RX: i3=0, up to 13 chars, Base42 charset.
- Beacon: every 16 slots (240 s), sends a 13-char Base42 location message
containing callsign + 8-char Maidenhead grid. Requires a valid callsign and
8-char grid; skipped when the TX input field is not empty. Received beacon
rows show
CALL GRID; tapping such a row opens the map. - Contacts: max 100 contacts, remark max 32 UTF-8 bytes. Received source callsigns are auto-saved. Entries involving the local callsign are highlighted and underlined. Contact remarks are shown in history.
- History/status logs:
history.txtin JSON Lines,status.txtin plain text, each trimmed to the latest 1000 lines. On-screen history holds up to 1000 entries. - Optional preamble noise for VOX: 0.5 s white noise + 0.5 s silence before each FT8 frame.
- Half-duplex operation: RX pauses during TX and resumes afterwards; beacon runs on its own worker thread.
- NTP sync at startup with multiple servers and retry; only the app's internal UTC offset is adjusted, system time is not modified.
- Map fallback:
geo:URI first, Bing Maps fallback when no map app handles it.
- The message-processing layer in this Android code handles i3=0 free text,
i3=6 transparent frames, and location beacons. i3=1 standard FT8 messages
are currently skipped by
processDecodedMessages(). Standard FT8 QSO TX is not implemented. - No CAT / PTT / serial / frequency control. Audio only via the system default input and output devices.
- For amateur radio FT8 experimentation only. Comply with local regulations, licensed frequencies, power limits, and callsign rules.
- Android Studio with Android SDK.
- The project includes a Gradle Wrapper (workspace shows Gradle 8.10).
- Android NDK and CMake for
ft8_jni/ft8_lib. - Real device recommended for RX/TX. Emulator microphone may be silent.
- Permissions:
RECORD_AUDIOfor RX.WRITE_EXTERNAL_STORAGEon Android 10 and below.MANAGE_EXTERNAL_STORAGEon Android 11+ for direct access toDocuments/FT8 Plus/.ACCESS_FINE_LOCATION/ACCESS_COARSE_LOCATIONoptional, for deriving the grid from system location.
Windows:
gradlew.bat assembleDebugmacOS / Linux:
./gradlew assembleDebugOr open the project in Android Studio and use Run.
APK is normally under app/build/outputs/apk/debug/. In this workspace the
intermediate APK is also present at
app/build/intermediates/apk/debug/app-debug.apk.
Install:
adb install -r app/build/outputs/apk/debug/app-debug.apkIf the outputs path differs, use Android Studio: Build > Build APK(s).
- Grant microphone permission. On Android 11+ grant All files access if prompted.
- Set your callsign. Format: 3-7 chars, 1-2 prefix + digit + 0-4 letters, prefix must contain a letter.
- Set an 8-char Maidenhead grid if you want beacon or map features.
- RX starts after
RECORD_AUDIOis granted. The UTC clock and status area show NTP/recording state. - Type a message in the TX field.
- If it matches free-text rules (up to 13 chars, Base42 charset), it is sent as i3=0.
- Otherwise it is sent as transparent single-frame or continuous-frame data.
- Byte and frame counters show the computed size.
- Press Transmit; press Stop to cancel. RX resumes after TX.
- Beacon button toggles automatic beacon. Beacon requires valid callsign and grid, and sends only when the TX input is empty.
- Long-press input, status, or history for copy/clear menus.
- Tap a beacon row containing a grid to open the map.
- Slot period: 15 s.
- Sample rate: 12000 Hz, mono PCM 16-bit.
- Symbol rate 6.25; HPS=4; BPT=2.
- 0.04 s per hop; 0.160 s per symbol; 375 hops per slot; 750 hops for two periods.
- TX frequency 300-3000 Hz; default 1500 Hz; step 6.25 Hz.
- Max raw data 574 bytes; max 64 frames.
- Frequency grouping tolerance +/-10 Hz.
- Free text: i3=0, n3=0, up to 13 chars, Base42 charset.
- Transparent single frame: i3=6, f2=0, up to 9 UTF-8 bytes,
0x20padding, no CRC/EOT. - Transparent continuous frames: i3=6, f2=1, 9 bytes per frame, CRC8 + EOT
0x04. - Beacon: 13-char Base42 location payload. Callsign is base36 in 37 bits, 8-char Maidenhead grid is 31 bits; total 68-bit payload.
- Merge/timeout: receive buffer timeout scales with the received slot span; the code contains a base delay constant of 60 s.
Directory: Documents/FT8 Plus/
config.txt: JSON withcallsign,grid,tx_freq,preamble_noise.contact.txt: one contact per line ascallsign,remark.history.txt: JSON Lines history entries.status.txt: plain-text status log.
Retention:
- History log: latest 100 lines.
- Status log: latest 100 lines.
- Contacts: max 100, remark max 32 UTF-8 bytes.
app/src/main/java/com/bi3bju/ft8_plus/MainActivity.javaUI, audio capture/playback, slot scheduler, NTP, persistence, protocol framing, location codec, contacts, history/status logs.app/src/main/res/layout/activity_main.xmlMain screen layout.app/src/main/res/values/strings.xmlEnglish resources.app/src/main/res/values-zh-rCN/strings.xmlChinese resources.app/src/main/cpp/jni/ft8_jni.cppJNI bridge.app/src/main/cpp/ft8_lib/C decoder/encoder library (common,fft,ft8).app/src/main/cpp/CMakeLists.txtNative build definition.gradle/wrapper/Gradle Wrapper.
- NTP sync does not change system time; it only updates the app's internal offset.
- Audio latency compensation uses decoded DT with EMA and a hard jump threshold.
- Direct File API is used for persistence because MediaStore writes were unreliable on some MIUI builds. Android 11+ therefore needs All files access.
- This project is for demonstration and amateur radio experimentation. Use legal power, frequencies, and callsigns.
GPL-3.0. See LICENSE.txt.
