描述

除了價格低廉、I/O 選項和 PIO 范圍廣泛之外，Pico 的一大優點是 C/C++ SDK。Raspberry Pi 的人們在創建一個易于使用的編程環境方面做得很好，但如果你想要的話，仍然可以讓你接近硬件。更不用說全面的文檔了。

使用 C/C++ SDK 的一個缺點是缺少庫。Raspberry PI 論壇上的用戶@martinkooij編制了一份可用庫列表，雖然數量在增加，但與使用 Arduino IDE 時可用的大量庫相比還差得遠。僅Arduino 參考文檔就列出了 4000 多個庫。

如果您的傳感器、顯示器或其他外圍設備不存在 Pico C/C++ SDK 庫，那么很可能存在 Arduino 庫。

在本教程中，我將引導您完成使用 pico-arduino-compat 將 Arduino 庫添加到您的 Pico C/C++ SDK 項目的過程。

什么是 pico-arduino-compat？

pico-arduino-compat 是一個兼容層，它允許（某些）Arduino 庫不加修改地用于使用 Pico C/C++ SDK 編寫的項目中。

對于 Arduino 官方文檔中列出的每個 Arduino 庫（超過 4000 個），都有一個相應的 cmake 接口庫，可以直接在 Pico C/C++ SDK 項目中使用。

pico-arduino-compat 兼容層利用earlephilhower 出色的RP2040 Arduino 內核來完成大部分繁重的工作。

兼容性

顯然，并非所有 Arduino 庫都可以與 Pico/RP2040 一起使用。那些依賴 AVR 或 ESP 硬件的特定功能的就是一個很好的例子。在 Arduino 官方參考文檔中列出的 4190 個庫中，其中 1730 個針對 Pico C/C++ SDK成功編譯（41%）。

我懷疑其中很大一部分由于依賴于其他庫而無法編譯。這可以通過調整CMakeLists.txt文件輕松解決，但這是一個手動過程，僅針對少數庫完成。這是一個進展中的工作。

安裝 pico-arduino-compat

1.克隆存儲庫

?

git clone https://github.com/fhdm-dev/pico-arduino-compat.git

?

2.初始化arduino-pico子模塊

?

cd pico-arduino-compat
git submodule update --init arduino-compat/arduino-pico

?

找到庫 ID 和 cmake 目標名稱

您需要您計劃使用的 Arduino 庫的確切庫名稱。如果您不知道，可以在官方Arduino 文檔中找到庫的名稱。

現在轉到pico-arduino-compat 庫表并按 Arduino 庫名稱搜索庫。

找到它后，請查看 Compile 列（右起第二個）。如果該列的值為 OK，則該庫已通過基本編譯測試，如果幸運的話，它無需任何修改即可與 Pico C/C++ SDK 一起使用。

記下 ID 和 CMake 目標名稱。

初始化庫

每個 Arduino 庫存儲庫都作為一個子模塊存儲在 pico-arduino-compat 存儲庫中。默認情況下，git 會將子模塊目錄留空，直到它被初始化。要初始化它（以及它所依賴的 Arduino 庫的子模塊），請執行以下操作：

1. 將目錄更改為 libs/，其中 是您在上面記下的 ID。從現在開始，我們將此目錄稱為庫目錄。

例如。對于 Arduino LiquidCrystal 庫，ID 是液晶

?

cd libs/liquidcrystal

?

2. 初始化子模塊。

在 linux 上只需運行以下腳本：

?

./init.sh

?

在其他操作系統上，只需在init.sh腳本中找到 git 命令并從命令行運行它。

將 Arduino 庫添加到您的項目中

在項目的CMakeLists.txt文件中，將庫目錄添加為子目錄

例如。

?

add_subdirectory(/home/fhdm-dev/pico/pico-arduino-compat/libs/liquidcrystal build-pac-liquidcrystal)

?

注意：傳遞給 add_subdirectory 的第二個參數的值并不重要。它只需要在您的項目中是獨一無二的。我傾向于使用 build_ 其中 是庫的 cmake 目標名稱。

現在將 CMake 目標添加到CMakeLists.txt文件中的 target_link_libraries

例如。

?

target_link_libraries(somename
  pac-liquidcrystal
)

?

注意：cmake 目標名稱都以pac-開頭，以幫助確保唯一性。

完畢。您現在應該能夠在您的 Pico C/C++ SDK 項目中使用該庫。

示例：Adafruit SSD1306

假設我們想在我們的項目中使用 Adafruit SSD1306 庫。首先，我們在pico-arduino-compat 庫表中查找條目，發現它的 ID 為adafruit-ssd1306 ，cmake 目標名稱為pac-adafruit-ssd1306 。

您還會注意到 Test 列顯示的值為Passed 。這意味著該庫已經在真實設備上進行了測試，并且至少有一些功能可以工作。

將目錄更改為庫目錄并列出其內容

?

cd libs/adafruit-ssd1306
ls

?

您看到的 Adafruit_SSD1306 目錄作為 git 子模塊包含在 pico-arduino-compat 存儲庫中，最初為空。

現在我們通過運行init.sh腳本來初始化子模塊，如下所示：

?

./init.sh

?

您可能會注意到，這也會初始化它所依賴的 adafruit-gfx-library 的子模塊，進而初始化 adafruit-busio 庫。

注意：在非 Linux 操作系統上，您可能需要通過手動運行 git 命令來初始化子模塊。有關詳細信息，請參閱init.sh的內容。

現在需要修改我們項目的主CMakeLists.txt文件，添加 add_subdirectory 行并將庫添加到 target_link_libraries。

例如：

?

cmake_minimum_required(VERSION 3.12)

include(pico_sdk_import.cmake)

project(adafruit-ssd1306-examples)

pico_sdk_init()

add_subdirectory(/home/fhdm-dev/pico/pico-arduino-compat/libs/adafruit-ssd1306 build_pac-adafruit-ssd1306)

add_executable(text
    main.cpp
)

target_link_libraries(text
    pac-adafruit-ssd1306
)

# create map/bin/hex file etc.
pico_add_extra_outputs(text)

?

完畢。

有關工作示例，請參閱adafruid-ssd1306/pico-sdk-examples 。如果您編譯示例并將 graphics.uf2 文件復制到您的 Pico，它應該如下所示：

示例：LiquidCrystal

官方 Arduino LiquidCrystal 庫。有關示例代碼，請參閱液晶/pico-sdk-examples 。

示例：字母和數字七段顯示庫

有關示例代碼，請參閱letters-and-numbers-seven-segment-display-library/pico-sdk-examples 。

從 C 代碼中使用 Arduino 庫

以下是一些圍繞 Arduino 庫的示例包裝器，允許從 C 代碼中使用它們。

pico-adafruit-ssd1306

皮克官方液晶

結論

雖然最好使用專門為 Pico C/C++ SDK 編寫的庫，但與 Arduino 生態系統可用的庫相比，庫的選擇是有限的。

對于那些只想讓某些東西快速運行的時候，Arduino 庫可能就足夠了。