EveApps-BT82X

EveApps-BT82X is a collection of applications designed as reference resources for Bridgetek's 5th-generation graphics controller, the BT82X.

The collection is divided into two categories: Sample and Demo applications. Both are written in ANSI C, with complete source code provided.

• Sample applications focus on instructional use, demonstrating individual display lists or commands.
• Demo applications are more complex, closely resembling real-world projects. (To be updated)

All applications rely on shared resources located in the "common" folder.

Each application includes a "project" subfolder containing the necessary files for building the application using the MS Visual Studio 2019.

Users are expected to have familiarity with the BT82X programming guide and datasheet.

Folder introduction

📂 EveApps
    ├───common                  
    │   ├───application      | Application's common functions
    │   ├───eve_flash        | Blob binary for flash programming
    │   └───eve_hal          | Hardware abstraction layer to bridge different platforms
    │    
    ├───SampleApp
    │    ├───Animation       | Sample usage of animation 
    |    ├───Audio           | Sample usage of audio functionality    
    │    ├───Bitmap          | Sample usage of bitmap 
    │    ├───Flash           | Sample usage of flash 
    │    ├───Font            | Sample usage of font
    |    ├───Lvds            | Sample usage of LVDSRX
    │    ├───Primitives      | Sample usage of drawing primitives
    │    ├───Touch           | Sample usage of touch functionality
    │    ├───Utility         | Sample usage of helper utilities
    │    ├───Video           | Sample usage of video playback
    │    ├───Widget          | Sample for default widgets

Note:

• For Eve registers and commands/instructions definition, user can find it at the file common/eve_hal/EVE_GpuDef.h and common/eve_hal/Eve_CoCmd.h.
• For flash blob file used to access the eve connected flash chip, user can find it at common/eve_flash.

Hardware dependency

Unless specified otherwise, the default hardware platform is the VM820C. You may refer to the details at www.brtchip.com

Build instructions

FT4222 and MPSSE

Way 1: Open SampleApp_MSVC.sln

Go to property

Change settings (EVE_PLATFORM_FT4222 / EVE_PLATFORM_MPSSE)

press F5 to build and run

Way 2: Use Cmake: (Need Cmake 3.19 installed)

# Launch the appropriate Developer Command Prompt for VS
# For 64-bit build, open:
# x64 Native Tools Command Prompt for VS
call "[path to VS]\VC\Auxiliary\Build\vcvars64.bat"   # for 64-bit
# For 32-bit build, open:
# x86 Native Tools Command Prompt for VS
call "[path to VS]\VC\Auxiliary\Build\vcvars32.bat"   # for 32-bit

cd [path to EveApps]
mkdir build
cd build
cmake -G "NMake Makefiles" -DEVE_APPS_PLATFORM=EVE_PLATFORM_FT4222 -DEVE_APPS_GRAPHICS=[EVE graphics] -DEVE_APPS_DISPLAY=[EVE display] -DEVE_APPS_SPI=[EVE SPI] -DCMAKE_BUILD_TYPE=Debug ..
nmake SampleApp_[Project Name]

# EVE_APPS_PLATFORM can be one of : EVE_PLATFORM_FT4222 or EVE_PLATFORM_MPSSE
# [EVE graphics] must be : EVE_GRAPHICS_BT820
# [EVE display] can be one of:  EVE_DISPLAY_WUXGA (1920x1200 LCD), EVE_DISPLAY_FHD (1920x1080 LCD)
# [EVE SPI] can be one of : EVE_SPI_QUAD, EVE_SPI_DUAL, EVE_SPI_SINGLE  (FT4222 can support Quad/Dual/Single, MPSSE supports single only)
# [Project Name] is the folder name of a subfolder inside SampleApp , one example is SampleApp_Widget
# The output binary [Project Name].exe can be found in build\[Project Name]

One example is :
cmake -G "NMake Makefiles" -DEVE_APPS_PLATFORM=EVE_PLATFORM_FT4222 -DEVE_APPS_GRAPHICS=EVE_GRAPHICS_BT820 -DEVE_APPS_DISPLAY=EVE_DISPLAY_WUXGA -DCMAKE_BUILD_TYPE=Debug ..

example:

Raspberry Pi Pico

Requires the Pico toolchain https://github.com/ndabas/pico-setup-windows to be installed.

Pico-SDK version 1.3.0 is required

The following steps will build for Raspberry Pi Pico.

1. Install cmake 3.19.x, python, Visual Studio 2019 community (must select C++), GNU Arm Embedded Toolchain for window.
2. Launch the Developer Command Prompt for VS

set PICO_SDK_PATH=[path to pico-sdk]
set PICO_TOOLCHAIN_PATH=[path to GNU Arm Embedded Toolchain\\10 2020-q4-major\\bin]
cd EveApps
mkdir build
cd build
cmake -G "NMake Makefiles" -DEVE_APPS_PLATFORM=EVE_PLATFORM_RP2040 -DEVE_APPS_GRAPHICS=[EVE graphics] -DEVE_APPS_DISPLAY=[EVE display] -DEVE_APPS_SPI=[EVE SPI] -DCMAKE_BUILD_TYPE=Debug ..
nmake [Project name]

# [EVE graphics] must be : EVE_GRAPHICS_BT820
# [EVE display] can be one of:  EVE_DISPLAY_WUXGA (1920x1200 LCD), EVE_DISPLAY_FHD (1920x1080 LCD)
# [EVE SPI] must : EVE_SPI_SINGLE (PR2040 supports single only)
# [Project Name] is the folder name of a subfolder inside SampleApp , one example is SampleApp_Widget
# The output binary [Project Name].uf2 can be found in build\SampleApp\[Project]

Example:

$ cmake.exe -G "NMake Makefiles"  -DEVE_APPS_GRAPHICS=EVE_GRAPHICS_BT820 -DEVE_APPS_PLATFORM=MM2040EV -DEVE_APPS_DISPLAY=EVE_DISPLAY_WUXGA -DEVE_APPS_SPI=EVE_SPI_SINGLE -DCMAKE_BUILD_TYPE=Debug ..
$ nmake 

Connections

RP2040	EVE	UART	SD
GP0 (TX)		RX (debug)
GP1 (RX)		TX (optional)
GP2 (SPI0 SCK)	SCK
GP3 (SPI0 MOSI)	MOSI
GP4 (SPI0 MISO)	MISO
GP5 (GPIO)	CS
GP6 (GPIO)	INT
GP7 (GPIO)	PWD
5V	5V
GND	GND

Version

This version is v1.0.0_RC1

Release log

v1.0.0_RC1
    - Refactored and organized codebase for Doxygen integration
    - Added Doxygen documentation support for EveApps APIs
    - Enhanced the QSPI read/write process
    - Removed emulator support; emulation is no longer supported starting from BT820

v1.0.0_Beta
    - Introduced a new sample application demonstrating the use of LVDSRX
    - Added sample code to showcase new commands and options introduced in BT820
      Commands: CMD_SKIPCOND, CMD_WAITCOND
      Options: OPT_COMPLETEREG
    - Added interrupt driven rendering example
    - Code cleanup and synced register/command names with BRT_AN_086 BT82X Series Programming Guide v1.1

pre_release v0.1.0
    - Initial release
    - Added ten sample applications with FT4222 and MPSSE support for BT820