Bridgetek FT801 Betriebsanleitung

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.

Dieses Handbuch passt für folgende Modelle

Inhaltsverzeichnis

Andere Bridgetek Controller Handbücher

Bridgetek

Bridgetek PanL PC0011 Bedienungsanleitung

Beliebte Controller Handbücher anderer Marken

Digiplex

Digiplex DGP-848 Betriebsanleitung

YASKAWA

YASKAWA SGM series Bedienungsanleitung

Sinope

Sinope Calypso RM3500ZB Bedienungsanleitung

Isimet

Isimet DLA Series Style 2 Installationshandbuch

LSIS

LSIS sv-ip5a Bedienungsanleitung

Rockwell Automation

Rockwell Automation 1769-L31 Bedienungsanleitung

Airflow

Airflow Uno hab Bedienungsanleitung

ABB

ABB ACS580-01 drives Bedienungsanleitung

Panasonic

Panasonic GM1 Series Bedienungsanleitung

Emerson

Emerson SW93 Bedienungsanleitung

AutoAqua

AutoAqua Smart ATO micro SATO-120P Bedienungsanleitung

Panasonic

Panasonic FP? Positioning Unit RTEX Bedienungsanleitung

Samson

Samson Type 5824 Service-Handbuch

Alpha IP

Alpha IP MIOB 21001 Bedienungsanleitung

Siemens

Siemens OpenAir GMA 1 Series Bedienungsanleitung

Surecom

Surecom SR-629 Bedienungsanleitung

Fishman

Fishman TriplePlay Bedienungsanleitung

Regulus

Regulus SRS1 T Bedienungsanleitung