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

البداية السريعة

تقودك هذه الصفحة من جهاز مجمَّع إلى تشغيل تلاوة. إذا لم تكن قد بنيت العتاد بعد، ابدأ بـقائمة المكونات والتوصيلات أولاً.

ما تحتاجه​

  • جهاز صافي مجمَّع (أو على الأقل لوحة ESP32-S3-N16R8 لتجربة لوحة التحكم وحدها)
  • كابل USB-C إلى حاسوبك
  • بطاقة microSD بسعة 8 غيغابايت أو أكثر، مهيأة بنظام FAT32
  • ملفات تلاوة القرآن بصيغة MP3، منظمة حسب القارئ
  • شبكة WiFi بتردد 2.4 غيغاهرتز (راديو ESP32-S3 لا يدعم تردد 5 غيغاهرتز)

الخطوة 1: كتابة البرنامج الثابت على الفلاش​

نزّل أحدث ملفات الإصدار من GitHub Releases، ثم اكتبها على الفلاش باستخدام esptool:

pip install esptool
python -m esptool --chip esp32s3 -p /dev/ttyACM0 -b 460800 write_flash \
  0x0      bootloader.bin \
  0x8000   partition-table.bin \
  0x1a000  ota_data_initial.bin \
  0x20000  Safi.bin \
  0x920000 storage.bin

على Windows يكون المنفذ COMx بدلاً من /dev/ttyACM0. تظهر اللوحة كجهاز USB تسلسلي بشكل أصلي، فلا حاجة إلى محول UART.

إذا كنت تفضل البناء من المصدر، اتبع بداية العمل للمطورين.

الخطوة 2: تجهيز بطاقة SD​

أنشئ مجلداً لكل قارئ، وسمِّ ملفات الصوت ببادئة من ثلاثة أرقام تمثل رقم السورة:

/
├── Al-Husary/
│   ├── 001.mp3
│   ├── 002.mp3
│   └── ...
├── Al-Minshawi/
│   ├── 001.mp3
│   └── ...
└── Abdul-Basit/
    └── ...

يتجاهل الماسح أي شيء بعد الرقم، لذا فإن 001_Al-Fatihah.mp3 يعمل أيضاً. يضم المستودع أداة فحص تتحقق من بنية البطاقة وتصلحها لك:

./tools/prepare_sd_card_data.sh --check /path/to/mounted/card

التفاصيل الكاملة، بما فيها دعم WAV ومنطق عرض أسماء السور، في مكتبة SD.

الخطوة 3: أول إقلاع​

  1. أدخل بطاقة SD ووصّل الطاقة.
  2. تعرض شاشة البداية شعار صافي ورقم إصدار البرنامج الثابت وتقرير الإقلاع. على جهاز كامل التوصيل تكون كل الأسطر خضراء؛ أما الملحقات المفقودة فتُعرض باللون الأحمر ويواصل الجهاز العمل من دونها.
  3. تستقر الشاشة على ساعة الخمول. تعرض الساعة --:-- حتى أول مزامنة ناجحة للوقت، وهي تتطلب WiFi.

الخطوة 4: الاتصال بشبكة WiFi​

يجرب صافي ثلاثة مسارات للتزويد بالترتيب؛ استخدم ما يناسبك. وصف الثلاثة مفصلاً في أول إقلاع وWiFi.

  1. بيانات اعتماد محفوظة من جلسة سابقة، مخزنة مشفرة في الفلاش.
  2. بيانات اعتماد مضمّنة في البناء (للمطورين): CONFIG_SAFI_WIFI_SSID وCONFIG_SAFI_WIFI_PASSWORD.
  3. التزويد عبر SoftAP: في غياب ما سبق، يفتح الجهاز نقطة وصول باسم Safi-XXXXXX، ويمكن لتطبيق ESP SoftAP Provisioning في الهاتف دفع بيانات اعتماد WiFi إلى الجهاز لاسلكياً، بعد مصادقة برمز إثبات الحيازة المطبوع على ملصق الجهاز.

عند نجاح الارتباط يظهر رمز WiFi في شريط الحالة، ويُعرض عنوان IP الخاص بالجهاز على شاشة الخمول ويُطبع على المنفذ التسلسلي.

الخطوة 5: فتح لوحة التحكم​

تصفح https://safi.local (يعلن الجهاز عن هذا الاسم عبر mDNS)، أو https://<device-ip> إذا كانت شبكتك تحجب mDNS. تحذيران متوقعان عند أول زيارة:

  • تحذير الشهادة: يأتي الجهاز بشهادة موقعة ذاتياً. اقبلها مرة واحدة. لتثبيت شهادة سليمة راجع أعماق HTTPS.
  • رمز API: تتطلب إجراءات التحكم رمز وصول يطبعه الجهاز على المنفذ التسلسلي عند أول إقلاع. يوضح دليل لوحة التحكم مكان لصقه.

من صفحة المكتبة، اختر قارئاً وسورة واضغط تشغيل.

الخطوة 6: التشغيل من دون لوحة التحكم​

  • أدر المفتاح الدوار لتغيير مستوى الصوت؛ واضغطه للدخول إلى متصفح المكتبة.
  • المس لوحة اللمس للتشغيل أو الإيقاف المؤقت.
  • سجّل بطاقة NFC من لوحة التحكم، ولمسها بعد ذلك يبدأ التشغيل مباشرة، انظر بطاقات NFC.

إلى أين بعد ذلك​