Raspberry Pi 5 وحدة حساب PMIC الإضافية 4

الصفحة الأخيرة

2020-2023 Raspberry Pi Ltd (المعروفة سابقًا باسم Raspberry Pi (Trading) Ltd.) تم ترخيص هذه الوثائق بموجب ترخيص Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0).

• تاريخ البناء: 2024-07-09
• إصدار البناء: githash: 3d961bb-clean

إشعار إخلاء المسؤولية القانونية

يتم توفير البيانات الفنية والموثوقية لمنتجات RASPBERRY PI (بما في ذلك أوراق البيانات) كما تم تعديلها من وقت لآخر ("الموارد") بواسطة RASPBERRY PI LTD ("RPL") "كما هي" ويتم إخلاء المسؤولية عن أي ضمانات صريحة أو ضمنية، بما في ذلك على سبيل المثال لا الحصر، الضمانات الضمنية للتسويق والملاءمة لغرض معين. إلى أقصى حد يسمح به القانون المعمول به، لن تكون RPL مسؤولة بأي حال من الأحوال عن أي أضرار مباشرة أو غير مباشرة أو عرضية أو خاصة أو نموذجية أو تبعية (بما في ذلك على سبيل المثال لا الحصر، شراء سلع أو خدمات بديلة؛ أو فقدان الاستخدام أو البيانات أو الأرباح؛ أو انقطاع الأعمال) مهما كان سببها وعلى أي نظرية للمسؤولية، سواء كانت عقدية أو مسؤولية صارمة أو تقصيرية (بما في ذلك الإهمال أو غير ذلك) تنشأ بأي شكل من الأشكال عن استخدام الموارد، حتى لو تم إخطارها بإمكانية حدوث مثل هذا الضرر. تحتفظ RPL بالحق في إجراء أي تحسينات أو تحسينات أو تصحيحات أو أي تعديلات أخرى على الموارد أو أي منتجات موصوفة فيها في أي وقت ودون إشعار آخر. الموارد مخصصة للمستخدمين المهرة ذوي المستويات المناسبة من المعرفة بالتصميم. المستخدمون هم المسؤولون الوحيدون عن اختيارهم واستخدامهم للموارد وأي تطبيق للمنتجات الموصوفة فيها. يوافق المستخدم على تعويض RPL وحمايتها من جميع المسؤوليات والتكاليف والأضرار أو الخسائر الأخرى الناشئة عن استخدامهم للموارد. تمنح RPL المستخدمين الإذن باستخدام الموارد فقط بالتزامن مع منتجات Raspberry Pi. يُحظر أي استخدام آخر للموارد. لا يُمنح أي ترخيص لأي RPL آخر أو أي طرف ثالث لحقوق الملكية الفكرية. الأنشطة عالية المخاطر. منتجات Raspberry Pi ليست مصممة أو مصنعة أو مخصصة للاستخدام في بيئات خطرة تتطلب أداءً آمنًا من الفشل، مثل تشغيل المنشآت النووية، أو أنظمة الملاحة الجوية أو الاتصالات، أو مراقبة الحركة الجوية، أو أنظمة الأسلحة، أو التطبيقات الحرجة للسلامة (بما في ذلك أنظمة دعم الحياة والأجهزة الطبية الأخرى)، حيث قد يؤدي فشل المنتجات مباشرة إلى الوفاة أو الإصابة الشخصية أو الضرر المادي أو البيئي الشديد ("الأنشطة عالية الخطورة"). تخلي RPL مسؤوليتها بشكل خاص عن أي ضمان صريح أو ضمني لملاءمة الأنشطة عالية الخطورة ولا تتحمل أي مسؤولية عن استخدام أو تضمين منتجات Raspberry Pi في الأنشطة عالية الخطورة. يتم توفير منتجات Raspberry Pi وفقًا للشروط القياسية لشركة RPL. لا يؤدي توفير RPL للموارد إلى توسيع أو تعديل الشروط القياسية لشركة RPL بأي شكل من الأشكال، بما في ذلك على سبيل المثال لا الحصر إخلاءات المسؤولية والضمانات الواردة فيها.

تاريخ إصدار الوثيقة

يطلق	تاريخ	وصف
1.0	16 ديسمبر 2022	• الإصدار الأولي
1.1	7 يوليو 2024	• إصلاح الخطأ المطبعي في أوامر vcgencmd، وإضافة Raspberry Pi 5 تفاصيل.

نطاق الوثيقة

تنطبق هذه الوثيقة على منتجات Raspberry Pi التالية:

باي زيرو

باي 1

باي 2

باي 3

باي 4

باي 5

Pi 400

CM1

CM3

CM4

بيكو

صفر

W

H

A

B

A+

B+

A

B

B

A+

B+

الجميع

الجميع

الجميع

الجميع

الجميع

الجميع

الجميع

*

*

*

*

مقدمة

تستخدم أجهزة Raspberry Pi 4/5 وRaspberry Pi Compute Module 4 دائرة متكاملة لإدارة الطاقة (PMIC) لتزويد وحدات التخزين المختلفةtagتتطلب المكونات المختلفة على لوحة الدوائر المطبوعة (PCB) وظائف إضافية. كما أنها تُرتب عمليات التشغيل لضمان تشغيل الأجهزة بالترتيب الصحيح. على مدار إنتاج هذه النماذج، استُخدم عدد من أجهزة PMICs المختلفة. وقد وفرت جميع أجهزة PMICs وظائف إضافية تفوق ما توفره وحدة التخزين.tagالعرض الإلكتروني:

• قناتين ADC يمكن استخدامهما على CM4.
• في الإصدارات الأحدث من Raspberry Pi 4 وRaspberry Pi 400، وجميع طرازات Raspberry Pi 5، تم توصيل المحولات التناظرية إلى الرقمية بموصل الطاقة USB-C على CC1 وCC2.
• مستشعر على الشريحة يمكن استخدامه لمراقبة درجة حرارة PMIC، متوفر على Raspberry Pi 4 و5، وCM4.

يصف هذا المستند كيفية الوصول إلى هذه الميزات في البرنامج.

تحذير

لا يوجد ضمان بأن يتم الحفاظ على هذه الوظيفة في الإصدارات المستقبلية من PMIC، لذا يجب استخدامها بحذر.

قد ترغب أيضًا في الرجوع إلى المستندات التالية:

• ورقة بيانات Raspberry Pi CM4: https://datasheets.raspberrypi.com/cm4/cm4-datasheet.pdf
• مخططات Raspberry Pi 4 المختصرة: https://datasheets.raspberrypi.com/rpi4/raspberry-pi-4-reduced-schematics.pdf

تفترض هذه الورقة البيضاء أن Raspberry Pi يعمل بنظام Raspberry Pi OS، وأنه محدث بالكامل بأحدث البرامج الثابتة والنوى.

استخدام الميزات

في الأصل، كانت هذه الميزات متاحة فقط من خلال قراءة السجلات مباشرةً على وحدة PMIC نفسها. ومع ذلك، تختلف عناوين السجلات باختلاف وحدة PMIC المستخدمة (وبالتالي باختلاف إصدار اللوحة)، لذا وفرت شركة Raspberry Pi Ltd طريقةً مستقلةً عن الإصدار للحصول على هذه المعلومات. يتضمن ذلك استخدام أداة سطر الأوامر vcgencmd، وهو برنامج يتيح لتطبيقات مساحة المستخدم الوصول إلى المعلومات المخزنة في البرنامج الثابت لجهاز Raspberry Pi Ltd أو التي يمكن الوصول إليها منه.

الأوامر المتاحة لـ vcgencmd هي كما يلي:

يأمر	وصف
vcgencmd قياس الفولتات usb_pd	يقيس المجلدtage على الدبوس المحدد بـ usb_pd (انظر مخطط CM4 IO). CM4 فقط.
vcgencmd قياس الفولتات ain1	يقيس المجلدtage على الدبوس المحدد بعلامة ain1 (انظر مخطط CM 4 IO). CM4 فقط.
vcgencmd قياس درجة الحرارة pmic	يقيس درجة حرارة قالب PMIC. CM4 و Raspberry Pi 4 و 5.

يتم تشغيل كافة هذه الأوامر من سطر أوامر Linux.

استخدام الميزات من كود البرنامج

من الممكن استخدام أوامر vcgencmd هذه برمجيًا إذا كنت بحاجة إلى المعلومات داخل تطبيق. في كلٍّ من بايثون وسي، يمكن استخدام استدعاء نظام التشغيل لتشغيل الأمر وإرجاع النتيجة كسلسلة نصية. إليك بعض الأمثلة:ampالكود Python الذي يمكن استخدامه لاستدعاء الأمر vcgencmd:

يستخدم هذا الكود وحدة المعالجة الفرعية في بايثون لاستدعاء الأمر vcgencmd وتمرير أمر measure_temp إلى pmic، والذي سيقيس درجة حرارة قالب PMIC. سيتم طباعة ناتج الأمر في وحدة التحكم.

وهنا مثال مشابهample في C:

يستخدم كود C popen (بدلاً من system()، والذي قد يكون أيضًا خيارًا)، وربما يكون أكثر تفصيلاً مما ينبغي لأنه يمكنه التعامل مع نتائج أسطر متعددة من المكالمة، بينما يقوم vcgencmd بإرجاع سطر واحد فقط من النص.

ملحوظة

يتم توفير مقتطفات التعليمات البرمجية هذه فقط على شكلampقد تحتاج إلى تعديلها حسب احتياجاتك الخاصة. على سبيل المثالampربما ترغب في تحليل مخرجات الأمر vcgencmd لاستخراج قيمة درجة الحرارة لاستخدامها لاحقًا.

الأسئلة الشائعة

• س: هل يمكنني استخدام هذه الميزات على جميع طرازات Raspberry Pi؟
  • ج: لا، هذه الميزات متاحة خصيصًا لأجهزة Raspberry Pi 4 وRaspberry Pi 5 وCompute Module 4.
• س: هل من الآمن الاعتماد على هذه الميزات للاستخدام المستقبلي؟
  • ج: لا يوجد ضمان بأن هذه الوظيفة ستظل موجودة في إصدارات PMIC المستقبلية، لذا يُنصح بالحذر عند استخدام هذه الميزات.

المستندات / الموارد

Raspberry Pi Raspberry Pi 5 وحدة الحوسبة الإضافية PMIC 4 [بي دي اف] دليل التعليمات Raspberry Pi 4، Raspberry Pi 5، وحدة الحوسبة 4، Raspberry Pi 5 وحدة الحوسبة الإضافية PMIC 4، Raspberry Pi 5، وحدة الحوسبة الإضافية PMIC 4، وحدة الحوسبة 4

مراجع

• دليل المستخدم