Add Tiny2040 board support (#305)

* Add Tiny2040 board support

* Remove unnecessary dev-dependencies

* Remove unnecessary dependencies
This commit is contained in:
Mike Bell 2022-02-28 20:21:52 +00:00 committed by GitHub
parent 111654fc28
commit 70be6ac766
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
6 changed files with 586 additions and 0 deletions

View file

@ -10,6 +10,7 @@ members = [
"boards/adafruit-trinkey-qt2040",
"boards/pimoroni-pico-explorer",
"boards/pimoroni-pico-lipo-16mb",
"boards/pimoroni-tiny2040",
"boards/rp-pico",
"boards/solderparty-rp2040-stamp",
"boards/sparkfun-pro-micro-rp2040",

11
boards/pimoroni-tiny2040/.gitignore vendored Normal file
View file

@ -0,0 +1,11 @@
# Generated by Cargo
# will have compiled files and executables
debug/
target/
# Remove Cargo.lock from gitignore if creating an executable, leave it for libraries
# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
Cargo.lock
# These are backup files generated by rustfmt
**/*.rs.bk

View file

@ -0,0 +1,30 @@
[package]
name = "pimoroni-tiny2040"
version = "0.1.0"
authors = ["Mike Bell <mdb036@gmail.com>"]
edition = "2018"
homepage = "https://github.com/rp-rs/rp-hal/tree/main/boards/pimoroni-tiny2040"
description = "Board Support Package for the Pimoroni Tiny2040"
license = "MIT OR Apache-2.0"
repository = "https://github.com/rp-rs/rp-hal.git"
# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
[dependencies]
cortex-m = "0.7.2"
rp2040-boot2 = { version = "0.2.0", optional = true }
rp2040-hal = { path = "../../rp2040-hal", version = "0.4.0"}
cortex-m-rt = { version = "0.7", optional = true }
embedded-time = "0.12.0"
[dev-dependencies]
panic-halt= "0.2.0"
embedded-hal ="0.2.5"
defmt = "0.2.0"
defmt-rtt = "0.2.0"
[features]
default = ["boot2", "rt"]
boot2 = ["rp2040-boot2"]
rt = ["cortex-m-rt","rp2040-hal/rt"]

View file

@ -0,0 +1,95 @@
# [pimoroni-tiny2040] - Board Support for the [Pimoroni Tiny2040]
You should include this crate if you are writing code that you want to run on
a [Pimoroni Tiny2040] - one of the first third party RP2040 boards available, with 8MB flash and a 3 colour LED.
This crate includes the [rp2040-hal], but also configures each pin of the
RP2040 chip according to how it is connected up on the Tiny2040.
[Pimoroni Tiny2040]: https://shop.pimoroni.com/products/tiny-2040
[rp-pico]: https://github.com/rp-rs/rp-hal/tree/main/boards/rp-pico
[rp2040-hal]: https://github.com/rp-rs/rp-hal/tree/main/rp2040-hal
[Raspberry Silicon RP2040]: https://www.raspberrypi.org/products/rp2040/
## Using
To use this crate, your `Cargo.toml` file should contain:
```toml
pimoroni-tiny2040 = "0.1.0"
```
In your program, you will need to call `pimoroni_tiny2040::Pins::new` to create
a new `Pins` structure. This will set up all the GPIOs for any on-board
devices. See the [examples](./examples) folder for more details.
## Examples
### General Instructions
To compile an example, clone the _rp-hal_ repository and run:
```console
rp-hal/boards/pimoroni-tiny2040 $ cargo build --release --example <name>
```
You will get an ELF file called
`./target/thumbv6m-none-eabi/release/examples/<name>`, where the `target`
folder is located at the top of the _rp-hal_ repository checkout. Normally
you would also need to specify `--target=thumbv6m-none-eabi` but when
building examples from this git repository, that is set as the default.
If you want to convert the ELF file to a UF2 and automatically copy it to the
USB drive exported by the RP2040 bootloader, simply boot your board into
bootloader mode and run:
```console
rp-hal/boards/pimoroni-tiny2040 $ cargo run --release --example <name>
```
If you get an error about not being able to find `elf2uf2-rs`, try:
```console
$ cargo install elf2uf2-rs
```
then try repeating the `cargo run` command above.
### [tiny2040_blinky](./examples/tiny2040_blinky.rs)
Flashes the Tiny2040's three on-board LEDs in sequence.
## Contributing
Contributions are what make the open source community such an amazing place to
be learn, inspire, and create. Any contributions you make are **greatly
appreciated**.
The steps are:
1. Fork the Project by clicking the 'Fork' button at the top of the page.
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Make some changes to the code or documentation.
4. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
5. Push to the Feature Branch (`git push origin feature/AmazingFeature`)
6. Create a [New Pull Request](https://github.com/rp-rs/rp-hal/pulls)
7. An admin will review the Pull Request and discuss any changes that may be required.
8. Once everyone is happy, the Pull Request can be merged by an admin, and your work is part of our project!
## Code of Conduct
Contribution to this crate is organized under the terms of the [Rust Code of
Conduct][CoC], and the maintainer of this crate, the [rp-rs team], promises
to intervene to uphold that code of conduct.
[CoC]: CODE_OF_CONDUCT.md
[rp-rs team]: https://github.com/orgs/rp-rs/teams/rp-rs
## License
The contents of this repository are dual-licensed under the _MIT OR Apache
2.0_ License. That means you can chose either the MIT licence or the
Apache-2.0 licence when you re-use this code. See `MIT` or `APACHE2.0` for more
information on each specific licence.
Any submissions to this project (e.g. as Pull Requests) must be made available
under these terms.

View file

@ -0,0 +1,71 @@
//! Blinks the 3 colour LEDs on a Tiny2040 in sequence
#![no_std]
#![no_main]
use cortex_m_rt::entry;
use defmt::*;
use defmt_rtt as _;
use embedded_hal::digital::v2::OutputPin;
use embedded_time::fixed_point::FixedPoint;
use panic_halt as _;
use pimoroni_tiny2040 as bsp;
use bsp::hal::{
clocks::{init_clocks_and_plls, Clock},
pac,
sio::Sio,
watchdog::Watchdog,
};
#[entry]
fn main() -> ! {
info!("Program start");
let mut pac = pac::Peripherals::take().unwrap();
let core = pac::CorePeripherals::take().unwrap();
let mut watchdog = Watchdog::new(pac.WATCHDOG);
let sio = Sio::new(pac.SIO);
// External high-speed crystal on the pico board is 12Mhz
let clocks = init_clocks_and_plls(
bsp::XOSC_CRYSTAL_FREQ,
pac.XOSC,
pac.CLOCKS,
pac.PLL_SYS,
pac.PLL_USB,
&mut pac.RESETS,
&mut watchdog,
)
.ok()
.unwrap();
let mut delay = cortex_m::delay::Delay::new(core.SYST, clocks.system_clock.freq().integer());
let pins = bsp::Pins::new(
pac.IO_BANK0,
pac.PADS_BANK0,
sio.gpio_bank0,
&mut pac.RESETS,
);
let mut led_green = pins.led_green.into_push_pull_output();
let mut led_red = pins.led_red.into_push_pull_output();
let mut led_blue = pins.led_blue.into_push_pull_output();
led_green.set_high().unwrap();
led_red.set_high().unwrap();
led_blue.set_high().unwrap();
loop {
led_green.set_low().unwrap();
delay.delay_ms(500);
led_green.set_high().unwrap();
led_blue.set_low().unwrap();
delay.delay_ms(500);
led_blue.set_high().unwrap();
led_red.set_low().unwrap();
delay.delay_ms(500);
led_red.set_high().unwrap();
}
}
// End of file

View file

@ -0,0 +1,378 @@
#![no_std]
pub extern crate rp2040_hal as hal;
#[cfg(feature = "rt")]
extern crate cortex_m_rt;
#[cfg(feature = "rt")]
pub use cortex_m_rt::entry;
/// The linker will place this boot block at the start of our program image. We
/// need this to help the ROM bootloader get our code up and running.
#[cfg(feature = "boot2")]
#[link_section = ".boot2"]
#[no_mangle]
#[used]
pub static BOOT2_FIRMWARE: [u8; 256] = rp2040_boot2::BOOT_LOADER_W25Q080;
pub use hal::pac;
hal::bsp_pins!(
/// GPIO 0 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 RX` | [crate::Gp0Spi0Rx] |
/// | `UART0 TX` | [crate::Gp0Uart0Tx] |
/// | `I2C0 SDA` | [crate::Gp0I2C0Sda] |
/// | `PWM0 A` | [crate::Gp0Pwm0A] |
/// | `PIO0` | [crate::Gp0Pio0] |
/// | `PIO1` | [crate::Gp0Pio1] |
Gpio0 {
name: gpio0,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio0].
FunctionUart: Gp0Uart0Tx,
/// SPI Function alias for pin [crate::Pins::gpio0].
FunctionSpi: Gp0Spi0Rx,
/// I2C Function alias for pin [crate::Pins::gpio0].
FunctionI2C: Gp0I2C0Sda,
/// PWM Function alias for pin [crate::Pins::gpio0].
FunctionPwm: Gp0Pwm0A,
/// PIO0 Function alias for pin [crate::Pins::gpio0].
FunctionPio0: Gp0Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio0].
FunctionPio1: Gp0Pio1
}
},
/// GPIO 1 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 CSn` | [crate::Gp1Spi0Csn] |
/// | `UART0 RX` | [crate::Gp1Uart0Rx] |
/// | `I2C0 SCL` | [crate::Gp1I2C0Scl] |
/// | `PWM0 B` | [crate::Gp1Pwm0B] |
/// | `PIO0` | [crate::Gp1Pio0] |
/// | `PIO1` | [crate::Gp1Pio1] |
Gpio1 {
name: gpio1,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio1].
FunctionUart: Gp1Uart0Rx,
/// SPI Function alias for pin [crate::Pins::gpio1].
FunctionSpi: Gp1Spi0Csn,
/// I2C Function alias for pin [crate::Pins::gpio1].
FunctionI2C: Gp1I2C0Scl,
/// PWM Function alias for pin [crate::Pins::gpio1].
FunctionPwm: Gp1Pwm0B,
/// PIO0 Function alias for pin [crate::Pins::gpio1].
FunctionPio0: Gp1Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio1].
FunctionPio1: Gp1Pio1
}
},
/// GPIO 2 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 SCK` | [crate::Gp2Spi0Sck] |
/// | `UART0 CTS` | [crate::Gp2Uart0Cts] |
/// | `I2C1 SDA` | [crate::Gp2I2C1Sda] |
/// | `PWM1 A` | [crate::Gp2Pwm1A] |
/// | `PIO0` | [crate::Gp2Pio0] |
/// | `PIO1` | [crate::Gp2Pio1] |
Gpio2 {
name: gpio2,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio2].
FunctionUart: Gp2Uart0Cts,
/// SPI Function alias for pin [crate::Pins::gpio2].
FunctionSpi: Gp2Spi0Sck,
/// I2C Function alias for pin [crate::Pins::gpio2].
FunctionI2C: Gp2I2C1Sda,
/// PWM Function alias for pin [crate::Pins::gpio2].
FunctionPwm: Gp2Pwm1A,
/// PIO0 Function alias for pin [crate::Pins::gpio2].
FunctionPio0: Gp2Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio2].
FunctionPio1: Gp2Pio1
}
},
/// GPIO 3 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 TX` | [crate::Gp3Spi0Tx] |
/// | `UART0 RTS` | [crate::Gp3Uart0Rts] |
/// | `I2C1 SCL` | [crate::Gp3I2C1Scl] |
/// | `PWM1 B` | [crate::Gp3Pwm1B] |
/// | `PIO0` | [crate::Gp3Pio0] |
/// | `PIO1` | [crate::Gp3Pio1] |
Gpio3 {
name: gpio3,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio3].
FunctionUart: Gp3Uart0Rts,
/// SPI Function alias for pin [crate::Pins::gpio3].
FunctionSpi: Gp3Spi0Tx,
/// I2C Function alias for pin [crate::Pins::gpio3].
FunctionI2C: Gp3I2C1Scl,
/// PWM Function alias for pin [crate::Pins::gpio3].
FunctionPwm: Gp3Pwm1B,
/// PIO0 Function alias for pin [crate::Pins::gpio3].
FunctionPio0: Gp3Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio3].
FunctionPio1: Gp3Pio1
}
},
/// GPIO 4 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 RX` | [crate::Gp4Spi0Rx] |
/// | `UART1 TX` | [crate::Gp4Uart1Tx] |
/// | `I2C0 SDA` | [crate::Gp4I2C0Sda] |
/// | `PWM2 A` | [crate::Gp4Pwm2A] |
/// | `PIO0` | [crate::Gp4Pio0] |
/// | `PIO1` | [crate::Gp4Pio1] |
Gpio4 {
name: gpio4,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio4].
FunctionUart: Gp4Uart1Tx,
/// SPI Function alias for pin [crate::Pins::gpio4].
FunctionSpi: Gp4Spi0Rx,
/// I2C Function alias for pin [crate::Pins::gpio4].
FunctionI2C: Gp4I2C0Sda,
/// PWM Function alias for pin [crate::Pins::gpio4].
FunctionPwm: Gp4Pwm2A,
/// PIO0 Function alias for pin [crate::Pins::gpio4].
FunctionPio0: Gp4Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio4].
FunctionPio1: Gp4Pio1
}
},
/// GPIO 5 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 CSn` | [crate::Gp5Spi0Csn] |
/// | `UART1 RX` | [crate::Gp5Uart1Rx] |
/// | `I2C0 SCL` | [crate::Gp5I2C0Scl] |
/// | `PWM2 B` | [crate::Gp5Pwm2B] |
/// | `PIO0` | [crate::Gp5Pio0] |
/// | `PIO1` | [crate::Gp5Pio1] |
Gpio5 {
name: gpio5,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio5].
FunctionUart: Gp5Uart1Rx,
/// SPI Function alias for pin [crate::Pins::gpio5].
FunctionSpi: Gp5Spi0Csn,
/// I2C Function alias for pin [crate::Pins::gpio5].
FunctionI2C: Gp5I2C0Scl,
/// PWM Function alias for pin [crate::Pins::gpio5].
FunctionPwm: Gp5Pwm2B,
/// PIO0 Function alias for pin [crate::Pins::gpio5].
FunctionPio0: Gp5Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio5].
FunctionPio1: Gp5Pio1
}
},
/// GPIO 6 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 SCK` | [crate::Gp6Spi0Sck] |
/// | `UART1 CTS` | [crate::Gp6Uart1Cts] |
/// | `I2C1 SDA` | [crate::Gp6I2C1Sda] |
/// | `PWM3 A` | [crate::Gp6Pwm3A] |
/// | `PIO0` | [crate::Gp6Pio0] |
/// | `PIO1` | [crate::Gp6Pio1] |
Gpio6 {
name: gpio6,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio6].
FunctionUart: Gp6Uart1Cts,
/// SPI Function alias for pin [crate::Pins::gpio6].
FunctionSpi: Gp6Spi0Sck,
/// I2C Function alias for pin [crate::Pins::gpio6].
FunctionI2C: Gp6I2C1Sda,
/// PWM Function alias for pin [crate::Pins::gpio6].
FunctionPwm: Gp6Pwm3A,
/// PIO0 Function alias for pin [crate::Pins::gpio6].
FunctionPio0: Gp6Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio6].
FunctionPio1: Gp6Pio1
}
},
/// GPIO 7 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI0 TX` | [crate::Gp7Spi0Tx] |
/// | `UART1 RTS` | [crate::Gp7Uart1Rts] |
/// | `I2C1 SCL` | [crate::Gp7I2C1Scl] |
/// | `PWM3 B` | [crate::Gp7Pwm3B] |
/// | `PIO0` | [crate::Gp7Pio0] |
/// | `PIO1` | [crate::Gp7Pio1] |
Gpio7 {
name: gpio7,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio7].
FunctionUart: Gp7Uart1Rts,
/// SPI Function alias for pin [crate::Pins::gpio7].
FunctionSpi: Gp7Spi0Tx,
/// I2C Function alias for pin [crate::Pins::gpio7].
FunctionI2C: Gp7I2C1Scl,
/// PWM Function alias for pin [crate::Pins::gpio7].
FunctionPwm: Gp7Pwm3B,
/// PIO0 Function alias for pin [crate::Pins::gpio7].
FunctionPio0: Gp7Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio7].
FunctionPio1: Gp7Pio1
}
},
/// GPIO 18 is red LED, active low
Gpio18 {
name: led_red
},
/// GPIO 19 is green LED, active low
Gpio19 {
name: led_green
},
/// GPIO 20 is blue LED, active low
Gpio20 {
name: led_blue
},
/// GPIO 23 is connected to bootsel button, active low
Gpio23 {
name: bootsel
},
/// GPIO 26 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI1 SCK` | [crate::Gp26Spi1Sck] |
/// | `UART1 CTS` | [crate::Gp26Uart1Cts] |
/// | `I2C1 SDA` | [crate::Gp26I2C1Sda] |
/// | `PWM5 A` | [crate::Gp26Pwm5A] |
/// | `PIO0` | [crate::Gp26Pio0] |
/// | `PIO1` | [crate::Gp26Pio1] |
Gpio26 {
name: gpio26,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio26].
FunctionUart: Gp26Uart1Cts,
/// SPI Function alias for pin [crate::Pins::gpio26].
FunctionSpi: Gp26Spi1Sck,
/// I2C Function alias for pin [crate::Pins::gpio26].
FunctionI2C: Gp26I2C1Sda,
/// PWM Function alias for pin [crate::Pins::gpio26].
FunctionPwm: Gp26Pwm5A,
/// PIO0 Function alias for pin [crate::Pins::gpio26].
FunctionPio0: Gp26Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio26].
FunctionPio1: Gp26Pio1
}
},
/// GPIO 27 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI1 TX` | [crate::Gp27Spi1Tx] |
/// | `UART1 RTS` | [crate::Gp27Uart1Rts] |
/// | `I2C1 SCL` | [crate::Gp27I2C1Scl] |
/// | `PWM5 B` | [crate::Gp27Pwm5B] |
/// | `PIO0` | [crate::Gp27Pio0] |
/// | `PIO1` | [crate::Gp27Pio1] |
Gpio27 {
name: gpio27,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio27].
FunctionUart: Gp27Uart1Rts,
/// SPI Function alias for pin [crate::Pins::gpio27].
FunctionSpi: Gp27Spi1Tx,
/// I2C Function alias for pin [crate::Pins::gpio27].
FunctionI2C: Gp27I2C1Scl,
/// PWM Function alias for pin [crate::Pins::gpio27].
FunctionPwm: Gp27Pwm5B,
/// PIO0 Function alias for pin [crate::Pins::gpio27].
FunctionPio0: Gp27Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio27].
FunctionPio1: Gp27Pio1
}
},
/// GPIO 28 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI1 RX` | [crate::Gp28Spi1Rx] |
/// | `UART0 TX` | [crate::Gp28Uart0Tx] |
/// | `I2C0 SDA` | [crate::Gp28I2C0Sda] |
/// | `PWM6 A` | [crate::Gp28Pwm6A] |
/// | `PIO0` | [crate::Gp28Pio0] |
/// | `PIO1` | [crate::Gp28Pio1] |
Gpio28 {
name: gpio28,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio28].
FunctionUart: Gp28Uart0Tx,
/// SPI Function alias for pin [crate::Pins::gpio28].
FunctionSpi: Gp28Spi1Rx,
/// I2C Function alias for pin [crate::Pins::gpio28].
FunctionI2C: Gp28I2C0Sda,
/// PWM Function alias for pin [crate::Pins::gpio28].
FunctionPwm: Gp28Pwm6A,
/// PIO0 Function alias for pin [crate::Pins::gpio28].
FunctionPio0: Gp28Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio28].
FunctionPio1: Gp28Pio1
}
},
/// GPIO 29 supports following functions:
///
/// | Function | Alias with applied function |
/// |--------------|-----------------------------|
/// | `SPI1 CSn` | [crate::Gp29Spi1Csn] |
/// | `UART0 RX` | [crate::Gp29Uart0Rx] |
/// | `I2C0 SCL` | [crate::Gp29I2C0Scl] |
/// | `PWM6 B` | [crate::Gp29Pwm6B] |
/// | `PIO0` | [crate::Gp29Pio0] |
/// | `PIO1` | [crate::Gp29Pio1] |
Gpio29 {
name: gpio29,
aliases: {
/// UART Function alias for pin [crate::Pins::gpio28].
FunctionUart: Gp29Uart0Rx,
/// SPI Function alias for pin [crate::Pins::gpio28].
FunctionSpi: Gp29Spi1Csn,
/// I2C Function alias for pin [crate::Pins::gpio28].
FunctionI2C: Gp29I2C0Scl,
/// PWM Function alias for pin [crate::Pins::gpio28].
FunctionPwm: Gp29Pwm6B,
/// PIO0 Function alias for pin [crate::Pins::gpio28].
FunctionPio0: Gp29Pio0,
/// PIO1 Function alias for pin [crate::Pins::gpio28].
FunctionPio1: Gp29Pio1
}
},
);
pub const XOSC_CRYSTAL_FREQ: u32 = 12_000_000;