Move examples to a package of their own (#16)

* Move examples to a package of their own

* cargo +nightly fmt

* Add missing safety doc

* cargo clippy examples

* fmt again

---------

Co-authored-by: Felipe Balbi <[email protected]>

1 files changed, 66 insertions, 0 deletions

diff --git a/examples/src/bin/uart_interrupt.rs b/examples/src/bin/uart_interrupt.rs
new file mode 100644
index 000000000..100588727
--- /dev/null
+++ b/examples/src/bin/uart_interrupt.rs
@@ -0,0 +1,66 @@
+#![no_std]
+#![no_main]
+
+use embassy_executor::Spawner;
+use embassy_mcxa::bind_interrupts;
+use embassy_mcxa_examples::init_uart2;
+use hal::interrupt::typelevel::Handler;
+use hal::uart;
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
+
+// Bind LPUART2 interrupt to our handler
+bind_interrupts!(struct Irqs {
+    LPUART2 => hal::uart::UartInterruptHandler;
+});
+
+#[used]
+#[no_mangle]
+static KEEP_LPUART2: unsafe extern "C" fn() = LPUART2;
+
+// Wrapper function for the interrupt handler
+unsafe extern "C" fn lpuart2_handler() {
+    hal::uart::UartInterruptHandler::on_interrupt();
+}
+
+#[embassy_executor::main]
+async fn main(_spawner: Spawner) {
+    let _p = hal::init(hal::config::Config::default());
+
+    // Enable/clock UART2 before touching its registers
+    unsafe {
+        init_uart2(hal::pac());
+    }
+    let src = unsafe { hal::clocks::uart2_src_hz(hal::pac()) };
+    let uart = uart::Uart::<uart::Lpuart2>::new(_p.LPUART2, uart::Config::new(src));
+
+    // Configure LPUART2 interrupt for UART operation BEFORE any UART usage
+    hal::interrupt::LPUART2.configure_for_uart(hal::interrupt::Priority::from(3));
+
+    // Manually install the interrupt handler and enable RX IRQs in the peripheral
+    unsafe {
+        hal::interrupt::LPUART2.install_handler(lpuart2_handler);
+        // Enable RX interrupts so the handler actually fires on incoming bytes
+        uart.enable_rx_interrupts();
+    }
+
+    // Print welcome message
+    uart.write_str_blocking("UART interrupt echo demo starting...\r\n");
+    uart.write_str_blocking("Type characters to echo them back.\r\n");
+
+    // Log using defmt if enabled
+    defmt::info!("UART interrupt echo demo starting...");
+
+    loop {
+        // Check if we have received any data
+        if uart.rx_data_available() {
+            if let Some(byte) = uart.try_read_byte() {
+                // Echo it back
+                uart.write_byte(byte);
+                uart.write_str_blocking(" (received)\r\n");
+            }
+        } else {
+            // No data available, wait a bit before checking again
+            cortex_m::asm::delay(12_000_000); // ~1 second at 12MHz
+        }
+    }
+}