Bridgetek FT801 Istruzioni operative

Product Page

FT800 Series Programmer Guide

Version 2.1

Issue Date: 2016-09-19

This document is a programmer guide for the FT800 series chip. This guide details the

chip features and procedures for use. For FT801 specific features and procedures,

please see the chapter FT801.

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

Table of Content

1Introduction .............................................................. 9

1.1 Overview .............................................................................9

1.2 Scope ..................................................................................9

1.3 API reference definitions.....................................................9

2Programming Model ................................................ 11

2.1 General Software architecture ..........................................11

2.2 Display configuration and initialization .............................12

2.2.1 Horizontal timing..................................................................... 13

2.2.2 Vertical timing ........................................................................ 14

2.2.3 Signals updating timing control ................................................. 14

2.2.4 Timing example: 480x272 at 60Hz ............................................ 15

2.2.5 Initialization Sequence ............................................................. 16

2.3 Sound Synthesizer.............................................................17

2.4 Audio playback ..................................................................18

2.5 Graphics routines ..............................................................19

2.5.1 Getting started........................................................................ 19

2.5.2 Coordinate Plane ..................................................................... 20

2.5.3 Drawing pattern ...................................................................... 21

2.5.4 Writing display lists ................................................................. 26

2.5.5 Bitmap transformation matrix ................................................... 27

2.5.6 Color and transparency ............................................................ 27

2.5.7 VERTEX2II and VERTEX2F ........................................................ 28

2.5.8 Screenshot ............................................................................. 30

2.5.9 Performance ........................................................................... 30

3Register Description ................................................ 32

3.1 Graphics Engine Registers .................................................32

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

3.2 Touch Engine Registers (FT800 only) ................................47

3.3 Audio Engine Registers......................................................62

3.4 Co-processor Engine Registers ..........................................68

3.5 Miscellaneous Registers ....................................................70

4Display list commands............................................. 81

4.1 Graphics State ...................................................................81

4.2 Command encoding ...........................................................82

4.3 Command groups ..............................................................83

4.3.1 Setting Graphics state.............................................................. 83

4.3.2 Drawing actions ...................................................................... 84

4.3.3 Execution control..................................................................... 84

4.4 ALPHA_FUNC.....................................................................85

4.5 BEGIN................................................................................86

4.6 BITMAP_HANDLE...............................................................88

4.7 BITMAP_LAYOUT...............................................................89

4.8 BITMAP_SIZE ....................................................................94

4.9 BITMAP_SOURCE...............................................................97

4.10 BITMAP_TRANSFORM_A .................................................99

4.11 BITMAP_TRANSFORM_B ...............................................101

4.12 BITMAP_TRANSFORM_C ...............................................102

4.13 BITMAP_TRANSFORM_D ...............................................103

4.14 BITMAP_TRANSFORM_E ...............................................104

4.15 BITMAP_TRANSFORM_F ...............................................106

4.16 BLEND_FUNC ................................................................107

4.17 CALL .............................................................................110

4.18 CELL..............................................................................111

4.19 CLEAR ...........................................................................112

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

4.20 CLEAR_COLOR_A ..........................................................114

4.21 CLEAR_COLOR_RGB ......................................................115

4.22 CLEAR_STENCIL............................................................117

4.23 CLEAR_TAG ...................................................................118

4.24 COLOR_A ......................................................................119

4.25 COLOR_MASK................................................................120

4.26 COLOR_RGB ..................................................................122

4.27 DISPLAY .......................................................................123

4.28 END...............................................................................124

4.29 JUMP.............................................................................125

4.30 LINE_WIDTH ................................................................126

4.31 MACRO..........................................................................127

4.32 POINT_SIZE..................................................................128

4.33 RESTORE_CONTEXT ......................................................129

4.34 RETURN ........................................................................130

4.35 SAVE CONTEXT .............................................................131

4.36 SCISSOR_SIZE ..............................................................132

4.37 SCISSOR_XY .................................................................134

4.38 STENCIL_FUNC .............................................................135

4.39 STENCIL_MASK.............................................................137

4.40 STENCIL_OP .................................................................138

4.41 TAG...............................................................................140

4.42 TAG_MASK ....................................................................141

4.43 VERTEX2F .....................................................................142

4.44 VERTEX2II ....................................................................143

5Co-Processor Engine commands ............................ 144

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

5.1 Co-processor handling of Display list commands.............146

5.2 Synchronization ..............................................................146

5.3 ROM and RAM Fonts ........................................................147

5.4 Cautions ..........................................................................148

5.5 Fault Scenarios................................................................149

5.6 widgets physical dimension.............................................149

5.7 widgets color settings .....................................................149

5.8 Co-processor engine graphics state ................................150

5.9 Definition of parameter OPTION......................................151

5.10 Co-processor engine resources .....................................153

5.11 Command groups..........................................................153

5.12 CMD_DLSTART - start a new display list .......................155

5.13 CMD_SWAP - swap the current display list ...................156

5.14 CMD_COLDSTART - set co-processor engine state to

default values .........................................................................156

5.15 CMD_INTERRUPT - trigger interrupt INT_CMDFLAG......158

5.16 CMD_APPEND - append memory to display list .............159

5.17 CMD_REGREAD - read a register value..........................160

5.18 CMD_MEMWRITE - write bytes into memory.................161

5.19 CMD_INFLATE - decompress data into memory ............163

5.20 CMD_LOADIMAGE - load a JPEG image .........................164

5.21 CMD_MEMCRC - compute a CRC-32 for memory............166

5.22 CMD_MEMZERO - write zero to a block of memory........167

5.23 CMD_MEMSET - fill memory with a byte value ..............168

5.24 CMD_MEMCPY - copy a block of memory.......................169

5.25 CMD_BUTTON - draw a button ......................................170

5.26 CMD_CLOCK - draw an analog clock..............................173

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

5.27 CMD_FGCOLOR - set the foreground color ....................178

5.28 CMD_BGCOLOR - set the background color ...................179

5.29 CMD_GRADCOLOR - set the 3D button highlight color ..181

5.30 CMD_GAUGE - draw a gauge .........................................183

5.31 CMD_GRADIENT - draw a smooth color gradient ..........190

5.32 CMD_KEYS - draw a row of keys ...................................194

5.33 CMD_PROGRESS - draw a progress bar.........................199

5.34 CMD_SCROLLBAR –draw a scroll bar............................202

5.35 CMD_SLIDER –draw a slider ........................................205

5.36 CMD_DIAL –draw a rotary dial control.........................208

5.37 CMD_TOGGLE –draw a toggle switch ...........................211

5.38 CMD_TEXT - draw text ..................................................214

5.39 CMD_NUMBER - draw a decimal number.......................218

5.40 CMD_SETMATRIX - write the current matrix to the display

list 221

5.41 CMD_GETMATRIX - retrieves the current matrix

coefficients .............................................................................221

5.42 CMD_GETPTR - get the end memory address of inflated

data 223

5.43 CMD_GETPROPS - get the image properties decompressed

by CMD_LOADIMAGE...............................................................224

5.44 CMD_SCALE - apply a scale to the current matrix .........224

5.45 CMD_ROTATE - apply a rotation to the current matrix ..227

5.46 CMD_TRANSLATE - apply a translation to the current

matrix .....................................................................................229

5.47 CMD_CALIBRATE - execute the touch screen calibration

routine ....................................................................................231

5.48 CMD_SPINNER - start an animated spinner ..................232

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

5.49 CMD_SCREENSAVER - start an animated screensaver...236

5.50 CMD_SKETCH - start a continuous sketch update .........237

5.51 CMD_STOP - stop any of spinner, screensaver or sketch

239

5.52 CMD_SETFONT - set up a custom font...........................240

5.53 CMD_TRACK - track touches for a graphics object ........241

5.54 CMD_SNAPSHOT - take a snapshot of the current screen

245

5.55 CMD_LOGO - play FTDI logo animation .........................246

6FT801 operation .................................................... 247

6.1 FT801 introduction ..........................................................247

6.2 FT801 touch engine .........................................................247

6.3 FT801 touch registers .....................................................247

6.4 Register summary ...........................................................253

6.5 Calibration.......................................................................253

6.6 CMD_CSKETCH –Capacitive touch specific sketch ...........254

7Contact Information .............................................. 256

Appendix A –References ........................................... 257

Document References .............................................................257

Acronyms & Abbreviations ......................................................257

Appendix B –List of Figures & Tables ........................ 258

List of Figures .........................................................................258

List of Tables...........................................................................258

Appendix C –Memory Map ......................................... 259

Appendix D - List of Code Snippet .............................. 260

Appendix E - List of Registers .................................... 261

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

Appendix F –Revision History ................................... 263

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

1Introduction

This document captures programming details of FT800 series chips including graphics

commands, widget commands and configurations to control FT800 series chips for

smooth and vibrant screen effects.

The FT800 series chips are graphics controllers with add-on features such as audio

playback and touch capabilities. They consist of a rich set of graphics objects (primitive

and widgets) that can be used for displaying various menus and screen shots for a range

of products including home appliances, toys, industrial machinery, home automation,

elevators, and many more.

1.1 Overview

This document will be useful to understand the command set and demonstrate the ease

of usage in the examples given for each specific instruction. In addition, it also covers

various power modes, audio, and touch features as well as their usage.

Information on pin settings, hardware model and hardware configuration can be found in

the FT800 data sheet (DS_FT800_Embedded_Video_Engine) or FT801 datasheet

(DS_FT801).

1.2 Scope

This document is targeted for software programmers and system designers to develop

graphical user interface (GUI) applications on any system processor with either an SPI or

I2C master port.

1.3 API reference definitions

Functionality and nomenclature of the APIs used in this document.

wr8() –write 8 bits to intended address location

wr16() –write 16 bits to intended address location

wr32() –write 32 bits to intended address location

wr8s() –write 8 bits string to intended address location

rd8() –read 8 bits from intended address location

rd16() –read 16 bits from intended address location

rd32() –read 32 bits from intended address location

rd8s() –read 8 bits string from intended address location

cmd() –write 32 bits command to co-processor engine FIFO RAM_CMD

FT800 Series Programmer Guide

Version 2.1

Document Reference No.: BRT_000030 Clearance No.: BRT#037

Product Page

cmd_*() –Write 32 bits co-processor engine command with its necessary parameters to

the co-processor engine FIFO (RAM_CMD).

dl() –Write the specified 32 bits display list command to RAM_DL. Refer to section 2.5.4

Writing display lists for more information.

host_command() –send host command to FT800. Refer to the FT800 data sheet for

more information.

Questo manuale è adatto per i seguenti modelli

Indice

Altri manuali Bridgetek Controllori

Bridgetek

Bridgetek PanL PC0011 Manuale utente

Manuali Controllori popolari di altre marche

Digiplex

Digiplex DGP-848 Istruzioni operative

YASKAWA

YASKAWA SGM series Manuale utente

Sinope

Sinope Calypso RM3500ZB Manuale utente

Isimet

Isimet DLA Series Style 2 Manuale di installazione

LSIS

LSIS sv-ip5a Manuale utente

Rockwell Automation

Rockwell Automation 1769-L31 Manuale utente

Airflow

Airflow Uno hab Manuale utente

ABB

ABB ACS580-01 drives Manuale utente

Panasonic

Panasonic GM1 Series Manuale utente

Emerson

Emerson SW93 Manuale utente

AutoAqua

AutoAqua Smart ATO micro SATO-120P Manuale utente

Panasonic

Panasonic FP? Positioning Unit RTEX Manuale utente

Samson

Samson Type 5824 Manuale di servizio

Alpha IP

Alpha IP MIOB 21001 Manuale utente

Siemens

Siemens OpenAir GMA 1 Series Manuale utente

Surecom

Surecom SR-629 Manuale utente

Fishman

Fishman TriplePlay Manuale utente

Regulus

Regulus SRS1 T Manuale utente