From 739e5861c2e47db251725163fcd91cd822cf97b7 Mon Sep 17 00:00:00 2001 From: Ulf Lilleengen Date: Sat, 18 May 2024 10:17:03 +0200 Subject: convert from antora to asciidoctor --- docs/examples/layer-by-layer/.cargo/config.toml | 14 ++++ docs/examples/layer-by-layer/Cargo.toml | 21 +++++ .../layer-by-layer/blinky-async/Cargo.toml | 15 ++++ .../layer-by-layer/blinky-async/src/main.rs | 23 ++++++ docs/examples/layer-by-layer/blinky-hal/Cargo.toml | 14 ++++ .../examples/layer-by-layer/blinky-hal/src/main.rs | 21 +++++ docs/examples/layer-by-layer/blinky-irq/Cargo.toml | 14 ++++ .../examples/layer-by-layer/blinky-irq/src/main.rs | 93 ++++++++++++++++++++++ docs/examples/layer-by-layer/blinky-pac/Cargo.toml | 14 ++++ .../examples/layer-by-layer/blinky-pac/src/main.rs | 53 ++++++++++++ 10 files changed, 282 insertions(+) create mode 100644 docs/examples/layer-by-layer/.cargo/config.toml create mode 100644 docs/examples/layer-by-layer/Cargo.toml create mode 100644 docs/examples/layer-by-layer/blinky-async/Cargo.toml create mode 100644 docs/examples/layer-by-layer/blinky-async/src/main.rs create mode 100644 docs/examples/layer-by-layer/blinky-hal/Cargo.toml create mode 100644 docs/examples/layer-by-layer/blinky-hal/src/main.rs create mode 100644 docs/examples/layer-by-layer/blinky-irq/Cargo.toml create mode 100644 docs/examples/layer-by-layer/blinky-irq/src/main.rs create mode 100644 docs/examples/layer-by-layer/blinky-pac/Cargo.toml create mode 100644 docs/examples/layer-by-layer/blinky-pac/src/main.rs (limited to 'docs/examples/layer-by-layer') diff --git a/docs/examples/layer-by-layer/.cargo/config.toml b/docs/examples/layer-by-layer/.cargo/config.toml new file mode 100644 index 000000000..3012f05dc --- /dev/null +++ b/docs/examples/layer-by-layer/.cargo/config.toml @@ -0,0 +1,14 @@ +[target.'cfg(all(target_arch = "arm", target_os = "none"))'] +runner = "probe-run --chip STM32L475VG" + +rustflags = [ + "-C", "link-arg=--nmagic", + "-C", "link-arg=-Tlink.x", + "-C", "link-arg=-Tdefmt.x", +] + +[build] +target = "thumbv7em-none-eabihf" + +[env] +DEFMT_LOG = "trace" diff --git a/docs/examples/layer-by-layer/Cargo.toml b/docs/examples/layer-by-layer/Cargo.toml new file mode 100644 index 000000000..943249a17 --- /dev/null +++ b/docs/examples/layer-by-layer/Cargo.toml @@ -0,0 +1,21 @@ +[workspace] +resolver = "2" +members = [ + "blinky-pac", + "blinky-hal", + "blinky-irq", + "blinky-async", +] + +[patch.crates-io] +embassy-executor = { path = "../../../../../embassy-executor" } +embassy-stm32 = { path = "../../../../../embassy-stm32" } + +[profile.release] +codegen-units = 1 +debug = 2 +debug-assertions = false +incremental = false +lto = "fat" +opt-level = 's' +overflow-checks = false diff --git a/docs/examples/layer-by-layer/blinky-async/Cargo.toml b/docs/examples/layer-by-layer/blinky-async/Cargo.toml new file mode 100644 index 000000000..64f7e8403 --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-async/Cargo.toml @@ -0,0 +1,15 @@ +[package] +name = "blinky-async" +version = "0.1.0" +edition = "2021" +license = "MIT OR Apache-2.0" + +[dependencies] +cortex-m = "0.7" +cortex-m-rt = "0.7" +embassy-stm32 = { version = "0.1.0", features = ["stm32l475vg", "memory-x", "exti"] } +embassy-executor = { version = "0.5.0", features = ["arch-cortex-m", "executor-thread"] } + +defmt = "0.3.0" +defmt-rtt = "0.3.0" +panic-probe = { version = "0.3.0", features = ["print-defmt"] } diff --git a/docs/examples/layer-by-layer/blinky-async/src/main.rs b/docs/examples/layer-by-layer/blinky-async/src/main.rs new file mode 100644 index 000000000..004602816 --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-async/src/main.rs @@ -0,0 +1,23 @@ +#![no_std] +#![no_main] + +use embassy_executor::Spawner; +use embassy_stm32::exti::ExtiInput; +use embassy_stm32::gpio::{Level, Output, Pull, Speed}; +use {defmt_rtt as _, panic_probe as _}; + +#[embassy_executor::main] +async fn main(_spawner: Spawner) { + let p = embassy_stm32::init(Default::default()); + let mut led = Output::new(p.PB14, Level::Low, Speed::VeryHigh); + let mut button = ExtiInput::new(p.PC13, p.EXTI13, Pull::Up); + + loop { + button.wait_for_any_edge().await; + if button.is_low() { + led.set_high(); + } else { + led.set_low(); + } + } +} diff --git a/docs/examples/layer-by-layer/blinky-hal/Cargo.toml b/docs/examples/layer-by-layer/blinky-hal/Cargo.toml new file mode 100644 index 000000000..c15de2db2 --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-hal/Cargo.toml @@ -0,0 +1,14 @@ +[package] +name = "blinky-hal" +version = "0.1.0" +edition = "2021" +license = "MIT OR Apache-2.0" + +[dependencies] +cortex-m = "0.7" +cortex-m-rt = "0.7" +embassy-stm32 = { version = "0.1.0", features = ["stm32l475vg", "memory-x"] } + +defmt = "0.3.0" +defmt-rtt = "0.3.0" +panic-probe = { version = "0.3.0", features = ["print-defmt"] } diff --git a/docs/examples/layer-by-layer/blinky-hal/src/main.rs b/docs/examples/layer-by-layer/blinky-hal/src/main.rs new file mode 100644 index 000000000..d0c9f4907 --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-hal/src/main.rs @@ -0,0 +1,21 @@ +#![no_std] +#![no_main] + +use cortex_m_rt::entry; +use embassy_stm32::gpio::{Input, Level, Output, Pull, Speed}; +use {defmt_rtt as _, panic_probe as _}; + +#[entry] +fn main() -> ! { + let p = embassy_stm32::init(Default::default()); + let mut led = Output::new(p.PB14, Level::High, Speed::VeryHigh); + let button = Input::new(p.PC13, Pull::Up); + + loop { + if button.is_low() { + led.set_high(); + } else { + led.set_low(); + } + } +} diff --git a/docs/examples/layer-by-layer/blinky-irq/Cargo.toml b/docs/examples/layer-by-layer/blinky-irq/Cargo.toml new file mode 100644 index 000000000..9733658b6 --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-irq/Cargo.toml @@ -0,0 +1,14 @@ +[package] +name = "blinky-irq" +version = "0.1.0" +edition = "2021" +license = "MIT OR Apache-2.0" + +[dependencies] +cortex-m = "0.7" +cortex-m-rt = { version = "0.7" } +embassy-stm32 = { version = "0.1.0", features = ["stm32l475vg", "memory-x", "unstable-pac"] } + +defmt = "0.3.0" +defmt-rtt = "0.3.0" +panic-probe = { version = "0.3.0", features = ["print-defmt"] } diff --git a/docs/examples/layer-by-layer/blinky-irq/src/main.rs b/docs/examples/layer-by-layer/blinky-irq/src/main.rs new file mode 100644 index 000000000..743c9d99b --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-irq/src/main.rs @@ -0,0 +1,93 @@ +#![no_std] +#![no_main] + +use core::cell::RefCell; + +use cortex_m::interrupt::Mutex; +use cortex_m::peripheral::NVIC; +use cortex_m_rt::entry; +use embassy_stm32::gpio::{Input, Level, Output, Pull, Speed}; +use embassy_stm32::{interrupt, pac}; +use {defmt_rtt as _, panic_probe as _}; + +static BUTTON: Mutex>>> = Mutex::new(RefCell::new(None)); +static LED: Mutex>>> = Mutex::new(RefCell::new(None)); + +#[entry] +fn main() -> ! { + let p = embassy_stm32::init(Default::default()); + let led = Output::new(p.PB14, Level::Low, Speed::Low); + let mut button = Input::new(p.PC13, Pull::Up); + + cortex_m::interrupt::free(|cs| { + enable_interrupt(&mut button); + + LED.borrow(cs).borrow_mut().replace(led); + BUTTON.borrow(cs).borrow_mut().replace(button); + + unsafe { NVIC::unmask(pac::Interrupt::EXTI15_10) }; + }); + + loop { + cortex_m::asm::wfe(); + } +} + +#[interrupt] +fn EXTI15_10() { + cortex_m::interrupt::free(|cs| { + let mut button = BUTTON.borrow(cs).borrow_mut(); + let button = button.as_mut().unwrap(); + + let mut led = LED.borrow(cs).borrow_mut(); + let led = led.as_mut().unwrap(); + if check_interrupt(button) { + if button.is_low() { + led.set_high(); + } else { + led.set_low(); + } + } + clear_interrupt(button); + }); +} +// +// +// +// +// +// +// "Hidden" HAL-like methods for doing interrupts with embassy. Hardcode pin just to give audience an idea of what it looks like + +const PORT: u8 = 2; +const PIN: usize = 13; +fn check_interrupt(_pin: &mut Input<'static>) -> bool { + let exti = pac::EXTI; + let pin = PIN; + let lines = exti.pr(0).read(); + lines.line(pin) +} + +fn clear_interrupt(_pin: &mut Input<'static>) { + let exti = pac::EXTI; + let pin = PIN; + let mut lines = exti.pr(0).read(); + lines.set_line(pin, true); + exti.pr(0).write_value(lines); +} + +fn enable_interrupt(_pin: &mut Input<'static>) { + cortex_m::interrupt::free(|_| { + let rcc = pac::RCC; + rcc.apb2enr().modify(|w| w.set_syscfgen(true)); + + let port = PORT; + let pin = PIN; + let syscfg = pac::SYSCFG; + let exti = pac::EXTI; + syscfg.exticr(pin / 4).modify(|w| w.set_exti(pin % 4, port)); + exti.imr(0).modify(|w| w.set_line(pin, true)); + exti.rtsr(0).modify(|w| w.set_line(pin, true)); + exti.ftsr(0).modify(|w| w.set_line(pin, true)); + }); +} diff --git a/docs/examples/layer-by-layer/blinky-pac/Cargo.toml b/docs/examples/layer-by-layer/blinky-pac/Cargo.toml new file mode 100644 index 000000000..f872b94cb --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-pac/Cargo.toml @@ -0,0 +1,14 @@ +[package] +name = "blinky-pac" +version = "0.1.0" +edition = "2021" +license = "MIT OR Apache-2.0" + +[dependencies] +cortex-m = "0.7" +cortex-m-rt = "0.7" +stm32-metapac = { version = "1", features = ["stm32l475vg", "memory-x"] } + +defmt = "0.3.0" +defmt-rtt = "0.3.0" +panic-probe = { version = "0.3.0", features = ["print-defmt"] } diff --git a/docs/examples/layer-by-layer/blinky-pac/src/main.rs b/docs/examples/layer-by-layer/blinky-pac/src/main.rs new file mode 100644 index 000000000..990d46cb6 --- /dev/null +++ b/docs/examples/layer-by-layer/blinky-pac/src/main.rs @@ -0,0 +1,53 @@ +#![no_std] +#![no_main] + +use pac::gpio::vals; +use {defmt_rtt as _, panic_probe as _, stm32_metapac as pac}; + +#[cortex_m_rt::entry] +fn main() -> ! { + // Enable GPIO clock + let rcc = pac::RCC; + unsafe { + rcc.ahb2enr().modify(|w| { + w.set_gpioben(true); + w.set_gpiocen(true); + }); + + rcc.ahb2rstr().modify(|w| { + w.set_gpiobrst(true); + w.set_gpiocrst(true); + w.set_gpiobrst(false); + w.set_gpiocrst(false); + }); + } + + // Setup button + let gpioc = pac::GPIOC; + const BUTTON_PIN: usize = 13; + unsafe { + gpioc.pupdr().modify(|w| w.set_pupdr(BUTTON_PIN, vals::Pupdr::PULLUP)); + gpioc.otyper().modify(|w| w.set_ot(BUTTON_PIN, vals::Ot::PUSHPULL)); + gpioc.moder().modify(|w| w.set_moder(BUTTON_PIN, vals::Moder::INPUT)); + } + + // Setup LED + let gpiob = pac::GPIOB; + const LED_PIN: usize = 14; + unsafe { + gpiob.pupdr().modify(|w| w.set_pupdr(LED_PIN, vals::Pupdr::FLOATING)); + gpiob.otyper().modify(|w| w.set_ot(LED_PIN, vals::Ot::PUSHPULL)); + gpiob.moder().modify(|w| w.set_moder(LED_PIN, vals::Moder::OUTPUT)); + } + + // Main loop + loop { + unsafe { + if gpioc.idr().read().idr(BUTTON_PIN) == vals::Idr::LOW { + gpiob.bsrr().write(|w| w.set_bs(LED_PIN, true)); + } else { + gpiob.bsrr().write(|w| w.set_br(LED_PIN, true)); + } + } + } +} -- cgit