jacdac-rs 0.1.0

jacdac-rs is a library written entirely in Rust, with the aim of providing jacdac support for embedded development
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

use crate::transport::{self, frame_flag::FrameFlags, serice_index::ServiceIndex};

use super::{
    packet_type::{CommandType, PacketType, ReportType},
    reports::{ActionReport, EventReport},
    serivce_error::ServiceError,
};

#[derive(Debug)]
pub struct Packet {
    pub service_index: ServiceIndex,
    pub packet_type: PacketType,
}

impl Packet {
    pub fn from_transport(
        packet: transport::packet::Packet,
        flags: &FrameFlags,
    ) -> Result<Self, ServiceError> {
        let packet_type: PacketType;

        if flags.is_command() {
            let command_type = match packet.command {
                transport::service_command::ServiceCommand::Action(value) => {
                    Ok(CommandType::Action(value & 0x0FFF))
                }
                transport::service_command::ServiceCommand::RegisterRead(value) => {
                    Ok(CommandType::ReadRegister(value & 0x0FFF))
                }
                transport::service_command::ServiceCommand::RegisterWrite(value) => {
                    Ok(CommandType::WriteRegister(value & 0x0FFF, packet.payload))
                }
                transport::service_command::ServiceCommand::Reserved(_) => {
                    Err(ServiceError::UnsupportedServiceCommand(
                        "Reserved service command is not supported",
                    ))
                }
                transport::service_command::ServiceCommand::Events(_) => {
                    Err(ServiceError::UnsupportedServiceCommand(
                        "Event service command (when command flag present) is not supported",
                    ))
                }
            }?;
            packet_type = PacketType::Command(command_type);
        } else {
            let report_type = match packet.command {
                transport::service_command::ServiceCommand::Action(value) => {
                    Ok(ReportType::Actions(ActionReport{ code: value & 0x0FFF, payload: packet.payload}))
                }
                transport::service_command::ServiceCommand::RegisterRead(value) => {
                    Ok(ReportType::Register(value & 0x0FFF, packet.payload))
                }
                transport::service_command::ServiceCommand::Events(value) => Ok(
                    ReportType::Events(EventReport{
                        counter: ((value & 0x7F00) >> 8) as u8,
                        code: (value & 0x00FF) as u8,
                        payload: if packet.payload.is_empty() { None } else { Some(packet.payload) }
                    }
                )),
                transport::service_command::ServiceCommand::RegisterWrite(_) => Err(
                    ServiceError::UnsupportedServiceCommand("Register Write service commmand (when command flag not present) is not supported"),
                ),
                transport::service_command::ServiceCommand::Reserved(_) => Err(
                    ServiceError::UnsupportedServiceCommand("Reserved service command is not supported"),
                ),
            }?;
            packet_type = PacketType::Report(report_type);
        }

        Ok(Self {
            service_index: packet.index,
            packet_type,
        })
    }
}