ezsp 6.0.1

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
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

use core::future::Future;

use crate::Transport;
use crate::ember::token::{Data, Info};
use crate::frame::parameters::token_interface::{
    get_token_count, get_token_data, get_token_info, gp_security_test_vectors, reset_node,
    set_token_data, token_factory_reset,
};

/// The `TokenInterface` trait provides an interface for the token interface.
pub trait TokenInterface {
    /// Gets the total number of tokens.
    fn get_token_count(&mut self) -> impl Future<Output = Result<u8, crate::Error>> + Send;

    /// Gets the token data for a single token with provided key.
    fn get_token_data(
        &mut self,
        token: u32,
        index: u32,
    ) -> impl Future<Output = Result<Data, crate::Error>> + Send;

    /// Gets the token information for a single token at provided index
    fn get_token_info(
        &mut self,
        index: u8,
    ) -> impl Future<Output = Result<Info, crate::Error>> + Send;

    /// Run GP security test vectors.
    fn gp_security_test_vectors(&mut self)
    -> impl Future<Output = Result<(), crate::Error>> + Send;

    /// Reset the node by calling `halReboot`.
    fn reset_node(&mut self) -> impl Future<Output = Result<(), crate::Error>> + Send;

    /// Sets the token data for a single token with provided key.
    fn set_token_data(
        &mut self,
        token: u32,
        index: u32,
        token_data: Data,
    ) -> impl Future<Output = Result<(), crate::Error>> + Send;

    /// Factory reset all configured Zigbee tokens.
    fn token_factory_reset(
        &mut self,
        exclude_outgoing_fc: bool,
        exclude_boot_counter: bool,
    ) -> impl Future<Output = Result<(), crate::Error>> + Send;
}

impl<T> TokenInterface for T
where
    T: Transport,
{
    async fn get_token_count(&mut self) -> Result<u8, crate::Error> {
        self.communicate(get_token_count::Command)
            .await
            .map(Into::into)
    }

    async fn get_token_data(&mut self, token: u32, index: u32) -> Result<Data, crate::Error> {
        self.communicate(get_token_data::Command::new(token, index))
            .await?
            .try_into()
    }

    async fn get_token_info(&mut self, index: u8) -> Result<Info, crate::Error> {
        self.communicate(get_token_info::Command::new(index))
            .await?
            .try_into()
    }

    async fn gp_security_test_vectors(&mut self) -> Result<(), crate::Error> {
        self.communicate(gp_security_test_vectors::Command)
            .await?
            .try_into()
    }

    async fn reset_node(&mut self) -> Result<(), crate::Error> {
        self.communicate(reset_node::Command).await.map(drop)
    }

    async fn set_token_data(
        &mut self,
        token: u32,
        index: u32,
        token_data: Data,
    ) -> Result<(), crate::Error> {
        self.communicate(set_token_data::Command::new(token, index, token_data))
            .await?
            .try_into()
    }

    async fn token_factory_reset(
        &mut self,
        exclude_outgoing_fc: bool,
        exclude_boot_counter: bool,
    ) -> Result<(), crate::Error> {
        self.communicate(token_factory_reset::Command::new(
            exclude_outgoing_fc,
            exclude_boot_counter,
        ))
        .await
        .map(drop)
    }
}