Miroirs/libdisplay-info
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/emersion/libdisplay-info.git synced 2024-12-25 21:59:08 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
Mirror of https://gitlab.freedesktop.org/emersion/libdisplay-info.git
282 commits 15 branches 3 tags 909 KiB
C 95.7%
Python 2.5%
Shell 0.9%
Meson 0.9%
Find a file
Simon Ser 6879d24379 build: update edid-decode to new repository 
Signed-off-by: Simon Ser <contact@emersion.fr>
2024-12-20 20:12:46 +01:00
di-edid-decode cta: Return a block struct for type vii timings 2024-08-06 12:41:17 +00:00
include cta: Return a block struct for type vii timings 2024-08-06 12:41:17 +00:00
subprojects build: update edid-decode to new repository 2024-12-20 20:12:46 +01:00
test build: update edid-decode to new repository 2024-12-20 20:12:46 +01:00
tool tool: fix redirect bashism in dump-i2c.sh 2023-06-28 12:12:04 +03:00
.editorconfig editorconfig: bump max line length to 100 chars 2023-05-11 08:58:10 +00:00
.gitlab-ci.yml build: update edid-decode to new repository 2024-12-20 20:12:46 +01:00
cta-vic-table.c cta: add VIC table 2023-01-13 02:37:01 +01:00
cta.c cta: Return a block struct for type vii timings 2024-08-06 12:41:17 +00:00
cvt.c Introduce di_cvt_compute() 2022-12-16 15:37:38 +01:00
displayid.c displayid: add support for type III timings 2024-03-21 17:15:27 +01:00
dmt-table.c dmt: add reduced_blanking field 2022-11-23 15:30:33 +01:00
edid.c edid: Record failures instead of aborting parsing 2024-05-08 12:43:20 +02:00
gcovr.cfg Add code coverage configuration file 2023-01-07 13:47:28 +01:00
gtf.c gtf: Initialize variables which might not get initialized 2024-07-29 14:37:23 +02:00
info.c info: add di_info_get_default_gamma() 2024-06-12 16:26:33 +03:00
libdisplay-info.map build: set symbol visibility 2022-06-14 11:40:07 +00:00
LICENSE Initial commit 2022-03-24 01:49:00 +01:00
log.c info: introduce di_logger 2022-08-04 08:40:36 +02:00
memory-stream.c memory-stream: Add memory_stream_cleanup helper 2022-11-25 12:15:14 +00:00
meson.build build: bump version to 0.3.0-dev 2024-06-20 18:40:01 +02:00
README.md readme: List the relevant specifications and where to get them 2024-07-02 18:11:55 +02:00
release.sh release: Add release instructions and script 2023-02-10 17:06:13 +01:00
releasing.md release: Add release instructions and script 2023-02-10 17:06:13 +01:00

README.md

libdisplay-info

EDID and DisplayID library.

Goals:

  • Provide a set of high-level, easy-to-use, opinionated functions as well as low-level functions to access detailed information.
  • Simplicity and correctness over performance and resource usage.
  • Well-tested and fuzzed.

Documentation is available on the website.

Using

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.

libdisplay-info uses semantic versioning. The public API is not yet stable.

Contributing

Open issues and merge requests on the GitLab project. Discuss and ask questions in the #wayland IRC channel on OFTC.

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.

Specifications

Both EDID and DisplayID are defined by VESA and the specifications are publicly available. There are multiple versions defined and they have multiple mechanisms for extending the base specification. Some of the extensions also have mechanisms for additional extensions. This sometimes makes it hard to find where a particular data structure is defined.

The raw data is usually read from the Display Data Channel (DDC) but other methods of delivery exist.

Available freely from VESA directly are the base EDID specifications, VESA specified EDID extensions, as well as the base DisplayID specifications. EDID also specifies how DisplayID can be embedded in EDID.

  • VESA Enhanced Extended Display Identification Data (E-EDID) Standard; Release A, Revision 1; February 9, 2000; Defines EDID Structure Version 1, Revision 3
  • VESA Enhanced Extended Display Identification Data (E-EDID) Standard; Release A, Revision 2; September 25, 2006; Defines EDID Structure Version 1, Revision 4
  • VESA Video Timing Block Extension Data (VTB-EXT) Standard; Release A; November 24, 2003
  • VESA Enhanced EDID Localized String Extension Standard; Release A; July 10, 2003
  • VESA Display Transfer Characteristics Data Block (DTCDB) Standard; Version 1.0; August 31, 2006
  • VESA Display Information Extension Block (DI-EXT) Standard; Release A; August 21, 2001
  • VESA Display Device Data Block (DDDB) Standard; Version 1; September 25, 2006
  • VESA Display Identification Data (DisplayID) Standard; Version 1.3; July 5, 2013
  • VESA Display Identification Data (DisplayID) Standard; Version 2.0; 11 September, 2017
  • VESA Display Identification Data (DisplayID) Standard; Version 2.1; 18 November, 2021
  • VESA Display Identification Data (DisplayID) Standard; Version 2.1a; 18 March, 2024

The most common extension to both EDID and DisplayID is CTA-861 which can be downloaded for free from CTA.

  • A DTV Profile for Uncompressed High Speed Digital Interfaces (CTA-861-E, CTA-861-F, CTA-861-G, CTA-861-H, CTA-861-I)
  • HDR Static Metadata Extensions (CTA-861.3-A)

The CTA-861 specification allows for Vendor Specific Data Blocks (VSDB). Their specifications are often proprietary and have to be reverse engineered. Some specifications are available publicly.

The libdisplay-info structures of the low-level API always point to the relevant specification and section therein.

Building

libdisplay-info has the following dependencies:

  • hwdata for the PNP ID database used at build-time only.

libdisplay-info is built using Meson:

meson setup build/
ninja -C build/

Testing

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, build edid-decode at the Git revision mentioned in .gitlab-ci.yml, put the executable in PATH, and run ninja -C build/ gen-test-data.

The latest code coverage report is available on GitLab CI.

Fuzzing

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/di-edid-decode