Arduino Nano 33 IoT: Sensor Air Multi-Parameter (EC, pH, ORP) dengan BLE & PWA
Komponen dan Perlengkapan
Arduino Nano 33 IoT
×
1
Antarmuka Probe EC Terisolasi Microfire LLC
×
1
Antarmuka Probe ISE Terisolasi Microfire LLC
×
2
Tentang Proyek Ini
Apa yang akan kita buat?
Sebuah perangkat untuk mengukur EC, pH, ORP, dan suhu. Perangkat ini dapat digunakan untuk memantau kolam renang atau sistem hidroponik. Komunikasi dilakukan melalui Bluetooth Low Energy, dan informasi ditampilkan di halaman web menggunakan Web Bluetooth. Sebagai tambahan menarik, kita akan mengubahnya menjadi Progressive Web App yang dapat diinstal langsung dari web.
Semua komponen dapat diperoleh di ufire.co.
Apa itu semua istilah tersebut?
EC/pH/ORP/suhu adalah beberapa pengukuran kualitas air yang paling umum. Konduktivitas listrik (EC) digunakan dalam hidroponik untuk mengukur larutan nutrisi, pH untuk mengetahui seberapa asam atau basa air, dan ORP digunakan untuk menentukan kemampuan air dalam membersihkan dirinya sendiri.
Bluetooth Low Energy adalah protokol nirkabel untuk mengirim dan menerima informasi dengan mudah. Papan Arduino yang digunakan dalam proyek ini adalah Nano 33 IoT, yang dilengkapi dengan antarmuka WiFi dan BLE.
Web Bluetooth adalah serangkaian API yang diimplementasikan di browser Chrome Google (dan Opera) yang memungkinkan halaman web berkomunikasi langsung dengan perangkat BLE.
Progressive Web Apps pada dasarnya adalah halaman web yang bertindak seperti aplikasi reguler. Android dan iPhone menangani mereka secara berbeda, dan mereka berbeda di desktop, jadi Anda perlu membaca lebih lanjut untuk detail spesifik.
Hardware
Sebelum merakit hardware, ada satu hal yang perlu diatasi. Perangkat sensor ISE uFire datang dengan alamat I2C yang sama dan kita menggunakan dua, jadi salah satu harus diubah. Untuk proyek ini, kita akan memilih salah satu papan ISE dan menggunakannya untuk mengukur ORP. Ikuti langkah-langkah di sini, ubah alamat menjadi 0x3e.
Setelah alamat diubah, memasang hardware menjadi mudah. Semua perangkat sensor menggunakan sistem koneksi Qwiic, jadi cukup hubungkan semuanya secara berantai. Anda akan membutuhkan satu kabel Qwiic ke Male untuk menghubungkan salah satu sensor ke Nano 33. Kabel-kabel tersebut konsisten dan berwarna. Sambungkan hitam ke GND Nano, merah ke pin +3.3V atau +5V, biru ke pin SDA yang merupakan A4, dan kuning ke pin SCL pada A5.
Untuk proyek ini, sistem akan mengharapkan informasi suhu datang dari sensor EC, jadi pastikan untuk memasang sensor suhu pada papan EC. Semua papan memiliki kemampuan untuk mengukur suhu. Jangan lupa untuk memasang sonde EC, pH, dan ORP ke sensor yang sesuai. Mereka dapat dipasang dengan mudah menggunakan konektor BNC.
Jika Anda memiliki kotak pelindung, memasang semuanya di dalamnya akan menjadi ide yang baik, terutama mengingat air akan terlibat.
Software
Bagian perangkat lunak dari proyek ini terbagi menjadi dua bagian utama: firmware pada Nano 33, dan halaman web.
Alur dasarnya adalah sebagai berikut:
Halaman web terhubung ke Nano melalui BLE
Halaman web mengirim perintah berbasis teks untuk meminta informasi atau melakukan tindakan
Nano mendengarkan perintah tersebut, mengeksekusinya, dan mengembalikan informasi
Halaman web menerima respons dan memperbarui antarmuka pengguna sesuai dengan itu
Pengaturan ini memungkinkan halaman web untuk melakukan semua fungsi yang Anda harapkan, seperti mengambil pengukuran atau mengkalibrasi sensor.
Layanan dan Karakteristik BLE
Salah satu hal pertama yang perlu dipelajari adalah dasar-dasar cara kerja BLE.
Ada banyak analogi, jadi mari kita pilih sebuah buku. Sebuah layanan adalah sebuah buku, dan sebuah karakteristik adalah halaman. Dalam "buku BLE" ini, halaman-halaman memiliki beberapa properti non-buku seperti mampu mengubah apa yang dikatakan halaman dan menerima pemberitahuan saat terjadi.
Sebuah perangkat BLE dapat membuat sebanyak layanan yang diinginkan. Beberapa telah ditetapkan dan bertindak sebagai cara untuk menstandardisasi informasi yang umum digunakan seperti Tx Power atau kehilangan koneksi, hingga hal-hal yang lebih spesifik seperti Insulin atau Pulse Oximetry. Anda juga dapat membuat satu dan melakukan apa pun yang Anda inginkan dengannya. Mereka ditetapkan dalam perangkat lunak dan diidentifikasi dengan UUID. Anda dapat membuat UUID di sini, atau sebagai alternatif open-source, coba UUIDTools.com.
Dalam firmware untuk perangkat ini, ada satu layanan, didefinisikan sebagai:
tx_Characteristic adalah tempat perangkat mengirim informasi, seperti pengukuran EC, untuk ditampilkan di halaman web. rx_Characteristic adalah tempat perangkat menerima perintah dari halaman web untuk dieksekusi.
Proyek ini menggunakan library ArduinoBLE. Jika Anda perhatikan, Anda akan melihat ada beberapa cara berbeda untuk mendeklarasikan karakteristik. Proyek ini menggunakan BLEStringCharacteristic karena kita akan berurusan dengan tipe String dan itu lebih mudah, tetapi Anda juga dapat memilih BLECharCharacteristic atau BLEByteCharacteristic di antara beberapa lainnya.
Selain itu, ada beberapa properti yang dapat Anda berikan pada karakteristik. tx_Characteristic memiliki BLENotify sebagai opsi. Artinya halaman web kita akan menerima pemberitahuan ketika nilainya berubah. rx_Characteristic memiliki BLEWrite yang akan memungkinkan halaman web kita untuk memodifikasinya. Ada yang lain.
Kemudian ada sedikit kode-pengikat untuk menyatukan semuanya:
Itulah tempat Anda mengambil keuntungan dari diberi tahu ketika nilai berubah. Baris ini memberi tahu kelas untuk mengeksekusi fungsi rxCallback ketika nilai berubah.
BLE.advertise(); adalah apa yang memulai segalanya. Sebuah perangkat BLE secara berkala mengirim paket kecil informasi yang mengumumkan bahwa ia di luar sana dan tersedia untuk terhubung. Tanpa itu, ia akan tidak terlihat.
Perintah Teks
Seperti yang disebutkan sebelumnya, perangkat ini akan berkomunikasi dengan halaman web melalui perintah teks sederhana. Seluruhnya mudah diimplementasikan karena pekerjaan keras telah selesai. Sensor uFire datang dengan library berbasis JSON dan MsgPack untuk mengirim dan menerima perintah. Anda dapat membaca lebih lanjut tentang perintah EC dan ISE di halaman dokumentasi mereka.
Proyek ini akan menggunakan JSON karena sedikit lebih mudah untuk digunakan dan dapat dibaca, berbeda dengan format MsgPack yang biner.
Berikut adalah contoh bagaimana semuanya terkait:
Halaman web meminta pengukuran EC dari perangkat dengan mengirim ec (atau lebih spesifiknya menulis ec ke karakteristik rx_Characteristic)
Perangkat menerima perintah dan mengeksekusinya. Kemudian mengirim kembali respons berformat JSON {"ec":1.24} dengan menulis ke karakteristik tx_Characteristic.
Halaman web menerima informasi dan menampilkannya
Halaman Web
Halaman web untuk proyek ini akan menggunakan Vue.js untuk front-end. Tidak perlu backend. Selain itu, untuk menjaga sederhana, tidak ada sistem build yang digunakan. Dibagi menjadi folder-folder biasa, js untuk javascript, css untuk CSS, assets untuk ikon.
Bagian html-nya tidak spesial. Menggunakan bulma.io untuk styling dan membuat antarmuka pengguna. Anda akan melihat banyak di bagian <head>. Ini menambahkan semua css dan ikon, tetapi juga menambahkan satu baris khusus.
<link rel="manifest" href="manifest.json">
Itu memuat file manifest.json kita yang membuat semua halaman PWA terjadi. Ini mendeklarasikan beberapa informasi yang memberi tahu ponsel kita bahwa halaman web ini dapat diubah menjadi aplikasi.
Javascript adalah tempat sebagian besar hal menarik terjadi. Dibagi menjadi file, app.js berisi dasar-dasar untuk menjalankan halaman Vue bersama dengan semua variabel terkait UI dan beberapa hal lain. ble.js memiliki bagian bluetooth.
Javascript dan Web Bluetooth
Pertama, ini hanya berfungsi di Chrome dan Opera. Saya harap browser lain mendukung ini, tetapi karena alasan apa pun, mereka tidak.
Lihat app.js dan Anda akan melihat UUID yang sama yang kita gunakan dalam firmware kita. Satu untuk Layanan uFire, dan satu masing-masing untuk karakteristik tx dan rx.
Jika Anda lihat di ble.js, Anda akan melihat fungsi connect() dan disconnect().
Fungsi connect() berisi beberapa logika untuk menjaga UI sinkron, tetapi sebagian besar untuk menyiapkan pengiriman dan penerimaan informasi pada karakteristik.
Ada beberapa keunikannya saat berurusan dengan Web Bluetooth. Koneksi harus dimulai oleh interaksi fisik pengguna, seperti mengetuk tombol. Anda tidak dapat terhubung secara terprogram saat halaman web dimuat, misalnya.
Bagian filters: dan optionalServices diperlukan untuk menghindari melihat setiap perangkat BLE di luar sana. Anda mungkin pikir bagian filter saja sudah cukup, tetapi Anda juga membutuhkan bagian optionalServices.
Kode di atas akan menampilkan dialog koneksi. Ini adalah bagian dari antarmuka Chrome dan tidak dapat diubah. Pengguna akan memilih dari daftar. Bahkan jika hanya satu perangkat yang akan dihubungkan aplikasi, pengguna masih perlu melewati dialog pemilihan ini, karena alasan keamanan.
Sisa kode adalah menyiapkan layanan dan karakteristik. Perhatikan bahwa kita menyiapkan rutinitas callback, mirip dengan callback pemberitahuan firmware:
this.value_update sekarang akan dipanggil setiap kali ada informasi baru pada karakteristik tx.
Salah satu hal terakhir yang dilakukan adalah mengatur timer untuk memperbarui informasi setiap 5 detik.
value_update() hanyalah fungsi panjang yang menunggu informasi JSON baru masuk dan memperbarui UI dengannya.
ec.js, ph.js, dan orp.js berisi banyak fungsi kecil yang mengirim perintah untuk mengambil informasi dan mengkalibrasi perangkat.
Untuk mencoba ini, Anda perlu ingat bahwa untuk menggunakan Web Bluetooth, harus disajikan melalui HTTPS. Salah satu banyak opsi untuk server HTTPS lokal adalah serve-https. Dengan firmware yang diunggah, semuanya terhubung, dan halaman web disajikan, Anda seharusnya dapat melihat semuanya berfungsi.
Bagian PWA
Ada beberapa langkah untuk mengubah halaman web menjadi aplikasi sebenarnya. Progressive Web Apps dapat melakukan lebih banyak daripada yang digunakan dalam proyek ini.
Penginstalan halaman web
Setelah diinstal, akses offline memungkinkan
Dimulai dan berjalan sebagai aplikasi reguler dengan ikon aplikasi yang terlihat biasa
Untuk memulai, kita akan perlu menghasilkan sejumlah file. Pertama adalah file manifest.json. Ada beberapa situs yang akan melakukan ini untuk Anda, App Manifest Generator, salah satunya.
Beberapa hal yang perlu dipahami:
Lingkup aplikasi penting. Jika Anda meletakkan halaman web ini di ufire.co/uFire-BLE/. Artinya lingkup aplikasi saya adalah /uFire-BLE/.
URL Awal juga penting. Ini adalah jalur ke halaman web tertentu Anda dengan domain dasar sudah diasumsikan.
Mode Tampilan akan menentukan tampilan aplikasi, Standalone akan membuatnya terlihat seperti aplikasi reguler tanpa tombol atau antarmuka Chrome.
Akhirnya Anda akan memiliki file json. Harus diletakkan di root halaman web, berdampingan dengan index.html.
Hal selanjutnya yang Anda butuhkan adalah Service Worker. Lagi, mereka dapat melakukan banyak, tetapi proyek ini hanya akan menggunakan caching untuk memungkinkan aplikasi ini diakses secara offline. Implementasi service worker sebagian besar boilerplate. Proyek ini menggunakan contoh Google dan mengubah daftar file yang akan di-cache. Anda tidak dapat cache file di luar domain Anda.
Pergi ke FavIcon Generator dan buat beberapa ikon.
Hal terakhir adalah menambahkan beberapa kode di fungsi Vue mounted().
mounted: function () {
if ('serviceWorker' in navigator) {
navigator.serviceWorker.register('service-worker.js');
}
},
Ini akan mendaftarkan worker dengan browser.
Anda dapat memeriksa apakah semuanya berfungsi, dan jika tidak, mungkin mencari tahu mengapa dengan menggunakan Lighthouse, itu akan menganalisis situs dan memberi tahu Anda segala macam hal.
Jika semuanya berfungsi, saat Anda pergi ke halaman web, Chrome akan bertanya apakah Anda ingin menginstalnya dengan banner popup.