はじめに (対象読者・この記事でわかること)

この記事は、Arduinoを使った電子工作やプログラミングを始めたばかりの初心者の方、特に「#include <Mouse.h>というスケッチを記述したはずなのに、Arduino IDEでコンパイルエラーが出て認識されない！」という問題に直面している方を対象にしています。

この記事を読むことで、なぜMouse.hライブラリが認識されないのか、その根本的な原因を理解することができます。また、この問題を解決するための具体的な方法と、今後同様の問題に遭遇しないためのボード選びの知識を身につけることができます。マウスやキーボードといったPCの入力デバイスをArduinoで制御したいという夢の実現に向けて、一緒に第一歩を踏み出しましょう。

前提知識

この記事を読み進める上で、以下の知識があるとスムーズです。 - Arduino IDEの基本的な操作方法（スケッチの記述、コンパイル、書き込み） - ArduinoボードにLEDを点滅させる程度の基本的なプログラミング経験

Arduinoでマウスを制御するHID機能とMouseライブラリの概要

Arduinoは、その柔軟性から様々なデバイスとの連携が可能です。中でも「HID（Human Interface Device）」機能は、ArduinoをPCのマウスやキーボードとして振る舞わせることを可能にする非常に魅力的な機能です。例えば、物理的なボタンを押したらPCのマウスカーソルが動く、特定のセンサーの値に応じてキーボードの文字を入力するといった面白い応用ができます。

このHID機能を実現するためのライブラリの一つがMouse.hです。このライブラリをスケッチにインクルードすることで、Arduinoがマウスの動きやクリックイベントをPCに送信できるようになります。しかし、ここで重要な注意点があります。すべてのArduinoボードがこのHID機能をネイティブにサポートしているわけではないという点です。一般的なArduino UnoやNanoといったボードは、USB-シリアル変換チップを介してPCと通信するため、直接的なHIDデバイスとして認識されることができません。この互換性の違いが、#include <Mouse.h>が認識されないという問題の根源となることが多いのです。

#include <Mouse.h>が認識されない問題の深掘りと解決策

それでは、#include <Mouse.h>が認識されないという問題に焦点を当て、その具体的な原因と解決策を詳しく見ていきましょう。多くのArduino初心者が一度は経験するであろうこの問題は、実はボードの種類に起因することがほとんどです。

ステップ1: 問題の再現とエラーメッセージの確認

まず、あなたが経験したであろうコンパイルエラーを再現してみましょう。以下のシンプルなスケッチをArduino IDEに記述し、コンパイル（検証）してみてください。

Cpp

#include <Mouse.h> // マウスライブラリをインクルード

void setup() {
  // マウス機能の初期化
  Mouse.begin(); 
}

void loop() {
  // マウスカーソルを右に1ピクセル動かす
  Mouse.move(1, 0, 0); 
  delay(10); // 短い遅延
}

このスケッチをコンパイルすると、以下のようなエラーメッセージが表示されるはずです（ボードの種類によって多少異なりますが、似たような内容です）。

'Mouse' was not declared in this scope

あるいは、#include <Mouse.h>の行で「No such file or directory」といったエラーが出ることもあります。これらのエラーは、Arduino IDEが現在選択されているボードに対してMouse.hライブラリが見つからない、または利用できないと判断していることを示しています。

ステップ2: 原因の特定 - ボードの互換性

このエラーの主な原因は、先述の通り使用しているArduinoボードがUSB-HID機能をネイティブにサポートしていないことにあります。

  • USB-HID非対応ボードの例: Arduino Uno, Arduino Nano, Arduino Mega2560など これらのボードは、ATmega328PやATmega2560といったマイクロコントローラを搭載しており、PCとのUSB通信はFTDIチップやATmega16U2といった専用のUSB-シリアル変換チップを介して行われます。そのため、ボード自身がマウスやキーボードとしてPCに認識される機能を持っていません。Mouse.hやKeyboard.hといったHID関連のライブラリは、これらのボードでは使用できません。

  • USB-HID対応ボードの例: Arduino Leonardo, Arduino Micro, Arduino Due, Arduino Esplora, ESP32-S2/S3 など これらのボードは、マイクロコントローラ自身がUSBコントローラ機能を内蔵しており、直接PCにHIDデバイスとして認識されることができます。そのため、Mouse.hやKeyboard.hといったHID関連のライブラリを問題なく使用できます。特に、LeonardoやMicroはUnoと同じような開発環境で使えるため、HID機能を試すのに非常に人気があります。

ハマった点やエラー解決

多くの初心者がArduino Unoから始めるため、この「Mouseライブラリが使えない」という壁にぶつかりがちです。Arduino IDEのエラーメッセージは一見すると「Mouseというものが定義されていない」とだけ表示されるため、ライブラリのインクルードミスや書き間違いを疑ってしまうかもしれません。しかし、実際はボードの種類が原因であることがほとんどです。

重要なのは、エラーメッセージの意味を正しく理解することです。「'Mouse' was not declared in this scope」は、コンパイラがMouseという名前を認識できないという意味であり、これは「Mouse.hライブラリが有効になっていないか、その機能が利用できない」という状況を示唆しています。

解決策: USB-HID対応ボードへの切り替え

最も確実で直接的な解決策は、USB-HID機能をネイティブにサポートしているArduinoボードを使用することです。

1. 対応ボードの選択

Mouse.hライブラリを使用したい場合は、以下のいずれかのボードを用意しましょう。 - Arduino Leonardo - Arduino Micro - Arduino Due - Arduino Esplora - ESP32-S2 や ESP32-S3 (ただし、これらのボードはArduino互換ボードですが、別途専用のボードマネージャーのインストールが必要です)

2. Arduino IDEでのボード変更

新しいボードを手に入れたら、Arduino IDEで適切なボードを選択する必要があります。

  1. Arduino IDEを開きます。
  2. メニューバーの「ツール(Tools)」をクリックします。
  3. 「ボード(Board)」のサブメニューから、あなたが使用するHID対応ボード（例: 「Arduino Leonardo」）を選択します。 Arduino IDE ボード選択の例

3. スケッチの再コンパイルと動作確認

ボードの選択が完了したら、先ほどのエラーが出たスケッチをもう一度コンパイル（検証）し、書き込み（アップロード）してみてください。 正しくボードが選択されていれば、今度はエラーなくコンパイルが完了し、Arduinoにスケッチが書き込まれるはずです。書き込みが成功したら、Mouse.move(1, 0, 0); の記述があればPCのマウスカーソルが少しずつ右に動くのを確認できるでしょう。

補足: Arduino UnoなどでどうしてもHID機能を実現したい場合は、Firmwareを書き換えてUSB-HIDデバイスとして動作させるなど、より高度な方法もありますが、これは上級者向けであり、元のUnoの機能（シリアル通信）が使えなくなる可能性があるため、まずは対応ボードを使用することを強くお勧めします。

まとめ

本記事では、Arduino IDEで#include <Mouse.h>が認識されないという問題の原因と具体的な解決策について解説しました。

  • Mouse.hライブラリはArduinoのHID機能（USB-マウス機能）を提供します。
  • Arduino UnoやNanoなどの一般的なボードは、このHID機能をネイティブにサポートしていません。
  • この問題を解決するには、Arduino LeonardoやMicroなどのUSB-HID対応ボードを使用する必要があります。

この記事を通して、あなたはMouse.hライブラリが認識されない理由を理解し、適切なボードを選択することで、その問題を解決できるようになりました。今後は、Arduinoを使ってPCのマウスを制御するだけでなく、Keyboard.hライブラリを使ってキーボード入力をシミュレートするなど、さらに発展的なプロジェクトに挑戦できるようになるでしょう。

参考資料