DEV Community

Cover image for u8g2 Software Package | A Monochrome Graphics Library

u8g2 Software Package | A Monochrome Graphics Library

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 OpenSource IoTOS to satisfy different development requirements.

Game Development (examples/games/space_trash)



User Interface (examples/page_buffer/icon_menu)


Drawing (examples/page_buffer/graphic_test)


1、U8G2 Features

1.1Supports 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




See here for a full list of supporting screens.

1.2 Supports Many Fonts.





1.3 Supports Many Drawing Functions.

Supports a variety of drawing functions, and comes with a variety of icons.



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 Catelog Structure

Item Description
docs Docs Catelog
examples Examples Catelog
src Source Code Catelog
port A catelog of ported code for a specific platform.

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.

Check Full LICENCE here.

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 pacakge 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

RT-Thread Contact Info:

Website | Github | Twitter | Facebook

Discussion (0)

Editor guide