mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
b7b9ea4361
This adds support for the retargetable locking implementation in newlib 3. This feature will be enabled in the future toolchain builds. With the present version of the toolchain, this code doesn't get used. When _RETARGETABLE_LOCKING gets enabled, newlib locking implementation will be modified as follows: - Legacy ESP-specific _lock_xxx functions are preserved. This is done because ROM copies of newlib in ESP32 and ESP32-S2 rely on these functions through the function pointer table. Also there is some code in IDF which still uses these locking functions. - New __retarget_lock_xxx functions are introduced. Newlib expects these functions to be provided by the system. These functions work pretty much the same way as the ESP-specific _lock_xxx functions, except one major difference: _lock_acquire receives the lock pointer by value, and as such doesn't support lazy initialization. - Static locks used by newlib are now explicitly initialized at startup. Since it is unlikely that these static locks are used at the same time, all compatible locks are set to point to the same mutex. This saves a bit of RAM. Note that there are still many locks not initialized statically, in particular those inside FILE structures.
42 lines
1.3 KiB
C
42 lines
1.3 KiB
C
#pragma once
|
|
|
|
#include_next <sys/lock.h>
|
|
|
|
#ifdef _RETARGETABLE_LOCKING
|
|
|
|
/* Actual platfrom-specific definition of struct __lock.
|
|
* The size here should be sufficient for a FreeRTOS mutex.
|
|
* This is checked by a static assertion in locks.c
|
|
*
|
|
* Note 1: this might need to be made dependent on whether FreeRTOS
|
|
* is included in the build.
|
|
*
|
|
* Note 2: the size is made sufficient for the case when
|
|
* configUSE_TRACE_FACILITY is enabled. If it is disabled,
|
|
* this definition wastes 8 bytes.
|
|
*/
|
|
struct __lock {
|
|
int reserved[23];
|
|
};
|
|
|
|
/* Compatibility definitions for the legacy ESP-specific locking implementation.
|
|
* These used to be provided by libc/sys/xtensa/sys/lock.h in newlib.
|
|
* Newer versions of newlib don't have this ESP-specific lock.h header, and are
|
|
* built with _RETARGETABLE_LOCKING enabled, instead.
|
|
*/
|
|
|
|
typedef _LOCK_T _lock_t;
|
|
|
|
void _lock_init(_lock_t *plock);
|
|
void _lock_init_recursive(_lock_t *plock);
|
|
void _lock_close(_lock_t *plock);
|
|
void _lock_close_recursive(_lock_t *plock);
|
|
void _lock_acquire(_lock_t *plock);
|
|
void _lock_acquire_recursive(_lock_t *plock);
|
|
int _lock_try_acquire(_lock_t *plock);
|
|
int _lock_try_acquire_recursive(_lock_t *plock);
|
|
void _lock_release(_lock_t *plock);
|
|
void _lock_release_recursive(_lock_t *plock);
|
|
|
|
#endif // _RETARGETABLE_LOCKING
|