Arduinoライブラリのインストール方法：ライブラリマネージャ、ZIP、手動

Arduinoライブラリのインストールとは、センサー、ディスプレイ、モジュールをスケッチで使えるように、既製のコードのパッケージをArduino IDEに追加することです。方法は3つあります。ライブラリマネージャ（最も簡単でおすすめの方法）、ダウンロードした.ZIPファイルをIDEに追加する方法、ライブラリのフォルダを手でスケッチブックのlibrariesフォルダにコピーする方法です。インストールしたら、スケッチの先頭に#include <LibraryName.h>と書けば、ライブラリのすべての関数が使えるようになります。正しいライブラリなら1分でインストールできますが、間違ったライブラリやバージョンだと、何時間ものバグ探しになることもあります。

このガイドでは、Arduino IDE 2で3つの方法をステップごとに紹介します。続いて、似た名前の何十ものライブラリから正しいものを選ぶ方法、古いバージョンに戻す方法、ライブラリのスケッチ例を開く方法、最も多い2つのメッセージ、No such file or directoryエラーとMultiple libraries were foundの警告の直し方を紹介します。最後の章では、ESP32とRaspberry Pi Picoで動くライブラリ、代わりが必要なライブラリ、MicroPythonでのライブラリの追加方法を取り上げます。IDEをまだインストールしていなければ、Arduino IDEのインストール方法から始めましょう。

Arduinoライブラリとは？何のためにある？

ライブラリは、決まった1つの仕事をするコードのファイルの集まりで、ほかの人が再利用できるようにまとめたものです。少なくとも1つのヘッダーファイル（.h）、たいてい1つ以上のソースファイル（.cpp）、そしてほぼ必ずいくつかのスケッチ例が入っています。たとえばDHT11センサーは、測った値を1本の線で、マイクロ秒単位でタイミングを取った40ビットのパケットとして送ります。そのタイミングを自分で書く代わりに、DHTライブラリをインストールしてdht.readTemperature()と書くだけで、難しい部分はライブラリがやってくれます。ライブラリとボードパッケージを混同しないでください。ボードマネージャからインストールするボードパッケージはESP32やPicoのような新しいプロセッサのファミリーをIDEに教えるもので、ライブラリは特定のハードウェアや仕事を簡単にするものです。Arduinoのライブラリは3つの場所から来ます。

WireやSPI、ESP32のWiFiライブラリなど、ボードパッケージに付属するライブラリはインストールする必要がなく、#includeの行を書くだけで使えます。自分でインストールするライブラリは、スケッチブックの中のlibrariesフォルダに入ります。OSごとの初期設定の場所は次のとおりです。

方法1：ライブラリマネージャでライブラリをインストールする

ライブラリマネージャを使うと、Arduinoの公式のライブラリインデックスにある何千ものライブラリを検索し、1回のクリックでインストールできます。このインデックスのライブラリは決まった仕様に沿ってまとめられているので、フォルダの構成が崩れることはなく、必要なほかのライブラリ（依存ライブラリ）も自動で提案され、新しいバージョンが出るとIDEが知らせてくれます。そのため、必要なライブラリがリストにあるなら、いつもこの方法を使いましょう。例として、DHT11とDHT22のセンサー用のAdafruitのライブラリをインストールしてみます。

1. Arduino IDE 2を開き、左のサイドバーの本のアイコンをクリックします。「スケッチ」>「ライブラリをインクルード」>「ライブラリを管理」や、Ctrl+Shift+Iのショートカット（macOSではCmd+Shift+I）でも同じパネルが開きます。
2. 検索欄にDHT sensor libraryと入力します。数秒で、名前や説明にその言葉を含むライブラリがすべてカードの一覧で表示されます。
3. 各カードには、上にライブラリの名前と作者、その下に短い説明とMore info（詳細）のリンクがあります。似た名前のDHTのライブラリがいくつか表示されるので、作者がAdafruitのDHT sensor libraryのカードを選びます。
4. カードの下のバージョンの一覧には最新のバージョンが表示されています。特別な理由がなければ最新のままにして、「インストール」をクリックします。
5. IDEがInstall library dependencies（依存ライブラリのインストール）という題のウィンドウを開き、このライブラリにはAdafruit Unified Sensorという別のライブラリが必要だと伝えます。「全てをインストール」をクリックします。
6. 出力パネルにダウンロードの行が流れ、右下にSuccessfully installed library DHT sensor library:1.4.7のような通知が表示されます。カードにはインストールしたバージョンが表示されます。

依存ライブラリのウィンドウでの選択は大切です。Install without dependencies（依存ライブラリなしでインストール）を選ぶと本体のライブラリだけがインストールされ、コンパイルするとAdafruit_Sensor.h: No such file or directoryになります。DHTライブラリのファイルの1つが、そのヘッダーをインクルードしているからです。依存の連鎖が何段にもなることもあります。Adafruit SSD1306のOLEDライブラリはAdafruit GFX Libraryを必要とし、それがさらにAdafruit BusIOを必要とします。「全てをインストール」をクリックすれば、IDEは連鎖全体を一度にインストールします。わざと依存ライブラリを省くのでなければ、いつもこの選択肢を使いましょう。

一覧が多すぎるときは、検索欄の上の2つの絞り込みが便利です。

同じ名前のライブラリから正しいものを選ぶ

ライブラリマネージャにDHTとだけ入力すると何十もの結果が出ますし、LiquidCrystal I2Cで検索しても、ほとんど同じ名前のライブラリがいくつも表示されます。同じハードウェアを動かすものでも、関数の名前、コンストラクタのパラメーター、例が違います。あるライブラリ用に書かれたコードは、似た名前の別のライブラリではコンパイルできないことがよくあります。正しいものを選ぶには、次の順番で確認しましょう。

• コードの#includeの行を見る：参考にしている例に#include <LiquidCrystal_I2C.h>とあれば、そのファイルを含むライブラリが必要です。よく書かれた例は、ライブラリの名前と作者も書いています。
• 作者を確認する：Adafruit、SparkFun、Arduino、Espressifなどのよく知られた名前や部品のメーカーは、たいてい最も資料がそろい、最も長く保守されているライブラリを公開しています。
• More infoのリンクを開く：ライブラリのページで、最後の更新日、未解決の課題（issue）、対応しているボードを確認します。何年も更新されていないライブラリは、ESP32やPicoで問題を起こすことがあります。
• バージョンの履歴を見る：バージョンの一覧が長ければ、ライブラリが定期的に開発されていることがわかります。バージョンが1つだけで説明が空のライブラリは避けましょう。
• まずライブラリ自体の例を試す：インストールしたら、その例の1つをコンパイルします。例はコンパイルできるのに自分のコードができないなら、そのコードはおそらく別のライブラリ用に書かれています。

この混乱の最もよく知られた例がI2C LCDです。ライブラリマネージャのLiquidCrystal I2C（Frank de Brabander）はlcd.init()で表示を始めます。GitHubで出回っている同じライブラリの別の版では、代わりにパラメーターなしのlcd.begin()を使います。その版用に書かれたコードをライブラリマネージャのライブラリでコンパイルすると、エラーno matching function for call to 'LiquidCrystal_I2C::begin()'（該当する関数がない）になります。直し方は簡単で、lcd.begin()をlcd.init()に変えるか、インストールしたライブラリの例から始めます。配線とI2Cアドレスの見つけ方はI2C LCDディスプレイの使い方で詳しく解説しています。

インストールを確かめる：2つのライブラリで温度を表示

ライブラリが正しくインストールされたかを一番速く確かめるには、それを使う小さなスケッチをコンパイルすることです。下のコードは、DHT11で読んだ温度と湿度を16x2のI2C LCDに表示します。ライブラリマネージャからDHT sensor library（依存ライブラリも）とLiquidCrystal I2Cをインストールし、DHT11のデータピンをArduino Unoの2番ピンに、LCDのSDAとSCLのピンをA4とA5につなぎます。これらのピンがボードのどこにあるかはピン配置ツールで確認できます。

1// Gereken kütüphaneler / Required libraries (Kütüphane Yöneticisi / Library Manager):
2//   DHT sensor library (Adafruit) + Adafruit Unified Sensor
3//   LiquidCrystal I2C (Frank de Brabander)
4#include <Wire.h>                  // kart paketiyle gelir / bundled with the board package
5#include <DHT.h>                   // DHT sensor library
6#include <LiquidCrystal_I2C.h>     // LiquidCrystal I2C
7
8#define DHT_PIN 2                  // DHT11 veri pini / DHT11 data pin
9#define DHT_TYPE DHT11             // DHT22 için DHT22 yaz / write DHT22 for a DHT22
10
11DHT dht(DHT_PIN, DHT_TYPE);
12LiquidCrystal_I2C lcd(0x27, 16, 2);    // adres, sütun, satır / address, columns, rows
13
14void setup() {
15  Serial.begin(9600);
16  dht.begin();
17  lcd.init();                      // bu kütüphanede begin() değil init() / init(), not begin(), in this library
18  lcd.backlight();                 // arka ışığı aç / backlight on
19  lcd.print(F("Kutuphaneler OK"));
20  delay(1500);
21}
22
23void loop() {
24  float t = dht.readTemperature(); // santigrat / Celsius
25  float h = dht.readHumidity();    // bağıl nem % / relative humidity %
26
27  if (isnan(t) || isnan(h)) {      // sensör cevap vermedi / sensor did not respond
28    Serial.println(F("DHT okunamadi / DHT read failed"));
29    delay(2000);
30    return;
31  }
32
33  lcd.clear();
34  lcd.setCursor(0, 0);             // sütun 0, satır 0 / column 0, row 0
35  lcd.print(F("Sicaklik: "));
36  lcd.print(t, 1);
37  lcd.print(F(" C"));
38  lcd.setCursor(0, 1);             // ikinci satır / second row
39  lcd.print(F("Nem: %"));
40  lcd.print(h, 0);
41
42  Serial.print(t);
43  Serial.print(F(" C  "));
44  Serial.print(h);
45  Serial.println(F(" %"));
46  delay(2000);                     // DHT11 en fazla saniyede bir ölçer / DHT11 measures at most once per second
47}

先頭の#includeの行は、どのライブラリのファイルを追加するかをコンパイラに伝えます。Wire.hはボードパッケージに付属しているので別にインストールする必要はなく、DHT.hとLiquidCrystal_I2C.hは今インストールしたライブラリから来ます。「検証」をクリックして出力パネルにSketch uses ... bytesの行が出れば、すべてのライブラリが見つかっています。赤いNo such file or directoryのメッセージが出たら、下のエラーの章に進みましょう。センサーのしくみとDHT22との違いはDHT11温湿度センサーで解説しています。

方法2：.ZIPファイルからライブラリを追加する

ライブラリマネージャにないライブラリもあります。まだインデックスに追加されていない新しいライブラリ、センサーのメーカーが自分のサイトで公開しているドライバ、本や講座や先生からもらった独自のライブラリなどです。これらはふつうGitHubか、ただの.zipファイルで配布されています。Arduino IDEは、アーカイブを展開して正しいフォルダに入れるところまで自分でやってくれます。

1. ライブラリのGitHubのページで緑のCodeボタンをクリックし、Download ZIPを選びます。ページにReleasesの欄があれば、そこから安定版のzipをダウンロードするほうが安全です。
2. ダウンロードしたファイルは展開せずにそのままにしておきます。zipはIDEが自分で展開し、このメニューはフォルダを受け付けません。
3. Arduino IDEで「スケッチ」>「ライブラリをインクルード」>「.ZIP形式のライブラリをインストール...」を開きます。
4. 開いたウィンドウで、ダウンロードした.zipファイルを選び、「開く」をクリックします。
5. インストールに成功すると、右下にSuccessfully installed library from ... archive（アーカイブからインストールしました）の通知が出ます。同じ名前のライブラリがすでにあると、上書きするかをIDEが聞いてきます。インストール済みの版を新しいものに替えたいなら、了承しましょう。
6. 「ファイル」>「スケッチ例」>「カスタムライブラリのスケッチ例」でライブラリの名前を見つけて、追加されたことを確認します。

方法3：ライブラリを手でlibrariesフォルダにコピーする

手でのインストールは、インターネットのない学校のパソコン室や、友だちからUSBメモリでもらったライブラリのフォルダ、IDEが受け付けないzipファイルのときに役立ちます。やることは、ライブラリのフォルダを正しい構成で、正しい場所に置くことだけです。

1. Arduino IDEを閉じます。IDEは起動時にライブラリの一覧を調べるので、動いている間にコピーしたフォルダは認識されないことがあります。
2. ファイルを展開し、library.propertiesファイルかライブラリの.hファイルが入っているフォルダを見つけます。それがライブラリのルートフォルダです。
3. このフォルダをスケッチブックのlibrariesフォルダ（Windowsではふつう「ドキュメント」\Arduino\libraries）にコピーします。librariesフォルダがなければ自分で作ります。名前は小文字でちょうどlibrariesにする必要があります。
4. フォルダの名前の-masterや-mainの接尾辞を消します。たとえばIRremote-masterをIRremoteに変えます。ライブラリのフォルダの名前は英字か数字で始まり、基本の英字、数字、アンダースコア、ドット、ハイフンだけで、最大63文字にする必要があります。スペースやアクセント付きの文字、日本語は使わないでください。
5. IDEをもう一度開き、「ファイル」>「スケッチ例」のメニューにライブラリが表示されるか確認します。

ライブラリのバージョンを変える：更新と巻き戻し

ライブラリは時間とともに進化し、大きなバージョンの変更では、関数の名前が変わったり動きが変わったりすることがあります。ネットで見つけた例が数年前のバージョン用に書かれていると、最新のバージョンではコンパイルできなかったり、コンパイルできてもおかしな動きをしたりします。その場合は、コードが書かれたバージョンに戻すか、コードを新しいバージョンに合わせます。ライブラリマネージャなら、数回のクリックでバージョンを切り替えられます。

1. ライブラリマネージャでライブラリの名前を検索するか、タイプの絞り込みをInstalledにします。カードにインストール済みのバージョンが表示されます。
2. カードの下のバージョンの一覧を開きます。ライブラリの公開済みのすべてのバージョンがOther Versions（ほかのバージョン）の下に並んでいます。
3. 使いたいバージョンを選び、「インストール」をクリックします。IDEは古いバージョンを消して選んだものをインストールします。librariesフォルダには、1つのライブラリにつき1つのバージョンしか置けません。
4. 起動時、IDEがUpdates are available for some of your libraries.（一部のライブラリに更新があります）という通知を出すことがあります。そこからまとめて更新する前に、動いているプロジェクトがどのバージョンに頼っているかをメモしておきましょう。まとめての更新では、多くのライブラリの大きなバージョンが一度に変わることがあります。
5. ライブラリを完全に消すには、カードにマウスを重ねてRemove（削除）をクリックします。IDEが確認を求め、librariesからフォルダを削除します。

コードがどのバージョン用に書かれたかを残す一番の方法は、ファイルの先頭のコメントにライブラリの名前とバージョンを書いておくことです。マクロでバージョンを知らせるライブラリもあり、たとえばArduinoJsonはARDUINOJSON_VERSION_MAJORを定義しています。下のスケッチは、違う大きなバージョンがインストールされているとわかりやすいメッセージでビルドを止め、正しいバージョンなら小さなJSONの文字列を作り、ライブラリのバージョンをシリアルモニタに表示します。

1// ArduinoJson 7.x (Benoit Blanchon) gerekir / requires ArduinoJson 7.x
2#include <ArduinoJson.h>
3
4#if ARDUINOJSON_VERSION_MAJOR < 7
5#error "Bu kod ArduinoJson 7 ister, Kutuphane Yoneticisinden surumu degistir / This sketch needs ArduinoJson 7"
6#endif
7
8void setup() {
9  Serial.begin(115200);
10  while (!Serial) {}                     // yerel USB'li kartlarda seri portu bekle / wait for native USB serial
11
12  JsonDocument doc;                      // 7.x: boyut vermek gerekmez / 7.x: no capacity needed
13  doc["sensor"] = "DHT11";
14  doc["sicaklik"] = 23.5;
15  doc["nem"] = 48;
16
17  serializeJson(doc, Serial);            // {"sensor":"DHT11","sicaklik":23.5,"nem":48}
18  Serial.println();
19  Serial.print(F("ArduinoJson: "));
20  Serial.println(ARDUINOJSON_VERSION);   // ör. / e.g. 7.4.2
21}
22
23void loop() {
24}

この方法なら、クラスメイトやネットでコードを共有したとき、違うバージョンをインストールした人には、わかりにくいエラーの代わりに、何をすべきかを伝える1行が表示されます。コマンドラインが好きなら、Arduino CLIで特定のバージョンを直接インストールできます：arduino-cli lib install "DHT sensor [email protected]"。どのライブラリのどのバージョンが実際に使われているかを見るには、「基本設定」でコンパイル時の詳細な出力をオンにします。ビルドの最後に、ライブラリごとにUsing library ... at version ... in folder: ...の行が表示されます。

No such file or directoryエラーとその直し方

ライブラリを追加するときに最もよく見るエラーです。#includeの行で求められたファイルを、コンパイラがどのライブラリのフォルダでも見つけられないと、出力パネルにfatal error: DHT.h: No such file or directoryとcompilation terminated.が表示され、右下にCompilation error: DHT.h: No such file or directoryの通知が出ます。メッセージのファイル名で、どのライブラリが足りないかがわかります。そのファイルがいつも自分の書いた行から来るとは限らないことも覚えておきましょう。インストールしたライブラリが、別のライブラリをインクルードしていることもあります。

Multiple libraries were foundの警告の意味は？

このメッセージは、コードの#includeの行を満たせるライブラリが2つ以上あるときに表示されます。たとえば、前のプロジェクトで古いServoライブラリを「ドキュメント」フォルダにインストールしていると、IDEの組み込みのServoライブラリと合わせて候補が2つになり、出力にMultiple libraries were found for "Servo.h"と、続いてUsed: C:\Users\<user>\Documents\Arduino\libraries\ServoとNot used: C:\Users\<user>\AppData\Local\Arduino15\libraries\Servoが表示されます。これはエラーではなく情報で、ビルドは続きます。問題になるのは、Used（使用）の行のライブラリが使いたいものではない場合だけです。IDEはおおよそ次の順番で選びます。

• Usedの行を読む：使われているフォルダは期待どおりのライブラリですか？そうなら何もする必要はなく、メッセージは無視してかまいません。
• 余分なコピーを消す：間違ったライブラリが選ばれているなら、ライブラリマネージャで見つけてRemoveをクリックするか、IDEを閉じた状態でスケッチブックのlibrariesフォルダからそのフォルダを削除します。
• 古いIDEの名残に注意：Arduino IDE 1.8のころに手でコピーした古いライブラリは「ドキュメント」フォルダに残っていて、場所の優先順位のため、IDEの最新の組み込みのライブラリより優先されてしまいます。
• 同じライブラリのコピーを2つ置かない：librariesフォルダにIRremoteとIRremote-masterのように2つのコピーがあると、ライブラリマネージャはそのライブラリを更新できず、重複を手で消すよう求めます。
• 消す前にバックアップする：フォルダを削除する代わりに、まずデスクトップに一時的に移しましょう。すべて動けば、あとで消せばよいのです。

ライブラリのスケッチ例を開き、コードにライブラリを追加する

ライブラリを一番速く学ぶ方法は、そのスケッチ例です。例はインストールしたバージョンに付属しているので、ネットのコードと違い、いつもインストール済みのバージョンに合っています。「ファイル」>「スケッチ例」のメニューは選んだボードに合わせて作られ、次のセクションがあります。

• 組み込みのスケッチ例：01.Basicsや02.Digitalなど、IDEの基本の例です。Blinkもここにあります。
• ボードの名前のセクション（例：Arduino Unoのスケッチ例）：IDEと選んだボードのパッケージに付属するライブラリの例です。Unoを選んでいればServo、EEPROM、SoftwareSerialが、ESP32を選んでいればWiFi、WebServer、Preferencesがここにあります。
• カスタムライブラリのスケッチ例：自分でインストールしたライブラリの例です。たとえばDHT sensor library > DHTtesterです。

インストールしたライブラリの例は、ライブラリマネージャのカードの横にある3点のメニューからも開けます。例は新しいウィンドウで開きます。変えて保存しようとすると、IDEは新しい名前と場所を聞いてきます。例のファイルはライブラリのフォルダに読み取り専用で置かれているからです。自分のスケッチにライブラリを追加するには、「スケッチ」>「ライブラリをインクルード」のメニューでライブラリの名前をクリックするだけです。IDEが必要な#includeの行をコードの先頭に書いてくれます。複数のヘッダーファイルを含むライブラリもあり、このメニューで何行も追加されることがありますが、使わない行は消してかまいません。

ESP32でのライブラリの互換性

ESP32もArduino IDEでプログラムするので、ほとんどのライブラリ、特にI2C、SPI、単線で通信するセンサーやディスプレイのライブラリは、そのままESP32で動きます。問題を起こすのは、Arduino UnoのATmega328Pプロセッサのタイマーやレジスタに直接触れるライブラリです。ライブラリのlibrary.propertiesファイルにESP32のアーキテクチャが見当たらないと、IDEはビルドの最初にWARNING: library LiquidCrystal I2C claims to run on avr architecture(s) and may be incompatible with your current board which runs on esp32 architecture(s)（今のボードと互換性がない可能性がある）という警告を表示します。これは警告にすぎません。LiquidCrystal I2CはWireライブラリしか使わないので、ESP32でも問題なく動きます。一方、ServoライブラリはThis library only supports boards with an AVR, SAM, SAMD, NRF52で始まる#errorのメッセージで、わざとビルドを止めます。また、ESP32のボードパッケージに付属するWiFi、WebServer、HTTPClient、Preferences、BluetoothSerialのライブラリを、ライブラリマネージャからインストールしないでください。同じ名前のほかのライブラリは混乱のもとになるだけです。

同じスケッチをUno、ESP32、Picoで使いたいなら、ボードパッケージが定義するアーキテクチャのマクロで、ボードごとに正しいライブラリを選べます。ESP32のパッケージはARDUINO_ARCH_ESP32を、Picoのarduino-picoのパッケージはARDUINO_ARCH_RP2040を、UnoやNanoなどのAVRのボードはARDUINO_ARCH_AVRを定義します。下のサーボのスケッチは3つのボードすべてでコンパイルできます。ESP32では、ESP32Servoライブラリをインストールするだけです。

1// Aynı kod Uno, ESP32 ve Pico'da / Same sketch on Uno, ESP32 and Pico
2#if defined(ARDUINO_ARCH_ESP32)
3  #include <ESP32Servo.h>            // Kütüphane Yöneticisi: ESP32Servo / Library Manager: ESP32Servo
4  const int SERVO_PIN = 18;          // güvenli bir GPIO / a safe GPIO
5#elif defined(ARDUINO_ARCH_RP2040)
6  #include <Servo.h>                 // arduino-pico paketiyle gelir / bundled with the arduino-pico core
7  const int SERVO_PIN = 15;          // GP15
8#else
9  #include <Servo.h>                 // IDE ile gelir (Uno, Nano, Mega) / bundled with the IDE
10  const int SERVO_PIN = 9;
11#endif
12
13Servo servo;
14
15void setup() {
16#if defined(ARDUINO_ARCH_ESP32)
17  servo.setPeriodHertz(50);          // yalnız ESP32: 50 Hz servo sinyali / ESP32 only: 50 Hz servo signal
18#endif
19  servo.attach(SERVO_PIN, 500, 2400); // darbe aralığı mikrosaniye / pulse range in microseconds
20}
21
22void loop() {
23  servo.write(0);    delay(1000);    // 0 derece / 0 degrees
24  servo.write(90);   delay(1000);    // orta konum / center
25  servo.write(180);  delay(1000);    // 180 derece / 180 degrees
26}

ESP32では、ライブラリのバージョンがボードパッケージのバージョンに合っていることも大切です。ESP32のボードパッケージの3.xのシリーズではPWM（LEDC）の関数が変わり、ledcSetup()とledcAttachPin()が削除されてledcAttach()に置き換えられました。そのため、古い関数を使うライブラリの版や例は、3.xではエラー'ledcSetup' was not declared in this scope（宣言されていない）で失敗します。現在のESP32Servoの版は3.xのボードパッケージ用に書かれています。直すには、ライブラリの現在の版に移るか、古いプロジェクトをそのままビルドする必要があるなら、ボードマネージャでesp32のパッケージを2.xの最後の版である2.0.17に下げます。ボードのピンと最初のWi-FiのプロジェクトはESP32とは？に、サーボの配線と電源はサーボモーターとは？にあります。

Raspberry Pi Picoでのライブラリ：Arduino IDEとMicroPython

PicoをArduino IDE（Earle F. PhilhowerのRaspberry Pi Pico/RP2040/RP2350のボードパッケージ）でプログラムするなら、ライブラリはUnoと同じ方法でインストールし、同じlibrariesフォルダに入ります。このパッケージのアーキテクチャ名はrp2040で、Pico 2のRP2350チップも同じ名前を使います。Wire、SPI、Servo、EEPROM、PIOを使ったSoftwareSerialはボードパッケージに入っていて、Pico WではWiFiライブラリもすぐに使えます。Adafruitのセンサーやディスプレイのライブラリのほとんどは、Picoでも問題なく動きます。AVRのレジスタに触れるライブラリは、ここでも動きません。PicoではEEPROMがフラッシュで模擬されるので、EEPROM.begin()で始め、EEPROM.commit()で変更を保存します。

MicroPythonでは、ライブラリはPicoのファイルシステムにある.py（またはコンパイル済みの.mpy）ファイルで、ふつう/libフォルダに置きます。machine、time、dht、onewire、ds18x20、neopixel、framebufなどのモジュールはMicroPythonに付属しています。全体の一覧を見るには、ThonnyのShellにhelp("modules")と入力しましょう。一覧にないドライバは、4つの方法で追加できます。

1# Pico W: kütüphane yoksa karttan kur, sonra dene / Pico W: install the library from the board if missing, then test
2import time
3
4try:
5    import ssd1306                          # zaten kurulu mu? / already installed?
6except ImportError:
7    import network, mip
8    wlan = network.WLAN(network.STA_IF)
9    wlan.active(True)
10    wlan.connect("AG_ADI", "SIFRE")         # kendi Wi-Fi ağın / your own Wi-Fi network
11    for _ in range(40):                     # en fazla 20 sn bekle / wait up to 20 s
12        if wlan.isconnected():
13            break
14        time.sleep(0.5)
15    if not wlan.isconnected():              # ağa bağlanamadı / could not join the network
16        raise RuntimeError("Wi-Fi baglantisi yok / no Wi-Fi connection")
17    mip.install("ssd1306")                  # /lib klasörüne iner / lands in /lib
18    import ssd1306
19
20from machine import Pin, I2C
21
22i2c = I2C(0, sda=Pin(4), scl=Pin(5), freq=400000)   # GP4 = SDA, GP5 = SCL
23oled = ssd1306.SSD1306_I2C(128, 64, i2c)
24oled.fill(0)                                 # ekranı temizle / clear the screen
25oled.text("Kutuphane OK", 0, 0)
26oled.show()                                  # ekrana gönder / push to the screen

コードの最初の部分はssd1306のモジュールをインポートしようとし、なければPico WをWi-Fiにつなぎ、micropython-libからライブラリをダウンロードしてから、ディスプレイに文字を書きます。Wi-FiのないPicoでは、パソコンからThonnyかmpremoteで同じことをします。OLEDの配線と描画の命令はOLEDディスプレイ（SSD1306）の使い方に、MicroPythonの基本の命令とファイルシステムはMicroPythonの基本にあります。初めてPicoをセットアップするなら、Raspberry Pi Picoとは？から始めましょう。

ライブラリを追加するときのよくある間違い

• ライブラリはインストールしたのにボードパッケージを忘れる：ESP32やPico用のライブラリをインストールしても、IDEにボードは追加されません。まずボードマネージャからボードパッケージを、それからライブラリをインストールしましょう。
• 依存ライブラリを飛ばす：Install without dependenciesは、Adafruit_Sensor.hやAdafruit_I2CDevice.hのようなファイルが足りないというエラーの最も多い原因です。
• 先に展開してから.ZIPのメニューを使う：このメニューはzipファイルしか受け付けません。フォルダならlibrariesフォルダに手でコピーしましょう。
• ライブラリを違う場所に置く：スケッチのフォルダ、デスクトップ、IDEのインストール先のフォルダにコピーしたライブラリは見つかりません。正しい場所はスケッチブックのlibrariesフォルダです。
• 同じライブラリのコピーが複数ある：IRremoteとIRremote-masterのような2つのフォルダがあると、Multiple librariesの警告が出て、違うバージョンが使われます。どちらかを消しましょう。
• 何でもかまわず更新する：大きなバージョンが上がる更新で、動いていたプロジェクトが壊れることがあります。更新の前にライブラリのリリースノートに目を通しましょう。
• 自作のライブラリにアクセント付きの文字やスペース：自分でライブラリを書くなら、フォルダとファイルの名前には基本の英字、数字、アンダースコアだけを使いましょう（日本語も避けます）。

Arduinoライブラリのインストールに慣れれば、新しいセンサーやディスプレイも数分の作業です。ライブラリマネージャで正しい作者のライブラリを見つけ、依存ライブラリと一緒にインストールし、まずライブラリ自体の例を試し、それから自分のコードに進みましょう。BlueGraysアプリには、DHT11での温度と湿度、I2C LCD、サーボモーター、RFIDカードリーダー、赤外線リモコン、WS2812BのLED、OLEDのPongゲームなど、ライブラリを使うプロジェクトが、回路図とステップごとに説明したコード付きで用意されています。