Daftar Isi

Dokumentasi

Memulai

Catatan: Voidmesh mengadopsi teknologi dari Meshtastic. Pelajari juga dokumentasi Meshtastic untuk pemahaman lebih dalam.

Apa itu Voidmesh?

Voidmesh adalah firmware open-source LoRa mesh networking untuk perangkat berbasis ESP32. Memungkinkan komunikasi multi-hop antar perangkat tanpa koneksi internet, sempurna untuk GPS tracking, aplikasi IoT, dan komunikasi off-grid.

Mulai Cepat

  1. Dapatkan Perangkat: Beli LilyGO T-Beam v1.2 dari toko kami atau sumber lain.
  2. Flash Firmware: Gunakan web flasher untuk install Voidmesh langsung dari browser.
  3. Nyalakan: Hubungkan baterai atau power USB. Perangkat akan otomatis mulai dan menemukan node lain.
  4. Tambah Node: Flash perangkat tambahan untuk memperluas jaringan mesh.

Perangkat Keras

Perangkat yang Didukung

LilyGO T-Beam v1.2
  • ESP32-D0WDQ6-V3 (240MHz, Dual Core)
  • SX1276 LoRa 433/470MHz
  • NEO-M8N GPS Module
  • SSD1306 0.96" OLED Display
  • AXP2101 Power Management IC
  • 18650 Battery Holder

Konfigurasi Pin

FungsiGPIO
I2C SDA21
I2C SCL22
GPS RX34
GPS TX12
LoRa CS18
LoRa RST23
LoRa DIO026
LED Merah4
Tombol38

Protokol Mesh

Fitur

  • Auto-discovery: Node broadcast discovery setiap 30 detik
  • Multi-hop routing: Pesan diteruskan dengan TTL (default 5 hop)
  • Deteksi duplikat: Mencegah forward ulang pesan yang sama
  • Node tracking: Hingga 20 node dilacak, timeout setelah 2 menit
  • Berbagi GPS: Node berbagi lokasi GPS melalui jaringan mesh

Tipe Pesan

TipeIDDeskripsi
DISCOVERY0x01Node mengumumkan diri
DISCOVERY_ACK0x02Respons discovery
DATA0x03Pesan data generik
GPS_SHARE0x04Berbagi lokasi GPS
PING0x05Ping request
PONG0x06Ping response

Format Paket

[srcId:4][dstId:4][msgId:2][ttl:1][type:1][payloadLen:1][payload:N]

Display OLED

Display berputar antara 3 halaman setiap 5 detik:

Halaman 1: GPS
  • Nama jalan & area
  • Altitude & kecepatan
  • Status GPS
Halaman 2: LoRa
  • Status (LISTEN/RX)
  • RSSI & SNR
  • Jumlah paket
Halaman 3: Mesh
  • Node ID
  • Statistik TX/RX/FW
  • Node yang ditemukan

Indikator LED

LED Merah (GPIO4)
  • MATI: Semua sistem OK
  • NYALA (solid): Tidak ada koneksi internet
  • BERKEDIP: Error terdeteksi (LoRa gagal, GPS < 3 satelit, error kirim)
LED Biru (AXP2101)
  • KEDIP: Pergantian halaman OLED

GPS Robust

Voidmesh memiliki penanganan GPS robust untuk mengatasi sinyal yang tidak stabil:

Fitur GPS Robust:
  • Data GPS di-cache hingga 30 detik saat sinyal hilang sementara
  • Non-blocking processing - tidak mengganggu LoRa/Mesh
  • Hysteresis mencegah flip-flop antara valid/invalid
  • Status detail: FIX, WEAK, ACQ, CACHE, STALE, SEARCH, NO_DATA
Status GPS
StatusArti
FIX:XGPS valid dengan X satelit (stabil)
WEAK:XGPS valid tapi < 4 satelit
ACQ:XAcquiring, punya lokasi tapi belum reliable
CACHE:XsMenggunakan data cache, X detik yang lalu
STALEData cache terlalu lama (>30s)
SEARCHModul GPS aktif, mencari satelit
NO_DATAModul GPS tidak mengirim data

Konfigurasi

Pengaturan LoRa

#define LORA_FREQ       433.0   // MHz (gunakan 920-923 untuk Indonesia legal)
#define loraBandwidth   125.0   // kHz
#define loraSpreadingFactor 7
#define loraCodingRate  5       // 4/5
#define loraTxPower     17      // dBm
Perhatian: Untuk penggunaan legal di Indonesia, gunakan frekuensi 920-923 MHz (AS923). Lihat halaman regulasi untuk detail.

Pengaturan Mesh

#define MESH_MAX_NODES          20    // Maks node yang dilacak
#define MESH_MAX_SEEN_MSGS      50    // Buffer duplikat
#define MESH_DEFAULT_TTL        5     // Maks hop
#define MESH_DISCOVERY_INTERVAL 30000 // 30 detik
#define MESH_NODE_TIMEOUT       120000 // 2 menit

Pengaturan GPS

#define GPS_MIN_SATELLITES      3       // Min satelit untuk fix valid
#define GPS_DATA_MAX_AGE        30000   // Maks umur cache (30 detik)
#define GPS_PROCESS_INTERVAL    10      // Proses setiap 10ms

Pemecahan Masalah

  • GPS butuh langit terbuka. Keluar ruangan atau dekat jendela.
  • First fix (cold start) bisa memakan waktu 1-5 menit.
  • Minimal 3 satelit dibutuhkan untuk lokasi akurat.
  • Data akan di-cache hingga 30 detik saat sinyal hilang sementara.

LED Merah berkedip saat ada error:

  • GPS kurang dari 3 satelit - keluar ruangan
  • Inisialisasi LoRa gagal - cek hardware
  • Error kirim WiFi - cek pengaturan jaringan

  • Semua node harus pakai pengaturan LoRa sama (frekuensi, SF, bandwidth)
  • Cek koneksi antena
  • Kurangi jarak atau tambah node intermediate
  • Discovery broadcast setiap 30 detik - tunggu sebentar