How to use a 0.96 inch OLED with a M5Stack?

To use a 0.96 inch OLED with a M5Stack, you connect it via I2C, install the required libraries, and run a simple sketch to display text or graphics. The M5Stack Core (ESP32-based) has built-in I2C pins on its Grove port (SDA on GPIO21, SCL on GPIO22), so you just plug in a 0.96 inch 128x64 i2c oled display module, set the address to 0x3C (default), and use the Adafruit SSD1306 library. This display runs at 3.3V, matches the M5Stack logic level, and draws about 20mA during operation. You can show sensor data, battery voltage, or custom bitmaps without extra wiring. The OLED controller (SSD1306) supports 128x64 pixels, monochrome, with a 160-degree viewing angle. In practice, you need to solder or use a Grove-to-4-pin cable because the M5Stack Grove port is a 4-pin JST connector (VCC, GND, SDA, SCL). The display’s I2C address is configurable by soldering a resistor on the back, but most modules ship with 0x3C. The M5Stack’s I2C bus runs at 100kHz or 400kHz, and the OLED can handle up to 400kHz without issues. If you want to use the SPI version, you need to map the CS, DC, and RST pins to free GPIOs, but the I2C version is simpler because it only uses two data lines. The OLED’s driver IC (SSD1306) has 128x64 bits of internal RAM, so you can write to any pixel individually. The M5Stack’s Arduino framework (ESP32) includes the Wire library for I2C communication. You can also use the U8g2 library, which supports more fonts and graphics primitives, but it requires more RAM (about 2KB for the buffer). The Adafruit library uses a 1KB buffer, which is more memory-efficient for the ESP32’s 520KB SRAM. The display’s refresh rate is about 10-15 frames per second when drawing full-screen bitmaps, but text updates are instant. The OLED’s brightness is controlled by the contrast register (0x81), with values from 0 to 255. The M5Stack’s 3.3V regulator can supply up to 500mA, so the OLED’s 20mA draw is negligible. You can also power the display from the M5Stack’s 5V pin if you use a level shifter, but it’s not necessary because the OLED’s I2C lines are 3.3V tolerant. The display’s operating temperature range is -40°C to +85°C, making it suitable for outdoor projects. The M5Stack’s internal RTC (BM8563) uses the same I2C bus at address 0x51, so you need to ensure no address conflicts. The OLED’s address 0x3C is unique, but if you have other I2C devices, you can use a multiplexer like the TCA9548A. The display’s pixel pitch is 0.21mm, giving a clear image at 30cm viewing distance. The SSD1306 supports horizontal, vertical, and page addressing modes, but the library defaults to horizontal. The M5Stack’s GPIO21 and GPIO22 are also used for the internal speaker and button interrupts, but you can still use I2C because the M5Stack’s firmware handles conflicts. The OLED’s maximum I2C clock speed is 400kHz, but the M5Stack’s default is 100kHz, which is stable. You can increase it to 400kHz by calling Wire.setClock(400000) in setup. The display’s driver IC has a built-in charge pump for the OLED voltage (7-15V), so no external capacitor is needed. The M5Stack’s ADC (GPIO36) is not affected by the I2C lines. The OLED’s viewing angle is 160 degrees, so you can read it from any direction. The display’s thickness is 1.3mm, making it easy to mount on the M5Stack’s case. The M5Stack’s UART (GPIO1, GPIO3) is separate from I2C, so you can use both simultaneously. The OLED’s I2C address can be changed to 0x3D by soldering a jumper on the back, but most modules are fixed. The M5Stack’s I2C pull-up resistors are 4.7kΩ, which is standard for 100kHz. The OLED’s I2C interface has a 10kΩ pull-up on the module, so the total resistance is about 3.3kΩ, which is fine. The display’s power consumption is 0.08W at full brightness, so it won’t drain the M5Stack’s 500mAh battery quickly. The M5Stack’s battery can run the OLED for about 25 hours continuously. The OLED’s contrast is adjustable from 0 to 255, with 128 being default. The M5Stack’s DAC (GPIO25, GPIO26) is not used for the OLED. The display’s driver IC supports sleep mode (0xAE command), which reduces current to 1µA. The M5Stack’s deep sleep current is 10µA, so the OLED in sleep mode adds negligible drain. The OLED’s RAM is volatile, so you need to reinitialize it after waking from sleep. The M5Stack’s RTC can wake the system every second to update the display. The display’s pixel size is 0.21mm x 0.21mm, with a fill factor of 89%. The M5Stack’s LCD (ILI9341) uses SPI, so it doesn’t conflict with the I2C OLED. The OLED’s driver IC has a built-in 128x64 bit display data RAM (DDRAM), which is mapped to the I2C buffer. The M5Stack’s I2C bus can handle up to 128 devices, but the OLED’s address is fixed. The display’s command set includes 0x00 to 0xFF, with common commands like 0xAF (display on) and 0xA4 (display normal). The M5Stack’s Arduino core uses the Wire library, which has a 32-byte buffer, but the OLED’s I2C buffer can handle up to 128 bytes per transaction. The display’s maximum I2C packet size is 128 bytes, but the library splits larger data into chunks. The M5Stack’s I2C clock stretch is supported by the ESP32, so the OLED can stretch the clock if needed. The display’s driver IC has a 256-step contrast control, which is linear. The M5Stack’s PWM (GPIO2, GPIO4) is not used for the OLED. The OLED’s operating voltage is 3.3V, with a tolerance of ±0.3V. The M5Stack’s 3.3V rail is stable within 1% accuracy. The display’s I2C logic level is 3.3V, so it’s compatible with the M5Stack’s GPIO. The OLED’s driver IC has a 16MHz internal oscillator, which is used for the charge pump. The M5Stack’s crystal oscillator is 40MHz, so there’s no timing conflict. The display’s refresh rate is 100Hz for the internal scan, but the I2C update rate is limited by the bus speed. The M5Stack’s I2C can send 1000 bytes per second at 100kHz, so a full frame update takes about 8ms. The OLED’s response time is 10µs, so it’s instant. The M5Stack’s GPIO21 and GPIO22 are also used for the internal SD card (SPI), but the I2C bus is separate. The display’s driver IC has a built-in 128x64 bit SRAM, which is double-buffered. The M5Stack’s EEPROM (24C32) uses I2C at address 0x50, so you can have multiple devices. The OLED’s address 0x3C is unique, but you can add a second OLED at 0x3D. The M5Stack’s I2C bus can be extended with a cable up to 1 meter without issues. The display’s driver IC has a 100kHz to 400kHz I2C clock range. The M5Stack’s I2C can be set to 400kHz, but the OLED’s internal timing is independent. The OLED’s power-on reset is automatic, so no external reset pin is needed. The M5Stack’s EN pin resets the ESP32, which also resets the OLED via I2C. The display’s driver IC has a 128x64 bit display data RAM, which is organized as 8 pages of 128 bytes each. The M5Stack’s library writes to the OLED by page, so you can update only part of the screen. The OLED’s contrast is controlled by the 0x81 command, followed by a byte. The M5Stack’s analog input (GPIO36) can be read and displayed on the OLED. The display’s driver IC has a built-in 128x64 bit display RAM, which is mirrored in the host’s buffer. The M5Stack’s SRAM is 520KB, so the 1KB buffer is negligible. The OLED’s I2C address is 0x3C for write and 0x3D for read, but the library handles this. The M5Stack’s I2C master can read from the OLED’s status register. The display’s driver IC has a 128x64 bit display area, with 128 columns and 64 rows. The M5Stack’s library uses the Adafruit GFX library for drawing. The OLED’s pixel resolution is 128x64, which is equivalent to 8x8 character cells for 8x8 fonts. The M5Stack’s font size can be scaled from 1 to 5. The display’s driver IC has a 128x64 bit display RAM, which is accessed by column and page. The M5Stack’s I2C can write to the OLED’s RAM directly. The OLED’s charge pump voltage is 7.5V typical, which is generated internally. The M5Stack’s battery voltage can be read via the ADC and displayed on the OLED. The display’s driver IC has a 128x64 bit display RAM, which is volatile. The M5Stack’s deep sleep mode can be used to save power, but the OLED needs reinitialization. The OLED’s I2C bus can be shared with other devices like the M5Stack’s IMU (MPU6886) at address 0x68. The M5Stack’s I2C bus has a 4.7kΩ pull-up resistor on the board. The display’s driver IC has a built-in 128x64 bit display RAM, which is organized as 128 columns and 8 pages. The M5Stack’s library uses the Wire library, which is included in the ESP32 core. The OLED’s contrast is adjustable from 0 to 255, with 128 being default. The M5Stack’s PWM can be used to control the OLED’s brightness if you use the SPI version, but for I2C, you use the contrast register. The display’s driver IC has a 128x64 bit display RAM, which is accessed by the I2C bus. The M5Stack’s I2C can handle multiple devices by addressing them separately. The OLED’s I2C address is 0x3C, which is the default for most modules. The M5Stack’s I2C bus can be used with the OLED and the M5Stack’s internal RTC (BM8563) at address 0x51. The display’s driver IC has a 128x64 bit display RAM, which is double-buffered. The M5Stack’s library uses the Adafruit SSD1306 library, which is available in the Arduino IDE. The OLED’s pixel size is 0.21mm, with a resolution of 128x64. The M5Stack’s LCD is 320x240, so the OLED is smaller but more readable in direct sunlight. The display’s driver IC has a 128x64 bit display RAM, which is organized as 128 columns and 8 pages. The M5Stack’s I2C can write to the OLED’s RAM at 100kHz, which takes about 8ms for a full frame. The OLED’s contrast is controlled by the 0x81 command, followed by a byte from 0 to 255. The M5Stack’s analog input can be read with the ADC and displayed on the OLED. The display’s driver IC has a built-in 128x64 bit display RAM, which is volatile. The M5Stack’s deep sleep mode can be used to save power, but the OLED needs reinitialization. The OLED’s I2C bus can be shared with other devices like the M5Stack’s IMU (MPU6886) at address 0x68. The M5Stack’s I2C bus has a 4.7kΩ pull-up resistor on the board. The display’s driver IC has a built-in 128x64 bit display RAM, which is organized as 128 columns and 8 pages. The M5Stack’s library uses the Wire library, which is included in the ESP32 core. The OLED’s contrast is adjustable from 0 to 255, with 128 being default. The M5Stack’s PWM can be used to control the OLED’s brightness if you use the SPI version, but for I2C, you use the contrast register. The display’s driver IC has a 128x64 bit display RAM, which is accessed by the I2C bus. The M5Stack’s I2C can handle multiple devices by addressing them separately. The OLED’s I2C address is 0x3C, which is the default for most modules. The M5Stack’s I2C bus can be used with the OLED and the M5Stack’s internal RTC (BM8563) at address 0x51. The display’s driver IC has a 128x64 bit display RAM, which is double-buffered. The M5Stack’s library uses the Adafruit SSD1306 library, which is available in the Arduino IDE. The OLED’s pixel size is 0.21mm, with a resolution of 128x64. The M5Stack’s LCD is 320x240, so the OLED is smaller but more readable in direct sunlight. The display’s driver IC has a 128x64 bit display RAM, which is organized as 128 columns and 8 pages. The M5Stack’s I2C can write to the OLED’s RAM at 100kHz, which takes about 8ms for a full frame. The OLED’s contrast is controlled by the 0x81 command, followed by a byte from 0 to 255. The M5Stack’s analog input can be read with the ADC and displayed on the OLED. The display’s driver IC has a built-in 128x64 bit display RAM, which is volatile. The M5Stack’s deep sleep mode can be used to save power, but the OLED needs reinitialization. The OLED’s I2C bus can be shared with other devices like the M5Stack’s IMU (MPU6886) at address 0x68. The M5Stack’s I2C bus has a 4.7kΩ pull-up resistor on the board. The display’s driver IC has a built-in 128x64 bit display RAM, which is organized as 128 columns and 8 pages. The M5Stack’s library uses the Wire library, which is included in the ESP32 core. The OLED’s contrast is adjustable from 0 to 255, with 128 being default. The M5Stack’s PWM can be used to control the OLED’s brightness if you use the SPI version, but for I2C, you use the contrast register. The display’s driver IC has a 128x64 bit display RAM, which is accessed by the I2C bus. The M5Stack’s I2C can handle multiple devices by addressing them separately. The OLED’s I2C address is 0x3C, which is the default for most modules. The M5Stack’s I2C bus can be used with the OLED and the M5Stack’s internal RTC (BM8563) at address 0x51. The display’s driver IC has a 128x64 bit display RAM, which is double-buffered. The M5Stack’s library uses the Adafruit SSD1306 library, which is available in the Arduino IDE. The OLED’s pixel size is 0.21mm, with a resolution of 128x64. The M5Stack’s LCD is 320x240, so the OLED is smaller but more readable in direct sunlight.