Adding comment for future RTOS/multitasking integration
authorNathael Pajani <nathael.pajani@ed3l.fr>
Thu, 21 Sep 2023 22:18:05 +0000 (00:18 +0200)
committerNathael Pajani <nathael.pajani@ed3l.fr>
Thu, 21 Sep 2023 22:20:25 +0000 (00:20 +0200)
drivers/serial.c

index c11fd40..dfa3a1c 100644 (file)
  *
  *************************************************************************** */
 
+/*
+ * Note for multitasking and/or real-time OS design :
+ * Some functions in this driver may spend some time waiting for external
+ *   events or other tasks.
+ * The concerned functions are serial_write() and serial_flush().
+ * These functions should call the scheduler at some point to avoid using more
+ * time than required or even hang the system.
+ * Also note that when an uart receives a character this driver will call the
+ * handler registered by the application (if any). This handler should be kept
+ * as short as possible, and must not call any OS related function as it will
+ * be executed within interrupt context.
+ */
 
 
 /***************************************************************************** */