pcics 0.3.2

PCI configuration space access library
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

/*!
# Root Complex Event Collector Endpoint Association

The PCI Express Root Complex Event Collector Endpoint Association Capability is implemented
by Root Complex Event Collectors.

It declares the RCiEPs supported by the Root Complex Event Collector on the same Logical Bus on
which the Root Complex Event Collector is located. A Root Complex Event Collector must
implement the Root Complex Event Collector Endpoint Association Capability; no other PCI
Express device Function is permitted to implement this Capability.

## Struct diagram
<pre>
<a href="struct.RootComplexEventCollectorEndpointAssociation.html">RootComplexEventCollectorEndpointAssociation</a>
</pre>

## Examples
```rust
# use pcics::extended_capabilities::root_complex_event_collector_endpoint_association::*;
let data = [
    0x07, 0x00, 0x00, 0x00, // Extended Capability Header
    0x44, 0x33, 0x22, 0x11, // Association Bitmap for RCiEPs
];
let result = data[4..].try_into().unwrap();
let sample = RootComplexEventCollectorEndpointAssociation {
    association_bitmap_for_rcieps: 0x11223344
};
assert_eq!(sample, result);
```
*/

use heterob::{endianness::Le, Seq};

use super::ExtendedCapabilityDataError;

/// Root Complex Event Collector Endpoint Association
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct RootComplexEventCollectorEndpointAssociation {
    /// The Association Bitmap for RCiEPs is a read-only register that sets
    /// the bits corresponding to the Device Numbers of RCiEPs supported by the Root
    /// Complex Event Collector on the same Logical Bus as the Event Collector itself.
    pub association_bitmap_for_rcieps: u32,
}

impl RootComplexEventCollectorEndpointAssociation {
    pub const SIZE: usize = 4;
}

impl From<[u8; Self::SIZE]> for RootComplexEventCollectorEndpointAssociation {
    fn from(bytes: [u8; Self::SIZE]) -> Self {
        let Le(association_bitmap_for_rcieps) = bytes.into();
        Self {
            association_bitmap_for_rcieps,
        }
    }
}

impl TryFrom<&[u8]> for RootComplexEventCollectorEndpointAssociation {
    type Error = ExtendedCapabilityDataError;

    fn try_from(slice: &[u8]) -> Result<Self, Self::Error> {
        let Seq { head, .. } = slice.try_into().map_err(|_| ExtendedCapabilityDataError {
            name: "Root Complex Event Collector Endpoint Association",
            size: Self::SIZE,
        })?;
        Ok(From::<[u8; Self::SIZE]>::from(head))
    }
}