TANZ STUDIO — FIELD DOCUMENTATION DIV. DOC. TSD-LC-26-001 · REV 1.0 · 24 SEP 2026 · SHEET 1/1

TSD-LC-26-001 · SISTEM PESAN NIRKABEL JARAK JAUH

Obrolan jarak jauh
tanpa internet.
Tanpa SIM. Tanpa BTS.

LoRa Chat menyalakan obrolan dua arah di tengah blank spot total: antarmuka Jetpack Compose bergaya iOS di ponsel Anda, jembatan Bluetooth ke gateway ESP32, lalu gelombang radio LoRa SX1278 menembus kilometer ke ponsel lawan bicara — dengan enkripsi ujung-ke-ujung, pelacak GPS, radar taktis, dan tombol SOS.

APLIKASI COM.TANZSTUDIO.LORACHAT V1.0 · KOTLIN 2.2.10 · COMPOSE M3 · ANDROID 7.0+ (API 24–36) · E2E AES-256-GCM

Frekuensi RF915 MHz · ops. 433/868/923
ModulasiLoRa CSS · SF7
Bandwidth / Coding125 kHz / 4-5
Daya pancar17 dBm PA_BOOST
Sync word0x12 private net
Auto-ACK6 s × 3 retry
Anggaran frame240 B / plafon 255 B
EnkripsiAES-256-GCM + PBKDF2
Presensi peerbeacon 30 s · exp 90 s
Siaran SOSsetiap 15 s
Unit test325 PASS / 0 FAIL
APK release±1,9 MB
TBL. 01 — Spesifikasi Kunci · diukur dari kode sumberTSD-LC-26-001
FIG. 01 — Aparatus · antarmuka pengguna, gaya iOSUI/01
RADIO LOG · GATEWAY ESP32115200 BD · 8N1
LOG. 01 — Boot & Operasi · keluaran serial gatewaySYS/01
01

Tentang Proyek

SEC.01 — APA YANG ANDA PEGANG

Satu ponsel, satu gateway seukuran kantong, dan spektrum radio terbuka. LoRa Chat adalah sistem pesan peer-to-peer yang tidak memerlukan internet, kartu SIM, menara BTS, maupun server terpusat — ponsel berbicara ke ESP32 lewat Bluetooth Classic (RFCOMM/SPP), dan gateway memancarkannya sebagai gelombang LoRa Chirp Spread Spectrum di pita ISM.

Dokumen ini disusun dari pembacaan langsung kode sumber pada commit d3f908c — setiap angka dapat dilacak ke file dan barisnya. Aplikasi Android ditulis dalam Kotlin 2.2.10 dengan Jetpack Compose Material 3, arsitektur bersih (domain murni, repository, ViewModel) dan injeksi dependensi manual tanpa framework. Ia berjalan dari Android 7.0 hingga target SDK 36.

Sisi perangkatnya sederhana dan murah: papan ESP32 DevKit V1 (dual core 240 MHz) plus modul radio Ai-Thinker Ra-02 berbasis Semtech SX1278, dengan total komponen seharga ratusan ribu rupiah. Firmware gateway 601 baris C++/Arduino berperan sebagai transparent bridge dua arah antara Bluetooth dan radio.

Skenarionya yang sesungguhnya: tanggap bencana saat jaringan seluler tumbang, pendakian di blank spot, pelayaran, atau komunitas perbatasan yang tak pernah tercakup BTS. Selama kedua pihak memegang ponsel dan gateway masing-masing, obrolan tetap berjalan — dari ratusan meter di perkotaan padat hingga belasan kilometer pada garis pandang bebas.

Sebagai alat riset, repo juga membawa dua firmware pendukung: Web Simulator yang menyalakan antarmuka chat lewat Wi-Fi SoftAP dengan satu ESP32 saja (tanpa modul LoRa), dan Wi-Fi Virtual Bridge sepasang node sebagai pengganti sambungan radio fisik saat pengembangan.

CATATAN PENGARANG — Topologi sebenarnya adalah BINTANG, bukan mesh: firmware tidak meneruskan paket LoRa-ke-LoRa, tidak ada multi-hop. Radio adalah medium broadcast; semua node dalam jangkauan saling mendengar, tetapi penyaringan alamat penerima terjadi di aplikasi Android, bukan di gateway.

02

Arsitektur

SEC.02 — JALUR DATA EMPAT LAPISAN

Satu pesan menempuh empat lapisan — aplikasi Compose, transport RFCOMM, gateway ESP32, lalu udara terbuka — dan tiba di ponsel lawan dalam hitungan detik.

L1Ponsel AndroidLoRa Chat App
Kotlin · Compose M3
Clean Architecture
L2Gateway ESP32ESP32-WROOM-32
dual core 240 MHz
transparent bridge
L3Radio SX1278Semtech LoRa
modulasi CSS
CRC perangkat keras
L4Node LoRa Lainponsel + gateway
para pengguna lain
topologi bintang
FIG. 02 — Jalur Data · ponsel → bluetooth → ESP32 → SPI → radio → udaraARC/01
TOPOLOGIBintang, bukan mesh

Setiap ponsel punya gateway sendiri; tidak ada routing dan hop count. Semua node dalam jangkauan radio saling mendengar, dan paket ditujukan lewat alamat pada JSON — disaring di aplikasi penerima.

PERAN GATEWAYJembatan transparan

ESP32 meneruskan frame apa pun antara Bluetooth dan radio, dua arah, tanpa memahami isinya. Gateway juga mengukur telemetri RSSI/SNR nyata dari paket terakhir dan melaporkannya sebagai network_status.

ISOLASI ISIGateway tak pernah melihat isi

Enkripsi end-to-end terjadi di aplikasi — gateway hanya pernah memindahkan ciphertext yang tidak bisa dibukanya. Inilah yang membuat perlindungannya benar-benar ujung-ke-ujung.

▲ KIRIM ANDROID → PEER

  1. Tulis & kirim — batas UI 150 karakter; status PENDING disimpan lebih dulu ke Room agar tak hilang bila aplikasi mati.
  2. Bangun paket — buildOutgoingPacket() mengenkripsi bila kontak punya passphrase; hasil di-cache per messageId agar retry memakai byte yang sama persis.
  3. Fragmentasi — bila serialisasi > 240 byte, pesan dipotong jadi chat_fragment dengan amplop terukur 142 byte (kasus terburuk).
  4. Tulis ke RFCOMM — JSON satu baris + \n; status menjadi SENT.
  5. ESP32 memancarkan — frame > 255 byte ditolak dan dicatat; lalu LoRa.beginPacket() ke udara terbuka.
  6. Tunggu ACK — timeout 6 detik; hingga 3 kali retry (total 4 transmisi, ±24 detik) sebelum FAILED.

▼ TERIMA PEER → ANDROID

  1. Radio mendengar — LoRa.parsePacket() membaca payload sekaligus mengukur RSSI & SNR nyata paket terakhir.
  2. Telemetri — ESP32 mengirim network_status (rssi/snr) tiap paket; heartbeat tiap 10 detik; angka basi setelah 30 detik.
  3. Parse & filter — urutan wajib: tolak milik sendiri → tolak untuk orang lain → dedup LRU 500 entri → baru kirim ACK.
  4. Dekripsi — hasil PLAINTEXT / ENCRYPTED / UNDECRYPTABLE; ciphertext yang gagal dibuka tidak disimpan.
  5. Rakit fragmen — buffer reassembly kedaluwarsa 60 detik; lengkap → diproses sebagai chat utuh.
  6. Tampil & beri tahu — disimpan ke Room, percakapan diperbarui, notifikasi pesan masuk via foreground service.
03

Index Fitur

SEC.03 — DUA BELAS KEMAMPUAN, NOL BAR INTERNET

Dirancang untuk skenario lapangan sesungguhnya — tanggap bencana, pendakian, laut, hingga operasi komunitas di daerah blank spot. Setiap entri berikut dijaga oleh satu atau lebih suite tes pada SEC.09.

F-01Chat dua arahCORE · ZERO CLOUDObrolan teks peer-to-peer penuh lewat radio LoRa — tanpa ISP, kartu SIM, BTS, atau server terpusat sama sekali. Riwayat tersimpan lokal di Room DB v3.
F-02Enkripsi end-to-endAES-256-GCM · PBKDF2Passphrase per kontak → PBKDF2 200.000 iterasi → AES-256-GCM dengan nonce 12 byte per pesan. Fail-closed: gagal enkripsi = tidak ada yang dipancarkan.
F-03Auto-ACK & retry6 S × 3Pengiriman terjamin dengan paket balik otomatis; paket yang hilang di udara dikirim ulang hingga 3 kali — total 4 transmisi sebelum status FAILED.
F-04Fragmentasi otomatisAMPOLOP 142 B TERUKURPesan panjang dipotong sadar-surrogate (emoji tak rusak) dan dirakit ulang utuh di penerima — amplop dihitung dari serialisasi nyata, bukan diperkirakan.
F-05Telemetri real-timeRSSI · SNRRSSI (dBm) dan SNR (dB) hasil pengukuran nyata paket terakhir tampil di header obrolan — bukan angka karangan, dan ditandai basi setelah 30 detik.
F-06Presensi peerBEACON 30 S · EXP 90 SBeacon kehadiran tiap 30 detik; peer dianggap offline setelah 90 detik. Satu sumber kebenaran: contacts.lastSeen — semua jenis paket dihitung sebagai bukti hidup.
F-07Berbagi lokasi GPS< 63 BYTE · 3 MENITSesi 3 menit (1 titik/30 detik, hingga 7 titik) via murni LocationManager — tanpa Google Play Services, cocok untuk perangkat AOSP/ROM lapangan.
F-08Radar taktis50 M – 250 KMKanvas radar dengan cincin jarak adaptif, jarak Haversine, dan bearing 8 penjuru mata angin terhadap posisi Anda sendiri — plus dialog radar layar penuh.
F-09Siaran SOS daruratTIAP 15 DETIK · BROADCASTTombol darurat menyiarkan posisi + status ke seluruh jaringan setiap 15 detik (payload sos_v1), lengkap dengan banner peringatan jarak & arah di layar penerima.
F-10Foreground serviceTIDUR-LAYAR-MATI AMANBluetoothChatService menjaga soket RFCOMM dan notifikasi interaktif; LocationSharingService kompatibel penuh aturan Android 14+ (tipe location).
F-11Room DB & migrasi amanV1 → V3 IN-PLACEEmpat tabel (user_profile, contacts, conversations, messages) dengan migrasi yang menjaga riwayat; database dikecualikan dari backup demi passphrase.
F-12Konsol debugRISET PROTOKOLLayar khusus menginspeksi frame mentah TX/RX Bluetooth dan LoRa langsung dari saku — alat riset protokol yang sesungguhnya.
04

Protokol Kabel

SEC.04 — DELapan VARIAN PAKET, SATU BAHASA

Semua komunikasi dibungkus JSON satu baris dengan pemisah newline (\n). Protokol v3 bersifat aditif: peer lama tetap bisa diajak bicara — field baru cukup dihilangkan, frame lama tetap identik byte-per-byte.

v1 Pesan obrolan teks tanpa enkripsi — format asli versi 1, byte-identik dengan keluaran pertama.
{
  "protocol_version": 1,
  "type": "chat",
  "message_id": "msg_1758600000000_a1b2c3d4",  // 26 karakter — dipakai dedup & ACK
  "sender_id": "usr_tanz",
  "sender_name": "Titan Tanz",
  "receiver_id": "usr_budi",              // kosong = broadcast
  "timestamp": 1758600000000,                 // divalidasi & disanitasi
  "message": "Halo Budi, koordinat evakuasi aman di posko A."
}
{
  "protocol_version": 2,
  "type": "chat",
  "message_id": "msg_1758600000000_a1b2c3d4",
  "sender_id": "usr_tanz",
  "sender_name": "Titan Tanz",
  "receiver_id": "usr_budi",
  "timestamp": 1758600000000,
  "message": "Rk9vQmFyQmF6UXV4...",           // ciphertext base64
  "enc": 1,                                    // penanda AES-256-GCM
  "nonce": "tLN/FFL6xHfFvMDQ"                  // 12 byte acak per pesan
}
{
  "protocol_version": 3,
  "type": "chat",
  "message_id": "msg_1758600000000_a1b2c3d4",
  "sender_id": "usr_tanz",
  "sender_name": "Titan Tanz",
  "receiver_id": "usr_budi",
  "timestamp": 1758600000000,
  "message": "v1|-6.2000000|106.8166667|12.5|35.0|gps|ab12cd34|1|1",
  "kind": "location"                            // opsional; default "text"
}
// Payload darurat dalam field "message" (terenkripsi bila E2E aktif)
"sos_v1|-6.20000|106.81667|12.5|35.0|gps|sos_ab12|@riris|ACTIVE"

// struktur: prefix|lat|lon|akurasi_m|elevasi_m|sumber|session|username|status
// status: ACTIVE → VERIFIED → STOPPED
// disiarkan berulang setiap 15 detik selama darurat berlangsung
{
  "protocol_version": 1,
  "type": "ack",
  "message_id": "msg_1758600000000_a1b2c3d4"
}

// Dikirim SETELAH paket lolos penyaringan (bukan milik sendiri,
// memang untuk kita, dan belum pernah diterima) — urutan ini
// mencegah node lain ikut meng-ACK paket yang bukan miliknya.
{
  "protocol_version": 1,
  "type": "presence",
  "user_id": "usr_tanz",
  "username": "@tanz",
  "display_name": "Titan Tanz",
  "node_id": "gateway-local",
  "timestamp": 1758600000000
}

// Beacon tiap 30 detik; peer dianggap offline setelah 90 detik.
{
  "protocol_version": 1,
  "type": "network_status",
  "node_id": "esp32-gateway-local",
  "connected": true,
  "rssi": -72,
  "snr": 9.2
}

// Telemetri gateway: RSSI/SNR nyata paket terakhir; basi setelah 30 dtk.
{
  "protocol_version": 1,
  "type": "chat_fragment",
  "message_id": "msg_1758600000000_a1b2c3d4",
  "fragment_id": 1,
  "total_fragments": 4,
  "payload": "{\"protocol_version\":1,\"type\":\"chat\"..."
}

// payload = potongan JSON pesan utuh (bukan potongan teks!).
// Buffer reassembly kedaluwarsa 60 detik.
Plafon fisik 255 BFIFO SX127x tidak bisa memancarkan lebih; frame yang melampaui dibuang dan dicatat sebagai error.
Amplop terukurAmplop chat_fragment terukur 136–142 byte via serialisasi nyata — versi lama salah 6 byte per fragmen.
Timestamp tervalidasiPeer tanpa RTC yang mengirim epoch 1970 disanitasi ke waktu terima lokal agar urutan obrolan tak kacau.
Versioning asimetrisPeer v1 menerima frame v2 tanpa crash — ciphertext base64 tampil sebagai teks aneh, tapi aman.
05

Enkripsi End-to-End

SEC.05 — GATEWAY BOLEH DISADAP, ISI TETAP TERKUNCI

Radio LoRa adalah medium broadcast: siapa pun dengan penerima sepandan bisa mendengar. Karena itu enkripsi terjadi di aplikasi, sebelum byte menyentuh Bluetooth — gateway hanya pernah melihat ciphertext.

TBL. 02 — Parameter Kriptografi
CipherAES-256-GCM — terautentikasi
Fungsi kunciPBKDF2-HMAC-SHA1 · 200.000 iterasi
Panjang kunci256 bit
Nonce12 byte acak per pesan
Tag autentikasi128 bit
Salt16 byte · deterministik dari 2 user id terurut
Associated datasender_id + receiver_id terurut (anti-pengalihan)
Passphraseminimum 12 karakter
Dependensi barunol — murni javax.crypto bawaan
Model Ancaman — DITUTUP vs TERBUKA
✓
Menyadap isi di udara

Penyadap hanya melihat ciphertext base64 yang tidak bisa dibuka.

✓
Memodifikasi isi di tengah jalan

Tag GCM menolak ciphertext yang diubah sedikit pun.

✓
Mengalihkan frame ke pihak ketiga

AAD mengikat routing — menulis ulang receiver_id merusak tag.

✕
Metadata tetap terbuka

Siapa bicara dengan siapa dan kapan harus terbaca untuk routing; hanya isi yang terlindungi.

✕
Tanpa forward secrecy

Satu kunci statis per pasangan; passphrase bocor hari ini = seluruh rekaman lama terbuka.

✕
presence & ack belum diautentikasi

Pemalsuan masih mungkin — lihat ERRATA E-03.

Pengguna A Pengguna B │ sepakati passphrase di luar radio │ │ (tatap muka / telepon / kanal lain) │ │ │ ├─ PBKDF2(passphrase, salt(A,B)) → kunci AES-256 │ ├─ seal(teks, kunci, AAD(A,B)) │ │ → nonce acak 12 byte + tag 16 byte │ │ │ ├─ kirim: message=ciphertext_b64, enc=1, nonce ────► │ │ │ ▼ bluetooth ▼ ESP32 ▼ RF LoRa ▼ ├─ PBKDF2(passphrase, salt(B,A)) → kunci sama │ │ gateway hanya melihat ciphertext ├─ open(...) → teks asli │ │ │ ◄───────────────── ack (plaintext) ───────────┤
Keputusan 01 — SHA1?

PBKDF2-WithHmacSHA256 baru tersedia sejak API 26, sedangkan aplikasi berjalan dari minSdk 24. HMAC tidak bergantung pada ketahanan tabrakan SHA-1 dan NIST SP 800-132 masih menyetujuinya.

Keputusan 02 — salt deterministik?

Kedua ujung harus menurunkan kunci yang sama tanpa bolak-balik di tautan yang mahal. Salt dihitung dari user id yang diurutkan — arah A→B dan B→A identik.

Keputusan 03 — fail-closed?

Enkripsi gagal = pesan tidak dikirim sama sekali dan berstatus FAILED. Jalan pintas "kirim saja plaintext" membocorkan pesan tanpa sepengetahuan pengguna.

06

Lokasi · Radar · SOS

SEC.06 — SITUASI LAPANGAN DALAM SATU NAPAS

Koordinat GPS dikirim hemat byte lewat radio, digabung menjadi kartu lokasi interaktif, diproyeksikan ke radar taktis — dan saat keadaan darurat, disiarkan ke seluruh jaringan.

FIG. 03 — Radar Taktis · TacticalRadarMathNAV/01
v1|lat|lon|akurasi_m|elevasi_m|sumber|session|seq|total contoh: v1|-6.2000000|106.8166667|12.5|35.0|gps|ab12cd34|1|7 → < 63 byte · presisi 7 desimal · terenkripsi bila E2E aktif
GPS-01
Provider platform murni

Membungkus android.location.LocationManager langsung — 100% kompatibel dengan perangkat AOSP/ROM tanpa GMS di lapangan. Fix instan dari getLastKnownLocation (< 2 menit, ≤ 100 m).

GPS-02
Kartu lokasi interaktif

Jarak Haversine + bearing 8 penjuru ("450 m ke barat laut"), tombol buka di peta via intent geo: (Organic Maps / OsmAnd / GMaps) dengan fallback salin koordinat, dan tombol izin lokasi kontekstual.

GPS-03
Sesi berbagi 3 menit · 7 titik

Satu sesi = 1 fix tiap 30 detik selama 3 menit via foreground service tipe location, dengan notifikasi sisa waktu + tombol hentikan. Titik berurutan dalam 5 menit digabung jadi satu kartu timeline.

GPS-04
Proyeksi bearing-ke-layar

TacticalRadarMath memilih skala dari daftar standar 50 m – 250 km, menggambar 4 cincin jarak, dan menandai peer yang keluar radar — plus dialog radar layar penuh.

Mode Darurat — Siaran SOS TSD · DARURAT

Satu tombol di layar chat menyiarkan paket sos_v1 berisi koordinat, sumber fix, identitas, dan status ke seluruh node dalam jangkauan — diulang otomatis setiap 15 detik hingga dihentikan atau diverifikasi. Penerima melihat banner peringatan dengan jarak & arah ke korban, plus dialog SOS dengan radar.

ACTIVE — siaran berjalanVERIFIED — ditanggapi responderSTOPPED — darurat selesai
07

Hardware & Firmware

SEC.07 — ELEKTRONIK RATUSAN RIBU, JANGKAUAN KILOMETER

Profil default: ESP32 DevKit V1 + modul Ai-Thinker Ra-02 (SX1278). Firmware gateway 601 baris C++/Arduino berperan sebagai jembatan transparan dua arah Bluetooth ⇄ LoRa.

Peringatan kerusakan — 3,3 V wajib

Modul Ra-02/SX1278 beroperasi pada logika 3,3 V. Menyambungkan VCC ke pin 5V/VIN ESP32 akan membakar modul radio secara permanen. Pin DIO1–DIO5 tidak perlu dihubungkan.

TBL. 03 — Pengkabelan Ra-02 / SX1278 → ESP32 DevKit V1
VCC3V3Catu dayaWAJIB 3,3 V — bukan 5V/VIN
GNDGNDGroundground bersama
NSS / CSGPIO 5VSPI SSchip select, aktif LOW
MOSIGPIO 23VSPI MOSIdata keluar SPI
MISOGPIO 19VSPI MISOdata masuk SPI
SCK / CLKGPIO 18VSPI SCKclock SPI
RSTGPIO 14Reset modul—
DIO0GPIO 26Interupsiindikator RX/TX done
—GPIO 2LED statusLED biru bawaan board
915MHz freq
SF7spreading
125kHz BW
4/5coding rate
0x12sync word
17dBm TX
8simbol preamble
CRCon — hw
TBL. 04 — Profil Board (satu #define)
ProfilSCKMISOMOSISSRSTDIO0LED
DevKit V1 + Ra-02 ★181923514262
TTGO LoRa32 T3 V2.1.65192718232625
Heltec WiFi LoRa 32 V25192718142625
LED Status · Pola Kedip
1 Hz · 500/500 msSiap koneksi Bluetooth, modul LoRa siap
kedip gandaBluetooth siap, LoRa tidak terdeteksi — cek kabel SPI (tetap bisa di-pair)
menyala stabilTerhubung ke smartphone
kedip cepatSedang memancar / menerima radio
// Serial Monitor · 115200 baud > status → status LoRa, Bluetooth, jumlah perangkat ter-bond > unpair → hapus cache pairing di flash (link key usang) > help → daftar perintah // Bluetooth: "ESP32-LoRa-Gateway" · SSP Just Works · PIN legacy: 1234 // Hot-plug: modul LoRa dicolok belakangan → terdeteksi otomatis tiap 5 dtk
Firmware Pendukung A — Web Simulator

Uji coba menyeluruh hanya dengan satu ESP32 tanpa modul LoRa: Bluetooth SPP ke ponsel + Wi-Fi SoftAP (192.168.4.1, SSID ESP32-LoRa-WebChat) dengan Web UI sebagai "pengguna kedua". Seluruh perilaku radio disimulasikan virtual di dalam chip.

  • Auto-ACK virtual dengan delay RF ±150 ms
  • Ring buffer chat + REST API & event polling
  • Partisi Huge APP 3 MB via partitions.csv
Firmware Pendukung B — Wi-Fi Virtual Bridge

Pasangan firmware dua node (node_a_devkit_ap + node_b_cam_sta) yang menjembatani dua ESP32 lewat Wi-Fi sebagai pengganti sambungan LoRa fisik — untuk pengembangan dan demo saat modul radio belum tersedia.

  • Node A berperan sebagai Access Point
  • Node B sebagai station + kamera opsional
  • Helper bonded-device di firmware/common/
08

Aplikasi Android

SEC.08 — TUJUH LAYAR, SATU ARSITEKTUR BERSIH

Clean Architecture + MVVM dengan DI manual (AppContainer), Kotlin Coroutines & StateFlow di seluruh aliran data, dan tema Material 3 kustom identitas sky/cyan "instrument panel" — kontras terukur WCAG; status tidak pernah disampaikan lewat warna saja.

route: profile_setupProfile Setup

Nama & username wajib saat pertama jalan — identitas untuk presence.

route: homeHome

Daftar percakapan, FAB "Chat Baru", strip telemetri jaringan.

route: contactsContacts

Direktori + pencarian, badge E2E, atur passphrase per kontak (tekan lama).

route: chat/{id}Chat

Gelembung pesan, status kirim, pemisah hari, gembok enkripsi, kartu lokasi & radar, tombol SOS.

route: bluetooth_devicesBluetooth

Pindai, pasangkan, dan sambungkan gateway — kartu status per keadaan.

route: settingsSettings

Profil, anggaran payload LoRa (160–240 B), timeout ACK, mode debug.

route: debug_consoleDebug Console

Log frame mentah TX/RX secara langsung untuk riset protokol.

TBL. 05 — Matriks Teknologi
LapisanTeknologiPeran
BahasaKotlin 2.2.10seluruh aplikasi · coroutines + StateFlow 1.10.2
UIJetpack Compose · Material 3UI deklaratif bergaya iOS · BOM 2024.09.00
ArsitekturClean Architecture + MVVMdomain murni · DI manual tanpa framework
PersistensiRoom 2.7.0 + DataStore 1.1.7riwayat offline & preferensi
TransportBluetooth Classic RFCOMM/SPPlatensi rendah ke ESP32 · framing newline
KriptoAES-256-GCM + PBKDF2 (JCA)E2E tanpa dependensi baru
MikrokontrolerESP32-WROOM-32 dual core 240 MHzbridge FreeRTOS
RadioSemtech SX1278/SX1276modulasi CSS jarak jauh
BuildGradle 9.3.1 · AGP 9.1.1 · PlatformIOotomasi app + firmware
TesJUnit4 · Robolectric 1.59 · Roborazzi325 tes + verifikasi screenshot baseline
09

Kualitas & Pengujian

SEC.09 — SETIAP KLAIM DIJAGA TES OTOMATIS

Unit test berjalan di JVM dengan Robolectric — tanpa emulator. Screenshot test memakai Roborazzi dengan roborazzi.test.verify: ./gradlew testDebugUnitTest memverifikasi gambar terhadap baseline dan gagal bila berbeda, bukan diam-diam merekam ulang.

325unit test · 0 fail
46file tes JVM
9screenshot baseline
±1,9 MBAPK release
./gradlew testDebugUnitTest → BUILD SUCCESSFUL · terverifikasi pula di perangkat fisik Realme RMX2189 (Android 11)
TBL. 06 — Suite Tes Utama
SuiteCakupanYang dijaga
EncryptionTest · BugHuntCryptoProtocolprimitif kripto & kontrak kabelkedua ujung menurunkan kunci sama · nonce selalu baru · passphrase salah / ciphertext diubah / AAD tak cocok semuanya ditolak
EncryptionIntegrationTestdua repository penuh (Alice & Bob)enkripsi lewat jalur kirim/terima sungguhan termasuk fragmentasi; retry memakai ciphertext asli, bukan seal ulang
ProtocolTest · FrameWriterTestframing & serialisasiamplop terukur 136–142 byte · dedup LRU 500 · sanitasi timestamp
PresenceTruthTestkebenaran status onlineliveness dari contacts.lastSeen — peer diam tapi online tidak boleh "offline"
PostReviewFixTestregresi 4 cacat reviewhapus pesan menghentikan retransmisi · fail-closed passphrase · migrasi v1 menjaga data · flag security di-reset benar
SosAlertManagerTest · SosPayloadTestsiaran daruratformat sos_v1 · interval 15 dtk · transisi ACTIVE→VERIFIED→STOPPED
TacticalRadar*Test · LocationCard*Testradar & kartu lokasiproyeksi bearing · cincin skala · jarak Haversine · label mata angin
LocationMigrationTestskema Room v2→v3pesan lama terbaca sebagai TEXT tanpa konversi data
10

Errata

SEC.10 — BATASAN YANG DIKETAHUI & DIKETAHUI PULA JALANNYA

Dokumentasi internal proyek ini ditulis dari pembacaan langsung kode sumber dan memisahkan yang terverifikasi dari yang belum. Berikut temuan materialnya — disajikan sebagai errata, bukan disimpan diam-diam.

E-01
BLOKIR
Firmware gateway belum bisa dikompilasi via PlatformIO

Firmware memakai 4 API BluetoothSerial dari Arduino-ESP32 core 2.x, sedangkan PlatformIO kini menarik core 3.x. Jalan keluar: kunci framework-arduinoespressif32@~2.0.17, atau migrasi ke API GAP (esp_bt_gap_*). Aplikasi Android tidak terpengaruh.

E-02
KLARIFIKASI
Bintang, bukan mesh

Firmware tidak meneruskan paket LoRa-ke-LoRa — tidak ada multi-hop atau routing. Label "mesh" pada metadata awal tidak didukung implementasi dan sudah dikoreksi.

E-03
KEAMANAN
presence & ack belum diautentikasi

Siapa pun yang tahu sync word bisa memancarkan presence palsu atau ack palsu. Direkomendasikan: menandatangani kedua jenis paket itu, atau memperluas skema enkripsi mencakupnya.

E-04
KRIPTO
Tanpa forward secrecy & replay lintas-restart

Kunci statis per pasangan: passphrase bocor membuka rekaman lama. Dedup messageId bersifat per-proses. Passphrase tersimpan apa adanya di database lokal — perangkat yang di-root bisa membacanya.

E-05
EFISIENSI
Dengan E2E aktif, hampir semua pesan terfragmentasi

Base64 membesarkan isi ±49%: pesan 150 karakter menjadi 5 fragmen, dan kehilangan satu fragmen menggagalkan seluruh pesan. Praktiknya: pesan singkat saat enkripsi aktif.

E-06
RANCANG
Collision avoidance masih berupa rencana

Spesifikasi jittered exponential backoff (Android) + listen-before-talk CAD (ESP32) ada di docs/superpowers/ namun belum masuk kode — tabrakan paket masih mungkin bila dua node memancar bersamaan.

E-07
LEGAL
File LICENSE belum ada di repo

README menautkan badge Apache-2.0 tetapi filenya tidak ada — secara hukum proyek belum berlisensi eksplisit. Sisanya: beberapa dependensi (moshi, plugin gemini) tersisa tak terpakai dari scaffolding awal.

E-08
VERIFIKASI
Yang belum terverifikasi di lapangan

Jangkauan radio nyata (klaim umum LoRa, bukan pengukuran proyek), board TTGO/Heltec, perilaku Android 12–16 (uji fisik: Android 11), dan enkripsi antar dua perangkat fisik — semua tes E2E berjalan di satu JVM.

11

Prosedur Awal

SEC.11 — DARI CLONE KE UDARA DALAM TIGA LANGKAH

Butuh: ESP32 DevKit V1 + modul Ra-02, Android Studio (JDK 17/21), PlatformIO, dan dua smartphone untuk uji penuh.

1
Flash firmware ke ESP32

Buka firmware/esp32_lora_gateway/ di PlatformIO. Default sudah menarget DevKit V1 + Ra-02; board TTGO/Heltec tersedia sebagai environment terpisah.

# flash + monitor serial pio run -t upload pio device monitor
2
Build & pasang aplikasi

Buka repo di Android Studio, sambungkan HP via USB debugging, lalu jalankan tes dan build. APK release butuh keystore via KEYSTORE_PATH.

./gradlew testDebugUnitTest ./gradlew assembleDebug # → app/build/outputs/apk/debug/
3
Pairing & mulai siaran

Pengaturan → Bluetooth → pair ESP32-LoRa-Gateway (Just Works, PIN lama: 1234). Di app: tab Bluetooth → Connect → LED menyala stabil → obrolan siap mengudara.

# pairing macet? link key usang: # HP: Lupakan Perangkat → ESP32: > unpair