firewire-fireworks-protocols 0.2.0

Implementation of protocols defined by Echo Digital Audio Corporation for Fireworks board module.
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

// SPDX-License-Identifier: LGPL-3.0-or-later
// Copyright (c) 2021 Takashi Sakamoto

//! Protocol about physical input.
//!
//! The module includes protocol about physical input defined by Echo Audio Digital Corporation for
//! Fireworks board module.

use super::*;

const CATEGORY_PHYS_INPUT: u32 = 5;

const CMD_SET_NOMINAL: u32 = 8;
const CMD_GET_NOMINAL: u32 = 9;

/// The parameters of physical inputs.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct EfwPhysInputParameters {
    /// The nominal signal level of physical input.
    pub nominals: Vec<NominalSignalLevel>,
}

/// The specification of physical input.
pub trait EfwPhysInputSpecification: EfwHardwareSpecification {
    fn phys_analog_input_count() -> usize {
        Self::PHYS_INPUT_GROUPS
            .iter()
            .filter(|(group_type, _)| PhysGroupType::Analog.eq(group_type))
            .fold(0, |total, (_, count)| total + count)
    }

    fn create_phys_input_parameters() -> EfwPhysInputParameters {
        EfwPhysInputParameters {
            nominals: vec![Default::default(); Self::phys_analog_input_count()],
        }
    }
}

impl<O, P> EfwWhollyCachableParamsOperation<P, EfwPhysInputParameters> for O
where
    O: EfwPhysInputSpecification,
    P: EfwProtocolExtManual,
{
    fn cache_wholly(
        proto: &mut P,
        states: &mut EfwPhysInputParameters,
        timeout_ms: u32,
    ) -> Result<(), Error> {
        assert_eq!(states.nominals.len(), Self::phys_analog_input_count());

        states
            .nominals
            .iter_mut()
            .enumerate()
            .try_for_each(|(ch, level)| {
                let args = [ch as u32, 0];
                let mut params = vec![0; 2];
                proto
                    .transaction(
                        CATEGORY_PHYS_INPUT,
                        CMD_GET_NOMINAL,
                        &args,
                        &mut params,
                        timeout_ms,
                    )
                    .map(|_| deserialize_nominal_signal_level(level, params[1]))
            })
    }
}

impl<O, P> EfwPartiallyUpdatableParamsOperation<P, EfwPhysInputParameters> for O
where
    O: EfwPhysInputSpecification,
    P: EfwProtocolExtManual,
{
    fn update_partially(
        proto: &mut P,
        states: &mut EfwPhysInputParameters,
        updates: EfwPhysInputParameters,
        timeout_ms: u32,
    ) -> Result<(), Error> {
        assert_eq!(states.nominals.len(), Self::phys_analog_input_count());
        assert_eq!(updates.nominals.len(), Self::phys_analog_input_count());

        states
            .nominals
            .iter_mut()
            .zip(&updates.nominals)
            .enumerate()
            .filter(|(_, (o, n))| !o.eq(n))
            .try_for_each(|(ch, (curr, level))| {
                let args = [ch as u32, serialize_nominal_signal_level(level)];
                proto
                    .transaction(
                        CATEGORY_PHYS_INPUT,
                        CMD_SET_NOMINAL,
                        &args,
                        &mut vec![0; 2],
                        timeout_ms,
                    )
                    .map(|_| *curr = *level)
            })
    }
}