Thursday, May 7, 2026

OSO ESP32 LoRa Gateway

# ESP32 LoRa Gateway

## Pendahuluan

Proyek ini adalah sebuah Gateway LoRa serbaguna yang dibangun menggunakan ESP32. Perangkat ini dirancang untuk menjembatani komunikasi antara jaringan LoRa dengan jaringan lain seperti Ethernet (LAN) atau WiFi (WLAN), serta dengan perangkat Modbus (RTU dan TCP).

Gateway ini memiliki dua mode operasi utama, **Master** dan **Slave**, yang ditentukan saat kompilasi kode. Selain itu, terdapat **Mode Konfigurasi** yang memungkinkan pengguna untuk mengubah pengaturan perangkat melalui antarmuka web yang mudah digunakan.

## Fitur Utama

- **Dua Mode Utama:** Dapat berfungsi sebagai **Master** atau **Slave** dalam jaringan LoRa.

- **Konektivitas Fleksibel:**

- **Master Mode:** Mendukung koneksi ke jaringan via Ethernet (W5500) atau WiFi.

- **Slave Mode:** Mendukung mode **Modbus RTU** (melalui RS485/RS232) atau **Modbus TCP** (melalui WiFi).

- **Antarmuka Konfigurasi Web:** Mode Access Point (AP) khusus untuk konfigurasi perangkat melalui browser. Tidak perlu mengubah kode untuk pengaturan dasar.

- **Penyimpanan Konfigurasi:** Pengaturan disimpan secara permanen di memori non-volatile (NVS) ESP32.

- **Modbus RTU Mapping (Master Mode):** Memungkinkan pemetaan register Modbus dari beberapa slave ke alamat lokal.

- **Reboot Jarak Jauh:** Perangkat dapat di-reboot dari antarmuka web.

- **Dibangun dengan PlatformIO:** Memudahkan manajemen library dan proses build.

## Alur Komunikasi Modbus yang Didukung

Gateway ini secara efektif menjembatani sistem SCADA berbasis Modbus TCP ke perangkat Modbus di lapangan melalui jaringan LoRa. Berikut adalah alur yang didukung:

1. **Modbus TCP ke Modbus RTU (via LoRa)**

- **Alur:** `SCADA (TCP)` <-> `Master Gateway (LoRa)` <-> `Slave Gateway (LoRa)` <-> `Perangkat Modbus (RTU)`

- **Deskripsi:** Sistem SCADA mengirimkan perintah Modbus TCP ke Master Gateway. Master meneruskannya melalui LoRa ke Slave Gateway, yang kemudian mengubahnya menjadi sinyal Modbus RTU untuk perangkat akhir yang terhubung secara serial (RS485/RS232).

2. **Modbus TCP ke Modbus TCP (via LoRa)**

- **Alur:** `SCADA (TCP)` <-> `Master Gateway (LoRa)` <-> `Slave Gateway (LoRa)` <-> `Perangkat Modbus (TCP)`

- **Deskripsi:** Sistem SCADA mengirimkan perintah Modbus TCP ke Master Gateway. Master meneruskannya melalui LoRa ke Slave Gateway. Slave Gateway kemudian mengirimkan perintah Modbus TCP melalui jaringan WiFi lokal ke alamat IP perangkat akhir.

## Mode Operasi

### 1. Mode Konfigurasi

Ini adalah mode utama untuk mengatur semua parameter perangkat.

- **Cara Masuk:**

1. Tekan dan tahan tombol `MODE_BUTTON_PIN` saat perangkat dinyalakan.

2. Atau, tekan tombol tersebut saat perangkat sedang berjalan normal.

- **Fungsionalitas:**

- ESP32 akan membuat Access Point (AP) WiFi dengan SSID `OSO-LoRa-Master-Config` atau `OSO-LoRa-Slave-Config`.

- Hubungkan perangkat Anda (laptop/HP) ke AP tersebut dengan password `12345678`.

- Buka browser dan navigasikan ke alamat `192.168.4.1`.

- Antarmuka web akan muncul, memungkinkan Anda untuk mengkonfigurasi:

- **Jaringan:** Pengaturan WiFi, Ethernet, dan mode Modbus (RTU/TCP).

- **LoRa:** Alamat, channel, baud rate, dan parameter LoRa lainnya.

- **Mapping:** (Hanya di mode Master) Aturan pemetaan Modbus.

- **Sistem:** Aksi seperti reboot perangkat.

### 2. Master Mode

Dalam mode ini, gateway berfungsi sebagai **server Modbus TCP** yang menjembatani sistem SCADA dengan perangkat LoRa di lapangan.

- **Konektivitas ke SCADA:**

- Master Gateway dapat terhubung ke jaringan lokal (LAN) melalui **Ethernet (W5500)** atau **WiFi**.

- Setelah terhubung, ia akan mendapatkan alamat IP dan siap menerima koneksi Modbus TCP dari sistem SCADA pada alamat IP tersebut.

- **Alur Kerja:**

1. SCADA (sebagai Modbus TCP Client) mengirim permintaan ke alamat IP Master Gateway.

2. Master Gateway menerima permintaan, memprosesnya, dan meneruskannya melalui jaringan LoRa ke slave yang dituju.

3. Slave LoRa merespons kembali ke Master Gateway.

4. Master Gateway meneruskan respons tersebut kembali ke SCADA.

### 3. Slave Mode

Dalam mode ini, gateway menghubungkan satu perangkat Modbus ke jaringan LoRa.

- **Sub-Mode:**

- **Modbus RTU:** Gateway terhubung ke perangkat Modbus (misalnya, sensor atau meteran) melalui antarmuka serial (RS485 atau RS232). Ia akan meneruskan permintaan LoRa dari Master ke perangkat Modbus RTU ini.

- **Modbus TCP:** Gateway terhubung ke jaringan WiFi lokal dan menjembatani komunikasi LoRa ke sebuah *end device* (perangkat target) melalui protokol Modbus TCP.

Monday, March 16, 2026

Berikut contoh dokumentasi lengkap MQTT Payload untuk Modbus Gateway ESP32 yang bisa langsung dipakai sebagai manual produk / dokumentasi user.

OSO Gateway

MQTT – Modbus Gateway Payload Documentation

OSO Gateway adalah perangkat Industrial IoT Gateway yang berfungsi menghubungkan perangkat Modbus RTU / Modbus TCP dengan MQTT Broker sehingga data PLC atau perangkat industri dapat dikirim ke cloud, dashboard, SCADA, atau Node-RED.

1. Arsitektur Sistem

Gateway bekerja sebagai bridge antara Modbus dan MQTT.


Modbus Device / PLC
        │
        │ Modbus RTU / TCP
        ▼
     OSO Gateway
        │
        │ MQTT
        ▼
     MQTT Broker
        │
        ▼
Dashboard / NodeRED / Cloud / SCADA

Fungsi gateway:

Polling data Modbus
Publish data ke MQTT
Menerima command dari MQTT
Mengirim write command ke Modbus device

2. Struktur Topic MQTT

Gateway menggunakan dua topic utama.

Topic	Fungsi
`gateway/cmd`	Mengirim perintah Modbus
`gateway/data`	Data Modbus dari gateway

3. MQTT Command (Write Modbus)

Topic:


gateway/cmd

Payload:


{
 "slave":1,
 "fc":6,
 "addr":0,
 "value":1
}

Parameter:

Field	Keterangan
slave	Modbus Slave ID
fc	Function Code
addr	Address register
value	Nilai yang akan ditulis

4. Contoh Perintah Write Register

Payload:


{
 "slave":1,
 "fc":6,
 "addr":0,
 "value":1
}

Artinya gateway akan mengirim perintah Modbus:


Slave ID  : 1
Function  : 06 (Write Single Register)
Address   : 0
Value     : 1

Jika menggunakan addressing PLC standar:


40001 = 1

5. Contoh Write Coil

Payload:


{
 "slave":1,
 "fc":5,
 "addr":0,
 "value":1
}

Arti:


Slave 1
Write Coil
Address 0
Value ON

Value:

Value	Status
0	OFF
1	ON

6. Function Code yang Didukung

FC	Nama	Fungsi
1	Read Coil	Membaca coil
2	Read Discrete Input	Membaca input
3	Read Holding Register	Membaca register
4	Read Input Register	Membaca input register
5	Write Single Coil	Menulis coil
6	Write Single Register	Menulis register

7. Data yang Dikirim Gateway

Topic:


gateway/data

Contoh payload:


{
  "gw": "esp32gw",
  "data": {
    "1:0": 1,
    "1:1": 1111,
    "2:0": 222,
    "2:1": 2222
  }
}

8. Penjelasan Field Payload

Field	Keterangan
gw	Nama gateway
data	Data hasil polling Modbus

9. Format Mapping Data

Format key pada field data:


slave:address

Contoh:

1:0

Artinya:


Slave ID : 1
Register : 0

Contoh lain:

2:1

Artinya:


Slave ID : 2
Register : 1

10. Contoh Interpretasi Data

Payload:


{
  "gw": "esp32gw",
  "data": {
    "1:0": 1,
    "1:1": 1111,
    "2:0": 222,
    "2:1": 2222
  }
}

Interpretasi:

Slave	Address	Value
1	0	1
1	1	1111
2	0	222
2	1	2222

11. Contoh Integrasi Node-RED

Subscribe topic:


gateway/data

Untuk mengambil nilai:


msg.payload.data["1:0"]

Contoh penggunaan:

Register	NodeRED
Slave1 Addr0	msg.payload.data["1:0"]
Slave1 Addr1	msg.payload.data["1:1"]
Slave2 Addr0	msg.payload.data["2:0"]

12. Contoh Testing dengan MQTT Explorer

Publish command:

Topic:


gateway/cmd

Payload:


{
 "slave":2,
 "fc":6,
 "addr":1,
 "value":123
}

Gateway akan menulis:


Slave ID : 2
Register : 1
Value    : 123

13. Keunggulan Format Payload Ini

Keuntungan format ini:

✔ Ringkas
✔ Mudah diparse di ESP32
✔ Mendukung multi slave
✔ Mendukung multi register
✔ Mudah dipakai di NodeRED / SCADA
✔ Payload ringan untuk IoT

14. Contoh Flow Sistem IoT


PLC
 │
 │ Modbus RTU
 ▼
OSO Gateway
 │
 │ MQTT Publish
 ▼
MQTT Broker
 │
 ├── NodeRED
 ├── SCADA
 ├── Dashboard Web
 └── Cloud Database

Saturday, March 14, 2026

oso gateway UART RTU TCP MQTT

OSO GATEWAY

Solusi Integrasi Modbus RTU, Modbus TCP, dan MQTT untuk Monitoring Industri & IoT dalam Satu Perangkat.

Deskripsi Produk

OSO Gateway merupakan perangkat komunikasi industri yang dirancang untuk menghubungkan berbagai protokol komunikasi seperti Modbus RTU, Modbus TCP, dan MQTT dalam satu sistem.

Perangkat ini berfungsi sebagai penghubung antara perangkat industri yang menggunakan komunikasi serial RS485 dengan sistem monitoring modern berbasis jaringan Ethernet maupun cloud IoT. Data dari PLC, energy meter, dan sensor dapat dikirim ke sistem SCADA secara real-time.

Pesan Sekarang

Antarmuka Konfigurasi Web

Dashboard System

Menampilkan Firmware versi.

Network Settings

Konfigurasi IP Address, Subnet Mask, Gateway, DNS Server, dan Port komunikasi melalui browser.

Modbus Configuration

Atur Slave ID, Baudrate, Parity, Stop Bit, dan Response Timeout.

Data Mapping Register

Memetakan alamat register RTU ke Modbus TCP atau MQTT.

Alur Komunikasi & Topologi

Sisi Modbus RTU (Slave)

Perangkat seperti Power Meter atau PLC dihubungkan secara Daisy Chain menggunakan RS485 (A+/B-) menuju Gateway. Mendukung hingga lebih dari 10 slave sekaligus.

Sisi Network (Master/Cloud)

Gateway bertindak sebagai server bagi Modbus TCP Client (SCADA/HMI) dan sebagai klien MQTT yang mengirimkan data ke broker cloud secara otomatis.

Integrasi MQTT & Spesifikasi Teknis

MQTT Integration

Broker Address
Client ID
Topic Publish
JSON Payload

Tabel Spesifikasi Teknis

Fitur	Detail
Tegangan Input	9 – 24 VDC
Interface	RS485 & RJ45 Ethernet
Baudrate RTU	Up to 115200
Suhu Operasi	-20°C s/d 60°C
Protokol	RTU, TCP, MQTT

Integrasi MQTT & Spesifikasi Teknis

☁️ MQTT Integration

Mendukung MQTT Broker lokal maupun cloud dengan fitur konfigurasi lengkap:

✅ Broker Address & Port
✅ Client ID & Auth (User/Pass)
✅ Topic Publish & Subscribe
✅ JSON Format Payload

Tabel Spesifikasi Teknis

Fitur	Detail
Tegangan Input	9 – 24 VDC
Interface	RS485 & RJ45 Ethernet
Baudrate RTU	Up to 115200 bps
Suhu Operasi	-20°C s/d 60°C
Protokol	RTU, TCP, MQTT, TCP UART

Cocok Untuk Berbagai Aplikasi

SCADA Monitoring Industrial IoT Smart Energy Metering Smart Factory PLC to Cloud

Siap Mengoptimalkan Monitoring Anda?

Klik tombol di bawah ini untuk konsultasi teknis atau pemesanan unit OSO Gateway.

HUBUNGI KAMI (WA)

OSO Gateway – Modbus RTU, Modbus TCP dan MQTT Gateway untuk Sistem Monitoring Industri

OSO Gateway merupakan perangkat komunikasi industri yang dirancang untuk menghubungkan berbagai protokol komunikasi seperti Modbus RTU, Modbus TCP, dan MQTT dalam satu sistem. Perangkat ini berfungsi sebagai penghubung antara perangkat industri yang menggunakan komunikasi serial RS485 dengan sistem monitoring modern berbasis jaringan Ethernet maupun cloud IoT.

Dengan menggunakan OSO Gateway, data dari perangkat seperti PLC, energy meter, sensor industri, maupun controller dapat dikirim ke sistem SCADA atau dashboard monitoring secara real-time melalui jaringan.

Gambar Produk

Perangkat OSO Gateway dirancang dengan ukuran yang ringkas dan mudah dipasang pada panel kontrol industri. Gateway ini dilengkapi dengan interface komunikasi RS485 untuk Modbus RTU serta port Ethernet untuk koneksi jaringan.

Dengan desain yang praktis, perangkat ini dapat digunakan untuk berbagai kebutuhan integrasi sistem industri tanpa memerlukan perangkat tambahan yang kompleks.Klik di sini untuk memesan OSO Gateway

Penjelasan OSO Gateway

OSO Gateway berfungsi sebagai jembatan komunikasi antara perangkat Modbus RTU dengan sistem jaringan berbasis TCP/IP. Dalam banyak sistem industri, perangkat lapangan seperti PLC dan sensor menggunakan komunikasi serial RS485 dengan protokol Modbus RTU.

Sementara itu, sistem monitoring modern seperti SCADA, server database, dan platform IoT biasanya menggunakan jaringan Ethernet dengan protokol Modbus TCP atau MQTT. OSO Gateway memungkinkan kedua sistem tersebut saling terhubung sehingga data dari perangkat lapangan dapat dipantau secara real-time melalui jaringan lokal maupun internet.

Selain itu, gateway ini juga menyediakan fitur konfigurasi berbasis web yang memudahkan pengguna dalam melakukan pengaturan sistem tanpa perlu menggunakan software tambahan.

Gambar Dashboard

Dashboard web pada OSO Gateway memberikan tampilan informasi status perangkat secara langsung. Melalui dashboard ini pengguna dapat melihat kondisi jaringan, status koneksi perangkat, serta aktivitas komunikasi yang sedang berlangsung.

Tampilan dashboard dirancang sederhana dan mudah dipahami sehingga memudahkan teknisi dalam melakukan monitoring dan pengecekan sistem.

Penjelasan Network

OSO Gateway menyediakan halaman pengaturan jaringan yang memungkinkan pengguna mengatur parameter koneksi Ethernet secara langsung melalui browser.

Pengaturan yang tersedia meliputi:

IP Address
Subnet Mask
Gateway
DNS Server
Port komunikasi

Dengan fitur ini, perangkat dapat dengan mudah disesuaikan dengan konfigurasi jaringan yang digunakan pada sistem industri.

Gambar Network

Halaman Network Setting memungkinkan pengguna melakukan konfigurasi jaringan secara cepat dan praktis tanpa perlu menggunakan perangkat lunak tambahan.

Penjelasan Modbus

Pada bagian konfigurasi Modbus, pengguna dapat mengatur parameter komunikasi Modbus RTU agar sesuai dengan perangkat yang digunakan di lapangan.

Parameter yang dapat diatur antara lain:

Slave ID
Baudrate
Parity
Stop Bit
Response Timeout

Dengan pengaturan ini, OSO Gateway dapat berkomunikasi dengan berbagai jenis perangkat Modbus yang memiliki konfigurasi komunikasi berbeda.Klik di sini untuk memesan OSO Gateway

Gambar Modbus

Melalui halaman ini pengguna dapat menyesuaikan parameter komunikasi Modbus RTU sehingga gateway dapat membaca data dari berbagai perangkat industri dengan stabil. Klik di sini untuk memesan OSO Gateway

Penjelasan Mapping

OSO Gateway menyediakan fitur data mapping yang memungkinkan pengguna memetakan alamat register dari perangkat Modbus RTU ke sistem Modbus TCP atau MQTT.

Fitur ini sangat penting dalam sistem integrasi industri karena memungkinkan data dari berbagai perangkat dikumpulkan dan dikirim ke sistem monitoring secara terstruktur.

Mapping register memungkinkan gateway membaca data dari beberapa slave Modbus sekaligus dan mengirimkannya ke jaringan dengan format yang sesuai.

Gambar Mapping

Halaman Mapping memudahkan pengguna dalam menentukan alamat register yang akan dibaca dari perangkat Modbus RTU serta menentukan bagaimana data tersebut dikirim ke sistem monitoring.

Penjelasan MQTT

Selain mendukung komunikasi Modbus TCP, OSO Gateway juga mendukung protokol MQTT yang banyak digunakan dalam sistem Industrial IoT.

Dengan fitur MQTT, data dari perangkat Modbus dapat dikirim langsung ke server MQTT sehingga dapat digunakan untuk sistem monitoring berbasis cloud maupun dashboard IoT.

Pengguna dapat mengatur parameter MQTT seperti:

MQTT Broker Address
Port
Client ID
Username dan Password
Format payload data

Gambar MQTT

Melalui halaman konfigurasi MQTT, gateway dapat terhubung dengan server IoT sehingga data dari perangkat lapangan dapat dipantau secara real-time melalui internet.Klik di sini untuk memesan OSO Gateway

OSO ESP32 W5500 RS485

ESP32 W5500

ESP32 Ethernet RS485 Gateway + SD Card Module
Fungsi utama

Modul ini merupakan gateway komunikasi serbaguna berbasis ESP32 yang mendukung WiFi, Ethernet, dan RS485 (Modbus RTU) serta dilengkapi dengan slot SD Card untuk penyimpanan data.
Cocok digunakan pada aplikasi IoT industri, data logger, monitoring sistem, dan smart automation.

Spesifikasi Teknis
Komponen Deskripsi
Mikrokontroler : ESP32 (WiFi + Bluetooth Dual Core)
Ethernet : Interface W5500 RS485 Converter IC MAX485 / SP3485 dengan terminal A-B
Slot SD Card : Mendukung microSD FAT/FAT32 hingga 32GB
Komunikasi : RS485 (UART), Ethernet (SPI), WiFi (2.4GHz), SPI, I2C, UART
Catu : daya 5V DC melalui terminal atau micro USB. 12v-24v dari terminal
Indikator : LED Power, TX/RX, Status

Fitur Tambahan SD Card

Menyimpan data log sensor, status perangkat, atau data komunikasi RS485

Dapat digunakan untuk menyimpan konfigurasi jaringan (WiFi, IP, MQTT, dll.)

Mendukung perekaman data jangka panjang tanpa perlu koneksi internet

Akses melalui SPI interface yang kompatibel dengan library SD.h atau SD_MMC.h

Aplikasi Umum

Gateway Modbus RTU Modbus TCP

Data Logger Industri (SD Card + Ethernet + RS485)

Remote Monitoring IoT via MQTT atau HTTP

Smart Factory / Smart Building Controller

Energy / Environmental Data Recorder

Kelebihan

Konektivitas lengkap: WiFi + Ethernet + RS485 + SD Card

Dapat diatur sebagai gateway, server, atau logger

Kompatibel dengan Arduino IDE, ESP-IDF, dan PlatformIO

Dukungan library: ModbusRTU, ModbusTCP, Ethernet.h, SD.h, PubSubClient, dll.

Desain ringkas, siap untuk penggunaan di lapangan

Sekema pinout Oso Esp32 w5500

Thursday, May 7, 2026

OSO ESP32 LoRa Gateway

Monday, March 16, 2026

OSO Gateway

MQTT – Modbus Gateway Payload Documentation

1. Arsitektur Sistem

2. Struktur Topic MQTT

3. MQTT Command (Write Modbus)

4. Contoh Perintah Write Register

5. Contoh Write Coil

6. Function Code yang Didukung

7. Data yang Dikirim Gateway

8. Penjelasan Field Payload

9. Format Mapping Data

10. Contoh Interpretasi Data

11. Contoh Integrasi Node-RED

12. Contoh Testing dengan MQTT Explorer

13. Keunggulan Format Payload Ini

14. Contoh Flow Sistem IoT

Saturday, March 14, 2026

oso gateway UART RTU TCP MQTT

Deskripsi Produk

Antarmuka Konfigurasi Web

Dashboard System

Network Settings

Modbus Configuration

Data Mapping Register

Alur Komunikasi & Topologi

Sisi Modbus RTU (Slave)

Sisi Network (Master/Cloud)

Integrasi MQTT & Spesifikasi Teknis

MQTT Integration

Tabel Spesifikasi Teknis

Integrasi MQTT & Spesifikasi Teknis

☁️ MQTT Integration

Tabel Spesifikasi Teknis

Cocok Untuk Berbagai Aplikasi

Siap Mengoptimalkan Monitoring Anda?

OSO Gateway – Modbus RTU, Modbus TCP dan MQTT Gateway untuk Sistem Monitoring Industri

OSO Gateway – Modbus RTU, Modbus TCP dan MQTT Gateway untuk Sistem Monitoring Industri

Gambar Produk

Penjelasan OSO Gateway

Gambar Dashboard

Penjelasan Network

Gambar Network

Penjelasan Modbus

Gambar Modbus

Penjelasan Mapping

Gambar Mapping

Penjelasan MQTT

Gambar MQTT

Monday, November 10, 2025

OSO ESP32 W5500 RS485