BT817Q EVE Migration Guide

EVE Migration Guide

Rev.1.0 2022-01-19

Introduction

The EVE family is a single-chip solution that combines display,
audio, and touch capabilities into one optimized package. It
provides high-quality graphics output to 1/16th pixel resolution
for WVGA, VGA, SVGA, WQVGA, WSVGA, WXGA TFT display panels. There
are four versions of EVE microcontrollers: FT800/1, FT810/1,
FT812/3, BT815/6, and BT817/8. Depending on the version, EVE
microcontrollers differ in their specifications.

Specifications for BT817/8

Parameter	Specification
Target Display Resolution*	WVGA, SVGA, WSVGA, WXGA
Max Pixels Per Line	2048
Display Interface	RGB666, RGB888
Touch Function	817-Capacitive
Audio Output	Sigma-Delta
Host Interface	SPI/QSPI
Object Memory Size	1 MB
External Memory Support	Up to 256 MB
Adaptive Framerate	Yes
Adaptive HSYNC	Yes
Dedicated PCLK	Yes
PLL 2X Pixel Mode	Yes
Non Square Pixel	Yes
Co-Processor	32-bit RISC
GPIOs	5
Package	QFN64

Design Differences

When switching to the newer generation of EVE, some differences
between the EVE versions should be taken into account. The register
addresses used in EVE1, EVE2, EVE3, and EVE4 are different.

Oscillator Register Addresses

If you have your own defined code, you have to change register
addresses using datasheets of IC:

REGISTER NAME	REG_ID REG_FRAMES REG_CLOCK REG_FREQUENCY REG_RENDERMODE REG_SNAPY REG_SNAPSHOT REG_SNAPFORMAT REG_CPURESET REG_TAP_CRC REG_TAP_MASK REG_HCYCLE REG_HOFFSET REG_HSIZE REG_HSYNC0 REG_HSYNC1 REG_VCYCLE REG_VOFFSET REG_VSIZE REG_VSYNC0 REG_VSYNC1 REG_DLSWAP REG_ROTATE REG_OUTBITS REG_DITHER REG_SWIZZLE REG_CSPREA-D REG_PCLK_POL REG_PCLK REG_TAG_X REG_TAG_Y REG_TAG REG_VOL_PB REG_VOL_SOUND REG_SOUND REG_PLAY REG_GPIO_DIR REG_GPIO REG_GPIOX_DIR REG_GPIOX Reserved
BT817/8	—

REG_ID REG_FRAMES REG_CLOCK REG_FREQUENCY REG_RENDERMODE
REG_SNAPY REG_SNAPSHOT REG_SNAPFORMAT REG_CPURESET REG_TAP_CRC
REG_TAP_MASK REG_HCYCLE REG_HOFFSET REG_HSIZE REG_HSYNC0 REG_HSYNC1
REG_VCYCLE REG_VOFFSET REG_VSIZE REG_VSYNC0 REG_VSYNC1 REG_DLSWAP
REG_ROTATE REG_OUTBITS REG_DITHER REG_SWIZZLE REG_CSPREA-D
REG_PCLK_POL REG_PCLK REG_TAG_X REG_TAG_Y REG_TAG REG_VOL_PB
REG_VOL_SOUND REG_SOUND REG_PLAY REG_GPIO_DIR REG_GPIO
REG_GPIOX_DIR REG_GPIOX Reserved

BT817/8

—

Product Usage Instructions

Refer to the datasheets of the IC to change register addresses
if you have your own defined code. For more information on displays
using EVE4 and their possibilities, please visit Riverdi’s
website.

View Fullscreen

EVE MIGRATION GUIDE

EVE Migration Guide
Rev.1.0 2022-01-19

EVE Migration Guide

REVISION RECORDS

REVNO. 1.0

REVDATE 2022-01-19

CONTENTS Initial Release

REMARKS

CONTENTS
REVISION RECORDS …………………………………………………………………………………………………. 2 CONTENTS ………………………………………………………………………………………………………………….. 2 INTRODUCTION …………………………………………………………………………………………………………. 3 DESIGN DIFFERENCES ……………………………………………………………………………………………… 4

LEGAL INFORMATION ……………………………………………………………………………………………………… 8

Page 2 of 8

www.riverdi.com

EVE Migration Guide

INTRODUCTION
The EVE family combines display, audio and touch into a single chip, providing an optimized solution with high quality graphics that output to 1/16th pixel resolution for WVGA, VGA, SVGA, WQVGA, WSVGA, WXGA TFT display panels. There are 4 versions of EVE:
1. EVE1 FT800/1, 2. EVE2 FT810/1; FT812/3, 3. EVE3 BT815/6, 4. EVE4 BT817/8.
Depending on the version EVE microcontrollers differ in their specifications. The below information relates to the IC.

PARAMETER FT800/1 FT810/1 FT812/3 BT815/6 BT817/8

Target Display Resolution*

QVGA WQVGA
HVGA

HVGA VGA WVGA SVGA

WVGA SVGA WSVGA WXGA

Max Pixels Per Line

512

2048

Display Interface

RGB666

RGB666, RGB888

Touch Function

800-Resistive 801Capacitive

810-Resistive 812-Resistive 816-Resistive 818-Resistive 811-Capacitive 813-Capacitive 815-Capacitive 817-Capacitive

Audio Output

PWM

Sigma-Delta Sigma-Delta

Host Interface

SPI/I2C

SPI/QSPI

90° Screen Rotation

Yes

Object Memory Size

256 kB

1 MB

External Memory Support

Up to 256 MB Up to 256 MB

Adaptive Framerate

Yes

Adaptive HSYNC

Yes

Dedicated PCLK

Yes

PLL

2X Pixel Mode

Yes

Non Square Pixel

Yes

Co-Processor

32-bit RISC

48MHz

60MHz

72MHz

Image Decoder

DXT1, JPEG

DXT1, JPEG,

PNG

PNG, ASTC

Hardware

JPEG

JPEG, ASTC

Acceleration

Video Playback

Motion JPEG Motion JPEG Motion JPEG Motion JPEG

Animation

Yes

Playback

GPIOs

Package

QFN48

QFN56

QFN64

* QVGA 320*240; WQVGA 480*272; HVGA 480*320; VGA 640*480; WVGA 800*480; SVGA 800*600; WSYGA 1024*600; WXGA 1280*800

Page 3 of 8

www.riverdi.com

EVE Migration Guide
Compared to the previous generation FT81X series (EVE2), the BT81X (EVE 3/4) series introduces several enhanced features:
· QSPI NOR flash interface, · Adaptive Scalable Texture Compression (ASTC) format bitmap, · unicode text display, · animation support.
Compared to BT815/6, BT817/8 has a 1.5x graphics engine performance improvement. In addition, it introduces many enhancements including:
· programmable timing to adjust HSYNC and VSYNC timing, enabling interface to numerous displays,
· add Horizontal Scan out Filter to support non-square pixel LCD display, · Adaptive Hsync modes, · Supports Animation in RAM_G, · enable constructing command list in RAM_G, · new font cache mechanism for custom fonts whose glyph is in flash.
If you want to read more about displays using EVE4 and their possibilities, please visit Riverdi’s website.
DESIGN DIFFERENCES
When switching to the newer generation of EVE, some differences between the EVE versions should be taken into account.
Oscillator
· EVE1, EVE3 use internal oscillator, · EVE2 use external oscillator, · EVE4 use internal or external oscillator.
Register addresses
The register addresses used in EVE1, EVE2, EVE3 and EVE4 are different, so:
a) if you use Riverdi’s library https://github.com/riverdi/riverdi-eve/, all you have to do is change the definition in the module.h file to #define EVE_4 and the definitions that define the display you are using,
b) if you have your own defined code, you have to change register addresses using datasheets of IC:
· EVE1 (version 1.4, chapter 5, page 30), · EVE2 (version 1.4, chapter 5, page 41), · EVE3 (version 1.0, chapter 5, page 42), · EVE4 (version 1.1, chapter 5, page 40).

Page 4 of 8

www.riverdi.com

EVE Migration Guide

REGISTER NAME
REG_ID REG_FRAMES REG_CLOCK REG_FREQUENCY REG_RENDERMODE REG_SNAPY REG_SNAPSHOT REG_SNAPFORMAT REG_CPURESET REG_TAP_CRC REG_TAP_MASK REG_HCYCLE REG_HOFFSET REG_HSIZE REG_HSYNC0 REG_HSYNC1 REG_VCYCLE REG_VOFFSET REG_VSIZE REG_VSYNC0 REG_VSYNC1 REG_DLSWAP REG_ROTATE REG_OUTBITS REG_DITHER REG_SWIZZLE REG_CSPREA-D REG_PCLK_POL REG_PCLK REG_TAG_X REG_TAG_Y REG_TAG REG_VOL_PB REG_VOL_SOUND REG_SOUND REG_PLAY REG_GPIO_DIR REG_GPIO REG_GPIOX_DIR REG_GPIOX Reserved
REG_INT_FLAGS

FT800/1 (EVE1)
102400h 102404h 102408h 10240Ch 102410h 102414h 102418h
10241Ch 102420h 102424h 102428h 10242Ch 102430h 102434h 102438h 10243Ch 102440h 102444h 102448h 10244Ch 102450h 102454h 102458h 10245Ch 102460h 102464h 102468h 10246Ch 102470h 102474h 102478h 10247Ch 102480h 102484h 102488h 10248Ch 102490h
102494h
102498h

ADDRESS

FT810/1 FT812/3 (EVE2) 302000h 302004h 302008h 30200Ch 302010h 302014h 302018h 30201Ch 302020h 302024h 302028h 30202Ch 302030h 302034h 302038h 30203Ch 302040h 302044h 302048h 30204Ch 302050h 302054h 302058h 30205Ch 302060h 302064h 302068h 30206Ch 302070h 302074h 302078h 30207Ch 302080h 302084h 302088h 30208Ch 302090h 302094h 302098h 30209Ch 3020A0h 3020A4h 3020A8h

BT815/6 (EVE3)
302000h 302004h 302008h 30200Ch 302010h 302014h 302018h 30201Ch 302020h 302024h 302028h 30202Ch 302030h 302034h 302038h 30203Ch 302040h 302044h 302048h 30204Ch 302050h 302054h 302058h 30205Ch 302060h 302064h 302068h 30206Ch 302070h 302074h 302078h 30207Ch 302080h 302084h 302088h 30208Ch 302090h 302094h 302098h 30209Ch 3020A0h 3020A4h 3020A8h

BT817/8 (EVE4)
302000 h 302004h 302008h 30200Ch 302010h 302014h 302018h 30201Ch 302020h 302024h 302028h 30202Ch 302030h 302034h 302038h 30203Ch 302040h 302044h 302048h 30204Ch 302050h 302054h 302058h 30205Ch 302060h 302064h 302068h 30206Ch 302070h 302074h 302078h 30207Ch 302080h 302084h 302088h 30208Ch 302090h 302094h 302098h 30209Ch 3020A0h 3020A4h 3020A8h

Page 5 of 8

www.riverdi.com

EVE Migration Guide

REG_INT_EN REG_INT_MASK REG_PLAYBACK_START REG_PLAYBACK_LENGTH REG_PLAYBACK_READPTR REG_PLAYBACK_FREQ REG_PLAYBACK_FORMAT REG_PLAYBACK_LOOP REG_PLAYBACK_PLAY REG_PWM_HZ REG_PWM_DUTY REG_MACRO_0 REG_MACRO_1 Reserved
REG_CMD_READ REG_CMD_WRITE REG_CMD_DL REG_TOUCH_MODE REG_TOUCH_ADC_MODE REG_CTOUCH_EXTENDED REG_TOUCH_CHARGE REG_EHOST_TOUCH_X REG_TOUCH_SETTLE REG_TOUCH_OVERSAMPLE REG_EHOST_TOUCH_ID REG_TOUCH_RZTHRESH REG_EHOST_TOUCH_Y REG_TOUCH_ RAW_XY REG_CTOUCH_TOUCH1_X Y REG_TOUCH_RZ REG_CTOUCH_TOUCH4_Y REG_TOUCH_ SCREEN_XY REG_CTOUCH_TOUCH0_X Y REG_TOUCH_ TAG_XY REG_TOUCH_TAG REG_TOUCH_ TAG1_XY REG_TOUCH_TAG1 REG_TOUCH_ TAG2_XY REG_TOUCH_TAG2 REG_TOUCH_ TAG3_XY REG_TOUCH_TAG3 REG_TOUCH_ TAG4_XY REG_TOUCH_TAG4 REG_TOUCH_TRANSFORM _A REG_TOUCH_TRANSFORM _B

10249Ch 1024A0h 1024A4h 1024A8h 1024ACh 1024B0h 1024B4h 1024B8h 1024BCh 1024C0h 1024C4h 1024C8h 1024CCh 1024D0h 1024E0h 1024E4h 1024E8h 1024ECh 1024F0h 1024F4h
1024F8h
1024FCh 102500h
102504h
102508h
10250Ch
102510h
102514h 102518h
10251Ch
102520h

3020Ach 3020B0h 3020B4h 3020B8h 3020BCh 3020C0h 3020C4h 3020C8h 3020CCh 3020D0h 3020D4h 3020D8h 3020DCh 3020E0h 3020F4h 3020F8h 3020FCh 302100h 302104h 302108h
30210Ch
302110h 302114h
302118h
30211Ch
302120h
302124h
302128h 30212Ch 302130h 302134h 302138h 30213Ch 302140h 302144h 302148h 30214Ch 302150h
302154h

Page 6 of 8

www.riverdi.com

EVE Migration Guide

REG_TOUCH_TRANSFORM _C REG_TOUCH_TRANSFORM _D REG_TOUCH_TRANSFORM _E REG_TOUCH_TRANSFORM _F REG_TOUCH_CONFIG REG_CTOUCH_TOUCH4_X Reserved
REG_EHOST_TOUCH_ACK REG_BIST_EN Reserved
REG_TRIM REG_ANA_COMP REG_SPI_WIDTH REG_TOUCH_DIRECT_XY REG_CTOUCH_TOUCH2_X Y REG_TOUCH_DIRECT_Z1Z 2 REG_CTOUCH_TOUCH3_X Y Reserved
REG_DATESTAMP REG_CMDB_SPACE REG_CMDB_WRITE REG_ADAPTIVE_FRAMERA TE REG_PLAYBACK_PAUSE REG_FLASH_STATUS Reserved
REG_UNDERRUN REG_AH_HCYCLE_MAX REG_PCLK_FREQ REG_PCLK_2X REG_TRACKER REG_TRACKER_1 REG_TRACKER_2 REG_TRACKER_3 REG_TRACKER_4 REG_MEDIAFIFO_READ REG_MEDIAFIFO_WRITE REG_FLASH_SIZE REG_ANIM_ACTIVE REG_PLAY_CONTROL

102524h
102528h
10252Ch
102530h
102534h 102470h –
102574h
102578h
–
–
–
109000h –

302158h
30215Ch
302160h
302164h
302168h 30216Ch 302170h
302174h 302178h 30217Ch 302180h 302184h 302188h 30218Ch
302190h
302194h 302560h 302564h 302574h 302578h
–
–
–

302158h
30215Ch
302160h
302164h
302168h 30216Ch
–
302170h 302174h 302178h 302187Ch 302180h 302184h 302188h 30218Ch
302190h
302194h 302560h 302564h 302574h 302578h 30257Ch
3025ECh 3025F0h
–
–

302158h
30215Ch
302160h
302164h
302168h 30216Ch
–
302170h 302174h 302178h 302187C h
302184h 302188h 30218Ch
302190h
302194h 302560h 302564h 302574h 302578h 30257Ch
3025ECh 3025F0h 3025F4h 302608h 30260Ch 302610h 302614h 302618h 309000h 309004h 309008h 30900Ch 309010h 309014h 309018h 309024h 30902Ch 30914Eh

Page 7 of 8

www.riverdi.com

EVE Migration Guide
SWITCH TO RIVERDI!
In Riverdi we focus on solutions. Modifying our products to support the requirements of customers is our specialty.
Both our custom and off-the-shelf displays are designed and manufactured in our headquarters in Europe, from components sourced from across the world — including the latest glass technologies only available in Asian markets. By keeping a large inventory of components, we are able to offer short lead times and flexible minimum order quantities.
Whether you are developing a prototype you need to show to a client or investor, or preparing to manufacture at scale for retail, hospitality, healthcare or any other industry — Riverdi can provide you with the right display solutions.
We offer the best technologies, competitive prices, and exceptional customer service, accompanied by a free sample designed by your requirements.
As top display solution experts on the market, we will create the best solution in every aspect, including price and service, not to mention quality.
With us, you don’t have to worry about hidden costs. We will design, develop, and manufacture your sample.
The only thing you need to do is send us information about your current project. We’ll handle the rest. Contact us at: [email protected]

Page 8 of 8

www.riverdi.com