Arduinoライブラリインストール完全ガイド：ステップバイステップ解説

Arduinoは数千のライブラリを備えたIDEにより、多くのDIY愛好家に支持される人気マイコンです。本記事では、Arduino IDEライブラリの意義と、ライブラリのインストール方法を詳しく解説します。

Arduinoライブラリとは？

図1：ホビーユーザー向けArduino電子プラットフォーム

Arduinoライブラリは、マイコンボードの機能を簡素化するコード集です。各ライブラリのインストールフォルダをダウンロードすることでアクセス可能。ユーザーはゼロからコードを書く手間から解放されます。代表例としてLiquidCrystalライブラリ、CapacitiveSensorライブラリなどがあり、メニューの「Arduino Library Reference」から全ライブラリフォルダにアクセスできます。

ライブラリはZIPファイル形式で配布されるため、ダウンロード後は解凍してインストールします。

Arduinoライブラリのインストール：種類と方法

ステップ1：Arduinoライブラリの種類

図2：ホビーユーザー向けArduino電子プラットフォーム

主に2種類あります。

標準ライブラリ

プリインストール済みで、基本通信機能などの一般的機能ドキュメントフォルダを備えます。キャラクタLCD、サーボモーターなど一般的なハードウェアもサポート。

ユーザーインストールライブラリ

ライブラリマネージャーで追加機能にアクセス可能。標準ライブラリでカバーされないハードウェア・ドライバ向けの追加ライブラリです。GitHub、Google Code、Arduino Playgroundなどのサードパーティライブラリが利用できます。

これらはスケッチブックの「libraries」フォルダに保存する必要があり、全Arduino IDEバージョンで使用可能になります。

ライブラリ例のダウンロード先

図3：Arduinoボード用ライブラリをダウンロード可能

以下からZIPライブラリ一覧にアクセスできます。

• 製品ページからダウンロード

有効なインストールが必要な製品を使用している場合、ダウンロードボタンをクリックして取得。通常は以下のようなボタンです。

「手動インストール」ボタンをクリックするとダウンロード開始。

• GitHubからダウンロード

図4：GitHubからもライブラリをダウンロード可能

GitHubはほぼ全Arduinoライブラリのリポジトリとして機能するライブラリマネージャー。インストール時は「Clone or download」ボタン→「Download ZIP」を選択。

ステップ2：ライブラリのインストール場所

コンパイラが容易に見つけられるフォルダにインストールしてください。スケッチブックフォルダを特定します。Arduino IDEはスケッチをここに保存し、インストール時に自動作成されます。

• Linux：ホームタブに「Sketchbook」
• Windows/Mac：ドキュメントフォルダ内に「Arduino」

ユーザーインストールライブラリはスケッチブックの「libraries」フォルダに保存され、IDEはここからライブラリを検出します。

ステップ3：ライブラリの追加

以下の2手順で追加可能。

• ZIPライブラリの追加

ZIPライブラリをダウンロード後、Arduino IDEで「スケッチ」→「ライブラリをインクルード」→「.ZIP形式のライブラリをインストール」を選択。ZIPファイルを指定し、正しくインストールされれば「ライブラリがライブラリフォルダに追加されました」と表示。

• ライブラリフォルダを手動追加

ZIPライブラリのルートフォルダに.cpp/.hファイルがない場合、Arduinoは認識しません。手動追加が必要です。ZIPを解凍し、ライブラリフォルダを保存先にコピー。正しく追加されればデモが表示されます。

ステップ4：Windowsへのライブラリインストール

まずArduino IDEを終了（起動時のみライブラリをスキャンするため、開いたままだと認識されない）。ZIPファイルをダウンロード・解凍しデスクトップに配置。完了したら「Librariesフォルダ」にコピー＆ペースト。

ステップ5：ライブラリ名の変更

フォルダ名にハイフン（-）があるとIDEが認識しないため、アンダースコア（_）等に変更。GitHub Masterフォルダを「AFMotor」等の任意名にリネーム。AFMotor.hとAFMotor.cppファイルの存在を確認。

ステップ6：コンパイル確認

IDEを再起動し、チェックマークアイコンでコンパイル確認。

結論

Arduinoライブラリのインストール手順と重要ポイントを詳しく解説しました。ご不明点やご質問はお気軽にお問い合わせください。