# Uplink Data DHT 11  dan Downlink Data  ditampilkan pada Display OLED

***

## Pendahuluan

Pada project ini, anda akan menggunakan **Shield Workshop Antares** pada modul **Development Board Lynx-32** **Antares**. Pada **Shield Workshop Antares** ini terdapat sensor suhu, kelembapan (DHT11), relay, LED dan push button. Anda akan mengirim data DHT11 serta dapat memberi pesan downlink yang ditampilkan pada display OLED. Proses pengiriman downlink ini menggunakan software POSTMAN yang melakukan HIT API downlink ke Platform Antares**.**

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/y6h5355mYvtg8XCU1X85/Uplink%20Data%20DHT%2011%20dan%20Downlink%20Data%20ditampilkan%20pada%20Display%20OLED.png" alt=""><figcaption><p>Gambar Ilustrasi Project</p></figcaption></figure>

## 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.

{% content-ref url="../prasyarat-umum-esp32-lora" %}
[prasyarat-umum-esp32-lora](https://docs.antares.id/contoh-kode-dan-library/esp32-lora/prasyarat-umum-esp32-lora)
{% endcontent-ref %}

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

1. Shield Workshop Antares

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/m6EIO4aK8DAyPeEK3mrP/workshop%20shield.png" alt=""><figcaption><p>Gambar Development Board Lynx-32 beserta Shield Workshop Antares.</p></figcaption></figure>

2. Modul OLED SSD1306 0.96inch 128x64 pixel berbasis I2C.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/2FPROYoP8nQrg9NtQZol/11_SSD1306_096_12864.png" alt=""><figcaption><p>Gambar Modul Oled SSD1306 0.96inch.</p></figcaption></figure>

3. Library DHT11. Pada dokumentasi ini menggunakan **DHT11 Sensor Library versi 1.4.4.**

{% hint style="info" %}
Jika anda belum menginstall library **DHT11 Sensor Library versi 1.4.4** dapat mengikuti langkah pada link berikut.

[dht11-sensor-library](https://docs.antares.id/pendahuluan/instalasi-library-arduino/dht11-sensor-library "mention")
{% endhint %}

4. Library display OLED. Pada dokumentasi ini menggunakan **Adafruit\_SSD1306 versi 2.5.7.**

{% hint style="info" %}
Jika anda belum menginstall library**Adafruit\_SSD1306 versi 2.5.7** dapat mengikuti langkah pada link berikut.

[adafruit-ssd1306](https://docs.antares.id/pendahuluan/instalasi-library-arduino/adafruit-ssd1306 "mention")
{% endhint %}

5. Software Postman.

{% hint style="info" %}
Jika anda belum menginstall **Software POSTMAN** anda dapat mengikuti langkah pada link berikut.

[instalasi-postman](https://docs.antares.id/pendahuluan/instalasi-software/instalasi-postman "mention")
{% endhint %}

## Langkah Kerja

### 1. Jalankan Aplikasi Arduino IDE

### 2. Membuka Contoh Program

{% tabs %}
{% tab title="Class A" %}
{% hint style="info" %}
Kode program dapat anda buka pada Arduino IDE melalui **File > Examples > Antares LoRaWAN >  Lynx32-Simple-Project** > **Class A > UPLINK\_DOWNLINK\_DHT11\_OLED\_CLASS\_A.**
{% endhint %}

Berikut adalah kode program dari contoh **UPLINK\_DOWNLINK\_DHT11\_OLED\_CLASS\_A.**

```arduino
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#include <lorawan.h>

#include "DHT.h"

#define DHTTYPE     DHT11
#define SENSOR_DHT  14

DHT dht(SENSOR_DHT, DHTTYPE);

// OLED object initialization
#define OLED_RESET 4
Adafruit_SSD1306 display(OLED_RESET);

//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

const unsigned long interval = 60000;    // 60 s interval to send message
unsigned long previousMillis = 0;  // will store last time message sent
unsigned int counter = 0;     // message counter
String dataSend = "";

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();

  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);

  // OLED initialization
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);  // OLED initialization with address 0x3C
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(WHITE);
  display.setCursor(0, 0);
  display.display();
  delay(2000);

}

void loop() {
  // Check interval overflow
  if (millis() - previousMillis > interval) {
    previousMillis = millis();

    int t, h;
    t = getTemperature();
    h = getHumidity();

    Serial.println("Temperature : " + (String)t + " C");
    Serial.println("Humidity    : " + (String)h + " %");

    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(" ");

    // Display temperature, humidity, and downlink data on OLED
    display.clearDisplay();
    display.setCursor(0, 0);
    display.print("Temperature : ");
    display.print(t);
    display.println(" C");
    display.print("Humidity : ");
    display.print(h);
    display.println(" %");
    display.display();

  }

  // 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]));
      }

      // Show on OLED
      display.clearDisplay();
      display.setTextSize(1);
      display.setTextColor(SSD1306_WHITE);
      display.setCursor(0, 0);
      display.println("Received String :");
      display.println((char*)outStr);
      display.display();
      delay(2000);
    }
    else
    {
      Serial.print(F("Received Hex : "));
      for (int i = 0; i < recvStatus; i++)
      {
        Serial.print(outStr[i], HEX); Serial.print(" ");
      }
      display.clearDisplay();
      display.setTextSize(1);
      display.setTextColor(SSD1306_WHITE);
      display.setCursor(0, 0);
      display.println("Received Hex : ");
      for (int i = 0; i < recvStatus; i++) {
        display.print(outStr[i] < 16 ? "0" : "");
        display.print(outStr[i], HEX);
        display.print(" ");
      }
      display.display();
      delay(2000);

    }
    Serial.println();
  }

}
```

{% endtab %}

{% tab title="Class C" %}
{% hint style="info" %}
Kode program dapat anda buka pada Arduino IDE melalui **File > Examples > Antares LoRaWAN >  Lynx32-Simple-Project** > **Class C > UPLINK\_DOWNLINK\_DHT11\_OLED\_CLASS\_C**
{% endhint %}

Berikut adalah kode program dari contoh **UPLINK\_DOWNLINK\_DHT11\_OLED\_CLASS\_C.**

```arduino
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>
#include <lorawan.h>

#include "DHT.h"

#define DHTTYPE     DHT11
#define SENSOR_DHT  14

DHT dht(SENSOR_DHT, DHTTYPE);

// OLED object initialization
#define OLED_RESET 4
Adafruit_SSD1306 display(OLED_RESET);

//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

const unsigned long interval = 60000;    // 60 s interval to send message
unsigned long previousMillis = 0;  // will store last time message sent
unsigned int counter = 0;     // message counter
String dataSend = "";

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();

  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);

  // OLED initialization
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);  // OLED initialization with address 0x3C
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(WHITE);
  display.setCursor(0, 0);
  display.display();
  delay(2000);

}

void loop() {
  // Check interval overflow
  if (millis() - previousMillis > interval) {
    previousMillis = millis();

    int t, h;
    t = getTemperature();
    h = getHumidity();

    Serial.println("Temperature : " + (String)t + " C");
    Serial.println("Humidity    : " + (String)h + " %");

    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(" ");

    // Display temperature, humidity, and downlink data on OLED
    display.clearDisplay();
    display.setCursor(0, 0);
    display.print("Temperature : ");
    display.print(t);
    display.println(" C");
    display.print("Humidity : ");
    display.print(h);
    display.println(" %");
    display.display();

  }

  // 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]));
      }

      // Show on OLED
      display.clearDisplay();
      display.setTextSize(1);
      display.setTextColor(SSD1306_WHITE);
      display.setCursor(0, 0);
      display.println("Received String :");
      display.println((char*)outStr);
      display.display();
      delay(2000);
    }
    else
    {
      Serial.print(F("Received Hex : "));
      for (int i = 0; i < recvStatus; i++)
      {
        Serial.print(outStr[i], HEX); Serial.print(" ");
      }
      display.clearDisplay();
      display.setTextSize(1);
      display.setTextColor(SSD1306_WHITE);
      display.setCursor(0, 0);
      display.println("Received Hex : ");
      for (int i = 0; i < recvStatus; i++) {
        display.print(outStr[i] < 16 ? "0" : "");
        display.print(outStr[i], HEX);
        display.print(" ");
      }
      display.display();
      delay(2000);

    }
    Serial.println();
  }

}
```

{% endtab %}
{% endtabs %}

### 3. Set LoRaWAN Parameter di Antares

Pada halaman Device console Antares lakukan Set LoRa dengan menekan button **Set LoRa** seperti gambar berikut.

<figure><img src="https://3995702122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRkxjRLeqOm0pNhLfsus%2Fuploads%2FsyprxAyDcgBPEI5NPcPK%2Fsetlora%201.png?alt=media&#x26;token=e49c923b-be8e-4f78-8587-3004b6f99a37" alt=""><figcaption><p>Gambar Halaman Console Antares untuk Set LoRa.</p></figcaption></figure>

{% tabs %}
{% tab title="Class A" %}
Masukan parameter LoRaWAN dengan **Lora Device Class A, Activation Mode ABP, ABP Parameters Inherit** seperti pada gambar berikut.

{% hint style="info" %}
Ketika memilih **ABP Parameters Inherit** maka parameter LoRa akan digenerate oleh Antares. Dari sisi perangkat, **Development Board Lynx32** perlu menyesuaikan parameter LoRa tersebut.
{% endhint %}

{% hint style="warning" %}
Jangan lupa untuk menyimpan **(copy)** parameter **Network Session Key** dan **Application Session Key** sebelum klik **Set LoRa** untuk memudahkan proses selanjutnya.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/Op470VQAJ5KeNnIWFUQY/CLASS%20A%20kotak%20setlora.png" alt=""><figcaption><p>Gambar Form berisi Parameter Set LoRa Class A.</p></figcaption></figure>

{% hint style="danger" %}
Pastikan akun antares anda memiliki paket LoRa yang aktif.
{% endhint %}
{% endtab %}

{% tab title="Class C" %}
Masukan parameter LoRaWAN dengan **Lora Device Class C, Activation Mode ABP, ABP Parameters Inherit** seperti pada gambar berikut.

{% hint style="info" %}
Ketika memilih **ABP Parameters Inherit** maka parameter LoRa akan digenerate oleh Antares. Dari sisi perangkat, **Development Board Lynx32** perlu menyesuaikan parameter LoRa tersebut.
{% endhint %}

{% hint style="warning" %}
Jangan lupa untuk menyimpan **(copy)** parameter **Network Session Key** dan **Application Session Key** sebelum klik **Set LoRa** untuk memudahkan proses selanjutnya.
{% endhint %}

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/IjkpN1mMpV2lvjXP6tVX/CLASS%20C%20kotak%20setlora.png" alt=""><figcaption><p>Gambar Form berisi Parameter Set LoRa Class C.</p></figcaption></figure>

{% hint style="danger" %}
Pastikan akun antares anda memiliki paket LoRa yang aktif.
{% endhint %}
{% endtab %}
{% endtabs %}

### 4. Set LoRaWAN Parameter pada Kode Program

Ubah parameter LoRaWAN ABP pada variabel berikut **`*devAddr`** , **`*nwkSkey`** , dan **`*appSKey`**. Sesuaikan dengan parameter di console Antares.

```arduino
const char *devAddr = "Lora-Device-Address";
const char *nwkSKey = "Network-Session-Key";
const char *appSKey = "Application-Session-Key"
```

{% hint style="info" %}
Parameter **\*devAddr** yang telah digenerate oleh Antares dapat dilihat pada halaman device setelah selesai **Set LoRa.**
{% endhint %}

{% hint style="info" %}
Parameter **\*nwkSKey**  dan **\*appSKey** didapatkan saat **Set LoRa** pada langkah sebelumnya.
{% endhint %}

<figure><img src="https://3995702122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRkxjRLeqOm0pNhLfsus%2Fuploads%2FWT02gmg7U0lzwd8GsWr7%2Fsetlora%202.png?alt=media&#x26;token=fe83472e-cb98-4754-ad82-c5ff4a598140" alt=""><figcaption><p>Gambar Halaman Console Antares Setelah berhasil Set LoRa.</p></figcaption></figure>

{% hint style="danger" %}
Jika anda lupa menyimpan \***nwkSkey** dan **\*appSKey** pada langkah sebelumnya maka lihat accesskey pada akun antares anda kemudian ikuti format berikut.

{% code overflow="wrap" %}

```arduino
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
```

{% endcode %}
{% endhint %}

### 5. Compile dan Upload Program

Hubungkan **Development Board Lynx-32**  dengan komputer anda dan pastikan **Communication Port** terbaca.

{% hint style="info" %}
Pada sistem operasi Windows pengecekan dapat dilakukan melalui **Device Manager.**&#x20;

Jika **Development Board Lynx-32** anda terbaca maka akan tampil **USB-Serial CH340** dengan port menyesuaikan ketersediaan port (pada kasus ini terbaca **COM4**).
{% endhint %}

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/XAiXBxxXUFVX8swfWA0c/comport.png" alt=""><figcaption><p>Gambar Device Manager pada Windows.</p></figcaption></figure>

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.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/bHXMy9BOpFxKNI2exOhW/4_Board%20Setup.png" alt=""><figcaption><p>Gambar Menu Tools pada Arduino IDE.</p></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/gNBqwRJL1J1RIMyPYhob/5_Upload%20and%20Compile.png" alt=""><figcaption><p>Gambar Icon Verify and Upload pada Arduino IDE.</p></figcaption></figure>

{% hint style="info" %}
**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.
{% endhint %}

Jika upload program berhasil maka akan terlihat seperti gambar berikut.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/0OF6UAOfhw7B3CfQNRLa/doneupload.png" alt=""><figcaption><p>Gambar Halaman Arduino IDE Setelah Upload berhasil.</p></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/weQ7rgplDgbBvpcC2gNR/8_Serial%20Monitor.png" alt=""><figcaption><p>Gambar Icon Serial Monitor pada Arduino IDE.</p></figcaption></figure>

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

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/V6qQ5DXLlzneEaZ9FGaa/9_Serial%20Communication.png" alt=""><figcaption><p>Gambar Serial Monitor.</p></figcaption></figure>

{% hint style="danger" %}
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.
{% endhint %}

### 6. 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

<table data-header-hidden><thead><tr><th width="119"></th><th></th></tr></thead><tbody><tr><td><strong>Methode</strong></td><td>POST</td></tr><tr><td><strong>URL</strong></td><td>https://platform.antares.id:8443/~/antares-cse/antares-id/<mark style="color:red;">your-application-name/your-device-name</mark></td></tr></tbody></table>

{% hint style="info" %}
Sesuaikan <mark style="color:red;">your-application-name</mark> dan <mark style="color:red;">your-device-name</mark> sesuai nama-nama yang terdaftar pada akun Antares anda.
{% endhint %}

#### Request Header

| **Key**      | **Value**                                       |
| ------------ | ----------------------------------------------- |
| X-M2M-Origin | <mark style="color:red;">your-access-key</mark> |
| Content-Type | application/json;ty=4                           |
| Accept       | application/json                                |

{% hint style="info" %}
Sesuaikan <mark style="color:red;">your-access-key</mark> dengan access key akun Antares anda.
{% endhint %}

Hasilnya seperti pada gambar berikut.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/lAUvuZz5DBBiIPnljkVp/POSTMAN%201.png" alt=""><figcaption><p>Gambar setting end-point dan header pada software POSTMAN.</p></figcaption></figure>

Selanjutnya anda perlu menginput request body untuk dengan mengikuti format berikut.

#### Request Body

{% tabs %}
{% tab title="Default Downlink Port" %}

```json
{
      "m2m:cin": {
        "con": "{\"type\":\"downlink\", \"data\":\"your-downlink-data\"}"
    }
}
```

{% hint style="info" %}
Default Downlink Port yaitu port 10.&#x20;
{% endhint %}
{% endtab %}

{% tab title="Custom  Downlink Port" %}

```json
{
      "m2m:cin": {
        "con": "{\"type\":\"downlink\", \"data\":\"your-downlink-data\", \"fport\":5}"
    }
}
```

{% hint style="info" %}
Jika anda menggunakan Custom Downlink Port maka isi field `"fport"`dengan angka integer selain 0.&#x20;
{% endhint %}
{% endtab %}
{% endtabs %}

Pada software POSTMAN pilih tab **Body** kemudian pilih **raw** dan masukan payload sesuai request body yang ingin digunakan seperti gambar berikut.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/PptqqlVreh623qITSgs6/POSTMAN2.png" alt=""><figcaption><p>Gambar isi payload request body pada software POSTMAN.</p></figcaption></figure>

{% hint style="info" %}
Sesuaikan isi field **`"data"`** sesuai dengan perintah downlink yang ingin anda kirimkan.
{% endhint %}

### 7. Mengirim Pesan Downlink

Setelah setup software POSTMAN selesai, saatnya mengirimkan perintah downlink. Pada field `"data"` diisi dengan string **"hello world"** sebagai pesan yang akan dikirim melalui lorawan downlink. Jika sudah selesai mengisi field `"data"` selanjutnya tekan tombol **Send** pada software POSTMAN.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/vRKnsJCzam6rt7wC7NkN/15_postman_data.png" alt=""><figcaption><p>Gambar isi payload request body pada software POSTMAN.</p></figcaption></figure>

Jika request HTTP melalui software POSTMAN berhasil, pada bagian response software POSTMAN akan muncul pesan seperti gambar berikut.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/MjcNeIu7E1cw192Xcwwg/16_postman_response.png" alt=""><figcaption><p>Gambar response hit API downlink pada software POSTMAN.</p></figcaption></figure>

### 8. Periksa Data di Antares&#x20;

Setelah langkah mengirim pesan downlink pada software POSTMAN berhasil, selanjutnya buka halaman device antares kemudian lihat apakah perintah downlink sudah masuk di Antares.&#x20;

<figure><img src="https://3995702122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRkxjRLeqOm0pNhLfsus%2Fuploads%2FPpGKZZOStJo8M4fxDfy2%2F153.png?alt=media&#x26;token=197809ca-fd50-435f-8312-2f7a2b383240" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3995702122-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FrRkxjRLeqOm0pNhLfsus%2Fuploads%2FobNktOmD8QQR0MyZqeHd%2F156.png?alt=media&#x26;token=31b41082-cf5b-425e-9eb5-298dff349326" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Data yang dikirimkan dari **POSTMAN** berupa **`"type": "downlink"`**` ``dan` **`"data".`**  pesan downlink yang diteruskan ke **Development Board Lynx-32** ada didalam field **`"data".`**&#x20;
{% endhint %}

### 9. Melihat Pesan Downlink

Pesan downlink yang diteruskan dari Antares ke **Development Board Lynx-32** dapat dilihat pada Serial Monitor terlihat seperti gambar berikut.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/mC4yR5mJvooJuwsUY8Jo/18_downlink_serial_monitor.png" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Class A" %}
{% hint style="info" %}
Pada LoRaWAN Class A, pesan downlink akan diterima oleh **Lynx-32** setelah **Lynx-32** melakukan uplink.
{% endhint %}
{% endtab %}

{% tab title="Class C" %}
{% hint style="info" %}
Pada LoRaWAN Class C, pesan downlink akan diterima oleh **Lynx-32** kapan saja.
{% endhint %}
{% endtab %}
{% endtabs %}

Pesan downlink yang diterima juga ditampilkan pada OLED terlihat seperti gambar berikut.

<figure><img src="https://content.gitbook.com/content/rRkxjRLeqOm0pNhLfsus/blobs/y23kmcR70zUeIw3WcL2o/17_Hasil%20Tampilan%20Oled.jpeg" alt=""><figcaption><p>Gambar pesan downlink yang ditampilkan pada display OLED.</p></figcaption></figure>