earlephilhower/arduino-picoنواة Raspberry Pi Pico Arduino، لجميع لوحات RP2040 و RP2350
# Arduino-Pico
[](https://github.com/earlephilhower/arduino-pico/releases)
[](https://gitter.im/arduino-pico/community)
نواة Arduino لـ Raspberry Pi Pico، لجميع لوحات RP2040 و RP2350
هذا نقل لـ Arduino إلى RP2040 (معالج Raspberry Pi Pico) و RP2350 (معالج Raspberry Pi Pico 2). يستخدم Raspberry Pi Pico SDK المجرد وسلسلة أدوات GCC 16.1/Newlib 4.6 المخصصة ويدعم أنوية ARM و RISC-V.
# التوثيق
راجع https://arduino-pico.readthedocs.io/en/latest/ مع الأمثلة للحصول على معلومات استخدام أكثر تفصيلاً.
# المساهمة
اقرأ [دليل المساهمة](https://github.com/earlephilhower/arduino-pico/blob/master/docs/contrib.rst) للحصول على مزيد من المعلومات حول تقديم طلبات السحب ونقل المكتبات أو الرسومات إلى هذه النواة.
# اللوحات المدعومة
* 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 Feather RP2040 DVI
* Adafruit Feather RP2040 Adalogger
* Adafruit Feather RP2040 RFM
* Adafruit Feather RP2040 ThinkINK
* Adafruit Feather RP2040 USB Host
* Adafruit Feather RP2040 CAN
* Adafruit Feather RP2040 Prop-Maker
* Adafruit ItsyBitsy RP2040
* Adafruit Metro RP2040
* Adafruit QT Py RP2040
* Adafruit STEMMA Friend RP2040
* Adafruit Trinkey RP2040 QT
* Adafruit MacroPad RP2040
* Adafruit KB2040
* Adafruit Feather RP2350 Adalogger
* Adafruit Feather RP2350 HSTX
* Adafruit Floppsy
* Adafruit Metro RP2350
* Adafruit Fruit Jam RP2350
* Amken BunnyBoard
* 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 Nano RP2040
* Cytron Maker Pi RP2040
* Cytron Maker Uno RP2040
* Cytron Motion 2350 Pro
* Cytron Maker Sumo RP2350
* DatanoiseTV PicoADK
* DatanoiseTV PicoADK v2
* Degz Robotics Suibo RP2040
* DeRuiLab FlyBoard2040Core
* DFRobot Beetle RP2040
* L'atelier d'Arnoz DudesCab
* ElectronicCats HunterCat NFC RP2040
* EVN Alpha
* ExtremeElectronics RC2040
* GeeekPi RP2040 Plus
* GroundStudio Marble Pico
* iLabs Challenger 2040 LTE
* iLabs Challenger 2040 LoRa
* iLabs Challenger 2040 SubGHz
* iLabs Challenger 2040 WiFi
* iLabs Challenger 2040 WiFi/BLE
* iLabs Challenger 2040 WiFi6/BLE
* iLabs Challenger NB 2040 WiFi
* iLabs Challenger 2040 SD/RTC
* iLabs Challenger 2040 NFC
* iLabs Challenger 2040 UWB
* iLabs Connectivity 2040 LTE/WiFi/BLE
* iLabs RPICO32
* iLabs Challenger 2350 WiFi/BLE
* iLabs Challenger 2350 BConnect
* iLabs Challenger 2350 NB-IoT
* iLabs Challenger ZP 2350 LoRa
* iLabs CPico 2350
* Makerbase MKS THR36
* Makerbase MKS THR42
* Melopero Cookie RP2040
* Melopero Shake RP2040
* METE HOCA Akana R1
* MyMakers RP2040
* MyMakers RP2350B
* Neko Systems BL2040 Mini
* Newsan Archi
* nullbits Bit-C PRO
* Olimex Pico2BB48
* Olimex Pico2XL
* Olimex Pico2XXL
* Olimex RP2040-Pico30
* Pcbcupid GLYPH 2040
* Pcbcupid GLYPH MINI 2040
* PicoLume Transceiver
* Pimoroni PGA2040
* Pimoroni PGA2350
* Pimoroni PicoPlus2
* Pimoroni PicoPlus2W
* Pimoroni Plasma2040
* Pimoroni Plasma2350
* Pimoroni Plasma2350W
* Pimoroni Servo2040
* Pimoroni Tiny2040
* Pimoroni Tiny2350
* Pimoroni Explorer
* Pintronix PinMax
* RAKwireless RAK11300
* redscorp RP2040-Eins
* redscorp RP2040-ProMini
* Generic Sea-Picro
* Silicognition RP2040-Shim
* Solder Party RP2040 Stamp
* Solder Party RP2350 Stamp
* Solder Party RP2350 Stamp XL
* Soldered Electronics NULA RP2350
* Soldered Electronics NULA Ethernet W55RP20
* Soldered Electronics NULA Node
* SparkFun IoT RedBoard RP2350
* SparkFun MicroMod RP2040
* SparkFun ProMicro RP2040
* SparkFun ProMicro RP2350
* SparkFun Thing Plus RP2040
* SparkFun Thing Plus RP2350
* SparkFun IoT Node LoRaWAN
* SparkFun XRP Controller (Beta)
* SparkFun XRP Controller
* Seeed INDICATOR RP2040
* Seeed XIAO RP2040
* Seeed XIAO RP2040 Plus
* Seeed XIAO RP2350
* uPesy RP2040 DevKit
* VCC-GND YD RP2040
* Vicharak Shrike-Lite
* Viyalab Mizu RP2040
* Waveshare RP2040 Zero
* Waveshare RP2040 One
* Waveshare RP2040 LoRa
* Waveshare RP2040 Matrix
* Waveshare RP2040 PiZero
* Waveshare RP2040 Plus
* Waveshare RP2040 LCD 0.96
* Waveshare RP2040 LCD 1.28
* Waveshare RP2350 Core
* Waveshare RP2350 Zero
* Waveshare RP2350 PiZero
* Waveshare RP2350 Plus
* Waveshare RP2350B Plus W
* Waveshare RP2350 LCD 0.96
* Waveshare RP2350-POE-ETH
* WeAct Studio RP2350B Core Board
* 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
* Generic RP2350
# الميزات
* Adafruit TinyUSB Arduino (فأرة USB، لوحة مفاتيح، محرك أقراص فلاش، HID عام، CDC Serial، MIDI، WebUSB، وغيرها)
* Bluetooth على PicoW (Classic و BLE) مع لوحة مفاتيح، فأرة، عصا تحكم، ومنفذ تسلسلي افتراضي
* وضع Bluetooth Classic و BLE HID master (الاتصال بلوحة مفاتيح BT أو فأرة أو عصا تحكم)
* محاكاة Arduino USB Serial و Keyboard و Joystick و Mouse العامة
* WiFi (Pico W، ESPHost القائم على ESP32، Atmel WINC1500)
* Ethernet (Wired WizNet W6300، WizNet W6100، WizNet W5500، WizNet W5100، ENC28J60)
* عميل وخادم HTTP (WebServer)
* SSL/TLS/HTTPS
* ترقيات Over-the-Air (OTA)
* أنظمة الملفات (LittleFS و SD/SDFS)
* دعم متعدد الأنوية (setup1() و loop1())
* دعم FreeRTOS SMP
* رفع وخفض التردد من القوائم
* digitalWrite/Read، shiftIn/Out، tone، analogWrite(PWM)/Read، درجة الحرارة
* إدخال صوت ستيريو تناظري باستخدام DMA و ADC المدمج
* إخراج صوت ستيريو تناظري باستخدام عتاد PWM
* مصدر وصوت Bluetooth A2DP (إخراج) و sink (إدخال) على PicoW
* وضع محرك أقراص USB لمسجلات البيانات (SingleFileDrive، FatFSUSB)
* الأجهزة الطرفية: SPI master/slave، Wire(I2C) master/slave، UART مزدوج، EEPROM محاكى، إدخال/إخراج صوت I2S، Servo
* إخراج printf (أي التصحيح) عبر USB serial
* استخدام شفاف لمتغيرات PSRAM العامة والكومة (RP2350 فقط)
* دعم ARM أو RISC-V (Hazard3) لـ RP2350
* وصول تسلسلي ونظام ملفات Semihosted
* دعم تنميط GPROF
تُستخدم آلات حالة PIO (SMs) في RP2040 لتوليد ما يلي بدون اهتزاز:
* Servos
* Tones
* I2S Input
* I2S Output
* Software UARTs (Serial ports)
* Software SPIs
# التثبيت عبر Arduino Boards Manager
## ملاحظات خاصة بـ Windows
يرجى عدم استخدام نسخة Windows Store من تطبيق Arduino الفعلي
لأنها تواجه مشكلات في اكتشاف لوحات Pico المتصلة. استخدم "Windows ZIP" أو ملف "Windows"
التنفيذي (EXE) العادي الذي يتم تنزيله مباشرة من https://arduino.cc. واسمح له بتثبيت أي برامج
تشغيل أجهزة يقترحها. وإلا فقد لا يتم اكتشاف لوحة Pico. أيضاً، إذا كنت تجرب
Arduino 2.0 beta يرجى تثبيت إصدار 1.8 أولاً لضمان وجود برامج تشغيل الأجهزة المطلوبة.
(راجع #20 لمزيد من التفاصيل.)
## ملاحظات خاصة بـ Linux
تثبيت Arduino باستخدام flatpak (غالباً ما تستخدمه "متاجر التطبيقات" في توزيعات Linux
المختلفة) يعني أنه سيكون لديه وصول مقيد إلى المضيف. قد يتسبب هذا في فشل عمليات الرفع
برسائل خطأ مثل التالية:
```
Scanning for RP2040 devices
...
No drive to deploy.
```
إذا واجهت هذا، ستحتاج إما إلى تثبيت Arduino بطريقة مختلفة، أو تجاوز
ميزة العزل في 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، يرجى قراءة واتباع الإرشادات في
[هذا الرابط](https://arduino-pico.readthedocs.io/en/latest/platformio.html#important-steps-for-windows-users-before-installing).
إذا لم يتم تمكين مسارات 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
````
# رفع الرسومات
لرفع أول رسم لك، ستحتاج إلى الضغط باستمرار على زر BOOTSEL أثناء توصيل Pico بجهاز الكمبيوتر.
ثم اضغط على زر الرفع ويجب نقل الرسم وبدء تشغيله.
بعد الرفع الأول، لن يكون ذلك ضرورياً لأن نواة `arduino-pico` لديها دعم إعادة الضبط التلقائي.
اختر منفذ التسلسل المناسب الظاهر في قائمة Arduino Tools->Port->Serial Port مرة واحدة (سيثبت هذا الإعداد ولن تحتاج إلى
تغييره لعمليات رفع متعددة). يتيح هذا الاختيار لأداة إعادة الضبط التلقائي تحديد الجهاز المناسب لإعادة ضبطه.
ثم اضغط على زر الرفع ويجب أن يتم رفع رسمك وتشغيله.
في بعض الحالات، قد يواجه Pico تعليقاً قوياً ولن يستجيب منفذ USB الخاص به لطلب إعادة الضبط التلقائي. إذا حدث هذا، فقط
اتبع الإجراء الأولي المتمثل في الضغط باستمرار على زر BOOTSEL أثناء توصيل Pico لدخول ROM bootloader.
# رفع صور نظام الملفات
يتيح لك نظام ملفات الفلاش المدمج لـ 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 Getting Started من مؤسسة 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](https://arduino.cc) تم تطويرهما وصيانتهما من قبل فريق Arduino. IDE مرخص تحت GPL.
* [سلسلة أدوات RP2040 القائمة على GCC](https://github.com/earlephilhower/pico-quick-toolchain) مرخصة تحت GPL.
* [Pico-SDK](https://github.com/raspberrypi/pico-sdk) من Raspberry Pi (Trading) Ltd ومرخص تحت ترخيص BSD 3-Clause.
* ملفات نواة [Arduino-Pico](https://github.com/earlephilhower/arduino-pico) مرخصة تحت LGPL.
* مكتبة [LittleFS](https://github.com/ARMmbed/littlefs) كتبتها ARM Limited وصدرت تحت [ترخيص BSD 3-clause](https://github.com/ARMmbed/littlefs/blob/master/LICENSE.md).
* [UF2CONV.PY](https://github.com/microsoft/uf2) من Microsoft Corporation ومرخص تحت ترخيص MIT.
* كود الشبكات ونظام الملفات مأخوذ من [ESP8266 Arduino Core](https://github.com/esp8266/Arduino) ومرخص تحت LGPL.
* خادم DHCP لوضع مضيف AP من [Micropython Project](https://micropython.org)، موزع تحت ترخيص MIT.
* [FreeRTOS](https://freertos.org) حقوق النشر لـ Amazon.com, Inc. أو الشركات التابعة لها، وموزع تحت ترخيص MIT.
* [lwIP](https://savannah.nongnu.org/projects/lwip/) هو (c) المعهد السويدي لعلوم الكمبيوتر ومرخص تحت ترخيص BSD.
* مكتبة [BearSSL](https://bearssl.org) كتبها Thomas Pornin، موزعة تحت [ترخيص MIT](https://bearssl.org/#legal-details).
* [UZLib](https://github.com/pfalcon/uzlib) حقوق النشر (c) 2003 Joergen Ibsen وموزعة تحت ترخيص zlib.
* [LEAmDNS](https://github.com/LaborEtArs/ESP8266mDNS) حقوق النشر لعدة مؤلفين وموزعة تحت ترخيص MIT.
* [http-parser](https://github.com/nodejs/http-parser) حقوق النشر لـ Joyent, Inc. ومساهمين آخرين في Node.
* كود WebServer معدل من [ESP32 WebServer](https://github.com/espressif/arduino-esp32/tree/master/libraries/WebServer) وحقوق النشر (c) 2015 Ivan Grokhotkov وآخرون.
* [Xoshiro-cpp](https://github.com/Reputeless/Xoshiro-cpp) حقوق النشر (c) 2020 Ryo Suzuki وموزعة تحت ترخيص MIT.
* كود [نظام الملفات منخفض المستوى FatFS](http://elm-chan.org/fsw/ff/) حقوق النشر (C) 2024، ChaN، جميع الحقوق محفوظة.
* [مدير ذاكرة TLSF لـ PSRAM من تفرع Espressif](https://github.com/espressif/tlsf) لـ [الأصلي](https://github.com/mattconte/tlsf) بواسطة Matthew Conte حقوق النشر لـ Matthew Conte ومرخص تحت ترخيص MIT.
* [مكتبة ESPHost](https://github.com/Networking-for-Arduino/ESPHost) مرخصة تحت LGPL من قبل صيانتها.
* [مكتبة iLabs_ESP-NOW](https://github.com/PontusO/iLabs_ESP-NOW) مرخصة تحت ترخيص MIT من قبل iLabs Electronics.
* [مكتبة iLabs_Hearth](https://github.com/PontusO/iLabs_Hearth) مرخصة تحت ترخيص MIT من قبل iLabs Electronics.
* مكتبة الكاميرا [PicoCamera](https://github.com/umeiko/PicoCamera) مرخصة تحت ترخيص MIT من قبل umeko.
-Earle F. Philhower, III
[email protected]