README.md 1.75 KB

U8g2 Package Test

About

This is a test application for the U8g2 package. This package is a graphical display library, including display drivers.

Usage

This test application will initialize the U8g2 to output on one of the following:

  • output to terminal virtual screen.
  • output to SDL virtual screen.
  • output to I2C graphics screen.
  • output to SPI graphics screen.

Note: you may have to run make clean between different output modes.

Output to terminal

To output to this virtual screen, supply TEST_OUTPUT=1 to the make command.

Output to SDL

To output to this virtual screen, supply TEST_OUTPUT=2 to the make command.

This is a native-only option and requires SDL (32-bits) to be installed.

Output to SPI

To output to screen, supply TEST_OUTPUT=3 to the make command.

  • TEST_SPI — The SPI device.
  • TEST_PIN_CS — If applicable, the CS pin.
  • TEST_PIN_DC — If applicable, the Command/Data pin.
  • TEST_PIN_RESET — If applicable, the reset pin.
  • TEST_DISPLAY — The used display driver (see https://github.com/olikraus/u8g2/wiki/u8g2setupc). Make sure you select a SPI compatible display.

Output to I2C

To output to screen, supply TEST_OUTPUT=4 to the make command.

Furthermore, you can configure the following:

  • TEST_I2C — The I2C device.
  • TEST_ADDR — The address to write commands to.
  • TEST_PIN_RESET — If applicable, the reset pin.
  • TEST_DISPLAY — The used display driver (see https://github.com/olikraus/u8g2/wiki/u8g2setupc). Make sure you select an I2C compatible display.

Expected result

The output of this test depends on the output mode and used hardware. If it works, the application cycles through three screens with the text: 'This is RIOT-OS'.