{"id":38498512,"url":"https://github.com/rdkcentral/rdk-halif-test-device_settings","last_synced_at":"2026-01-17T05:57:16.958Z","repository":{"id":212042835,"uuid":"706782581","full_name":"rdkcentral/rdk-halif-test-device_settings","owner":"rdkcentral","description":"RDK Device Settings Hardware Abstraction Layer test suite","archived":false,"fork":false,"pushed_at":"2026-01-07T11:43:34.000Z","size":4412,"stargazers_count":2,"open_issues_count":43,"forks_count":7,"subscribers_count":12,"default_branch":"main","last_synced_at":"2026-01-08T22:58:15.166Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rdkcentral.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-10-18T15:52:40.000Z","updated_at":"2026-01-06T16:45:23.000Z","dependencies_parsed_at":"2025-11-29T16:00:27.684Z","dependency_job_id":null,"html_url":"https://github.com/rdkcentral/rdk-halif-test-device_settings","commit_stats":null,"previous_names":["rdkcentral/rdk-halif-test-device_settings"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/rdkcentral/rdk-halif-test-device_settings","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdkcentral%2Frdk-halif-test-device_settings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdkcentral%2Frdk-halif-test-device_settings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdkcentral%2Frdk-halif-test-device_settings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdkcentral%2Frdk-halif-test-device_settings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rdkcentral","download_url":"https://codeload.github.com/rdkcentral/rdk-halif-test-device_settings/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rdkcentral%2Frdk-halif-test-device_settings/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28501351,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T04:31:57.058Z","status":"ssl_error","status_checked_at":"2026-01-17T04:31:45.816Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-17T05:57:16.867Z","updated_at":"2026-01-17T05:57:16.931Z","avatar_url":"https://github.com/rdkcentral.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Unit Testing Suite For Device Settings HAL\n\n## Table of Contents\n\n- [Acronyms, Terms and Abbreviations](#acronyms-terms-and-abbreviations)\n- [Description](#description)\n- [Reference Documents](#reference-documents)\n- [How to build the test suite](#how-to-build-the-test-suite)\n- [Notes](#notes)\n- [Manual way of running the L1 and L2 test cases](#manual-way-of-running-the-l1-and-l2-test-cases)\n- [Setting Python environment for running the L1 L2 and L3 automation test cases](#setting-python-environment-for-running-the-l1-l2-and-l3-automation-test-cases)\n\n## Acronyms, Terms and Abbreviations\n\n- `L1`  - Functional Tests\n- `L2`  - Module functional Testing\n- `L3`  - Module testing with External Stimulus is required to validate and control device\n- `HAL` - Hardware Abstraction Layer\n- `API` - Application Programming Interface\n- `DS`  - Device Settings\n- `FPD` - Front Panel Display\n- `HDMIIn` - HDMI Input\n- `CompositeIn` - Composite Input\n- `High-Level Test Specification` : These specification will provide a broad overview of the system's functionality from the callers' perspective. It focuses on major use cases, system behavior, and overall caller experience.\n- `Low-Level Test Specification` : These specification will deeper into the technical details. They will define specific test cases with inputs, expected outputs, and pass/fail criteria for individual functionalities, modules, or APIs.\n- `NA` - Not Applicable\n\n## Description\n\nThis repository contains the Unit Test Suites (`L1` , `L2` and `L3`) for the following submodules of Device Settings  `HAL` :\n\n- `DS` Audio `HAL`\n- `DS` Video Device `HAL`\n- `DS` Video Port `HAL`\n- `DS` Display `HAL`\n- `DS` Front Panel Display `HAL`\n- `DS` Host `HAL`\n- `DS` HDMI Input `HAL`\n- `DS` Composite Input `HAL`\n\n## Reference Documents\n\n|SNo|Document Name|Document Description|Document Link|\n|---|-------------|--------------------|-------------|\n|1|Device Settings `HAL`|This document provides specific information on each `DS` sub-module's `APIs` for which tests are written in this module|[`DS` `HAL` Guide](https://github.com/rdkcentral/rdk-halif-device_settings/blob/main/docs/pages/README.md)|\n|2|`DS` Audio Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` Audio module.|Refer [dsAudio](#l1-l2-l3-testprocedure-documents)|\n|3|`DS` Video Device Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` Video Device module.|Refer [dsVideoDevice](#l1-l2-l3-testprocedure-documents)|\n|4|`DS` Video Port  Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` Video Port  module.|Refer [dsVideoPort](#l1-l2-l3-testprocedure-documents)|\n|5|`DS` Display Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` Display module.|Refer [dsDisplay](#l1-l2-l3-testprocedure-documents)|\n|6|`DS` Front Panel Display Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` Front Panel Display module.|Refer [dsFPD](#l1-l2-l3-testprocedure-documents)|\n|7|`DS` Host Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` Host module.|Refer [dsHost](#l1-l2-l3-testprocedure-documents)|\n|8|`DS` HDMI Input Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` HDMI Input module.|Refer [dsHdmiIn](#l1-l2-l3-testprocedure-documents)|\n|9|`DS` Composite Input Test Suits Specifications |`L1`,`L2`,`L3` Test Specification Documentation for `DS` Composite Input module.|Refer [dsCompositeIn](#l1-l2-l3-testprocedure-documents)|\n\n## Notes\n\n- All APIs in each individual sub-module need to be implemented in this current version. If any API is not supported, please add stub implementation with return type dsERR_OPERATION_NOT_SUPPORTED for the same.\n- Building against the actual library may introduce SOC dependencies. Hence, a template SKELETON library is created without SOC dependencies. On the real platform (target), it can be mounted, copied and bound with the actual library.\n- When executing the binary, ensure to include a platform-specific profile file as an argument for the designated test cases. The following example illustrates this:\n\n## How to build the test suite\n\nIn order to build the test suits, there is a requirement to supply the toolchain, either as a vendor independent toolchain, an SDK, or an RDK Docker Toolchain .\n\nFor more information about RDK Docker Toolchain, please check [RDK Docker Toolchain](https://github.com/rdkcentral/ut-core/wiki/FAQ:-RDK-Docker-Toolchain)\n\n- Export the Toolchain Path:\n\n```bash\nexport TOOLCHAIN_PATH=/opt/toolchains/rdk-glibc-x86_64/sysroots/armv7at2hf-neon-rdk-linux-gnueabi\nexport CC=\"arm-rdk-linux-gnueabi-gcc  -march=armv7-a -mthumb -mfpu=neon -mfloat-abi=hard --sysroot=$TOOLCHAIN_PATH\"\n```\n\n- Clone the `HAL` Repository:\n\n```bash\ngit clone git@github.com:rdkcentral/rdk-halif-device_settings.git\n```\n\n- Set Project Version:\n\nIf you want to build the test repository with a specific tag or branch, set the UT_PROJECT_VERSION variable accordingly. If not set, the default main branch will be used.\n\n```bash\nexport UT_PROJECT_VERSION=1.0.1  # Build using a specific tag\n```\n\nor\n\n```bash\nexport UT_PROJECT_VERSION=develop  # Build using a specific branch\n```\n\n- Build Targets:\n\n There are two targets for the platform\n\n  1. linux - (default)\n  2. arm - TARGET=arm\n\n```bash\nbuild_ut.sh TARGET=arm\n```\n\n- `build_ut.sh` script will clone the hal-test repo, ut-core and generate a `hal_test_dshal` binary in `ut/bin/` upon successful completion.\n\n### Manual way of running the `L1` and `L2` test cases\n\n```bash\n ./hal_test_dshal -p Sink_AudioSettings.yaml\n ```\n\nAlternatively, use the run.sh script with the profile file:\n\n```bash\n./run.sh -p /absolute/path/to/profile/file\n ```\n\n- Profiles files defines the configuration for the platform available for sink and source\n\n|`DS` Module|Sink Profile yaml|Source Profile yaml|\n|-----------|-----------------|-------------------|\n|dsAudio|[Sink_AudioSettings.yaml](./profiles/sink/Sink_AudioSettings.yaml)|[Source_AudioSettings.yaml](./profiles/source/Source_AudioSettings.yaml)|\n|dsDisplay|[Sink_4K_Display.yaml](./profiles/sink/Sink_4K_Display.yaml)|[Source_4K_Display.yaml](./profiles/source/Source_4K_Display.yaml)|\n|dsFPD|[Sink_FPD.yaml](./profiles/sink/Sink_FPD.yaml)|[Source_FPD.yaml](./profiles/source/Source_FPD.yaml)|\n|dsHost|[Sink_HostSettings.yaml](./profiles/sink/Sink_HostSettings.yaml)|[Source_HostSettings.yaml](./profiles/source/Source_HostSettings.yaml)|\n|dsCompositeIn|[Sink_CompositeInput.yaml](./profiles/sink/Sink_CompositeInput.yaml)|`NA`|\n|dsHdmiIn|[Sink_HDMIIN.yaml](./profiles/sink/Sink_HDMIIN.yaml)|[Source_HDMIIN.yaml](./profiles/source/Source_HDMIIN.yaml)|\n|dsVideoDevice|[Sink_2K_VideoDevice.yaml](./profiles/sink/Sink_2K_VideoDevice.yaml) [Sink_4K_VideoDevice.yaml](./profiles/sink/Sink_4K_VideoDevice.yaml)|[Source_VideoDevice.yaml](./profiles/source/Source_VideoDevice.yaml)|\n|dsVideoPort|[Sink_4K_VideoPort.yaml](./profiles/sink/Sink_4K_VideoPort.yaml)|[Source_4K_VideoPort.yaml](./profiles/source/Source_4K_VideoPort.yaml)|\n\n### Setting Python environment for running the `L1` `L2` and `L3` automation test cases\n\n- For running the `L1` `L2` and `L3` test suite, a host PC or server with a Python environment is required.\n- Install Python Environment and Activation Scripts as detailed in the [HPK Documentation](https://github.com/rdkcentral/rdk-hpk-documentation/tree/main?tab=readme-ov-file#installing-the-python-environment-for-l3-testing-suite)\n- To run the `L1` and `L2` test cases of `DS` sub-modules follow the \"`L1` `L2` TestProcedure docs\". And, to run the `L3` test cases of `DS` sub-modules follow the \"`L3` TestProcedure docs\" mentioned in below table.\n\n## `L1` `L2` `L3` TestProcedure Documents\n\n|`DS` Module|L1 L2 TestProcedure docs|L3 TestProcedure docs|\n|-----------|------------------------|---------------------|\n|dsAudio|[ds-audio_High-Level_TestSpecification.md](./docs/pages/dsAudio/ds-audio_High-Level_TestSpecification.md), [ds-audio_L1_L2_TestProcedure.md](./docs/pages/dsAudio/ds-audio_L1_L2_TestProcedure.md), [ds-audio_L2_Low-Level_TestSpecification.md](./docs/pages/dsAudio/ds-audio_L2_Low-Level_TestSpecification.md)|[ds-audio_High-Level_TestSpecification.md](./docs/pages/dsAudio/ds-audio_High-Level_TestSpecification.md), [ds-audio_L3_TestProcedure.md](./docs/pages/dsAudio/ds-audio_L3_TestProcedure.md)|\n|dsDisplay|[ds-display-high-Level_TestSpec.md](./docs/pages/dsDisplay/ds-display-high-Level_TestSpec.md), [ds-display_L1_L2_TestProcedure.md](./docs/pages/dsDisplay/ds-display_L1_L2_TestProcedure.md), [ds-display-L2-Low-Level_TestSpec.md](./docs/pages/dsDisplay/ds-display-L2-Low-Level_TestSpec.md)|[ds-display-high-Level_TestSpec.md](./docs/pages/dsDisplay/ds-display-high-Level_TestSpec.md), [ds-display_L3_TestProcedure.md](./docs/pages/dsDisplay/ds-display_L3_TestProcedure.md)|\n|dsFPD|[ds-front-panel-display_High-Level_TestSpec.md](./docs/pages/dsFPD/ds-front-panel-display_High-Level_TestSpec.md), [ds-front-panel-display_L1_L2_TestProcedure.md](./docs/pages/dsFPD/ds-front-panel-display_L1_L2_TestProcedure.md), [ds-front-panel-display_L2_Low-Level_TestSpecification.md](./docs/pages/dsFPD/ds-front-panel-display_L2_Low-Level_TestSpecification.md)|[ds-front-panel-display_High-Level_TestSpec.md](./docs/pages/dsFPD/ds-front-panel-display_High-Level_TestSpec.md), [ds-front-panel-display_L3_TestProcedure.md](./docs/pages/dsFPD/ds-front-panel-display_L3_TestProcedure.md)|\n|dsHost|[ds-host_High-Level_TestSpecification.md](./docs/pages/dsHost/ds-host_High-Level_TestSpecification.md), [ds-host_L1_L2_TestProcedure.md](./docs/pages/dsHost/ds-host_L1_L2_TestProcedure.md), [ds-host_L2_Low-Level_TestSpecification.md](./docs/pages/dsHost/ds-host_L2_Low-Level_TestSpecification.md)|[ds-host_High-Level_TestSpecification.md](./docs/pages/dsHost/ds-host_High-Level_TestSpecification.md),[ds-host_L3_TestProcedure.md](./docs/pages/dsHost/ds-host_L3_TestProcedure.md)|\n|dsCompositeIn|[ds-compositeIn-High-Level_TestSpec.md](./docs/pages/dsCompositeIn/ds-compositeIn-High-Level_TestSpec.md), [ds-compositeIn_L1_L2_TestProcedure.md](./docs/pages/dsCompositeIn/ds-compositeIn_L1_L2_TestProcedure.md), [ds-compositeIn-L2-Low-Level_TestSpec.md](./docs/pages/dsCompositeIn/ds-compositeIn-L2-Low-Level_TestSpec.md)|[ds-compositeIn-High-Level_TestSpec.md](./docs/pages/dsCompositeIn/ds-compositeIn-High-Level_TestSpec.md), [ds-compositeIn-L3-TestProcedure.md](./docs/pages/dsCompositeIn/ds-compositeIn-L3-TestProcedure.md)|\n|dsHdmiIn|[ds-hdmi-in-High-Level_TestSpec.md](./docs/pages/dsHDMIIn/ds-hdmi-in-High-Level_TestSpec.md),[ds-hdmi-in_L1_L2_TestProcedure.md](./docs/pages/dsHDMIIn/ds-hdmi-in_L1_L2_TestProcedure.md), [ds-hdmi-in-L2-Low-Level_TestSpec.md](./docs/pages/dsHDMIIn/ds-hdmi-in-L2-Low-Level_TestSpec.md)|[ds-hdmi-in-High-Level_TestSpec.md](./docs/pages/dsHDMIIn/ds-hdmi-in-High-Level_TestSpec.md), [ds-hdmi-in_L3_Test-Procedure.md](./docs/pages/dsHDMIIn/ds-hdmi-in_L3_Test-Procedure.md)|\n|dsVideoDevice|[ds-video-device_High-Level_TestSpec.md](./docs/pages/dsVideoDevice/ds-video-device_High-Level_TestSpec.md), [ds-video-device_L1_L2_TestProcedure.md](./docs/pages/dsVideoDevice/ds-video-device_L1_L2_TestProcedure.md), [ds-video-device_L2-Low-Level_TestSpec.md](./docs/pages/dsVideoDevice/ds-video-device_L2-Low-Level_TestSpec.md)|[ds-video-device_High-Level_TestSpec.md](./docs/pages/dsVideoDevice/ds-video-device_High-Level_TestSpec.md), [ds-video-device_L3_TestProcedure.md](./docs/pages/dsVideoDevice/ds-video-device_L3_TestProcedure.md)|\n|dsVideoPort|[ds-video-port_High-Level_TestSpec.md](./docs/pages/dsVideoPort/ds-video-port_High-Level_TestSpec.md), [ds-video-port_L1_L2_TestProcedure.md](./docs/pages/dsVideoPort/ds-video-port_L1_L2_TestProcedure.md), [ds-video-port_L2_Low-Level_TestSpecification.md](./docs/pages/dsVideoPort/ds-video-port_L2_Low-Level_TestSpecification.md)|[ds-video-port_High-Level_TestSpec.md](./docs/pages/dsVideoPort/ds-video-port_High-Level_TestSpec.md), [ds-video-port_L3_Test-Procedure.md](./docs/pages/dsVideoPort/ds-video-port_L3_Test-Procedure.md)|\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frdkcentral%2Frdk-halif-test-device_settings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frdkcentral%2Frdk-halif-test-device_settings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frdkcentral%2Frdk-halif-test-device_settings/lists"}