TSC2006 Touch Panel Library

The mikroPascal PRO for ARM provides a library for working with TSC2006 Touch Panel controller.

External dependencies of TSC2006 Touch Panel Library

The following variables must be defined in all projects using Touch Panel TSC2006 Library: Description : Example :
var TSC2006_CS : sbit; sfr; external; Chip Select line. var TSC2006_CS : sbit at GPIO_PORTB_DATA4_bit;
var TSC2006_RST : sbit; sfr; external; Reset line. var TSC2006_RST : sbit at GPIO_PORTE_DATA0_bit;
var TSC2006_CS_Direction : sbit; sfr; external; Direction of the Chip Select pin. var TSC2006_CS_Direction : sbit at GPIO_PORTB_DIR4_bit;
var TSC2006_RST_Direction : sbit; sfr; external; Direction of the Reset pin. var TSC2006_RST_Direction : sbit at GPIO_PORTE_DIR0_bit;

Library Routines

TSC2006_Init

Prototype

function TSC2006_Init() : byte;
Description

Initialize the TSC2006 touch panel controller.
Parameters

None.
Returns
  • -1 - if an error occurred.
  • 0 - if successful.
Requires

External dependencies of the library from the top of the page must be defined before using this function.

The appropriate hardware SPI module must be previously initialized.
See the SPIx_Init and SPIx_Init_Advanced routines.
Example 
var TSC2006_CS : sbit at GPIO_PORTB_DATA4_bit;
var TSC2006_RST : sbit at GPIO_PORTE_DATA0_bit;
var TSC2006_CS_Direction : sbit at GPIO_PORTB_DIR4_bit
var TSC2006_RST_Direction : sbit at GPIO_PORTE_DIR0_bit;
...
SPI1_Init();
TSC2006_Init(;)
Notes

None.

TSC2006_Reset

Prototype

procedure TSC2006_Reset();
Description

This function performs hardware reset of the TSC2006 touch panel controller.
Parameters

None.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_Reset();
Notes

None.

TSC2006_CalibratePoint

Prototype

procedure TSC2006_CalibratePoint(dispCorner : byte);
Description

This function performs calibration of a corner point displayed on the screen.
Parameters
  • dispCorner: corner points. Valid values :
    Value Description
    _TSC2006_DISP_0_0 Corner point at coordinate (0,0).
    _TSC2006_DISP_XMAX_0 Corner point at coordinate (XMAX,0).
    _TSC2006_DISP_XMAX_YMAX Corner point at coordinate (XMAX,YMAX).
    _TSC2006_DISP_0_YMAX Corner point at coordinate (0,YMAX).
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_CalibratePoint(_TSC2006_DISP_0_0);
Notes

All four corner points should be calibrated, starting from the (0,0) up to the (0,YMAX).

TSC2006_PressDetect

Prototype

function TSC2006_PressDetect() : byte;
Description

Detects if there is a change on the X and Y axis.
Parameters

None.
Returns
  • 1 - if touch panel is pressed.
  • 0 - otherwise.
Requires

Nothing.
Example 
if (TSC2006_PressDetect() = 1) then
...
Notes

None.

TSC2006_SetCalibrationConsts

Prototype

procedure TSC2006_SetCalibrationConsts(xMin, xMax, yMin, yMax : word);
Description

Sets calibration constants.
Parameters
  • xMin: minimal calibration value on the X axis.
  • xMax: maximal calibration value on the X axis.
  • yMin: minimal calibration value on the Y axis.
  • yMax: maximal calibration value on the Y axis.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_SetCalibrationConsts(148, 3590, 519, 3370);    // Set calibration constants
Notes

None.

TSC2006_GetCalibrationConsts

Prototype

procedure TSC2006_GetCalibrationConsts(xMin, xMax, yMin, yMax : ^word);
Description

Gets calibration constants after calibration is done and stores them in xMin, xMax, yMin and yMax parameters.
Parameters
  • xMin: minimal calibration value on the X axis.
  • xMax: maximal calibration value on the X axis.
  • yMin: minimal calibration value on the Y axis.
  • yMax: maximal calibration value on the Y axis.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_GetCalibrationConsts(@x_min, @x_max, @y_min, @y_max);    // Get calibration constants
Notes

None.

TSC2006_GetCoordinates

Prototype

function TSC2006_GetCoordinates(xCoord, yCoord : ^word) : byte;
Description

Get touch panel coordinates and store them in xCoord and yCoord parameters.
Parameters
  • xCoord: x coordinate of the place of touch.
  • yCoord: y coordinate of the place of touch.
Returns
  • 0 - if reading is within display dimension range.
  • 1 - if reading is out of display dimension range.
Requires

Nothing.
Example 
if (TSC2006_GetCoordinates(@xCoord, @yCoord) = 0) then
 ...
Notes

None.

TSC2006_SetDisplaySize

Prototype

procedure TSC2006_SetDisplaySize(width, height : word);
Description

Sets the display size.
Parameters
  • width: width of the display.
  • height: height of the display.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_SetDisplaySize(320, 240);
Notes

None.

TSC2006_SetDefaultMode

Prototype

procedure TSC2006_SetDefaultMode();
Description

Sets the touch panel in default mode (threshold set to 6000, 0 degrees rotation).
Parameters

None.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_SetDefaultMode();
Notes

None.

TSC2006_SetTouchPressureThreshold

Prototype

procedure TSC2006_SetTouchPressureThreshold(threshold : word);
Description

Sets the touch panel pressure threshold value.
Parameters
  • threshold: threshold value.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_SetTouchPressureThreshold(6000);
Notes

None.

TSC2006_Rotate180

Prototype

procedure TSC2006_Rotate180();
Description

Rotates the touch panel by 180 degrees.
Parameters

None.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_Rotate180();
Notes

None.

TSC2006_SetTPRotation

Prototype

procedure TSC2006_SetTPRotation(rotation : byte);
Description

Rotates the touch panel clockwise by a given parameter angle.
Parameters
  • rotation: angle by which the touch panel shall be rotated. Valid values :
    Value Description
    _TSC2006_ROTATE_0 0 degrees rotation clockwise.
    _TSC2006_ROTATE_90 90 degrees rotation clockwise.
    _TSC2006_ROTATE_180 180 degrees rotation clockwise.
    _TSC2006_ROTATE_270 270 degrees rotation clockwise.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_SetTPRotation(_TSC2006_ROTATE_180);
Notes

None.

TSC2006_GetTPRotation

Prototype

function TSC2006_GetTPRotation() : byte;
Description

Gets the angle by which the touch panel is rotated.
Parameters

None.
Returns
  • 0 - touch panel is rotated by 0 degrees clockwise.
  • 1 - touch panel is rotated by 90 degrees clockwise..
  • 2 - touch panel is rotated by 180 degrees clockwise.
  • 3 - touch panel is rotated by 270 degrees clockwise.
Requires

Nothing.
Example 
rotation_angle := TSC2006_GetTPRotation();
Notes

None.

TSC2006_ReadCB0

Prototype

function TSC2006_ReadCB0(cb0 : byte) : word;
Description

Reads the value stored in touch panel controller register using the control byte 0 command format (read data registers and non-conversion-related controls).
Parameters
  • cb0: control byte 0 command.
Returns

Value stored in register.
Requires

Nothing.
Example 
read_value := TSC2006_ReadCB0(cb0);
Notes

None.

TSC2006_WriteCB0

Prototype

procedure TSC2006_WriteCB0(cb0 : byte; value : word);
Description

Stores the value in touch panel controller register using the control byte 0 command format (write data registers and non-conversion-related controls).
Parameters
  • cb0: control byte 0 command
  • value: value to be stored.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_WriteCB0(cb0, value);
Notes

None.

TSC2006_WriteCB1

Prototype

procedure TSC2006_WriteCB1(cb1 : byte);
Description

Stores the value in touch panel controller register using the control byte 1 command format (start conversion and channel select and conversion-related configuration).
Parameters
  • cb1: control byte 1 command
  • value: value to be stored.
Returns

Nothing.
Requires

Nothing.
Example 
TSC2006_WriteCB1(cb1, value);
Notes

None.