إنتقل إلى المحتوى الرئيسي

برمجة MAG-BOARD

يُسلَّم MAG-BOARD مع برنامج ثابت مُحمَّل مسبقاً لمقياس التدرج.

إذا كنت تستخدم البرنامج الثابت القياسي من FG Sensors ولا تحتاج إلى تعديل الكود، يمكنك تخطي هذا القسم. إذا أردت تخصيص البرنامج، يمكنك برمجة MAG-BOARD باستخدام Arduino IDE والكود مفتوح المصدر الذي توفره FG Sensors.

ملاحظة

برنامج مقياس التدرج مفتوح المصدر المتاح على الموقع لا يدعم الاتصال بتطبيق FG Sensors App لنظام Android.

المتطلبات​

قبل برمجة MAG-BOARD، احضر ما يلي:

  • كابل MicroUSB
  • Arduino IDE
  • حزمة دعم لوحة ESP32
  • مكتبات Arduino المطلوبة

الخطوة 1 — تثبيت Arduino IDE​

نزّل وثبّت Arduino IDE من الموقع الرسمي لـArduino.

بعد التثبيت، افتح Arduino IDE وجهّزه لدعم ESP32.

الخطوة 2 — إضافة عنوان URL لمدير لوحة ESP32​

تستخدم MAG-BOARD وحدة تحكم مبنية على ESP32، لذا يجب تثبيت دعم لوحة ESP32 في Arduino IDE.

  1. افتح File → Preferences
  2. ابحث عن حقل Additional Boards Manager URLs
  3. أضف عنوان URL التالي:
https://dl.espressif.com/dl/package_esp32_index.json

يُتيح ذلك لـArduino IDE تنزيل تعريفات لوحة ESP32 وتثبيتها.

Arduino IDE ESP32 Board Manager URL

الخطوة 3 — تثبيت حزمة لوحة ESP32​

  1. افتح Tools → Board → Boards Manager
  2. ابحث عن: esp32
  3. ثبّت حزمة لوحة ESP32

بعد التثبيت، ستتوفر أهداف ESP32 المطلوبة في Arduino IDE.

Arduino IDE ESP32 Board Package Installation
Arduino IDE ESP32 Board Package Installation Step 2

الخطوة 4 — تحديد اللوحة​

  1. افتح Tools → Board
  2. اختر: ESP32 Dev Module
Arduino IDE Select ESP32 Dev Module

الخطوة 5 — تحديد المنفذ التسلسلي​

وصّل MAG-BOARD بحاسوبك باستخدام كابل MicroUSB، ثم:

  1. افتح Tools → Port
  2. اختر منفذ COM المقابل لـMAG-BOARD المتصلة

قد يختلف اسم المنفذ حسب نظام تشغيلك (مثل COM4 على Windows، /dev/ttyUSB0 على Linux).

Arduino IDE Select Serial Port

الخطوة 6 — تثبيت المكتبات المطلوبة​

افتح Sketch → Include Library → Manage Libraries وثبّت ما يلي:

Arduino IDE Manage Libraries

مكتبة LCD​

ابحث عن: liquidcrystal_pcf8574 وثبّتها.

Arduino IDE Install LiquidCrystal PCF8574 Library

مكتبة الجرس الإلكتروني​

ابحث عن: easybuzzer وثبّتها.

Arduino IDE Install EasyBuzzer Library

الخطوة 7 — رفع البرنامج الثابت​

  1. افتح كود المصدر لمقياس التدرج من FG Sensors في Arduino IDE
  2. تحقق من نجاح بناء المشروع
  3. انقر زر Upload

سيُجمّع Arduino IDE البرنامج الثابت وينقله إلى MAG-BOARD.

سير عمل البرمجة النموذجي​

تثبيت Arduino IDE
→ إضافة عنوان URL لـESP32
→ تثبيت حزمة ESP32
→ تحديد ESP32 Dev Module
→ تحديد منفذ COM
→ تثبيت المكتبات المطلوبة
→ فتح كود المصدر
→ رفع البرنامج الثابت

ملاحظات​

  • تتضمن MAG-BOARD بالفعل برنامج مقياس التدرج مُحمَّل مسبقاً
  • البرمجة ضرورية فقط إذا أردت تعديل البرنامج الثابت أو استبداله
  • نسخة الكود مفتوح المصدر لا تدعم تطبيق FG Sensors لنظام Android

استكشاف الأخطاء وإصلاحها​

عدم اكتشاف اللوحة

  • تحقق من كابل MicroUSB
  • أعد توصيل اللوحة
  • تحقق من تحديد منفذ COM الصحيح

فشل الرفع

  • تأكد من تحديد ESP32 Dev Module
  • تحقق من تثبيت حزمة ESP32 بشكل صحيح
  • تأكد من اختيار المنفذ التسلسلي الصحيح

عدم عمل وظائف LCD أو الجرس الإلكتروني

  • تأكد من تثبيت كلتا المكتبتَين:
    • liquidcrystal_pcf8574
    • easybuzzer

الخطوة التالية​

إذا لم تردت تجميع البرنامج الثابت من المصدر، تابع مع:

تثبيت البرنامج الثابت

تستخدم هذه الطريقة صورة البرنامج الثابت الجاهزة وأداة كتابة بدلاً من Arduino IDE.