multiboot2/
apm.rs

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
114
115
116
117
118
119
120
121
122
123
124
125
126
//! Module for [`ApmTag`].

use crate::{TagHeader, TagType};
use core::mem;
use multiboot2_common::{MaybeDynSized, Tag};

/// The Advanced Power Management (APM) tag.
#[derive(Debug)]
#[repr(C, align(8))]
pub struct ApmTag {
    header: TagHeader,
    version: u16,
    cseg: u16,
    offset: u32,
    cset_16: u16,
    dseg: u16,
    flags: u16,
    cseg_len: u16,
    cseg_16_len: u16,
    dseg_len: u16,
}

impl ApmTag {
    /// Creates a new tag.
    #[allow(clippy::too_many_arguments)]
    #[must_use]
    pub fn new(
        version: u16,
        cseg: u16,
        offset: u32,
        cset_16: u16,
        dset: u16,
        flags: u16,
        cseg_len: u16,
        cseg_16_len: u16,
        dseg_len: u16,
    ) -> Self {
        Self {
            header: TagHeader::new(Self::ID, mem::size_of::<Self>() as u32),
            version,
            cseg,
            offset,
            cset_16,
            dseg: dset,
            flags,
            cseg_len,
            cseg_16_len,
            dseg_len,
        }
    }

    /// The version number of the APM BIOS.
    #[must_use]
    pub const fn version(&self) -> u16 {
        self.version
    }

    /// Contains the 16-bit code segment (CS) address for the APM entry point.
    #[must_use]
    pub const fn cseg(&self) -> u16 {
        self.cseg
    }

    /// Represents the offset address within the code segment (`cseg`) for the
    /// APM entry point.
    #[must_use]
    pub const fn offset(&self) -> u32 {
        self.offset
    }

    /// Contains the 16-bit code segment (CS) address used for 16-bit protected
    /// mode APM functions.
    #[must_use]
    pub const fn cset_16(&self) -> u16 {
        self.cset_16
    }

    /// Holds the 16-bit data segment (DS) address used by the APM BIOS for
    /// data operations.
    #[must_use]
    pub const fn dseg(&self) -> u16 {
        self.dseg
    }

    /// Indicates the status and characteristics of the APM connection, such as
    /// if APM is present and its capabilities.
    #[must_use]
    pub const fn flags(&self) -> u16 {
        self.flags
    }

    /// Indicates the length, in bytes, of the data segment (`dseg`) used by
    /// the APM BIOS
    #[must_use]
    pub const fn cseg_len(&self) -> u16 {
        self.cseg_len
    }

    /// Provides the length, in bytes, of the 16-bit code segment (`cseg_16`)
    /// used for APM functions.
    #[must_use]
    pub const fn cseg_16_len(&self) -> u16 {
        self.cseg_16_len
    }

    /// Indicates the length, in bytes, of the data segment (`dseg`) used by
    /// the APM BIOS.
    #[must_use]
    pub const fn dseg_len(&self) -> u16 {
        self.dseg_len
    }
}

impl MaybeDynSized for ApmTag {
    type Header = TagHeader;

    const BASE_SIZE: usize = mem::size_of::<Self>();

    fn dst_len(_: &TagHeader) {}
}

impl Tag for ApmTag {
    type IDType = TagType;

    const ID: TagType = TagType::Apm;
}