From 3a719c69c7cabe08847554b123f95f4bc48aa0a8 Mon Sep 17 00:00:00 2001
From: chrysn <chrysn@fsfe.org>
Date: Sun, 21 Mar 2021 14:35:01 +0100
Subject: [PATCH] doc/SAUL: State expectations on blocking and interrupts

---
 drivers/include/saul.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/drivers/include/saul.h b/drivers/include/saul.h
index e1c8ebbab8..6cddb7b368 100644
--- a/drivers/include/saul.h
+++ b/drivers/include/saul.h
@@ -27,6 +27,10 @@
  * actuators/sensor via auto_init and the access to all available devices via
  * one unified shell command.
  *
+ * SAUL drivers may rely on being called from a thread, and often block for
+ * short amounts of time to obtain a value. Conversely, requests through the
+ * @ref sys_saul_reg must not be issued from an interrupt context.
+ *
  * @todo        So far, the interface only supports simple read and set
  *              operations. It probably needs to be extended to handling events,
  *              thresholds, and so on.