Skip to content

Device Settings Display L2 Low Level Test Specification and Procedure Documentation

Overview

This document describes the Low Level L2 test Specification and Procedure for the Device settings Display module.

Acronyms, Terms and Abbreviations

  • HAL - Hardware Abstraction layer
  • EDID - Extended Display Identification
  • HDMI - High-Definition Multimedia Interface
  • API - Application programming interface
  • HAL - Hardware Abstraction Layer, may include some common components
  • UT - Unit Test(s)
  • OEM - Original Equipment Manufacture
  • SoC - System on a Chip
  • DS - Device Settings

Definitions

References

Level 2 Test Procedure

The following functions are expecting to test the module operates correctly.

Test 1

Title Details
Function Name test_l2_dsDisplay_RetrieveAndValidateEDID_sink
Description For the sink device, retrieve EDID information for the display type 'dsVIDEOPORT_TYPE_INTERNAL' using GetEDID and GetEDIDBytes, then validate the values against the data available in the "Panel_4K_Display.yaml" profile file. The values to be validated are the 'EDID_Data/productCode' for GetEDID and the 'EDID_Data/edidBytes'(which stands for Manufacturer ID) at bytes 8 and 9 against the values available in the profile file for GetEDIDBytes.
Test Group 02
Test Case ID 001
Priority High

Pre-Conditions None

Dependencies None

User Interaction If user chose to run the test in interactive mode, then the test case has to be selected via console.

Test Procedure - Test 1

Variation / Steps Description Test Data Expected Result Notes
01 Initialize the display using dsDisplayInit None dsERR_NONE Should be successful
02 Get the display handle using dsGetDisplay for the dsVIDEOPORT_TYPE_INTERNAL type type = dsVIDEOPORT_TYPE_INTERNAL, index = 0 dsERR_NONE Should be successful
03 Retrieve EDID information using dsGetEDID handle = obtained from step 02 dsERR_NONE Should be successful
04 Validate with the product code data available in the profile file product code, dsDisplay/EDID_Data/productCode Value matches Should be successful
05 Retrieve EDID bytes using dsGetEDIDBytes handle = obtained from step 02, edidBytes = valid buffer, length = valid buffer dsERR_NONE Should be successful
06 Validate with the Manufacturer ID at bytes 8 and 9 against the values available in the profile file Manufacturer ID , dsDisplay/EDID_Data/edidBytes Value matches Should be successful
07 Terminate the display using dsDisplayTerm None dsERR_NONE Should be successful 
graph TB
    A[Call dsDisplayInit] -->|dsERR_NONE| B[Call dsGetDisplay]
    A -->|!= dsERR_NONE| A1[Test case fail]
    B -->|dsERR_NONE and valid handle| C[Parse 'Panel_CompositeInput.yaml']
    C--> D[Call dsGetEDID]
    B -->|!= dsERR_NONE or invalid handle| B1[Test case fail]
    D -->|dsERR_NONE and valid dsDisplayEDID_t| E[Compare productcode values]
    D -->|!= dsERR_NONE or invalid dsDisplayEDID_t| D1[Test case fail]
    E --> F[Call dsGetEDIDBytes]
    F -->|dsERR_NONE and valid buffer and length >= 0| G[Compare Manufacturer ID values]
    F -->|!= dsERR_NONE or invalid buffer or length < 0| F1[Test case fail]
    G --> H[Call dsDisplayTerm]
    H -->|dsERR_NONE| I[Test case success]
    H -->|!= dsERR_NONE| H1[Test case fail]

Test 2

Title Details
Function Name test_l2_dsDisplay_TestDefaultAspectRatio_source
Description Test the default aspect ratio (16:9) without any TV connected on source devices.
Test Group 02
Test Case ID 002
Priority High

Pre-Conditions None

Dependencies None

User Interaction If user chose to run the test in interactive mode, then the test case has to be selected via console.

Test Procedure - Test 2

Variation / Steps Description Test Data Expected Result Notes
01 Initialize the display using dsDisplayInit None dsERR_NONE Should be successful
02 Get the display handle using dsGetDisplay with dsVIDEOPORT_TYPE_HDMI and index 0 dsVIDEOPORT_TYPE_HDMI, 0 dsERR_NONE Should be successful
03 Get the display aspect ratio using dsGetDisplayAspectRatio with the handle obtained from dsGetDisplay handle obtained from dsGetDisplay and aspectRatio = valid buffer dsERR_NONE, dsVIDEO_ASPECT_RATIO_16x9 Should be successful
04 Verify that the aspect ratio is dsVIDEO_ASPECT_RATIO_16x9 None dsVIDEO_ASPECT_RATIO_16x9, dsDisplay/AspectRatio Should be successful
05 Terminate the display using dsDisplayTerm None dsERR_NONE Should be successful 
graph TB
A[Call dsDisplayInit] -->|dsERR_NONE| B[Call dsGetDisplay]
B -->|dsERR_NONE| C[Call dsGetDisplayAspectRatio]
C -->|dsERR_NONE| D[Verify aspect ratio is dsVIDEO_ASPECT_RATIO_16x9]
D -->|Verified| E[Call dsDisplayTerm]
E -->|dsERR_NONE| F[Test case success]
A -->|!=dsERR_NONE| G[Test case fail]
B -->|!=dsERR_NONE| H[Test case fail]
C -->|!=dsERR_NONE| I[Test case fail]
D -->|Not Verified| J[Test case fail]
E -->|!=dsERR_NONE| K[Test case fail]