918 lines
34 KiB
C
918 lines
34 KiB
C
/*!
|
|
* @defgroup ST7735
|
|
* @brief ST7735R LCD
|
|
<table>
|
|
<caption id="AdafruitLCDpins">Adafruit ST7735R pins </caption>
|
|
<tr><th>Pin <th>Connection <th>Description
|
|
<tr><td>10<td>+3.3<td>Backlight
|
|
<tr><td>9 <td>nc <td>SPI1 MISO (used for SDC)
|
|
<tr><td>8 <td>PB9 <td>SPI1 SCLK clock out
|
|
<tr><td>7 <td>PB8 <td>SPI1 PICO data out
|
|
<tr><td>6 <td>PB6 <td>SPI1 CS0=TFT_CS
|
|
<tr><td>5 <td>nc <td>CARD_CS (used for SDC)
|
|
<tr><td>4 <td>PA13<td>Data/Command(GPIO), high for data, low for command
|
|
<tr><td>3 <td>PB15<td>RESET, low to reset, (GPIO)
|
|
<tr><td>2 <td>+3.3<td>VCC
|
|
<tr><td>1 <td>Gnd <td>ground
|
|
</table>
|
|
|
|
<table>
|
|
<caption id="widehkpins">wide.hk ST7735R with ADXL345 accelerometer pins </caption>
|
|
<tr><th>Pin<th>Connection
|
|
<tr><td>VCC <td> +3.3 V
|
|
<tr><td>GND <td> Ground
|
|
<tr><td>!SCL <td> SPI1 SCLK: PB9 clock
|
|
<tr><td>!SDA <td> SPI1 PICO: PB8 MOSI SPI data from microcontroller to TFT or SDC
|
|
<tr><td>DC <td> GPIO PA13 TFT data/command
|
|
<tr><td>RES <td> GPIO PB15 TFT reset
|
|
<tr><td>CS <td> SPI1 CS0: PB6 TFT_CS, active low to enable TFT
|
|
<tr><td>*CS <td> (NC) SDC_CS, active low to enable SDC
|
|
<tr><td>MISO <td> (NC) MISO SPI data from SDC to microcontroller
|
|
<tr><td>SDA <td> (NC) I2C data for ADXL345 accelerometer
|
|
<tr><td>SCL <td> (NC) I2C clock for ADXL345 accelerometer
|
|
<tr><td>SDO <td> (NC) I2C alternate address for ADXL345 accelerometer
|
|
<tr><td>Backlight + - Light, backlight connected to +3.3 V
|
|
</table>
|
|
|
|
|
|
<table>
|
|
<caption id="widehkpins335">wide.hk ST7735R with ADXL335 accelerometer pins </caption>
|
|
<tr><th>Pin<th>Connection
|
|
<tr><td>VCC <td> +3.3 V
|
|
<tr><td>GND <td> Ground
|
|
/<tr><td>!SCL<td> SPI1 SCLK: PB9
|
|
<tr><td>!SDA <td> SPI1 PICO: PB8 MOSI SPI data from microcontroller to TFT or SDC
|
|
<tr><td>DC <td> GPIO PA13 TFT data/command
|
|
<tr><td>RES <td> GPIO PB15 TFT reset
|
|
<tr><td>CS <td> SPI1 CS0: PB6 TFT_CS, active low to enable TFT
|
|
<tr><td>*CS <td> (NC) SDC_CS, active low to enable SDC
|
|
<tr><td>MISO <td> (NC) MISO SPI data from SDC to microcontroller
|
|
<tr><td>X<td> (NC) analog input X-axis from ADXL335 accelerometer
|
|
<tr><td>Y<td> (NC) analog input Y-axis from ADXL335 accelerometer
|
|
<tr><td>Z<td> (NC) analog input Z-axis from ADXL335 accelerometer
|
|
<tr><td>Backlight + <td> Light, backlight connected to +3.3 V
|
|
</table>
|
|
|
|
<table>
|
|
<caption id="HiLetgopins">HiLetgo ST7735 TFT and SDC pins </caption>
|
|
<tr><th>signal<th>Pin<th>Connection
|
|
<tr><td>LED- <td>16<td>TFT, to ground
|
|
<tr><td>LED+ <td>15<td>TFT, to +3.3 V
|
|
<tr><td>SD_CS <td>14<td>SDC, to chip select
|
|
<tr><td>MOSI <td>13<td>SDC, to MOSI
|
|
<tr><td>MISO <td>12<td>SDC, to MISO
|
|
<tr><td>SCK <td>11<td>SDC, to serial clock
|
|
<tr><td>CS <td>10<td>TFT, to PB6 SPI1 CS0
|
|
<tr><td>SCL <td> 9<td>TFT, to PB9 SPI1 SCLK
|
|
<tr><td>SDA <td> 8<td>TFT, to PB8 MOSI SPI1 PICO
|
|
<tr><td>A0 <td> 7<td>TFT, to PA13 Data/Command, high for data, low for command
|
|
<tr><td>RESET <td> 6<td>TFT, to PB15 reset (GPIO), low to reset
|
|
<tr><td>NC <td>3,4,5<td>not connected
|
|
<tr><td>VCC <td> 2<td>to +3.3 V
|
|
<tr><td>GND <td> 1<td>to ground
|
|
</table>
|
|
|
|
<table>
|
|
<caption id="Tyenazapins">Tyenaza Tyenazaqhf72mi9s3 pins </caption>
|
|
<tr><th>signal<th>Pin<th>Connection
|
|
<tr><td>LED <td>8<td> to +3.3 V
|
|
<tr><td>SCK <td>7<td>SCLK to PB9 SPI1 SCLK
|
|
<tr><td>SDA <td>6<td>MOSI, to PB8 SPI1 PICO
|
|
<tr><td>A0 <td>5<td>Data/Command to PA13 (GPIO), high for data, low for command
|
|
<tr><td>RESET <td>4<td>to PB15 (GPIO), low to reset
|
|
<tr><td>CS <td>3<td>to PB6 SPI1 CS0:
|
|
<tr><td>Gnd <td>2<td>to ground
|
|
<tr><td>VCC <td>1<td>to +3.3 V
|
|
</table>
|
|
* @{*/
|
|
/**
|
|
* @file ST7735.h
|
|
* @brief 160 by 128 pixel LCD
|
|
* @details Software driver functions for ST7735R display<br>
|
|
* This is a library for the Adafruit 1.8" SPI display.<br>
|
|
* This library works with the Adafruit 1.8" TFT Breakout w/SD card<br>
|
|
* ----> http://www.adafruit.com/products/358<br>
|
|
* as well as Adafruit raw 1.8" TFT display<br>
|
|
* ----> http://www.adafruit.com/products/618<br>
|
|
* Check out the links above for our tutorials and wiring diagrams<br>
|
|
* These displays use SPI to communicate, 4 or 5 pins are required to
|
|
* interface (RST is optional)
|
|
* Adafruit invests time and resources providing this open source code,
|
|
* please support Adafruit and open-source hardware by purchasing
|
|
* products from Adafruit!
|
|
* Written by Limor Fried/Ladyada for Adafruit Industries.
|
|
* MIT license, all text above must be included in any redistribution
|
|
* @version ECE319K v1.0
|
|
* @author Daniel Valvano and Jonathan Valvano
|
|
* @copyright Copyright 2023 by Jonathan W. Valvano, valvano@mail.utexas.edu,
|
|
* @warning AS-IS
|
|
* @note For more information see http://users.ece.utexas.edu/~valvano/
|
|
* @date August 14, 2023
|
|
* interface <br>
|
|
* \image html ST7735interface.png width=500px
|
|
* <br><br>ST7735 160 by 128 pixel LCD<br>
|
|
* \image html ST7735.png width=500px
|
|
<table>
|
|
<caption id="AdafruitLCDpins2">Adafruit ST7735R pins </caption>
|
|
<tr><th>Pin <th>Connection <th>Description
|
|
<tr><td>10<td>+3.3<td>Backlight
|
|
<tr><td>9 <td>nc <td>SPI1 MISO (used for SDC)
|
|
<tr><td>8 <td>PB9 <td>SPI1 SCLK clock out
|
|
<tr><td>7 <td>PB8 <td>SPI1 PICO data out
|
|
<tr><td>6 <td>PB6 <td>SPI1 CS0=TFT_CS
|
|
<tr><td>5 <td>nc <td>CARD_CS (used for SDC)
|
|
<tr><td>4 <td>PA13<td>Data/Command(GPIO), high for data, low for command
|
|
<tr><td>3 <td>PB15<td>RESET, low to reset, (GPIO)
|
|
<tr><td>2 <td>+3.3<td>VCC
|
|
<tr><td>1 <td>Gnd <td>ground
|
|
</table>
|
|
|
|
<table>
|
|
<caption id="widehkpins2">wide.hk ST7735R with ADXL345 accelerometer pins </caption>
|
|
<tr><th>Pin<th>Connection
|
|
<tr><td>VCC <td> +3.3 V
|
|
<tr><td>GND <td> Ground
|
|
<tr><td>!SCL <td> SPI1 SCLK: PB9 clock
|
|
<tr><td>!SDA <td> SPI1 PICO: PB8 MOSI SPI data from microcontroller to TFT or SDC
|
|
<tr><td>DC <td> GPIO PA13 TFT data/command
|
|
<tr><td>RES <td> GPIO PB15 TFT reset
|
|
<tr><td>CS <td> SPI1 CS0: PB6 TFT_CS, active low to enable TFT
|
|
<tr><td>*CS <td> (NC) SDC_CS, active low to enable SDC
|
|
<tr><td>MISO <td> (NC) MISO SPI data from SDC to microcontroller
|
|
<tr><td>SDA <td> (NC) I2C data for ADXL345 accelerometer
|
|
<tr><td>SCL <td> (NC) I2C clock for ADXL345 accelerometer
|
|
<tr><td>SDO <td> (NC) I2C alternate address for ADXL345 accelerometer
|
|
<tr><td>Backlight + - Light, backlight connected to +3.3 V
|
|
</table>
|
|
|
|
|
|
<table>
|
|
<caption id="widehkpins3352">wide.hk ST7735R with ADXL335 accelerometer pins </caption>
|
|
<tr><th>Pin<th>Connection
|
|
<tr><td>VCC <td> +3.3 V
|
|
<tr><td>GND <td> Ground
|
|
/<tr><td>!SCL<td> SPI1 SCLK: PB9
|
|
<tr><td>!SDA <td> SPI1 PICO: PB8 MOSI SPI data from microcontroller to TFT or SDC
|
|
<tr><td>DC <td> GPIO PA13 TFT data/command
|
|
<tr><td>RES <td> GPIO PB15 TFT reset
|
|
<tr><td>CS <td> SPI1 CS0: PB6 TFT_CS, active low to enable TFT
|
|
<tr><td>*CS <td> (NC) SDC_CS, active low to enable SDC
|
|
<tr><td>MISO <td> (NC) MISO SPI data from SDC to microcontroller
|
|
<tr><td>X<td> (NC) analog input X-axis from ADXL335 accelerometer
|
|
<tr><td>Y<td> (NC) analog input Y-axis from ADXL335 accelerometer
|
|
<tr><td>Z<td> (NC) analog input Z-axis from ADXL335 accelerometer
|
|
<tr><td>Backlight + <td> Light, backlight connected to +3.3 V
|
|
</table>
|
|
|
|
<table>
|
|
<caption id="HiLetgopins2">HiLetgo ST7735 TFT and SDC pins </caption>
|
|
<tr><th>signal<th>Pin<th>Connection
|
|
<tr><td>LED- <td>16<td>TFT, to ground
|
|
<tr><td>LED+ <td>15<td>TFT, to +3.3 V
|
|
<tr><td>SD_CS <td>14<td>SDC, to chip select
|
|
<tr><td>MOSI <td>13<td>SDC, to MOSI
|
|
<tr><td>MISO <td>12<td>SDC, to MISO
|
|
<tr><td>SCK <td>11<td>SDC, to serial clock
|
|
<tr><td>CS <td>10<td>TFT, to PB6 SPI1 CS0
|
|
<tr><td>SCL <td> 9<td>TFT, to PB9 SPI1 SCLK
|
|
<tr><td>SDA <td> 8<td>TFT, to PB8 MOSI SPI1 PICO
|
|
<tr><td>A0 <td> 7<td>TFT, to PA13 Data/Command, high for data, low for command
|
|
<tr><td>RESET <td> 6<td>TFT, to PB15 reset (GPIO), low to reset
|
|
<tr><td>NC <td>3,4,5<td>not connected
|
|
<tr><td>VCC <td> 2<td>to +3.3 V
|
|
<tr><td>GND <td> 1<td>to ground
|
|
</table>
|
|
|
|
<table>
|
|
<caption id="Tyenazapins2">Tyenaza Tyenazaqhf72mi9s3 pins </caption>
|
|
<tr><th>signal<th>Pin<th>Connection
|
|
<tr><td>LED <td>8<td> to +3.3 V
|
|
<tr><td>SCK <td>7<td>SCLK to PB9 SPI1 SCLK
|
|
<tr><td>SDA <td>6<td>MOSI, to PB8 SPI1 PICO
|
|
<tr><td>A0 <td>5<td>Data/Command to PA13 (GPIO), high for data, low for command
|
|
<tr><td>RESET <td>4<td>to PB15 (GPIO), low to reset
|
|
<tr><td>CS <td>3<td>to PB6 SPI1 CS0:
|
|
<tr><td>Gnd <td>2<td>to ground
|
|
<tr><td>VCC <td>1<td>to +3.3 V
|
|
</table>
|
|
<br>
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
#ifndef _ST7735H_
|
|
#define _ST7735H_
|
|
#include <stdint.h>
|
|
/**
|
|
* \brief some flags for ST7735_InitR()
|
|
*/
|
|
enum initRFlags{
|
|
none,
|
|
INITR_GREENTAB,
|
|
INITR_REDTAB,
|
|
INITR_BLACKTAB
|
|
};
|
|
|
|
/**
|
|
* \brief 128 pixels wide
|
|
*/
|
|
#define ST7735_TFTWIDTH 128
|
|
/**
|
|
* \brief 160 pixels tall
|
|
*/
|
|
#define ST7735_TFTHEIGHT 160
|
|
|
|
|
|
/**
|
|
* \brief The following constants are possible colors for the LCD in RGB format
|
|
*/
|
|
#define ST7735_BLACK 0x0000
|
|
#define ST7735_BLUE 0xF800
|
|
#define ST7735_RED 0x001F
|
|
#define ST7735_GREEN 0x07E0
|
|
#define ST7735_CYAN 0xFFE0
|
|
#define ST7735_MAGENTA 0xF81F
|
|
#define ST7735_YELLOW 0x07FF
|
|
#define ST7735_WHITE 0xFFFF
|
|
#define ST7735_LIGHTGREY ST7735_Color565(228,228,228)
|
|
#define ST7735_DARKGREY ST7735_Color565(32,32,32)
|
|
#define ST7735_ORANGE ST7735_Color565(255,102,0)
|
|
#define ST7735_PURPLE ST7735_Color565(106,13,173)
|
|
|
|
/**
|
|
* Initialize ST7735B color 128x160-pixel TFT LCD
|
|
* @param none
|
|
* @return none
|
|
* @brief Initialize ST7735B LCD
|
|
* @note assumes GPIOA and GPIOB are reset and powered previously
|
|
*/
|
|
void ST7735_InitB(void);
|
|
|
|
|
|
|
|
/**
|
|
* Initialize ST7735R color 128x160-pixel TFT LCD
|
|
* @param option one of none,INITR_GREENTAB,INITR_REDTAB,INITR_BLACKTAB
|
|
* @return none
|
|
* @brief Initialize ST7735R LCD
|
|
* @note assumes GPIOA and GPIOB are reset and powered previously
|
|
*/
|
|
void ST7735_InitR(enum initRFlags option);
|
|
|
|
|
|
|
|
/**
|
|
* Color the pixel at the given coordinates with the given color.<br>
|
|
* Requires 13 bytes of transmission<br>
|
|
* x must be less than 128<br>
|
|
* x 0 is on the left, 126 is near the right <br>
|
|
* y must be less than 160
|
|
* y 159 is near the wires, 0 is the side opposite the wires
|
|
* @param x horizontal position of the pixel, columns from the left edge
|
|
* @param y vertical position of the pixel, rows from the top edge
|
|
* @param color 16-bit color, which can be produced by LCD_Color565()
|
|
* @return none
|
|
* @brief Color one pixel
|
|
*/
|
|
void ST7735_DrawPixel(int16_t x, int16_t y, uint16_t color);
|
|
|
|
|
|
/**
|
|
* Draw a vertical line at the given coordinates with the given height and color.<br>
|
|
* A vertical line is parallel to the longer side of the rectangular display<br>
|
|
* Requires (11 + 2*h) bytes of transmission (assuming image fully on screen)
|
|
* @param x horizontal position of the start of the line, columns from the left edge
|
|
* @param y vertical position of the start of the line, rows from the top edge
|
|
* @param h vertical height of the line
|
|
* @param color 16-bit color, which can be produced by LCD_Color565()
|
|
* @return none
|
|
* @brief Draw a vertical line
|
|
*/
|
|
void ST7735_DrawFastVLine(int16_t x, int16_t y, int16_t h, uint16_t color);
|
|
|
|
|
|
|
|
/**
|
|
* Draw a horizontal line at the given coordinates with the given width and color.
|
|
* A horizontal line is parallel to the shorter side of the rectangular display<br>
|
|
* Requires (11 + 2*w) bytes of transmission (assuming image fully on screen)
|
|
* @param x horizontal position of the start of the line, columns from the left edge
|
|
* @param y vertical position of the start of the line, rows from the top edge
|
|
* @param w horizontal width of the line
|
|
* @param color 16-bit color, which can be produced by LCD_Color565()
|
|
* @return none
|
|
* @brief Draw a horizontal line
|
|
*/
|
|
void ST7735_DrawFastHLine(int16_t x, int16_t y, int16_t w, uint16_t color);
|
|
|
|
|
|
/**
|
|
* Fill the screen with the given color.<br>
|
|
* Requires 40,971 bytes of transmission
|
|
* @param color 16-bit color, which can be produced by ST7735_Color565()
|
|
* @return none
|
|
* @brief Fill the screen
|
|
*/
|
|
void ST7735_FillScreen(uint16_t color);
|
|
|
|
|
|
|
|
/**
|
|
* Draw a filled rectangle at the given coordinates with the given width, height, and color.<br>
|
|
* Requires (11 + 2*w*h) bytes of transmission (assuming image fully on screen)
|
|
* @param x horizontal position of the top left corner of the rectangle, columns from the left edge
|
|
* @param y vertical position of the top left corner of the rectangle, rows from the top edge
|
|
* @param w horizontal width of the rectangle
|
|
* @param h vertical height of the rectangle
|
|
* @param color 16-bit color, which can be produced by ST7735_Color565()
|
|
* @return none
|
|
* @brief Draw a filled rectangle
|
|
*/
|
|
void ST7735_FillRect(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color);
|
|
|
|
|
|
/**
|
|
* Draw a small circle (diameter of 6 pixels) at the given coordinates with the given color.<br>
|
|
* Requires (11*6+24*2)=114 bytes of transmission (assuming image fully on screen)
|
|
* @param x horizontal position of the top left corner of the circle, columns from the left edge
|
|
* @param y vertical position of the top left corner of the circle, rows from the top edge
|
|
* @param color 16-bit color, which can be produced by ST7735_Color565()
|
|
* @return none
|
|
* @brief Draw a small circle
|
|
*/
|
|
void ST7735_DrawSmallCircle(int16_t x, int16_t y, uint16_t color);
|
|
|
|
|
|
/**
|
|
* Draw a circle (diameter of 10 pixels) at the given coordinates with the given color.<br>
|
|
* Requires (11*10+68*2)=178 bytes of transmission (assuming image on screen)
|
|
* @param x horizontal position of the top left corner of the circle, columns from the left edge
|
|
* @param y vertical position of the top left corner of the circle, rows from the top edge
|
|
* @param color 16-bit color, which can be produced by ST7735_Color565()
|
|
* @return none
|
|
* @brief Draw a circle
|
|
*/
|
|
void ST7735_DrawCircle(int16_t x, int16_t y, uint16_t color);
|
|
|
|
/**
|
|
* Pass 8-bit (each) R,G,B and get back 16-bit packed color.
|
|
* @param r red value
|
|
* @param g green value
|
|
* @param b blue value
|
|
* @return 16-bit color
|
|
* @brief RGB to color creation
|
|
*/
|
|
uint16_t ST7735_Color565(uint8_t r, uint8_t g, uint8_t b);
|
|
|
|
/**
|
|
* Swaps the red and blue values of the given 16-bit packed color;
|
|
* green is unchanged.
|
|
* @param x 16-bit color in format B, G, R
|
|
* @return 16-bit color in format R, G, B
|
|
* @brief Swaps red and blue
|
|
*/
|
|
uint16_t ST7735_SwapColor(uint16_t x) ;
|
|
|
|
|
|
/**
|
|
* Displays a 16-bit color BMP image. A bitmap file that is created
|
|
* by a PC image processing program has a header and may be padded
|
|
* with dummy columns so the data have four byte alignment. This
|
|
* function assumes that all of that has been stripped out, and the
|
|
* array image[] has one 16-bit halfword for each pixel to be
|
|
* displayed on the screen (encoded in reverse order, which is
|
|
* standard for bitmap files). An array can be created in this
|
|
* format from a 24-bit-per-pixel .bmp file using the associated
|
|
* <b>BmpConvert16.exe</b> converter program.
|
|
* (x,y) is the screen location of the lower left corner of BMP image<br>
|
|
* Requires (11 + 2*w*h) bytes of transmission (assuming image fully on screen)
|
|
* @param x horizontal position of the bottom left corner of the image, columns from the left edge
|
|
* @param y vertical position of the bottom left corner of the image, rows from the top edge
|
|
* @param image pointer to a 16-bit color BMP image
|
|
* @param w number of pixels wide
|
|
* @param h number of pixels tall
|
|
* @note Must be less than or equal to 128 pixels wide by 160 pixels high
|
|
* @return none
|
|
* @brief Displays a BMP image
|
|
*/
|
|
void ST7735_DrawBitmap(int16_t x, int16_t y, const uint16_t *image, int16_t w, int16_t h);
|
|
|
|
/**
|
|
* Simple character draw function. This is the same function from
|
|
* Adafruit_GFX.c but adapted for this processor. However, each call
|
|
* to ST7735_DrawPixel() calls setAddrWindow(), which needs to send
|
|
* many extra data and commands. If the background color is the same
|
|
* as the text color, no background will be printed, and text can be
|
|
* drawn right over existing images without covering them with a box.<br>
|
|
* Requires (11 + 2*size*size)*6*8 bytes of transmission (image fully on screen; textcolor != bgColor)
|
|
* @param x horizontal position of the top left corner of the character, columns from the left edge
|
|
* @param y vertical position of the top left corner of the character, rows from the top edge
|
|
* @param c character to be printed
|
|
* @param textColor 16-bit color of the character
|
|
* @param bgColor 16-bit color of the background
|
|
* @param size number of pixels per character pixel (e.g. size==2 prints each pixel of font as 2x2 square)
|
|
* @return none
|
|
* @brief Draw a character
|
|
*/
|
|
void ST7735_DrawCharS(int16_t x, int16_t y, char c, int16_t textColor, int16_t bgColor, uint8_t size);
|
|
|
|
|
|
/**
|
|
* Advanced character draw function. This is similar to the function
|
|
* from Adafruit_GFX.c but adapted for this processor. However, this
|
|
* function only uses one call to setAddrWindow(), which allows it to
|
|
* run at least twice as fast.<br>
|
|
* Requires (11 + size*size*6*8) bytes of transmission (assuming image fully on screen)
|
|
* @param x horizontal position of the top left corner of the character, columns from the left edge
|
|
* @param y vertical position of the top left corner of the character, rows from the top edge
|
|
* @param c character to be printed
|
|
* @param textColor 16-bit color of the character
|
|
* @param bgColor 16-bit color of the background
|
|
* @param size number of pixels per character pixel (e.g. size==2 prints each pixel of font as 2x2 square)
|
|
* @return none
|
|
* @brief Draw a character
|
|
*/
|
|
void ST7735_DrawChar(int16_t x, int16_t y, char c, int16_t textColor, int16_t bgColor, uint8_t size);
|
|
|
|
|
|
/**
|
|
* String draw function.
|
|
* 16 rows (0 to 15) and 21 characters (0 to 20)<br>
|
|
* Requires (11 + size*size*6*8) bytes of transmission for each character
|
|
* @param x columns from the left edge (0 to 20)
|
|
* @param y rows from the top edge (0 to 12)
|
|
* @param pt pointer to a null terminated string to be printed
|
|
* @param textColor 16-bit color of the characters
|
|
* @return number of characters printed
|
|
* @note bgColor is Black and size is 1
|
|
* @brief Draw a string
|
|
*/
|
|
uint32_t ST7735_DrawString(uint16_t x, uint16_t y, char *pt, int16_t textColor);;
|
|
|
|
|
|
/**
|
|
* Move the cursor to the desired X- and Y-position. The
|
|
* next character of the next unsigned decimal will be
|
|
* printed here. X=0 is the leftmost column. Y=0 is the top row.
|
|
* The cursor is used by the "Out" functions, but not the "Draw" functions
|
|
* @param newX new X-position of the cursor (0<=newX<=20)
|
|
* @param newY new Y-position of the cursor (0<=newY<=15)
|
|
* @return none
|
|
* @brief Move the cursor
|
|
*/
|
|
void ST7735_SetCursor(uint32_t newX, uint32_t newY);
|
|
|
|
/**
|
|
* Output a 32-bit number in unsigned decimal format.
|
|
* Position determined by ST7735_SetCursor command.
|
|
* Color set by ST7735_SetTextColor.
|
|
* @param n 32-bit number to be transferred
|
|
* @return none
|
|
* @note Variable format 1-10 digits with no space before or after
|
|
* @brief Output an unsigned decimal
|
|
*/
|
|
void ST7735_OutUDec(uint32_t n);
|
|
|
|
|
|
/**
|
|
* Output a 32-bit number in unsigned 4-digit decimal format
|
|
* with no space before or after.
|
|
* Color set by ST7735_SetTextColor.
|
|
* Position determined by ST7735_SetCursor command
|
|
* @param n 32-bit number to be transferred
|
|
* @return none
|
|
* @note Fixed format 4 digits with no space before or after
|
|
* @brief Output a 4-digit unsigned decimal
|
|
*/
|
|
void ST7735_OutUDec4(uint32_t n);
|
|
|
|
/**
|
|
* Output a 32-bit number in unsigned 5-digit decimal format
|
|
* with no space before or after.
|
|
* Color set by ST7735_SetTextColor.
|
|
* Position determined by ST7735_SetCursor command
|
|
* @param n 32-bit number to be transferred
|
|
* @return none
|
|
* @note Fixed format 5 digits with no space before or after
|
|
* @brief Output a 5-digit unsigned decimal
|
|
*/
|
|
void ST7735_OutUDec5(uint32_t n);
|
|
|
|
/**
|
|
* Output a 32-bit number in unsigned 3-digit fixed point, 0.1 resolution
|
|
* numbers 0 to 999 printed as " 0.0" to "99.9"
|
|
* Position determined by ST7735_SetCursor command
|
|
* @param n 32-bit number to be transferred
|
|
* @param textColor 16-bit color of the numbers
|
|
* @return none
|
|
* @note Fixed format 4 characters with no space before or after
|
|
* @brief Output a 2-digit fixed-point decimal
|
|
*/
|
|
void ST7735_OutUFix2_1(uint32_t n, int16_t textColor);
|
|
|
|
/**
|
|
* Output a 32-bit number in unsigned 2-digit hexadecimal format
|
|
* numbers 0 to 255 printed as "00," to "FF,"
|
|
* Position determined by ST7735_SetCursor command
|
|
* @param n 32-bit number to be transferred
|
|
* @param textColor 16-bit color of the numbers
|
|
* @return none
|
|
* @note Fixed format 3 characters with comma after
|
|
* @brief Output a 2-digit hexadecimal number
|
|
*/
|
|
void ST7735_OutUHex2(uint32_t n, int16_t textColor);
|
|
|
|
/**
|
|
* Change the image rotation.
|
|
* Requires 2 bytes of transmission
|
|
* @param m new rotation value (0 to 3)
|
|
* @return none
|
|
* @brief Change rotation
|
|
*/
|
|
void ST7735_SetRotation(uint8_t m) ;
|
|
|
|
|
|
|
|
/**
|
|
* Send the command to invert all of the colors.
|
|
* Requires 1 byte of transmission
|
|
* @param i 0 to disable inversion; non-zero to enable inversion
|
|
* @return none
|
|
* @brief invert display
|
|
*/
|
|
void ST7735_InvertDisplay(int i) ;
|
|
|
|
|
|
|
|
/**
|
|
* Set up the axes, labels, and other variables to
|
|
* allow data to be plotted in a chart using the
|
|
* functions ST7735_PlotPoint() and
|
|
* ST7735_PlotIncrement().
|
|
* If yLabel2 is empty string, no yLabel2 is printed, and yLabel1 is centered
|
|
* - graphics routines
|
|
* - y coordinates 0 to 31 used for labels and messages
|
|
* - y coordinates 32 to 159 128 pixels high
|
|
* - x coordinates 0 to 127 128 pixels wide
|
|
*
|
|
* @param axisColor 16-bit color for axes, which can be produced by LCD_Color565()
|
|
* @param bgColor 16-bit color for plot background, which can be produced by LCD_Color565()
|
|
* @param xLabel pointer to a null terminated string for x-axis (~4 character space)
|
|
* @param yLabel1 pointer to a null terminated string for top of y-axis (~3-5 character space)
|
|
* @param label1Color 16-bit color for y-axis label1, which can be produced by LCD_Color565()
|
|
* @param yLabel2 pointer to a null terminated string for bottom of y-axis (~3 character space)
|
|
* @param label2Color 16-bit color for y-axis label2, which can be produced by LCD_Color565()
|
|
* @param ymax maximum value to be printed
|
|
* @param ymin minimum value to be printed
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() has been called
|
|
* @brief Initializes a plot
|
|
*/
|
|
void ST7735_Drawaxes(uint16_t axisColor, uint16_t bgColor, char *xLabel,
|
|
char *yLabel1, uint16_t label1Color, char *yLabel2, uint16_t label2Color,
|
|
int32_t ymax, int32_t ymin);
|
|
|
|
/**
|
|
* Clear the graphics buffer, set X coordinate to 0
|
|
* This routine clears the display
|
|
* @param ymin minimum plot value
|
|
* @param ymax maximum plot value
|
|
* @return none
|
|
* @brief Clear plot
|
|
*/
|
|
void ST7735_PlotClear(int32_t ymin, int32_t ymax);
|
|
|
|
|
|
/**
|
|
* Plot a point on the chart. To plot several points in the
|
|
* same column, call this function repeatedly before calling
|
|
* ST7735PlotIncrement(). The units of the data are the
|
|
* same as the ymax and ymin values specified in the
|
|
* initialization function.
|
|
* @param y value to be plotted (units not specified)
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() and ST7735_Drawaxes() have been called
|
|
* @brief Plot one point
|
|
*/
|
|
void ST7735_PlotPoint(int32_t y);
|
|
|
|
|
|
/**
|
|
* Plot a point on the chart. To plot several points in the
|
|
* same column, call this function repeatedly before calling
|
|
* ST7735_PlotIncrement(). The units of the data are the
|
|
* same as the ymax and ymin values specified in the
|
|
* initialization function.
|
|
* @param data1 value to be plotted (units not specified)
|
|
* @param color1 16-bit color for the point, which can be produced by ST7735_Color565()
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() and ST7735_Drawaxes() have been called
|
|
* @brief Plot one point with color
|
|
*/
|
|
void ST7735_PlotPoint2(int32_t data1, uint16_t color1);
|
|
|
|
|
|
/**
|
|
* Increment the plot between subsequent calls to
|
|
* ST7735_PlotPoint(). Automatically wrap and clear the
|
|
* column to be printed to.
|
|
* ST7735_PlotIncrement will erase the new line (clearing the display as it goes).
|
|
* ST7735_PlotNext does not erase the new line (plots over itself as it wraps).
|
|
* @param none
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() and ST7735_Drawaxes() have been called
|
|
* @brief Moves the plot cursor in time
|
|
*/
|
|
void ST7735PlotIncrement(void);
|
|
|
|
|
|
/**
|
|
* Used in the voltage versus time plot, plot line to new point
|
|
* It does output to display
|
|
* @param y value to be plotted
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() and ST7735_Drawaxes() have been called
|
|
* @brief Plot one line
|
|
*/
|
|
void ST7735_PlotLine(int32_t y);
|
|
|
|
// *************** ST7735_PlotPoints ********************
|
|
// Used in the voltage versus time plot, plot two points at y1, y2
|
|
// It does output to display
|
|
// Inputs: y1 is the y coordinate of the first point plotted
|
|
// y2 is the y coordinate of the second point plotted
|
|
// Outputs: none
|
|
/**
|
|
* Used in the voltage versus time plot, plot two points at y1, y2
|
|
* It does output to display. The units of the data are the
|
|
* same as the ymax and ymin values specified in the
|
|
* initialization function. Call ST7735_PlotIncrement() to move time.
|
|
* @param y1 is the y coordinate of the first point plotted
|
|
* @param y2 is the y coordinate of the second point plotted
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() and ST7735_Drawaxes() have been called
|
|
* @brief Plot two points
|
|
*/
|
|
void ST7735_PlotPoints(int32_t y1,int32_t y2);
|
|
|
|
|
|
/**
|
|
* Used in the voltage versus time bar plot, plot one bar at y
|
|
* It does output to display. The units of the data are the
|
|
* same as the ymax and ymin values specified in the
|
|
* initialization function. Call ST7735_PlotIncrement() to move time.
|
|
* @param y is the y coordinate of the bar plotted
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() and ST7735_Drawaxes() have been called
|
|
* @brief Plot one bar
|
|
*/
|
|
void ST7735_PlotBar(int32_t y);
|
|
|
|
|
|
/**
|
|
* Used in the amplitude versus frequency plot, plot one bar at y
|
|
* It does output to display. 0 to 0.625V scaled on a log plot from min to max.
|
|
* Call ST7735_PlotIncrement() to move x axis.
|
|
* @param y is the y ADC value of the bar plotted
|
|
* @return none
|
|
* @note Assumes: ST7735_InitR() and ST7735_Drawaxes() have been called
|
|
* @brief Plot one bar
|
|
*/
|
|
void ST7735_PlotdBfs(int32_t y);
|
|
|
|
/**
|
|
* Used in all the plots to step the X coordinate one pixel.
|
|
* ST7735_PlotIncrement will erase the new line (clearing the display as it goes).
|
|
* ST7735_PlotNext does not erase the new line (plots over itself as it wraps).
|
|
* X steps from 0 to 127, then back to 0 again
|
|
* It does not output to display
|
|
* @param none
|
|
* @return none
|
|
* @brief Move x-axis parameter
|
|
*/
|
|
void ST7735_PlotNext(void);
|
|
|
|
/**
|
|
* Used in all the plots to step the X coordinate one pixel
|
|
* X steps from 0 to 127, then back to 0 again
|
|
* It clears the vertical space into which the next pixel will be drawn
|
|
* @param none
|
|
* @return none
|
|
* @brief Move X coordinate
|
|
*/
|
|
void ST7735_PlotNextErase(void);
|
|
|
|
// Used in all the plots to write buffer to LCD
|
|
// Example 1 Voltage versus time
|
|
// ST7735_PlotClear(0,4095); // range from 0 to 4095
|
|
// ST7735_PlotPoint(data); ST7735_PlotNext(); // called 128 times
|
|
|
|
// Example 2a Voltage versus time (N data points/pixel, time scale)
|
|
// ST7735_PlotClear(0,4095); // range from 0 to 4095
|
|
// { for(j=0;j<N;j++){
|
|
// ST7735_PlotPoint(data[i++]); // called N times
|
|
// }
|
|
// ST7735_PlotNext();
|
|
// } // called 128 times
|
|
|
|
// Example 2b Voltage versus time (N data points/pixel, time scale)
|
|
// ST7735_PlotClear(0,4095); // range from 0 to 4095
|
|
// { for(j=0;j<N;j++){
|
|
// ST7735_PlotLine(data[i++]); // called N times
|
|
// }
|
|
// ST7735_PlotNext();
|
|
// } // called 128 times
|
|
|
|
// Example 3 Voltage versus frequency (512 points)
|
|
// perform FFT to get 512 magnitudes, mag[i] (0 to 4095)
|
|
// ST7735_PlotClear(0,1023); // clip large magnitudes
|
|
// {
|
|
// ST7735_PlotBar(mag[i++]); // called 4 times
|
|
// ST7735_PlotBar(mag[i++]);
|
|
// ST7735_PlotBar(mag[i++]);
|
|
// ST7735_PlotBar(mag[i++]);
|
|
// ST7735_PlotNext();
|
|
// } // called 128 times
|
|
|
|
// Example 4 Voltage versus frequency (512 points), dB scale
|
|
// perform FFT to get 512 magnitudes, mag[i] (0 to 4095)
|
|
// ST7735_PlotClear(0,511); // parameters ignored
|
|
// {
|
|
// ST7735_PlotdBfs(mag[i++]); // called 4 times
|
|
// ST7735_PlotdBfs(mag[i++]);
|
|
// ST7735_PlotdBfs(mag[i++]);
|
|
// ST7735_PlotdBfs(mag[i++]);
|
|
// ST7735_PlotNext();
|
|
// } // called 128 times
|
|
|
|
|
|
/**
|
|
* Output one character to the LCD
|
|
* Position determined by ST7735_SetCursor command
|
|
* Color set by ST7735_SetTextColor
|
|
* @param ch 8-bit ASCII character
|
|
* @return none
|
|
* @brief Output a character
|
|
*/
|
|
void ST7735_OutChar(char ch);
|
|
|
|
/**
|
|
* Output one character to the LCD
|
|
* Position determined by ST7735_SetCursor command
|
|
* Color set by ST7735_SetTextColor, background is transparent
|
|
* @param ch 8-bit ASCII character
|
|
* @return none
|
|
* @brief Output a character transparently
|
|
*/
|
|
void ST7735_OutCharTransparent(char ch);
|
|
|
|
/**
|
|
* Print a string of characters to the ST7735 LCD.
|
|
* Position determined by ST7735_SetCursor command
|
|
* Color set by ST7735_SetTextColor
|
|
* The string will not automatically wrap.
|
|
* @param ptr pointer to NULL-terminated ASCII string
|
|
* @return none
|
|
* @brief Output a string
|
|
*/
|
|
void ST7735_OutString(char *ptr);
|
|
|
|
|
|
/**
|
|
* Print a string of characters to the ST7735 LCD.
|
|
* Position determined by ST7735_SetCursor command
|
|
* Color set by ST7735_SetTextColor, background is transparent
|
|
* The string will not automatically wrap.
|
|
* @param ptr pointer to NULL-terminated ASCII string
|
|
* @return none
|
|
* @brief Output a string transparently
|
|
*/
|
|
void ST7735_OutStringTransparent(char *ptr);
|
|
|
|
/**
|
|
* Sets the color in which the characters will be printed
|
|
* Background color is fixed at black
|
|
* @param color 16-bit packed color
|
|
* @return none
|
|
* @brief sets the text color
|
|
*/
|
|
void ST7735_SetTextColor(uint16_t color);
|
|
|
|
/**
|
|
* Initialize the ST7735 for printf
|
|
* @param none
|
|
* @return none
|
|
* @brief use ST7735 LCD to output from printf
|
|
*/
|
|
void ST7735_InitPrintf(void);
|
|
|
|
|
|
/**
|
|
* Outputs signed fixed point number to LCD.
|
|
* The format signed 32-bit with resolution 0.01.
|
|
* The range -99.99 to +99.99
|
|
<table>
|
|
<caption id="ST7735_sDecOut2">ST7735_sDecOut2 </caption>
|
|
<tr><th>Parameter <th>LCD display
|
|
<tr><td> 12345 <td>" **.**"
|
|
<tr><td> 2345 <td>" 23.45"
|
|
<tr><td> -8100 <td><td>"-81.00"
|
|
<tr><td> -102 <td>" -1.02"
|
|
<tr><td> 31 <td>" 0.31"
|
|
<tr><td>-12345 <td>"-**.**"
|
|
</table>
|
|
* @param n signed 32-bit integer part of fixed-point number
|
|
* @return none
|
|
* @brief fixed point output resolution 0.01
|
|
* @note send exactly 6 characters to the LCD
|
|
*/
|
|
void ST7735_sDecOut2(int32_t n);
|
|
|
|
|
|
|
|
/**
|
|
* unsigned 32-bit binary fixed-point with a resolution of 1/64.
|
|
* The full-scale range is from 0 to 999.99.
|
|
* If the integer part is larger than 63999, it signifies an error.
|
|
* The ST7735_uBinOut6 function takes an unsigned 32-bit integer part
|
|
* of the binary fixed-point number and outputs the fixed-point value on the LCD
|
|
<table>
|
|
<caption id="ST7735_uBinOut6">ST7735_uBinOut6 </caption>
|
|
<tr><th>Parameter <th>LCD display
|
|
<tr><td> 0 <td>" 0.00"
|
|
<tr><td> 1 <td>" 0.01"
|
|
<tr><td> 16 <td>" 0.25"
|
|
<tr><td> 25 <td>" 0.39"
|
|
<tr><td> 125 <td>" 1.95"
|
|
<tr><td> 128 <td>" 2.00"
|
|
<tr><td> 1250 <td>" 19.53"
|
|
<tr><td> 7500 <td>"117.19"
|
|
<tr><td>63999 <td>"999.99"
|
|
<tr><td>64000 <td>"***.**"
|
|
</table>
|
|
* @param n unsigned 32-bit integer part of binary fixed-point number
|
|
* @return none
|
|
* @brief fixed point output resolution 1/64
|
|
* @note send exactly 6 characters to the LCD
|
|
*/
|
|
void ST7735_uBinOut6(uint32_t n);
|
|
|
|
/**
|
|
* Specify the X and Y axes for an x-y scatter plot
|
|
* Draw the title and clear the plot area
|
|
* @param title ASCII string to label the plot, null-termination
|
|
* @param minX smallest X data value allowed, resolution= 0.001
|
|
* @param maxX largest X data value allowed, resolution= 0.001
|
|
* @param minY smallest Y data value allowed, resolution= 0.001
|
|
* @param maxY largest Y data value allowed, resolution= 0.001
|
|
* @return none
|
|
* @note assumes minX < maxX, and miny < maxY
|
|
* @brief initialize XY plot
|
|
*/
|
|
void ST7735_XYplotInit(char *title, int32_t minX, int32_t maxX, int32_t minY, int32_t maxY);
|
|
|
|
/**
|
|
* Plot an array of (x,y) data, neglect any points outside the minX maxY minY maxY bounds
|
|
* @param num number of data points in the two arrays
|
|
* @param bufX array of 32-bit fixed-point data, resolution= 0.001
|
|
* @param bufY array of 32-bit fixed-point data, resolution= 0.001
|
|
* @return none
|
|
* @note assumes ST7735_XYplotInit has been previously called
|
|
* @brief XY plot
|
|
*/
|
|
void ST7735_XYplot(uint32_t num, int32_t bufX[], int32_t bufY[]);
|
|
|
|
/**
|
|
* Draws one line on the ST7735 color LCD<br>
|
|
* - (x1,y1) is the start point
|
|
* - (x2,y2) is the end point
|
|
* - x1 x2 must be less than 128, 0 is on the left, 126 is near the right
|
|
* - y1 y2 must be less than 160, 159 is near the wires, 0 is the side opposite the wires
|
|
*
|
|
* @param x1 horizonal position
|
|
* @param x2 horizonal position
|
|
* @param y1 vertical position
|
|
* @param y2 vertical position
|
|
* @param color 16-bit color, which can be produced by ST7735_Color565()
|
|
* @return none
|
|
* @brief Draws line
|
|
*/
|
|
void ST7735_Line(uint16_t x1, uint16_t y1, uint16_t x2, uint16_t y2,
|
|
uint16_t color);
|
|
|
|
/**
|
|
* Used in all the plots to change the X coordinate to new location
|
|
* X exists in the range from 0 to 127,
|
|
* Input values less than 0 get changed to 0,
|
|
* Input values greater than 127 get changed to 127
|
|
* It does not output to display
|
|
* @param newX is the new value that the global X will be
|
|
* @return none
|
|
* @brief set X-position
|
|
*/
|
|
void ST7735_SetX(int32_t newX);
|
|
|
|
|
|
#endif
|
|
/** @}*/
|