DEV Community


u8g2 Software Package|A monochrome graphics library for embedded devices.

abby06 profile image Abby ・3 min read

Alt Text


U8g2 is a monochrome graphics library for embedded devices. U8g2 supports Monochrome LCD, OLED, and eInk Library. Now it is ported on RT-Thread to satisfy different development requirements.

Game Development (examples/games/space_trash)

Alt Text

Alt Text

User Interface (examples/page_buffer/icon_menu)
Alt Text

Drawing (examples/page_buffer/graphic_test)
Alt Text

1、U8G2 Features

1.1 Supports Multi-screens, easy to Port.

The advantage of using u8g2 is that it supports nearly 200 monochrome screens, and same code can run directly on different screens:

  • Classic screen 128x64
    Alt Text

  • OLED SSD1306 I2C

Alt Text

Click HERE for a full list of supporting screens.

1.2 Supports Many Fonts.
Alt Text

Alt Text

Alt Text

Alt Text

1.3 Supports Many Drawing Functions.
Supports a variety of drawing functions, and comes with a variety of icons.

Alt Text

Alt Text

Summarize the features of u8g2:

  • Support for nearly 200 monochrome screens, making it easy to port.
  • Supports a variety of drawing functions, images and non-operation, with user key detection.
  • Unicode and utf8 are supported, with more than 100 fonts and over 100 icons.


2.1 Catalog Structure

Alt Text

2.2 License


  • The repository and optionally the releases contain icons, which are derived from the WPZOOM Developer Icon Set. WPZOOM Developer Icon Set by WPZOOM is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.


  • Fonts are licensed under different conditions.for detailed information on the licensing conditions for each font.



2.3 Dependence

Note: If you need to use the I2C LCD screen you need to turn on the I2C, and use GPIO to simulate I2C.

  • Using I2C device drivers
  • Use GPIO to simulate I2C Note: If you use the SPI LCD, you need to turn on the SPI.
  • Using SPI Bus/Device device drivers

3、How to use U8G2?

You will need to select u8g2 package on the RT-Thread package manager, the specific path is shown as follows:

RT-Thread online packages
    peripheral libraries and drivers --->
        [*] U8G2: a u8g2 package for rt-thread
            [*] Use hardware spi                                     
              (spi1)  spi bus name (NEW)              
              (spi10) spi device name (NEW)     
            [*] Use hardware i2c          
              (i2c2)  i2c device name
            U8G2 Examples  --->

Then, RT-Thread’s package manager will update automatically, or you can manually update the package to the BSP by entering the pkgs-update command.

There are 50 routines that you can see in the source docs directory. The default routines are using the software I2C, if you feel that the speed of software I2C is relatively slow you can use the hardware I2C.

4、 Notes

  • Use the BSP in the stm32 directory.
  • Turned on -std=c99 when compiling.
  • If you feel that the flash is not large enough when compiling, you can turn on the optimization option -O3 or refer to HERE to remove the extra word library.
  • The full API manual can be accessed at this LINK.

RT-Thread Contact Info:

Website | Github | Twitter | Facebook | Youtube

Discussion (0)

Editor guide