Asynchronous events and concurrency
Important
This is the Azure Sphere (Legacy) documentation. Azure Sphere (Legacy) is retiring on 27 September 2027, and users must migrate to Azure Sphere (Integrated) by this time. Use the Version selector located above the TOC to view the Azure Sphere (Integrated) documentation.
The Azure Sphere platform supports several common POSIX and Linux mechanisms to handle asynchronous events and concurrency, including event loops and POSIX pthreads.
The samples demonstrate how to use Azure Sphere event loops to safely manage event-driven scenarios. For example, the UART sample pauses until the device receives data over UART or until a button is pressed to send data over UART.
Event loops are a standard part of most graphical user interfaces and a standard Linux pattern. Azure Sphere event loops are a specific implementation of event loops that allow Azure Sphere applications to receive system notifications such as events related to updates.
We recommend the event loop pattern for the following reasons:
Azure Sphere event loops are required for managing system events such as OS and application update notifications. You must use event loops to defer device updates.
Event loops allow for asynchronous programming so that multiple tasks can progress concurrently.
Event loops minimize memory overhead. Every thread carries the memory overhead of a separate stack. Linux stacks are allocated with virtual memory and grow on-demand to an upper limit so there is no fixed cost. Threads are therefore harder to implement on a constrained system such as the Azure Sphere MT3620 because of the additional resource cost.
Synchronization between threads is complex and can lead to problems such as deadlocks. Event loops are simpler in this regard.
Although we recommend using event loops where practicable, if your application requires threads, Azure Sphere supports POSIX pthreads. It is the responsibility of the application to ensure thread-safe execution. Application calls to some applibs functions are thread safe, but others are not, as indicated in the header files. If the header file does not mention thread safety, you should assume that the relevant function or library is not thread safe.