p50x 0.1.0

P50X protocol communication library and command-line utility
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

/*
 * File: reply.ts
 * Date: 04.05.2020
 * Author: MarkAtk
 *
 * MIT License
 *
 * Copyright (c) 2020 MarkAtk
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

use std::convert::From;
use std::fmt;

#[derive(Debug, PartialEq, Eq, Copy, Clone)]
#[repr(u8)]
pub enum P50XReply {
    Ok = 0x00,
    BadCommand = 0x01,
    BadParameter = 0x02,
    PowerOff = 0x06,
    NoLokCommandSpace = 0x08,
    FullTurnoutCommandStack = 0x09,
    NoData = 0x0A,
    NoSlot = 0x0B,
    BadLokParameter = 0x0C,
    LokBusy = 0x0D,
    BadTurnoutParameter = 0x0E,
    BadSpecialOptionValue = 0x0F,
    NoI2CCommandSpace = 0x10,
    LowTurnoutCommandStackSpace = 0x40,
    LokHalt = 0x41,
    LokPowerOff = 0x42,
    Busy = 0x80,
    Unknown
}

impl From<u8> for P50XReply {
    fn from(value: u8) -> P50XReply {
        match value {
            0x00 => P50XReply::Ok,
            0x01 => P50XReply::BadCommand,
            0x02 => P50XReply::BadParameter,
            0x06 => P50XReply::PowerOff,
            0x08 => P50XReply::NoLokCommandSpace,
            0x09 => P50XReply::FullTurnoutCommandStack,
            0x0A => P50XReply::NoData,
            0x0B => P50XReply::NoSlot,
            0x0C => P50XReply::BadLokParameter,
            0x0D => P50XReply::LokBusy,
            0x0E => P50XReply::BadTurnoutParameter,
            0x0F => P50XReply::BadSpecialOptionValue,
            0x10 => P50XReply::NoI2CCommandSpace,
            0x40 => P50XReply::LowTurnoutCommandStackSpace,
            0x41 => P50XReply::LokHalt,
            0x42 => P50XReply::LokPowerOff,
            0x80 => P50XReply::Busy,
            _ => P50XReply::Unknown
        }
    }
}

impl fmt::Display for P50XReply {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match *self {
            P50XReply::Ok => write!(f, "Ok"),
            P50XReply::BadCommand => write!(f, "Command not implemented"),
            P50XReply::BadParameter => write!(f, "Bad parameter value"),
            P50XReply::PowerOff => write!(f, "Power is off"),
            P50XReply::NoLokCommandSpace => write!(f, "Locomotive command stack is full"),
            P50XReply::FullTurnoutCommandStack => write!(f, "Turnout command stack is full"),
            P50XReply::NoData => write!(f, "No locomotive data available"),
            P50XReply::NoSlot => write!(f, "No slot available"),
            P50XReply::BadLokParameter => write!(f, "Bad locomotive address"),
            P50XReply::LokBusy => write!(f, "Locomotive already controlled by another device"),
            P50XReply::BadTurnoutParameter => write!(f, "Bad turnout address"),
            P50XReply::BadSpecialOptionValue => write!(f, "Bad special option value"),
            P50XReply::NoI2CCommandSpace => write!(f, "I2C command stack is full"),
            P50XReply::LowTurnoutCommandStackSpace => write!(f, "Tunrout command stack is nearly full"),
            P50XReply::LokHalt => write!(f, "Command accepted but in halt mode"),
            P50XReply::LokPowerOff => write!(f, "Command accepted but power is off"),
            P50XReply::Busy => write!(f, "Device is busy"),
            P50XReply::Unknown => write!(f, "Unknown error")
        }
    }
}