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

مكتبة SD

يبني صافي مكتبته بفحص بطاقة SD عند الإقلاع وكلما أُعيد إدخال البطاقة. اضبط البنية على الوجه الصحيح وكل شيء آخر (وضع التصفح، ومكتبة لوحة التحكم، وبطاقات NFC، والمفضلة) يعمل منها.

متطلبات البطاقة​

  • بطاقة microSD مهيأة بنظام FAT32. البطاقات حتى 32 غيغابايت تهيأ بـFAT32 جاهزاً من الصندوق؛ البطاقات الأكبر تعمل لكن يجب تهيئتها صراحة بنظام FAT32 (نظام exFAT غير مدعوم).
  • أي فئة سرعة تكفي: يقرأ تشغيل الصوت نحو 20 كيلوبايت/ثانية، وهي أقل بمراتب من أبطأ البطاقات.

بنية المجلدات​

مجلد لكل قارئ في جذر البطاقة؛ وملفات الصوت بداخله مسماة برقم السورة:

/
├── Al-Husary/
│   ├── 001.mp3
│   ├── 002.mp3
│   └── ... up to 114.mp3
├── Al-Minshawi/
│   ├── 001_Al-Fatihah.mp3
│   └── ...
└── Abdul-Basit/
    └── ...

القواعد التي يطبقها الماسح:

  • يجب أن تكون الأحرف الثلاثة الأولى من اسم الملف هي رقم السورة، من 001 إلى 114. كل ما بعد الأرقام يُتجاهل، لذا فإن 001.mp3 و001_Al-Fatihah.mp3 و001 الفاتحة.mp3 كلها صالحة ومتكافئة.
  • الصيغ المدعومة: MP3 وWAV. MP3 هو الاختيار العاقل؛ مجموعة كاملة من 114 سورة بمعدل 128 كيلوبت/ثانية نحو 2 غيغابايت.
  • تصبح أسماء المجلدات أسماء القراء المعروضة في الواجهة ولوحة التحكم، فسمِّها بالطريقة التي تريد قراءتها.
  • الملفات والمجلدات المخفية (نقطة في البداية) وأي شيء لا يطابق النمط يُتخطى بصمت.

لا تحتاج ملفات السور الـ114 كلها؛ الفجوات مقبولة والمتصفح يتخطاها ببساطة.

بيانات توقيت الآيات​

لتفعيل شارة رقم الآية بالعربية على الشاشة (آية ١٥)، والتنقل الدقيق بين الآيات في لوحة التحكم، وتكرار الحفظ على مستوى الآية في أوضاع الحفظ، ضع بيانات التوقيت داخل مجلد /timings/ على بطاقة SD:

/
├── Al-Husary/
│   ├── 001.mp3
│   └── ...
└── timings/
    ├── Al-Husary.atb          # أرشيف ثنائي مدمج لكافة السور الـ114 (موصى به)
    └── Al-Husary/
        ├── 001.atb            # ملفات توقيت ثنائية لكل سورة (اختياري)
        └── 001.json           # ملفات توقيت JSON لكل سورة (احتياطي)

يمنح مشغل التوقيت الأولوية للملف المدمج <reciter>.atb (أرشيف ثنائي واحد بحجم ~27 كيلوبايت يتيح وصولاً عشوائياً فورياً دون أي تخصيص ديناميكي للذاكرة)، يليه <reciter>/<surah>.atb، ثم يتراجع إلى JSON كخيار احتياطي. غياب ملفات التوقيت لا يوقف تشغيل الصوت وإنما يُبقي تتبع الآيات غير نشط دون أخطاء.

أسماء السور​

أنت توفر الأرقام فقط؛ يحمل البرنامج الثابت القائمة القانونية الكاملة لأسماء السور الـ114 بالخط العربي ويعرضها بتشكيل سياقي صحيح على الشاشة. هذا يعني أن الشاشة لا تعتمد أبداً على كيفية كتابتك لاسم الملف، وأسماء الملفات العربية غير ضرورية (رغم أنها غير ضارة).

أداة التحقق​

يضم المستودع سكربتاً يفحص بطاقة موصولة ويصلح مشكلات التسمية الشائعة:

# report problems only
./tools/prepare_sd_card_data.sh --check /run/media/you/SDCARD

# rename fixable files in place (e.g. 1.mp3 to 001.mp3)
./tools/prepare_sd_card_data.sh --rename /run/media/you/SDCARD

سلوك التشغيل​

  • داخل القارئ الواحد، يتقدم التشغيل إلى السورة التالية تلقائياً عند نهاية الملف.
  • يعمل الانتقال إلى موضع داخل الملف من لوحة التحكم، بما في ذلك ملفات MP3 ذات معدل البت المتغير (يفهرسها البرنامج الثابت كما يجب؛ التفاصيل قراءة شيقة في الانتقال والاستئناف).
  • يُحفظ موضع التشغيل دورياً وعند كل توقف، فيستطيع الاستئناف المتابعة من منتصف السورة حتى بعد انقطاع الكهرباء.

تبديل البطاقات​

تُكتشف البطاقة عند إدخالها وتُعاد فحص المكتبة تلقائياً؛ لا حاجة إلى إعادة تشغيل. إزالة البطاقة أثناء التشغيل توقف تشغيل الملفات بلطف (بث الراديو غير متأثر، فهو لا يلمس البطاقة أبداً).