Merge remote-tracking branch 'origin/main' into james/impl-clocks

18 files changed, 767 insertions, 107 deletions

diff --git a/examples/.cargo/config.toml b/examples/.cargo/config.toml
new file mode 100644
index 000000000..ecb11be64
--- /dev/null
+++ b/examples/.cargo/config.toml
@@ -0,0 +1,17 @@
+[target.thumbv8m.main-none-eabihf]
+runner = 'probe-rs run --chip MCXA276 --preverify --verify'
+
+rustflags = [
+  "-C", "linker=flip-link",
+  "-C", "link-arg=-Tlink.x",
+  "-C", "link-arg=-Tdefmt.x",
+  # This is needed if your flash or ram addresses are not aligned to 0x10000 in memory.x
+  # See https://github.com/rust-embedded/cortex-m-quickstart/pull/95
+  "-C", "link-arg=--nmagic",
+]
+
+[build]
+target = "thumbv8m.main-none-eabihf" # Cortex-M33
+
+[env]
+DEFMT_LOG = "trace"
diff --git a/examples/.gitignore b/examples/.gitignore
new file mode 100644
index 000000000..2f7896d1d
--- /dev/null
+++ b/examples/.gitignore
@@ -0,0 +1 @@
+target/
diff --git a/examples/Cargo.lock b/examples/Cargo.lock
new file mode 100644
index 000000000..b774aff97
--- /dev/null
+++ b/examples/Cargo.lock
@@ -0,0 +1,625 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "bare-metal"
+version = "0.2.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5deb64efa5bd81e31fcd1938615a6d98c82eafcbcd787162b6f63b91d6bac5b3"
+dependencies = [
+ "rustc_version",
+]
+
+[[package]]
+name = "bitfield"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "46afbd2983a5d5a7bd740ccb198caf5b82f45c40c09c0eed36052d91cb92e719"
+
+[[package]]
+name = "bitflags"
+version = "1.3.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
+
+[[package]]
+name = "byteorder"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "cortex-m"
+version = "0.7.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ec610d8f49840a5b376c69663b6369e71f4b34484b9b2eb29fb918d92516cb9"
+dependencies = [
+ "bare-metal",
+ "bitfield",
+ "critical-section",
+ "embedded-hal 0.2.7",
+ "volatile-register",
+]
+
+[[package]]
+name = "cortex-m-rt"
+version = "0.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "801d4dec46b34c299ccf6b036717ae0fce602faa4f4fe816d9013b9a7c9f5ba6"
+dependencies = [
+ "cortex-m-rt-macros",
+]
+
+[[package]]
+name = "cortex-m-rt-macros"
+version = "0.7.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e37549a379a9e0e6e576fd208ee60394ccb8be963889eebba3ffe0980364f472"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "critical-section"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "790eea4361631c5e7d22598ecd5723ff611904e3344ce8720784c93e3d83d40b"
+
+[[package]]
+name = "darling"
+version = "0.20.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc7f46116c46ff9ab3eb1597a45688b6715c6e628b5c133e288e709a29bcb4ee"
+dependencies = [
+ "darling_core",
+ "darling_macro",
+]
+
+[[package]]
+name = "darling_core"
+version = "0.20.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0d00b9596d185e565c2207a0b01f8bd1a135483d02d9b7b0a54b11da8d53412e"
+dependencies = [
+ "fnv",
+ "ident_case",
+ "proc-macro2",
+ "quote",
+ "strsim",
+ "syn",
+]
+
+[[package]]
+name = "darling_macro"
+version = "0.20.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fc34b93ccb385b40dc71c6fceac4b2ad23662c7eeb248cf10d529b7e055b6ead"
+dependencies = [
+ "darling_core",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "defmt"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "548d977b6da32fa1d1fda2876453da1e7df63ad0304c8b3dae4dbe7b96f39b78"
+dependencies = [
+ "bitflags",
+ "defmt-macros",
+]
+
+[[package]]
+name = "defmt-macros"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d4fc12a85bcf441cfe44344c4b72d58493178ce635338a3f3b78943aceb258e"
+dependencies = [
+ "defmt-parser",
+ "proc-macro-error2",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "defmt-parser"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10d60334b3b2e7c9d91ef8150abfb6fa4c1c39ebbcf4a81c2e346aad939fee3e"
+dependencies = [
+ "thiserror",
+]
+
+[[package]]
+name = "defmt-rtt"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93d5a25c99d89c40f5676bec8cefe0614f17f0f40e916f98e345dae941807f9e"
+dependencies = [
+ "critical-section",
+ "defmt",
+]
+
+[[package]]
+name = "document-features"
+version = "0.2.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d4b8a88685455ed29a21542a33abd9cb6510b6b129abadabdcef0f4c55bc8f61"
+dependencies = [
+ "litrs",
+]
+
+[[package]]
+name = "embassy-embedded-hal"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "554e3e840696f54b4c9afcf28a0f24da431c927f4151040020416e7393d6d0d8"
+dependencies = [
+ "embassy-futures",
+ "embassy-hal-internal",
+ "embassy-sync",
+ "embedded-hal 0.2.7",
+ "embedded-hal 1.0.0",
+ "embedded-hal-async",
+ "embedded-storage",
+ "embedded-storage-async",
+ "nb 1.1.0",
+]
+
+[[package]]
+name = "embassy-executor"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "06070468370195e0e86f241c8e5004356d696590a678d47d6676795b2e439c6b"
+dependencies = [
+ "cortex-m",
+ "critical-section",
+ "document-features",
+ "embassy-executor-macros",
+ "embassy-executor-timer-queue",
+]
+
+[[package]]
+name = "embassy-executor-macros"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dfdddc3a04226828316bf31393b6903ee162238576b1584ee2669af215d55472"
+dependencies = [
+ "darling",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "embassy-executor-timer-queue"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2fc328bf943af66b80b98755db9106bf7e7471b0cf47dc8559cd9a6be504cc9c"
+
+[[package]]
+name = "embassy-futures"
+version = "0.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc2d050bdc5c21e0862a89256ed8029ae6c290a93aecefc73084b3002cdebb01"
+
+[[package]]
+name = "embassy-hal-internal"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "95285007a91b619dc9f26ea8f55452aa6c60f7115a4edc05085cd2bd3127cd7a"
+dependencies = [
+ "cortex-m",
+ "critical-section",
+ "num-traits",
+]
+
+[[package]]
+name = "embassy-mcxa"
+version = "0.1.0"
+dependencies = [
+ "cortex-m",
+ "cortex-m-rt",
+ "critical-section",
+ "defmt",
+ "embassy-embedded-hal",
+ "embassy-executor",
+ "embassy-hal-internal",
+ "embassy-sync",
+ "embassy-time",
+ "embassy-time-driver",
+ "embedded-hal 0.2.7",
+ "embedded-hal 1.0.0",
+ "embedded-hal-async",
+ "embedded-hal-nb",
+ "embedded-io",
+ "embedded-io-async",
+ "heapless 0.8.0",
+ "mcxa-pac",
+ "nb 1.1.0",
+ "paste",
+]
+
+[[package]]
+name = "embassy-mcxa-examples"
+version = "0.1.0"
+dependencies = [
+ "cortex-m",
+ "cortex-m-rt",
+ "critical-section",
+ "defmt",
+ "defmt-rtt",
+ "embassy-embedded-hal",
+ "embassy-executor",
+ "embassy-mcxa",
+ "embassy-sync",
+ "embassy-time",
+ "embassy-time-driver",
+ "embedded-io-async",
+ "heapless 0.9.2",
+ "panic-probe",
+]
+
+[[package]]
+name = "embassy-sync"
+version = "0.7.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73974a3edbd0bd286759b3d483540f0ebef705919a5f56f4fc7709066f71689b"
+dependencies = [
+ "cfg-if",
+ "critical-section",
+ "embedded-io-async",
+ "futures-core",
+ "futures-sink",
+ "heapless 0.8.0",
+]
+
+[[package]]
+name = "embassy-time"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f4fa65b9284d974dad7a23bb72835c4ec85c0b540d86af7fc4098c88cff51d65"
+dependencies = [
+ "cfg-if",
+ "critical-section",
+ "document-features",
+ "embassy-time-driver",
+ "embedded-hal 0.2.7",
+ "embedded-hal 1.0.0",
+ "embedded-hal-async",
+ "futures-core",
+]
+
+[[package]]
+name = "embassy-time-driver"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a0a244c7dc22c8d0289379c8d8830cae06bb93d8f990194d0de5efb3b5ae7ba6"
+dependencies = [
+ "document-features",
+]
+
+[[package]]
+name = "embedded-hal"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "35949884794ad573cf46071e41c9b60efb0cb311e3ca01f7af807af1debc66ff"
+dependencies = [
+ "nb 0.1.3",
+ "void",
+]
+
+[[package]]
+name = "embedded-hal"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "361a90feb7004eca4019fb28352a9465666b24f840f5c3cddf0ff13920590b89"
+
+[[package]]
+name = "embedded-hal-async"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c4c685bbef7fe13c3c6dd4da26841ed3980ef33e841cddfa15ce8a8fb3f1884"
+dependencies = [
+ "embedded-hal 1.0.0",
+]
+
+[[package]]
+name = "embedded-hal-nb"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fba4268c14288c828995299e59b12babdbe170f6c6d73731af1b4648142e8605"
+dependencies = [
+ "embedded-hal 1.0.0",
+ "nb 1.1.0",
+]
+
+[[package]]
+name = "embedded-io"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "edd0f118536f44f5ccd48bcb8b111bdc3de888b58c74639dfb034a357d0f206d"
+
+[[package]]
+name = "embedded-io-async"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ff09972d4073aa8c299395be75161d582e7629cd663171d62af73c8d50dba3f"
+dependencies = [
+ "embedded-io",
+]
+
+[[package]]
+name = "embedded-storage"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a21dea9854beb860f3062d10228ce9b976da520a73474aed3171ec276bc0c032"
+
+[[package]]
+name = "embedded-storage-async"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1763775e2323b7d5f0aa6090657f5e21cfa02ede71f5dc40eead06d64dcd15cc"
+dependencies = [
+ "embedded-storage",
+]
+
+[[package]]
+name = "fnv"
+version = "1.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
+
+[[package]]
+name = "futures-core"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05f29059c0c2090612e8d742178b0580d2dc940c837851ad723096f87af6663e"
+
+[[package]]
+name = "futures-sink"
+version = "0.3.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e575fab7d1e0dcb8d0c7bcf9a63ee213816ab51902e6d244a95819acacf1d4f7"
+
+[[package]]
+name = "hash32"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47d60b12902ba28e2730cd37e95b8c9223af2808df9e902d4df49588d1470606"
+dependencies = [
+ "byteorder",
+]
+
+[[package]]
+name = "heapless"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0bfb9eb618601c89945a70e254898da93b13be0388091d42117462b265bb3fad"
+dependencies = [
+ "hash32",
+ "stable_deref_trait",
+]
+
+[[package]]
+name = "heapless"
+version = "0.9.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2af2455f757db2b292a9b1768c4b70186d443bcb3b316252d6b540aec1cd89ed"
+dependencies = [
+ "hash32",
+ "stable_deref_trait",
+]
+
+[[package]]
+name = "ident_case"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
+
+[[package]]
+name = "litrs"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11d3d7f243d5c5a8b9bb5d6dd2b1602c0cb0b9db1621bafc7ed66e35ff9fe092"
+
+[[package]]
+name = "mcxa-pac"
+version = "0.1.0"
+source = "git+https://github.com/OpenDevicePartnership/mcxa-pac?rev=3ab4c868f75a9240bb8fdce24982d34f2273aabf#3ab4c868f75a9240bb8fdce24982d34f2273aabf"
+dependencies = [
+ "cortex-m",
+ "cortex-m-rt",
+ "vcell",
+]
+
+[[package]]
+name = "nb"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "801d31da0513b6ec5214e9bf433a77966320625a37860f910be265be6e18d06f"
+dependencies = [
+ "nb 1.1.0",
+]
+
+[[package]]
+name = "nb"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8d5439c4ad607c3c23abf66de8c8bf57ba8adcd1f129e699851a6e43935d339d"
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "panic-probe"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fd402d00b0fb94c5aee000029204a46884b1262e0c443f166d86d2c0747e1a1a"
+dependencies = [
+ "cortex-m",
+ "defmt",
+]
+
+[[package]]
+name = "paste"
+version = "1.0.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
+
+[[package]]
+name = "proc-macro-error-attr2"
+version = "2.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96de42df36bb9bba5542fe9f1a054b8cc87e172759a1868aa05c1f3acc89dfc5"
+dependencies = [
+ "proc-macro2",
+ "quote",
+]
+
+[[package]]
+name = "proc-macro-error2"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11ec05c52be0a07b08061f7dd003e7d7092e0472bc731b4af7bb1ef876109802"
+dependencies = [
+ "proc-macro-error-attr2",
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.103"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5ee95bc4ef87b8d5ba32e8b7714ccc834865276eab0aed5c9958d00ec45f49e8"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.42"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a338cc41d27e6cc6dce6cefc13a0729dfbb81c262b1f519331575dd80ef3067f"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rustc_version"
+version = "0.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "138e3e0acb6c9fb258b19b67cb8abd63c00679d2851805ea151465464fe9030a"
+dependencies = [
+ "semver",
+]
+
+[[package]]
+name = "semver"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1d7eb9ef2c18661902cc47e535f9bc51b78acd254da71d375c2f6720d9a40403"
+dependencies = [
+ "semver-parser",
+]
+
+[[package]]
+name = "semver-parser"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "388a1df253eca08550bef6c72392cfe7c30914bf41df5269b68cbd6ff8f570a3"
+
+[[package]]
+name = "stable_deref_trait"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
+
+[[package]]
+name = "strsim"
+version = "0.11.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
+
+[[package]]
+name = "syn"
+version = "2.0.110"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a99801b5bd34ede4cf3fc688c5919368fea4e4814a4664359503e6015b280aea"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "thiserror"
+version = "2.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f63587ca0f12b72a0600bcba1d40081f830876000bb46dd2337a3051618f4fc8"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "2.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ff15c8ecd7de3849db632e14d18d2571fa09dfc5ed93479bc4485c7a517c913"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9312f7c4f6ff9069b165498234ce8be658059c6728633667c526e27dc2cf1df5"
+
+[[package]]
+name = "vcell"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77439c1b53d2303b20d9459b1ade71a83c716e3f9c34f3228c00e6f185d6c002"
+
+[[package]]
+name = "void"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a02e4885ed3bc0f2de90ea6dd45ebcbb66dacffe03547fadbb0eeae2770887d"
+
+[[package]]
+name = "volatile-register"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "de437e2a6208b014ab52972a27e59b33fa2920d3e00fe05026167a1c509d19cc"
+dependencies = [
+ "vcell",
+]
diff --git a/examples/Cargo.toml b/examples/Cargo.toml
new file mode 100644
index 000000000..6b100de42
--- /dev/null
+++ b/examples/Cargo.toml
@@ -0,0 +1,21 @@
+[package]
+name = "embassy-mcxa-examples"
+version = "0.1.0"
+edition = "2021"
+license = "MIT OR Apache-2.0"
+
+[dependencies]
+cortex-m = { version = "0.7", features = ["critical-section-single-core"] }
+cortex-m-rt = { version = "0.7", features = ["device"] }
+critical-section = "1.2.0"
+defmt = "1.0"
+defmt-rtt = "1.0"
+embassy-embedded-hal = "0.5.0"
+embassy-executor = { version = "0.9.0", features = ["arch-cortex-m", "executor-interrupt", "executor-thread"], default-features = false }
+embassy-mcxa = { path = "../", features = ["defmt", "rt", "unstable-pac"] }
+embassy-sync = "0.7.2"
+embassy-time = "0.5.0"
+embassy-time-driver = "0.2.1"
+embedded-io-async = "0.6.1"
+heapless = "0.9.2"
+panic-probe = { version = "1.0", features = ["print-defmt"] }
diff --git a/examples/build.rs b/examples/build.rs
new file mode 100644
index 000000000..f076bba9f
--- /dev/null
+++ b/examples/build.rs
@@ -0,0 +1,20 @@
+use std::env;
+use std::fs::File;
+use std::io::Write;
+use std::path::PathBuf;
+
+fn main() {
+    let out = &PathBuf::from(env::var_os("OUT_DIR").unwrap());
+
+    // Generate memory.x - put "FLASH" at start of RAM, RAM after "FLASH"
+    // cortex-m-rt expects FLASH for code, RAM for data/bss/stack
+    // Both are in RAM, but separated to satisfy cortex-m-rt's expectations
+    // MCXA256 has 128KB RAM total
+    File::create(out.join("memory.x"))
+        .unwrap()
+        .write_all(include_bytes!("memory.x"))
+        .unwrap();
+
+    println!("cargo:rustc-link-search={}", out.display());
+    println!("cargo:rerun-if-changed=memory.x");
+}
diff --git a/examples/memory.x b/examples/memory.x
new file mode 100644
index 000000000..f4263a412
--- /dev/null
+++ b/examples/memory.x
@@ -0,0 +1,5 @@
+MEMORY
+{
+    FLASH : ORIGIN = 0x20000000, LENGTH = 64K
+    RAM   : ORIGIN = 0x20010000, LENGTH = 64K
+}
diff --git a/examples/adc_interrupt.rs b/examples/src/bin/adc_interrupt.rs
index 536152539..be08ebf8c 100644
--- a/examples/adc_interrupt.rs
+++ b/examples/src/bin/adc_interrupt.rs
@@ -2,19 +2,16 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use embassy_mcxa276::clocks::periph_helpers::{AdcClockSel, Div4};
-use embassy_mcxa276::clocks::PoweredClock;
-use embassy_mcxa276::lpuart::{Config, Lpuart};
 use hal::adc::{LpadcConfig, TriggerPriorityPolicy};
-use mcxa_pac::adc1::cfg::{Pwrsel, Refsel};
-use mcxa_pac::adc1::cmdl1::{Adch, Mode};
-use mcxa_pac::adc1::ctrl::CalAvgs;
-use mcxa_pac::adc1::tctrl::Tcmd;
-use {embassy_mcxa276 as hal};
-mod common;
-
+use hal::clocks::periph_helpers::{AdcClockSel, Div4};
+use hal::clocks::PoweredClock;
+use hal::lpuart::{Config, Lpuart};
+use hal::pac::adc1::cfg::{Pwrsel, Refsel};
+use hal::pac::adc1::cmdl1::{Adch, Mode};
+use hal::pac::adc1::ctrl::CalAvgs;
+use hal::pac::adc1::tctrl::Tcmd;
 use hal::{bind_interrupts, InterruptExt};
-use {defmt_rtt as _, panic_probe as _};
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 bind_interrupts!(struct Irqs {
     ADC1 => hal::adc::AdcHandler;
@@ -38,7 +35,7 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        embassy_mcxa_examples::init_uart2(hal::pac());
     }
     let mut uart = Lpuart::new_blocking(
         p.LPUART2, // Peripheral
@@ -47,9 +44,10 @@ async fn main(_spawner: Spawner) {
         config,
     )
     .unwrap();
+    uart.write_str_blocking("\r\n=== ADC interrupt Example ===\r\n");
 
     unsafe {
-        common::init_adc(hal::pac());
+        embassy_mcxa_examples::init_adc(hal::pac());
     }
 
     let adc_config = LpadcConfig {
diff --git a/examples/adc_polling.rs b/examples/src/bin/adc_polling.rs
index 2fe4153db..723f1e044 100644
--- a/examples/adc_polling.rs
+++ b/examples/src/bin/adc_polling.rs
@@ -1,23 +1,20 @@
 #![no_std]
 #![no_main]
 
-use embassy_executor::Spawner;
-use embassy_mcxa276::clocks::periph_helpers::{AdcClockSel, Div4};
-use embassy_mcxa276::clocks::PoweredClock;
-use embassy_mcxa276::lpuart::{Config, Lpuart};
-use embassy_mcxa276 as hal;
-use hal::adc::{ConvResult, LpadcConfig, TriggerPriorityPolicy};
-use mcxa_pac::adc1::cfg::{Pwrsel, Refsel};
-use mcxa_pac::adc1::cmdl1::{Adch, Mode};
-use mcxa_pac::adc1::ctrl::CalAvgs;
-use mcxa_pac::adc1::tctrl::Tcmd;
-
-mod common;
-
 use core::fmt::Write;
 
+use embassy_executor::Spawner;
+use embassy_mcxa_examples::{init_adc, init_uart2};
+use hal::adc::{ConvResult, LpadcConfig, TriggerPriorityPolicy};
+use hal::clocks::periph_helpers::{AdcClockSel, Div4};
+use hal::clocks::PoweredClock;
+use hal::lpuart::{Config, Lpuart};
+use hal::pac::adc1::cfg::{Pwrsel, Refsel};
+use hal::pac::adc1::cmdl1::{Adch, Mode};
+use hal::pac::adc1::ctrl::CalAvgs;
+use hal::pac::adc1::tctrl::Tcmd;
 use heapless::String;
-use {defmt_rtt as _, panic_probe as _};
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 const G_LPADC_RESULT_SHIFT: u32 = 0;
 
@@ -26,7 +23,7 @@ async fn main(_spawner: Spawner) {
     let p = hal::init(hal::config::Config::default());
 
     unsafe {
-        common::init_uart2(hal::pac());
+        init_uart2(hal::pac());
     }
 
     // Create UART configuration
@@ -39,7 +36,7 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        init_uart2(hal::pac());
     }
     let mut uart = Lpuart::new_blocking(
         p.LPUART2, // Peripheral
@@ -49,10 +46,10 @@ async fn main(_spawner: Spawner) {
     )
     .unwrap();
 
-    uart.blocking_write(b"\r\n=== ADC polling Example ===\r\n").unwrap();
+    uart.write_str_blocking("\r\n=== ADC polling Example ===\r\n");
 
     unsafe {
-        common::init_adc(hal::pac());
+        init_adc(hal::pac());
     }
 
     let adc_config = LpadcConfig {
diff --git a/examples/blink.rs b/examples/src/bin/blink.rs
index 0f489abb9..ee59ac591 100644
--- a/examples/blink.rs
+++ b/examples/src/bin/blink.rs
@@ -2,15 +2,13 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use embassy_mcxa276 as hal;
+use embassy_mcxa as hal;
+use embassy_mcxa::bind_interrupts;
+use embassy_mcxa_examples::init_led;
 use embassy_time::{Duration, Timer};
 use hal::gpio::pins::PIO3_18;
 use hal::gpio::{Level, Output};
 
-mod common;
-
-use embassy_mcxa276::bind_interrupts;
-
 // Bind only OS_EVENT for timer interrupts
 bind_interrupts!(struct Irqs {
     OS_EVENT => hal::ostimer::time_driver::OsEventHandler;
@@ -24,9 +22,8 @@ static KEEP_OS_EVENT: unsafe extern "C" fn() = OS_EVENT;
 async fn main(_spawner: Spawner) {
     let _p = hal::init(hal::config::Config::default());
 
-    // Board-style init: enable LED GPIO/PORT clocks used by blink
     unsafe {
-        common::init_led(hal::pac());
+        init_led(hal::pac());
     }
 
     // Initialize embassy-time global driver backed by OSTIMER0
diff --git a/examples/hello.rs b/examples/src/bin/hello.rs
index dbb53fdcf..ff7afa01d 100644
--- a/examples/hello.rs
+++ b/examples/src/bin/hello.rs
@@ -2,11 +2,8 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use embassy_mcxa276::{self as hal, lpuart::{Blocking, Config, Lpuart}};
-
-mod common;
-
-use {defmt_rtt as _, panic_probe as _};
+use hal::lpuart::{Blocking, Config, Lpuart};
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 /// Simple helper to write a byte as hex to UART
 fn write_hex_byte(uart: &mut Lpuart<'_, Blocking>, byte: u8) {
@@ -31,7 +28,7 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        embassy_mcxa_examples::init_uart2(hal::pac());
     }
     let mut uart = Lpuart::new_blocking(
         p.LPUART2, // Peripheral
diff --git a/examples/lpuart_buffered.rs b/examples/src/bin/lpuart_buffered.rs
index 9e297ca67..e96ab7b81 100644
--- a/examples/lpuart_buffered.rs
+++ b/examples/src/bin/lpuart_buffered.rs
@@ -2,14 +2,13 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use embassy_mcxa276 as hal;
-use embassy_mcxa276::interrupt::typelevel::Handler;
-use embassy_mcxa276::lpuart::buffered::BufferedLpuart;
-use embassy_mcxa276::{bind_interrupts, lpuart};
+use embassy_mcxa as hal;
+use embassy_mcxa::interrupt::typelevel::Handler;
+use embassy_mcxa::lpuart::buffered::BufferedLpuart;
+use embassy_mcxa::{bind_interrupts, lpuart};
+use embassy_mcxa_examples::init_uart2;
 use embedded_io_async::{Read, Write};
 
-mod common;
-
 // Bind OS_EVENT for timers plus LPUART2 IRQ for the buffered driver
 bind_interrupts!(struct Irqs {
     LPUART2 => lpuart::buffered::BufferedInterruptHandler::<hal::peripherals::LPUART2>;
@@ -25,14 +24,14 @@ async fn main(_spawner: Spawner) {
     let p = hal::init(hal::config::Config::default());
 
     unsafe {
-        hal::interrupt::install_irq_handler(mcxa_pac::Interrupt::LPUART2, lpuart2_handler);
+        hal::interrupt::install_irq_handler(hal::pac::Interrupt::LPUART2, lpuart2_handler);
     }
 
     // Configure NVIC for LPUART2
     hal::interrupt::LPUART2.configure_for_uart(hal::interrupt::Priority::P3);
 
     unsafe {
-        common::init_uart2(hal::pac());
+        init_uart2(hal::pac());
     }
 
     // UART configuration (enable both TX and RX)
diff --git a/examples/lpuart_polling.rs b/examples/src/bin/lpuart_polling.rs
index c9630dca5..bdcfa0776 100644
--- a/examples/lpuart_polling.rs
+++ b/examples/src/bin/lpuart_polling.rs
@@ -2,12 +2,11 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use {defmt_rtt as _, embassy_mcxa276 as hal, panic_probe as _};
+use embassy_mcxa_examples::init_uart2;
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 use crate::hal::lpuart::{Config, Lpuart};
 
-mod common;
-
 #[embassy_executor::main]
 async fn main(_spawner: Spawner) {
     let p = hal::init(hal::config::Config::default());
@@ -16,7 +15,7 @@ async fn main(_spawner: Spawner) {
 
     // Board-level init for UART2 clocks and pins.
     unsafe {
-        common::init_uart2(hal::pac());
+        init_uart2(hal::pac());
     }
 
     // Create UART configuration
diff --git a/examples/ostimer_alarm.rs b/examples/src/bin/ostimer_alarm.rs
index f3a84d312..9e858b60b 100644
--- a/examples/ostimer_alarm.rs
+++ b/examples/src/bin/ostimer_alarm.rs
@@ -4,16 +4,12 @@
 use core::sync::atomic::{AtomicBool, Ordering};
 
 use embassy_executor::Spawner;
-use embassy_mcxa276 as hal;
-
-mod common;
-
-use embassy_mcxa276::{
-    bind_interrupts,
-    clocks::{periph_helpers::OstimerClockSel, PoweredClock},
-    lpuart::{Config, Lpuart},
-};
-use {defmt_rtt as _, panic_probe as _};
+use embassy_mcxa::bind_interrupts;
+use embassy_mcxa::clocks::periph_helpers::OstimerClockSel;
+use embassy_mcxa::clocks::PoweredClock;
+use embassy_mcxa::lpuart::{Config, Lpuart};
+use embassy_mcxa_examples::init_uart2;
+use {cortex_m, defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 // Bind only OS_EVENT, and retain the symbol explicitly so it can't be GC'ed.
 bind_interrupts!(struct Irqs {
@@ -46,7 +42,7 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        init_uart2(hal::pac());
     }
     let mut uart = Lpuart::new_blocking(
         p.LPUART2, // Peripheral
diff --git a/examples/ostimer_async.rs b/examples/src/bin/ostimer_async.rs
index 2642a633d..4e692a744 100644
--- a/examples/ostimer_async.rs
+++ b/examples/src/bin/ostimer_async.rs
@@ -2,13 +2,10 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use embassy_mcxa276::{self as hal, lpuart::{Config, Lpuart}};
-
-mod common;
-
-use embassy_mcxa276::bind_interrupts;
+use embassy_mcxa::bind_interrupts;
+use embassy_mcxa_examples::init_uart2;
 use embassy_time::{Duration, Timer};
-use {defmt_rtt as _, panic_probe as _};
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 // Bind only OS_EVENT, and retain the symbol explicitly so it can’t be GC’ed.
 bind_interrupts!(struct Irqs {
@@ -24,7 +21,7 @@ async fn main(_spawner: Spawner) {
     let p = hal::init(hal::config::Config::default());
 
     // Create UART configuration
-    let config = Config {
+    let config = hal::lpuart::Config {
         baudrate_bps: 115_200,
         enable_tx: true,
         enable_rx: true,
@@ -33,9 +30,9 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        init_uart2(hal::pac());
     }
-    let mut uart = Lpuart::new_blocking(
+    let mut uart = hal::lpuart::Lpuart::new_blocking(
         p.LPUART2, // Peripheral
         p.PIO2_2,  // TX pin
         p.PIO2_3,  // RX pin
diff --git a/examples/ostimer_counter.rs b/examples/src/bin/ostimer_counter.rs
index 590c5a14b..47543160b 100644
--- a/examples/ostimer_counter.rs
+++ b/examples/src/bin/ostimer_counter.rs
@@ -7,15 +7,12 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use embassy_mcxa276::{
-    clocks::{periph_helpers::OstimerClockSel, PoweredClock},
-    lpuart::{Blocking, Config, Lpuart},
-};
+use embassy_mcxa::clocks::periph_helpers::OstimerClockSel;
+use embassy_mcxa::clocks::PoweredClock;
+use embassy_mcxa::lpuart::{Blocking, Config, Lpuart};
 use embassy_time::{Duration, Timer};
 use hal::bind_interrupts;
-use {defmt_rtt as _, embassy_mcxa276 as hal, panic_probe as _};
-
-mod common;
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 bind_interrupts!(struct Irqs {
     OS_EVENT => hal::ostimer::time_driver::OsEventHandler;
@@ -35,7 +32,7 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        embassy_mcxa_examples::init_uart2(hal::pac());
     }
     let mut uart = Lpuart::new_blocking(
         p.LPUART2, // Peripheral
diff --git a/examples/ostimer_race_test.rs b/examples/src/bin/ostimer_race_test.rs
index 131d10f64..c2ecff969 100644
--- a/examples/ostimer_race_test.rs
+++ b/examples/src/bin/ostimer_race_test.rs
@@ -12,15 +12,12 @@
 use core::sync::atomic::{AtomicU32, Ordering};
 
 use embassy_executor::Spawner;
-use embassy_mcxa276::{
-    clocks::{periph_helpers::OstimerClockSel, PoweredClock},
-    lpuart::{Blocking, Config, Lpuart},
-};
+use embassy_mcxa::clocks::periph_helpers::OstimerClockSel;
+use embassy_mcxa::clocks::PoweredClock;
+use embassy_mcxa::lpuart::{Blocking, Config, Lpuart};
 use embassy_time::{Duration, Timer};
 use hal::bind_interrupts;
-use {defmt_rtt as _, embassy_mcxa276 as hal, panic_probe as _};
-
-mod common;
+use {defmt_rtt as _, embassy_mcxa as hal, panic_probe as _};
 
 bind_interrupts!(struct Irqs {
     OS_EVENT => hal::ostimer::time_driver::OsEventHandler;
@@ -85,7 +82,7 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        embassy_mcxa_examples::init_uart2(hal::pac());
     }
     let mut uart = Lpuart::new_blocking(
         p.LPUART2, // Peripheral
@@ -281,7 +278,7 @@ async fn test_concurrent_operations(
 async fn test_reset_during_operation(
     ostimer: &hal::ostimer::Ostimer<'_, hal::ostimer::Ostimer0>,
     uart: &mut Lpuart<'_, Blocking>,
-    peripherals: &mcxa_pac::Peripherals,
+    peripherals: &hal::pac::Peripherals,
 ) {
     let initial_counter = ostimer.now();
 
diff --git a/examples/rtc_alarm.rs b/examples/src/bin/rtc_alarm.rs
index 1cda37054..e2eaa6ae2 100644
--- a/examples/rtc_alarm.rs
+++ b/examples/src/bin/rtc_alarm.rs
@@ -2,16 +2,13 @@
 #![no_main]
 
 use embassy_executor::Spawner;
-use embassy_mcxa276::lpuart::{Config, Lpuart};
 use hal::rtc::{RtcDateTime, RtcInterruptEnable};
 use hal::InterruptExt;
-use {embassy_mcxa276 as hal};
-
-mod common;
+use {cortex_m, embassy_mcxa as hal};
 
 type MyRtc = hal::rtc::Rtc<'static, hal::rtc::Rtc0>;
 
-use embassy_mcxa276::bind_interrupts;
+use embassy_mcxa::bind_interrupts;
 use {defmt_rtt as _, panic_probe as _};
 
 bind_interrupts!(struct Irqs {
@@ -27,7 +24,7 @@ async fn main(_spawner: Spawner) {
     let p = hal::init(hal::config::Config::default());
 
     // Create UART configuration
-    let config = Config {
+    let config = hal::lpuart::Config {
         baudrate_bps: 115_200,
         enable_tx: true,
         enable_rx: true,
@@ -36,9 +33,9 @@ async fn main(_spawner: Spawner) {
 
     // Create UART instance using LPUART2 with PIO2_2 as TX and PIO2_3 as RX
     unsafe {
-        common::init_uart2(hal::pac());
+        embassy_mcxa_examples::init_uart2(hal::pac());
     }
-    let mut uart = Lpuart::new_blocking(
+    let mut uart = hal::lpuart::Lpuart::new_blocking(
         p.LPUART2, // Peripheral
         p.PIO2_2,  // TX pin
         p.PIO2_3,  // RX pin
@@ -94,6 +91,4 @@ async fn main(_spawner: Spawner) {
     }
 
     uart.write_str_blocking("Example complete - Test PASSED!\r\n");
-
-    loop {}
 }
diff --git a/examples/common/mod.rs b/examples/src/lib.rs
index 7b197a590..a45ab708d 100644
--- a/examples/common/mod.rs
+++ b/examples/src/lib.rs
@@ -1,13 +1,15 @@
+#![no_std]
+
 //! Shared board-specific helpers for the FRDM-MCXA276 examples.
 //! These live with the examples so the HAL stays generic.
 
 use hal::{clocks, pins};
-use {embassy_mcxa276 as hal, panic_probe as _};
+use {embassy_mcxa as hal, panic_probe as _};
 
 /// Initialize clocks and pin muxing for UART2 debug console.
 /// Safe to call multiple times; writes are idempotent for our use.
 #[allow(dead_code)]
-pub unsafe fn init_uart2(_p: &mcxa_pac::Peripherals) {
+pub unsafe fn init_uart2(_p: &hal::pac::Peripherals) {
     // NOTE: Lpuart has been updated to properly enable + reset its own clocks.
     // GPIO has not.
     _ = clocks::enable_and_reset::<hal::peripherals::PORT2>(&clocks::NoConfig);
@@ -16,14 +18,14 @@ pub unsafe fn init_uart2(_p: &mcxa_pac::Peripherals) {
 
 /// Initialize clocks for the LED GPIO/PORT used by the blink example.
 #[allow(dead_code)]
-pub unsafe fn init_led(_p: &mcxa_pac::Peripherals) {
+pub unsafe fn init_led(_p: &hal::pac::Peripherals) {
     _ = clocks::enable_and_reset::<hal::peripherals::PORT3>(&clocks::NoConfig);
     _ = clocks::enable_and_reset::<hal::peripherals::GPIO3>(&clocks::NoConfig);
 }
 
 /// Initialize clocks and pin muxing for ADC.
 #[allow(dead_code)]
-pub unsafe fn init_adc(_p: &mcxa_pac::Peripherals) {
+pub unsafe fn init_adc(_p: &hal::pac::Peripherals) {
     // NOTE: Lpuart has been updated to properly enable + reset its own clocks.
     // GPIO has not.
     _ = clocks::enable_and_reset::<hal::peripherals::PORT1>(&clocks::NoConfig);