المحرر

البلوتوث، محاكى

اقرن هاتفك بـESP32 أو HC-05 وتحدّث معه. الهاتف هو لوحة Bluetooth في Mokxi، لا جهاز راديو حقيقي.

بلوتوث محاكى: هاتف داخل Mokxi، وليس راديو حقيقيًا. لا شيء في Mokxi يرسل أي شيء، ولا يمكن لأي هاتف حقيقي أن يرى لوحة هنا. ما هو أمين هو كود Arduino الذي تكتبه: أمثلة البلوتوث الخاصة بنواة ESP32 نفسها تعمل دون تغيير، وتقوم اللوحة بما تفعله تطبيقات الهاتف المستخدمة في تلك الدروس.

أين الهاتف

اضغط تشغيل، ثم افتح تبويب البلوتوث بجانب Serial (على الهاتف يكون تحت المزيد). تعرض اللوحة كل جهاز يمكن للهاتف رؤيته:

  • لوحة ESP32 تعمل بـ BluetoothSerial (بلوتوث Classic، على ESP32 الكلاسيكية فقط)،
  • لوحة ESP32 تعلن عبر Bluetooth LE (لوحات ESP32 وESP32-S3 وC3 وC6 مع كود Arduino، وESP32-C3 وC6 مع MicroPython)،
  • كل وحدة HC-05 وHC-06 في الدائرة، على أي لوحة.

اختر واحدة، اقترن، اتصل، ويصبح الجانب الأيمن من اللوحة هو التطبيق.

بلوتوث تسلسلي: SerialBT في ESP32

يعمل كود الدرس كما هو مكتوب:

#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 في اللوحة. اضغط Pair ثم توصيل، وتصبح اللوحة طرفية مثل تطبيق "Serial Bluetooth Terminal": اكتب سطرًا وأرسله (مع CR+LF أو LF أو CR أو لا شيء في النهاية)، وكل ما يكتبه الكود في SerialBT يظهر تحته.

ما يراه الكود هو ما يراه على لوحة حقيقية:

  • يستقبل register_callback() الحدثين ESP_SPP_INIT_EVT وESP_SPP_START_EVT من begin()، وESP_SPP_SRV_OPEN_EVT عند اتصال الهاتف (مع عنوان الهاتف)، وESP_SPP_DATA_IND_EVT عن كل سطر يرسله، وESP_SPP_CLOSE_EVT عند قطع الاتصال؛
  • يتبع hasClient() وconnected() حالة الوصلة، ويعيد write() القيمة 0 دون أحد متصل؛
  • يقرأ available() وread() وpeek() وreadString() وبقية Stream ما أرسله الهاتف، ويستقبله onData() بدلًا منها عند تعيينه.

الاقتران بالطريقة التي يطلبها كودك

  • Just works هو الافتراضي: ينجح Pair فورًا.
  • رمز PIN: بعد SerialBT.disableSSP() وSerialBT.setPin("1234")، تطلب اللوحة رمز PIN، ويفشل الرمز الخاطئ باستدعاء onAuthComplete(false).
  • مقارنة رقمية: مع SerialBT.enableSSP() وonConfirmRequest()، تعرض اللوحة رمزًا من ستة أرقام، ويستقبل رد النداء في الكود الرقم نفسه. على الطرفين الموافقة: زر Pair في اللوحة، وconfirmReply(true) في الكود. بعدها يعمل onAuthComplete(true).
  • مع enableSSP(true, false) تكتب اللوحة الرمز الذي تعرضه اللوحة الجانبية (onKeyRequest() ثم respondPasskey())؛ ومع enableSSP(false, true) تعرضه اللوحة وتكتبه أنت في اللوحة الجانبية.

Forget يلغي الاقتران، كما تفعل إعدادات الهاتف.

Bluetooth LE: خادم BLE في ESP32

تعمل أمثلة BLE_server وBLE_notify وBLE_uart الخاصة بنواة ESP32 دون أي تغيير. تجعل BLEDevice::startAdvertising() اللوحة مرئية، وتصبح اللوحة عندئذٍ ماسحًا مثل nRF Connect:

  • اضغط توصيل، فتُعرض الخدمات والخصائص التي أنشأها الكود مع معرفاتها (UUIDs)، وأسمائها حيث يعرفها الهاتف (خدمة Nordic UART، ومستوى البطارية، وما إلى ذلك) وخصائصها؛
  • Read يشغّل أولًا onRead() الخاص بالخاصية ويعرض القيمة كنص وكتمثيل سداسي عشري (hex)؛
  • Write يرسل نصًا أو hex، ويعمل onWrite() في الكود به؛
  • Notify يشترك، وكل notify() بعدها يظهر مع قيمته. قبل الاشتراك، notify() لا يصل إلى أحد، كما على هاتف حقيقي.

يعمل onConnect() وonDisconnect() عند اتصال اللوحة الجانبية وانفصالها. تتوقف اللوحة عن الإعلان بمجرد الاتصال، فتختفي من القائمة بعد الانفصال حتى يستدعي الكود startAdvertising() مجددًا. لهذا تفعل ذلك الأمثلة داخل loop().

Bluetooth LE في MicroPython: لوحتا ESP32-C3 وC6

على لوحة ESP32-C3 أو ESP32-C6 تعمل بـ MicroPython، تعمل وحدة bluetooth كما على اللوحة الحقيقية، لأن برنامج البلوتوث الخاص باللوحة نفسه يعمل: يُستبدل فقط جزء رقاقة الراديو. يظهر خادم GATT كهذا في اللوحة الجانبية:

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')
  • تعرض اللوحة الجانبية اسم اللوحة كما ورد في بيانات الإعلان الخاصة بها.
  • اضغط توصيل، فيستقبل معالج irq لديك _IRQ_CENTRAL_CONNECT (1). ثم تعثر اللوحة الجانبية على الخدمات بالطريقة التي يفعلها تطبيق هاتف، فتعرض خدمتي Generic Access وGeneric Attribute قبل خدماتك.
  • يعرض Read ما خزّنته gatts_write()، ويطلق Write حدث _IRQ_GATTS_WRITE (3)، وبعد Notify، تظهر كل رسالة gatts_notify().
  • يعمل aioble أيضًا: أضف مجلد aioble من micropython-lib إلى مشروعك، كما تنسخه إلى لوحة حقيقية.
  • ينتهي gap_scan() دون العثور على أي شيء، لأن الهاتف لا يعلن، ولا تستطيع اللوحة الاتصال بالهاتف كمركز (central).

HC-05 وHC-06 على أي لوحة

الوحدات جسور تسلسلية: كل ما يرسله الهاتف يخرج من TXD بمعدل باود الوحدة، بتًا ببت، وما ترسله اللوحة إلى RXD يذهب إلى الهاتف. في اللوحة الجانبية تُدرج كل وحدة باسمها. اقترن برمز PIN الخاص بها (1234 حتى يغيّره AT+PSWD أو AT+PIN)، اتصل، واستخدم الطرفية نفسها. النقر على الوحدة في مساحة العمل يتصل أو يقطع الاتصال أيضًا.

تبدأ HC-05 متصلة، فيعمل مربعها في الشاشة التسلسلية فورًا. وتبدأ HC-06 دون أي اتصال، كما تخرج من الكيس، وبينما لا يكون شيء متصلًا ترد على أوامر AT. يحتوي دليل التسلسل اللاسلكي على أوامر AT للوحدتين.

ما هو حقيقي وما هو ليس كذلك

حقيقي، بالمعنى أنه يتصرف كما ستفعل لوحتك: الاستدعاءات وتواقيعها، وترتيب وصول ردود النداء، والاقتران الذي يجب أن ينجح قبل أي اتصال، ورمز PIN أو الرمز الذي يجب أن يتطابق، والبايتات في الاتجاهين، وجدول GATT، والإشعار فقط بعد اشتراك الهاتف.

غير حقيقي، ولم يُدّعَ يومًا أنه كذلك:

  • لا راديو. لا 2.4 GHz، لا RFCOMM، لا قنوات إعلان، لا مدى، لا مفاتيح وصل، لا تشفير. يقارن رمز PIN كسلسلة نصية.
  • لا تأخير من عنده. يصل السطر كاملًا دفعة واحدة؛ الوصلة الحقيقية تستغرق عشرات المللي ثانية وتتذبذب. تعمل ردود النداء كل 10 ms من الزمن المحاكى أثناء وجود الكود في delay()، وهو تقريبًا ما تحصل عليه مهمة البلوتوث في لوحة حقيقية.
  • لا أجهزة أخرى. الهاتف هو الوحيد. اللوحة التي تمسح (BLEScan) أو تتصل كعميل لا تجد شيئًا، وSerialBT.connect() لا يجد شيئًا يتصل به.
  • لا تفاوض على MTU مع كود Arduino: تصل القيمة حتى 512 بايت كاملة. مع MicroPython يتفاوض الهاتف على MTU مع برنامج البلوتوث الخاص باللوحة نفسها، كما يفعل هاتف حقيقي.
  • لا اقتران عبر LE مع MicroPython: يقول الهاتف إن الاقتران غير مدعوم.
  • NimBLE-Arduino وبلوتوث Pico W غير محاكيَين.