Menghubungkan Arduino MKR GSM 1400 ke Google Cloud IoT Core dengan Aman: Panduan Langkah demi Langkah
Komponen dan Perlengkapan
Arduino MKR GSM 1400 – 1 unit
Kabel Micro-USB ke USB (umum) – 1 unit
Baterai Lipo 3.7V – 1 unit
Kartu Micro SIM – 1 unit
Antena Seluler U.F.L – 1 unit
Aplikasi dan Layanan Online
Arduino IDE
Google Cloud IoT Core
Tentang Proyek Ini
Catatan: Tutorial ini mungkin sudah ketinggalan zaman. Silakan kunjungi disini untuk versi yang lebih terbaru.
Pendahuluan
Perangkat dapat terhubung ke GCP IoT Core menggunakan HTTP atau MQTT. Tutorial ini akan memandu Anda dalam menghubungkan papan Arduino MKR GSM 1400 secara aman ke GCP IoT Core menggunakan klien MQTT. MQTT (Message Queuing Telemetry Transport) adalah protokol konektivitas M2M (machine-to-machine) yang menyediakan transportasi pesan berlangganan dan publikasi.
Perangkat harus menggunakan JSON Web Tokens (JWT) untuk autentikasi. Informasi lebih lanjut tentang JWT dapat ditemukan dalam RFC 7519. GCP IoT Core mendukung algoritma RSA dan Elliptic Curve untuk memverifikasi JSON Web Signatures (JWS). Informasi lebih lanjut tentang JWS dapat ditemukan dalam RFC 7515.
Setiap papan Arduino MKR dengan konektivitas bawaan, termasuk MKR GSM 1400, dilengkapi dengan elemen kripto Microchip ATECC508A atau ATECC608A. Elemen kripto ini dapat digunakan untuk menghasilkan dan menyimpan kunci ECC (Elliptic Curve Cryptography) 256-bit dengan aman. Kami akan menggunakan kunci pribadi yang disimpan di dalam elemen kripto untuk menandatangani JWT.
Pengaturan Perangkat Lunak dan Perangkat Keras
Jika Arduino IDE belum terinstal di komputer Anda, unduh dan instal terlebih dahulu.
Setelah terinstal, pastikan Anda telah menginstal paket "Arduino SAMD Boards" terbaru. Anda dapat memeriksa dengan membuka Arduino IDE, lalu membuka menu Tools → Board: "..." → Board Manager... dan mencari "Arduino SAMD". Saat tulisan ini dibuat, versi 1.6.20 adalah versi terbaru.
Selanjutnya, Anda perlu menginstal pustaka Arduino yang akan digunakan melalui Library Manager Arduino IDE. Buka menu Sketch → Include Library → Manage Libraries..., cari dan instal masing-masing pustaka berikut:
MKRGSM
Arduino_JSON
ArduinoECCX08 (versi 1.3.0 atau lebih baru)
ArduinoMqttClient (versi 0.1.3 atau lebih baru)
Arduino Cloud Provider Examples (versi 1.2.0 atau lebih baru)
Masukkan kartu micro SIM ke dalam slot di bagian bawah papan MKR GSM 1400, sambungkan antena, dan pasang baterai Lipo 3.7V ke konektor JST. Kemudian colokkan MKR GSM 1400 dengan kabel micro USB ke komputer Anda, pilih port serial di Arduino IDE melalui menu Tools → Port "...", dan pilih Arduino MKR GSM 1400 di menu Tools → Board "...".
Mengonfigurasi dan Menambahkan Papan ke GCP IoT Core
Seperti yang disebutkan di atas, GCP IoT Core mengharuskan perangkat yang terhubung menggunakan protokol MQTT untuk menggunakan JWT untuk autentikasi. Kami akan menggunakan sketch untuk menghasilkan kunci pribadi dan publik di papan, lalu menambahkan nilai PEM dari kunci publik ke konsol GCP IoT Core.
Kunci pribadi dan publik dapat dihasilkan menggunakan sketch contoh dari pustaka ArduinoECCX08. Buka sketch di Arduino IDE melalui File → Examples → ArduinoECCX08 → Tools → ECCX08JWSPublicKey. Klik tombol "Upload" untuk membangun dan mengunggah sketch ke papan Anda, lalu buka Serial Monitor. Pastikan konfigurasi akhir baris diatur ke "Both NL & CR."
Sketch ini akan meminta Anda untuk mengonfigurasi secara permanen ATECC508A Anda menjadi elemen kripto ECC608A jika belum dikonfigurasi dan dikunci. CATATAN: Proses penguncian ini permanen dan tidak dapat dibalik, tetapi diperlukan untuk menggunakan elemen kripto - konfigurasi yang diatur oleh sketch memungkinkan Anda menggunakan 5 slot kunci pribadi dengan penyedia cloud (atau server) apa pun, dan kunci pribadi dapat dihasilkan ulang kapan saja untuk salah satu dari 5 slot kunci pribadi (0 - 4). Ketika papan dikirim dari pabrik, elemen kripto berada dalam keadaan yang belum dikonfigurasi dan tidak dikunci.
Setelah ini, Anda akan diminta untuk memilih slot yang akan digunakan. Untuk tutorial ini, kami akan menggunakan slot 0 untuk menghasilkan dan menyimpan kunci pribadi yang digunakan untuk kunci publik (slot 1 hingga 4 dapat digunakan untuk menghasilkan dan menyimpan kunci pribadi tambahan jika diperlukan). Catatan: Karena kunci pribadi dihasilkan di dalam elemen kripto, itu tidak pernah keluar dari perangkat dan disimpan dengan aman serta tidak dapat dibaca.
Salin nilai kunci publik yang dihasilkan. Dalam tangkapan layar ini, nilainya adalah:
-----BEGIN PUBLIC KEY----- MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEFl4+DXufU84AhDGib7aMwmYwUVAp9coRdC9jOdzR e2kqGWFEb+QP4V4YUK9Zy7PsmRABi1sWgxiAoEhg1FEQgg== -----END PUBLIC KEY-----
Kami akan menggunakannya pada langkah selanjutnya saat menambahkan perangkat ke GCP IoT Core.
Sekarang setelah kita memiliki kunci publik PEM, kita perlu masuk ke konsol GCP IoT Core dan membuat perangkat baru untuknya.
1) Buka browser web dan buka https://cloud.google.com/ lalu klik tautan "Sign In" untuk masuk dengan ID Google Anda.
2) Setelah masuk, klik tombol "GO TO CONSOLE". Kemudian Anda akan melihat dasbor utama.
3) Klik tautan "CREATE" untuk membuat proyek baru.
4) Anda akan diminta untuk nama proyek. Kami akan menggunakan "MKR GCP Tutorial" sebagai nama. Klik tombol "CREATE" untuk melanjutkan.
5) Setelah proyek dibuat, Anda akan melihat tampilan dasbor proyek tersebut.
6) Sekarang klik ikon menu di pojok kiri atas, gulir ke judul "BIG DATA" dan klik tautan "IoT Core".
7) Anda akan diminta untuk mengaktifkan API. Klik tombol "Enable API".
8) Setelah API diaktifkan, Anda akan diminta untuk membuat register perangkat. Klik tombol "Create a device registry" untuk melanjutkan.
9) Kemudian Anda akan melihat formulir. Isi "Registry ID", pilih wilayah. Dalam tangkapan layar di bawah, "MKR_GCP_Tutorial" dimasukkan untuk registry ID dan "us-central1" dipilih sebagai wilayah. Setelah formulir diisi, klik tombol "Create".
10) Anda akan melihat detail register.
11) Untuk menambahkan perangkat baru, klik tautan "Devices" pada bilah navigasi di sisi kiri.
12) Kemudian klik "+ CREATE A DEVICE" pada judul di bagian atas halaman.
13) Masukkan nama perangkat. Dalam tangkapan layar di bawah, "MyMKRGSM1400" digunakan. "ES256" harus dipilih sebagai "Public key format". Tempelkan nilai kunci publik PEM yang dihasilkan di papan sebelumnya ke dalam area teks "Public key value". Kemudian klik tombol "Create".
Menghubungkan Papan ke GCP IoT Core
1) Buka sketch GCP IoT Core GSM di Arduino IDE menggunakan File → Examples → Arduino Cloud Provider Examples → GoogleCloudPlatformIoTCore→ GCP_IoT_Core_GSM.
2) Di tab arduino_secrets.h, isi pin (jika diperlukan) untuk kartu SIM, serta GPRS APN, nama pengguna dan sandi untuk operator seluler yang Anda gunakan.
// GSM settings #define SECRET_PINNUMBER "" #define SECRET_GPRS_APN "GPRS_APN" // ganti dengan GPRS APN Anda #define SECRET_GPRS_LOGIN "login" // ganti dengan login GPRS Anda #define SECRET_GPRS_PASSWORD "password" // ganti dengan sandi GPRS Anda
4) Kemudian perbarui nilai project id, cloud region, registry id dan device id.
// Isi informasi Google Cloud Platform - IoT Core Anda #define SECRET_PROJECT_ID "" #define SECRET_CLOUD_REGION "" #define SECRET_REGISTRY_ID "" #define SECRET_DEVICE_ID ""
Nilai project id dapat ditemukan dengan mengeklik bilah menu di bagian atas konsol GCP. Untuk langkah di atas, nilainya adalah:
5) Unggah sketch ke papan Anda dan buka serial monitor. Papan akan mencoba terhubung ke jaringan seluler dan jika berhasil akan mencoba terhubung ke GCP IoT Core menggunakan MQTT.
Berinteraksi dengan Papan di GCP IoT Core
Sekarang papan Anda telah berhasil terhubung ke GCP IoT Core, kita dapat menggunakan konsol GCP IoT Core untuk berinteraksi dengannya. Sketch mengirim pesan ke topik /devices/{deviceId}/state setiap 5 detik dan mendengarkan pesan pada topik /devices/{deviceId}/config dan /devices/{deviceId}/commands/#.
Di halaman perangkat di konsol GCP IoT Core, klik tombol "SEND COMMAND".
Sebuah dialog modal akan muncul, tempat Anda dapat memasukkan pesan untuk dikirim. Dalam tangkapan layar di bawah, "Hello There!" dimasukkan. Klik tombol "SEND COMMAND" untuk mengirim pesan.
Setelah papan menerima pesan, itu akan mencetaknya di Serial Monitor.
Untuk melihat pesan yang dikirim papan, klik tab "Configuration & state history".
Pesan akan muncul dalam format terenkode Base64. Untuk melihat nilainya, klik entri dalam daftar dan pilih tombol radio "Text".
Dalam tangkapan layar di atas, papan sedang mengirim nilai "hello 464488", nilai 464488 adalah hasil dari fungsi millis() di papan.
Kesimpulan
Dalam tutorial ini, kami membahas cara menggunakan papan Arduino MKR GSM 1400 dengan aman bersama GCP IoT Core. JWT yang ditandatangani digunakan untuk mengautentikasi ke GCP IoT Core menggunakan protokol MQTT dengan ATECC508A atau ATECC608A menyimpan kunci pribadi yang digunakan untuk menandatangani JWT. Pesan MQTT dikirim ke dan dari papan.
Ini hanyalah awal, Anda dapat menggunakan GCP IoT Core dengan banyak layanan lain yang disediakan GCP!