#WioTerminal – Convert and use images on the device 📺🖼️

Hi !

Time to write about Wio Terminal. Today, something that tricked me a little, so here are my lessons learned about how to use images on the device.

Using images is super simple, just follow this steps

  • Installing the SD Card library for Wio Terminal
  • Installing the TFT LCD Library For Wio Terminal
  • Use the following code as a reference to show images
#include "Seeed_FS.h" //Including SD card library
#include"RawImage.h"  //Including image processing library
TFT_eSPI tft;
void setup() {
    //Initialise SD card
    if (!SD.begin(SDCARD_SS_PIN, SDCARD_SPI)) {
        while (1);

    //To draw on 8-bit color image on screen, starting from point (x, y):
    drawImage<uint8_t>("image1.bmp", x, y);
    //To draw on 16-bit color image on screen, starting from point  (x, y):
    drawImage<uint16_t>("image1.bmp", x, y); 
void loop() {

Super easy ! this sample is part of the [loading images] code sample in the Seeed Wiki (see references).

However, this is the moment when I start to have some questions.

Where do I store my images?

Images should be stored in a SD Card. The card must be formatted in FAT12, FAT16, FAT32 or exFAT. And then, just insert the card in the device.

Then, you can use the drawimage() function with the specific path to the images in the SD Card.

Standard BMP images won’t work

This is the tricky part, we need to preprocess the images before. There are 2 ways to do this.

  1. Navigate to [Online image converter for Wio Terminal] and upload your files.
  2. Download the bmp_converter.py file, and run the file locally to convert the files.

And that’s it. 5 seconds later, you can show a custom BMP in your device.

wioterminal show image

Happy coding!


El Bruno

More posts in my blog ElBruno.com.


¿Con ganas de ponerte al día?

En Lemoncode te ofrecemos formación online impartida por profesionales que se baten el cobre en consultoría:

Leave a comment

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.

%d bloggers like this: