AmebaILI9341 Class

AmebaILI9341 Class

Description
A class to use ILI9341 TFT SPI display for Ameba.

Syntax
class AmebaILI9341

Members

Public Constructors 
AmebaILI9341::AmebaILI9341Constructs an AmebaILI9341 object.
Public Methods 
AmebaILI9341::beginInitialize SPI, pin mapping and screen configuration.
AmebaILI9341::setAddressInitialize image size and position.
AmebaILI9341::writecommandSPI transfer a command.
AmebaILI9341::writedataSPI transfer a piece of data.
AmebaILI9341::setRotationSet screen orientation.
AmebaILI9341::fillScreenFill the screen with a color.
AmebaILI9341::clrClear screen.
AmebaILI9341::fillRectangleFill a rectangle shape with color and display on the screen.
AmebaILI9341::drawPixelDraw a pixel by coordinates on the screen.
AmebaILI9341::drawCharDraw a character in the frame buffer but does not refresh.
AmebaILI9341::drawLineDraw a line and display on the screen.
AmebaILI9341::drawRectangleDraw a rectangular shape and display on the screen.
AmebaILI9341::drawCircleDraw a circle shape and display on the screen.
AmebaILI9341::writeDisplay a character and display on the screen.
AmebaILI9341::getWidthGet the width of the image.
AmebaILI9341::getHeightGet the height of the image.
AmebaILI9341::setCursorSet the cursor to a specific position on the screen.
AmebaILI9341::setForegroundSet foreground color.
AmebaILI9341::setBackgroundSet background color.
AmebaILI9341::setFontSizeSet character font size.
AmebaILI9341::resetReset the module.

AmebaILI9341::AmebaILI9341

Description
Constructs an AmebaILI9341 object and set CS, DC and RESET pins.

Syntax
AmebaILI9341::AmebaILI9341(int csPin, int dcPin, int resetPin);

Parameters
csPin: pin for Chip Select
dcPin: pin for Data/Command
resetPin: pin for Reset

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
“AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::begin

Description
Initialize hardware SPI, pin mapping and screen configuration.

Syntax
void begin(void);

Parameters
NA

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
“AmebaILI9341.h” must be included to use the class function.
This method is required to run first before other operations on the display.

AmebaILI9341::setAddress

Description
Initialize image size and positioning on the display.

Syntax
void setAddress(uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1);

Parameters
x0: leftmost coordinate of the image
y0: top coordinate of the image
x1: rightmost coordinate of the image
y1: bottom coordinate of the image

Returns
NA

Example Code
NA

Notes and Warnings
Do not use this to set the cursor, use “setCursor” method instead. “AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::writecommand

Description
Transfer a command via SPI.

Syntax
void writecommand(uint8_t command);

Parameters
command: a single byte command

Returns
NA

Example Code
NA

Notes and Warnings
“AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::writedata

Description
Transfer a piece of data via SPI.

Syntax
void writedata(uint8_t data);

Parameters
data: a single byte data

Returns
NA

Example Code
NA

Notes and Warnings
Only use this method to write 1 byte at a time. “AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::setRotation

Description
Setting screen orientation, “0” for no rotation, “1” for 90 degrees rotation, “2” for 180 degrees rotation, “3” for 270 degrees rotation.

Syntax
void setRotation(uint8_t m);

Parameters
m: select desired screen orientation, expressing it as an integer.

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
Although “0” for no rotation, “1” for 90 degrees rotation, “2” for 180 degrees rotation, “3” for 270 degrees rotation, but if m is more than 3, for example, m = 4: there will be no rotation, m= 5: 90 degrees rotation and so on.
“AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::fillScreen

Description
Fill the entire screen with one color.

Syntax
void fillScreen(uint16_t color);

Parameters
color: a 16-bit color reference defined in AmebaILI9341.h

Returns
NA

Example Code
NA

Notes and Warnings
Refer to AmebaILI9341.h for available colors. “AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::clr

Description
Clear the screen.

Syntax
void clr(void);

Parameters
NA

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
Background color can be set by calling setBackground method. ”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::fillRectangle

Description
Fill a rectangle shape with color and display on the screen.

Syntax
void fillRectangle(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color);

Parameters
x: leftmost coordinate of the image
y: top coordinate of the image
w: width of the image
h: height of the image
color: the color of the image

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::drawPixel

Description
Draw a pixel by coordinates on the screen.

Syntax
void drawPixel(int16_t x, int16_t y, uint16_t color);

Parameters
x: leftmost coordinate of the image
y: top coordinate of the image
color: the color of the image

Returns
NA

Example Code
NA

Notes and Warnings
”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::drawChar

Description
Draw a character in the frame buffer but does not refresh.

Syntax
void drawChar(unsigned char c);
void drawChar(int16_t x, int16_t y, unsigned char c, uint16_t _fontcolor, uint16_t _background, uint8_t _fontsize);

Parameters
x: leftmost coordinate of the image
y: top coordinate of the image
c: a character
_fontcolor: font color
_background: background color
_fontsize: font size

Returns
NA

Example Code
NA

Notes and Warnings
By using this method only stores the string of character in a buffer frame. The Print/Println method have to be called in order to display a string of character on the screen. ”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::drawLine

Description
Draw a line and display on the screen.

Syntax
void drawLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1, uint16_t color);
void drawLine(int16_t x0, int16_t y0, int16_t x1, int16_t y1);

Parameters
x0: leftmost coordinate of the image
y0: top coordinate of the image
x1: leftmost coordinate of the image
y1: top coordinate of the image
color: the color of the image

Returns
NA

Example Code
NA

Notes and Warnings
”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::drawRectangle

Description
Draw a rectangular shape and display on the screen.

Syntax
void drawRectangle(int16_t x, int16_t y, int16_t w, int16_t h, uint16_t color);
void drawRectangle(int16_t x, int16_t y, int16_t w, int16_t h);

Parameters
x: leftmost coordinate of the image
y: top coordinate of the image
w: width of the image
h: height of the image
color: the color of the image

Returns
NA

Example Code
NA

Notes and Warnings
”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::drawCircle

Description
Draw a circle shape and display on the screen.

Syntax
void drawCircle(int16_t x0, int16_t y0, int16_t r, uint16_t color);
void drawCircle(int16_t x0, int16_t y0, int16_t r);

Parameters
x0: leftmost coordinate of the image
y0: top coordinate of the image
r: radius of the image
color: the color of the image

Returns
NA

Example Code
NA

Notes and Warnings
”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::write

Description
Display a character and display on the screen.

Syntax
virtual size_t write(uint8_t);

Parameters
c: a character to be written on the screen.

Returns
This function returns the number of bytes written.

Example Code
NA

Notes and Warnings
This an inherited method from Print class and is seldom used. ”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::getWidth

Description
Get the width of the image.

Syntax
int16_t getWidth(void);

Parameters
NA

Returns
This function returns the width of the image.

Example Code
NA

Notes and Warnings
The width is defined in” AmebaILI9341.h”. ” AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::getHeight

Description
Get the height of the image.

Syntax
int16_t getHeight(void);

Parameters
NA

Returns
This function returns the height of the image.

Example Code
NA

Notes and Warnings
The height is defined in” AmebaILI9341.h”. ”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::setCursor

Description
Set the cursor to a specific position on the screen.

Syntax
void setCursor(int16_t x, int16_t y);

Parameters
x: coordinates on the x-axis
y: coordinates on the y-axis

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
”AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::setForeground

Description
Set foreground color.

Syntax
void setForeground(uint16_t color);

Parameters
color: desired colors for foreground

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
Refer to AmebaILI9341.h for available colors. “AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::setBackground

Description
Set background color.

Syntax
void setBackground(uint16_t color);

Parameters
_background: desired background color

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
Refer to AmebaILI9341.h for available colors. “AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::setFontSize

Description
Set the font size of the characters to be printed on the screen.

Syntax
void setFontSize(uint8_t size);

Parameters
size: desired font size. Default values:1 (smallest) to 5 (largest).

Returns
NA

Example Code
Example: PM25_on_ILI9341_TFT_LCD
(https://github.com/ambiot/amb1_arduino/blob/dev/Arduino_package/hardware/libraries/SPI/examples/PM25_on_ILI9341_TFT_LCD/PM25_on_ILI9341_TFT_LCD.ino)

Notes and Warnings
“AmebaILI9341.h” must be included to use the class function.

AmebaILI9341::reset

Description
Reset the module.

Syntax
void reset(void);

Parameters
NA

Returns
NA

Example Code
NA

Notes and Warnings
“AmebaILI9341.h” must be included to use the class function.

Please confirm that QQ communication software is installed
請先確認已安裝QQ通訊軟體