From 6a73d56aff7597caa0c9da681075e92fda29ce04 Mon Sep 17 00:00:00 2001
From: Michael Buesch <m@bues.ch>
Date: Sun, 7 Aug 2022 18:21:38 +0200
Subject: [PATCH] Add statically checked macro for safe struct Peripherals
 creation

---
 src/lib.rs | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/src/lib.rs b/src/lib.rs
index 7c99a39..7000e45 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -273,3 +273,24 @@ pub use crate::devices::attiny85;
 pub use crate::devices::attiny861;
 #[cfg(feature = "attiny88")]
 pub use crate::devices::attiny88;
+
+/// Safely retrieve an instance of the device's `struct Peripherals` once.
+///
+/// This macro can only be used once in the whole program.
+/// Multiple uses will result in a linker abort.
+#[macro_export]
+macro_rules! peripherals {
+    ($device_name: ident) => {
+        {
+            {
+                #[no_mangle]
+                #[link_section=".__peripherals_usage_restriction__"]
+                #[export_name="__ERROR__avr_device__peripherals__macro_must_only_be_used_once__"]
+                static _x: () = ();
+            }
+            unsafe {
+                avr_device::$device_name::Peripherals::steal()
+            }
+        }
+    }
+}