1 /* 2 * SPDX-FileCopyrightText: 2020-2023 Espressif Systems (Shanghai) CO LTD 3 * 4 * SPDX-License-Identifier: Apache-2.0 5 */ 6 #ifndef _ROM_LIBC_STUBS_H_ 7 #define _ROM_LIBC_STUBS_H_ 8 9 #include <sys/lock.h> 10 #include <stddef.h> 11 #include <stdint.h> 12 #include <stdio.h> 13 #include <stdarg.h> 14 #include <reent.h> 15 #include <errno.h> 16 17 #ifdef __cplusplus 18 extern "C" { 19 #endif 20 21 /* 22 ESP32-C3 ROM code contains implementations of some of C library functions. 23 Whenever a function in ROM needs to use a syscall, it calls a pointer to the corresponding syscall 24 implementation defined in the following struct. 25 26 The table itself, by default, is not allocated in RAM. A global pointer syscall_table_ptr is used to 27 set the address 28 29 So, before using any of the C library functions (except for pure functions and memcpy/memset functions), 30 application must allocate syscall table structure for each CPU being used, and populate it with pointers 31 to actual implementations of corresponding syscalls. 32 */ 33 34 struct syscall_stub_table 35 { 36 struct _reent* (*__getreent)(void); 37 void* (*_malloc_r)(struct _reent *r, size_t); 38 void (*_free_r)(struct _reent *r, void*); 39 void* (*_realloc_r)(struct _reent *r, void*, size_t); 40 void* (*_calloc_r)(struct _reent *r, size_t, size_t); 41 void (*_abort)(void); 42 int (*_system_r)(struct _reent *r, const char*); 43 int (*_rename_r)(struct _reent *r, const char*, const char*); 44 clock_t (*_times_r)(struct _reent *r, struct tms *); 45 int (*_gettimeofday_r) (struct _reent *r, struct timeval *, void *); 46 void (*_raise_r)(struct _reent *r); 47 int (*_unlink_r)(struct _reent *r, const char*); 48 int (*_link_r)(struct _reent *r, const char*, const char*); 49 int (*_stat_r)(struct _reent *r, const char*, struct stat *); 50 int (*_fstat_r)(struct _reent *r, int, struct stat *); 51 void* (*_sbrk_r)(struct _reent *r, ptrdiff_t); 52 int (*_getpid_r)(struct _reent *r); 53 int (*_kill_r)(struct _reent *r, int, int); 54 void (*_exit_r)(struct _reent *r, int); 55 int (*_close_r)(struct _reent *r, int); 56 int (*_open_r)(struct _reent *r, const char *, int, int); 57 int (*_write_r)(struct _reent *r, int, const void *, int); 58 int (*_lseek_r)(struct _reent *r, int, int, int); 59 int (*_read_r)(struct _reent *r, int, void *, int); 60 void (*_retarget_lock_init)(_LOCK_T *lock); 61 void (*_retarget_lock_init_recursive)(_LOCK_T *lock); 62 void (*_retarget_lock_close)(_LOCK_T lock); 63 void (*_retarget_lock_close_recursive)(_LOCK_T lock); 64 void (*_retarget_lock_acquire)(_LOCK_T lock); 65 void (*_retarget_lock_acquire_recursive)(_LOCK_T lock); 66 int (*_retarget_lock_try_acquire)(_LOCK_T lock); 67 int (*_retarget_lock_try_acquire_recursive)(_LOCK_T lock); 68 void (*_retarget_lock_release)(_LOCK_T lock); 69 void (*_retarget_lock_release_recursive)(_LOCK_T lock); 70 int (*_printf_float)(struct _reent *data, void *pdata, FILE * fp, int (*pfunc) (struct _reent *, FILE *, const char *, size_t len), va_list * ap); 71 int (*_scanf_float) (struct _reent *rptr, void *pdata, FILE *fp, va_list *ap); 72 void (*__assert_func) (const char *file, int line, const char * func, const char *failedexpr) __attribute__((__noreturn__)); 73 void (*__sinit) (struct _reent *r); 74 void (*_cleanup_r) (struct _reent* r); 75 }; 76 77 extern struct syscall_stub_table *syscall_table_ptr; 78 79 #ifdef __cplusplus 80 } // extern "C" 81 #endif 82 83 #endif /* _ROM_LIBC_STUBS_H_ */ 84
