This example Seeeduino (Arduino clone) code is for the Crystalfontz line of displays powered by a Bridgetek EVE BT817 chip. These displays are driven by the powerful BT817 chip and are available in a range of sizes, touch options, and brightnesses. Please refer to the datasheets for more information.
For more information on our full list of EVE displays, please click here
4"
CFA480480E0-040TN - Non-Touch
CFA480480E0-040TW - Capacitive Touch\
4.3" - 800x480
CFA800480E0-043SC - Capacitive Touch
CFA800480E0-043SR - Resistive Touch
CFA800480E0-043SN - Non-Touch\
4.3" - 480x272
CFA480272E0-043SC - Capacitive Touch
CFA480272E0-043SR - Resistive Touch
CFA480272E0-043SN - Non-Touch\
5" EVE Displays
CFA800480E3-050SW - Capacitive Touch With Overhanging Glass
CFA800480E3-050SC - Capacitive Touch
CFA800480E3-050SR - Resistive Touch
CFA800480E3-050SN - Non-Touch\
7"
CFAF1024600B0-070SC-A1 - Capacitive Touch
4"
CFA480480E0-040TN-KIT - Non-Touch
CFA480480E0-040TW-KIT - Capacitive Touch\
4.3" - 800x480
CFA800480E0-043SC-KIT - Capacitive Touch
CFA800480E0-043SR-KIT - Resistive Touch
CFA800480E0-043SN-KIT - Non-Touch\
4.3" - 480x272
CFA480272E0-043SC-KIT - Capacitive Touch
CFA480272E0-043SR-KIT - Resistive Touch
CFA480272E0-043SN-KIT - Non-Touch\
5" EVE Displays
CFA800480E3-050SW-KIT - Capacitive Touch With Overhanging Glass
CFA800480E3-050SC-KIT - Capacitive Touch
CFA800480E3-050SR-KIT - Resistive Touch
CFA800480E3-050SN-KIT - Non-Touch\
7"
CFAF1024600B0-070SC-A12 - Capacitive Touch
To toggle on or off different demonstrations, some defines in "CFA_E_defines.h" can be changed.
#define BMP_DEMO (0)
#define BMP_SCROLL (0)
#define SOUND_DEMO (0)
#define SOUND_VOICE (0)
#define SOUND_PLAY_TIMES (10)
#define LOGO_DEMO (1)
#define LOGO_PNG_0_ARGB2_1 (1)
#define BOUNCE_DEMO (1)
#define MARBLE_DEMO (0)
#define TOUCH_DEMO (0)
#define VIDEO_DEMO (0) BMP_DEMO - Toggled to 1 will look to the uSD card to pull the "SPLASH.RAW" file and display it
BMP_SCROLL - Toggled to 1 will look to the uSD card to pull the "CLOUDS.RAW" file and display it scrolling accross the screen
LOGO_DEMO - Toggled to 1 will display the Crystalfontz Logo from flash
BOUNCE_DEMO - Toggled to 1 will show a ball bouncing around the screen
MARBLE_DEMO - Toggled to 1 will look in the uSD card and pull "BLUEMARB.RAW" and demonstrate the earth rotating and bouncing around in screen in place of the ball
TOUCH_DEMO - Toggled to 1 will enable the touch screen (only compatible on touch versions of the display)
VIDEO_DEMO - Toggled to 1 will enable the video playback. The video must already be programmed into flash by using PROGRAM_FLASH_FROM_USD (Ice_400.avi)
Creating the files:
- Open EVE Asset Builder
- In the Image Converter tool, use the "ADD" button to load the image
- Set the output format to "COMPRESSED_RGBA_ASTC_8x8_KHR" and ASTC Preset to "thorough"
- Click Convert and rename the extension of the file to .a8z
- The file names are hard coded in the firmware. These names can be found starting on line 104 of demos.cpp
Configuring the demo code:
- Load the files on an SD card and connect to the Seeeduino (see pinout)
- Set PROGRAM_FLASH_FROM_USD to 1
- Compile and upload the firmware
- Watch the serial monitor, the code will export the memory locations that are needed for the demo code to work
- Take the macros that are exported from the code and insert them on line 92 of CFA10100_defines.h
- Set PROGRAM_FLASH_FROM_USD to 0
- Set VIDEO_DEMO to 1
- Compile and upload the code
Here is an example of the macros that will exported from the code:
#define FLASH_SECTOR_MARBLE (1UL)
#define FLASH_LENGTH_MARBLE (14400UL) // sectors: 3
#define FLASH_SECTOR_SPLASH (5UL)
#define FLASH_LENGTH_SPLASH (153600UL) // sectors: 37
#define FLASH_SECTOR_CLOUDS (43UL)
#define FLASH_LENGTH_CLOUDS (153600UL) // sectors: 37
#define FLASH_SECTOR_ICE_FPV_512x300 (81UL)
#define FLASH_LENGTH_ICE_FPV_512x300 (12882892UL) // sectors: 3145
For an in-depth guide to loading custom images on our EVE lineup of displays without an SD card (using the Seeeduino's flash memory) please refer to our blog post available here.
To CFA10098 Adapter Board (See kits above)
| 10098 Pin | Seeeduino Pin | Connection Description |
|---|---|---|
| 1 (3v3) | 3v3 | +3.3V Power |
| 2 (GND) | GND | Ground |
| 3 (SCK) | D13 | Serial Clock |
| 4 (MOSI/D0) | D11 | MOSI/D0 |
| 5 (MISO/D1) | D12 | MISO/D1 |
| 6 (GPIO0/D2) | DNC | GPIO0/D2 |
| 7 (GPIO1/D3) | DNC | GPIO1/D2 |
| 8 (GND) | GND or DNC | Ground |
| 9 (CS) | D9 | Chip Select |
| 10 (INT) | D7 | Interrupt |
| 11 (PD) | D8 | Chip Power Down |
| 12 (MODE/GPIO2) | DNC | MODE/GPIO2 |
| 13 (AUDIO) | DNC | Audio PWM |
| 14 (GND) | GND or DNC | Ground |
To Optional uSD Adapter Board
| microSD Pin | Seeeduino Pin | Connection Description |
|---|---|---|
| 1 (CS) | D10 | SD CS |
| 2 (DI) | D11 | SD MOSI |
| 3 (DO) | D12 | SD MISO |
| 4 (VDD) | 3v3 | +3.3V Power |
| 5 (SCLK) | D13 | SD SCLK |
| 6 (VSS) | GND | Ground |
Additional accessories for the products can be found at the bottom of each of the product pages. This will include 30 position FFC cables, wires, and any accessory boards that are available.
(2020-08-05 Brent A. Crosby / Crystalfontz America, Inc.)
This is a simplified / refactored version of the code in FTDI's AN_275 with support added for the BT817 series.
In the spirit of AN_275: An “abstraction layer” concept was explicitly avoided in this example. Rather, direct use of the Arduino libraries demonstrates the simplicity of sending and receiving data through the FT800 while producing a graphic output.
The main goal here is to be transparent about what is really happening from the high to lowest levels, without obfuscation, while still at least giving a nod to good programming practices. Plus, you probably don't have RAM and flash for all those fancy programming layers.
The FTDI write offset (FWo) into the BT817's circular write write buffer is passed into and back from functions (FWol = FWo local) rather than being a global. Keeping track of the write offset avoids having to read that information from the BT817 before every SPI transaction.
A nod to Rudolph R and company for deep insight and lots of help in increasing our understanding of the fiddly bits of the EVE hardware and software architecture (Link 1 Link 2).