teensy3 0.2.0

Rust interface layer for the Teensy 3.1/3.2 microcontroller
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

use bindings;
use core::fmt;

#[derive(Copy, Clone)]
pub struct Serial;

/// Struct for the onboard USB port. Should be treated as a singleton
impl Serial {
    /// Is serial data available?
    pub fn readable(self) -> bool {
        unsafe {
            bindings::usb_serial_available() > 0
        }
    }

    /// Read a byte, panic if no data available
    pub fn read_byte(self) -> u8 {
        self.try_read_byte().unwrap()
    }

    /// Try to read a byte
    pub fn try_read_byte(self) -> Result<u8, &'static str> {
        match unsafe { bindings::usb_serial_getchar() } {
            -1 => Err("usb_serial_getchar returned -1"),
            byte => Ok(byte as u8)
        }
    }

    /// Write N bytes to the serial port
    pub fn write_bytes(self, bytes: &[u8]) -> Result<(), ()> {
        unsafe {
            if bindings::usb_serial_write(bytes.as_ptr() as *const _, bytes.len() as u32) >= 0 {
                Ok(())
            } else {
                Err(())
            }
        }
    }
}

impl fmt::Write for Serial {
    fn write_str(&mut self, s: &str) -> fmt::Result {
        self.write_bytes(s.as_bytes()).map_err(|_| fmt::Error)
    }
}

/// print!() using the onboard USB serial port
#[macro_export]
macro_rules! print {
    ($($arg:tt)*) => {
        ::core::fmt::Write::write_fmt(&mut $crate::serial::Serial, format_args!($($arg)*)).ok();
    }
}

/// println!() using the onboard USB serial port
#[macro_export]
macro_rules! println {
    ($($arg:tt)*) => {
        ::core::fmt::Write::write_fmt(&mut $crate::serial::Serial, format_args!($($arg)*)).ok();
        let ser = $crate::serial::Serial{};
        ser.write_bytes("\n\r".as_bytes()).ok();
    }
}