4.4. DSS

4.4.1. Introduction

The Display Subsystem (DSS) is a flexible, multi-pipeline subsystem that supports high-resolution display outputs. DSS includes input pipelines providing multi-layer blending with transparency to enable on-the-fly composition. Various pixel processing capabilities are supported, such as color space conversion and scaling, among others. DSS includes a DMA engine, which allows direct access to the frame buffer (device system memory). Display outputs can connect seamlessly to an Open LVDS Display Interface transmitter (OLDITX), or can directly drive device pads as a parallel video output interface. This document has detailed API description that user can use to make use of the DSS driver.

4.4.2. User Interface

For details about individual fields of this library structure, see the PDK doxygen documentation

4.4.2.1. APIs

The DSS driver API can be broadly divided into the following categories

  • DSS Display API - API for video display drivers
  • DSS Display Controller API - API for controlling and configuring Video Ports in the display subsystem

In addition to above drivers the DSS package also includes many sample examples which show how to use the drivers in different ways. Many of these sample examples use a common set of APIs which a user may find useful to refer to for use in their final application.

API reference for application:

#include <ti/drv/dss/dss.h>

4.4.3. Application

4.4.3.1. Examples

Name
Description
Expected Results
Display Dss application
Example demonstrating simple display bgra frames to the OLDI use case. Reference example for developers
Application shows two different buffer on OLDI panel and success messages on CCS console.
Display Dss application (Bare metal)
Example demonstrating simple display bgra frames to the OLDI use case. Reference example for developers
Application shows two different buffer on OLDI panel and success messages on CCS console.
Display Dss Colorbar application
Example demonstrating internal colorbar to the OLDI panel. Reference example for developers.
Application shows internal colorbar on OLDI panel and success messages on CCS console.

4.4.3.2. DSS examples

Description

DSS examples exploits the DISPC (Display Controller) and OLDI output available in the SoC. The example works on outputing pre-loaded video frames of BGRA8888 formats to OLDI interface. The example also demonstrates displaying videos combined from VID1 and VIDL1 pipelines to OLDI panel. The example is also enhanced to show the display controller scaling features.

Running the Display examples

Configuring Display:

  • Make sure the OLDI panel is connected to the base EVM before running the example binary.

CCS connection:

  • Load the System firmware as specified in SCICLIENT documentation
  • Load the generated executable file in CCS
  • Run the application.
  • Content will be displayed on the OLDI panel connected to EVM