الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

PiNEbox

يصف README.md التالي الإجراء الخاص بتطوير وتثبيت PiNe Box بما في ذلك واجهة المستخدم. صندوق PiNe هو جهاز مغلق يعمل مع Raspberry Pi الذي يسمح بالتشغيل المتزامن للأحداث وختم الوقت بين نظام EEG بالإضافة إلى شاشة خارجية للعلامات الحيوية. يقوم النظام بتشغيل واجهة مستخدم Python التي تقرأ مشغلات TTL من أجهزة التشغيل الخارجية (التي يتم إرسالها في نفس الوقت إلى مكبر صوت EEG) وترسل رسالة UDP إلى شاشة Vital Signs عبر رابط شبكة إيثرنت. تتيح واجهة المستخدم الرسومية للمستخدم تحديد عنوان IP المناسب ومنافذ الاستماع.

هذه التعليمات مخصصة لستة مشغلات إدخال (زر الضغط، والرمح، والمثيرات اللمسية، والسمعية، والمرئية، والتجريبية/وخز الدبوس) باستخدام مواصفات TTL ويفترض حاليًا أن نظام العلامات الحيوية هو iXTrend الذي تم تطويره بواسطة iXcellence: https://www.ixellence .com/index.php/en/home/17-default-en/products

المطورون: كيروبين بيلاي، ماريا كوبو أندرادي، كارولين هارتلي، آلان وورلي 06/07/2021
مجموعة التصوير العصبي للأطفال، جامعة أكسفورد، أكسفورد، المملكة المتحدة.
مستشفى جريت أورموند ستريت، لندن، المملكة المتحدة.

الإصدار الحالي

الإصدار 1.0 (تم إصداره في 07/06/2021)

الاقتباس

المخطوطة قيد التطوير حاليًا وستتطلب الاستشهاد بها بمجرد نشرها. سيتم توفير الاقتباس هنا.

هيكل المستودع

لتطوير صندوق PiNe، يحتوي هذا المستودع على المعلومات التالية:

  1. تعليمات إنشاء PiNe Box: إنشاء صندوق PiNe وإعداد Raspberry Pi بما في ذلك أوراق البيانات والرسومات التخطيطية وما إلى ذلك. انتقل إلى المجلد "PiNeBox_setup" في المستودع. ابدأ بملف pdf "PiNeBox_hardware" للحصول على الإرشادات العامة لإنشاء صندوق PiNe. سيتم تضمين ملف pdf هذا بمجرد نشر الورقة.
  2. تكوين برنامج Raspberry Pi OS : تعليمات إعداد نظام التشغيل Raspberry Pi OS (يفترض هذا الدليل أن إصدارًا حديثًا من Raspbian مثبت بالفعل على Pi) - راجع بقية وثائق الملف التمهيدي هذه.
  3. واجهة مستخدم Python : كود المصدر لتطوير وتشغيل واجهة مستخدم Python على Raspberry Pi الذي تم تكوينه. راجع بقية هذا الملف التمهيدي للحصول على إرشادات حول كيفية التشغيل وبدء التشغيل تلقائيًا.

تنزيل مستودع Git

التبعيات

تفترض تعليمات برنامج نظام التشغيل أن هناك إصدارًا حديثًا من Raspbian Jessie مثبتًا بالفعل على Pi. يتطلب كود Python UI إصدار Python 3.7.0 أو أعلى.

على جهاز كمبيوتر شخصي/Mac (للمطورين)

  1. لتنزيل المستودع وتثبيته على جهاز كمبيوتر شخصي/جهاز Mac للتحرير/مزيد من التطوير: 
 git clone https://github.com/kpillay/PiNEbox.git
cd PiNEbox. 
pip install -r requirements.txt

على Raspberry Pi (لغير المطورين)

  1. عادةً ما يتم تثبيت Pi مع Python 2 وربما إصدار Python 3 (<3.7.0) على الأقل على نظام التشغيل Raspbian. إذا كان الأمر كذلك، فسيلزم أولاً تثبيت Python 3.7 وربطه بأمر python عند تشغيله على الوحدة الطرفية. لتحقيق ذلك، اتبع التعليمات الموجودة في: https://installvirtual.com/install-python-3-7-on-raspberry-pi/. إذا تم إعداده بالفعل، فانتقل إلى الخطوة 3.

  2. بعد اتباع الإرشادات الواردة في الخطوة 1، من المحتمل أن يظل مُثبِّت النقطة يشير إلى مثيل بايثون سابق. لتجنب هذا التعارض، قم بتنزيل المستودع وتثبيته باستخدام الأوامر التالية (بافتراض أن python 3.7 مرتبط الآن بـ python في الوحدة الطرفية. لاحظ أن هذا سيؤدي إلى تنزيل نسخة للقراءة فقط من المستودع ويوصى به عندما ترغب ببساطة في نشر البرنامج الحالي الإصدار على Pi الخاص بك للاستخدام غير المطور. 

 git clone git://github.com/kpillay/PiNEbox.git
cd PiNEbox
python -m pip install -r requirements.txt

تكوين برنامج Raspberry Pi لاستخدام صندوق PiNe

يجب إجراء بعض التعديلات على البرنامج حتى يعمل بشكل أفضل مع أجهزة PiNe box وPython UI. يتضمن ذلك تثبيت لوحة مفاتيح Vietual للاستخدام على شاشة اللمس.

التحديث الأولي للبرمجيات

قبل المتابعة، قم بتحديث نظام التشغيل Raspbian إلى الإصدار الأحدث. للقيام بذلك، أدخل الأوامر التالية في محطة Pi (تأكد من إنشاء اتصال بالإنترنت أولاً على Pi عبر WiFi أو إيثرنت): 

 sudo apt-get update
sudo apt-get upgrade
sudo shutdown -r now

بعد تحديث Pi وإيقاف تشغيله. أعد التشغيل وتابع كما هو موضح أدناه.

تفعيل مؤشر LED للنشاط

يستخدم زر إيقاف التشغيل الناعم دبوس TxD الموجود على Pi GPIO لتزويد المستخدم بمؤشر لحالة وحدة المعالجة المركزية الحالية. يجب تمكين هذا الدبوس في البرنامج لتشغيل مؤشر LED. للقيام بذلك:

  1. على Pi، افتح الملف bootconfig.txt
  2. في نهاية الملف أضف السطر enable_uart=1 ثم احفظه وأغلقه.
  3. أعد تشغيل pi ويجب الآن تشغيل مؤشر LED الخاص بالنشاط.

تركيب لوحة مفاتيح افتراضية لشاشة اللمس

تم اختيار لوحة مفاتيح علبة الثقاب هنا. لتثبيته وإنشاء اختصار على شريط الأدوات:

  1. قم بتثبيت لوحة المفاتيح عن طريق الكتابة في Pi Terminal sudo apt-get install matchbox-keyboard .
  2. أعد تشغيل باي
  3. يمكن الآن العثور على لوحة المفاتيح في القائمة -> الملحقات -> لوحة المفاتيح. لإنشاء اختصار لشريط المهام، انقر بزر الماوس الأيمن فوق شريط المهام ثم حدد إضافة/إزالة عناصر اللوحة. أضف "شريط تشغيل التطبيق".
  4. انقر بزر الماوس الأيمن على شريط المهام مرة أخرى، وحدد "تشغيل التطبيق وشريط المهام"، وانتقل إلى "لوحة المفاتيح" ضمن "البرامج الملحقة" وانقر على "إضافة".
  5. يجب أن يكون اختصار لوحة المفاتيح الآن على شريط المهام أعلى الشاشة.

التغييرات الجمالية (اختياري)

تغيير نظام ألوان نظام التشغيل Raspbian

لإنشاء مظهر أكثر احترافية ومخصصًا لنظام التشغيل Pi الخاص بك استعدادًا لتشغيل واجهة Python UI، يمكنك تغيير الألوان. يمكن تغيير خلفية وألوان شريط المهام والنافذة لتتوافق مع واجهة مستخدم Python من خلال الانتقال إلى قائمة Pi start وتحديد "Preferences" وفتح إعدادات "Appearance". يمكن استخدام رموز الألوان السداسية التالية:

  • يتغير لون الخلفية ليتوافق مع نظام Python UI: #504f51
  • تغيرات لون النص: #f28e7c

تغيير ورق الجدران

يتم أيضًا تضمين خلفية PiNe Box في المستودع وتسمى "PiNe_wallpaper.png". ويمكن أيضًا إضافة هذا في الإعدادات المذكورة أعلاه.

تشغيل واجهة مستخدم PiNe Box

على المحطة

لتشغيل PiNe UI على جهاز الكمبيوتر/Mac/Raspberry Pi، ما عليك سوى تشغيل cli.py في بيئة التطوير المتكاملة (IDE) التي اخترتها. للتشغيل مباشرة في الوحدة الطرفية، قم بزيارة القرص المضغوط إلى موقع المستودع واستخدم الأمر التالي: 

 python cli.py

اختبار واجهة بايثون

يمكن اختبار واجهة مستخدم Python عن طريق تعيين عنوان IP على المضيف المحلي (127.0.0.1) وتشغيل البرنامج النصي على النحو الوارد أعلاه. إن فتح جلسة بايثون متوازية باستخدام نصوص الخادم المتوفرة PiNe_macServerUDP.py وPiNe_macServerTCP.py بناءً على اختيار المراسلة سيسمح باختبار أن البرامج النصية cli.py ترسل الرسائل مرة أخرى إلى جهازك المحلي بنجاح.

الإعداد للتشغيل تلقائيًا عند تشغيل Pi

بمجرد فتح واجهة Python UI بنجاح كما هو مذكور أعلاه باستخدام الوحدة الطرفية، يمكن إعدادها لفتحها تلقائيًا عند تشغيل Pi. تفترض الإرشادات التالية أن مجلد مستودع PiNEbox موجود على سطح المكتب :

  1. افتح البرنامج النصي لبدء التشغيل التلقائي في محطة Pi عن طريق كتابة sudo nano /etc/xdg/lxsession/LXDE-pi/autostart .
  2. في أسفل الملف، أضف الأمر التالي لتشغيل برنامج bash النصي الذي تم تكوينه مسبقًا: /home/pi/Desktop/PiNEbox/PiNe_startup.sh .
  3. سيقوم البرنامج النصي bash الذي تم تكوينه مسبقًا "PiNe_startup" بتشغيل كود Python UI.
  4. أعد تشغيل pi ويجب الآن فتح واجهة مستخدم Python تلقائيًا.
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل