Mengirim Data Sederhana ke Antares
Last updated
Last updated
Pada project ini Anda akan diarahkan untuk mengirim data sederhana dari board NB-LYNX-7000 ke Antares IoT Platform menggunakan serangkaian AT Command dari modul SIM7000.
Material yang dibutuhkan mengikuti Prasyarat Umum pada laman sebelumnya. Jika Anda belum menyiapkan kebutuhan pada laman tersebut, maka Anda dapat mengunjungi laman berikut.
Hal yang perlu Anda lakukan pertama kali adalah melakukan setup peralatan dengan cara menghubungkan board NB-LYNX-7000 ke perangkat laptop/komputer Anda menggunakan kabel USB-C.
Pastikan Anda telah memasang antena pada port antena GSM sebelum menghubungkan board NB-LYNX-7000 ke laptop/komputer.
Berikut adalah rangkaian peralatan yang sudah dihubungkan ke laptop/komputer.
Untuk mengirim data ke Antares, Anda perlu menginputkan kode program di bawah pada Arduino IDE.
Jangan lupa untuk menggganti APPNAME dengan nama aplikasi yang Anda buat di platform Antares, DEVNAME dengan nama device yang dibuat pada platform Antares, dan ACCESSKEY dengan access-key akun Anda.
Setelah menginputkan kode program, jangan lupa untuk menyimpan kode program tersebut dengan memilih File > Save As. Berikut adalah tampilan pada Arduino IDE ketika Anda sudah menginputkan kodenya.
Supaya board NB-LYNX-7000 dapat berkomunikasi dengan platform Antares, digunakan modul SIM7000. SIM7000 merupakan modul komunikasi seluler yang dikembangkan oleh SIMCom Wireless Solutions. Modul ini menerapkan beberapa protokol yang memungkinkan perangkat untuk terhubung ke jaringan menggunakan AT command. Berikut dijelaskan beberapa AT command yang digunakan pada kode program.
Pada kode program terdapat command "AT\r\n" yang dikirimkan sebagai starting point atau tahap inisialisasi modul SIM7000. \r merupakan carriage return , sedangkan \n merupakan line feed. Command ini dikirimkan untuk mendapatkan respons “OK”.
Pada kode program terdapat command "ATE0\r\n" yang dikirimkan setelah mendapatkan respons “OK”. Command ini digunakan untuk menonaktifkan echo mode yang menandakan bahwa inisialisasi telah berhasil.
Pada kode program terdapat command "AT+CNMP=38\r\n" yang dikirimkan untuk memilih mode yang diinginkan. Parameter “38” diatur supaya modul SM7000 hanya bekerja pada jaringan LTE saja, yang mana umum digunakan untuk NB-IoT.
Berikut parameter <mode> lain yang dapat digunakan
2 = Automatic
13 = GSM only
38 = LTE only
51 = GSM and LTE only
Pada kode program terdapat command "AT+CMNB=2\r\n" yang digunakan untuk memilih mode antara CAT-M dan NB-IoT. Parameter “2” digunakan untuk memilih NB-IoT.
Berikut terdapat parameter <mode> lain yang tersedia
1 = CAT-M
2 = NB-IoT
3 = CAT-M dan NB-IoT
Pada kode program terdapat command "AT+CIPSHUT\r\n" yang dikirimkan sebagai case 0 untuk mematikan PDP (packet data protocol) context. PDP context merupakan protokol pada komunikasi seluler yang digunakan untuk mengatur data session antara perangkat dengan jaringan. Command "AT+CIPSHUT\r\n" digunakan untuk memastikan bahwa semua koneksi internet yang aktif telah dimatikan semuanya sebelum dilanjutkan dengan konfigurasi yang lain. Respons yang akan diterima ketika mengirimkan command ini adalah “SHUT OK”.
Pada kode program terdapat command "AT+CSTT=""+ String(APN) + ""\r\n" yang dikirimkan sebagai case 1 untuk mengatur APN (Access Point Name) pada modul SM7000 sebagai koneksi GPRS (General Packet Radio Service). String(APN) digunakan untuk mengubah variabel yang sudah didefinisikan pada bagian awal kode menggunakan #define APN "nb1internet" menjadi string. Oleh karena itu, APN yang diatur dalam hal ini akan memiliki value “nb1internet”.
Pada kode program terdapat command "AT+CIICR\r\n" yang dikirimkan sebagai case 2 untuk mengaktifkan koneksi wireless berupa IP connection. IP connection ini digunakan sebagai transmisi data.
Pada kode program terdapat command "AT+CIFSR\r\n" yang dikirimkan sebagai case default untuk mendapatkan IP address ketika case sebelumnya (case 0, case 1, dan case 2) tidak ada yang match. Command ini digunakan untuk memastikan bahwa IP address berhasil didapatkan yang ditandai dengan response berupa IP address. Apabila proses ini gagal, maka respons yang diterima adalah ERROR.
Pada kode program terdapat command "AT+CIPSTATUS\r\n" yang digunakan untuk menanyakan status koneksi saat ini.
Pada kode program terdapat command "AT+CIPSTART="TCP","platform.antares.id","8080"\r\n" yang digunakan untuk memulai TCP connection pada suatu host dan port. Dalam hal ini host yang digunakan adalah platform.antares.id dengan port 8080. Anda juga dapat mengganti nama host dengan IP address.
Pada kode program terdapat command “AT+CIPSEND\r\n" yang mengindikasikan bahwa modul SIM7000 telah siap untuk mengirimkan data melalui TCP connection yang sudah dibentuk.
Anda harus mengatur board yang digunakan dengan memilih ESP32 Dev Module pada bagian Tools > Board > esp32.
Setelah itu, Anda perlu mengatur port yang digunakan dengan membuka Tools > Port > COM(X). Nilai X menyesuaikan dengan nomor port yang digunakan oleh board NB-LYNX-7000.
Setelah Anda mempersiapkan kode program, selanjutnya Anda dapat meng-upload kode program tersebut dengan menekan tombol upload seperti ditunjukkan pada gambar di bawah.
Jika kode program sudah berhasil di-upload, Anda dapat membuka Serial Monitor dengan menekan icon seperti ditunjukkan pada gambar di bawah. Icon tersebut dapat Anda temukan pada bagian atas sebelah kanan.
Anda perlu mengatur baud rate Serial Monitor menjadi 115200 supaya output-nya dapat terbaca.
Tampilan Serial Monitor akan menjadi seperti pada gambar di bawah yang menandakan proses inisiasi modul SIM7000.
Setelah berhasil mengirimkan data sebanyak 10 kali, maka program akan berhenti seperti ditunjukkan pada gambar berikut.
Untuk memastikan bahwa data telah terkirim dengan benar dari board NB-LYNX-7000 ke Antares IoT Platform, Anda dapat membuka URL device Anda. Gambar berikut menunjukkan tampilan pada Antares IoT Platform yang sudah menerima data dari NB-LYNX-7000.