hdmi-hal-i2c-dev 0.2.0

Linux userspace hdmi-hal backend via /dev/i2c-N (i2c-dev)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use std::fs;
use std::os::unix::fs::symlink;

use tempfile::TempDir;

use super::*;

/// Build a minimal synthetic sysfs tree under `tmp`:
///
/// ```text
/// <tmp>/
///   <connector>/
///     ddc -> <symlink_target>   (only created when `target` is Some)
/// ```
fn make_sysfs(connector: &str, target: Option<&str>) -> TempDir {
    let tmp = tempfile::tempdir().unwrap();
    let connector_dir = tmp.path().join(connector);
    fs::create_dir_all(&connector_dir).unwrap();
    if let Some(t) = target {
        symlink(t, connector_dir.join("ddc")).unwrap();
    }
    tmp
}

#[test]
fn resolves_valid_connector() {
    let tmp = make_sysfs("card0-HDMI-A-1", Some("../../devices/pci0000:00/i2c-6"));
    let path = connector_ddc_adapter_in(tmp.path(), "card0-HDMI-A-1").unwrap();
    assert_eq!(path, PathBuf::from("/dev/i2c-6"));
}

#[test]
fn connector_not_found() {
    let tmp = make_sysfs("card0-HDMI-A-1", None);
    let err = connector_ddc_adapter_in(tmp.path(), "card0-HDMI-A-2").unwrap_err();
    assert!(
        matches!(err, I2cDevError::ConnectorNotFound { connector } if connector == "card0-HDMI-A-2")
    );
}

#[test]
fn connector_has_no_ddc_adapter() {
    // Connector directory exists but has no `ddc` symlink.
    let tmp = make_sysfs("card0-HDMI-A-1", None);
    let err = connector_ddc_adapter_in(tmp.path(), "card0-HDMI-A-1").unwrap_err();
    assert!(
        matches!(err, I2cDevError::ConnectorHasNoDdcAdapter { connector } if connector == "card0-HDMI-A-1")
    );
}

#[test]
fn ddc_adapter_index_unparseable_wrong_prefix() {
    // Symlink target's final component does not start with "i2c-".
    let tmp = make_sysfs("card0-HDMI-A-1", Some("../../devices/pci0000:00/usb-6"));
    let err = connector_ddc_adapter_in(tmp.path(), "card0-HDMI-A-1").unwrap_err();
    assert!(matches!(
        err,
        I2cDevError::DdcAdapterIndexUnparseable { .. }
    ));
}

#[test]
fn ddc_adapter_index_unparseable_non_numeric_suffix() {
    // "i2c-" prefix present but suffix is not all digits.
    let tmp = make_sysfs("card0-HDMI-A-1", Some("../../devices/i2c-abc"));
    let err = connector_ddc_adapter_in(tmp.path(), "card0-HDMI-A-1").unwrap_err();
    assert!(matches!(
        err,
        I2cDevError::DdcAdapterIndexUnparseable { .. }
    ));
}

#[test]
fn ddc_adapter_index_unparseable_empty_suffix() {
    // "i2c-" with nothing after it.
    let tmp = make_sysfs("card0-HDMI-A-1", Some("../../devices/i2c-"));
    let err = connector_ddc_adapter_in(tmp.path(), "card0-HDMI-A-1").unwrap_err();
    assert!(matches!(
        err,
        I2cDevError::DdcAdapterIndexUnparseable { .. }
    ));
}

#[test]
fn multi_digit_adapter_index() {
    let tmp = make_sysfs("card1-HDMI-A-2", Some("../../../i2c-12"));
    let path = connector_ddc_adapter_in(tmp.path(), "card1-HDMI-A-2").unwrap();
    assert_eq!(path, PathBuf::from("/dev/i2c-12"));
}

#[test]
fn public_entry_point_returns_connector_not_found() {
    // Exercises the public `connector_ddc_adapter` function (which hardcodes
    // `/sys/class/drm`) against the live sysfs. No real system will have a
    // connector with this name, so `ConnectorNotFound` is certain.
    let err = connector_ddc_adapter("card99-HDMI-NOEXIST-99").unwrap_err();
    assert!(matches!(
        err,
        I2cDevError::ConnectorNotFound { connector } if connector == "card99-HDMI-NOEXIST-99"
    ));
}

#[test]
fn ddc_adapter_index_unparseable_dotdot_target() {
    // Symlink target whose final component is `..` — `file_name()` returns
    // `None` for paths ending in `..`, hitting the first `ok_or_else` branch.
    let tmp = make_sysfs("card0-HDMI-A-1", Some("../.."));
    let err = connector_ddc_adapter_in(tmp.path(), "card0-HDMI-A-1").unwrap_err();
    assert!(matches!(
        err,
        I2cDevError::DdcAdapterIndexUnparseable { .. }
    ));
}