#cortex-m #arm #teensy-4 #board #helper

no-std teensy4-pins

Helpers for configuring and using a Teensy 4's pins. Part of the teensy4-rs project

5 unstable releases

0.3.2 May 27, 2024
0.3.1 Feb 9, 2023
0.3.0 Jan 6, 2023
0.2.0 Dec 29, 2021
0.1.0 Oct 16, 2020

#1619 in Embedded development

Download history 202/week @ 2024-06-23 4/week @ 2024-06-30 17/week @ 2024-07-07 45/week @ 2024-07-14 52/week @ 2024-07-21 32/week @ 2024-07-28 35/week @ 2024-08-04 43/week @ 2024-08-11 23/week @ 2024-08-18 24/week @ 2024-08-25 40/week @ 2024-09-01 50/week @ 2024-09-08 56/week @ 2024-09-15 84/week @ 2024-09-22 93/week @ 2024-09-29 36/week @ 2024-10-06

274 downloads per month
Used in 6 crates (via teensy4-bsp)

MIT/Apache

47KB
573 lines

teensy4-pins

Hardware pins for the Teensy 4.0 and 4.1 boards

teensy4-pins is designed to the imxrt-iomuxc crate. The pins API constrains the processor pads to the ones that are available on the Teensy 4.0 and 4.1. It also exposes type aliases that simplify pin identification in the type system.

Note that this pin API is optional. You are free to configure the pins using the pad identifiers, instead of the physical pin identifiers. Pads are available directly from the imxrt-iomuxc crate.

See the API documentation for more information.

License: MIT OR Apache-2.0


lib.rs:

Hardware pins for the Teensy 4.0, 4.1 and MicroMod boards

teensy4-pins is designed to the imxrt-iomuxc crate. The pins API constrains the processor pads to the ones that are available on the Teensy 4.0, 4.1 and MicroMod. It also exposes type aliases that simplify pin identification in the type system.

Note that this pin API is optional. You are free to configure the pins using the pad identifiers, instead of the physical pin identifiers. Pads are available directly from the imxrt-iomuxc crate.

Teensy 4.0

To acquire Teensy 4.0 pins, call t40::from_pads and provide all of the processor pads:

use teensy4_pins::t40;

let pads = // Handle to all processor pads
    # unsafe { Pads::new() };
let pins = t40::from_pads(pads);

Teensy 4.1

The approach is the same as the Teensy 4.0, replacing t40 with t41:

use teensy4_pins::t41;

let pads = // Handle to all processor pads
    # unsafe { Pads::new() };
let pins = t41::from_pads(pads);

Teensy MicroMod

The approach is the same as the Teensy 4.0, replacing t40 with tmm:

use teensy4_pins::tmm;

let pads = // Handle to all processor pads
    # unsafe { Pads::new() };
let pins = tmm::from_pads(pads);

Pin configuration

Once you have your pad resources, you can configure pull ups, pull downs, and other pad characteristics. See the Config documentation for all supported features. Use configure to apply the settings.

For example, here's a pull down on pin 7 and an pull up, open drain on pin 9:

use teensy4_pins::{t40, Config, configure, PullKeeper, OpenDrain};

const P7_CONFIG: Config = Config::zero()
    .set_pull_keeper(Some(PullKeeper::Pulldown100k));

const P9_CONFIG: Config = Config::zero()
    .set_pull_keeper(Some(PullKeeper::Pullup22k))
    .set_open_drain(OpenDrain::Enabled);

let pads = // Handle to all processor pads
    # unsafe { Pads::new() };
let mut pins = t40::from_pads(pads);

configure(&mut pins.p7, P7_CONFIG);
configure(&mut pins.p9, P9_CONFIG);

Safety

The safe APIs expect to work on the only instance of the processor pads. If you don't have that available, or you need more flexibility, use the unsafe t40::Pin::new, t41::Pins::new, or tmm::Pins::new constructor methods to create an instance that may be aliasing another handle to the pads or pins.

Dependencies

~430KB