change(esp_rom): optimize target-specific header files layout in components/esp_rom

components/esp_coex/esp32h2/esp_coex_adapter.c

@@ -21,7 +21,7 @@
 #include "soc/rtc.h"
 #include "esp_private/esp_clk.h"
 #include "private/esp_coexist_adapter.h"
-#include "esp32c6/rom/ets_sys.h"
+#include "esp32h2/rom/ets_sys.h"
 
 #define TAG "esp_coex_adapter"
 

components/esp_rom/CMakeLists.txt

@@ -3,7 +3,8 @@ idf_build_get_property(target IDF_TARGET)
 set(target_folder "${target}")
 
 set(include_dirs "include"
-                 "include/${target_folder}"
+                 "${target_folder}/include"
+                 "${target_folder}/include/${target_folder}"
                  "${target_folder}")
 
 set(private_required_comp "")
@@ -17,9 +18,6 @@ if(target STREQUAL "linux")
                         "${target}/esp_rom_md5.c"
                         "${target}/esp_rom_efuse.c")
 else()
-    if(CONFIG_IDF_TARGET_ESP32C5)
-        list(APPEND include_dirs "include/${target_folder}/..")
-    endif()
     list(APPEND sources "patches/esp_rom_crc.c"
                         "patches/esp_rom_uart.c"
                         "patches/esp_rom_spiflash.c"

components/esp_rom/esp32/include/esp32/rom/aes.h

@@ -5,19 +5,11 @@
   use the wrapper functions in esp32/aes.h instead.
 
  */
-// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #ifndef _ROM_AES_H_
 #define _ROM_AES_H_

components/esp_rom/esp32/include/esp32/rom/bigint.h

@@ -5,19 +5,11 @@
   use the wrapper functions in hwcrypto/mpi.h instead.
 
  */
-// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #ifndef _ROM_BIGINT_H_
 #define _ROM_BIGINT_H_

components/esp_rom/esp32/include/esp32/rom/crc.h

@@ -1,16 +1,8 @@
-// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #ifndef ROM_CRC_H
 #define ROM_CRC_H

components/esp_rom/esp32/include/esp32/rom/ets_sys.h

@@ -64,11 +64,11 @@ struct ETSEventTag {
     ETSParam  par;  /**< Event parameter, sometimes without usage, then will be set as 0*/
 };
 
-typedef void (*ETSTask)(ETSEvent *e);       /**< Type of the Task processer*/
+typedef void (*ETSTask)(ETSEvent *e);       /**< Type of the Task processor*/
 typedef void (* ets_idle_cb_t)(void *arg);  /**< Type of the system idle callback*/
 
 /**
-  * @brief  Start the Espressif Task Scheduler, which is an infinit loop. Please do not add code after it.
+  * @brief  Start the Espressif Task Scheduler, which is an infinite loop. Please do not add code after it.
   *
   * @param  none
   *
@@ -88,9 +88,9 @@ void ets_run(void);
 void ets_set_idle_cb(ets_idle_cb_t func, void *arg);
 
 /**
-  * @brief  Init a task with processer, priority, queue to receive Event, queue length.
+  * @brief  Init a task with processor, priority, queue to receive Event, queue length.
   *
-  * @param  ETSTask task : The task processer.
+  * @param  ETSTask task : The task processor.
   *
   * @param  uint8_t prio : Task priority, 0-31, bigger num with high priority, one priority with one task.
   *
@@ -128,7 +128,7 @@ ETS_STATUS ets_post(uint8_t prio, ETSSignal sig, ETSParam par);
   * @{
   */
 
-extern const char *const exc_cause_table[40];   ///**< excption cause that defined by the core.*/
+extern const char *const exc_cause_table[40];   ///**< exception cause that defined by the core.*/
 
 /**
   * @brief  Set Pro cpu Entry code, code can be called in PRO CPU when booting is not completed.
@@ -230,7 +230,7 @@ int ets_printf(const char *fmt, ...);
 void ets_write_char_uart(char c);
 
 /**
-  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need ouput.
+  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need output.
   *         To install putc1, which is defaulted installed as ets_write_char_uart in none silent boot mode, as NULL in silent mode.
   *
   * @param  void (*)(char) p: Output function to install.
@@ -240,7 +240,7 @@ void ets_write_char_uart(char c);
 void ets_install_putc1(void (*p)(char c));
 
 /**
-  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need ouput.
+  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need output.
   *         To install putc2, which is defaulted installed as NULL.
   *
   * @param  void (*)(char) p: Output function to install.
@@ -283,7 +283,7 @@ typedef void ETSTimerFunc(void *timer_arg);/**< timer handler*/
 
 typedef struct _ETSTIMER_ {
     struct _ETSTIMER_    *timer_next;   /**< timer linker*/
-    uint32_t              timer_expire; /**< abstruct time when timer expire*/
+    uint32_t              timer_expire; /**< abstract time when timer expire*/
     uint32_t              timer_period; /**< timer period, 0 means timer is not periodic repeated*/
     ETSTimerFunc         *timer_func;   /**< timer handler*/
     void                 *timer_arg;    /**< timer handler argument*/

components/esp_rom/esp32/include/esp32/rom/gpio.h

@@ -62,7 +62,7 @@ typedef enum {
   *
   * @param  uint32_t enable_mask : the gpios that need be changed.
   *
-  * @param  uint32_t disable_mask : the gpios that need diable output.
+  * @param  uint32_t disable_mask : the gpios that need disable output.
   *
   * @return None
   */
@@ -79,7 +79,7 @@ void gpio_output_set(uint32_t set_mask, uint32_t clear_mask, uint32_t enable_mas
   *
   * @param  uint32_t enable_mask : the gpios that need be changed.
   *
-  * @param  uint32_t disable_mask : the gpios that need diable output.
+  * @param  uint32_t disable_mask : the gpios that need disable output.
   *
   * @return None
   */

components/esp_rom/esp32/include/esp32/rom/rtc.h

@@ -85,7 +85,7 @@ typedef enum {
     TGWDT_CPU_RESET        = 11,    /**<11, Time Group reset CPU*/
     SW_CPU_RESET           = 12,    /**<12, Software reset CPU*/
     RTCWDT_CPU_RESET       = 13,    /**<13, RTC Watch dog Reset CPU*/
-    EXT_CPU_RESET          = 14,    /**<14, for APP CPU, reseted by PRO CPU*/
+    EXT_CPU_RESET          = 14,    /**<14, for APP CPU, reset by PRO CPU*/
     RTCWDT_BROWN_OUT_RESET = 15,    /**<15, Reset when the vdd voltage is not stable*/
     RTCWDT_RTC_RESET       = 16     /**<16, RTC Watch dog reset digital core and rtc module*/
 } RESET_REASON;

components/esp_rom/esp32/include/esp32/rom/sha.h

@@ -6,19 +6,11 @@
   esp_sha_lock_memory_block() functions in esp32/sha.h to ensure
   exclusive access.
  */
-// Copyright 2015-2016 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 #ifndef _ROM_SHA_H_
 #define _ROM_SHA_H_
 

components/esp_rom/esp32/include/esp32/rom/tbconsole.h

@@ -0,0 +1,19 @@
+/*
+ * SPDX-FileCopyrightText: 2015-2024 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+#ifndef _ROM_TBCONSOLE_H_
+#define _ROM_TBCONSOLE_H_
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void start_tb_console(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _ROM_TBCONSOLE_H_ */

components/esp_rom/esp32/include/esp32/rom/tjpgd.h

@@ -71,7 +71,7 @@ struct JDEC {
 	BYTE msx, msy;			/* MCU size in unit of block (width, height) */
 	BYTE qtid[3];			/* Quantization table ID of each component */
 	SHORT dcv[3];			/* Previous DC element of each component */
-	WORD nrst;				/* Restart inverval */
+	WORD nrst;				/* Restart interval */
 	UINT width, height;		/* Size of the input image (pixel) */
 	BYTE* huffbits[2][2];	/* Huffman bit distribution tables [id][dcac] */
 	WORD* huffcode[2][2];	/* Huffman code word tables [id][dcac] */
@@ -80,9 +80,9 @@ struct JDEC {
 	void* workbuf;			/* Working buffer for IDCT and RGB output */
 	BYTE* mcubuf;			/* Working buffer for the MCU */
 	void* pool;				/* Pointer to available memory pool */
-	UINT sz_pool;			/* Size of momory pool (bytes available) */
+	UINT sz_pool;			/* Size of memory pool (bytes available) */
 	UINT (*infunc)(JDEC*, BYTE*, UINT);/* Pointer to jpeg stream input function */
-	void* device;			/* Pointer to I/O device identifiler for the session */
+	void* device;			/* Pointer to I/O device identifier for the session */
 };
 
 

components/esp_rom/esp32c2/include/esp32c2/rom/cache.h

@@ -445,7 +445,7 @@ void Cache_Travel_Tag_Memory(struct cache_mode * mode, uint32_t filter_addr, voi
   *
   * @param  struct cache_mode * mode : the cache to calculate the virtual address and the cache mode.
   *
-  * @param  uint32_t tag : the tag part fo a tag item, 12-14 bits.
+  * @param  uint32_t tag : the tag part of a tag item, 12-14 bits.
   *
   * @param  uint32_t addr_offset : the virtual address offset of the cache ways.
   *

components/esp_rom/esp32c2/include/esp32c2/rom/efuse.h

@@ -39,7 +39,7 @@ typedef enum {
 } ets_efuse_block_t;
 
 /**
- * @brief set timing accroding the apb clock, so no read error or write error happens.
+ * @brief set timing according the apb clock, so no read error or write error happens.
  *
  * @param clock: apb clock in HZ, only accept 5M(in FPGA), 10M(in FPGA), 20M, 40M, 80M.
  *
@@ -162,7 +162,7 @@ bool ets_efuse_download_modes_disabled(void);
   * - 0 for uart force print.
   * - 1 for uart print when GPIO8 is low when digital reset.
   *   2 for uart print when GPIO8 is high when digital reset.
-  *   3 for uart force slient
+  *   3 for uart force silent
   */
 uint32_t ets_efuse_get_uart_print_control(void);
 

components/esp_rom/esp32c2/include/esp32c2/rom/gpio.h

@@ -57,7 +57,7 @@ typedef enum {
   *
   * @param  uint32_t enable_mask : the gpios that need be changed.
   *
-  * @param  uint32_t disable_mask : the gpios that need diable output.
+  * @param  uint32_t disable_mask : the gpios that need disable output.
   *
   * @return None
   */

components/esp_rom/esp32c2/include/esp32c2/rom/spi_flash.h

@@ -434,7 +434,7 @@ void esp_rom_spiflash_fix_dummylen(uint8_t spi, uint8_t freqdiv);
   *
   * @param  uint8_t *drvs: drvs[0]-bit[3:0] for cpiclk, bit[7:4] for spiq, drvs[1]-bit[3:0] for spid, drvs[1]-bit[7:4] for spid
   *            drvs[2]-bit[3:0] for spihd, drvs[2]-bit[7:4] for spiwp.
-  *                        Values usually read from falsh by rom code, function usually callde by rom code.
+  *                        Values usually read from flash by rom code, function usually called by rom code.
   *                        if value with bit(3) set, the value is valid, bit[2:0] is the real value.
   *
   * @return None

components/esp_rom/esp32c2/include/esp32c2/rom/uart.h

@@ -28,7 +28,7 @@ extern "C" {
 #define RX_BUFF_SIZE                     0x400
 #define TX_BUFF_SIZE                     100
 
-//uart int enalbe register ctrl bits
+//uart int enable register ctrl bits
 #define UART_RCV_INTEN                   BIT0
 #define UART_TRX_INTEN                   BIT1
 #define UART_LINE_STATUS_INTEN           BIT2
@@ -263,7 +263,7 @@ char uart_rx_one_char_block(void);
   *
   * @param  uint8_t *pString : the pointer to store the string.
   *
-  * @param  uint8_t MaxStrlen : the max string length, incude '\0'.
+  * @param  uint8_t MaxStrlen : the max string length, include '\0'.
   *
   * @return OK.
   */

components/esp_rom/esp32c3/include/esp32c3/rom/bigint.h

@@ -1,16 +1,8 @@
-// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2020-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #ifndef _ROM_BIGINT_H_
 #define _ROM_BIGINT_H_

components/esp_rom/esp32c3/include/esp32c3/rom/cache.h

@@ -605,7 +605,7 @@ void Cache_Travel_Tag_Memory(struct cache_mode * mode, uint32_t filter_addr, voi
   *
   * @param  struct cache_mode * mode : the cache to calculate the virtual address and the cache mode.
   *
-  * @param  uint32_t tag : the tag part fo a tag item, 12-14 bits.
+  * @param  uint32_t tag : the tag part of a tag item, 12-14 bits.
   *
   * @param  uint32_t addr_offset : the virtual address offset of the cache ways.
   *

components/esp_rom/esp32c3/include/esp32c3/rom/crc.h

@@ -1,16 +1,8 @@
-// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2020-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #ifndef ROM_CRC_H
 #define ROM_CRC_H

components/esp_rom/esp32c3/include/esp32c3/rom/digital_signature.h

@@ -1,16 +1,8 @@
-// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2020-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #pragma once
 

components/esp_rom/esp32c3/include/esp32c3/rom/efuse.h

@@ -55,7 +55,7 @@ typedef enum {
 } ets_efuse_block_t;
 
 /**
- * @brief set timing accroding the apb clock, so no read error or write error happens.
+ * @brief set timing according the apb clock, so no read error or write error happens.
  *
  * @param clock: apb clock in HZ, only accept 5M(in FPGA), 10M(in FPGA), 20M, 40M, 80M.
  *
@@ -208,7 +208,7 @@ bool ets_efuse_legacy_spi_boot_mode_disabled(void);
   * - 0 for uart force print.
   * - 1 for uart print when GPIO8 is low when digital reset.
   *   2 for uart print when GPIO8 is high when digital reset.
-  *   3 for uart force slient
+  *   3 for uart force silent
   */
 uint32_t ets_efuse_get_uart_print_control(void);
 

components/esp_rom/esp32c3/include/esp32c3/rom/esp_flash.h

@@ -1,16 +1,8 @@
-// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2020-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #pragma once
 

components/esp_rom/esp32c3/include/esp32c3/rom/ets_sys.h

@@ -61,7 +61,7 @@ struct ETSEventTag {
     ETSParam  par;  /**< Event parameter, sometimes without usage, then will be set as 0*/
 };
 
-typedef void (*ETSTask)(ETSEvent *e);       /**< Type of the Task processer*/
+typedef void (*ETSTask)(ETSEvent *e);       /**< Type of the Task processor*/
 typedef void (* ets_idle_cb_t)(void *arg);  /**< Type of the system idle callback*/
 
 
@@ -80,7 +80,7 @@ typedef void (* ets_idle_cb_t)(void *arg);  /**< Type of the system idle callbac
   * @{
   */
 
-extern const char *const exc_cause_table[40];   ///**< excption cause that defined by the core.*/
+extern const char *const exc_cause_table[40];   ///**< exception cause that defined by the core.*/
 
 /**
   * @brief  Set Pro cpu Entry code, code can be called in PRO CPU when booting is not completed.
@@ -125,7 +125,7 @@ int ets_printf(const char *fmt, ...);
 uint8_t ets_get_printf_channel(void);
 
 /**
-  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need ouput.
+  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need output.
   *         To install putc1, which is defaulted installed as ets_write_char_uart in none silent boot mode, as NULL in silent mode.
   *
   * @param  void (*)(char) p: Output function to install.
@@ -135,7 +135,7 @@ uint8_t ets_get_printf_channel(void);
 void ets_install_putc1(void (*p)(char c));
 
 /**
-  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need ouput.
+  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need output.
   *         To install putc2, which is defaulted installed as NULL.
   *
   * @param  void (*)(char) p: Output function to install.
@@ -178,7 +178,7 @@ typedef void ETSTimerFunc(void *timer_arg);/**< timer handler*/
 
 typedef struct _ETSTIMER_ {
     struct _ETSTIMER_    *timer_next;   /**< timer linker*/
-    uint32_t              timer_expire; /**< abstruct time when timer expire*/
+    uint32_t              timer_expire; /**< abstract time when timer expire*/
     uint32_t              timer_period; /**< timer period, 0 means timer is not periodic repeated*/
     ETSTimerFunc         *timer_func;   /**< timer handler*/
     void                 *timer_arg;    /**< timer handler argument*/

components/esp_rom/esp32c3/include/esp32c3/rom/gpio.h

@@ -57,7 +57,7 @@ typedef enum {
   *
   * @param  uint32_t enable_mask : the gpios that need be changed.
   *
-  * @param  uint32_t disable_mask : the gpios that need diable output.
+  * @param  uint32_t disable_mask : the gpios that need disable output.
   *
   * @return None
   */

components/esp_rom/esp32c3/include/esp32c3/rom/hmac.h

@@ -1,16 +1,8 @@
-// Copyright 2018 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2020-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #ifndef _ROM_HMAC_H_
 #define _ROM_HMAC_H_

components/esp_rom/esp32c3/include/esp32c3/rom/rsa_pss.h

@@ -1,16 +1,8 @@
-// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2020-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 
 #ifndef _ROM_RSA_PSS_H_
 #define _ROM_RSA_PSS_H_

components/esp_rom/esp32c3/include/esp32c3/rom/sha.h

@@ -1,16 +1,8 @@
-// Copyright 2020 Espressif Systems (Shanghai) PTE LTD
+/*
-//
+ * SPDX-FileCopyrightText: 2020-2024 Espressif Systems (Shanghai) CO LTD
-// Licensed under the Apache License, Version 2.0 (the "License");
+ *
-// you may not use this file except in compliance with the License.
+ * SPDX-License-Identifier: Apache-2.0
-// You may obtain a copy of the License at
+ */
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
 #ifndef _ROM_SHA_H_
 #define _ROM_SHA_H_
 

components/esp_rom/esp32c3/include/esp32c3/rom/spi_flash.h

@@ -428,7 +428,7 @@ void esp_rom_spiflash_fix_dummylen(uint8_t spi, uint8_t freqdiv);
   *
   * @param  uint8_t *drvs: drvs[0]-bit[3:0] for cpiclk, bit[7:4] for spiq, drvs[1]-bit[3:0] for spid, drvs[1]-bit[7:4] for spid
   *            drvs[2]-bit[3:0] for spihd, drvs[2]-bit[7:4] for spiwp.
-  *                        Values usually read from falsh by rom code, function usually callde by rom code.
+  *                        Values usually read from flash by rom code, function usually called by rom code.
   *                        if value with bit(3) set, the value is valid, bit[2:0] is the real value.
   *
   * @return None

components/esp_rom/esp32c3/include/esp32c3/rom/tjpgd.h

@@ -71,7 +71,7 @@ struct JDEC {
     BYTE msx, msy;          /* MCU size in unit of block (width, height) */
     BYTE qtid[3];           /* Quantization table ID of each component */
     SHORT dcv[3];           /* Previous DC element of each component */
-    WORD nrst;              /* Restart inverval */
+    WORD nrst;              /* Restart interval */
     UINT width, height;     /* Size of the input image (pixel) */
     BYTE *huffbits[2][2];   /* Huffman bit distribution tables [id][dcac] */
     WORD *huffcode[2][2];   /* Huffman code word tables [id][dcac] */
@@ -80,9 +80,9 @@ struct JDEC {
     void *workbuf;          /* Working buffer for IDCT and RGB output */
     BYTE *mcubuf;           /* Working buffer for the MCU */
     void *pool;             /* Pointer to available memory pool */
-    UINT sz_pool;           /* Size of momory pool (bytes available) */
+    UINT sz_pool;           /* Size of memory pool (bytes available) */
     UINT (*infunc)(JDEC *, BYTE *, UINT); /* Pointer to jpeg stream input function */
-    void *device;           /* Pointer to I/O device identifiler for the session */
+    void *device;           /* Pointer to I/O device identifier for the session */
 };
 
 

components/esp_rom/esp32c3/include/esp32c3/rom/uart.h

@@ -28,7 +28,7 @@ extern "C" {
 #define RX_BUFF_SIZE                     0x400
 #define TX_BUFF_SIZE                     100
 
-//uart int enalbe register ctrl bits
+//uart int enable register ctrl bits
 #define UART_RCV_INTEN                   BIT0
 #define UART_TRX_INTEN                   BIT1
 #define UART_LINE_STATUS_INTEN           BIT2
@@ -253,7 +253,7 @@ char uart_rx_one_char_block(void);
   *
   * @param  uint8_t *pString : the pointer to store the string.
   *
-  * @param  uint8_t MaxStrlen : the max string length, incude '\0'.
+  * @param  uint8_t MaxStrlen : the max string length, include '\0'.
   *
   * @return OK.
   */

components/esp_rom/esp32c6/include/esp32c6/rom/cache.h

@@ -561,7 +561,7 @@ void Cache_Travel_Tag_Memory(struct cache_mode * mode, uint32_t filter_addr, voi
   *
   * @param  struct cache_mode * mode : the cache to calculate the virtual address and the cache mode.
   *
-  * @param  uint32_t tag : the tag part fo a tag item, 12-14 bits.
+  * @param  uint32_t tag : the tag part of a tag item, 12-14 bits.
   *
   * @param  uint32_t addr_offset : the virtual address offset of the cache ways.
   *

components/esp_rom/esp32c6/include/esp32c6/rom/efuse.h

@@ -169,7 +169,7 @@ bool ets_efuse_download_modes_disabled(void);
   * - 0 for uart force print.
   * - 1 for uart print when GPIO8 is low when digital reset.
   *   2 for uart print when GPIO8 is high when digital reset.
-  *   3 for uart force slient
+  *   3 for uart force silent
   */
 uint32_t ets_efuse_get_uart_print_control(void);
 

components/esp_rom/esp32c6/include/esp32c6/rom/ets_sys.h

@@ -61,7 +61,7 @@ struct ETSEventTag {
     ETSParam  par;  /**< Event parameter, sometimes without usage, then will be set as 0*/
 };
 
-typedef void (*ETSTask)(ETSEvent *e);       /**< Type of the Task processer*/
+typedef void (*ETSTask)(ETSEvent *e);       /**< Type of the Task processor*/
 typedef void (* ets_idle_cb_t)(void *arg);  /**< Type of the system idle callback*/
 
 
@@ -80,7 +80,7 @@ typedef void (* ets_idle_cb_t)(void *arg);  /**< Type of the system idle callbac
   * @{
   */
 
-extern const char *const exc_cause_table[40];   ///**< excption cause that defined by the core.*/
+extern const char *const exc_cause_table[40];   ///**< exception cause that defined by the core.*/
 
 /**
   * @brief  Set Pro cpu Entry code, code can be called in PRO CPU when booting is not completed.
@@ -135,7 +135,7 @@ uint8_t ets_get_printf_channel(void);
 void ets_write_char_uart(char c);
 
 /**
-  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need ouput.
+  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need output.
   *         To install putc1, which is defaulted installed as ets_write_char_uart in none silent boot mode, as NULL in silent mode.
   *
   * @param  void (*)(char) p: Output function to install.
@@ -145,7 +145,7 @@ void ets_write_char_uart(char c);
 void ets_install_putc1(void (*p)(char c));
 
 /**
-  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need ouput.
+  * @brief  Ets_printf have two output functions： putc1 and putc2, both of which will be called if need output.
   *         To install putc2, which is defaulted installed as NULL.
   *
   * @param  void (*)(char) p: Output function to install.
@@ -188,7 +188,7 @@ typedef void ETSTimerFunc(void *timer_arg);/**< timer handler*/
 
 typedef struct _ETSTIMER_ {
     struct _ETSTIMER_    *timer_next;   /**< timer linker*/
-    uint32_t              timer_expire; /**< abstruct time when timer expire*/
+    uint32_t              timer_expire; /**< abstract time when timer expire*/
     uint32_t              timer_period; /**< timer period, 0 means timer is not periodic repeated*/
     ETSTimerFunc         *timer_func;   /**< timer handler*/
     void                 *timer_arg;    /**< timer handler argument*/

components/esp_rom/esp32c6/include/esp32c6/rom/gpio.h

@@ -57,7 +57,7 @@ typedef enum {
   *
   * @param  uint32_t enable_mask : the gpios that need be changed.
   *
-  * @param  uint32_t disable_mask : the gpios that need diable output.
+  * @param  uint32_t disable_mask : the gpios that need disable output.
   *
   * @return None
   */