Zo maak je een YouTube-audiospeler
Muziekstreamingdiensten hebben ten opzichte van traditionele muziekdragers zoals cassettes en cd’s natuurlijk een aantal voordelen. Daarentegen hebben de grote drukknoppen, een verlicht lcd-scherm en de fysieke handeling van het verwisselen van een cd of cassettebandje zo ook wel zijn charme. In dit artikel bouwen we een Raspberry Pi om tot een retroapparaat dat de audio van YouTube-video’s kan afspelen. In plaats van cd’s of cassettebandjes gebruiken we rfid-tags om een specifieke YouTube-playlist te kiezen.
Boodschappenlijstje
Het hart van de muziekspeler wordt gevormd door een Raspberry Pi Zero W: een van de meest compacte en goedkope, maar minst krachtige telgen van de Raspberry-familie. Hij heeft gelukkig wel nog voldoende capaciteit om alles te doen wat we willen. We beginnen met het uitlezen van een rfid-tag en het afspelen van een YouTube-playlist die met die specifieke tag wordt geassocieerd. We sluiten ook een lcd-scherm aan. Hierop wordt de titel van de video en het volgnummer uit de playlist getoond. De knoppen dienen voor het starten en pauzeren van de muziek, het kiezen van de vorige en volgende track en het regelen van het geluidsvolume. Omdat een Pi Zero W geen ingebouwde speaker of audio-uitgang heeft, gebruiken we een Adafruit Speaker Bonnet: een 3watt-stereoversterker waar je kleine luidsprekers op kunt aansluiten.
Een Python-script stuurt de elektronica aan. Omdat zoveel verschillende onderdelen een complex geheel vormen, wordt elke functie en elk onderdeel eerst apart getest. Pas als het voor elk onderdeel duidelijk is hoe dit los van de rest functioneert, wordt alles samengevoegd.
Software
We gaan ervan uit dat je een geüpdatete installatie van de meest recente versie van Raspberry Pi OS hebt en dat de Raspberry Pi een werkende wifi-verbinding heeft. Let op: in dit artikel gebruiken we de Lite-versie, want een grafische interface hebben we niet nodig en vertraagt de boel in dit geval alleen maar.
Als je nog nooit eerder een sd-kaartje voor een Raspberry Pi hebt geïnstalleerd, dan verwijzen we je naar de officiële site, waar bij het helpgedeelte een duidelijke handleiding te vinden is.
Vervolgens kun je de software, inclusief kortere scriptjes om afzonderlijke onderdelen te testen, binnenhalen vanaf GitHub. Installeer eerst Git met de commandline-opdracht:
sudo apt install git
Daarna download je de benodigde bestanden met dit commando:
git clone https://github.com/ralphcrutzen/YouTube-audio-player.git
De bestanden worden nu in een map genaamd YouTube-audio-player gezet. Het is handig als ze allemaal naar de home-map worden gekopieerd, dus gebruik het volgende commando nadat de bestanden zijn gedownload:
cp YouTube-audio-player/* ~
Heb je ervaring met Git en ga je daadwerkelijk aan de slag met dit project, dan zijn pull requests natuurlijk van harte welkom!
Geluid via de Adafruit Speaker Bonnet
Voordat je de Adafruit Speaker Bonnet op de Raspberry Pi kunt prikken, zul je eerst zelf de pinnen erop moeten solderen. Eerst de dubbele rij aan de onderkant: dit is de verbinding tussen de Speaker Bonnet en de Raspberry Pi. Daarna een enkele rij aan de bovenkant: deze pinnen zorgen ervoor dat de gpio-aansluitingen van de Raspberry Pi beschikbaar komen zodat we alle onderdelen voor de muziekspeler kunnen aansluiten. Verbind ook de speakers met de Speaker Bonnet.
Als dat klusje is geklaard, is het tijd om software-ondersteuning voor I²S te installeren. De volgende commandline-opdracht downloadt daar een script voor en voert het automatisch uit:
curl -sS https://raw.githubusercontent.com/adafruit/Raspberry-Pi-Installer-Scripts/master/i2samp.sh | bash
Op de vraag Activate ‘/dev/zero’ playback in background? antwoord je met N. Daarna moet je de Raspberry Pi opnieuw opstarten en het script voor een tweede keer uitvoeren met behulp van de bovengenoemde commandline-opdracht. Je krijgt nu ook de vraag of je de speakers wilt testen, waarop je uiteraard het antwoord Y geeft.
Als je bij deze test geen geluid hoort, verwijzen we je naar de uitgebreide en duidelijke handleiding op de site van Adafruit. Daar kun je ook terecht als je het hele installatieproces nog eens in wat meer detail wilt teruglezen.
Over I²S en I²C
Zonder I²C zouden we voor het lcd-scherm 16 verbindingen nodig hebben
-
Audio van YouTube afspelen
Nu de Raspberry Pi Zero via de Speaker Bonnet geluid kan afspelen, is het tijd om een Python-script te maken waarmee we naar een YouTube-playlist kunnen luisteren. Daarvoor moet eerst een aantal Python-library’s worden geïnstalleerd: pafy, vlc en youtube-dl.
Met pafy is het mogelijk om een directe link naar de audiostream van een YouTube-video op te halen. Met vlc (dat behalve als python-library vooral bekend is als mediaspeler-software) is het mogelijk om de door pafy verkregen audiostream af te spelen, te pauzeren en het volume aan te passen. Youtube-dl stelt pafy in staat om de audio van YouTube-video’s te streamen.
Om bovenstaande software te installeren, gebruik je de volgende vijf opdrachten op de commandline:
sudo apt install python3-pip
sudo pip3 install pafy
sudo pip3 install python-vlc
sudo apt install vlc
sudo pip3 install youtube_dl
Je kunt testen of het werkt door het script met de bestandsnaam testpafyvlc.py uit te voeren:
python3 testpafyvlc.py
Het script is te stoppen via Ctrl+C. Eventueel kun je in de programmacode de url vervangen door die van een andere playlist.
Python-scripts uitvoeren
Lcd-scherm aansluiten
Het lcd-scherm is niet alleen handig om het volgnummer in de afspeellijst weer te geven, maar ook om de naam van de video en andere statusinformatie zoals het volume te tonen. Het lcd-scherm dat we gebruiken, maakt gebruik van een I²C-backpack.
Zoals je in het schema kunt zien, heb je vier kabeltjes nodig. De manier waarop je het scherm op de Pi aansluit ligt voor de hand: SDA naar SDA, SCL naar SCL, VCC naar 5V en natuurlijk ook GND naar GND. Op zowel het schermpje als de Speaker Bonnet staan deze aansluitingen duidelijk aangegeven. Het is wel aan te raden om eerst de Pi uit te schakelen met het commando sudo shutdown now en vervolgens de stroom eraf te halen wanneer je dingen gaat aansluiten.
I²C installeren
Om I²C op een Raspberry Pi te kunnen gebruiken en het lcd-scherm aan de praat te krijgen, is aanvullende software nodig. Deze download en installeer je als volgt:
git clone https://github.com/the-raspberry-pi-guy/lcd.git
cd lcd
sudo sh install.sh
Aan het einde van het installatiescript wordt de Raspberry Pi vanzelf opnieuw opgestart. Daarna installeren we met de volgende commando’s eerst ondersteuning voor I²C voor versie 3 van Python en een hulpprogramma om te testen of het scherm door de Raspberry Pi wordt herkend.
sudo apt install python3-smbus
sudo apt install i2c-tools
Voer nu het commando sudo raspi-config uit. Ga naar Interfacing Options / I2C en kies vervolgens Yes om I²C in te schakelen. Keer via Finish terug naar de commandline.
Lcd-scherm testen
Je kunt nu testen of het lcd-scherm wordt herkend met het commando:
sudo i2cdetect -y 1
In de tabel die getoond wordt, kun je het I²C-adres van het lcd-scherm aflezen, in ons geval is dat 27. Dit adres kun je ook terug vinden op regel 25 in het Python-script met de naam lcddriver.py.
Om ons testscript uit te voeren, moet je eerst twee bestanden van de lcd-directory naar de home-directory kopiëren:
cp lcd/lcddriver.py lcd/i2c_lib.py ~
Het lcd-scherm test je met het commando python3 testlcd.py, dat je in het begin van dit artikel bij GitHub hebt gedownload. Stop het script met Ctrl+C.
Als er bij het uitvoeren van het testscript geen tekst op het lcd-scherm komt te staan, kijk dan of het juiste I²C-adres in lcddriver.py staat. Ook moet je ervoor zorgen dat de bestanden lcddriver.py en i2c_lib.py in dezelfde directory als het testscript staan.
Bedieningsknoppen gebruiken
We kijken nu naar hoe je met een Python-script kunt reageren op een druk op een knop. Het voorbeeldscript heet testbutton.py en is een onderdeel van de bestanden die je eerder van GitHub hebt gedownload. Om de gpio-pinnen in een Python-script te kunnen gebruiken, moet er eerst weer een library worden geïnstalleerd:
sudo apt install python3-rpi.gpio
In het testscript gebruiken we de knop met het ingebouwde ledje als schakelaar om het lampje aan en uit te doen. De knop heeft vier aansluitingen: de + en de – voor het lampje en nog twee aansluitingen voor de knop zelf. Sluit de + van het lampje aan op GPIO4 en de – op een GND-pin. De aansluitingen van de knop komen op GPIO27 en een andere GND-pin. Bij knoppen zonder lampje werkt het script trouwens ook, want de status van de lamp wordt tevens op je monitor weergegeven.
Knoppen-jargon: debouncing en interrupts
Rfid-kaartlezer aansluiten
De rfid-lezer communiceert, net als het lcd-scherm, ook via I²C met de Raspberry Pi. Het handige van I²C is dat je meerdere apparaten op dezelfde pinnen van de Raspberry Pi kunt aansluiten. De aansluitingen die gelijk zijn, worden eerst naar één punt op een breadboard of printplaatje geleid en van daaruit gaan ze naar de Raspberry Pi toe.
Wanneer je beide onderdelen hebt aangesloten, kun je weer met de opdracht sudo i2cdetect -y 1 controleren welk I²C-adres elk apparaat heeft. Bij ons krijgt de rfid-lezer het adres 24 toegewezen. Dit adres hebben we deze keer niet nodig, omdat de software die we in de volgende stap gaan installeren dit automatisch detecteert.
Met I²C kun je meerdere apparaatjes op dezelfde pinnen aansluiten
-
Rfid-tags lezen
Om daadwerkelijk tags te kunnen lezen, hebben we natuurlijk weer een extra library nodig. Installeer deze met:
sudo pip3 install pn532pi
Met het script testrfid.py kun je voor elke tag die je tegen de lezer houdt het unieke ID zien. Noteer deze ID’s, want je hebt ze nodig in de definitieve versie van het script voor de muziekspeler.
Alle hardware samenvoegen
Wanneer je alles in een mooie behuizing (een houten schatkistje bijvoorbeeld) gaat inbouwen, wil je dat alle kabels stevig vast blijven zitten. Het is dan verstandig om geen breadboard te gebruiken, maar alles op een printplaatje te solderen. Deze kun je ook gebruiken voor de GND-aansluitingen van de vijf knoppen en het ledje. Op de foto zie je dat we eerst diverse pinnetjes op een pcb hebben gesoldeerd; hierop worden dan de kabeltjes met Dupont-stekkers aangesloten. Wanneer alles is aangesloten, is het verstandig om de testscrips voor het geluid (testpafyvlc.py), het scherm (testlcd.py), de knop (testbutton.py) en de tag-lezer (testrfid.py) nog eens uit te voeren, zodat je zeker weet dat alles ook nu nog steeds werkt. Want het belangrijkste gaat nu komen: het script dat alles bij elkaar brengt.
Het alles-in-1 Python-script
Het uiteindelijke script dat ervoor zorgt dat alle onderdelen samenwerken heet ytplayer.py. Het gaat te ver om in dit artikel alle programmode in dit bestand toe te lichten. Daarom staan er commentaarregels in de code, beginnend met een hekje #. Daarmee wordt hopelijk duidelijk genoeg uitgelegd hoe het script werkt. Ook vind je rond regel 80 de plek waar je zelf de ID’s van de rfid-tags en de links naar de bijbehorende YouTube-playlists moet invullen.
Automatisch opstarten
Om ervoor te zorgen dat het script automatisch wordt uitgevoerd zodra de Raspberry Pi is opgestart, moet je het bestand /etc/rc.local bewerken. Gebruik een teksteditor (nano bijvoorbeeld) om dit bestand te doen:
sudo nano /etc/rc.local
Voeg daarna de volgende regel toe aan het einde, maar let er op dat je exit 0 op de allerlaatste regel laat staan.
python3 /home/pi/ytplayer.py &
De ampersand (&) op het einde is belangrijk, want deze zorgt ervoor dat het programma gelijktijdig met de overige opstartprocessen wordt uitgevoerd. Wanneer je dit teken weg laat, zal de Pi niet volledig opstarten.
Gebruik Ctrl+X, dan Y en dan Enter om het bestand op te slaan, en vervolgens sudo reboot om de Pi opnieuw op te starten om te testen of het werkt.
Tot slot
Het is niet lastig om elk onderdeel los van de rest werkend te krijgen, want er zijn veel duidelijke handleidingen op internet te vinden. Maar op het moment dat je meerdere onderdelen wil laten samenwerken, ben je vaak op je eigen creativiteit en vindingrijkheid aangewezen om oplossingen voor problemen te vinden. Vaak lukt dat, maar helaas niet altijd. Het is bijvoorbeeld niet gelukt om te achterhalen waarom het lcd-scherm soms vreemde tekens vertoont. En bij het afspelen van een track zijn de eerste paar seconden nog wat haperingen in het geluid te horen. Maar omdat alle programmacode op GitHub beschikbaar is, zouden die problemen op het moment dat je dit leest misschien al lang door iemand opgelost kunnen zijn.