riverdi-eve

KO | EN

gitlite — search

#javascript #react #golang #android #machine-learning #docker #windows #awesome #awesome-list #security #pytorch #ios #openai #open-source

(★ 22)

Example app for the Riverdi Intelligent Display driven by Bridgetek EVE graphics controllers (FT8XX/BT81X)

riverdi-eve Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

OVERVIEW
--------
![alt text](http://circuitcellar.com/wp-content/uploads/2016/10/FTDI-Img.png "riverdi-logo")

*riverdi-eve* is an easy-to-use library and example app (good starting poiny for you own projects) for [*Riverdi Intelligent Display*](https://riverdi.com/product-category/intelligent-displays/bt817q/) driven by [*Bridgetek EVE graphics controllers*](http://brtchip.com/eve/):

- __EVE 1__ series: FT800 and FT801,
- __EVE 2__ series: FT810, FT811, FT812 and FT813,
- __EVE 3__ series: BT815 and BT816,
- __EVE 4__ series: BT817 and BT818

The library contains support for the most popular hardware/software platforms like:

* __Raspberry Pi__ (and other linux-based Single Board Computers),
* __STM32__ (with full support for [*Riverdi STM32 Evaluation Board*](https://riverdi.com/product/stm32-evaluation-board/) ('stm32f4') and *Riverdi Revelation Board*) ('stm32f0'),
* __Windows__ (with FT232H USB-SPI converters - FT232H USB-SPI converter is a part of [*Riverdi STM32 Evaluation Board*](https://riverdi.com/product/stm32-evaluation-board/)),
* __Arduino__ (source code available as a separate GitHub repository - [*riverdi-eve-arduino*](https://github.com/riverdi/riverdi-eve-arduino)).

Library supports instructions in a similar format to the [*FT80x and FT81x Series Programmers Guides*](https://brtchip.com/wp-content/uploads/Support/Documentation/Programming_Guides/ICs/EVE/FT81X_Series_Programmer_Guide.pdf), [*BT81X Series Programming Guide*](https://brtchip.com/wp-content/uploads/2022/12/BRT_AN_033_BT81X-Series-Programming-Guide.pdf) and the [*EVE Screen Editor*](https://brtchip.com/ese-2/).

__Note:__ *this repository contains library code fully integrated with example app (and Makefile files for various platform) - if you need only library, please check [*riverdi-eve-lib*](https://github.com/riverdi/riverdi-eve-lib) repository and examples of library integration for such platforms like: [*RP2040*](https://github.com/riverdi/riverdi-eve-demo-rp2040), [*ESP32*](https://github.com/riverdi/riverdi-eve-demo-esp32) or [*Raspberry Pi*](https://github.com/riverdi/riverdi-eve-demo-rpi)*

LIBRARY ARCHITECTURE
--------------------

#### Example App

The *riverdi-demo.c* file can be edited to produce the final application, calling the functions from the underlying layers.

#### API Layer

This layer is designed to allow the main application to use syntax close to that of the *FT80X/FT81X Programmers Guide* and make it more user friendly. The functions provided in this layer handle co-processor operation and assist with creating and executing co-processor lists as well as keeping track of the offset within the FIFO for each command and sending parameters of commands such as text strings.

#### EVE Layer

This layer translates the calls from the API layer above into a series of SPI byte transfers formatted for the protocol used by the FT8XX. It includes a series of functions which send the register address as well as for reading and writing 8/16/32-bit values. It also has functions for checking the read and write pointers of the RAM_CMD FIFO and for checking the free space available, which are used by the layers above.

#### Host Layer

This layer provides an interface to the hardware. It takes the SPI transfers from the EVE layer and translates them into the low-level operations (SPI and GPIO operations for chip select and power down).

If porting the provided code to another type of hardware/software platform, the code in *host_layer* directory should be customized to match the peripheral API of the chosen platform whilst keeping the same syntax for calls to this layer from the EVE layer above.

COMPILING LIBRARY
-----------------

The *riverdi-eve* project uses a standard Makefile and GNU make to build and customize the source files for all supported platforms.

__Note:__ *before compilation edit Makefile.linux file to choose Embedded Video Engine series (-DEVE_1, -DEVE_2 or -DEVE_3 flags), choose type and size of connected TFT module (choose predefined macros for Riverdi EVE modules or edit timings manually in modules.h file for custom displays) or to adjust compilation settings.*

#### Raspberry Pi / Linux SBCs

1. Clone the repository (if you haven't done so already):
```
git clone https://github.com/riverdi/riverdi-eve.git
```
2. Change directory to the repository folder:
```
cd riverdi-eve
```
3. Build *riverdi-eve* project:
```
make -f Makefile.linux
```

#### Windows

For Windows OS, *riverdi-eve* project can be easily compiled under *MinGW* (minimalist development environment for native Microsoft Windows applications). Please visit official [*MinGW project website*](http://www.mingw.org/) for detailed tutorials:
```
make -f Makefile.win32
```

#### STM32 (cross-compilation under GNU/Linux OS)

1. Before building, please install the GNU compiler toolchain on your Linux platform. You can easily use toolchain shipped with recent Debian and Ubuntu versions:
```
sudo apt-get install gcc-arm-none-eabi binutils-arm-none-eabi
```
2. You also might want to install some other debuggers or dedicated software for your programmer (for example *stlink*):
```
sudo apt-get install openocd gdb-arm-none-eabi
```
3. Clone the repository:
```
git clone https://github.com/riverdi/riverdi-eve.git
```
4. Change directory to the repository folder:
```
cd riverdi-eve
```
5. Build *riverdi-eve* project:
```
make -f Makefile.stm32f4
```
6. Flash your device:
```
make -f Makefile.stm32f4 flash
```

#### STM32 (cross-compilation under Windows and SW4STM32 IDE)

1. Clone the repository:
```
git clone https://github.com/riverdi/riverdi-eve.git
```
2. Start *SW4STM32 IDE* and import *riverdi-eve* project by choosing:
```
File -> New -> Other -> C/C++ -> Makefile Project with Existing Code
```
3. Rename *Makefile.stm32f4* file to *Makefile* (alternatively, replace defult build command *make* with *make -f Makefile.stm32f4* in *Project Properties*)

4. Now you can build project by choosing:
```
Project -> Build All [Ctrl+B]
```

GETTING HELP
------------

Please contact Riverdi support - [*<contact@riverdi.com>*](contact@riverdi.com)

LICENSE
-------

See *LICENSE.txt* file for details.

riverdi-eve

riverdi-eve Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

riverdi-eve

riverdi-eve Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README