Pada project ini, anda akan menggunakan Shield Workshop Antares pada modul Development Board Lynx-32Antares. Pada Shield Workshop Antares ini terdapat sensor suhu, kelembapan (DHT11), relay, LED dan push button. Anda akan melakukan monitoring suhu dan kelembapan dengan push button sebagai pemicu pengiriman data. Hasil data yang dikirim oleh sensor dapat anda pantau melalui console Antares.
Prasyarat
Material yang dibutuhkan mengikuti dengan Prasyarat Umum pada laman sebelumnya. Jika anda belum menyiapkan kebutuhan pada laman tersebut, maka anda dapat mengunjungi laman berikut.
Kode program dapat anda buka pada Arduino IDE melalui File > Examples > Antares LoRaWAN > Lynx32-Simple-Project > Class A > UPLINK_DHT11_PUSHBUTTON_CLASS_A.
Berikut adalah kode program dari contoh UPLINK_DHT11_PUSHBUTTON_CLASS_A.
#include <lorawan.h>
#include "DHT.h"
#define DHTTYPE DHT11
#define SENSOR_DHT 14
#define pushButtonPin 32
#define ledPin 12
DHT dht(SENSOR_DHT, DHTTYPE);
bool ledState = false;
bool lastButtonState = false;
//ABP Credentials
/*
Notes:
- select ABP Activation on ANTARES
- select inherit to generate your keys
- nwkSKey: 32 digit hex, you can put 16 first digits by first 16 digits your access key and add 16 digits with 0 (ex : abcdef01234567890000000000000000)
- appSKey: 32 digit hex, put 16 first digits by 0 and put last 16 digits by last 16 digit your access key (ex : 0000000000000000abcdef0123456789)
*/
const char *devAddr = "Lora-Device-Address"; // Replace with the Device Address that you have in the Antares console
const char *nwkSKey = "Network-Session-Key"; // Replace with the Network Session Key that you have in the Antares console
const char *appSKey = "Application-Session-Key"; // Replace with the Application Session Key that you have in the Antares console
char myStr[50];
char outStr[255];
byte recvStatus = 0;
int channel;
const sRFM_pins RFM_pins = {
.CS = 5, //LYNX32 to RFM NSS
.RST = 0, //LYNX32 to RFM RST
.DIO0 = 27, //LYNX32 to RFM DIO0
.DIO1 = 2, //LYNX32 to RFM DIO1
};
// get temperature and humidity from DHT11
float getTemperature()
{
float t = dht.readTemperature();
if (isnan(t)) return 0;
return t;
}
float getHumidity()
{
float h = dht.readHumidity();
if (isnan(h)) return 0;
return h;
}
void setup() {
// Setup loraid access
Serial.begin(115200);
dht.begin();
pinMode(pushButtonPin, INPUT_PULLUP);
pinMode(ledPin, OUTPUT);
digitalWrite(ledPin, LOW);
delay(2000);
if (!lora.init()) {
Serial.println("RFM95 not detected");
delay(5000);
return;
}
// Set LoRaWAN Class change CLASS_A or CLASS_C
lora.setDeviceClass(CLASS_A);
// Set Data Rate
lora.setDataRate(SF10BW125);
// set channel to random
lora.setChannel(MULTI);
// Set TxPower to 15 dBi (max)
lora.setTxPower1(15);
// Put ABP Key and DevAddress here
lora.setNwkSKey(nwkSKey);
lora.setAppSKey(appSKey);
lora.setDevAddr(devAddr);
}
void loop() {
bool currentButtonState = digitalRead(pushButtonPin);
// only toggle the LED if the new button state is HIGH
if (currentButtonState != lastButtonState && currentButtonState == LOW)
{
Serial.println("The button is pressed");
int t, h;
t = getTemperature();
h = getHumidity();
Serial.println("Temperature : " + (String)t + " C");
Serial.println("Humidity : " + (String)h + " %");
// Turn on the LED as an indicator
digitalWrite(ledPin, HIGH);
String dataSend = "{\"Temp\": " + (String)t + ", \"Humd\": " + (String)h + "}";
dataSend.toCharArray(myStr, 50);
Serial.print("Sending : ");
Serial.println(dataSend);
lora.sendUplink(myStr, strlen(myStr), 0, 5);
channel = lora.getChannel();
Serial.print(F("Ch : ")); Serial.print(channel); Serial.println(" ");
// Delay to avoid multiple uplinks due to button debouncing
delay(1000);
// Turn off the LED after sending the uplink
digitalWrite(ledPin, LOW);
}
// save the reading. Next time through the loop, it'll be the lastButtonState:
lastButtonState = currentButtonState;
// Check Lora RX
lora.update();
recvStatus = lora.readData(outStr);
if (recvStatus) {
int counter = 0;
for (int i = 0; i < recvStatus; i++)
{
if (((outStr[i] >= 32) && (outStr[i] <= 126)) || (outStr[i] == 10) || (outStr[i] == 13))
counter++;
}
if (counter == recvStatus)
{
Serial.print(F("Received String : "));
for (int i = 0; i < recvStatus; i++)
{
Serial.print(char(outStr[i]));
}
}
else
{
Serial.print(F("Received Hex : "));
for (int i = 0; i < recvStatus; i++)
{
Serial.print(outStr[i], HEX); Serial.print(" ");
}
}
Serial.println();
}
}
Kode program dapat anda buka pada Arduino IDE melalui File > Examples > Antares LoRaWAN > Lynx32-Simple-Project > Class C > UPLINK_DHT11_PUSHBUTTON_CLASS_C.
Berikut adalah kode program dari contoh UPLINK_DHT11_PUSHBUTTON_CLASS_C.
#include <lorawan.h>
#include "DHT.h"
#define DHTTYPE DHT11
#define SENSOR_DHT 14
#define pushButtonPin 32
#define ledPin 12
DHT dht(SENSOR_DHT, DHTTYPE);
bool ledState = false;
bool lastButtonState = false;
//ABP Credentials
/*
Notes:
- select ABP Activation on ANTARES
- select inherit to generate your keys
- nwkSKey: 32 digit hex, you can put 16 first digits by first 16 digits your access key and add 16 digits with 0 (ex : abcdef01234567890000000000000000)
- appSKey: 32 digit hex, put 16 first digits by 0 and put last 16 digits by last 16 digit your access key (ex : 0000000000000000abcdef0123456789)
*/
const char *devAddr = "Lora-Device-Address"; // Replace with the Device Address that you have in the Antares console
const char *nwkSKey = "Network-Session-Key"; // Replace with the Network Session Key that you have in the Antares console
const char *appSKey = "Application-Session-Key"; // Replace with the Application Session Key that you have in the Antares console
char myStr[50];
char outStr[255];
byte recvStatus = 0;
int channel;
const sRFM_pins RFM_pins = {
.CS = 5, //LYNX32 to RFM NSS
.RST = 0, //LYNX32 to RFM RST
.DIO0 = 27, //LYNX32 to RFM DIO0
.DIO1 = 2, //LYNX32 to RFM DIO1
};
// get temperature and humidity from DHT11
float getTemperature()
{
float t = dht.readTemperature();
if (isnan(t)) return 0;
return t;
}
float getHumidity()
{
float h = dht.readHumidity();
if (isnan(h)) return 0;
return h;
}
void setup() {
// Setup loraid access
Serial.begin(115200);
dht.begin();
pinMode(pushButtonPin, INPUT_PULLUP);
pinMode(ledPin, OUTPUT);
digitalWrite(ledPin, LOW);
delay(2000);
if (!lora.init()) {
Serial.println("RFM95 not detected");
delay(5000);
return;
}
// Set LoRaWAN Class change CLASS_A or CLASS_C
lora.setDeviceClass(CLASS_C);
// Set Data Rate
lora.setDataRate(SF10BW125);
// set channel to random
lora.setChannel(MULTI);
// Set TxPower to 15 dBi (max)
lora.setTxPower1(15);
// Put ABP Key and DevAddress here
lora.setNwkSKey(nwkSKey);
lora.setAppSKey(appSKey);
lora.setDevAddr(devAddr);
}
void loop() {
bool currentButtonState = digitalRead(pushButtonPin);
// only toggle the LED if the new button state is HIGH
if (currentButtonState != lastButtonState && currentButtonState == LOW)
{
Serial.println("The button is pressed");
int t, h;
t = getTemperature();
h = getHumidity();
Serial.println("Temperature : " + (String)t + " C");
Serial.println("Humidity : " + (String)h + " %");
// Turn on the LED as an indicator
digitalWrite(ledPin, HIGH);
String dataSend = "{\"Temp\": " + (String)t + ", \"Humd\": " + (String)h + "}";
dataSend.toCharArray(myStr, 50);
Serial.print("Sending : ");
Serial.println(dataSend);
lora.sendUplink(myStr, strlen(myStr), 0, 5);
channel = lora.getChannel();
Serial.print(F("Ch : ")); Serial.print(channel); Serial.println(" ");
// Delay to avoid multiple uplinks due to button debouncing
delay(1000);
// Turn off the LED after sending the uplink
digitalWrite(ledPin, LOW);
}
// save the reading. Next time through the loop, it'll be the lastButtonState:
lastButtonState = currentButtonState;
// Check Lora RX
lora.update();
recvStatus = lora.readData(outStr);
if (recvStatus) {
int counter = 0;
for (int i = 0; i < recvStatus; i++)
{
if (((outStr[i] >= 32) && (outStr[i] <= 126)) || (outStr[i] == 10) || (outStr[i] == 13))
counter++;
}
if (counter == recvStatus)
{
Serial.print(F("Received String : "));
for (int i = 0; i < recvStatus; i++)
{
Serial.print(char(outStr[i]));
}
}
else
{
Serial.print(F("Received Hex : "));
for (int i = 0; i < recvStatus; i++)
{
Serial.print(outStr[i], HEX); Serial.print(" ");
}
}
Serial.println();
}
}
3. Set LoRaWAN Parameter di Antares
Pada halaman Device console Antares lakukan Set LoRa dengan menekan button Set LoRa seperti gambar berikut.
Masukan parameter LoRaWAN dengan Lora Device Class A, Activation Mode ABP, ABP Parameters Inherit seperti pada gambar berikut.
Ketika memilih ABP Parameters Inherit makaparameter LoRa akan digenerate oleh Antares. Dari sisi perangkat, Development Board Lynx32 perlu menyesuaikan parameter LoRa tersebut.
Jangan lupa untuk menyimpan (copy) parameter Network Session Key dan Application Session Key sebelum klik Set LoRa untuk memudahkan proses selanjutnya.
Pastikan akun antares anda memiliki paket LoRa yang aktif.
Masukan parameter LoRaWAN dengan Lora Device Class C, Activation Mode ABP, ABP Parameters Inherit seperti pada gambar berikut.
Ketika memilih ABP Parameters Inherit makaparameter LoRa akan digenerate oleh Antares. Dari sisi perangkat, Development Board Lynx32 perlu menyesuaikan parameter LoRa tersebut.
Jangan lupa untuk menyimpan (copy) parameter Network Session Key dan Application Session Key sebelum klik Set LoRa untuk memudahkan proses selanjutnya.
Pastikan akun antares anda memiliki paket LoRa yang aktif.
4. Set LoRaWAN Parameter pada Kode Program
Ubah parameter LoRaWAN ABP pada variabel berikut *devAddr , *nwkSkey , dan *appSKey. Sesuaikan dengan parameter di console Antares.
Parameter *devAddr yang telah digenerate oleh Antares dapat dilihat pada halaman device setelah selesai Set LoRa.
Parameter *nwkSKey dan *appSKey didapatkan saat Set LoRa pada langkah sebelumnya.
Jika anda lupa menyimpan *nwkSkey dan *appSKey pada langkah sebelumnya maka lihat accesskey pada akun antares anda kemudian ikuti format berikut.
Example Accesskey = "aaaaaaaaaaaaaaaa:bbbbbbbbbbbbbbbb"; //32 digit accesskey
const char *nwkSKey = "aaaaaaaaaaaaaaaa0000000000000000"; //16 digit first accesskey plus 16 digit zero
const char *appSKey = "0000000000000000bbbbbbbbbbbbbbbb"; //16 digit zero plus 16 digit last acesskey
5. Compile dan Upload Program
Hubungkan Development Board Lynx-32dengan komputer anda dan pastikan Communication Port terbaca.
Pada sistem operasi Windows pengecekan dapat dilakukan melalui Device Manager.
Jika Development Board Lynx-32 anda terbaca maka akan tampil USB-Serial CH340 dengan port menyesuaikan ketersediaan port (pada kasus ini terbaca COM4).
Atur Board Lynx-32 dengan klik Tools > Board > ESP32 Arduino pada Arduino IDE, kemudian pastikan board yang digunakan adalah ESP32 Dev Module. Pilih port sesuai communicaion 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 and upload. Biasanya digunakan untuk Compile program sekaligus Flash program kedalam 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 seperti 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.
6. Periksa Data di Antares
Setelah upload program berhasil, selanjutnya buka halaman device antares kemudian lihat apakah data lora sudah berhasil dikirim.
Data yang dikirimkan dari Development Board Lynx-32 berupa "counter", "port", dan pesan yang berada didalam JSON field "data". Hasil pemantauan suhu DHT11 berada di dalam JSON field "data" yang didalamnya terdapat field "Temp" dan "Humd". Sementara parameter lainnya adalah parameter pendukung yang dihasilkan oleh Infrastruktur LoRaWAN Antares.