01なぜOLED表示でつまずくのか

結論から言うと、Arduinoで有機ELディスプレイ（OLED）に何も表示されない場合、原因の大半は「I2Cアドレスの指定間違い」と「SDA・SCLの配線ミス」の2つに集約されます。よく使われるSSD1306搭載のOLEDモジュールは、製品によってI2Cアドレスが0x3Cまたは0x3Dのいずれかに設定されており、サンプルコードのアドレスがそのまま自分のモジュールに合うとは限りません。

この後の章では、OLEDとSSD1306の基本、表示の仕組み、SH1106など類似デバイスとの違い、そして実際に文字を表示するまでの手順を順番に解説していきます。

02OLED（SSD1306）とArduinoの基礎知識

OLED（有機ELディスプレイ）とは、電圧をかけると自ら発光する有機化合物を使ったディスプレイです。バックライトが不要なため消費電力が少なく、黒い部分が完全に発光しないコントラストの高さが特徴で、Arduinoのようなマイコンでの小型情報表示によく使われます。

SSD1306は、こうしたモノクロ有機ELディスプレイを制御するための代表的なドライバICです。Adafruit社が公開しているArduino向けライブラリ「Adafruit_SSD1306」は、128×64および128×32ピクセルのモノクロSSD1306搭載OLEDに対応しており、I2CまたはSPIで通信できると公式リポジトリで説明されています。文字や図形の描画には、このライブラリと組み合わせて使う「Adafruit GFX Library」も必要です。

Arduinoは、イタリア発のオープンソースハードウェアプラットフォームで、趣味の電子工作からプロトタイピングまで幅広く使われるマイコンボードとその開発環境（Arduino IDE）を指します。OLEDのようなI2Cデバイスとの通信には、Arduino標準の「Wire」ライブラリが使われ、多くのArduinoボードではSDA・SCLという2本の信号線でI2C通信を行います。

03表示の仕組みと技術的背景

ArduinoからOLEDに文字を表示する処理は、大きく分けて「①I2CでSSD1306に接続する」「②画面バッファに描画内容を書き込む」「③バッファの内容を一括で画面に転送する」という3段階で成り立っています。Adafruit_SSD1306ライブラリを使った基本的なコードは次のようになります。

#include <Wire.h>
#include <Adafruit_GFX.h>
#include <Adafruit_SSD1306.h>

#define SCREEN_WIDTH 128   // OLEDの横ピクセル数
#define SCREEN_HEIGHT 64   // OLEDの縦ピクセル数（128x32モデルの場合は32）
#define OLED_RESET    -1   // リセットピン未使用の場合は-1
#define SCREEN_ADDRESS 0x3C // I2Cアドレス（0x3Cまたは0x3D。要スキャン確認）

Adafruit_SSD1306 display(SCREEN_WIDTH, SCREEN_HEIGHT, &Wire, OLED_RESET);

void setup() {
  // ディスプレイを初期化。アドレスが違うと何も表示されない
  if (!display.begin(SSD1306_SWITCHCAPVCC, SCREEN_ADDRESS)) {
    Serial.println("SSD1306の初期化に失敗しました");
    while (true); // 停止
  }

  display.clearDisplay();        // 画面バッファをクリア
  display.setTextSize(1);        // 文字サイズ（1〜複数倍で指定）
  display.setTextColor(SSD1306_WHITE); // モノクロOLEDでは白のみ
  display.setCursor(0, 0);       // 描画開始座標(x, y)
  display.println("Hello, OLED!");
  display.display();             // バッファの内容を実際の画面に転送
}

void loop() {
}

ポイントはdisplay.print()やdisplay.drawLine()などの描画関数を呼んだ時点ではまだ画面に反映されず、最後にdisplay.display()を呼び出して初めてバッファの内容が画面に転送されるという点です。この2段階方式により、複数の描画を組み合わせてから一括で画面を更新でき、ちらつきを抑えられます。

もう一つの重要なポイントがI2Cアドレスです。Adafruit SSD1306のサンプルスケッチではデフォルトでI2Cアドレスが0x3Dに指定されているが、実際のハードウェアでは0x3Cで動作するケースが多く、アドレスが合わない場合は表示されないことが複数の技術記事で報告されています。手元のモジュールの実アドレスが分からない場合は、Arduinoコミュニティで広く使われているI2Cスキャナースケッチを実行することで、接続されているI2Cデバイスのアドレスを特定できます。

04比較：SSD1306／SH1106／有機ELとLCD

※「初心者への向きやすさ」欄は編集部見解によるものです。購入したモジュールのドライバICは商品ページや基板の刻印で必ず確認してください。

結論として、購入したOLEDモジュールがSSD1306搭載であれば、情報量が多くコミュニティのサポートも厚いAdafruit_SSD1306ライブラリから始めるのが最短ルートです。SH1106搭載モジュールを誤ってSSD1306用コードで動かそうとすると、表示が歪んだり真っ暗のままになったりすることがあるため、購入前に型番を確認しておくと余計なトラブルシューティングを避けられます。

05実践：5ステップで文字を表示する

06注意点・よくある誤解

07よくある質問