Editor

Bluetooth, tersimulasi

Pasangkan HP dengan ESP32 atau HC-05 milikmu dan bicara dengannya. HP itu adalah panel Bluetooth di Mokxi, bukan radio sungguhan.

Bluetooth tersimulasi: sebuah HP di Mokxi, bukan radio sungguhan. Tidak ada apa pun di Mokxi yang memancarkan apa pun, dan tidak ada HP sungguhan yang bisa melihat board di sini. Yang akurat adalah kode Arduino yang kamu tulis: contoh Bluetooth bawaan ESP32 core berjalan tanpa perubahan, dan panel melakukan apa yang dilakukan aplikasi HP yang dipakai tutorial-tutorial itu.

Di mana HP-nya

Tekan Jalankan, lalu buka tab Bluetooth di sebelah Serial (di HP ada di bawah More). Panel ini mencantumkan semua perangkat yang bisa dilihat HP:

  • ESP32 yang menjalankan BluetoothSerial (Bluetooth Classic, hanya ESP32 klasik),
  • ESP32 yang mengiklankan lewat Bluetooth LE (ESP32, ESP32-S3, C3 dan C6 dengan sketch Arduino, serta ESP32-C3 dan C6 dengan MicroPython),
  • setiap modul HC-05 dan HC-06 di rangkaian, di board mana pun.

Pilih satu, pasangkan, sambungkan, dan sisi kanan panel menjadi aplikasinya.

Bluetooth serial: SerialBT milik ESP32

Sketch tutorial berjalan apa adanya:

#include "BluetoothSerial.h"
BluetoothSerial SerialBT;
void setup() { Serial.begin(115200); SerialBT.begin("ESP32test"); }
void loop() {
  if (Serial.available()) SerialBT.write(Serial.read());
  if (SerialBT.available()) Serial.write(SerialBT.read());
}

ESP32test muncul di panel. Tekan Pair, lalu Connect, dan panelnya jadi terminal seperti aplikasi "Serial Bluetooth Terminal": ketik satu baris dan kirim (dengan CR+LF, LF, CR atau tanpa apa pun di akhir), dan apa pun yang sketch tulis ke SerialBT muncul di bawahnya.

Apa yang dilihat sketch sama dengan apa yang dilihatnya di board sungguhan:

  • register_callback() menerima ESP_SPP_INIT_EVT dan ESP_SPP_START_EVT dari begin(), ESP_SPP_SRV_OPEN_EVT saat HP terhubung (beserta alamat HP-nya), ESP_SPP_DATA_IND_EVT untuk setiap baris yang dikirim, dan ESP_SPP_CLOSE_EVT saat terputus;
  • hasClient() dan connected() mengikuti koneksi, dan write() mengembalikan 0 saat tak ada yang terhubung;
  • available(), read(), peek(), readString() dan sisanya dari Stream membaca apa yang dikirim HP, dan onData() yang mengambilnya jika sudah disetel.

Pemasangan sesuai permintaan sketch-mu

  • Just works adalah bawaan: Pair langsung berhasil.
  • PIN: setelah SerialBT.disableSSP() dan SerialBT.setPin("1234"), panel meminta PIN dan PIN yang salah gagal, memanggil onAuthComplete(false).
  • Perbandingan angka: dengan SerialBT.enableSSP() dan onConfirmRequest(), panel menampilkan kode enam digit dan callback sketch menerima angka yang sama. Kedua sisi harus menyatakan setuju: tombol Pair di panel, dan confirmReply(true) di sketch. Lalu onAuthComplete(true) berjalan.
  • Dengan enableSSP(true, false) board mengetik kode yang ditampilkan panel (onKeyRequest(), lalu respondPasskey()); dengan enableSSP(false, true) board yang menampilkannya dan kamu mengetikkannya di panel.

Forget membatalkan pemasangan, seperti pengaturan HP.

Bluetooth LE: server BLE milik ESP32

Contoh BLE_server, BLE_notify dan BLE_uart dari ESP32 core berjalan tanpa perubahan. BLEDevice::startAdvertising() membuat board terlihat; panelnya lalu jadi pemindai seperti nRF Connect:

  • Connect, dan service serta characteristic yang dibuat sketch dicantumkan dengan UUID-nya, namanya jika HP mengenalnya (Nordic UART Service, Battery Level dan sebagainya) beserta propertinya;
  • Read menjalankan onRead() characteristic lebih dulu dan menampilkan nilainya sebagai teks dan heksadesimal;
  • Write mengirim teks atau heksadesimal, dan onWrite() di sketch berjalan dengannya;
  • Notify berlangganan, dan setiap notify() setelahnya muncul dengan nilainya. Sebelum kamu berlangganan, notify() tidak sampai ke siapa pun, seperti di HP sungguhan.

onConnect() dan onDisconnect() berjalan saat panel terhubung dan terputus. Board berhenti mengiklankan setelah terhubung, jadi hilang dari daftar setelah terputus sampai sketch memanggil startAdvertising() lagi. Itulah kenapa contoh-contohnya melakukannya di loop().

Bluetooth LE di MicroPython: ESP32-C3 dan C6

Di ESP32-C3 atau ESP32-C6 yang menjalankan MicroPython, modul bluetooth bekerja seperti di board sungguhan, karena software Bluetooth milik board sendiri yang berjalan: hanya bagian chip radio yang digantikan. Server GATT seperti yang ini muncul di panel:

import bluetooth
b = bluetooth.BLE()
b.active(True)
F = bluetooth.FLAG_READ | bluetooth.FLAG_WRITE | bluetooth.FLAG_NOTIFY
((h,),) = b.gatts_register_services(((bluetooth.UUID(0x180F), ((bluetooth.UUID(0x2A19), F),)),))
b.gatts_write(h, b'42')
b.gap_advertise(100000, bytes([2, 1, 6, 8, 9]) + b'mpy-ble')
  • Panel mencantumkan board dengan nama di data iklannya.
  • Connect, dan handler irq milikmu menerima _IRQ_CENTRAL_CONNECT (1). Panel lalu menemukan service seperti yang dilakukan aplikasi HP, jadi ia mencantumkan service Generic Access dan Generic Attribute milik board sebelum punyamu.
  • Read menampilkan apa yang disimpan gatts_write(), Write memicu _IRQ_GATTS_WRITE (3), dan setelah Notify, setiap gatts_notify() muncul.
  • aioble juga bisa: tambahkan folder aioble dari micropython-lib ke proyekmu, seperti menyalinnya ke board sungguhan.
  • gap_scan() berakhir tanpa menemukan apa pun, karena HP tidak mengiklankan, dan board tidak bisa terhubung ke HP sebagai central.

HC-05 dan HC-06 di board mana pun

Modulnya adalah jembatan serial: apa pun yang dikirim HP keluar dari TXD, dengan baud rate modul, bit demi bit, dan yang dikirim board ke RXD pergi ke HP. Di panel masing-masing dicantumkan dengan namanya. Pasangkan dengan PIN-nya (1234 sampai AT+PSWD atau AT+PIN mengubahnya), sambungkan, dan pakai terminal yang sama. Mengklik modul di kanvas juga menyambungkan atau memutuskan.

HC-05 mulai terhubung, jadi kotak serial monitor untuknya langsung bisa dipakai. HC-06 mulai tanpa koneksi apa pun, seperti yang baru keluar dari kantong, dan selama tak ada yang terhubung ia menjawab perintah AT. Panduan serial nirkabel memuat perintah AT kedua modul.

Apa yang asli dan apa yang tidak

Nyata, dalam arti berperilaku seperti board-mu kelak: panggilan dan tanda tangannya, urutan callback datang, pemasangan yang harus berhasil sebelum apa pun terhubung, PIN atau kode yang harus cocok, byte ke dua arah, tabel GATT, dan notifikasi hanya setelah HP berlangganan.

Tidak asli, dan tidak pernah dibuat-buat seolah asli:

  • tanpa radio. Tanpa 2.4 GHz, tanpa RFCOMM, tanpa kanal iklan, tanpa jangkauan, tanpa link key, tanpa enkripsi. PIN dibandingkan sebagai string.
  • tanpa jeda sendiri. Satu baris datang utuh, sekaligus; koneksi sungguhan butuh puluhan milidetik dan tidak stabil. Callback berjalan setiap 10 ms waktu simulasi selama sketch ada di delay(), kira-kira pada titik di mana tugas Bluetooth board sungguhan masuk.
  • tanpa perangkat lain. HP-nya satu-satunya. Board yang memindai (BLEScan) atau terhubung sebagai klien tidak menemukan apa pun, dan SerialBT.connect() tidak menemukan tujuan sambungan.
  • tanpa pertukaran MTU untuk sketch Arduino: nilai hingga 512 byte datang utuh. Dengan MicroPython, HP menukar MTU dengan software Bluetooth milik board itu sendiri, seperti yang dilakukan HP sungguhan.
  • tanpa pemasangan lewat LE dengan MicroPython: HP mengatakan pemasangan tidak didukung.
  • NimBLE-Arduino dan Bluetooth Pico W tidak disimulasikan.