{"id":774,"date":"2021-04-08T14:26:05","date_gmt":"2021-04-08T14:26:05","guid":{"rendered":"https:\/\/picockpit.com\/raspberry-pi\/?p=774"},"modified":"2023-11-23T02:13:08","modified_gmt":"2023-11-23T02:13:08","slug":"c-extension-for-micropython-on-raspberry-pi-pico","status":"publish","type":"post","link":"https:\/\/picockpit.com\/raspberry-pi\/nl\/c-extensie-voor-micropython-op-raspberry-pi-pico\/","title":{"rendered":"C uitbreiding voor MicroPython op Raspberry Pi Pico"},"content":{"rendered":"

Dit is een gids over hoe een basis C uitbreiding voor MicroPython te schrijven en te draaien op de Raspberry Pi Pico. Ik zal de redenen voor het uitbreiden van MicroPython behandelen, hoe de uitbreidingsmodule te schrijven, hoe het te compileren en hoe het te installeren op de Pico. Als u meer wilt lezen over dit onderwerp, raadpleeg dan https:\/\/docs.micropython.org\/en\/latest\/develop\/extendingmicropython.html<\/a><\/p>\n\n\n\n

Inleiding<\/h2>\n

Waarom MicroPython uitbreiden?<\/h3>\n

Er kunnen meerdere redenen zijn waarom u MicroPython zou willen uitbreiden. Omdat het een afgeslankte versie van Python is, presteert MicroPython niet erg goed als het aankomt op rekenkundig zware taken (vergelijkbaar met Python). C daarentegen is zeer geschikt voor dergelijke taken. Een C extensie voor Micropython maakt het mogelijk om die berekeningen in de C taal uit te voeren en de resultaten in MicroPython te gebruiken. Dit kan sommige processen met een orde van grootte versnellen.<\/p>\n

Een tweede reden kan zijn, dat u hardware die een C API gebruikt vanuit MicroPython wilt koppelen. <\/p>\n

Soorten MicroPython C-uitbreidingen<\/h3>\n

Er zijn verschillende manieren om MicroPython uit te breiden: externe C modules en native machine code in .mpy bestanden.<\/p>\n

Om een externe C-module te kunnen gebruiken, moet u deze hercompileren in de MicroPython firmware. Dit is een nogal gecompliceerd proces, daarom zal deze gids zich richten op het tweede alternatief. Als u echter ge\u00efnteresseerd bent in deze aanpak, kunt u er meer over lezen op deze webpagina's:                https:\/\/docs.micropython.org\/en\/latest\/develop\/cmodules.html<\/a>                      https:\/\/www.raspberrypi.org\/forums\/viewtopic.php?t=300352<\/a><\/p>\n

De .mpy is een bestand dat gecompileerde native machine code opslaat en dynamisch kan worden gelinkt. Dit maakt het veel flexibeler omdat je niet de hele MicroPython firmware hoeft te hercompileren.<\/p>\n\n\n\n

Schrijf de uitbreidingsmodule<\/h2>\n\n\n\n

Het schrijven van de uitbreidingsmodule is het gemakkelijkste deel van het uitbreiden van MicroPython. Ik zal je laten zien hoe je dat doet aan de hand van een eenvoudig voorbeeld. Om te beginnen maken we een nieuwe directory aan genaamd factfib<\/em>. Open een nieuw terminalvenster, cd naar de nieuwe map en maak een nieuw bestand met de naam factfib.c<\/em>. Als je de directory op een Raspberry Pi onder Dekstop hebt aangemaakt, ziet het commando er als volgt uit.<\/p>\n\n\n\n

<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
cd<\/span> <\/span>~\/<\/span>Desktop<\/span>\/<\/span>factfib<\/span><\/span>\n<\/span>\ntouch<\/span> <\/span>factfib<\/span>.<\/span>c<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Open factfib.c<\/em><\/span> in je favoriete teksteditor en voer de volgende code in:<\/span><\/span><\/span><\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
#<\/span>include<\/span> <\/span>"<\/span>py\/dynruntime.<\/span>h<\/span><\/span>\n<\/span>\nSTATIC<\/span> <\/span>mp_int_t<\/span> <\/span>factorial_helper<\/span>(<\/span>mp_int_t<\/span> <\/span>x<\/span>) <\/span>{<\/span><\/span>\n   <\/span>if<\/span> (<\/span>x<\/span> <\/span><<\/span> <\/span>1<\/span>) <\/span>{<\/span><\/span>\n      <\/span>return<\/span> <\/span>1<\/span>;<\/span><\/span>\n   <\/span>}<\/span><\/span>\n   <\/span>return<\/span> <\/span>x<\/span>*<\/span>factorial_helper<\/span>(<\/span>x<\/span>-<\/span>1<\/span>)<\/span>;<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nSTATIC<\/span> <\/span>mp_obj_t<\/span> <\/span>factorial<\/span>(<\/span>mp_obj_t<\/span> <\/span>x_obj<\/span>) <\/span>{<\/span><\/span>\n   <\/span>mp_int_t<\/span> <\/span>x<\/span> <\/span>=<\/span> <\/span>mp_obj_get_int<\/span>(<\/span>x_obj<\/span>)<\/span>;<\/span><\/span>\n   <\/span>mp_int_t<\/span> <\/span>rslt<\/span> <\/span>=<\/span> <\/span>factorial_helper<\/span>(<\/span>x<\/span>)<\/span>;<\/span><\/span>\n   <\/span>return<\/span> <\/span>rslt<\/span>;<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nSTATIC<\/span> <\/span>MP_DEFINE_CONST_FUN_OBJ_1<\/span>(<\/span>factorial_obj<\/span>,<\/span> <\/span>factorial<\/span>)<\/span>;<\/span><\/span>\n<\/span>\nSTATIC<\/span> <\/span>mp_int_t<\/span> <\/span>fibonacci_helper<\/span>(<\/span>mp_int_t<\/span> <\/span>x<\/span>) <\/span>{<\/span><\/span>\n   <\/span>if<\/span> (<\/span>x<\/span> <\/span><=<\/span> <\/span>0<\/span>) <\/span>{<\/span><\/span>\n      <\/span>return<\/span> <\/span>0<\/span>;<\/span><\/span>\n   <\/span>}<\/span><\/span>\n   <\/span>else<\/span> <\/span>if<\/span> (<\/span>x<\/span> <\/span>==<\/span> <\/span>1<\/span>) <\/span>{<\/span><\/span>\n      <\/span>return<\/span> <\/span>1<\/span>;<\/span><\/span>\n   <\/span>}<\/span><\/span>\n   <\/span>else<\/span> <\/span>{<\/span><\/span>\n      <\/span>return<\/span> (<\/span>fibonacci_helper<\/span>(<\/span>x<\/span>-<\/span>1<\/span>) <\/span>+<\/span> <\/span>fibonacci_helper<\/span>(<\/span>x<\/span>-<\/span>2<\/span>))<\/span>;<\/span><\/span>\n   <\/span>}<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nSTATIC<\/span> <\/span>mp_obj_t<\/span> <\/span>fibonacci<\/span>(<\/span>mp_obj_t<\/span> <\/span>x_obj<\/span>) <\/span>{<\/span><\/span>\n   <\/span>mp_int_t<\/span> <\/span>x<\/span> <\/span>=<\/span> <\/span>mp_obj_get_int<\/span>(<\/span>x_obj<\/span>)<\/span>;<\/span><\/span>\n   <\/span>mp_int_t<\/span> <\/span>rslt<\/span> <\/span>=<\/span> <\/span>fibonacci_helper<\/span>(<\/span>x<\/span>)<\/span>;<\/span><\/span>\n   <\/span>return<\/span> <\/span>mp_obj_new_int<\/span>(<\/span>rslt<\/span>)<\/span>;<\/span><\/span>\n}<\/span><\/span>\n<\/span>\nSTATIC<\/span> <\/span>MP_DEFINE_CONST_FUN_OBJ_1<\/span>(<\/span>fibonacci_obj<\/span>,<\/span> <\/span>fibonacci<\/span>)<\/span>;<\/span><\/span>\n<\/span>\nmp_obj_t<\/span> <\/span>mpy_init<\/span>(<\/span>mp_obj_fun_bc_t<\/span> <\/span>*<\/span>self<\/span>,<\/span> <\/span>size_t<\/span> <\/span>n_args<\/span>,<\/span> <\/span>size_t<\/span> <\/span>n_kw<\/span>,<\/span> <\/span>mp_obj_t<\/span> <\/span>*<\/span>args<\/span>) <\/span>{<\/span><\/span>\n   <\/span>MP_DYNRUNTIME_INIT_ENTRY<\/span><\/span>\n<\/span>\n   <\/span>mp_store_global<\/span>(<\/span>MP_QSTR_factorial<\/span>,<\/span> <\/span>MP_OBJ_FROM_PTR<\/span>(<\/span>&<\/span>factorial_obj<\/span>))<\/span>;<\/span><\/span>\n   <\/span>mp_store_global<\/span>(<\/span>MP_QSTR_fibonacci<\/span>,<\/span> <\/span>MP_OBJ_FROM_PTR<\/span>(<\/span>&<\/span>fibonacci_obj<\/span>))<\/span>;<\/span><\/span>\n<\/span>\n   <\/span>MP_DYNRUNTIME_INIT_EXIT<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Laat me de code hierboven uitleggen: In MicroPython en Python, is elke variabele een object. Daarom stellen we ze in C voor als mp_obj_t<\/em>. Maar een C programma kan alleen werken met C type variabelen, daarom moeten we het object omzetten in een C type. Dit heet Marshalling en MicroPython biedt functies om elk C type uit een object te halen.<\/p>\n\n\n\n
Bouw de uitbreiding<\/h2>\n\n\n\n
We bouwen de extensie in een .mpy bestand met behulp van een Makefile. Maar we moeten eerst een paar dingen instellen. Zorg ervoor dat je terminal nog steeds geopend is in de factfib<\/em> map. Kloon dan de MicroPython GitHub repository.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>apt<\/span>-<\/span>get<\/span> <\/span>install<\/span> <\/span>build<\/span>-<\/span>essential<\/span> <\/span>libreadline<\/span>-<\/span>dev<\/span> <\/span>libffi<\/span>-<\/span>dev<\/span> <\/span>git<\/span> <\/span>pkg<\/span>-<\/span>config<\/span> <\/span>gcc<\/span>-<\/span>arm<\/span>-<\/span>none<\/span>-<\/span>eabi<\/span> <\/span>libnewlib<\/span>-<\/span>arm<\/span>-<\/span>none<\/span>-<\/span>eabi<\/span><\/span>\n<\/span>\ngit<\/span> <\/span>clone<\/span> <\/span>--<\/span>recurse<\/span>-<\/span>submodules<\/span>\u00a0https<\/span>:<\/span>\/\/github.com\/micropython\/micropython.git<\/span><\/span>\n<\/span>\npip3<\/span>\u00a0<\/span>install<\/span>\u00a0<\/span>'<\/span>pyelftools>=0.25<\/span>'<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Deze installaties zullen een tijdje duren, als je tijd wilt besparen en je weet wat je doet, hoef je alleen maar de \/py en \/tools directory van de micropython repository te clonen en ze in een micropython<\/em> map in de factfib<\/em> map (sla het tweede commando over).<\/p>\n\n\n\n
Terwijl de installatie loopt, kunnen we de tijd gebruiken om de Makefile te schrijven. Voer gewoon<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
touch<\/span> <\/span>Makefile<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
en open het nieuw aangemaakte bestand in een tekstverwerker.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
MPY_DIR<\/span> <\/span>=<\/span> <\/span>micropython<\/span><\/span>\n<\/span>\nMOD<\/span> <\/span>=<\/span> <\/span>factfib<\/span><\/span>\n<\/span>\nSRC<\/span> <\/span>=<\/span> <\/span>factfib<\/span>.<\/span>c<\/span><\/span>\n<\/span>\nARCH<\/span> <\/span>=<\/span> <\/span>armv7m<\/span><\/span>\n<\/span>\ninclude<\/span> <\/span>$<\/span>(<\/span>MPY_DIR<\/span>)<\/span>\/<\/span>py<\/span>\/<\/span>dynruntime<\/span>.<\/span>mk<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Je hebt misschien gemerkt dat we de ARCH <\/em>variabele naar armv7m<\/em> hoewel de pico armv6m<\/em>. We moeten dit doen omdat de armv6m<\/em> architectuur wordt (op het moment dat ik dit artikel schrijf) niet ondersteund door de dynruntime.mk<\/em> gereedschap.<\/p>\n\n\n\n
Maar gelukkig kunnen we nog steeds een werkende uitbreiding compileren voor de Pico. We hoeven alleen maar de dynruntime.mk <\/em>bestand, dat zich moet bevinden onder micropython\/py\/dynruntime.mk. <\/em>Open het en zoek onder Architectuur configuratie in armv7m naar de CFLAGS variabele (zou regel 64 moeten zijn). Verander -mcpu=cortex-m3<\/em> naar -mcpu=cortex-m0<\/em> en sla het bestand op.<\/p>\n\n\n
\n
\"chnge<\/figure>\n<\/div>\n\n\n
Dan nadat alles ge\u00efnstalleerd is, voer<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
make<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
en de factfib.mpy<\/em> bestand zal worden aangemaakt.<\/p>\n\n\n\n
Installeer en test de uitbreiding<\/h2>\n\n\n\n
De laatste stap is installeren en testen. Hiervoor maken we gebruik van het bestandssysteem dat Micropython aanmaakt op de Raspberry Pi Pico. Eerst moeten we de Pico flashen met de MicroPython firmware. De eenvoudigste manier om dit te doen is door de Thonny IDE te gebruiken (voorge\u00efnstalleerd op Raspbian\/Raspberry Pi OS).<\/p>\n\n\n\n
Als u geen Raspberry Pi gebruikt om uw Pico te programmeren of als u MicroPython nog nooit op de Pico hebt gebruikt, raadpleeg dan de handleiding \"Aan de slag met MicroPython\" van Raspberry Pi https:\/\/www.raspberrypi.org\/documentation\/rp2040\/getting-started\/#getting-started-with-micropython<\/a><\/p>\n\n\n\n
Als u Windows gebruikt, kijk dan eens naar deze blogpost over de Raspberry Pi Pico en MicroPython op Windows https:\/\/picockpit.com\/raspberry-pi\/raspberry-pi-pico-and-micropython-on-windows\/<\/a><\/p>\n\n\n\n
Sluit Thonny nadat je je Pico hebt geflashed met de MicroPython firmware en installeer rshell. We gebruiken rshell om toegang te krijgen tot het bestandssysteem vanaf de commandoregel.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>pip3<\/span> <\/span>install<\/span> <\/span>rshell<\/span><\/span>\nrshell<\/span> <\/span>--<\/span>version<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Dit drukt de rhsell versie af als alles juist is ingesteld. Trek dan de stekker van de pico uit het stopcontact en steek hem er weer in (zonder de BOOTSEL knop ingedrukt te houden) om er zeker van te zijn dat niets toegang probeert te krijgen tot het bestandssysteem. Nu moeten we het volgende uitvoeren<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
rshell<\/span> <\/span>-<\/span>p<\/span> <\/span>\/<\/span>dev<\/span>\/<\/span>ttyACM0<\/span> <\/span>--<\/span>buffer<\/span>-<\/span>size<\/span> <\/span>512<\/span><\/span>\n<\/span>\ncp<\/span> <\/span>factfib<\/span>.<\/span>mpy<\/span> <\/span>\/<\/span>pyboard<\/span>\/<\/span>factfib<\/span>.<\/span>mpy<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Om de installatie te testen kunt u rshell of de Thonny IDE gebruiken om uw .py<\/em> bestanden op de Pico, maar ik zal demonstreren hoe je de MicroPython interpreter over de minicom gebruikt.<\/p>\n\n\n\n
Dus druk eerst op Ctrl+c<\/em> om rshell te verlaten en dan minicom te installeren via<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>apt<\/span> <\/span>install<\/span> <\/span>minicom<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
nu hebben we toegang tot de Picos REPL (Read-eval-print loop)<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
minicom<\/span> <\/span>-<\/span>o<\/span> <\/span>-<\/span>D<\/span> <\/span>\/<\/span>dev<\/span>\/<\/span>ttyACM0<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
De drie afsluitende haakjes >>> geven aan dat de MicroPython-interpreter draait. Nu kunnen we onze extensie importeren en er zoals gewoonlijk mee werken.<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
>>><\/span> <\/span>import<\/span> <\/span>factfib<\/span> <\/span>as<\/span> <\/span>ff<\/span><\/span>\n<\/span>\n>>> <\/span>ff<\/span>.<\/span>factorial<\/span>(5)<\/span><\/span>\n<\/span>\n>>> 120<\/span><\/span>\n<\/span>\n>>> <\/span>ff<\/span>.<\/span>fibonacci<\/span>(7)<\/span><\/span>\n<\/span>\n>>> 13<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
Gefeliciteerd! Je hebt je eerste MicroPython C-extensie voor de Pico gemaakt! De volgende stap is om complexere modules te leren schrijven en compileren. Een goede manier om te beginnen is door te testen hoe Marshalling van lijsten en dicts werkt (zie de Marshalling webpagina van hierboven). <\/p>\n\n\n\n
Als je vragen hebt over deze post, schrijf dan gerust een reactie.<\/p>\n
Deze webpagina van Oliver Robson is echt nuttig voor Marshalling https:\/\/mpy-c-gen.oliverrobson.tech\/<\/a>. Verder kunt u Marshalling voorbeelden vinden in de MicroPython documentatie https:\/\/docs.micropython.org\/en\/latest\/develop\/natmod.html<\/a>. Ik raad u aan dit artikel te lezen als u meer uitleg nodig hebt.<\/p>\n\n\n\n