ezsp 5.0.0

Ember ZNet Serial Protocol
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

#![cfg(feature = "ashv2")]
//! `ASHv2` extensions for the builder.

use std::io;

use ashv2::{Actor, SerialPort, TryCloneNative};
use tokio::sync::mpsc::channel;

use crate::apis_saltans::network_manager::builder::Builder;
use crate::uart::{Buffers, Uart};
use crate::{Error, MIN_NON_LEGACY_VERSION};

impl Builder<Uart> {
    /// Create a new builder using an `ASHv2` UART on the given serial port.
    ///
    /// # Errors
    ///
    /// Returns an [`Error`] if the serial port cannot be used for `ASHv2` communication.
    pub fn ashv2<T>(serial_port: T) -> Result<Self, Error>
    where
        T: SerialPort + TryCloneNative + Sync + 'static,
    {
        Self::ashv2_with_buffers(serial_port, &Buffers::default())
    }

    /// Create a new builder using an `ASHv2` UART on the given serial port.
    ///
    /// # Errors
    ///
    /// Returns an [`Error`] if the serial port cannot be used for `ASHv2` communication.
    pub fn ashv2_with_buffers<T>(serial_port: T, buffers: &Buffers) -> Result<Self, Error>
    where
        T: SerialPort + TryCloneNative + Sync + 'static,
    {
        let (ash_tx, ash_rx) = channel(buffers.ash_receiver);
        let (_ashv2_tasks, proxy) = Actor::new(serial_port, ash_tx, buffers.ash_transmitter)
            .map_err(io::Error::from)?
            .spawn();
        let (callbacks_tx, callbacks_rx) = channel(buffers.ezsp_callbacks);
        let uart = Uart::new(
            proxy,
            ash_rx,
            callbacks_tx,
            MIN_NON_LEGACY_VERSION,
            buffers.ezsp_messages,
        );
        Ok(Self::new(uart, callbacks_rx))
    }
}