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_NANO_FORMAT      (1) // ROM has the newlib nano version of formatting functions
#define ESP_ROM_USB_OTG_NUM                 (3) // The serial port ID (UART, USB, ...) of USB_OTG CDC in the ROM.
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`
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`
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.`