commit | 1f3913f76d89ac0b18f63abd818e0c6e03173731 | [log] [tgz] |
---|---|---|
author | Simon Ser <[email protected]> | Thu Jan 12 13:05:46 2023 +0100 |
committer | Simon Ser <[email protected]> | Fri Jan 13 02:37:01 2023 +0100 |
tree | 42df23e0c7272853813409fab5dcc42d078176d2 | |
parent | b4399853248bea4d584750a466fef09524ef45ee [diff] |
di-edid-decode/cta: print detailed info for VICs Signed-off-by: Simon Ser <[email protected]>
EDID and DisplayID library.
Goals:
Documentation is available on the website.
The public API headers are categorised as either high-level or low-level API as per the comments in the header files. Users of libdisplay-info should prefer high-level API over low-level API when possible.
If high-level API lacks needed features, please propose additions to the high-level API upstream before using low-level API to get what you need. If the additions are rejected, you are welcome to use the low-level API.
This policy is aimed to propagate best practises when interpreting EDID and DisplayID information which can often be cryptic or even inconsistent.
Open issues and merge requests on the GitLab project.
In general, the Wayland contribution guidelines should be followed. In particular, each commit must carry a Signed-off-by tag to denote that the submitter adheres to the Developer Certificate of Origin 1.1. This project follows the freedesktop.org Contributor Covenant.
libdisplay-info has the following dependencies:
libdisplay-info is built using Meson:
meson setup build/ ninja -C build/
The low-level EDID library is tested against edid-decode. test/data/
contains a small collection of EDID blobs and diffs between upstream edid-decode
and our di-edid-decode
clone. Our CI ensures the diffs are up-to-date. A patch should never make the diffs grow larger. To re-generate the test data, run ninja -C build/ gen-test-data
.
To run the test suite locally, you need to use edid-decode of the git revision mentioned in .gitlab-ci.yml
. Otherwise you may experience false failures.
The latest code coverage report is available on GitLab CI.
To fuzz libdisplay-info with AFL, the library needs to be instrumented:
CC=afl-gcc meson build/ ninja -C build/ afl-fuzz -i test/data/ -o afl/ build/di-edid-decode