mirajazz 0.5.0

A library for interfacing with Mirabox and Ajazz stream controller devices
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

use std::{
    error::Error,
    fmt::{Display, Formatter},
    str::Utf8Error,
    sync::PoisonError,
};

use async_hid::HidError;
use image::ImageError;

/// Errors that can occur while working with devices
#[derive(Debug)]
pub enum MirajazzError {
    /// Watcher is already initialized
    WatcherAlreadyInitialized,

    /// No device found for specified vid, pid and serial
    DeviceNotFoundError,

    /// HidApi error
    HidError(HidError),

    /// Failed to convert bytes into string
    Utf8Error(Utf8Error),

    /// Failed to encode image
    ImageError(ImageError),

    /// Reader mutex was poisoned
    PoisonError,

    /// There's literally nowhere to write the image
    NoScreen,

    /// Key index is invalid
    InvalidKeyIndex,

    /// Unrecognized Product ID
    UnrecognizedPID,

    /// The device doesn't support doing that
    UnsupportedOperation,

    /// Device sent unexpected data
    BadData,
}

impl Display for MirajazzError {
    fn fmt(&self, f: &mut Formatter<'_>) -> std::fmt::Result {
        write!(f, "{:?}", self)
    }
}

impl Error for MirajazzError {}

impl From<HidError> for MirajazzError {
    fn from(e: HidError) -> Self {
        Self::HidError(e)
    }
}

impl From<Utf8Error> for MirajazzError {
    fn from(e: Utf8Error) -> Self {
        Self::Utf8Error(e)
    }
}

impl From<ImageError> for MirajazzError {
    fn from(e: ImageError) -> Self {
        Self::ImageError(e)
    }
}

impl<T> From<PoisonError<T>> for MirajazzError {
    fn from(_value: PoisonError<T>) -> Self {
        Self::PoisonError
    }
}