Arduino-Pico

نواة Arduino للوحة Raspberry Pi Pico، لجميع لوحات RP2040 وRP2350

هذا منفذ لـ Arduino على معالج RP2040 (معالج Raspberry Pi Pico) وRP2350 (معالج Raspberry Pi Pico 2). يستخدم حزمة Raspberry Pi Pico SDK الخام وأدوات GCC 14.3/Newlib 4.5 المخصصة ويدعم أنوية ARM وRISC-V.

التوثيق

انظر https://arduino-pico.readthedocs.io/en/latest/ مع الأمثلة لمزيد من معلومات الاستخدام التفصيلية.

المساهمة

اقرأ دليل المساهمة لمزيد من المعلومات حول تقديم طلبات السحب ونقل المكتبات أو الرسومات (sketches) إلى هذه النواة.

اللوحات المدعومة

Raspberry Pi Pico
Raspberry Pi Pico W
Raspberry Pi Pico 2
Raspberry Pi Pico 2W
0xCB Helios
Adafruit Feather RP2040
Adafruit Feather RP2040 SCORPIO
Adafruit Floppsy RP2040
Adafruit ItsyBitsy RP2040
Adafruit KB2040
Adafruit Macropad RP2040
Adafruit Metro RP2040
Adafruit Metro RP2350
Adafruit QTPy RP2040
Adafruit STEMMA Friend RP2040
Adafruit Trinkey RP2040 QT
Amken Bunny
Amken Revelop
Amken Revelop Plus
Amken Revelop eS
Architeuthis Flux Jumperless
Architeuthis Flux Jumperless V5
Arduino Nano RP2040 Connect
ArtronShop RP2 Nano
BIGTREETECH SKR-Pico
Breadstick Raspberry
BridgeTek IDM2040-7A
BridgeTek IDM2040-43A
Cytron IRIV IO Controller
Cytron Maker Pi RP2040
Cytron Maker Nano RP2040
Cytron Maker Uno RP2040
Cytron Motion 2350 Pro
Datanoise PicoADK v1
Datanoise PicoADK v2 (RP2350)
Degz Suibo RP2040
DeRuiLab FlyBoard2040 Core
DFRobot Beetle RP2040
ElectronicCats Hunter Cat NFC
EVN Alpha
ExtremeElectronics RC2040
GeeekPi RP2040 Plus
GroundStudio Marble Pico
Invector Labs Challenger RP2040 WiFi
Invector Labs Challenger RP2040 WiFi/BLE
Invector Labs Challenger RP2040 WiFi6/BLE
Invector Labs Challenger NB RP2040 WiFi
Invector Labs Challenger RP2040 LTE
Invector Labs Challenger RP2040 LoRa
Invector Labs Challenger RP2040 SubGHz
Invector Labs Challenger RP2040 SD/RTC
Invector Labs Challenger RP2040 UWB
Invector Labs Challenger+ RP2350 BConnect
Invector Labs Challenger+ RP2350 WiFi/BLE
Invector Labs Challenger+ RP2350 NB-IoT
Invector Labs RPICO32
Melopero Cookie RP2040
Melopero Shake RP2040
METE HOCA Akana R1
Makerbase MKSTHR36
Makerbase MKSTHR42
MyMakers RP2040
Neko Systems BL2040 Mini
Newsan Archi
nullbits Bit-C PRO
Olimex Pico2XL
Olimex Pico2XXL
Olimex RP2040-Pico30
PicoLume Transceiver
Pimoroni PGA2040
Pimoroni Pico Plus 2
Pimoroni Pico Plus 2W
Pimoroni Plasma2040
Pimoroni Plasma2350
Pimoroni Plasma2350W
Pimoroni Servo2040
Pimoroni Tiny2040
Pimoroni Tiny2350
Pintronix PinMax
PCBCupid Glyph 2040
PCBCupid Glyph Mini 2040
RAKwireless RAK11300
Redscorp RP2040-Eins
Redscorp RP2040-ProMini
Sea-Picro
Seeed Indicator RP2040
Seeed XIAO RP2040
Seeed XIAO RP2040 Plus
Seeed XIAO RP2350
Silicognition RP2040-Shim
Solder Party RP2040 Stamp
Solder Party RP2350 Stamp
Solder Party RP2350 Stamp XL
Soldered Electronics NULA Ethernet W55RP20
Soldered Electronics NULA RP2350
SparkFun IoT RedBoard RP2350
SparkFun MicroMod RP2040
SparkFun ProMicro RP2040
SparkFun ProMicro RP2350
SparkFun Thing Plus RP2040
SparkFun Thing Plus RP2350
SparkFun XRP Controller
uPesy RP2040 DevKit
VCC-GND YD-RP2040
Viyalab Mizu RP2040
Waveshare RP2040 Zero
Waveshare RP2040 One
Waveshare RP2040 Plus
Waveshare RP2040 LCD 0.96
Waveshare RP2040 LCD 1.28
Waveshare RP2040 LoRa
Waveshare RP2040 Matrix
Waveshare RP2040 PiZero
Waveshare RP2350 Zero
Waveshare RP2350 PiZero
Waveshare RP2350 Plus
Waveshare RP2350 Plus W
Waveshare RP2350 LCD 0.96
WIZnet W5100S-EVB-Pico
WIZnet W5100S-EVB-Pico2
WIZnet W5500-EVB-Pico
WIZnet W5500-EVB-Pico2
WIZnet W55RP20-EVB-Pico
WIZnet W6300-EVB-Pico
WIZnet W6300-EVB-Pico2
WIZnet WizFi360-EVB-Pico
Generic RP2040 (ذاكرة فلاش قابلة للتكوين، دبابيس I/O)
Generic RP2350 (ذاكرة فلاش قابلة للتكوين، دبابيس I/O)

الميزات

Adafruit TinyUSB Arduino (فأرة USB، لوحة مفاتيح، محرك أقراص فلاش، HID عام، CDC Serial، MIDI، WebUSB، وغيرها)
Bluetooth على PicoW (كلاسيكي وBLE) مع لوحة مفاتيح، فأرة، عصا تحكم، ومنفذ تسلسلي افتراضي
وضع المضيف HID عبر Bluetooth Classic وBLE (الاتصال بلوحة مفاتيح BT، فأرة، أو عصا تحكم)
محاكاة عامة لمنفذ Arduino USB التسلسلي، لوحة المفاتيح، عصا التحكم، والفأرة
WiFi (Pico W، ESPHost المعتمد على ESP32، Atmel WINC1500)
Ethernet (سلكي WizNet W6300، WizNet W6100، WizNet W5500، WizNet W5100، ENC28J60)
عميل وخادم HTTP (WebServer)
SSL/TLS/HTTPS
الترقيات عبر الهواء (OTA)
أنظمة الملفات (LittleFS وSD/SDFS)
دعم متعدد النوى (setup1() وloop1())
دعم FreeRTOS SMP
رفع أو خفض سرعة الساعة من القوائم
digitalWrite/Read، shiftIn/Out، tone، analogWrite(PWM)/Read، درجة الحرارة
صوت استريو تماثلي للإدخال باستخدام DMA ومحول ADC المدمج
صوت استريو تماثلي للإخراج باستخدام أجهزة PWM
مصدر صوت A2DP Bluetooth (خرج) ومستقبل (إدخال) على PicoW
وضع محرك أقراص USB لمسجلات البيانات (SingleFileDrive, FatFSUSB)
الأطراف: SPI رئيس/تابع، Wire(I2C) رئيس/تابع، UART مزدوج، EEPROM محاكى، إدخال/إخراج صوت I2S، Servo
إخراج printf (أي التصحيح) عبر USB التسلسلي
استخدام شفاف لذاكرة PSRAM العالمية والكومة (فقط RP2350)
دعم ARM أو RISC-V (Hazard3) لـ RP2350
الوصول إلى الملفات والمنفذ التسلسلي شبه المستضاف (Semihosted)
دعم التنميط GPROF

تُستخدم آلات الحالة PIO في RP2040 لتوليد خالٍ من التقطيع:

Servos
Tones
إدخال I2S
إخراج I2S
UART برمجي (منافذ Serial)
SPI برمجي

التثبيت عبر Arduino Boards Manager

ملاحظات خاصة بنظام Windows

يرجى عدم استخدام إصدار Windows Store من تطبيق Arduino الفعلي لأنه يواجه مشكلات في اكتشاف لوحات Pico المتصلة. استخدم تنزيل "Windows ZIP" أو "Windows" القابل للتنفيذ (EXE) مباشرة من https://arduino.cc. واسمح له بتثبيت أي برامج تشغيل يقترحها. وإلا قد لا يتم اكتشاف لوحة Pico. أيضًا، إذا كنت تجرب الإصدار التجريبي 2.0 من Arduino، فيرجى تثبيت الإصدار 1.8 مسبقًا لضمان توفر برامج التشغيل اللازمة. (انظر #20 لمزيد من التفاصيل.)

ملاحظات خاصة بنظام Linux

تثبيت Arduino باستخدام flatpak (المستخدم غالبًا بواسطة "متاجر التطبيقات" في توزيعات Linux المختلفة) سيؤدي إلى تقييد الوصول إلى المضيف. قد يتسبب ذلك في فشل التحميل مع رسائل خطأ مثل التالية:

Scanning for RP2040 devices
...
No drive to deploy.

إذا واجهت هذا، فستحتاج إما إلى تثبيت Arduino بطريقة مختلفة، أو تجاوز ميزة العزل (sandboxing) الخاصة بـ flatpak باستخدام الأمر التالي، ثم إعادة تشغيل Arduino.

flatpak override --user --filesystem=host:ro cc.arduino.IDE2

التثبيت

افتح Arduino IDE وانتقل إلى File->Preferences.

في الحوار الذي يظهر، أدخل عنوان URL التالي في حقل "Additional Boards Manager URLs":

https://github.com/earlephilhower/arduino-pico/releases/download/global/package_rp2040_index.json

اضغط OK لإغلاق الحوار.

انتقل إلى Tools->Boards->Board Manager في IDE

اكتب "pico" في مربع البحث واختر "Add":

التثبيت عبر GIT

مستخدمو Windows: قبل التثبيت عبر git على Windows، يرجى قراءة واتباع التعليمات في هذا الرابط. إذا لم يتم تمكين المسارات الطويلة في Win32، ولم يتم تكوين git لاستخدامها، فقد تظهر أخطاء عند محاولة استنساخ الوحدات الفرعية.

لتثبيت عبر GIT (للحصول على أحدث الإصدارات) تحت Linux أو Mac:

mkdir -p ~/Arduino/hardware/pico
git clone https://github.com/earlephilhower/arduino-pico.git ~/Arduino/hardware/pico/rp2040
cd ~/Arduino/hardware/pico/rp2040
git submodule update --init --recursive
cd tools
python3 ./get.py

لنظام Windows، يجب أن يكون لديك Python مثبتًا بالفعل واستنساخ git في مسار مختلف:

mkdir %USERPROFILE%\Documents\Arduino\hardware\pico
git clone https://github.com/earlephilhower/arduino-pico.git %USERPROFILE%\Documents\Arduino\hardware\pico\rp2040
cd %USERPROFILE%\Documents\Arduino\hardware\pico\rp2040
git submodule update --init --recursive
cd tools
python .\get.py

تحميل الرسومات (Sketches)

لتحميل أول رسمة لك، ستحتاج إلى الضغط مع الاستمرار على زر BOOTSEL أثناء توصيل Pico بجهاز الكمبيوتر الخاص بك. ثم اضغط على زر التحميل وسيتم نقل الرسمة وستبدأ في العمل.

بعد التحميل الأول، لا ينبغي أن يكون ذلك ضروريًا لأن نواة arduino-pico تدعم إعادة الضبط التلقائي. حدد المنفذ التسلسلي المناسب الظاهر في قائمة Arduino Tools->Port->Serial Port مرة واحدة (سيظل هذا الإعداد ثابتًا ولا يحتاج إلى تغييره لتحميلات متعددة). يسمح هذا الاختيار لأداة إعادة الضبط التلقائي بتحديد الجهاز الصحيح لإعادة تعيينه. ثم اضغط على زر التحميل وسيتم تحميل الرسمة وتشغيلها.

في بعض الحالات، قد يتعطل Pico بشدة ولن يستجيب منفذ USB الخاص به لطلب إعادة الضبط التلقائي. إذا حدث ذلك، فقط اتبع الإجراء الأولي بالضغط على زر BOOTSEL أثناء توصيل Pico للدخول إلى محمل الإقلاع ROM.

تحميل صور أنظمة الملفات

نظام الملفات المدمج في Pico، LittleFS، يتيح لك تحميل صورة نظام ملفات من دليل الرسمة لاستخدامها. قم بتنزيل الإضافة اللازمة من

https://github.com/earlephilhower/arduino-pico-littlefs-plugin/releases

لتثبيته، اتبع التعليمات في

https://github.com/earlephilhower/arduino-pico-littlefs-plugin/blob/master/README.md

للحصول على معلومات استخدام مفصلة، يرجى مراجعة توثيق مستودع ESP8266 (تجاهل الملاحظات المتعلقة بـ SPIFFS) المتاحة في

https://arduino-pico.readthedocs.io/en/latest/fs.html

تحميل الرسومات باستخدام Picoprobe/Debugprobe

إذا قمت ببناء Raspberry Pi Picoprobe، يمكنك استخدام OpenOCD للتعامل مع تحميل الرسومات الخاصة بك ولتصحيح الأخطاء باستخدام GDB.

تحت Windows، يجب أن يكون المستخدم المحلي المسؤول قادرًا على الوصول إلى منفذ Picoprobe تلقائيًا، ولكن تحت Linux يجب إعلام udev بالجهاز والسماح للمستخدمين العاديين بالوصول.

لإعداد الوصول على مستوى المستخدم إلى Picoprobes في Ubuntu (وأنظمة التشغيل الأخرى التي تستخدم udev):

echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="0004", MODE="660", GROUP-"plugdev"' | sudo tee -a /etc/udev/rules.d/98-PicoProbe.rules
echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="000a", MODE="660", GROUP="plugdev"' | sudo tee -a /etc/udev/rules.d/98-PicoProbe.rules
echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="2e8a", ATTRS{idProduct}=="000f", MODE="660", GROUP="plugdev"' | sudo tee -a /etc/udev/rules.d/98-PicoProbe.rules
sudo udevadm control --reload
sudo udevadm trigger -w -s usb

يقوم السطر الأول بإنشاء ملف جهاز في /dev يطابق معرف البائع والمنتج USB الخاص بـ Picoprobe، ويمنح أذونات القراءة والكتابة العامة. السطر الثاني يجعل udev يقوم بتحميل هذه القاعدة الجديدة. السطر الثالث يطلب من النواة توليد أحداث "تغيير الجهاز" التي ستؤدي إلى تشغيل قاعدة udev الجديدة لدينا.

إذا لم يظهر ملف الجهاز لسبب ما، افصل وأعد توصيل كابل USB يدويًا وتحقق مرة أخرى. يمكن أن يكشف إخراج dmesg عن تشخيصات مفيدة إذا ظل ملف الجهاز غائبًا.

بمجرد إعداد أذونات Picoprobe بشكل صحيح، حدد اللوحة "Raspberry Pi Pico (Picoprobe)" في قائمة Tools وقم بالتحميل كالمعتاد.

تصحيح الأخطاء باستخدام Picoprobe وOpenOCD وGDB

تتضمن الأدوات المثبتة إصدارًا من OpenOCD (في دليل pqt-openocd) وGDB (في دليل pqt-gcc). يمكن استخدامها لتشغيل GDB في نافذة تفاعلية كما هو موثق في أدلة بدء استخدام Pico من مؤسسة Raspberry Pi. استخدم سطر الأوامر ./system/openocd/bin/openocd -f ./lib/rp2040/picoprobe_cmsis_dap.tcl أو ./system/openocd/bin/openocd -f ./lib/rp2350/picoprobe_cmsis_dap.tcl من دليل تثبيت git.

الترخيص والإسناد

Arduino IDE وArduinoCore-API تم تطويرهما وصيانتهما بواسطة فريق Arduino. IDE مرخص تحت GPL.
مجموعة أدوات RP2040 المستندة إلى GCC مرخصة تحت GPL.
Pico-SDK من Raspberry Pi (Trading) Ltd ومرخص تحت رخصة BSD 3-Clause.
ملفات نواة Arduino-Pico مرخصة تحت LGPL.
مكتبة LittleFS من تأليف ARM Limited ومصدرة تحت رخصة BSD 3-clause.
UF2CONV.PY من Microsoft Corporation ومرخص تحت رخصة MIT.
كود الشبكات وأنظمة الملفات مأخوذ من نواة ESP8266 Arduino ومرخص تحت LGPL.
خادم DHCP لوضع المضيف AP من مشروع Micropython، موزع تحت رخصة MIT.
FreeRTOS حقوق الطبع والنشر لـ Amazon.com, Inc. أو الشركات التابعة لها، وموزع تحت رخصة MIT.
lwIP حقوق الطبع والنشر للمعهد السويدي لعلوم الكمبيوتر ومرخص تحت رخصة BSD.
مكتبة BearSSL من تأليف Thomas Pornin، موزعة تحت رخصة MIT.
UZLib حقوق الطبع والنشر (c) 2003 Joergen Ibsen وموزعة تحت رخصة zlib.
LEAmDNS حقوق الطبع والنشر لمؤلفين متعددين وموزعة تحت رخصة MIT.
http-parser حقوق الطبع والنشر لـ Joyent, Inc. ومساهمين آخرين في Node.
كود WebServer معدل من ESP32 WebServer وحقوق الطبع والنشر (c) 2015 Ivan Grokhotkov وآخرون.
Xoshiro-cpp حقوق الطبع والنشر (c) 2020 Ryo Suzuki وموزع تحت رخصة MIT.

-إيرل إف. فيلهاور الثالث
[email protected]

arduino-pico

الأكثر شعبية