Angel David Yaguana Hernandez / SPI_TFT_Sherckuith
Embed: (wiki syntax)

« Back to documentation index

SPI_TFT Class Reference

SPI_TFT Class Reference

Display control class, based on GraphicsDisplay and TextDisplay. More...

#include <SPI_TFT.h>

Inherits GraphicsDisplay.

Public Member Functions

 SPI_TFT (PinName mosi, PinName miso, PinName sclk, PinName cs, PinName reset, PinName bk, const char *name="TFT")
 Create a SPI_TFT object connected to SPI and two pins.
virtual int width ()
 Get the width of the screen in pixel.
virtual int height ()
 Get the height of the screen in pixel.
virtual void pixel (int x, int y, int colour)
 Draw a pixel at x,y with color.
void circle (int x, int y, int r, int colour)
 draw a circle
void fillcircle (int x, int y, int r, int colour)
 draw a filled circle
void line (int x0, int y0, int x1, int y1, int colour)
 draw a 1 pixel line
void rect (int x0, int y0, int x1, int y1, int colour)
 draw a rect
void fillrect (int x0, int y0, int x1, int y1, int colour)
 draw a filled rect
virtual void locate (int x, int y)
 setup cursor position
virtual void cls (void)
 Fill the screen with _backgroun color.
virtual int columns (void)
 calculate the max number of char in a line
virtual int rows (void)
 calculate the max number of columns
virtual int _putc (int value)
 put a char on the screen
virtual void character (int x, int y, int c)
 draw a character on given position out of the active font to the TFT
void Bitmap (unsigned int x, unsigned int y, unsigned int w, unsigned int h, unsigned char *bitmap)
 paint a bitmap on the TFT
int BMP_16 (unsigned int x, unsigned int y, const char *Name_BMP)
 paint a 16 bit BMP from local filesytem on the TFT (slow)
int BMP_SD (unsigned int x_sd, unsigned int y_sd, const char *Name_BMP_SD)
 paint a 16 bit BMP from memory uSD Card on the TFT (slow)
void set_font (unsigned char *f)
 select the font to use
void set_orientation (unsigned int o)
 Set the orientation of the screen x,y: 0,0 is always top left.
void tft_rst_hw ()
 Resetea mediante hardware el LFCD TFT a travez del pin RESET.
void backlight (float intensity)
 Enciende el Backligth del LCD TFT a travez de un pin PWM.
void contraste_pos (float min, float max, float steep, float delay)
 Modula el Backligth del LCD TFT a travez de un pin PWM minimo 0.01; maximo 1.0 ; paso para FOR 0.01, retardo 0.01.
void contraste_neg (float max, float min, float steep, float delay)
 Modula el Backligth del LCD TFT a travez de un pin PWM minimo 0.01; maximo 1.0 ; paso para FOR 0.01, retardo 0.01.
void Init_Kernel_Up (float brillo, int color, int orientation, unsigned char *letra, int x, int y, int delay)
void tft_init ()
 Init the HX8347D controller.
void WindowMax (void)
 Set draw window region to whole screen.
void hline (int x0, int x1, int y, int colour)
 draw a horizontal line
void vline (int y0, int y1, int x, int colour)
 draw a vertical line
virtual void windows (unsigned int x, unsigned int y, unsigned int w, unsigned int h)
 Set draw window region.
void wr_dat (int value)
 Write data to the LCD controller.
void wr_cmd (int value)
 Write a command the LCD controller.
void wr_dat_start ()
 Start data sequence to the LCD controller.
void wr_dat_stop ()
 Stop of data writing to the LCD controller.
void wr_dat_only (unsigned short dat)
 write data to the LCD controller
unsigned short rd_dat (void)
 Read data from the LCD controller.
void wr_reg (unsigned char reg, unsigned short val)
 Write a value to the to a LCD register.
unsigned short rd_reg (unsigned char reg)
 Read a LCD register.
virtual bool claim (FILE *stream)
 redirect output from a stream (stoud, sterr) to display

Detailed Description

Display control class, based on GraphicsDisplay and TextDisplay.

Example:

 #include "stdio.h"
 #include "mbed.h"
 #include "SPI_TFT.h"
 #include "string"
 #include "Arial12x12.h"
 #include "Arial24x23.h"
 


 // the TFT is connected to SPI pin 5-7 
 SPI_TFT TFT(p5, p6, p7, p8, p15,"TFT"); // mosi, miso, sclk, cs, reset
 
 int main() {
     TFT.claim(stdout);      // send stdout to the TFT display 
     //TFT.claim(stderr);      // send stderr to the TFT display

     TFT.background(Black);    // set background to black
     TFT.foreground(White);    // set chars to white
     TFT.cls();                // clear the screen
     TFT.set_font((unsigned char*) Arial12x12);  // select the font
     
     TFT.set_orientation(0);
     TFT.locate(0,0);
     printf("  Hello Mbed 0");
     TFT.set_font((unsigned char*) Arial24x23);  // select font 2
     TFT.locate(48,115);
     TFT.printf("Bigger Font");
  }

Definition at line 118 of file SPI_TFT.h.


Constructor & Destructor Documentation

SPI_TFT ( PinName  mosi,
PinName  miso,
PinName  sclk,
PinName  cs,
PinName  reset,
PinName  bk,
const char *  name = "TFT" 
)

Create a SPI_TFT object connected to SPI and two pins.

Parameters:
mosi,miso,sclkSPI
cspin connected to CS of display
resetpin connected to RESET of display

Definition at line 7 of file SPI_TFT.cpp.


Member Function Documentation

int _putc ( int  value ) [virtual]

put a char on the screen

Parameters:
valuechar to print
Returns:
printed char

Definition at line 572 of file SPI_TFT.cpp.

void backlight ( float  intensity )

Enciende el Backligth del LCD TFT a travez de un pin PWM.

Definition at line 859 of file SPI_TFT.cpp.

void Bitmap ( unsigned int  x,
unsigned int  y,
unsigned int  w,
unsigned int  h,
unsigned char *  bitmap 
)

paint a bitmap on the TFT

Parameters:
x,y: upper left corner
wwidth of bitmap
hhigh of bitmap
*bitmappointer to the bitmap data

bitmap format: 16 bit R5 G6 B5

use Gimp to create / load , save as BMP, option 16 bit R5 G6 B5 use winhex to load this file and mark data stating at offset 0x46 to end use edit -> copy block -> C Source to export C array paste this array into your program

define the array as static const unsigned char to put it into flash memory cast the pointer to (unsigned char *) : tft.Bitmap(10,40,309,50,(unsigned char *)scala);

Definition at line 645 of file SPI_TFT.cpp.

int BMP_16 ( unsigned int  x,
unsigned int  y,
const char *  Name_BMP 
)

paint a 16 bit BMP from local filesytem on the TFT (slow)

Parameters:
x,y: upper left corner
*Name_BMPname of the BMP file
Returns:
1 if bmp file was found and painted
-1 if bmp file was found not found
-2 if bmp file is not 16bit
-3 if bmp file is to big for screen
-4 if buffer malloc go wrong

bitmap format: 16 bit R5 G6 B5

use Gimp to create / load , save as BMP, option 16 bit R5 G6 B5 copy to internal file system

Definition at line 674 of file SPI_TFT.cpp.

int BMP_SD ( unsigned int  x_sd,
unsigned int  y_sd,
const char *  Name_BMP_SD 
)

paint a 16 bit BMP from memory uSD Card on the TFT (slow)

Parameters:
x,y: upper left corner
*Name_BMPname of the BMP file
Returns:
1 if bmp file was found and painted
-1 if bmp file was found not found
-2 if bmp file is not 16bit
-3 if bmp file is to big for screen
-4 if buffer malloc go wrong

bitmap format: 16 bit R5 G6 B5

use Gimp to create / load , save as BMP, option 16 bit R5 G6 B5 copy to internal file system

Definition at line 755 of file SPI_TFT.cpp.

void character ( int  x,
int  y,
int  c 
) [virtual]

draw a character on given position out of the active font to the TFT

Parameters:
xx-position of char (top left)
yy-position
cchar to print

Definition at line 588 of file SPI_TFT.cpp.

void circle ( int  x,
int  y,
int  r,
int  colour 
)

draw a circle

Parameters:
x0,y0center
rradius
color16 bit color *

Definition at line 290 of file SPI_TFT.cpp.

bool claim ( FILE *  stream ) [virtual, inherited]

redirect output from a stream (stoud, sterr) to display

Parameters:
streamstream that shall be redirected to the TextDisplay

Definition at line 65 of file TextDisplay.cpp.

void cls ( void   ) [virtual]

Fill the screen with _backgroun color.

Definition at line 277 of file SPI_TFT.cpp.

int columns ( void   ) [virtual]

calculate the max number of char in a line

Returns:
max columns depends on actual font size

Definition at line 560 of file SPI_TFT.cpp.

void contraste_neg ( float  max,
float  min,
float  steep,
float  delay 
)

Modula el Backligth del LCD TFT a travez de un pin PWM minimo 0.01; maximo 1.0 ; paso para FOR 0.01, retardo 0.01.

Definition at line 873 of file SPI_TFT.cpp.

void contraste_pos ( float  min,
float  max,
float  steep,
float  delay 
)

Modula el Backligth del LCD TFT a travez de un pin PWM minimo 0.01; maximo 1.0 ; paso para FOR 0.01, retardo 0.01.

Definition at line 863 of file SPI_TFT.cpp.

void fillcircle ( int  x,
int  y,
int  r,
int  colour 
)

draw a filled circle

Parameters:
x0,y0center
rradius
color16 bit color *

use circle with different radius, can miss some pixel

Definition at line 397 of file SPI_TFT.cpp.

void fillrect ( int  x0,
int  y0,
int  x1,
int  y1,
int  colour 
)

draw a filled rect

Parameters:
x0,y0top left corner
x1,y1down right corner
color16 bit color

Definition at line 533 of file SPI_TFT.cpp.

int height (  ) [virtual]

Get the height of the screen in pixel.

Returns:
height of screen in pixel

Definition at line 26 of file SPI_TFT.cpp.

void hline ( int  x0,
int  x1,
int  y,
int  colour 
)

draw a horizontal line

Parameters:
x0horizontal start
x1horizontal stop
yvertical position
color16 bit color

Definition at line 405 of file SPI_TFT.cpp.

void Init_Kernel_Up ( float  brillo,
int  color,
int  orientation,
unsigned char *  letra,
int  x,
int  y,
int  delay 
)

*

Definition at line 907 of file SPI_TFT.cpp.

void line ( int  x0,
int  y0,
int  x1,
int  y1,
int  colour 
)

draw a 1 pixel line

Parameters:
x0,y0start point
x1,y1stop point
color16 bit color

Definition at line 441 of file SPI_TFT.cpp.

void locate ( int  x,
int  y 
) [virtual]

setup cursor position

Parameters:
xx-position (top left)
yy-position

Definition at line 553 of file SPI_TFT.cpp.

void pixel ( int  x,
int  y,
int  colour 
) [virtual]

Draw a pixel at x,y with color.

Parameters:
xhorizontal position
yvertical position
color16 bit pixel color

Definition at line 243 of file SPI_TFT.cpp.

unsigned short rd_dat ( void   )

Read data from the LCD controller.

Returns:
data from LCD controller

Definition at line 95 of file SPI_TFT.cpp.

unsigned short rd_reg ( unsigned char  reg )

Read a LCD register.

Parameters:
regregister to be read
Returns:
value of the register

Definition at line 118 of file SPI_TFT.cpp.

void rect ( int  x0,
int  y0,
int  x1,
int  y1,
int  colour 
)

draw a rect

Parameters:
x0,y0top left corner
x1,y1down right corner
color16 bit color *

Definition at line 514 of file SPI_TFT.cpp.

int rows ( void   ) [virtual]

calculate the max number of columns

Returns:
max column depends on actual font size

Definition at line 566 of file SPI_TFT.cpp.

void set_font ( unsigned char *  f )

select the font to use

Parameters:
fpointer to font array

font array can created with GLCD Font Creator from http://www.mikroe.com you have to add 4 parameter at the beginning of the font array to use:

  • the number of byte / char
  • the vertial size in pixel
  • the horizontal size in pixel
  • the number of byte per vertical line you also have to change the array to char[]

Definition at line 639 of file SPI_TFT.cpp.

void set_orientation ( unsigned int  o )

Set the orientation of the screen x,y: 0,0 is always top left.

Parameters:
odirection to use the screen (0-3) 90&#65533; Steps

Definition at line 33 of file SPI_TFT.cpp.

void tft_init (  )

Init the HX8347D controller.

Definition at line 132 of file SPI_TFT.cpp.

void tft_rst_hw (  )

Resetea mediante hardware el LFCD TFT a travez del pin RESET.

Definition at line 851 of file SPI_TFT.cpp.

void vline ( int  y0,
int  y1,
int  x,
int  colour 
)

draw a vertical line

Parameters:
xhorizontal position
y0vertical start
y1vertical stop
color16 bit color

Definition at line 423 of file SPI_TFT.cpp.

int width (  ) [virtual]

Get the width of the screen in pixel.

Parameters:
@returnswidth of screen in pixel

Definition at line 20 of file SPI_TFT.cpp.

void WindowMax ( void   )

Set draw window region to whole screen.

Definition at line 272 of file SPI_TFT.cpp.

void windows ( unsigned int  x,
unsigned int  y,
unsigned int  w,
unsigned int  h 
) [virtual]

Set draw window region.

Parameters:
xhorizontal position
yvertical position
wwindow width in pixel
hwindow height in pixels

Definition at line 259 of file SPI_TFT.cpp.

void wr_cmd ( int  value )

Write a command the LCD controller.

Parameters:
cmd,:command to be written

Definition at line 53 of file SPI_TFT.cpp.

void wr_dat ( int  value )

Write data to the LCD controller.

Parameters:
datdata written to LCD controller

Definition at line 62 of file SPI_TFT.cpp.

void wr_dat_only ( unsigned short  dat )

write data to the LCD controller

Parameters:
datato be written *

Definition at line 86 of file SPI_TFT.cpp.

void wr_dat_start ( void   )

Start data sequence to the LCD controller.

Definition at line 73 of file SPI_TFT.cpp.

void wr_dat_stop ( void   )

Stop of data writing to the LCD controller.

Definition at line 80 of file SPI_TFT.cpp.

void wr_reg ( unsigned char  reg,
unsigned short  val 
)

Write a value to the to a LCD register.

Parameters:
regregister to be written
valdata to be written

Definition at line 110 of file SPI_TFT.cpp.