rp-hal-boards/rp2040-hal/examples/spi.rs

127 lines
3.7 KiB
Rust
Raw Normal View History

2021-09-28 03:37:20 +10:00
//! # SPI Example
//!
//! This application demonstrates how to use the SPI Driver to talk to a remote
//! SPI device.
//!
//!
//! It may need to be adapted to your particular board layout and/or pin
//! assignment.
//!
//! See the `Cargo.toml` file for Copyright and licence details.
2021-09-19 22:33:36 +10:00
#![no_std]
#![no_main]
2021-09-28 03:37:20 +10:00
// The macro for our start-up function
2021-09-19 22:33:36 +10:00
use cortex_m_rt::entry;
2021-09-28 03:37:20 +10:00
// Ensure we halt the program on panic (if we don't mention this crate it won't
// be linked)
2021-09-19 22:33:36 +10:00
use panic_halt as _;
2021-09-28 03:37:20 +10:00
// Alias for our HAL crate
2021-09-19 22:33:36 +10:00
use rp2040_hal as hal;
2021-09-28 03:37:20 +10:00
// Traits we need
use cortex_m::prelude::*;
use embedded_time::rate::Extensions;
use rp2040_hal::clocks::Clock;
// A shorter alias for the Peripheral Access Crate, which provides low-level
// register access
use hal::pac;
/// 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.
2021-09-19 22:33:36 +10:00
#[link_section = ".boot2"]
#[used]
pub static BOOT2: [u8; 256] = rp2040_boot2::BOOT_LOADER;
2021-09-28 03:37:20 +10:00
/// External high-speed crystal on the Raspberry Pi Pico board is 12 MHz. Adjust
/// if your board has a different frequency
const XTAL_FREQ_HZ: u32 = 12_000_000u32;
2021-09-19 22:33:36 +10:00
2021-09-28 03:37:20 +10:00
/// Entry point to our bare-metal application.
///
/// The `#[entry]` macro ensures the Cortex-M start-up code calls this function
/// as soon as all global variables are initialised.
///
/// The function configures the RP2040 peripherals, then performs some example
/// SPI transactions, then goes to sleep.
2021-09-19 22:33:36 +10:00
#[entry]
fn main() -> ! {
2021-09-28 03:37:20 +10:00
// Grab our singleton objects
2021-09-19 22:33:36 +10:00
let mut pac = pac::Peripherals::take().unwrap();
2021-09-28 03:37:20 +10:00
// Set up the watchdog driver - needed by the clock setup code
let mut watchdog = hal::watchdog::Watchdog::new(pac.WATCHDOG);
// Configure the clocks
let clocks = hal::clocks::init_clocks_and_plls(
XTAL_FREQ_HZ,
pac.XOSC,
pac.CLOCKS,
pac.PLL_SYS,
pac.PLL_USB,
&mut pac.RESETS,
&mut watchdog,
)
.ok()
.unwrap();
// The single-cycle I/O block controls our GPIO pins
let sio = hal::sio::Sio::new(pac.SIO);
// Set the pins to their default state
2021-09-19 22:33:36 +10:00
let pins = hal::gpio::Pins::new(
pac.IO_BANK0,
pac.PADS_BANK0,
sio.gpio_bank0,
&mut pac.RESETS,
);
// These are implicitly used by the spi driver if they are in the correct mode
2021-09-28 03:37:20 +10:00
let _spi_sclk = pins.gpio6.into_mode::<hal::gpio::FunctionSpi>();
let _spi_mosi = pins.gpio7.into_mode::<hal::gpio::FunctionSpi>();
let _spi_miso = pins.gpio4.into_mode::<hal::gpio::FunctionSpi>();
let spi = hal::spi::Spi::<_, _, 8>::new(pac.SPI0);
// Exchange the uninitialised SPI driver for an initialised one
let mut spi = spi.init(
2021-09-19 22:33:36 +10:00
&mut pac.RESETS,
2021-09-28 03:37:20 +10:00
clocks.peripheral_clock.freq(),
2021-09-19 22:33:36 +10:00
16_000_000u32.Hz(),
2021-09-28 03:37:20 +10:00
&embedded_hal::spi::MODE_0,
2021-09-19 22:33:36 +10:00
);
// Write out 0, ignore return value
2021-09-28 03:37:20 +10:00
if let Ok(_) = spi.write(&[0]) {
// SPI write was succesful
2021-09-19 22:33:36 +10:00
};
// write 50, then check the return
let send_success = spi.send(50);
match send_success {
Ok(_) => {
// We succeeded, check the read value
2021-09-28 03:37:20 +10:00
if let Ok(_x) = spi.read() {
// We got back `x` in exchange for the 0x50 we sent.
2021-09-19 22:33:36 +10:00
};
}
Err(_) => todo!(),
}
2021-09-28 03:37:20 +10:00
// Do a read+write at the same time. Data in `buffer` will be replaced with
// the data read from the SPI device.
let mut buffer: [u8; 4] = [1, 2, 3, 4];
let transfer_success = spi.transfer(&mut buffer);
2021-09-19 22:33:36 +10:00
#[allow(clippy::single_match)]
match transfer_success {
Ok(_) => {} // Handle success
Err(_) => {} // handle errors
};
#[allow(clippy::empty_loop)]
loop {}
}