Pixel Dex Scanner: OLED Display & Sensors

What you need

From the Starter Pack: ESP32, breadboard, wires, USB-C cable, buttons, buzzer.

From this kit: 0.96” SSD1306 OLED, IR obstacle sensor, 3D-printed Pokédex case.

Step 1: Wire the OLED (I2C)

The OLED uses I2C — just 4 wires:

   OLED Display (0.96" SSD1306)
   ┌─────────────────────────┐
   │  ┌─────────────────┐    │
   │  │                 │    │
   │  │    OLED SCREEN  │    │
   │  │    128 x 64 px  │    │
   │  │                 │    │
   │  └─────────────────┘    │
   │  VCC GND SDA SCL        │
   └──┬───┬───┬───┬──────────┘
      │   │   │   │
      │   │   │   └──── GPIO 22
      │   │   └──────── GPIO 21
      │   └──────────── GND
      └──────────────── 3.3V

   Pin mapping:
   ┌────────────┬────────────┐
   │ OLED Pin   │ ESP32 Pin  │
   ├────────────┼────────────┤
   │ VCC        │ 3.3V       │
   │ GND        │ GND        │
   │ SDA        │ GPIO 21    │
   │ SCL        │ GPIO 22    │
   └────────────┴────────────┘

   Breadboard layout:
   ┌─────────────────────────────────────────┐
   │  + + + + + + + + + + + + + + + + + + +  │
   │  - - - - - - - - - - - - - - - - - - -  │
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  · · · · [VCC][GND][SDA][SCL] · · · ·  │ ← OLED pins
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  · · · · · · · · · · · · · · · · · · ·  │
   │  + + + + + + + + + + + + + + + + + + +  │
   │  - - - - - - - - - - - - - - - - - - -  │
   └─────────────────────────────────────────┘

Step 2: Wire the IR sensor

   IR Obstacle Sensor
   ┌─────────────────────────┐
   │  ┌─────────────────┐    │
   │  │  ○   IR LED   ○ │    │
   │  │     ┌─────┐     │    │
   │  │     │SENSOR│     │    │
   │  │     └─────┘     │    │
   │  └─────────────────┘    │
   │  VCC GND OUT            │
   └──┬───┬───┬──────────────┘
      │   │   │
      │   │   └──── GPIO 14
      │   └──────── GND
      └──────────── 3.3V

   Pin mapping:
   ┌────────────┬────────────┐
   │ Sensor Pin │ ESP32 Pin  │
   ├────────────┼────────────┤
   │ VCC        │ 3.3V       │
   │ GND        │ GND        │
   │ OUT        │ GPIO 14    │
   └────────────┴────────────┘

Step 3: Install the OLED library

1. Go to Sketch → Include Library → Manage Libraries
2. Search for “SSD1306”
3. Install Adafruit SSD1306
4. Also install Adafruit GFX Library (dependency)

Step 4: First pixels on screen

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

#define SCREEN_WIDTH 128
#define SCREEN_HEIGHT 64
#define OLED_RESET -1

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

void setup() {
  display.begin(SSD1306_SWITCHCAPVCC, 0x3C);
  display.clearDisplay();
  display.setTextSize(1);
  display.setTextColor(SSD1306_WHITE);
  display.setCursor(0, 0);
  display.println("POKEDEX v1.0");
  display.println("Scanning...");
  display.display();
}

void loop() {
  // We'll add scanning here
}

Result: “POKEDEX v1.0 / Scanning…” appears on the OLED.

Step 5: Draw pixel art

A simple Pokémon silhouette as a 16x16 bitmap:

// Pikachu silhouette (16x16)
static const unsigned char pikachu[] PROGMEM = {
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
};

void displayPokemon() {
  display.clearDisplay();
  display.drawBitmap(32, 0, pikachu, 64, 64, SSD1306_WHITE);
  display.display();
}

Result: A pixel art Pokémon silhouette appears on screen.

Step 6: Add scanning

int scanCount = 0;

void loop() {
  if (digitalRead(14) == LOW) {  // IR sensor detects object
    scanCount++;
    display.clearDisplay();
    display.setCursor(0, 0);
    display.print("SCAN #");
    display.println(scanCount);
    display.println("Pokemon found!");
    display.drawBitmap(32, 20, pikachu, 64, 64, SSD1306_WHITE);
    display.display();

    tone(5, 880, 100);  // scan sound
    delay(1000);
  }
}

Result: Point the scanner at something — when it detects an object, it displays a Pokémon and increments the scan count.

Step 7: Assemble the Pokédex

   Pokédex Case Assembly:
   ┌─────────────────────────────────────────┐
   │                                         │
   │  ┌─────────────────────────────────┐    │
   │  │         TOP HALF                │    │
   │  │  ┌─────────────────────────┐    │    │
   │  │  │      OLED SCREEN        │    │    │
   │  │  │      (visible)          │    │    │
   │  │  └─────────────────────────┘    │    │
   │  │         IR SENSOR → ○           │    │
   │  └───────────────┬─────────────────┘    │
   │                  │ hinge                │
   │  ┌───────────────┴─────────────────┐    │
   │  │         BOTTOM HALF             │    │
   │  │  ┌─────────────────────────┐    │    │
   │  │  │      ESP32 BOARD        │    │    │
   │  │  │      (hidden)           │    │    │
   │  │  └─────────────────────────┘    │    │
   │  │         BUZZER                  │    │
   │  └─────────────────────────────────┘    │
   │                                         │
   └─────────────────────────────────────────┘

   Wiring summary:
   ┌────────────┬────────────┐
   │ Component  │ ESP32 Pin  │
   ├────────────┼────────────┤
   │ OLED VCC   │ 3.3V       │
   │ OLED GND   │ GND        │
   │ OLED SDA   │ GPIO 21    │
   │ OLED SCL   │ GPIO 22    │
   │ IR VCC     │ 3.3V       │
   │ IR GND     │ GND        │
   │ IR OUT     │ GPIO 14    │
   │ Buzzer +   │ GPIO 5     │
   │ Buzzer -   │ GND        │
   └────────────┴────────────┘

1. Fit the OLED into the top half of the clamshell case
2. Mount the IR sensor behind the sensor window
3. Wire everything to the ESP32 in the bottom half
4. Connect the hinge
5. Open and close it like a real Pokédex

Customise it

• Draw your own pixel art using pixilart.com
• Add more Pokémon silhouettes and cycle through them
• Use the buzzer to play the Pokédex entry sound
• Log scan data to the serial monitor

What’s next?

Combine with the Pokéball Signal Tower to build a Full Pokédex Station — OLED screen + LED ring in one unit.