firewire-bebob-protocols 0.2.0

Implementation of protocols defined by BridgeCo. AG and application vendors for DM1000, DM1100, and DM1500 ASICs with its BridgeCo. Enhanced Break Out Box (BeBoB) solution.
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
114
115
116
117
118
119
120
121
122
123

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

//! Protocol implementation for models of Icon Digital International.
//!
//! The module includes structure, enumeration, and trait and its implementation for protocol
//! defined by Icon for FireWire models.
//!

//! ## Diagram of internal signal flow for Firexon
//!
//! ```text
//! analog-input-1/2 --------+------------------------------> stream-output-1/2
//! analog-input-3/4 --------|-+----------------------------> stream-output-3/4
//! digital-input-1/2 -------|-|-+--------------------------> stream-output-5/6
//!                          | | |
//!                          v v v
//!                      ++=========++
//!                      ||  6 x 2  ||
//!                      || monitor ||
//!                      ++=========++
//!                            |
//!                            v              ++=======++
//!                    monitor-output-1/2 --> || 4 x 2 ||
//!                                           || mixer ||
//!                            +------------> ||       ||
//!                            |              ++=======++
//!                            |                   |
//!                            |            mixer-output-1/2
//!                            |                  | |
//! stream-input-1/2 ----------+                  | +-------> analog-output-1/2
//!                                               v
//! stream-input-3/4 ---------------------(one source only)-> analog-output-3/4
//!                                               ^
//! stream-input-5/6 -----------------------------+---------> digital-output-1/2
//! ```

use super::*;

/// The protocol implementation of clock operation.
#[derive(Default, Debug)]
pub struct FirexonClkProtocol;

impl MediaClockFrequencyOperation for FirexonClkProtocol {
    const FREQ_LIST: &'static [u32] = &[44100, 48000, 88200, 96000, 176400, 192000];
}

impl SamplingClockSourceOperation for FirexonClkProtocol {
    const DST: SignalAddr = SignalAddr::Subunit(SignalSubunitAddr {
        subunit: MUSIC_SUBUNIT_0,
        plug_id: 0x05,
    });

    const SRC_LIST: &'static [SignalAddr] = &[
        // Internal.
        SignalAddr::Subunit(SignalSubunitAddr {
            subunit: MUSIC_SUBUNIT_0,
            plug_id: 0x05,
        }),
        // S/PDIF in coaxial interface.
        SignalAddr::Unit(SignalUnitAddr::Ext(0x03)),
    ];
}

/// The protocol implementation of physical output.
#[derive(Default, Debug)]
pub struct FirexonPhysOutputProtocol;

impl AvcAudioFeatureSpecification for FirexonPhysOutputProtocol {
    const ENTRIES: &'static [(u8, AudioCh)] = &[
        (0x06, AudioCh::Each(0)), // analog-output-1
        (0x06, AudioCh::Each(1)), // analog-output-2
        (0x07, AudioCh::Each(0)), // analog-output-3
        (0x07, AudioCh::Each(1)), // analog-output-4
    ];
}

impl AvcLevelOperation for FirexonPhysOutputProtocol {}

impl AvcLrBalanceOperation for FirexonPhysOutputProtocol {}

impl AvcMuteOperation for FirexonPhysOutputProtocol {}

impl AvcSelectorOperation for FirexonPhysOutputProtocol {
    // NOTE: "analog-output-3/4" (not "analog-output-1/2")
    const FUNC_BLOCK_ID_LIST: &'static [u8] = &[0x01];
    // NOTE: "mixer-output-1/2", "stream-input-3/4", "stream-input-5/6"
    const INPUT_PLUG_ID_LIST: &'static [u8] = &[0x00, 0x01, 0x02];
}

/// The protocol implementation of source to monitor mixer for physical inputs
#[derive(Default, Debug)]
pub struct FirexonMonitorSourceProtocol;

impl AvcAudioFeatureSpecification for FirexonMonitorSourceProtocol {
    const ENTRIES: &'static [(u8, AudioCh)] = &[
        (0x01, AudioCh::Each(0)), // analog-input-1
        (0x01, AudioCh::Each(1)), // analog-input-2
        (0x02, AudioCh::Each(0)), // analog-input-3
        (0x02, AudioCh::Each(1)), // analog-input-4
        (0x03, AudioCh::Each(0)), // digital-input-5
        (0x03, AudioCh::Each(1)), // digital-input-6
    ];
}

impl AvcLevelOperation for FirexonMonitorSourceProtocol {}

impl AvcLrBalanceOperation for FirexonMonitorSourceProtocol {}

impl AvcMuteOperation for FirexonMonitorSourceProtocol {}

/// The protocol implementation of source to mixer for stream input and output of the monitor mixer.
#[derive(Default, Debug)]
pub struct FirexonMixerSourceProtocol;

impl AvcAudioFeatureSpecification for FirexonMixerSourceProtocol {
    const ENTRIES: &'static [(u8, AudioCh)] = &[
        (0x04, AudioCh::Master), // stream-input-1/2
        (0x05, AudioCh::Master), // monitor-output-1/2
    ];
}

impl AvcLevelOperation for FirexonMixerSourceProtocol {}