safe-vex 4.4.0

A modular, safe and data-orientated rust wrapper over the Purdue PROS library for Vex Robotics
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

//! # ADI API

use crate::{bindings, error::{PROSErr, PROSResult}, port::AdiPort};

/// An Adi configuration
#[derive(Debug, Clone, Copy)]
#[repr(u32)]
pub enum AdiConfig {
    /// An analog Adi voltage input
    AnalogIn = 0,
    /// An analog Adi voltage output
    AnalogOut = 1,
    /// A digital Adi voltage input
    DigitalIn = 2,
    /// A digital Adi voltage output
    DigitalOut = 3,
}

/// Sets the configurations for a specified ADI port
pub fn set_config(port: AdiPort, config: AdiConfig)  {
    // set the config for the adi port
    unsafe {
        bindings::adi_port_set_config(port as u8, config as u32);
    }
}

/// Sends an outbound digital signal to a **configured** ADI port
///
/// **Warning:** ADI port must be configured prior to this function call
/// 
/// # Errors
/// 
/// - Returns `PROSErr::AddrInUse` if the ADI port is not configured correctly
///
/// # Safety
///
/// This function is marked unsafe due to it depending on the Adi port having previously being configured as the kind of Adi port that is expected by this function
pub unsafe fn digital_write(port: AdiPort, val: bool) -> Result<(), PROSErr> {
    // write to the digital ADI output and wrap any errors
    unsafe {
        bindings::adi_digital_write(port as u8, val)
    }.check().map(|_| ())
}

/// Reads an inbound digital signal from a **configured** ADI port
///
/// **Warning:** ADI port must be configured prior to this function call
/// 
/// # Errors
/// 
/// - Returns `PROSErr::AddrInUse` if the ADI port is not configured correctly
///
/// # Safety
///
/// This function is marked unsafe due to it depending on the Adi port having previously being configured as the kind of Adi port that is expected by this function
pub unsafe fn digital_read(port: AdiPort) -> Result<bool, PROSErr> {
    unsafe {
        bindings::adi_digital_read(port as u8)
    }.check().map(|val| val != 0)
}