esp-idf/components/esp_rom/esp32s2/esp_rom_caps.h

/*
 * SPDX-FileCopyrightText: 2020-2022 Espressif Systems (Shanghai) CO LTD
 *
 * SPDX-License-Identifier: Apache-2.0
 */

#pragma once

#define ESP_ROM_HAS_CRC_LE                  (1) // ROM CRC library supports Little Endian
#define ESP_ROM_HAS_MZ_CRC32                (1) // ROM has mz_crc32 function
#define ESP_ROM_HAS_UART_BUF_SWITCH         (1) // ROM has exported the uart buffer switch function
#define ESP_ROM_NEEDS_SWSETUP_WORKAROUND    (1) // ROM uses 32-bit time_t. A workaround is required to prevent printf functions from crashing
#define ESP_ROM_HAS_REGI2C_BUG              (1) // ROM has the regi2c bug
#define ESP_ROM_HAS_NEWLIB                  (1) // ROM has newlib (at least parts of it) functions included
#define ESP_ROM_HAS_NEWLIB_NANO_FORMAT      (1) // ROM has the newlib nano version of formatting functions
#define ESP_ROM_HAS_NEWLIB_32BIT_TIME       (1) // ROM was compiled with 32 bit time_t
#define ESP_ROM_USB_OTG_NUM                 (3) // The serial port ID (UART, USB, ...) of USB_OTG CDC in the ROM.
#define ESP_ROM_HAS_FLASH_COUNT_PAGES_BUG   (1) // ROM api Cache_Count_Flash_Pages will return unexpected value
#define ESP_ROM_HAS_SW_FLOAT            (1) // ROM has libgcc software floating point emulation functions
#define ESP_ROM_USB_SERIAL_DEVICE_NUM       (-1) // No USB_SERIAL_JTAG in the ROM, set -1 for Kconfig usage.
#define ESP_ROM_SUPPORT_DEEP_SLEEP_WAKEUP_STUB  (1) // ROM supports the HP core to jump to the RTC memory to execute stub code after waking up from deepsleep.
newlib: Add workaround for printf functions using 32-bit time_t on first call sizeof(time_t) was previously switched from 4 to 8, ROM functions that use time_t or dependent types (such as "struct stat") are no longer called due as they still treat sizeof(time_t) as 4 (see commit 24c20d188e24c815e28351cddb838c01e7dfb241). However, there is a ROM callpath that was left out. If putchar is the first stdio print related call, the call path will result in cantwrite() -> __swsetup_r() -> __smakebuf_r() -> __swhatbuf_r() using the ROM "struct stat" (where sizeof(time_t)==4). Instead of removing all printf related ROM newlib functions (which will result in increased binary size), this commit adds a workaround to setup the stdio files before any print related calls occur. This results in cantwrite() always returning false, thus the callpath described above never being reached. Closes https://github.com/espressif/esp-idf/issues/9269 2022-08-18 09:23:53 -04:00			`/*`
			`* SPDX-FileCopyrightText: 2020-2022 Espressif Systems (Shanghai) CO LTD`
			`*`
			`* SPDX-License-Identifier: Apache-2.0`
			`*/`
esp_rom: extract common CRC apis into esp_rom_crc.h 2020-06-19 03:08:38 -04:00
			`#pragma once`

esp_rom: add ESP_ROM_HAS_REGI2C_BUG in rom caps 2022-12-03 08:48:01 -05:00			`#define ESP_ROM_HAS_CRC_LE (1) // ROM CRC library supports Little Endian`
			`#define ESP_ROM_HAS_MZ_CRC32 (1) // ROM has mz_crc32 function`
rom: patch uart function to switch buffer 2023-01-30 01:01:19 -05:00			`#define ESP_ROM_HAS_UART_BUF_SWITCH (1) // ROM has exported the uart buffer switch function`
newlib: Add workaround for printf functions using 32-bit time_t on first call sizeof(time_t) was previously switched from 4 to 8, ROM functions that use time_t or dependent types (such as "struct stat") are no longer called due as they still treat sizeof(time_t) as 4 (see commit 24c20d188e24c815e28351cddb838c01e7dfb241). However, there is a ROM callpath that was left out. If putchar is the first stdio print related call, the call path will result in cantwrite() -> __swsetup_r() -> __smakebuf_r() -> __swhatbuf_r() using the ROM "struct stat" (where sizeof(time_t)==4). Instead of removing all printf related ROM newlib functions (which will result in increased binary size), this commit adds a workaround to setup the stdio files before any print related calls occur. This results in cantwrite() always returning false, thus the callpath described above never being reached. Closes https://github.com/espressif/esp-idf/issues/9269 2022-08-18 09:23:53 -04:00			`#define ESP_ROM_NEEDS_SWSETUP_WORKAROUND (1) // ROM uses 32-bit time_t. A workaround is required to prevent printf functions from crashing`
esp_rom: add ESP_ROM_HAS_REGI2C_BUG in rom caps 2022-12-03 08:48:01 -05:00			`#define ESP_ROM_HAS_REGI2C_BUG (1) // ROM has the regi2c bug`
refactor(esp_rom): refactor rom LD inclusions to make it easier to add new targets 2024-03-01 02:53:20 -05:00			`#define ESP_ROM_HAS_NEWLIB (1) // ROM has newlib (at least parts of it) functions included`
newlib: update newlib nano documentation for C6 C6 ROM has the the full IO formatting functions included. 2023-02-02 04:24:31 -05:00			`#define ESP_ROM_HAS_NEWLIB_NANO_FORMAT (1) // ROM has the newlib nano version of formatting functions`
refactor(esp_rom): refactor rom LD inclusions to make it easier to add new targets 2024-03-01 02:53:20 -05:00			`#define ESP_ROM_HAS_NEWLIB_32BIT_TIME (1) // ROM was compiled with 32 bit time_t`
esp_rom: add USB_OTG "port" number for S2 and S3 2022-05-17 17:43:47 -04:00			`#define ESP_ROM_USB_OTG_NUM (3) // The serial port ID (UART, USB, ...) of USB_OTG CDC in the ROM.`
esp_rom: Patch some cache apis 2023-06-16 02:04:00 -04:00			`#define ESP_ROM_HAS_FLASH_COUNT_PAGES_BUG (1) // ROM api Cache_Count_Flash_Pages will return unexpected value`
ci(system): fixed and enabled misc system build tests 2023-11-27 23:10:55 -05:00			`#define ESP_ROM_HAS_SW_FLOAT (1) // ROM has libgcc software floating point emulation functions`
fix(uart,usj...): Fix wrong serial number that has been parsed to rom functions, Closes https://github.com/espressif/esp-idf/issues/12958 2024-01-17 04:19:49 -05:00			`#define ESP_ROM_USB_SERIAL_DEVICE_NUM (-1) // No USB_SERIAL_JTAG in the ROM, set -1 for Kconfig usage.`
feat(soc): add ESP_ROM_SUPPORT_DEEP_SLEEP_WAKEUP_STUB rom caps 2024-03-21 06:07:36 -04:00			`#define ESP_ROM_SUPPORT_DEEP_SLEEP_WAKEUP_STUB (1) // ROM supports the HP core to jump to the RTC memory to execute stub code after waking up from deepsleep.`