Белая кніга, якая дае
Высокі ўзровень вышэйview аўдыё
Варыянты SBC на Raspberry Pi
Кампанія Raspberry Pi Ltd
Калафон
© 2022-2025 Raspberry Pi Ltd
Гэтая дакументацыя распаўсюджваецца па ліцэнзіі Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Версія 1.0
Дата зборкі: 28.05.2025
Юрыдычная адмова ад адказнасці
ТЭХНІЧНЫЯ ДАДЗЕНЫЯ І ДАДЗЕНЫЯ НАД НАДЗЕЙНАСЦІ ДЛЯ ПРАДУКЦЫІ RASPBERRY PI (УКЛЮЧАЮЦЬ ТАБЛІЦЫ ДАННЫХ), ПРА ЧАС АД ЧАСУ (“РЭСУРСЫ”) ПРАДСТАЎЛЯЮЦЦА RASPBERRY PI LTD (“RPL”) “ЯК ЁСЦЬ” І ЛЮБЫЯ ЯВНЫЯ АБО РАЗУМЕВАНЫЯ ГАРАНТЫІ, УКЛЮЧАЮЧЫ, АЛЕ НЕ АБМЕЖУВАЮЧЫСЯ. ДА, АДМОВА ДАЕЦЦА ГАРАНТЫІ ТАВАРЫЧНАСЦІ І ПРЫДАТНАСЦІ ДЛЯ ПЭЙНЫХ МЭТ. У МАКСІМАЛЬНАЙ СТУПЕНІ, ДАЗВОЛЕНАЙ ДЫЮЧЫМ ЗАКАНАДАЎСТВАМ, RPL НЕ НЕСЕ АДКАЗНАСЦІ ЗА ЛЮБЫЯ ПРАМЫЯ, УСКОСНЫЯ, ВЫПАДКОВЫЯ, СПЕЦЫЯЛЬНЫЯ, УЗОРЫ АБО Ўскосныя ШКОДЫ (УКЛЮЧАЮЧЫ, АЛЕ НЕ АБМЯЖУЮЧЫСЯ, НАКУПКУ ЗАМЕННЫХ ТАВАРАЎ АБО ПЭ ПАСЛУГІ; СТРАТА ВЫКАРЫСТАННЯ, ДАДЗЕНЫХ , АБО ПРЫБЫТКІ; АБО ПЕРЫВАННЕ БІЗНЭСУ) НЕЗАЛЕЖНА ПРЫЧЫНЕНЫМ І ЛЮБЫМ ТЭОРЫЯМ АДКАЗНАСЦІ, ПА ДАМОВЕ ДАГАВОРУ, СТВОГАЙ АДКАЗНАСЦІ АБО ПРАВАПАРУШЭННЯ (УКЛЮЧАЮЧЫ НАБЛАЖНАСЦЬ ЦІ ІНШЫМ ШЛЯХАМ), ЯКІЯ Ўзніклі ЛЮБЫМ ШЛЯХАМ ВЫКАРЫСТАННЯ РЭСУРСАЎ, НАВАТ КАЛІ ПАВЕДАМЛЕНЫ АБ МАГЧЫМАСЦІ ITY ТАКОЙ ШКОДЫ.
RPL пакідае за сабой права ў любы час і без дадатковага паведамлення ўносіць любыя паляпшэнні, паляпшэнні, выпраўленні або любыя іншыя мадыфікацыі ў РЭСУРСЫ або любыя прадукты, апісаныя ў іх.
РЭСУРСЫ прызначаны для кваліфікаваных карыстальнікаў з адпаведным узроўнем ведаў у галіне праектавання. Карыстальнікі нясуць выключную адказнасць за свой выбар і выкарыстанне РЭСУРСАЎ і любое прымяненне прадуктаў, апісаных у іх. Карыстальнік згаджаецца кампенсаваць і абараняць RPL ад любой адказнасці, выдаткаў, шкоды або іншых страт, якія ўзнікаюць у выніку выкарыстання РЭСУРСАЎ. RPL дае карыстальнікам дазвол выкарыстоўваць РЭСУРСЫ выключна ў спалучэнні з прадуктамі Raspberry Pi. Любое іншае выкарыстанне РЭСУРСАЎ забаронена. Ліцэнзія на якія-небудзь іншыя правы інтэлектуальнай уласнасці RPL або іншыя правы трэціх асоб не прадастаўляецца.
ДЗЕЙНАСЦЬ З ВЫСОКАЙ РЫЗЫКАЙ. Прадукты Raspberry Pi не распрацаваны, не выраблены і не прызначаны для выкарыстання ў небяспечных асяроддзях, якія патрабуюць надзейнай працы, напрыклад, пры эксплуатацыі ядзерных установак, у сістэмах навігацыі або сувязі самалётаў, у сістэмах кіравання паветраным рухам, сістэмах узбраення або крытычна важных для бяспекі прыкладанняў (у тым ліку сістэмах жыццезабеспячэння і іншых медыцынскіх прыладах), у якіх адмова прадуктаў можа прывесці непасрэдна да смерці, траўмаў або сур'ёзнай фізічнай шкоды або шкоды навакольнаму асяроддзю («Дзейнасць з высокай рызыкай»). RPL адмаўляецца ад любых відавочных або ўскосных гарантый прыдатнасці для дзейнасці з высокай рызыкай і не нясе адказнасці за выкарыстанне або ўключэнне прадуктаў Raspberry Pi ў дзейнасць з высокай рызыкай. Прадукты Raspberry Pi прадастаўляюцца ў адпаведнасці з RPL. Стандартныя ўмовыПрадастаўленне RPL РЭСУРСАЎ не пашырае і не змяняе RPL Стандартныя ўмовы у тым ліку, але не абмяжоўваючыся адмовай ад адказнасці і гарантыямі, выкладзенымі ў іх.
Гісторыя версій дакумента
| Вызваленне | Дата | Апісанне |
| 1 | 1 красавіка 25 г | Першапачатковы выпуск |
Вобласць дзеяння дакумента
Гэты дакумент адносіцца да наступных прадуктаў Raspberry Pi:
| PI 0 | PI 1 | Пі 2 | Пі 3 | Пі 4 | Пі 400 | Пі 5 | Пі 500 | CM1 | CM3 | CM4 | CM5 | Піка | Піка2 | ||||
| 0 | W | H | A | B | A | B | B | Усе | Усе | Усе | Усе | Усе | Усе | Усе | Усе | Усе | Усе |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Уводзіны
З гадамі варыянты вываду гуку на аднаплатных камп'ютарах Raspberry Pi (SBC) сталі больш шматлікімі, а спосаб іх кіравання праграмным забеспячэннем змяніўся.
У гэтым дакуменце будуць разгледжаны многія даступныя варыянты вываду гуку на вашай прыладзе Raspberry Pi і прадастаўлены інструкцыі па выкарыстанні параметраў гуку з працоўнага стала і каманднага радка.
У гэтым дакуменце мяркуецца, што прылада Raspberry Pi працуе пад кіраваннем аперацыйнай сістэмы Raspberry Pi і цалкам абноўлена да апошняй версіі прашыўкі і ядраў.
Аўдыёабсталяванне Raspberry Pi
HDMI
Усе SBC Raspberry Pi маюць раз'ём HDMI, які падтрымлівае аўдыё HDMI. Падключэнне Raspberry Pi SBC да манітора або тэлевізара з дынамікамі аўтаматычна ўключыць вывад аўдыё HDMI праз гэтыя дынамікі. Аўдыё HDMI — гэта высакаякасны лічбавы сігнал, таму вынікі могуць быць вельмі добрымі, і падтрымліваецца шматканальнае аўдыё, такое як DTS.
Калі вы выкарыстоўваеце відэа HDMI, але хочаце, каб аўдыёсігнал быў раздзелены, напрыкладampле, да ampаўдыёсігнал, які не падтрымлівае ўваход HDMI, — тады вам спатрэбіцца дадатковае абсталяванне, якое называецца разветвальнікам, каб аддзяліць аўдыёсігнал ад сігналу HDMI. Гэта можа быць дорага, але ёсць і іншыя варыянты, якія апісаны ніжэй.
Аналагавы раз'ём PCM/3.5 мм
Мадэлі Raspberry Pi B+, 2, 3 і 4 маюць 4-кантактны аўдыёраздым 3.5 мм, які можа падтрымліваць аўдыё- і кампазітныя відэасігналы. Гэта нізкаякасны аналагавы выхад, які генеруецца з сігналу PCM (імпульсна-кодавай мадуляцыі), але ён усё яшчэ падыходзіць для навушнікаў і настольных дынамікаў.
УВАГА
На Raspberry Pi 5 няма аналагавага аўдыёвыхаду.
Сігналы раз'ёмаў вызначаны ў наступнай табліцы, пачынаючы ад канца кабеля і заканчваючы яго наканечнікам. Кабелі выпускаюцца з рознымі прызначэннямі, таму пераканайцеся, што ў вас правільнае прызначэнне.
| Сегмент Джэка | Сігнал |
| Рукаў | Відэа |
| Кольца 2 | зямля |
| Кольца 1 | правільна |
| Парада | налева |
Платы адаптараў на базе I2S
Усе мадэлі SBC Raspberry Pi маюць перыферыйную прыладу I2S, даступную на раздыме GPIO. I2S — гэта стандарт электрычнага інтэрфейсу паслядоўнай шыны, які выкарыстоўваецца для падлучэння лічбавых аўдыёпрылад і перадачы аўдыёдадзеных PCM паміж перыферыйнымі прыладамі ў электроннай прыладзе. Raspberry Pi Ltd вырабляе шэраг аўдыёплат, якія падключаюцца да раздыма GPIO і выкарыстоўваюць інтэрфейс I2S для перадачы аўдыёдадзеных з SoC (сістэмы на чыпе) на дадатковую плату.
Заўвага: Дадатковыя платы, якія падключаюцца праз раз'ём GPIO і адпавядаюць адпаведным спецыфікацыям, вядомыя як HAT (Hardware Attached on Top - абсталяванне, прымацаванае зверху). Іх характарыстыкі можна знайсці тут: https://datasheets.raspberrypi.com/
Поўны асартымент аўдыё HAT можна ўбачыць на Raspberry Pi Ltd webсайт: https://www.raspberrypi.com/products/
Для вываду гуку таксама даступная вялікая колькасць HAT іншых вытворцаў, напрыкладampад Pimoroni, HiFiBerry, Adafruit і г.д., і яны прапануюць мноства розных функцый.
USB аўдыё
Калі няма магчымасці ўсталяваць HAT, або вы шукаеце хуткі і просты спосаб падключыць раз'ём для выхаду навушнікаў або ўваходу для мікрафона, то добрым выбарам будзе аўдыёадаптар USB. Гэта простыя і недарагія прылады, якія падключаюцца да аднаго з партоў USB-A на Raspberry Pi SBC.
Аперацыйная сістэма Raspberry Pi па змаўчанні ўключае драйверы для USB-аўдыё; як толькі прылада падключана, яна павінна з'явіцца ў меню прылад, якое з'яўляецца пры пстрычцы правай кнопкай мышы на значку дынаміка на панэлі задач.
Сістэма таксама аўтаматычна вызначыць, ці мае падключаная прылада USB уваход для мікрафона, і ўключыць адпаведную падтрымку.
Bluetooth
Bluetooth-аўдыё — гэта бесправадная перадача гукавых дадзеных праз тэхналогію Bluetooth, якая вельмі шырока выкарыстоўваецца. Яна дазваляе Raspberry Pi SBC мець зносіны з Bluetooth-дынамікамі і навушнікамі/ўкладышамі або любой іншай аўдыёпрыладай з падтрымкай Bluetooth. Дыяпазон даволі кароткі — максімум каля 10 м.
Прылады Bluetooth неабходна «спалучыць» з Raspberry Pi SBC, і пасля гэтага яны з'явяцца ў наладах гуку на працоўным стале. Bluetooth усталяваны па змаўчанні ў Raspberry Pi OS, а лагатып Bluetooth з'яўляецца на панэлі задач на працоўным стале на ўсіх прыладах, на якіх усталявана абсталяванне Bluetooth (убудаванае або праз USB-адаптар Bluetooth). Калі Bluetooth уключаны, значок будзе сінім; калі ён выключаны, значок будзе шэрым.
Праграмная падтрымка
Базавае праграмнае забеспячэнне для падтрымкі гуку значна змянілася ў поўным вобразе Raspberry Pi OS, і для канечнага карыстальніка гэтыя змены ў асноўным зразумелыя. Першапачаткова выкарыстоўвалася гукавая падсістэма ALSA. Pulse Audio змяніла ALSA, перш чым была заменена цяперашняй сістэмай пад назвай Pipe Wire. Гэтая сістэма мае тую ж функцыянальнасць, што і Pulse Audio, і сумяшчальны API, але яна таксама мае пашырэнні для апрацоўкі відэа і іншых функцый, што значна спрашчае інтэграцыю відэа і аўдыё. Паколькі Pipe Wire выкарыстоўвае той жа API, што і Pulse Audio, утыліты Pulse Audio добра працуюць у сістэме Pipe Wire.
Гэтыя ўтыліты выкарыстоўваюцца ў былымampніжэй.
Каб паменшыць памер выявы, Raspberry Pi OS Lite усё яшчэ выкарыстоўвае ALSA для падтрымкі гуку і не ўключае ніякіх аўдыёбібліятэк Pipe Wire, Pulse Audio або Bluetooth. Аднак можна ўсталяваць адпаведныя бібліятэкі, каб дадаць гэтыя функцыі па меры неабходнасці, і гэты працэс таксама апісаны ніжэй.
Працоўны стол
Як ужо згадвалася вышэй, кіраванне гукам ажыццяўляецца з дапамогай значка дынаміка на панэлі задач працоўнага стала. Клік левай кнопкай мышы на значку адкрывае паўзунок гучнасці і кнопку адключэння гуку, а клік правай кнопкай мышы адкрывае спіс даступных аўдыёпрылад. Проста націсніце на аўдыёпрыладу, якую вы хочаце выкарыстоўваць. Таксама ёсць магчымасць змяніць налады, клікнуўшы правай кнопкай мышы.fileвыкарыстоўваецца кожнай прыладай. Гэтыя прафесіяналыfileзвычайна забяспечваюць розныя ўзроўні якасці.
Калі падтрымка мікрафона ўключана, у меню з'явіцца значок мікрафона; клік правай кнопкай мышы на ім адкрые спецыфічныя для мікрафона параметры меню, такія як выбар прылады ўводу, а клік левай кнопкай мышы адкрые налады ўзроўню ўваходнага гуку.
Bluetooth
Каб падключыць прыладу Bluetooth, пстрыкніце левай кнопкай мышы на значку Bluetooth на панэлі задач, а затым выберыце «Дадаць прыладу». Пасля гэтага сістэма пачне пошук даступных прылад, якія трэба будзе перавесці ў рэжым «Выяўленне», каб яны з'явіліся. Націсніце на прыладу, калі яна з'явіцца ў спісе, і прылады павінны падключыцца. Пасля падключэння аўдыёпрылада з'явіцца ў меню, якое можна выбраць, націснуўшы на значок дынаміка на панэлі задач.
Камандны радок
Паколькі Pipe Wire выкарыстоўвае той жа API, што і 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 Audio ў кароткай форме:
Спіс $ pactl апускаецца ніжэй
На Raspberry Pi 5, падлучаным да манітора HDMI з убудаваным аўдыё і дадатковай гукавой картай USB, гэтая каманда дае наступны вынік: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Трубаправодны провад s32le 2ch 48000Hz ПРЫПЫНЕНЫ 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Трубаправодны провад s16le 2ch 48000Hz ПРЫПЫНЕНЫ
УВАГА
Raspberry Pi 5 не мае аналагавага выхаду.
Для ўсталёўкі Raspberry Pi OS Lite на Raspberry Pi 4, які мае HDMI і аналагавы выхад, вяртаецца наступнае: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Трубаправодны провад s16le 2ch 48000Hz ПРЫВІСНА
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Трубаправодны провад s32le 2ch 48000Hz ПАДВЕСНЫ
Каб адлюстраваць і змяніць прыёмнік па змаўчанні на аўдыё HDMI (звярніце ўвагу, што ён ужо можа быць усталяваны па змаўчанні) у гэтай усталёўцы Raspberry Pi OS Lite, увядзіце:
$ pactl get-default-sink
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sink 70
$ pactl get-default-sink
alsa_output.platform-107c701400.hdmi.hdmi-стэрэа
Каб прайграць якampспачатку яго трэба загрузіць на sampкэш le, у дадзеным выпадку на прыёмніку па змаўчанні. Вы можаце змяніць прыёмнік, дадаўшы яго назву ў канец pactl play-sampкаманда:
$ pactl upload-sampsample.mp3 sampімя карыстальніка
$ pactl play-sampsampімя карыстальніка
Існуе каманда Pulse Audio, якую яшчэ прасцей выкарыстоўваць для прайгравання аўдыё:
$ paplay sampле.mp3
У камандзе pactl ёсць опцыя для ўсталёўкі гучнасці прайгравання. Паколькі працоўны стол выкарыстоўвае ўтыліты Pulse Audio для атрымання і ўсталёўкі аўдыёінфармацыі, выкананне гэтых змяненняў каманднага радка таксама будзе адлюстравана ў паўзунку гучнасці на працоўным стале.
Гэты былыampпамяншае гучнасць на 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Гэты былыample ўстанаўлівае гучнасць на 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Існуе мноства каманд Pulse Audio, якія тут не згадваюцца. Pulse Audio webсайт (https://www.freedesktop.org/wiki/Software/PulseAudio/) і старонкі кіраўніцтва для кожнай каманды прапануюць падрабязную інфармацыю пра сістэму.
Bluetooth
Кіраванне Bluetooth з каманднага радка можа быць складаным працэсам. Пры выкарыстанні Raspberry Pi OS Lite адпаведныя каманды ўжо ўсталяваныя. Найбольш карыснай камандай з'яўляецца bluetoothctl, а некаторыя...ampніжэй прыведзены прыклады яго выкарыстання.
Зрабіце прыладу бачнай для іншых прылад:
$ bluetoothctl бачны на
Зрабіце прыладу спалучанай з іншымі прыладамі:
$ bluetoothctl спалучаецца ўключана
Пошук прылад Bluetooth у зоне дзеяння:
$ сканаванне bluetoothctl уключана
Адключыць сканаванне:
$ bluetoothctl scan off bluetoothctl таксама мае інтэрактыўны рэжым, які выклікаецца з дапамогай каманды без параметраў. Наступны прыкладampКаманда le запускае інтэрактыўны рэжым на Raspberry Pi 4 пад кіраваннем Raspberry Pi OS Lite Bookworm, дзе ўводзіцца каманда list і адлюстроўваюцца вынікі: $ bluetoothctl
Агент зарэгістраваны
спіс [bluetooth]#
Кантролер D8:3A:DD:3B:00:00 Pi4Lite [па змаўчанні] [bluetooth]#
Цяпер вы можаце ўводзіць каманды ў інтэрпрэтатар, і яны будуць выкананы. Тыповы працэс спалучэння і падключэння да прылады можа выглядаць наступным чынам: $ bluetoothctl
Агент зарэгістраваны [bluetooth]# бачны на
Выяўленае змяненне на паспяхова
[CHG] Кантролер D8:3A:DD:3B:00:00 Бачны па [bluetooth]# спалучаецца
Змена пары на ўдалася
[CHG] Кантролер D8:3A:DD:3B:00:00 Спалучэнне на [bluetooth]# сканаванне ўключана
<магчыма, гэта доўгі спіс прылад паблізу>
[bluetooth]# пара [MAC-адрас прылады, з каманды сканавання або з самой прылады, у выглядзе xx:xx:xx:xx:xx:xx] [bluetooth]# сканаванне выключана
[bluetooth]# падключыць [той жа MAC-адрас] Прылада Bluetooth цяпер павінна з'явіцца ў спісе прыёмнікаў, як паказана ў гэтым прыкладзеampфайл з усталёўкі Raspberry Pi OS Lite:
Спіс $ pactl апускаецца ніжэй
69 alsa_output.platform-bcm2835_audio.stereo-fallback Трубаправодны провад s16le 2ch 48000Hz ПРЫВІСНА
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Трубаправодны провад s32le 2ch 48000Hz ПАДВЕСНЫ
71 bluez_output.CA_3A_B2_CA_7C_55.1 Трубаправодны провад s32le 2ch 48000Hz ПРЫВІСНА
$ pactl set-default-sink 71
$ paplayample_audio_file>
Цяпер вы можаце зрабіць гэта наладай па змаўчанні і прайграваць аўдыё праз яе.
Высновы
Існуе мноства розных спосабаў атрымання гукавога вываду з прылад Raspberry Pi Ltd, якія задавальняюць патрабаванні пераважнай большасці карыстальнікаў. У гэтым дакуменце апісаны гэтыя механізмы і прадстаўлена інфармацыя пра многія з іх. Спадзяемся, што парады, прадстаўленыя тут, дапамогуць канчатковаму карыстальніку выбраць правільную схему гукавога вываду для свайго праекта. Просты прыкладampІнструкцыі па выкарыстанні аўдыёсістэм прадстаўлены, але чытачу варта звярнуцца да кіраўніцтваў і старонак кіраўніцтва па аўдыё і Bluetooth-камандах для атрымання больш падрабязнай інфармацыі.
Raspberry Pi з'яўляецца гандлёвай маркай Raspberry Pi Ltd
Кампанія Raspberry Pi Ltd
Дакументы / Рэсурсы
 |
Аднаплатны камп'ютар Raspberry Pi SBCS [pdfКіраўніцтва карыстальніка Аднаплатны камп'ютар SBCS, SBCS, аднаплатны камп'ютар, бартавы камп'ютар, камп'ютар |