futuresdr 0.6.0

An Experimental Async SDR Runtime for Heterogeneous Architectures.
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

use crate::runtime::BlockId;
use crate::runtime::BlockPortCtx;
use crate::runtime::Edge;
use crate::runtime::Error;
use crate::runtime::PortId;
use crate::runtime::Result;
use crate::runtime::resolve_port_name;

use super::BlockSlot;
use super::Flowgraph;

impl Flowgraph {
    /// Connect a message output port to a message input port.
    ///
    /// Message connections are type-erased and may form arbitrary topologies,
    /// including cycles and self-connections. The destination message input
    /// and the source message output are validated immediately. The concrete
    /// output handler list is populated from this logical edge at startup.
    pub fn message(
        &mut self,
        src_block_id: impl Into<BlockId>,
        src_port_id: impl Into<PortId>,
        dst_block_id: impl Into<BlockId>,
        dst_port_id: impl Into<PortId>,
    ) -> Result<(), Error> {
        let src_block_id = src_block_id.into();
        let src_port_id = src_port_id.into();
        let dst_block_id = dst_block_id.into();
        let dst_port_id = dst_port_id.into();

        let edge =
            self.normalize_message_edge(src_block_id, src_port_id, dst_block_id, dst_port_id)?;
        self.message_edges.push(edge);
        Ok(())
    }

    fn normalize_message_port(
        block_id: BlockId,
        port_id: PortId,
        ports: &[&str],
    ) -> Result<PortId, Error> {
        resolve_port_name(&port_id, ports).ok_or(Error::InvalidMessagePort(
            BlockPortCtx::Id(block_id),
            port_id,
        ))
    }

    fn normalize_message_edge(
        &self,
        src_block: BlockId,
        src_port: PortId,
        dst_block: BlockId,
        dst_port: PortId,
    ) -> Result<Edge, Error> {
        let dst_inputs = self
            .blocks
            .get(dst_block.0)
            .map(BlockSlot::message_inputs)
            .ok_or(Error::InvalidBlock(dst_block))?;
        let dst_port = Self::normalize_message_port(dst_block, dst_port, dst_inputs)?;

        let src_outputs = self
            .blocks
            .get(src_block.0)
            .map(BlockSlot::message_outputs)
            .ok_or(Error::InvalidBlock(src_block))?;
        let src_port = Self::normalize_message_port(src_block, src_port, src_outputs)?;

        Ok(Edge::new(src_block, src_port, dst_block, dst_port))
    }
}