Mengontrol Relay dan LED Melalui Perintah Get
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 Post Data menggunakan software POSTMAN yang berisi perintah untuk mengontrol LED dan relay. Kemudian Development Board Lynx-32 melakukan Get Data dari 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.
Prasyarat Umum ESP32 Wi-FiAdapun tambahan material yang spesifik untuk project ini adalah sebagai berikut.
Shield Workshop Antares
Library Antares ESP HTTP. Pada dokumentasi ini menggunakan library Antares ESP HTTP versi 1.6.0.
Jika anda belum menginstall Antares ESP HTTP 1.6.0 dapat mengikuti langkah berikut.
Software Postman
Jika Anda belum menginstall Software POSTMAN dapat mengikuti langkah pada link berikut.
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 > GET_DATA_RELAY_LED.
Berikut adalah kode program contoh GET_DATA_RELAY_LED.
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.
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 POSTMAN
Pada langkah ini anda memerlukan software POSTMAN, Anda dapat menginput end-point, request header dan request body terlebih dahulu dengan mengikuti format berikut.
End Point
Method | POST |
URL | https://platform.antares.id:8443/~/antares-cse/antares-id/your-application-name/your-device-name |
Sesuaikan your-application-name dan your-device-name sesuai nama-nama yang terdaftar pada akun Antares Anda.
Request Header
Key | Value |
X-M2M-Origin | your-access-key |
Content-Type | application/json;ty=4 |
Accept | application/json |
Sesuaikan your-access-key dengan access key akun Antares Anda.
Hasilnya akan seperti gambar berikut.
Selanjutnya Anda perlu menginput request body dengan mengikuti format berikut.
Request Body
Pada software POSTMAN pilih tab Body kemudian pilih raw dan masukkan payload sesuai request body yang ingin digunakan seperti gambar berikut.
Sesuaikan isi field "con" sesuai dengan "key" dan "value" yang ingin Anda kirimkan.
6. Mengirim Pesan POSTMAN ke Server Antares
Setelah setup software POSTMAN selesai, saatnya mengirimkan perintah POST. Pada field "Relay" diisi dengan string "1" untuk RELAY ON atau "0" untuk RELAY OFF. Pada field "LED" diisi dengan string "1" untuk LED ON atau "0" untuk LED OFF. Field "Relay" dan "LED" ini merupakan pesan perintah untuk mengendalikan Relay dan LED yang akan dikirim melalui protokol HTTP ke server Antares.
Sesuaikan isi field "Relay" dan "LED" sesuai dengan perintah get yang ingin Anda kirimkan. Berikan nilai "1" atau "0" untuk menyalakan atau mematikan.
Jika sudah selesai mengisi field "test" selanjutnya tekan tombol Send pada software POSTMAN. Indikator request HTTP melalui software POSTMAN berhasil, pada bagian response software POSTMAN akan muncul seperti gambar 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 HTTP berupa variabel Relay dan LED.
8. Output Program
Get data dari Antares IoT Platform dan menggerakan relay dan menyalakan LED.
Last updated