Introduction
Are you looking to add precision and power to your next robotics project? Look no further than interfacing a single-axis 1:120 TT gear motor with an Arduino microcontroller. This combination will provide precise control over the motor’s movement and allow easy integration with other sensors and components to create a truly dynamic and responsive system.
In this article, we’ll get into the technical details of how to connect a 1:120 TT gear motor to an Arduino and give you a code snippet to get you started on your next robotics project. So, gear up, and let’s dive into the world of precision motion control with Arduino and gear motors.
What is an OLED IPS Display Module?
IPS stands for “In-Plane Switching,” which in the market means “High-End Full Color LCD.” IPS display technology is known for giving accurate colors from any angle and getting rid of the tailing that happens when you touch twisted nematic (TN) LCDs. Because of this benefit, most touch-screen devices, like smartphones and tablets, now use IPS panels. The images on these types of panels are also clear and stable.
Hardware Components
You will require the following hardware for Interfacing 1.3 Inch SPI OLED Full Color IPS Display Module with Arduino.
| S.no | Component | Value | Qty |
|---|---|---|---|
| 1. | Arduino UNO | – | 1 |
| 2. | 1.3 inch OLED Display Module | 240×240 | 1 |
| 3. | Breadboard | – | 1 |
| 4. | Jumper Wires | – | 1 |
1.3 Inch SPI OLED with Arduino
It’s now time to interface a 1.3-inch SPI OLED Full Color IPS Display Module with the Arduino. Hence, for this, you need to follow the given steps:
Schematic
Make connections according to the circuit diagram given below.
Wiring / Connections
| Arduino | OLED Display Module |
|---|---|
| 5V | VCC |
| GND | GND |
| D7 | DC |
| D8 | RES |
| D11 | SDA |
| D13 | SCL |
Installing Arduino IDE
First, you need to install Arduino IDE Software from its official website Arduino. Here is a simple step-by-step guide on “How to install Arduino IDE“.
Installing Libraries
Before you start uploading a code, download and unzip the following libraries at /Progam Files(x86)/Arduino/Libraries (default), in order to use the sensor with the Arduino board. Here is a simple step-by-step guide on “How to Add Libraries in Arduino IDE“.
Code
Now copy the following code and upload it to Arduino IDE Software.
/*
Modified on Dec 8, 2020
Modified by MehranMaleki from Arduino Examples
Home
*/
// ST7789 library example
// (c) 2019-20 Pawel A. Hernik
/*
ST7789 240x240 IPS (without CS pin) connections (only 6 wires required):
#01 GND -> GND
#02 VCC -> VCC (3.3V only!)
#03 SCL -> D13/SCK
#04 SDA -> D11/MOSI
#05 RES -> D8 or any digital
#06 DC -> D7 or any digital
#07 BLK -> NC
*/
#define SCR_WD 240
#define SCR_HT 240
#include <SPI.h>
#include <Adafruit_GFX.h>
#if (__STM32F1__) // bluepill
#define TFT_DC PA1
#define TFT_RST PA0
//#include <Arduino_ST7789_STM.h>
#else
#define TFT_DC 7
#define TFT_RST 8
#include <Arduino_ST7789_Fast.h>
//#include <Arduino_ST7789.h>
#endif
Arduino_ST7789 tft = Arduino_ST7789(TFT_DC, TFT_RST);
// ------------------------------------------------
unsigned long FillScreenTest()
{
unsigned long start = millis();
for(int i=0;i<5;i++) {
tft.fillScreen(RED);
tft.fillScreen(GREEN);
tft.fillScreen(BLUE);
tft.fillScreen(YELLOW);
}
return millis()-start;
}
// ------------------------------------------------
unsigned long ClearScreenTest()
{
unsigned long start = millis();
for(int i=0;i<5*4;i++)
tft.fillScreen(BLACK);
return millis()-start;
}
// ------------------------------------------------
const uint16_t imgF[] PROGMEM = {0xF800,0xF840,0xF8A0,0xF900,0xF960,0xF9C0,0xFA20,0xFA80,0xFAE0,0xFB40,0xFBA0,0xFC00,0xFC60,0xFCC0,0xFD20,0xFD80,0xFDE0,0xFE40,0xFEA0,0xFF00,0xFF60,0xFFC0,0xFFE0,0xEFE0,0xE7E0,0xD7E0,0xCFE0,0xBFE0,0xB7E0,0xA7E0,0x9FE0,0x8FE0,0x87E0,0x77E0,0x6FE0,0x5FE0,0x57E0,0x47E0,0x3FE0,0x2FE0,0x27E0,0x17E0,0xFE0,0x7E0,0x7E1,0x7E3,0x7E4,0x7E6,0x7E7,0x7E9,0x7EA,0x7EC,0x7ED,0x7EF,0x7F0,0x7F2,0x7F3,0x7F5,0x7F6,0x7F8,0x7F9,0x7FB,0x7FC,0x7FE,0x7FF,0x79F,0x73F,0x6DF,0x67F,0x61F,0x5BF,0x55F,0x4FF,0x49F,0x43F,0x3DF,0x37F,0x31F,0x2BF,0x25F,0x1FF,0x19F,0x13F,0xDF,0x7F,0x1F,0x81F,0x101F,0x201F,0x281F,0x381F,0x401F,0x501F,0x581F,0x681F,0x701F,0x801F,0x881F,0x981F,0xA01F,0xB01F,0xB81F,0xC81F,0xD01F,0xE01F,0xE81F,0xF81F,0xF81F,0xF81D,0xF81C,0xF81A,0xF819,0xF817,0xF816,0xF814,0xF813,0xF811,0xF810,0xF80E,0xF80D,0xF80B,0xF80A,0xF808,0xF807,0xF805,0xF804,0xF802,0xF801,
0xF800,0xF840,0xF8A0,0xF900,0xF960,0xF9C0,0xFA20,0xFA80,0xFAE0,0xFB40,0xFBA0,0xFC00,0xFC60,0xFCC0,0xFD20,0xFD80,0xFDE0,0xFE40,0xFEA0,0xFF00,0xFF60,0xFFC0,0xFFE0,0xEFE0,0xE7E0,0xD7E0,0xCFE0,0xBFE0,0xB7E0,0xA7E0,0x9FE0,0x8FE0,0x87E0,0x77E0,0x6FE0,0x5FE0,0x57E0,0x47E0,0x3FE0,0x2FE0,0x27E0,0x17E0,0xFE0,0x7E0,0x7E1,0x7E3,0x7E4,0x7E6,0x7E7,0x7E9,0x7EA,0x7EC,0x7ED,0x7EF,0x7F0,0x7F2,0x7F3,0x7F5,0x7F6,0x7F8,0x7F9,0x7FB,0x7FC,0x7FE,0x7FF,0x79F,0x73F,0x6DF,0x67F,0x61F,0x5BF,0x55F,0x4FF,0x49F,0x43F,0x3DF,0x37F,0x31F,0x2BF,0x25F,0x1FF,0x19F,0x13F,0xDF,0x7F,0x1F,0x81F,0x101F,0x201F,0x281F,0x381F,0x401F,0x501F,0x581F,0x681F,0x701F,0x801F,0x881F,0x981F,0xA01F,0xB01F,0xB81F,0xC81F,0xD01F,0xE01F,0xE81F,0xF81F,0xF81F,0xF81D,0xF81C,0xF81A,0xF819,0xF817,0xF816,0xF814,0xF813,0xF811,0xF810,0xF80E,0xF80D,0xF80B,0xF80A,0xF808,0xF807,0xF805,0xF804,0xF802,0xF801};
uint16_t img[SCR_WD+16];
unsigned long DrawImageTest()
{
for(int i=0;i<SCR_WD+16;i++) img[i] = tft.rgbWheel(500L*i/SCR_WD);
unsigned long start = millis();
for(int i=0;i<5*4;i++) for(int y=0;y<SCR_HT;y++) tft.drawImage(0,y,SCR_WD,1,img+(((y>>2)+i)&0xf));
return millis()-start;
}
// ------------------------------------------------
unsigned long DrawImageFTest()
{
unsigned long start = millis();
for(int i=0;i<5*4;i++) for(int y=0;y<SCR_HT;y++) tft.drawImageF(0,y,SCR_WD,1,imgF+(((y>>2)+i)&0xf));
return millis()-start;
}
// ------------------------------------------------
// original Adafruit
unsigned long orig[14]={ 5872, 5872, 1468292,394696,2938532,132952,121996,4068208,925276,1319512, 1278096,1930524,602080,4649200 };
// pre 18.09.2020 Fast
//unsigned long orig[14]={2645,3577,661616,114064,579036,56216,49500,1830864,222936,259340,175460,903348,138264,1853300};
unsigned long res[14];
void result(int i)
{
Serial.print(res[i]);
if(res[i]<1000000) Serial.print("\t");
Serial.print("\t\t\t");
Serial.print(100*orig[i]/res[i]);
Serial.println("%");
}
void setup(void)
{
Serial.begin(9600);
Serial.println(F("IPS 240x240 ST7789"));
//tft.reset();
//tft.init(SCR_WD, SCR_HT);
tft.begin();
tft.fillScreen(BLACK);
tft.setCursor(0, 0);
tft.setTextColor(WHITE); tft.setTextSize(2);
tft.println("IPS 240x240 ST7789");
tft.println("Library Benchmark");
tft.println("starts in 3s ...");
delay(3000);
Serial.println(F("Benchmark Time (microseconds)"));
res[0]=FillScreenTest();
Serial.print(F("FillScreen Mbps "));
Serial.println(String(res[0])+"ms "+String(1000*20.0/res[0]) "+String(1000*20.0/res[0]) +"fps "+String(20.0*SCR_WD*SCR_HT*16/res[0]/1000.0) "+String(20.0*SCR_WD*SCR_HT*16/res[0]/1000.0) +" Mbps\t"+100*orig[0]/res[0]+"%");
//for(int i=0;i<100;i++) tft.fillRect(i,i,SCR_WD-i*2,SCR_HT-i*2,tft.rgbWheel(i*10)); delay(1000);
res[1]=ClearScreenTest();
Serial.print(F("ClearScreen Mbps "));
Serial.println(String(res[1])+"ms "+String(1000*20.0/res[1]) "+String(1000*20.0/res[1]) +"fps "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0) "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0) +" Mbps\t"+100*orig[1]/res[1]+"%");
res[1]=DrawImageTest();
Serial.print(F("DrawImage Mbps "));
Serial.println(String(res[1])+"ms "+String(1000*20.0/res[1]) "+String(1000*20.0/res[1]) +"fps "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0) "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0) +" Mbps\t"+100*orig[1]/res[1]+"%");
res[1]=DrawImageFTest();
Serial.print(F("DrawImageF Mbps "));
Serial.println(String(res[1])+"ms "+String(1000*20.0/res[1]) "+String(1000*20.0/res[1]) +"fps "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0) "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0) +" Mbps\t"+100*orig[1]/res[1]+"%");
res[2]=testFillScreen();
Serial.print(F("Screen fill "));
result(2);
delay(500);
res[3]=testText();
Serial.print(F("Text "));
result(3);
delay(3000);
res[4]=testLines(CYAN);
Serial.print(F("Lines "));
result(4);
delay(500);
res[5]=testFastLines(RED, BLUE);
Serial.print(F("Horiz/Vert Lines "));
result(5);
delay(500);
res[6]=testRects(GREEN);
Serial.print(F("Rectangles (outline) "));
result(6);
delay(500);
res[7]=testFilledRects(YELLOW, MAGENTA);
Serial.print(F("Rectangles (filled) "));
result(7);
delay(500);
res[8]=testFilledCircles(10, MAGENTA);
Serial.print(F("Circles (filled) "));
result(8);
res[9]=testCircles(10, WHITE);
Serial.print(F("Circles (outline) "));
result(9);
delay(500);
res[10]=testTriangles();
Serial.print(F("Triangles (outline) "));
result(10);
delay(500);
res[11]=testFilledTriangles();
Serial.print(F("Triangles (filled) "));
result(11);
delay(500);
res[12]=testRoundRects();
Serial.print(F("Rounded rects (outline) "));
result(12);
delay(500);
res[13]=testFilledRoundRects();
Serial.print(F("Rounded rects (filled) "));
result(13);
delay(500);
Serial.println(F("Done!"));
Serial.println(F("Results:"));
for(int i=0;i<14;i++) { Serial.print(res[i]); Serial.print(","); }
Serial.println();
int c1=YELLOW, c2=WHITE;
tft.fillScreen(BLACK);
tft.setCursor(0, 0);
tft.setTextSize(2);
tft.setTextColor(CYAN);
tft.println("RESULTS:");
tft.setTextSize(1);
tft.println();
tft.setTextColor(GREEN);
tft.println(F("Benchmark Time (us)"));
tft.setTextColor(c1); tft.print(F("FillScreen Mbps "));
tft.setTextColor(c2); tft.println(String(res[0])+"ms "+String(20.0*SCR_WD*SCR_HT*16/res[0]/1000.0)+" Mbps");
//tft.setTextColor(c1); tft.print(F("ClearScreen Mbps "));
//tft.setTextColor(c2); tft.print(String(res[1])+"ms "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0)+" Mbps");
tft.setTextColor(c1); tft.print(F("DrawImageF Mbps "));
tft.setTextColor(c2); tft.println(String(res[1])+"ms "+String(20.0*SCR_WD*SCR_HT*16/res[1]/1000.0)+" Mbps");
tft.setTextColor(c1); tft.print(F("Screen fill "));
tft.setTextColor(c2); tft.println(res[3]);
tft.setTextColor(c1); tft.print(F("Text "));
tft.setTextColor(c2); tft.println(res[4]);
tft.setTextColor(c1); tft.print(F("Lines "));
tft.setTextColor(c2); tft.println(res[5]);
tft.setTextColor(c1); tft.print(F("Horiz/Vert Lines "));
tft.setTextColor(c2); tft.println(res[6]);
tft.setTextColor(c1); tft.print(F("Rectangles (outline) "));
tft.setTextColor(c2); tft.println(res[8]);
tft.setTextColor(c1); tft.print(F("Rectangles (filled) "));
tft.setTextColor(c2); tft.println(res[9]);
tft.setTextColor(c1); tft.print(F("Circles (filled) "));
tft.setTextColor(c2); tft.println(res[10]);
tft.setTextColor(c1); tft.print(F("Circles (outline) "));
tft.setTextColor(c2); tft.println(res[11]);
tft.setTextColor(c1); tft.print(F("Triangles (outline) "));
tft.setTextColor(c2); tft.println(res[12]);
tft.setTextColor(c1); tft.print(F("Triangles (filled) "));
tft.setTextColor(c2); tft.println(res[13]);
tft.setTextColor(c1); tft.print(F("Rounded rects (outline) "));
tft.setTextColor(c2); tft.println(res[14]);
tft.setTextColor(c1); tft.print(F("Rounded rects (filled) "));
tft.setTextColor(c2); tft.println(res[15]);
tft.setTextColor(RED); tft.println(F("Done!"));
}
/*
Optimizations from 18.9.2020
-- IPS 240x240 ST7789, back to old setAddrWindow() with writeSPI, flash: 28,550
Benchmark Time (microseconds)
FillScreen Mbps 2609ms 7.67fps 7.06 Mbps 225%
ClearScreen Mbps 2609ms 7.67fps 7.06 Mbps 225%
DrawImage Mbps 2740ms 7.30fps 6.73 Mbps 214%
DrawImageF Mbps 3579ms 5.59fps 5.15 Mbps 164%
Screen fill 652528 225%
Text 109748 359%
Lines 572992 512%
Horiz/Vert Lines 54696 243%
Rectangles (outline) 47916 254%
Rectangles (filled) 1805552 225%
Circles (filled) 208212 444%
Circles (outline) 255744 515%
Triangles (outline) 173468 736%
Triangles (filled) 880160 219%
Rounded rects (outline) 135920 442%
Rounded rects (filled) 1819660 255%
Done!
Results:
2609,3579,652528,109748,572992,54696,47916,1805552,208212,255744,173468,880160,135920,1819660,
-- IPS 240x240 ST7789 + back to old drawPixel, flash: 28,456
Benchmark Time (microseconds)
FillScreen Mbps 2609ms 7.67fps 7.06 Mbps 225%
ClearScreen Mbps 2609ms 7.67fps 7.06 Mbps 225%
DrawImage Mbps 2750ms 7.27fps 6.70 Mbps 213%
DrawImageF Mbps 3588ms 5.57fps 5.14 Mbps 163%
Screen fill 652540 225%
Text 114004 346%
Lines 609216 482%
Horiz/Vert Lines 54884 242%
Rectangles (outline) 48216 253%
Rectangles (filled) 1805640 225%
Circles (filled) 213896 432%
Circles (outline) 272036 485%
Triangles (outline) 184020 694%
Triangles (filled) 885728 217%
Rounded rects (outline) 142432 422%
Rounded rects (filled) 1821976 255%
Done!
Results:
2609,3588,652540,114004,609216,54884,48216,1805640,213896,272036,184020,885728,142432,1821976,
-- IPS 240x240 ST7789 - all previous + no _x/ystart in setAddrWindow(), flash: 28,462
Benchmark Time (microseconds)
FillScreen Mbps 2609ms 7.67fps 7.06 Mbps 225%
ClearScreen Mbps 2609ms 7.67fps 7.06 Mbps 225%
DrawImage Mbps 2749ms 7.28fps 6.70 Mbps 213%
DrawImageF Mbps 3588ms 5.57fps 5.14 Mbps 163%
Screen fill 652536 225%
Text 115248 342%
Lines 622492 472%
Horiz/Vert Lines 54876 242%
Rectangles (outline) 48216 253%
Rectangles (filled) 1805608 225%
Circles (filled) 213896 432%
Circles (outline) 278020 474%
Triangles (outline) 187872 680%
Triangles (filled) 885744 217%
Rounded rects (outline) 144708 416%
Rounded rects (filled) 1821980 255%
Done!
Results:
2609,3588,652536,115248,622492,54876,48216,1805608,213896,278020,187872,885744,144708,1821980,
-- IPS 240x240 ST7789 optimized write and copy, flash 28,506
Benchmark Time (microseconds)
FillScreen Mbps 2609ms 7.67fps 7.06 Mbps 225%
ClearScreen Mbps 2608ms 7.67fps 7.07 Mbps 225%
DrawImage Mbps 2751ms 7.27fps 6.70 Mbps 213%
DrawImageF Mbps 3592ms 5.57fps 5.13 Mbps 163%
Screen fill 652552 225%
Text 117240 336% (---)
Lines 639400 459% (---)
Horiz/Vert Lines 54968 241%
Rectangles (outline) 48364 252%
Rectangles (filled) 1805680 225%
Circles (filled) 216544 427%
Circles (outline) 285624 461%
Triangles (outline) 192788 662%
Triangles (filled) 888328 217%
Rounded rects (outline) 147748 407% (---)
Rounded rects (filled) 1823064 255%
Done!
Results:
2609,3592,652552,117240,639400,54968,48364,1805680,216544,285624,192788,888328,147748,1823064,
IPS 240x240 ST7789 Fast original before 18.9.20 changes, flash: 29,356 bytes
Benchmark Time (microseconds)
FillScreen Mbps 2645ms 7.56fps 6.97 Mbps 222%
ClearScreen Mbps 2645ms 7.56fps 6.97 Mbps 222%
DrawImage Mbps 3026ms 6.61fps 6.09 Mbps 194%
DrawImageF Mbps 3577ms 5.59fps 5.15 Mbps 164%
Screen fill 661616 221%
Text 114064 346%
Lines 579036 507%
Horiz/Vert Lines 56216 236%
Rectangles (outline) 49500 246%
Rectangles (filled) 1830864 222%
Circles (filled) 222936 415%
Circles (outline) 259340 508%
Triangles (outline) 175460 728%
Triangles (filled) 903348 213%
Rounded rects (outline) 138264 435%
Rounded rects (filled) 1853300 250%
Done!
Results:
2645,3577,661616,114064,579036,56216,49500,1830864,222936,259340,175460,903348,138264,1853300,
-- IPS 240x240 ST7789 in COMPATIBILITY mode
Benchmark Time (microseconds)
FillScreen Mbps 5361ms 3.73fps 3.44 Mbps 109%
ClearScreen Mbps 5362ms 3.73fps 3.44 Mbps 109%
DrawImage Mbps 5665ms 3.53fps 3.25 Mbps 103%
DrawImageF Mbps 5706ms 3.51fps 3.23 Mbps 102%
Screen fill 1340716 109%
Text 244268 161%
Lines 1652188 177%
Horiz/Vert Lines 114840 115%
Rectangles (outline) 101892 119%
Rectangles (filled) 3711592 109%
Circles (filled) 487852 189%
Circles (outline) 741392 177%
Triangles (outline) 494348 258%
Triangles (filled) 1614292 119%
Rounded rects (outline) 363292 165%
Rounded rects (filled) 3761392 123%
Done!
Results:
5361,5706,1340716,244268,1652188,114840,101892,3711592,487852,741392,494348,1614292,363292,3761392,
*/
/*
IPS ST7789 original:
Benchmark Time (microseconds)
FillScreen 5872ms 3.41fps
ClearScreen 5872ms 3.41fps
Screen fill 1468292
Text 394696
Lines 2938532
Horiz/Vert Lines 132952
Rectangles (outline) 121996
Rectangles (filled) 4068208
Circles (filled) 925276
Circles (outline) 1319512
Triangles (outline) 1278096
Triangles (filled) 1930524
Rounded rects (outline) 602080
Rounded rects (filled) 4649200
Done!
IPS 240x240 ST7789 optimized - FINAL
Benchmark Time (microseconds)
FillScreen 2645ms 7.56fps
ClearScreen 2645ms 7.56fps
Screen fill 661488
Text 108816
Lines 563888
Horiz/Vert Lines 56192
Rectangles (outline) 49128
Rectangles (filled) 1830804
Circles (filled) 270728
Circles (outline) 250940
Triangles (outline) 245104
Triangles (filled) 897880
Rounded rects (outline) 135416
Rounded rects (filled) 2030816
Done!
Fill speed:
240*240*2 = 115 200b *20 *8bit/2.645 ->6.9Mbps (!)
IPS 240x240 ST7789
Benchmark Time (microseconds)
FillScreen Mbps 2645ms 7.56fps 6.97 Mbps 222%
ClearScreen Mbps 2645ms 7.56fps 6.97 Mbps 222%
Screen fill 661624 221%
Text 109496 360%
Lines 563888 521%
Horiz/Vert Lines 56216 236%
Rectangles (outline) 49168 248%
Rectangles (filled) 1830880 222%
Circles (filled) 271772 340%
Circles (outline) 251000 525%
Triangles (outline) 245104 521%
Triangles (filled) 898632 214%
Rounded rects (outline) 135368 444%
Rounded rects (filled) 2031308 228%
Done!
*/
// ------------------------------------------------
void loop(void)
{
}
// ------------------------------------------------
unsigned long test FillScreen() {
unsigned long start = micros();
tft.fillScreen(BLACK);
tft.fillScreen(RED);
tft.fillScreen(GREEN);
tft.fillScreen(BLUE);
tft.fillScreen(BLACK);
return micros() - start;
}
// ------------------------------------------------
unsigned long testText() {
tft.fillScreen(BLACK);
unsigned long start = micros();
tft.setCursor(0, 0);
tft.setTextColor(WHITE); tft.setTextSize(1);
tft.println("Hello World!");
tft.setTextColor(YELLOW); tft.setTextSize(2);
tft.println(1234.56);
tft.setTextColor(RED); tft.setTextSize(3);
tft.println(0xDEADBEEF, HEX);
tft.println();
tft.setTextColor(GREEN);
tft.setTextSize(5);
tft.println("Groop");
tft.setTextSize(2);
tft.println("I implore thee,");
tft.setTextSize(1);
tft.println("my foonting turlingdromes.");
tft.println("And hooptiously drangle me");
tft.println("with crinkly bindlewurdles,");
tft.println("Or I will rend thee");
tft.println("in the gobberwarts");
tft.println("with my blurglecruncheon,");
tft.println("see if I don't!");
return micros() - start;
}
// ------------------------------------------------
unsigned long testLines(uint16_t color) {
unsigned long start, t;
int x1, y1, x2, y2,
w = tft.width(),
h = tft.height();
tft.fillScreen(BLACK);
x1 = y1 = 0;
y2 = h - 1;
start = micros();
for(x2=0; x2<w; x2+=6) tft.drawLine(x1, y1, x2, y2, color);
x2 = w - 1;
for(y2=0; y2<h; y2+=6) tft.drawLine(x1, y1, x2, y2, color);
t = micros() - start; // fill Screen doesn't count against timing
tft.fillScreen(BLACK);
x1 = w - 1;
y1 = 0;
y2 = h - 1;
start = micros();
for(x2=0; x2<w; x2+=6) tft.drawLine(x1, y1, x2, y2, color);
x2 = 0;
for(y2=0; y2<h; y2+=6) tft.drawLine(x1, y1, x2, y2, color);
t += micros() - start;
tft.fillScreen(BLACK);
x1 = 0;
y1 = h - 1;
y2 = 0;
start = micros();
for(x2=0; x2<w; x2+=6) tft.drawLine(x1, y1, x2, y2, color);
x2 = w - 1;
for(y2=0; y2<h; y2+=6) tft.drawLine(x1, y1, x2, y2, color);
t += micros() - start;
tft.fillScreen(BLACK);
x1 = w - 1;
y1 = h - 1;
y2 = 0;
start = micros();
for(x2=0; x2<w; x2+=6) tft.drawLine(x1, y1, x2, y2, color);
x2 = 0;
for(y2=0; y2<h; y2+=6) tft.drawLine(x1, y1, x2, y2, color);
return micros() - start;
}
// ------------------------------------------------
unsigned long testFastLines(uint16_t color1, uint16_t color2) {
unsigned long start;
int x, y, w = tft.width(), h = tft.height();
tft.fillScreen(BLACK);
start = micros();
for(y=0; y<h; y+=5) tft.drawFastHLine(0, y, w, color1);
for(x=0; x<w; x+=5) tft.drawFastVLine(x, 0, h, color2);
return micros() - start;
}
// ------------------------------------------------
unsigned long testRects(uint16_t color) {
unsigned long start;
int n, i, i2,
cx = tft.width() / 2,
cy = tft.height() / 2;
tft.fillScreen(BLACK);
n = min(tft.width(), tft.height());
start = micros();
for(i=2; i<n; i+=6) {
i2 = i / 2;
tft.drawRect(cx-i2, cy-i2, i, i, color);
}
return micros() - start;
}
// ------------------------------------------------
unsigned long test FilledRects(uint16_t color1, uint16_t color2) {
unsigned long start, t = 0;
int n, i, i2,
cx = tft.width() / 2 - 1,
cy = tft.height() / 2 - 1;
tft.fillScreen(BLACK);
n = min(tft.width(), tft.height());
for(i=n; i>0; i-=6) {
i2 = i / 2;
start = micros();
tft.fillRect(cx-i2, cy-i2, i, i, color1);
t += micros() - start;
// Outlines are not included in timing results
tft.drawRect(cx-i2, cy-i2, i, i, color2);
}
return t;
}
// ------------------------------------------------
unsigned long test FilledCircles(uint8_t radius, uint16_t color) {
unsigned long start;
int x, y, w = tft.width(), h = tft.height(), r2 = radius * 2;
tft.fillScreen(BLACK);
start = micros();
for(x=radius; x<w; x+=r2) {
for(y=radius; y<h; y+=r2) {
tft.fillCircle(x, y, radius, color);
}
}
return micros() - start;
}
// ------------------------------------------------
unsigned long testCircles(uint8_t radius, uint16_t color) {
unsigned long start;
int x, y, r2 = radius * 2,
w = tft.width() + radius,
h = tft.height() + radius;
// Screen is not cleared for this one -- this is
intentional and does not affect the reported time.
start = micros();
for(x=0; x<w; x+=r2) {
for(y=0; y<h; y+=r2) {
tft.drawCircle(x, y, radius, color);
}
}
return micros() - start;
}
// ------------------------------------------------
unsigned long test Triangles() {
unsigned long start;
int n, i, cx = tft.width() / 2 - 1,
cy = tft.height() / 2 - 1;
tft.fillScreen(BLACK);
n = min(cx, cy);
start = micros();
for (i=0; in; i+=5) {
tft.drawTriangle(
cx , cy - i, // peak
cx - i, cy + i, // bottom left
cx + i, cy + i, // bottom right
tft.color565(0, 0, i));
}
return micros() - start;
}
// ------------------------------------------------
unsigned long test FilledTriangles() {
unsigned long start, t = 0;
int i, cx = tft.width() / 2 - 1,
cy = tft.height() / 2 - 1;
tft.fillScreen(BLACK);
start = micros();
for(i=min(cx,cy); i>10; i-=5) {
start = micros();
tft.fillTriangle(cx, cy - i, cx - i, cy + i, cx + i, cy + i,
tft.color565(0, i, i));
t += micros() - start;
tft.drawTriangle(cx, cy - i, cx - i, cy + i, cx + i, cy + i,
tft.color565(i, i, 0));
}
return t;
}
// ------------------------------------------------
unsigned long test RoundRects() {
unsigned long start;
int w, i, i2,
cx = tft.width() / 2 - 1,
cy = tft.height() / 2 - 1;
tft.fillScreen(BLACK);
w = min(tft.width(), tft.height());
start = micros();
for(i=0; i<w; i+=6) {
i2 = i / 2;
tft.drawRoundRect(cx-i2, cy-i2, i, i, i/8, tft.color565(i, 0, 0));
}
return micros() - start;
}
// ------------------------------------------------
unsigned long test FilledRoundRects() {
unsigned long start;
int i, i2,
cx = tft.width() / 2 - 1,
cy = tft.height() / 2 - 1;
tft.fillScreen(BLACK);
start = micros();
for(i=min(tft.width(), tft.height()); i>20; i-=6) {
i2 = i / 2;
tft.fillRoundRect(cx-i2, cy-i2, i, i, i/8, tft.color565(0, i, 0));
}
return micros() - start;
}
// ------------------------------------------------
Let’s Test It
To test the functionality of the 1.3 Inch SPI OLED Full Color IPS Display Module with Arduino, upload the provided code to your Arduino board and open the serial monitor. The code runs on and the display module shows the result including fill screen, text, line.
Working Explanation
- The above code is for interfacing a 1.3-inch OLED display module with an Arduino board. The OLED display module is based on an ST7789 driver IC and has a resolution of 240×240 pixels. The code uses the Adafruit ST7789 library to communicate with the display module and perform various functions.
- The code initializes the serial communication and sets up the display module by calling the tft.begin() function. It then fills the screen with black and displays a message.
- After that, several tests are performed to measure the performance of different functions of the display module. The tests include filling the screen with a color, clearing the screen, drawing an image, drawing an image with a font, filling the screen with a color, displaying text, drawing lines, drawing fast lines, drawing rectangles, drawing circles and triangles, drawing rounded rectangles. The time taken for each test is measured using the micros() function, which returns the number of microseconds since the Arduino board was powered on. The results of each test are printed on the serial monitor.
- The code also has an empty loop() function that does nothing.
- In the end, the code also has several functions to perform the benchmark tests. For example, the testFillScreen() function is called to perform the fill screen test, testText() function is called to perform the text display test and so on. All these functions return the time taken to perform the respective test.
Applications
- Smartwatches
- Cell phones
- Portable devices, etc
Conclusion.
We hope you have found this Interfacing 1.3 Inch SPI OLED Full Color IPS Display Module with Arduino Circuit very useful. If you feel any difficulty in making it feel free to ask anything in the comment section.
