Pada project ini, Anda akan menggunakan Shield Workshop Antares pada modul ESP8266 . Pada Shield Workshop Antares ini terdapat sensor suhu, kelembapan (DHT11), relay, LED dan push button. Anda akan melakukan monitoring suhu dan kelembapan sesuai periode interval yang ditentukan. Hasil data yang dikirim oleh sensor dapat anda pantau melalui console Antares dan ditampilkan pada OLED.
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.
Shield Workshop Antares
Modul OLED SSD1036 0,96inch 128x64 pixel berbasis I2C
Library Antares ESP MQTT. 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.
Kode program dapat Anda buka pada Arduino IDE melalui File > Example > Antares ESP HTTP > ESP8266-Simple-Project > SEND_DATA_DHT11_OLED.
Berikut adalah kode program dari contoh SEND_DATA_DHT11_OLED.
// Library initialization#include<AntaresESPMQTT.h>// Library initiation for Antares ESP8266 MQTT#include"DHT.h"// Load DHT sensor library for reading temperature and humidity#include<Adafruit_SSD1306.h>// Load OLED display library#defineDHTPIN D1 // Define DHTPIN variable, pointing to pin D1#defineDHTTYPE DHT11 // Set DHT type to DHT11#defineSCREEN_WIDTH128 // Define OLED screen width#defineSCREEN_HEIGHT64 // Define OLED screen height#defineOLED_RESET-1 // Define OLED reset pin, set to -1 as it's not used#defineSCREEN_ADDRESS0x3C // Define OLED I2C address#defineACCESSKEY"YOUR-ACCESS-KEY" // Replace with your Antares account access key#defineWIFISSID"YOUR-WIFI-SSID" // Replace with your Wi-Fi SSID#definePASSWORD"YOUR-WIFI-PASSWORD" // Replace with your Wi-Fi password#defineprojectName"YOUR-APPLICATION-NAME" // Replace with the Antares application name that was created#definedeviceName"YOUR-DEVICE-NAME" // Replace with the Antares device name that was createdconstunsignedlong interval =10000; // 10 s interval to send messageunsignedlong previousMillis =0; // will store last time message sentAntaresESPMQTTantares(ACCESSKEY); // Create an antares object for connecting to AntaresDHTdht(DHTPIN,DHTTYPE); // Create a dht object for the DHT sensorAdafruit_SSD1306display(SCREEN_WIDTH,SCREEN_HEIGHT,&Wire,OLED_RESET); // Create a display object for the OLED screenvoidsetup() {Serial.begin(115200); // Initialize serial communication with baudrate 115200antares.setDebug(true); // Turn on debug mode. Set to "false" if you don't want messages to appear in the serial monitorantares.wifiConnection(WIFISSID, PASSWORD); // Attempt to connect to Wi-Fi with the specified SSID and passwordantares.setMqttServer();dht.begin(); // Initialize the DHT sensor objectif (!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDRESS)) {Serial.println(F("SSD1306 allocation failed")); // Check if the OLED is successfully initializedfor (;;) ; }display.clearDisplay(); // Clear the OLED displaydisplay.setTextColor(SSD1306_WHITE); // Set text color to whitedisplay.setTextSize(1); // Set text size to 1display.setCursor(0,0); // Set cursor position to (0, 0)display.println(F("Temperature & Humidity")); // Display "Temperature & Humidity" text on the OLEDdisplay.display(); // Show the text on the OLEDdelay(2000); // Delay for 2 seconds}voidloop() {antares.checkMqttConnection(); // Check interval overflowif (millis() - previousMillis > interval) { previousMillis =millis();float hum =dht.readHumidity(); // Read humidity value from the DHT sensorfloat temp =dht.readTemperature(); // Read temperature value from the DHT sensorif (isnan(hum) ||isnan(temp)) { // Check if the sensor reading is invalidSerial.println("Failed to read DHT sensor!"); // If the reading is invalid, print an error messagereturn; // Exit the loop function and wait for the next cycle }display.clearDisplay(); // Clear the OLED displaydisplay.setTextSize(1); // Set text size to 1display.setCursor(0,0); // Set cursor position to (0, 0)display.print(F("Temperature: ")); // Display "Temperature: " text on the OLEDdisplay.print(temp); // Display temperature value on the OLEDdisplay.println(F(" C")); // Display " C" (for Celsius) on the OLEDdisplay.print(F("Humidity: ")); // Display "Humidity: " text on the OLEDdisplay.print(hum); // Display humidity value on the OLEDdisplay.println(F(" %")); // Display " %" (for percentage) on the OLEDdisplay.display(); // Show the text on the OLEDSerial.println("Temperature: "+ (String)temp +" *C"); // Print temperature value to the serial monitor with "*C" formatSerial.println("Humidity: "+ (String)hum +" %"); // Print humidity value to the serial monitor with "%" format // Add variable data to the storage buffer in Antaresantares.add("temperature", temp);antares.add("humidity", hum); // Send data from the storage buffer to Antaresantares.publish(projectName, deviceName); }}
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-project-name" // Antares project name
#define deviceName "YOUR-DEVICE-NAME-" // Antares device name
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 ESP8266 WEMOS D1R2 dengan komputer Anda dan pastikan Communication Port terbaca.
Pada sistem operasi Windows pengecekan dapat dilakukan melalui Device Manager. Jika ESP8266 WEMOS D1R2 Anda terbaca maka tampil USB-Serial CH340 dengan port menyesuaikan ketersediaan port (pada kasus ini terbaca COM4).
Atur board ESP8266 WEMOS D1R2 dengan klik Tools > Board > esp8266 pada Arduino IDE, kemudian pastikan yang digunakan adalah LOLIN(WEMOS) D1 R2 & mini. 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 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 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. Periksa Data di Antares
Setelah upload program berhasil, selanjutnya buka halaman device antares kemudian lihat apakah data sudah berhasil dikirim.
Data yang dikirimkan dari ESP8266 dengan protokol HTTP berupa variabel temperature dan humidity.
6. Output program
Send data DHT 11 dan ditampilkan pada display OLED setelah terhubung ke Wi-Fi tertampil pada gambar dibawah ini: