ورقة بيضاء تقدم
مستوى عالىview من الصوت
خيارات على Raspberry Pi SBCs
راسبيري باي المحدودة
الصفحة الأخيرة
© 2022-2025 شركة راسبيري باي المحدودة
تم ترخيص هذه الوثائق بموجب ترخيص المشاع الإبداعي المنسوب إلى - لا مشتقات 4.0 الدولي (CC BY-ND).
الإصدار 1.0
تاريخ البناء: 28/05/2025
إشعار إخلاء المسؤولية القانونية
يتم توفير البيانات الفنية وبيانات الموثوقية الخاصة بمنتجات RASPBERRY PI (بما في ذلك أوراق البيانات) والتي يتم تعديلها من وقت لآخر ("الموارد") من قبل RASPBERRY PI LTD ("RPL") "كما هي" وأي ضمانات صريحة أو ضمنية، بما في ذلك، على سبيل المثال لا الحصر إلى، تم إخلاء المسؤولية عن الضمانات الضمنية الخاصة بقابلية التسويق والملاءمة لغرض معين. إلى الحد الأقصى الذي يسمح به القانون المعمول به، لن تكون RPL مسؤولة بأي حال من الأحوال عن أي أضرار مباشرة أو غير مباشرة أو عرضية أو خاصة أو نموذجية أو تبعية (بما في ذلك، على سبيل المثال لا الحصر، شراء السلع أو الخدمات البديلة؛ فقدان الاستخدام، البيانات). أو الأرباح؛ أو انقطاع الأعمال) مهما كان سببها وعلى أي نظرية للمسؤولية، سواء في العقد أو المسؤولية الصارمة أو الضرر (بما في ذلك الإهمال أو غيره) الذي ينشأ بأي شكل من الأشكال عن استخدام الموارد، حتى لو تم الإبلاغ عن هذا الاحتمال. من مثل هذه الأضرار.
تحتفظ RPL بالحق في إجراء أي تحسينات أو تحسينات أو تصحيحات أو أي تعديلات أخرى على الموارد أو أي منتجات موصوفة فيها في أي وقت ودون إشعار آخر.
الموارد مُصممة للمستخدمين ذوي الخبرة في التصميم. يتحمل المستخدمون وحدهم مسؤولية اختيارهم واستخدامهم للموارد، بالإضافة إلى أي تطبيق للمنتجات الموصوفة فيها. يوافق المستخدم على تعويض RPL وإبراء ذمتها من جميع المسؤوليات والتكاليف والأضرار والخسائر الأخرى الناتجة عن استخدامهم للموارد. تمنح RPL المستخدمين الإذن باستخدام الموارد فقط مع منتجات Raspberry Pi. يُحظر أي استخدام آخر للموارد. لا يُمنح أي ترخيص لأي RPL أو أي طرف ثالث آخر لحقوق الملكية الفكرية.
الأنشطة عالية الخطورة. منتجات راسبيري باي غير مصممة أو مصنعة أو مخصصة للاستخدام في بيئات خطرة تتطلب أداءً آمنًا من الأعطال، مثل تشغيل المنشآت النووية، أو أنظمة الملاحة الجوية أو الاتصالات، أو مراقبة الحركة الجوية، أو أنظمة الأسلحة، أو التطبيقات الحرجة للسلامة (بما في ذلك أنظمة دعم الحياة والأجهزة الطبية الأخرى)، حيث قد يؤدي فشل المنتجات مباشرةً إلى الوفاة أو الإصابة الشخصية أو الضرر المادي أو البيئي الشديد ("الأنشطة عالية الخطورة"). تُخلي شركة RPL مسؤوليتها صراحةً عن أي ضمان، صريحًا كان أم ضمنيًا، لملاءمة المنتجات للأنشطة عالية الخطورة، ولا تتحمل أي مسؤولية عن استخدام أو تضمين منتجات راسبيري باي في هذه الأنشطة. تُقدم منتجات راسبيري باي وفقًا لشروط وأحكام RPL. الشروط القياسية. لا يؤدي توفير RPL للموارد إلى توسيع أو تعديل RPL بأي شكل آخر الشروط القياسية بما في ذلك على سبيل المثال لا الحصر إخلاءات المسؤولية والضمانات الواردة فيها.
تاريخ إصدار الوثيقة
| يطلق | تاريخ | وصف |
| 1 | 1-25-XNUMX | الإصدار الأولي |
نطاق الوثيقة
تنطبق هذه الوثيقة على منتجات Raspberry Pi التالية:
| بي 0 | بي 1 | باي 2 | باي 3 | باي 4 | باي 400 | باي 5 | باي 500 | CM1 | CM3 | CM4 | CM5 | بيكو | بيكو 2 | ||||
| 0 | W | H | A | B | A | B | B | الجميع | الجميع | الجميع | الجميع | الجميع | الجميع | الجميع | الجميع | الجميع | الجميع |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
مقدمة
على مر السنين، أصبحت الخيارات المتاحة لإخراج الصوت على أجهزة الكمبيوتر أحادية اللوحة Raspberry Pi أكثر عددًا، وتغيرت الطريقة التي يتم بها تشغيلها من خلال البرامج.
ستتناول هذه الوثيقة العديد من الخيارات المتاحة لإخراج الصوت على جهاز Raspberry Pi الخاص بك وتقدم إرشادات حول كيفية استخدام خيارات الصوت من سطح المكتب وسطر الأوامر.
تفترض هذه الورقة البيضاء أن جهاز Raspberry Pi يعمل بنظام التشغيل Raspberry Pi ومحدث بالكامل بأحدث البرامج الثابتة والنوى.
أجهزة صوت Raspberry Pi
منفذ HDMI
جميع وحدات Raspberry Pi SBC مزودة بموصل HDMI يدعم صوت HDMI. عند توصيل وحدة Raspberry Pi SBC بشاشة أو تلفزيون مزود بمكبرات صوت، سيتم تفعيل إخراج صوت HDMI تلقائيًا عبر هذه المكبرات. يُعد صوت HDMI إشارة رقمية عالية الجودة، لذا يمكن أن تكون النتائج ممتازة، كما أنه يدعم الصوت متعدد القنوات مثل DTS.
إذا كنت تستخدم فيديو HDMI ولكنك تريد فصل إشارة الصوت — على سبيل المثالampلي، إلى ampإذا كان لديك مُضخّم صوت لا يدعم مدخل HDMI، فستحتاج إلى استخدام مُقسّم إضافي لاستخراج إشارة الصوت من إشارة HDMI. قد يكون هذا مُكلفًا، ولكن هناك خيارات أخرى، وهي موضحة أدناه.
مقبس PCM/3.5 ملم تناظري
تتميز طُرز Raspberry Pi B+ و2 و3 و4 بمقبس صوت رباعي الأقطاب بقطر 3.5 مم يدعم إشارات الصوت والفيديو المُركّب. يُعد هذا خرجًا تناظريًا منخفض الجودة مُولّدًا من إشارة PCM (تعديل شفرة النبضة)، ولكنه لا يزال مناسبًا لسماعات الرأس ومكبرات الصوت المكتبية.
ملحوظة
لا يوجد إخراج صوتي تناظري على Raspberry Pi 5.
إشارات مقبس التوصيل مُعرَّفة في الجدول التالي، بدءًا من طرف الكابل وانتهاءً بطرفه. تتوفر الكابلات بمهام مختلفة، لذا تأكد من اختيار الكابل الصحيح.
| قطعة جاك | إشارة |
| كم | فيديو |
| اتصل على الرقم 2 | أرضي |
| اتصل على الرقم 1 | يمين |
| نصيحة | غادر |
لوحات محولات تعتمد على I2S
جميع طُرز Raspberry Pi SBCs مزودة بموصل طرفي I2S مُتاح على منفذ GPIO. I2S هو معيار واجهة ناقل تسلسلي كهربائي يُستخدم لتوصيل أجهزة الصوت الرقمية ونقل بيانات صوت PCM بين الأجهزة الطرفية في جهاز إلكتروني. تُصنّع Raspberry Pi Ltd مجموعة من لوحات الصوت التي تتصل بموصل GPIO وتستخدم واجهة I2S لنقل بيانات الصوت من نظام SoC (نظام على شريحة) إلى اللوحة الإضافية.
ملحوظة: تُعرف لوحات التوصيل الإضافية التي تتصل عبر موصل GPIO وتلتزم بالمواصفات المناسبة باسم HAT (الأجهزة المرفقة في الأعلى). يمكن الاطلاع على مواصفاتها هنا: https://datasheets.raspberrypi.com/
يمكن رؤية النطاق الكامل لـ HATs الصوتية على Raspberry Pi Ltd webموقع: https://www.raspberrypi.com/products/
هناك أيضًا عدد كبير من أجهزة HAT التابعة لجهات خارجية متاحة لإخراج الصوت، على سبيل المثالampتتوفر العديد من أنواع البرامج المجانية من Pimoroni وHiFiBerry وAdafruit وما إلى ذلك، وتوفر هذه البرامج مجموعة كبيرة من الميزات المختلفة.
صوت يو اس بي
إذا لم يكن تركيب HAT ممكنًا، أو كنت تبحث عن طريقة سريعة وسهلة لتوصيل مقبس سماعة رأس أو مدخل ميكروفون، فإن محول الصوت USB خيار جيد. هذه أجهزة بسيطة واقتصادية تُوصل بأحد منافذ USB-A في Raspberry Pi SBC.
يتضمن نظام التشغيل Raspberry Pi OS برامج تشغيل للصوت عبر USB بشكل افتراضي؛ بمجرد توصيل الجهاز، يجب أن يظهر في قائمة الجهاز التي تظهر عند النقر بزر الماوس الأيمن على رمز مكبر الصوت على شريط المهام.
وسوف يقوم النظام أيضًا بالكشف تلقائيًا عما إذا كان جهاز USB المتصل يحتوي على مدخل ميكروفون وتمكين الدعم المناسب.
بلوتوث
يشير صوت البلوتوث إلى النقل اللاسلكي لبيانات الصوت عبر تقنية البلوتوث، وهي تقنية شائعة الاستخدام. تُمكّن هذه التقنية جهاز Raspberry Pi SBC من التواصل مع مكبرات الصوت وسماعات الرأس/الأذن التي تدعم البلوتوث، أو أي جهاز صوتي آخر يدعمه. نطاق الاتصال قصير نسبيًا - حوالي 10 أمتار كحد أقصى.
يجب إقران أجهزة البلوتوث مع وحدة Raspberry Pi SBC، وستظهر في إعدادات الصوت على سطح المكتب بعد ذلك. يُثبّت البلوتوث افتراضيًا على نظام Raspberry Pi OS، ويظهر شعار البلوتوث على شريط مهام سطح المكتب على أي أجهزة مُثبّت عليها أجهزة بلوتوث (سواءً مُدمجة أو عبر دونجل USB). عند تفعيل البلوتوث، يكون الرمز أزرقًا؛ وعند تعطيله، يكون الرمز رماديًا.
دعم البرمجيات
تغيّر برنامج دعم الصوت الأساسي بشكل كبير في نظام تشغيل Raspberry Pi الكامل، وبالنسبة للمستخدم النهائي، تُعد هذه التغييرات واضحة في معظمها. كان نظام الصوت الفرعي الأصلي المستخدم هو ALSA. حل Pulse Audio محل ALSA، قبل أن يُستبدل بالنظام الحالي، Pipe Wire. يتمتع هذا النظام بنفس وظائف Pulse Audio، وواجهة برمجة تطبيقات متوافقة، ولكنه يحتوي أيضًا على ملحقات للتعامل مع الفيديو والميزات الأخرى، مما يُسهّل دمج الفيديو والصوت بشكل كبير. ولأن Pipe Wire يستخدم نفس واجهة برمجة التطبيقات مثل Pulse Audio، فإن أدوات Pulse Audio تعمل بشكل جيد على نظام Pipe Wire.
يتم استخدام هذه الأدوات المساعدة في السابقampأدناه.
للحفاظ على حجم الصورة صغيرًا، لا يزال نظام Raspberry Pi OS Lite يستخدم ALSA لدعم الصوت، ولا يتضمن أي مكتبات صوتية لـ Pipe Wire أو Pulse Audio أو Bluetooth. مع ذلك، يُمكن تثبيت المكتبات المناسبة لإضافة هذه الميزات حسب الحاجة، كما هو موضح أدناه.
سطح المكتب
كما ذُكر سابقًا، تتم إدارة عمليات الصوت عبر أيقونة مكبر الصوت في شريط مهام سطح المكتب. يؤدي النقر بزر الماوس الأيسر على الأيقونة إلى ظهور شريط تمرير مستوى الصوت وزر كتم الصوت، بينما يؤدي النقر بزر الماوس الأيمن إلى عرض قائمة بأجهزة الصوت المتاحة. ما عليك سوى النقر على جهاز الصوت الذي تريد استخدامه. كما يتوفر خيار، بالنقر بزر الماوس الأيمن، لتغيير مستوى الصوت.fileيستخدمها كل جهاز. هذه الميزاتfileعادة ما توفر مستويات جودة مختلفة.
إذا تم تمكين دعم الميكروفون، سيظهر رمز الميكروفون في القائمة؛ سيؤدي النقر بزر الماوس الأيمن فوق هذا الرمز إلى إظهار خيارات القائمة الخاصة بالميكروفون، مثل تحديد جهاز الإدخال، بينما سيؤدي النقر بزر الماوس الأيسر إلى إظهار إعدادات مستوى الإدخال.
بلوتوث
لإقران جهاز بلوتوث، انقر بزر الماوس الأيسر على أيقونة البلوتوث في شريط المهام، ثم اختر "إضافة جهاز". سيبدأ النظام بعد ذلك بالبحث عن الأجهزة المتاحة، والتي يجب تفعيل وضع "الاكتشاف" لعرضها. انقر على الجهاز عند ظهوره في القائمة، وسيتم إقران الأجهزة. بعد الإقران، سيظهر جهاز الصوت في القائمة، ويمكنك تحديده بالنقر على أيقونة مكبر الصوت في شريط المهام.
سطر الأوامر
نظرًا لأن Pipe Wire يستخدم نفس واجهة برمجة التطبيقات مثل Pulse Audio، فإن غالبية أوامر Pulse Audio المستخدمة للتحكم في الصوت تعمل على Pipe Wire. pacts هي الطريقة القياسية للتحكم في Pulse Audio: اكتب man pactl في سطر الأوامر للحصول على مزيد من التفاصيل.
المتطلبات الأساسية لنظام Raspberry Pi OS Lite
عند تثبيت نظام Raspberry Pi OS بالكامل، تكون جميع تطبيقات سطر الأوامر والمكتبات المطلوبة مُثبّتة مُسبقًا. أما في الإصدار Lite، فلا يكون Pipe Wire مُثبّتًا افتراضيًا، ويجب تثبيته يدويًا لتشغيل الصوت.
لتثبيت المكتبات المطلوبة لـ Pipe Wire على Raspberry Pi OS Lite، يرجى إدخال ما يلي: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils إذا كنت تنوي تشغيل التطبيقات التي تستخدم ALSA، فستحتاج أيضًا إلى تثبيت ما يلي: sudo apt install pipewire-alsa
إن إعادة التشغيل بعد التثبيت هي الطريقة الأسهل لتشغيل كل شيء.
تشغيل الصوت السابقampليه
عرض قائمة بوحدات الصوت Pulse المثبتة في شكل مختصر (يحتوي الشكل الطويل على الكثير من المعلومات ويصعب قراءته): $ pactl list modules short عرض قائمة بوحدات الصوت Pulse المثبتة في شكل مختصر:
قائمة $ pactl تغرق قصيرة
على Raspberry Pi 5 المتصل بشاشة HDMI مع صوت مدمج وبطاقة صوت USB إضافية، يعطي هذا الأمر الناتج التالي: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz SUSPENDED 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Pipe Wire s16le 2ch 48000Hz SUSPENDED
ملحوظة
لا يحتوي Raspberry Pi 5 على مخرج تناظري.
لتثبيت Raspberry Pi OS Lite على Raspberry Pi 4 — الذي يحتوي على HDMI ومخرج تناظري — يتم إرجاع ما يلي: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipe Wire s16le 2ch 48000Hz SUSPENDED
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz SUSPENDED
لعرض وتغيير المغسلة الافتراضية إلى صوت HDMI (مع ملاحظة أنه قد يكون الافتراضي بالفعل) في هذا التثبيت من Raspberry Pi OS Lite، اكتب:
$ pactl الحصول على الحوض الافتراضي
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sink 70
$ pactl الحصول على الحوض الافتراضي
alsa_output.platform-107c701400.hdmi.hdmi-stereo
لتشغيل مرة أخرى كـampيجب أولاً تحميله إلى sampذاكرة التخزين المؤقت، في هذه الحالة، على المُستقبِل الافتراضي. يمكنك تغيير المُستقبِل بإضافة اسمه إلى نهاية ملف pactl play-s.ampالأمر le:
$ pactl upload-sampقample.mp3 sampالاسم
$pactl play-sampقampالاسم
هناك أمر Pulse Audio الذي يعد أسهل في الاستخدام لتشغيل الصوت:
$ بابلاي سample.mp3
يوفر Pactl خيارًا لضبط مستوى الصوت عند التشغيل. ولأن سطح المكتب يستخدم أدوات Pulse Audio للحصول على معلومات الصوت وضبطها، فإن تنفيذ هذه التغييرات في سطر الأوامر سينعكس أيضًا على شريط تمرير مستوى الصوت على سطح المكتب.
هذا السابقampيقلل الحجم بنسبة 10٪:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
هذا السابقampيضبط مستوى الصوت على 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
هناك العديد من أوامر Pulse Audio التي لم تُذكر هنا. webموقع (https://www.freedesktop.org/wiki/Software/PulseAudio/) وصفحات الدليل لكل أمر تقدم معلومات شاملة حول النظام.
بلوتوث
قد يكون التحكم في البلوتوث من سطر الأوامر عملية معقدة. عند استخدام Raspberry Pi OS Lite، تكون الأوامر المناسبة مُثبّتة مسبقًا. الأمر الأكثر فائدة هو bluetoothctl، وبعضها...ampيتم توفير أمثلة على استخدامه أدناه.
جعل الجهاز قابلاً للاكتشاف بواسطة الأجهزة الأخرى:
$bluetoothctl قابل للاكتشاف على
جعل الجهاز قابلاً للاقتران مع أجهزة أخرى:
$ bluetoothctl قابل للاقتران
البحث عن أجهزة بلوتوث في النطاق:
$bluetoothctl scan on
إيقاف تشغيل المسح الضوئي:
يحتوي الأمر $bluetoothctl scan off أيضًا على وضع تفاعلي، يتم استدعاؤه باستخدام الأمر بدون معلمات. المثال التالي:ampيقوم بتشغيل الوضع التفاعلي، حيث يتم إدخال أمر القائمة وإظهار النتائج، على Raspberry Pi 4 الذي يعمل بنظام Raspberry Pi OS Lite Bookworm: $ bluetoothctl
وكيل مسجل
[بلوتوث]# قائمة
وحدة التحكم D8:3A:DD:3B:00:00 Pi4Lite [افتراضي] [بلوتوث]#
يمكنك الآن كتابة الأوامر في المُفسِّر وسيتم تنفيذها. قد تكون العملية النموذجية للاقتران بجهاز، ثم الاتصال به، كما يلي: $ bluetoothctl
العميل مسجل [بلوتوث]# يمكن اكتشافه على
نجح التغيير القابل للاكتشاف
[CHG] وحدة التحكم D8:3A:DD:3B:00:00 قابلة للاكتشاف على [bluetooth]# قابلة للاقتران على
تم تغيير الاقتران بنجاح
[CHG] وحدة التحكم D8:3A:DD:3B:00:00 قابلة للاقتران [bluetooth]# المسح قيد التشغيل
< قد تكون هناك قائمة طويلة من الأجهزة في المنطقة المجاورة >
[بلوتوث]# زوج [عنوان ماك للجهاز، من أمر المسح أو من الجهاز نفسه، في شكل xx:xx:xx:xx:xx:xx] [بلوتوث]# إيقاف المسح
[بلوتوث]# اتصال [نفس عنوان ماك] يجب أن يظهر جهاز البلوتوث الآن في قائمة الأحواض، كما هو موضح في هذا المثالampمن تثبيت Raspberry Pi OS Lite:
قائمة $ pactl تغرق قصيرة
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipe Wire s16le 2ch 48000Hz SUSPENDED
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz SUSPENDED
71 bluez_output.CA_3A_B2_CA_7C_55.1 سلك أنبوب s32le 2ch 48000Hz معلق
$ pactl set-default-sink 71
بابلايampالصوتfile>
يمكنك الآن جعل هذا هو الإعداد الافتراضي وتشغيل الصوت عليه.
الاستنتاجات
هناك عدة طرق مختلفة لإنتاج مخرجات صوتية من أجهزة Raspberry Pi Ltd، تلبي معظم احتياجات المستخدمين. وقد بيّنت هذه الورقة البيضاء هذه الآليات وقدّمت معلومات حول العديد منها. ويُؤمَل أن تساعد النصائح المُقدّمة هنا المستخدم النهائي في اختيار نظام إخراج الصوت المناسب لمشروعه. مثال بسيطampتم توفير شرح لكيفية استخدام أنظمة الصوت، ولكن يجب على القارئ الرجوع إلى الأدلة وصفحات الدليل الخاصة بأوامر الصوت والبلوتوث لمزيد من التفاصيل.
Raspberry Pi هي علامة تجارية لشركة Raspberry Pi Ltd
راسبيري باي المحدودة
المستندات / الموارد
 |
حاسوب Raspberry Pi SBCS أحادي اللوحة [بي دي اف] دليل المستخدم SBCS، حاسوب ذو لوحة واحدة، حاسوب ذو لوحة واحدة، حاسوب ذو لوحة واحدة، حاسوب |