Antares
Antares
id
id
  • Pendahuluan
    • Registrasi Akun
    • Buat App
    • Tambah Device ke Application
    • Instalasi Board pada Arduino IDE
      • ESP8266
      • ESP32
      • STM32
    • Instalasi Arduino IDE
    • Instalasi Library Arduino
      • Antares LoRaWAN
      • Antares Wi-Fi HTTP
      • Antares Wi-Fi MQTT
      • DHT11 Sensor Library
      • Adafruit SSD1306
    • Instalasi STM32 Cube IDE
    • Instalasi STM32 Cube Programmer
    • Instalasi Expansion Pack I-CUBE-LRWAN
    • Instalasi Software
      • Instalasi MQTTX
      • Instalasi Postman
      • Instalasi Operating System (OS) pada SD Card
    • Quickstart
  • Antares Insight Hub
    • Getting Started
      • Request Demo
      • Request Free Trial
    • Usecase
      • Power Meter
        • Prasyarat Usecase Power Meter
        • Power Meter Device Recommendation
        • Payload Example Power Meter
        • Setup Device Threshold Power Meter
      • Water Meter
        • Prasyarat Usecase Water Meter
        • Water Meter Device Recommendation
        • Payload Example Water Meter
        • Setup Device Threshold Water Meter
      • Water Level
        • Prasyarat Usecase Water Level
        • Water Level Device Recommendation
        • Payload Example Water Level
        • Setup Device Threshold Water Level
      • Environment Monitoring
        • Prasyarat Usecase Environment Monitoring
        • Environment Monitoring Device Recommendation
        • Payload Example Environment Monitoring
        • Setup Device Threshold Environment Monitoring
    • Settings
      • Manage Alert Recipient (Telegram)
      • Manage User
      • Roles
  • Subscription and Payment
    • Platform
      • Cara Menggunakan Layanan Platform
      • Tata Cara Pembelian Layanan Platform
        • Pembayaran Menggunakan Virtual Account
          • Bank Mandiri
          • Bank Permata
          • Bank BRI
          • Bank BNI
        • Pembayaran Menggunakan e-Wallet (LinkAja)
        • Pembayaran Menggunakan Credit Cards (CC)
        • Pembayaran Menggunakan Antares Coins
      • Tata Cara Memperpanjang Layanan Platform
      • Tata Cara Mengganti Layanan Platform
    • Connectivity
      • Cara Menggunakan Layanan Connectivity
      • Tata Cara Pembelian Layanan Connectivity
        • Pembayaran Menggunakan Virtual Account
          • Bank Mandiri
          • Bank Permata
          • Bank BRI
          • Bank BNI
        • Pembayaran Menggunakan e-Wallet (LinkAja)
        • Pembayaran Menggunakan Credit Cards (CC)
        • Pembayaran Menggunakan Antares Coins
      • Tata Cara Memperpanjang Layanan Connectivity
      • Tata Cara Mengganti Layanan Connectivity
    • Antares Coins
      • Tata Cara Pembayaran Top Up Antares Coins
        • Pembayaran Menggunakan Virtual Account
          • Bank Mandiri
          • Bank Permata
          • Bank BRI
          • Bank BNI
        • Pembayaran Menggunakan e-Wallet (LinkAja)
        • Pembayaran Menggunakan Credit Cards (CC)
  • Contoh kode dan library
    • ESP8266 (Wi-Fi)
      • Prasyarat Umum ESP8266 Wi-Fi
      • ESP8266 (Wi-Fi) Protokol HTTP
        • Mengirim Data Sederhana ke Antares dengan Protokol HTTP
        • Mengambil Data Terakhir dari Server Antares dengan Protokol HTTP
        • Project Sederhana ESP8266 HTTP Antares
          • Post Data DHT 11 Secara Periodik
          • Post Data DHT 11 dengan Push Button
          • Post Data DHT 11 dan ditampilkan pada Display OLED
          • Get Data ditampilkan pada Display OLED
          • Post dan Get Data DHT 11 ditampilkan pada Display OLED
          • Mengontrol Relay dan LED Melalui Perintah Get
      • ESP8266 (Wi-Fi) Protokol MQTT
        • Mengirim Data Sederhana ke Antares dengan Protokol MQTT
        • Mengambil Data Terakhir dari Server Antares dengan Protokol MQTT
        • Project Sederhana ESP8266 MQTT Antares
          • Send Data DHT 11 Secara Periodik
          • Send Data DHT 11 dengan Push Button
          • Send Data DHT 11 dan ditampilkan pada Display OLED
          • Retrieve Data ditampilkan pada Display OLED
          • Send Data DHT 11 dan Retrieve Data ditampilkan pada Display OLED
          • Mengontrol Relay dan LED Melalui Perintah Get
    • Arduino Uno
      • Instalasi Arduino IDE
      • Instalasi Library Antares Ethernet Shield
      • Konfigurasi
      • Kirim Data Sederhana ke Antares
    • ESP32 (Wi-Fi)
      • Prasyarat Umum ESP32 Wi-Fi
      • ESP32 (Wi-Fi) Protokol HTTP
        • Mengirim Data Sederhana ke Antares dengan Protokol HTTP
        • Mengambil Data Terakhir dari Server Antares dengan Protokol HTTP
        • Project Sederhana Lynx-32 HTTP Antares
          • Post Data DHT 11 Secara Periodik
          • Post Data DHT 11 dengan Push Button
          • Post Data DHT 11 dan ditampilkan pada Display OLED
          • Get Data ditampilkan pada Display OLED
          • Post dan Get Data DHT 11 ditampilkan pada Display OLED
          • Mengontrol Relay dan LED Melalui Perintah Get
      • ESP32 (Wi-Fi) Protokol MQTT
        • Mengirim Data Sederhana ke Antares dengan Protokol MQTT
        • Mengambil Data Terakhir dari Server Antares dengan Protokol MQTT
        • Project Sederhana Lynx-32 MQTT Antares
          • Send Data DHT 11 Secara Periodik
          • Send Data DHT 11 dengan Push Button
          • Send Data DHT 11 dan ditampilkan pada Display OLED
          • Retrieve Data ditampilkan pada Display OLED
          • Send Data DHT 11 dan Retrieve Data ditampilkan pada Display OLED
          • Mengontrol Relay dan LED Melalui Perintah Retrieve
      • Protokol HTTP & MQTT
    • ESP32 (LoRa)
      • Prasyarat Umum ESP32 LoRa
      • Mengirim Data Sederhana ke Antares
      • Project Sederhana Lynx-32 LoRa Antares
        • Uplink Data DHT11 Secara Periodik
        • Uplink Data DHT11 dengan Push Button
        • Uplink Data DHT11 dan Ditampilkan pada Display Oled
        • Downlink Data Ditampilkan pada Display Oled
        • Uplink Data DHT 11 dan Downlink Data ditampilkan pada Display OLED
        • Mengontrol Relay dan LED melalui perintah Downlink
      • LoRaWAN Class
    • STM32 (LoRa) STM32Cube IDE
      • Prasyarat Umum STM32 (LoRa) STM32Cube IDE
      • Mengirim Data Sederhana ke Antares
    • STM32 (LoRa) Arduino IDE
      • Prasyarat Umum STM32 (LoRa) Arduino IDE
      • Mengirim Data Sederhana ke Antares
    • Raspberry Pi
      • GUI (Graphical User Interface)
        • Prasyarat Umum Raspberry GUI
        • Mengirim Data Menggunakan Node.js
        • Monitoring Suhu dan Kelembaban Menggunakan Sensor DHT11
      • SSH (Secure Shell)
        • Prasyarat Umum Raspberry SSH
        • Mengirim Data Menggunakan Node.js
        • Monitoring Suhu dan Kelembaban Menggunakan Sensor DHT11
    • NB-IoT
      • NB-Lynx-7000
        • Prasyarat Umum NB-Lynx-7000
        • Mengirim Data Sederhana ke Antares
        • Mengambil Data GNSS (Global Navigation Satellite System)
      • NB-Lynx-95
        • Prasyarat Umum NB-Lynx-95
        • Mengirim Data Sederhana ke Antares
    • Android
      • Mengambil data dari ANTARES mengunakan Android
      • Coding Stuff
    • MIT App Inventor
    • Node-RED
    • Postman
    • MQTT | Push data to Device
    • HTTP | Subscribe and Notify Mechanism
    • Library PHP
    • MQTT | Subscribe LoRa Device
    • LoRaWAN | Downlink Tutorial
    • Register Perangkat LoRaWAN
      • Register Menu
    • GPS TrackerID
  • Data Model
  • Port Configuration
  • API | HTTP
    • Device
    • Data of Device
    • Subscriber
  • API | MQTT
    • Device
    • Subscriber
  • Daftar Akronim
  • Software Relevan
Powered by GitBook
On this page
  • Pendahuluan
  • Prasyarat
  • Langkah Kerja
  • 1. Jalankan Aplikasi Arduino IDE
  • 2. Membuka Contoh Program
  • 3. Set Credential WiFi dan Credential Antares pada Kode Program
  • 4. Compile dan Upload Program
  • 5. Setup Software MQTTX
  • 6. Mengirim Pesan MQTTX ke Server Antares
  • 7. Periksa Data di Antares
  • 8. Melihat Pesan Retrieve
  1. Contoh kode dan library
  2. ESP32 (Wi-Fi)
  3. ESP32 (Wi-Fi) Protokol MQTT
  4. Project Sederhana Lynx-32 MQTT Antares

Mengontrol Relay dan LED Melalui Perintah Retrieve

PreviousSend Data DHT 11 dan Retrieve Data ditampilkan pada Display OLEDNextProtokol HTTP & MQTT

Last updated 8 months ago

Pendahuluan

Pada project ini, Anda akan menggunakan Shield Workshop Antares pada modul Development Board Lynx-32. Pada Shield Workshop Antares ini terdapat sensor suhu, kelembapan (DHT11), relay, LED, dan push button. Anda akan melakukan publish data menggunakan MQTTX yang berisi perintah untuk mengontrol LED dan relay. Kemudian Development Board Lynx-32 melakukan Subscribe Data ke Antares IoT Platform yang berisi dua opsi perintah, yaitu apabila masukan Relay bernilai 1 maka relay akan menyala; masukan Relay bernilai 0 maka relay akan mati; LED bernilai 1 maka LED akan menyala; masukan LED bernilai 0 maka LED akan mati.

Prasyarat

Material yang dibutuhkan mengikuti Prasyarat Umum pada laman sebelumnya. Jika Anda belum menyiapkan kebutuhan pada laman tersebut, maka Anda dapat mengunjungi laman berikut.

Adapun tambahan material yang spesifik untuk project ini adalah sebagai berikut.

  1. Shield Workshop Antares

  2. Library Antares ESP HTTP. Pada dokumentasi ini menggunakan library Antares ESP MQTT versi 1.0.

Jika anda belum menginstall Antares ESP MQTT versi 1.0 dapat mengikuti langkah berikut.

Antares Wi-Fi MQTT

  1. Software MQTTX

Jika Anda belum menginstall Software MQTTX dapat mengikuti langkah pada link berikut.

Instalasi MQTTX

Langkah Kerja

1. Jalankan Aplikasi Arduino IDE

2. Membuka Contoh Program

Kode program dapat Anda buka pada Arduino IDE melalui File > Examples > Antares ESP HTTP > Lynx32-Simple-Project > RETRIEVE_DATA_RELAY_LED.

Berikut adalah kode program contoh RETRIEVE_DATA_RELAY_LED.

// Include necessary libraries
#include <AntaresESPMQTT.h> // Include the ESP32 HTTP library
#include <Adafruit_SSD1306.h> // Include the OLED library

// Replace these with your own credentials
#define ACCESSKEY "YOUR-ACCESS-KEY"       // Replace with your Antares account access key
#define WIFISSID "YOUR-WIFI-SSID"         // Replace with your Wi-Fi SSID
#define PASSWORD "YOUR-WIFI-PASSWORD"     // Replace with your Wi-Fi password

#define projectName "YOUR-APPLICATION-NAME"   // Replace with the Antares application name that was created
#define deviceName "YOUR-DEVICE-NAME"     // Replace with the Antares device name that was created

#define relayPin 25
#define ledPin 12

const unsigned long interval = 10000;    // 10 s interval to send message
unsigned long previousMillis = 0;  // will store last time message sent

AntaresESPMQTT antares(ACCESSKEY);

void callback(char topic[], byte payload[], unsigned int length) {
  antares.get(topic, payload, length);

  Serial.println("New Message!");
  Serial.println("Topic: " + antares.getTopic());
  Serial.println("Payload: " + antares.getPayload());

  String relayValue = antares.getString("Relay"); // Change data field to "Relay"
  String ledValue = antares.getString("LED");     // Add reading for "LED" data field
  // Control relay based on received data
  if (relayValue == "1") {
  digitalWrite(relayPin, HIGH);
  } 
  else if (relayValue == "0") {
  digitalWrite(relayPin, LOW);
  }

  // Control LED based on received data
  if (ledValue == "1") {
  digitalWrite(ledPin, HIGH);
  } 
  else if (ledValue == "0") {
  digitalWrite(ledPin, LOW);
  }

  Serial.println("Received data - Relay: " + relayValue + " | LED: " + ledValue);
  
}

void setup() {
    Serial.begin(115200); // Initialize serial communication
    antares.setDebug(true); // Enable debugging for Antares
    antares.wifiConnection(WIFISSID, PASSWORD); // Connect to WiFi
    antares.setMqttServer();
    antares.setCallback(callback);
    pinMode(relayPin, OUTPUT); // Set relayPin as an output
    pinMode(ledPin, OUTPUT); // Set ledPin as an output
}

void loop() {
 /*
    Check if we're still connected to the MQTT broker/server.
    If disconnected, the device will try to reconnect.
   */
  antares.checkMqttConnection();
}

3. Set Credential WiFi dan Credential Antares pada Kode Program

Ubah parameter Protokol HTTP pada variabel berikut *ACCESSKEY, *WIFISSID, *PASSWORD, *projectName, dan *deviceName. Sesuaikan dengan parameter di console Antares.

#define ACCESSKEY "YOUR-ACCESS-KEY"       // Replace with your Antares account access key
#define WIFISSID "YOUR-WIFI-SSID"         // Replace with your Wi-Fi SSID
#define PASSWORD "YOUR-WIFI-PASSWORD"     // Replace with your Wi-Fi password

#define projectName "YOUR-APPLICATION-NAME"   // Replace with the Antares application name that was created
#define deviceName "YOUR-DEVICE-NAME"     // Replace with the Antares device name that was created

Parameter *Access key didapat dari laman akun Antares Anda.

Parameter WIFISSID didapat dari nama Wifi/Hotspot yang sedang digunakan oleh Anda. contohnya pada gambar di bawah ini.

Parameter *PASSWORD didapat dari password WiFi yang sedang anda gunakan.

Parameter *projectName dan *deviceName didapat dari Application Name dan Device Name yang sudah dibuat dalam akun Antares.

4. Compile dan Upload Program

Hubungkan Lynx-32 dengan komputer Anda dan pastikan Communication Port terbaca.

Pada sistem operasi Windows pengecekan dapat dilakukan melalui Device Manager. Jika Lynx-32 Anda terbaca maka tampil USB-Serial CH340 dengan port menyesuaikan ketersediaan port (pada kasus ini terbaca COM4).

Atur board ESP32 dengan klik Tools > Board > esp32 pada Arduino IDE, kemudian pastikan yang digunakan adalah ESP32 Dev Module. Pilih port sesuai communication port yang terbaca (dalam kasus ini COM4). Hasilnya akan terlihat seperti gambar berikut.

Setelah semua setup selesai, lakukan upload program dengan menekan icon panah seperti gambar berikut. Tunggu hingga selesai proses compile dan upload

Icon Centang pada Arduino IDE hanyalah proses verify. Biasanya digunakan untuk Compile program untuk mengetahui apakah terdapat error atau tidak.

Icon panah pada Arduino IDE adalah proses verify dan upload. Biasanya digunakan untuk Compile program sekaligus Flash Program pada target board.

Jika upload program berhasil maka akan terlihat seperti gambar berikut.

Setelah selesai upload program, Anda dapat melihat serial monitor untuk melakukan debug program. Icon serial monitor terlihat pada gambar berikut.

Atur serial baud rate menjadi 115200 dan pilih BothNL & CR. Hasilnya akan terlihat seperti gambar berikut.

Pastikan serial baud rate sesuai dengan nilai yang terdefinisi di kode program. Jika serial baud rate tidak sama, antara kode program dan serial monitor maka karakter ASCII tidak akan terbaca dengan baik.

5. Setup Software MQTTX

Buka Aplikasi MQTTX, lalu pilih New Connection

Agar dapat terconfigurasi antara MQTTX dengan broker Antares, sesuaikan Name, Host dan Port seperti yang ditunjukan di bawah ini, setelah itu klik Connect

Jika sudah terkoneksi maka terdapat notifikasi seperti gambar berikut

Masukan Topic dan Payload pada kolom di MQTTX.

Field
Value

Topic

/oneM2M/req/your-access-key/antares-cse/json

Payload

Sesuaikan your-access-key, nama-aplikasi-anda, dan nama-device-anda sesuai nama-nama yang terdaftar pada akun Antares Anda. Isikan pula "Field" data dan "Nilai" data pada "con" sesuai yang Anda inginkan.

Pada software MQTTX masukan Topic dan Payload yang ingin digunakan. Kemudian klik Publish untuk mengirimkan pesan dari MQTTX ke server Antares.

6. Mengirim Pesan MQTTX ke Server Antares

Setelah setup software MQTTX selesai, saatnya mengirimkan perintah PUBLISH. Pada field "Relay" diisi dengan string "1" atau "0" sebagai pesan perintah untuk Relay yang akan dikirim melalui protokol MQTT ke server Antares. Pada field "LED" diisi dengan string "1" untuk LED ON atau "0" untuk LED OFF sebagai pesan perintah untuk LED yang akan dikirim melalui protokol MQTT ke server Antares.

{
      "m2m:rqp": {
        "fr": "your-access-key",
        "to": "/antares-cse/antares-id/nama-aplikasi-anda/nama-device-anda",
        "op": 1,
        "rqi": 123456,
        "pc": {
          "m2m:cin": {
            "cnf": "message",
            "con": "{\"Relay\":\"1\",\"LED\":\"1\"}"
          }
        },
        "ty": 4
      }
    }

Jika sudah selesai mengisi field "test" selanjutnya tekan tombol PUBLISH pada software MQTTX yang terletak di sebelah kanan kolom pengisian Topic, seperti pada gambar berikut.

Jika sudah publish maka laman MQTTX akan terdapat Message seperti berikut.

7. Periksa Data di Antares

Setelah upload program berhasil, selanjutnya buka halaman device antares kemudian lihat apakah data sudah berhasil dikirim.

Data yang diterima oleh LYNX-32 dengan protokol MQTT berupa variabel Relay dan LED.

8. Melihat Pesan Retrieve

Retrieve data dari Antares IoT Platform dan ditampilkan pada display OLED setelah terhubung ke Wi-Fi tertampil pada gambar dibawah ini:

{
      "m2m:rqp": {
        "fr": "your-access-key",
        "to": "/antares-cse/antares-id/nama-aplikasi-anda/nama-device-anda",
        "op": 1,
        "rqi": 123456,
        "pc": {
          "m2m:cin": {
            "cnf": "message",
            "con": "{\"your-first-data\":\"the-integer-value\",\"your-second-data\":\"the-string-data\"}"
          }
        },
        "ty": 4
      }
    }
Prasyarat Umum ESP32 Wi-Fi
Gambar Ilustrasi Project
Letak Access Key di Laman Akun Antares
WIFISSID
Tampilan Application Name
Tampilan Device Name
Tampilan Device Manager
Tampilan Spesifikasi Board dan Port yang Digunakan
Ikon Compile untuk Centang dan Ikon Upload untuk Tanda Panah
Ikon Serial Monitor
Tampilan Serial Monitor
Membuat New Connection
Antares MQTT Broker Configuration
Antares Broker MQTTX Connected
Laman Topic dan Payload pada MQTTX
Publish untuk mengirim pesan ke server Antares
Gambar isi Payload MQTTX
Notifikasi Message Published
Gambar Halaman Console Antares Ketika Data Berhasil Diterima.