IDF release/v3.3 44e9dd3e29

Author: me-no-dev

platform.txt

@@ -35,7 +35,7 @@ compiler.S.flags=-c -g3 -x assembler-with-cpp -MMD -mlongcalls
 
 compiler.c.elf.cmd=xtensa-esp32-elf-gcc
 compiler.c.elf.flags=-nostdlib "-L{compiler.sdk.path}/lib" "-L{compiler.sdk.path}/ld" -T esp32_out.ld -T esp32.project.ld -T esp32.rom.ld -T esp32.peripherals.ld -T esp32.rom.libgcc.ld -T esp32.rom.spiram_incompatible_fns.ld -u esp_app_desc -u ld_include_panic_highint_hdl -u call_user_start_cpu0 -Wl,--gc-sections -Wl,-static -Wl,--undefined=uxTopUsedPriority  -u __cxa_guard_dummy -u __cxx_fatal_exception
-compiler.c.elf.libs=-lgcc -ldetection_cat_face -lespcoredump -lwpa -lrtc -lvfs -lnewlib -ldetection -lfreemodbus -lprotocomm -lwpa_supplicant -lfatfs -lsmartconfig -lesp_ringbuf -lfd -lesp_adc_cal -lspiffs -lopenssl -lsdmmc -ljsmn -lespnow -lc -lbootloader_support -lesp_https_server -lcore -lspi_flash -lmicro-ecc -lunity -lapp_trace -lexpat -lheap -ltcp_transport -lfr -lfb_gfx -lethernet -lesp_websocket_client -lesp32-camera -lcoexist -lpthread -lmqtt -lface_recognition -llwip -lasio -lefuse -lnvs_flash -lhal -lcxx -lesp_event -lfreertos -llibsodium -lwear_levelling -ljson -lesp32 -lcoap -lbt -lbtdm_app -lmbedtls -lwpa2 -lface_detection -lesp-tls -lwps -lpe -lmdns -lmesh -lesp_http_server -llog -lesp_http_client -lsoc -lc_nano -lnghttp -lprotobuf-c -lphy -lesp_https_ota -lwifi_provisioning -ldl -lulp -limage_util -lnet80211 -lsmartconfig_ack -lapp_update -lm -ltcpip_adapter -lpp -ldriver -lconsole -lod -lxtensa-debug-module  -lstdc++
+compiler.c.elf.libs=-lgcc -lcore -lsmartconfig_ack -lwear_levelling -limage_util -lmesh -lface_detection -lsoc -lbtdm_app -lesp-tls -lesp_https_ota -lcoap -ldl -lefuse -lspiffs -lspi_flash -lpp -lethernet -lhal -lm -ltcpip_adapter -lfatfs -lwpa2 -lprotobuf-c -lmqtt -ltcp_transport -lfreemodbus -lheap -lrtc -lc_nano -llibsodium -lnewlib -lbootloader_support -ljsmn -lmbedtls -lsdmmc -lesp_websocket_client -lprotocomm -lwps -lconsole -lphy -lespcoredump -lesp_http_client -ldetection -lnghttp -lvfs -lunity -lpe -ldetection_cat_face -lwpa_supplicant -lfreertos -lespnow -lwpa -lnvs_flash -lpthread -lmicro-ecc -ljson -llog -lesp_event -lesp_http_server -lcoexist -lnet80211 -lfd -lxtensa-debug-module -lesp32-camera -lwifi_provisioning -lexpat -lapp_update -lmdns -lsmartconfig -lc -lesp32 -lface_recognition -lopenssl -lulp -lesp_ringbuf -lfr -lasio -ldriver -llwip -lfb_gfx -lbt -lesp_https_server -lcxx -lesp_adc_cal -lod -lapp_trace  -lstdc++
 
 compiler.as.cmd=xtensa-esp32-elf-as
 

tools/platformio-build.py

@@ -170,7 +170,7 @@
     ],
 
     LIBS=[
-        "-lgcc", "-ldetection_cat_face", "-lespcoredump", "-lwpa", "-lrtc", "-lvfs", "-lnewlib", "-ldetection", "-lfreemodbus", "-lprotocomm", "-lwpa_supplicant", "-lfatfs", "-lsmartconfig", "-lesp_ringbuf", "-lfd", "-lesp_adc_cal", "-lspiffs", "-lopenssl", "-lsdmmc", "-ljsmn", "-lespnow", "-lc", "-lbootloader_support", "-lesp_https_server", "-lcore", "-lspi_flash", "-lmicro-ecc", "-lunity", "-lapp_trace", "-lexpat", "-lheap", "-ltcp_transport", "-lfr", "-lfb_gfx", "-lethernet", "-lesp_websocket_client", "-lesp32-camera", "-lcoexist", "-lpthread", "-lmqtt", "-lface_recognition", "-llwip", "-lasio", "-lefuse", "-lnvs_flash", "-lhal", "-lcxx", "-lesp_event", "-lfreertos", "-llibsodium", "-lwear_levelling", "-ljson", "-lesp32", "-lcoap", "-lbt", "-lbtdm_app", "-lmbedtls", "-lwpa2", "-lface_detection", "-lesp-tls", "-lwps", "-lpe", "-lmdns", "-lmesh", "-lesp_http_server", "-llog", "-lesp_http_client", "-lsoc", "-lc_nano", "-lnghttp", "-lprotobuf-c", "-lphy", "-lesp_https_ota", "-lwifi_provisioning", "-ldl", "-lulp", "-limage_util", "-lnet80211", "-lsmartconfig_ack", "-lapp_update", "-lm", "-ltcpip_adapter", "-lpp", "-ldriver", "-lconsole", "-lod", "-lxtensa-debug-module", "-lstdc++"
+        "-lgcc", "-lcore", "-lsmartconfig_ack", "-lwear_levelling", "-limage_util", "-lmesh", "-lface_detection", "-lsoc", "-lbtdm_app", "-lesp-tls", "-lesp_https_ota", "-lcoap", "-ldl", "-lefuse", "-lspiffs", "-lspi_flash", "-lpp", "-lethernet", "-lhal", "-lm", "-ltcpip_adapter", "-lfatfs", "-lwpa2", "-lprotobuf-c", "-lmqtt", "-ltcp_transport", "-lfreemodbus", "-lheap", "-lrtc", "-lc_nano", "-llibsodium", "-lnewlib", "-lbootloader_support", "-ljsmn", "-lmbedtls", "-lsdmmc", "-lesp_websocket_client", "-lprotocomm", "-lwps", "-lconsole", "-lphy", "-lespcoredump", "-lesp_http_client", "-ldetection", "-lnghttp", "-lvfs", "-lunity", "-lpe", "-ldetection_cat_face", "-lwpa_supplicant", "-lfreertos", "-lespnow", "-lwpa", "-lnvs_flash", "-lpthread", "-lmicro-ecc", "-ljson", "-llog", "-lesp_event", "-lesp_http_server", "-lcoexist", "-lnet80211", "-lfd", "-lxtensa-debug-module", "-lesp32-camera", "-lwifi_provisioning", "-lexpat", "-lapp_update", "-lmdns", "-lsmartconfig", "-lc", "-lesp32", "-lface_recognition", "-lopenssl", "-lulp", "-lesp_ringbuf", "-lfr", "-lasio", "-ldriver", "-llwip", "-lfb_gfx", "-lbt", "-lesp_https_server", "-lcxx", "-lesp_adc_cal", "-lod", "-lapp_trace", "-lstdc++"
     ],
 
     LIBSOURCE_DIRS=[

tools/sdk/bin/bootloader_dio_40m.bin

@@ -18,6 +18,7 @@
 #define CONFIG_LWIP_ETHARP_TRUST_IP_MAC 1
 #define CONFIG_BLE_SCAN_DUPLICATE 1
 #define CONFIG_STACK_CHECK_NORM 1
+#define CONFIG_GC032A_SUPPORT 1
 #define CONFIG_TCP_WND_DEFAULT 5744
 #define CONFIG_PARTITION_TABLE_OFFSET 0x8000
 #define CONFIG_SW_COEXIST_ENABLE 1
@@ -33,6 +34,7 @@
 #define CONFIG_SCCB_HARDWARE_I2C_PORT1 1
 #define CONFIG_MBEDTLS_KEY_EXCHANGE_RSA 1
 #define CONFIG_UDP_RECVMBOX_SIZE 6
+#define CONFIG_GC0308_SUPPORT 1
 #define CONFIG_APP_RETRIEVE_LEN_ELF_SHA 16
 #define CONFIG_ARDUHAL_PARTITION_SCHEME_DEFAULT 1
 #define CONFIG_FREERTOS_QUEUE_REGISTRY_SIZE 0
@@ -128,8 +130,10 @@
 #define CONFIG_NUMBER_OF_UNIVERSAL_MAC_ADDRESS 4
 #define CONFIG_ESPTOOLPY_FLASHSIZE_DETECT 1
 #define CONFIG_AUTOSTART_ARDUINO 1
+#define CONFIG_GC_SENSOR_SUBSAMPLE_MODE 1
 #define CONFIG_ARDUINO_RUNNING_CORE 1
 #define CONFIG_ESP32_ECO3_CACHE_LOCK_FIX 1
+#define CONFIG_CAMERA_DMA_BUFFER_SIZE_MAX 32768
 #define CONFIG_PPP_CHAP_SUPPORT 1
 #define CONFIG_LOG_DEFAULT_LEVEL_ERROR 1
 #define CONFIG_TIMER_TASK_STACK_SIZE 4096
@@ -276,6 +280,7 @@
 #define CONFIG_ARDUINO_UDP_TASK_PRIORITY 3
 #define CONFIG_MBEDTLS_SSL_SESSION_TICKETS 1
 #define CONFIG_SPIFFS_MAX_PARTITIONS 3
+#define CONFIG_GC2145_SUPPORT 1
 #define CONFIG_ESP_ERR_TO_NAME_LOOKUP 1
 #define CONFIG_BTDM_CONTROLLER_PINNED_TO_CORE_0 1
 #define CONFIG_MBEDTLS_SSL_RENEGOTIATION 1
@@ -397,5 +402,5 @@
 #define CONFIG_BTDM_MODEM_SLEEP_MODE_ORIG 1
 #define CONFIG_ARDUHAL_LOG_DEFAULT_LEVEL_ERROR 1
 #define CONFIG_FATFS_API_ENCODING_ANSI_OEM 1
-#define CONFIG_ARDUINO_IDF_COMMIT "b65a37795"
+#define CONFIG_ARDUINO_IDF_COMMIT "44e9dd3e29"
 #define CONFIG_ARDUINO_IDF_BRANCH "release/v3.3"

tools/sdk/bin/bootloader_dio_80m.bin

@@ -85,7 +85,7 @@ typedef struct {
     int sclk_io_num;                ///< GPIO pin for Spi CLocK signal, or -1 if not used.
     int quadwp_io_num;              ///< GPIO pin for WP (Write Protect) signal which is used as D2 in 4-bit communication modes, or -1 if not used.
     int quadhd_io_num;              ///< GPIO pin for HD (HolD) signal which is used as D3 in 4-bit communication modes, or -1 if not used.
-    int max_transfer_sz;            ///< Maximum transfer size, in bytes. Defaults to 4094 if 0.
+    int max_transfer_sz;            ///< Maximum transfer size, in bytes. Defaults to 4092 if 0 when DMA enabled, or to 64 if DMA is disabled.
     uint32_t flags;                 ///< Abilities of bus to be checked by the driver. Or-ed value of ``SPICOMMON_BUSFLAG_*`` flags.
     int intr_flags;    /**< Interrupt flag for the bus to set the priority, and IRAM attribute, see
                          *  ``esp_intr_alloc.h``. Note that the EDGE, INTRDISABLED attribute are ignored

tools/sdk/bin/bootloader_dout_40m.bin

@@ -83,6 +83,14 @@ typedef enum {
     CAMERA_GRAB_LATEST              /*!< Except when 1 frame buffer is used, queue will always contain the last 'fb_count' frames */
 } camera_grab_mode_t;
 
+/**
+ * @brief Camera frame buffer location 
+ */
+typedef enum {
+    CAMERA_FB_IN_PSRAM,         /*!< Frame buffer is placed in external PSRAM */
+    CAMERA_FB_IN_DRAM           /*!< Frame buffer is placed in internal DRAM */
+} camera_fb_location_t;
+
 /**
  * @brief Configuration structure for camera initialization
  */
@@ -114,6 +122,7 @@ typedef struct {
 
     int jpeg_quality;               /*!< Quality of JPEG output. 0-63 lower means higher quality  */
     size_t fb_count;                /*!< Number of frame buffers to be allocated. If more than one, then each frame will be acquired (double speed)  */
+    camera_fb_location_t fb_location; /*!< The location where the frame buffer will be allocated */
     camera_grab_mode_t grab_mode;   /*!< When buffers should be filled */
 } camera_config_t;
 

tools/sdk/bin/bootloader_dout_80m.bin

@@ -11,23 +11,21 @@
 #include <stdint.h>
 #include <stdbool.h>
 
-// Chip ID Registers
-#define REG_PID        0x0A
-#define REG_VER        0x0B
-#define REG_MIDH       0x1C
-#define REG_MIDL       0x1D
-
-#define REG16_CHIDH     0x300A
-#define REG16_CHIDL     0x300B
+#ifdef __cplusplus
+extern "C" {
+#endif
 
 typedef enum {
     OV9650_PID = 0x96,
     OV7725_PID = 0x77,
     OV2640_PID = 0x26,
-    OV3660_PID = 0x36,
-    OV5640_PID = 0x56,
+    OV3660_PID = 0x3660,
+    OV5640_PID = 0x5640,
     OV7670_PID = 0x76,
-    NT99141_PID = 0x14
+    NT99141_PID = 0x1410,
+    GC2145_PID = 0x2145,
+    GC032A_PID = 0x232a,
+    GC0308_PID = 0x9b,
 } camera_pid_t;
 
 typedef enum {
@@ -37,18 +35,23 @@ typedef enum {
     CAMERA_OV5640,
     CAMERA_OV7670,
     CAMERA_NT99141,
+    CAMERA_GC2145,
+    CAMERA_GC032A,
+    CAMERA_GC0308,
     CAMERA_MODEL_MAX,
     CAMERA_NONE,
-    CAMERA_UNKNOWN
 } camera_model_t;
 
 typedef enum {
-    OV2640_SCCB_ADDR   = 0x30,
-    OV5640_SCCB_ADDR   = 0x3C,
-    OV3660_SCCB_ADDR   = 0x3C,
-    OV7725_SCCB_ADDR   = 0x21,
-    OV7670_SCCB_ADDR   = 0x21,
-    NT99141_SCCB_ADDR  = 0x2A,
+    OV2640_SCCB_ADDR   = 0x30,// 0x60 >> 1
+    OV5640_SCCB_ADDR   = 0x3C,// 0x78 >> 1
+    OV3660_SCCB_ADDR   = 0x3C,// 0x78 >> 1
+    OV7725_SCCB_ADDR   = 0x21,// 0x42 >> 1
+    OV7670_SCCB_ADDR   = 0x21,// 0x42 >> 1
+    NT99141_SCCB_ADDR  = 0x2A,// 0x54 >> 1
+    GC2145_SCCB_ADDR   = 0x3C,// 0x78 >> 1
+    GC032A_SCCB_ADDR   = 0x21,// 0x42 >> 1
+    GC0308_SCCB_ADDR   = 0x21,// 0x42 >> 1
 } camera_sccb_addr_t;
 
 typedef enum {
@@ -92,9 +95,11 @@ typedef enum {
 
 typedef struct {
     const camera_model_t model;
+    const char *name;
     const camera_sccb_addr_t sccb_addr;
     const camera_pid_t pid;
     const framesize_t max_size;
+    const bool support_jpeg;
 } camera_sensor_info_t;
 
 typedef enum {
@@ -146,7 +151,7 @@ extern const camera_sensor_info_t camera_sensor[];
 typedef struct {
     uint8_t MIDH;
     uint8_t MIDL;
-    uint8_t PID;
+    uint16_t PID;
     uint8_t VER;
 } sensor_id_t;
 
@@ -231,4 +236,10 @@ typedef struct _sensor {
     int  (*set_xclk)            (sensor_t *sensor, int timer, int xclk);
 } sensor_t;
 
+camera_sensor_info_t *esp_camera_sensor_get_info(sensor_id_t *id);
+
+#ifdef __cplusplus
+}
+#endif
+
 #endif /* __SENSOR_H__ */

tools/sdk/bin/bootloader_qio_40m.bin

@@ -49,6 +49,7 @@ typedef struct {
  *
  * @return
  *  - ESP_OK: Success
+ *  - ESP_ERR_INVALID_ARG: event_loop_args or event_loop was NULL
  *  - ESP_ERR_NO_MEM: Cannot allocate memory for event loops list
  *  - ESP_FAIL: Failed to create task loop
  *  - Others: Fail
@@ -58,7 +59,7 @@ esp_err_t esp_event_loop_create(const esp_event_loop_args_t* event_loop_args, es
 /**
  * @brief Delete an existing event loop.
  *
- * @param[in] event_loop event loop to delete
+ * @param[in] event_loop event loop to delete, must not be NULL
  *
  * @return
  *  - ESP_OK: Success
@@ -103,7 +104,7 @@ esp_err_t esp_event_loop_delete_default();
  * In cases where waiting on the queue times out, ESP_OK is returned and not ESP_ERR_TIMEOUT, since it is
  * normal behavior.
  *
- * @param[in] event_loop event loop to dispatch posted events from
+ * @param[in] event_loop event loop to dispatch posted events from, must not be NULL
  * @param[in] ticks_to_run number of ticks to run the loop
  *
  * @note encountering an unknown event that has been posted to the loop will only generate a warning, not an error.
@@ -153,7 +154,7 @@ esp_err_t esp_event_handler_register(esp_event_base_t event_base,
  * This function behaves in the same manner as esp_event_handler_register, except the additional
  * specification of the event loop to register the handler to.
  *
- * @param[in] event_loop the event loop to register this handler function to
+ * @param[in] event_loop the event loop to register this handler function to, must not be NULL
  * @param[in] event_base the base id of the event to register the handler for
  * @param[in] event_id the id of the event to register the handler for
  * @param[in] event_handler the handler function which gets called when the event is dispatched
@@ -169,23 +170,23 @@ esp_err_t esp_event_handler_register(esp_event_base_t event_base,
  *  - Others: Fail
  */
 esp_err_t esp_event_handler_register_with(esp_event_loop_handle_t event_loop,
-                                            esp_event_base_t event_base,
-                                            int32_t event_id,
-                                            esp_event_handler_t event_handler,
-                                            void* event_handler_arg);
+                                          esp_event_base_t event_base,
+                                          int32_t event_id,
+                                          esp_event_handler_t event_handler,
+                                          void *event_handler_arg);
 
 /**
  * @brief Unregister a handler with the system event loop.
  *
- * This function can be used to unregister a handler so that it no longer gets called during dispatch.
- * Handlers can be unregistered for either: (1) specific events, (2) all events of a certain event base,
- * or (3) all events known by the system event loop
- *
- *  - specific events: specify exact event_base and event_id
- *  - all events of a certain base: specify exact event_base and use ESP_EVENT_ANY_ID as the event_id
- *  - all events known by the loop: use ESP_EVENT_ANY_BASE for event_base and ESP_EVENT_ANY_ID as the event_id
+ * Unregisters a handler so it will no longer be called during dispatch.
+ * Handlers can be unregistered for any combination of event_base and event_id which were previously registered.
+ * To unregister a handler, the event_base and event_id arguments must match exactly the arguments passed to
+ * esp_event_handler_register() when that handler was registered. Passing ESP_EVENT_ANY_BASE and/or ESP_EVENT_ANY_ID
+ * will only unregister handlers that were registered with the same wildcard arguments.
  *
- * This function ignores unregistration of handlers that has not been previously registered.
+ * @note When using ESP_EVENT_ANY_ID, handlers registered to specific event IDs using the same base will not be
+ *       unregistered. When using ESP_EVENT_ANY_BASE, events registered to specific bases will also not be
+ *       unregistered. This avoids accidental unregistration of handlers registered by other users or components.
  *
  * @param[in] event_base the base of the event with which to unregister the handler
  * @param[in] event_id the id of the event with which to unregister the handler
@@ -203,7 +204,7 @@ esp_err_t esp_event_handler_unregister(esp_event_base_t event_base, int32_t even
  * This function behaves in the same manner as esp_event_handler_unregister, except the additional specification of
  * the event loop to unregister the handler with.
  *
- * @param[in] event_loop the event loop with which to unregister this handler function
+ * @param[in] event_loop the event loop with which to unregister this handler function, must not be NULL
  * @param[in] event_base the base of the event with which to unregister the handler
  * @param[in] event_id the id of the event with which to unregister the handler
  * @param[in] event_handler the handler to unregister
@@ -251,7 +252,7 @@ esp_err_t esp_event_post(esp_event_base_t event_base,
  * This function behaves in the same manner as esp_event_post_to, except the additional specification of the event loop
  * to post the event to.
  *
- * @param[in] event_loop the event loop to post to
+ * @param[in] event_loop the event loop to post to, must not be NULL
  * @param[in] event_base the event base that identifies the event
  * @param[in] event_id the the event id that identifies the event
  * @param[in] event_data the data, specific to the event occurence, that gets passed to the handler
@@ -323,4 +324,4 @@ esp_err_t esp_event_dump(FILE* file);
 } // extern "C"
 #endif
 
-#endif // #ifndef ESP_EVENT_H_
+#endif // #ifndef ESP_EVENT_H_

tools/sdk/bin/bootloader_qio_80m.bin

@@ -88,14 +88,14 @@
 /* MBEDTLS_ERR_ARIA_HW_ACCEL_FAILED is deprecated and should not be used. */
 #define MBEDTLS_ERR_ARIA_HW_ACCEL_FAILED      -0x0058  /**< ARIA hardware accelerator failed. */
 
-#if !defined(MBEDTLS_ARIA_ALT)
-// Regular implementation
-//
-
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+#if !defined(MBEDTLS_ARIA_ALT)
+// Regular implementation
+//
+
 /**
  * \brief The ARIA context-type definition.
  */

tools/sdk/bin/bootloader_qout_40m.bin

@@ -71,6 +71,46 @@
 
 #include "bignum.h"
 
+
+/*
+ * Conversion macros for embedded constants:
+ * build lists of mbedtls_mpi_uint's from lists of unsigned char's grouped by 8, 4 or 2
+ */
+#if defined(MBEDTLS_HAVE_INT32)
+
+#define MBEDTLS_BYTES_TO_T_UINT_4( a, b, c, d )               \
+    ( (mbedtls_mpi_uint) (a) <<  0 ) |                        \
+    ( (mbedtls_mpi_uint) (b) <<  8 ) |                        \
+    ( (mbedtls_mpi_uint) (c) << 16 ) |                        \
+    ( (mbedtls_mpi_uint) (d) << 24 )
+
+#define MBEDTLS_BYTES_TO_T_UINT_2( a, b )                   \
+    MBEDTLS_BYTES_TO_T_UINT_4( a, b, 0, 0 )
+
+#define MBEDTLS_BYTES_TO_T_UINT_8( a, b, c, d, e, f, g, h ) \
+    MBEDTLS_BYTES_TO_T_UINT_4( a, b, c, d ),                \
+    MBEDTLS_BYTES_TO_T_UINT_4( e, f, g, h )
+
+#else /* 64-bits */
+
+#define MBEDTLS_BYTES_TO_T_UINT_8( a, b, c, d, e, f, g, h )   \
+    ( (mbedtls_mpi_uint) (a) <<  0 ) |                        \
+    ( (mbedtls_mpi_uint) (b) <<  8 ) |                        \
+    ( (mbedtls_mpi_uint) (c) << 16 ) |                        \
+    ( (mbedtls_mpi_uint) (d) << 24 ) |                        \
+    ( (mbedtls_mpi_uint) (e) << 32 ) |                        \
+    ( (mbedtls_mpi_uint) (f) << 40 ) |                        \
+    ( (mbedtls_mpi_uint) (g) << 48 ) |                        \
+    ( (mbedtls_mpi_uint) (h) << 56 )
+
+#define MBEDTLS_BYTES_TO_T_UINT_4( a, b, c, d )             \
+    MBEDTLS_BYTES_TO_T_UINT_8( a, b, c, d, 0, 0, 0, 0 )
+
+#define MBEDTLS_BYTES_TO_T_UINT_2( a, b )                   \
+    MBEDTLS_BYTES_TO_T_UINT_8( a, b, 0, 0, 0, 0, 0, 0 )
+
+#endif /* bits in mbedtls_mpi_uint */
+
 #if defined(MBEDTLS_HAVE_ASM)
 
 #ifndef asm

tools/sdk/bin/bootloader_qout_80m.bin

@@ -453,7 +453,7 @@
  *       be overridden, but the wrapper functions mbedtls_aes_decrypt and mbedtls_aes_encrypt
  *       must stay untouched.
  *
- * \note If you use the AES_xxx_ALT macros, then is is recommended to also set
+ * \note If you use the AES_xxx_ALT macros, then it is recommended to also set
  *       MBEDTLS_AES_ROM_TABLES in order to help the linker garbage-collect the AES
  *       tables.
  *
@@ -1746,6 +1746,23 @@
  */
 //#define MBEDTLS_SSL_TRUNCATED_HMAC_COMPAT
 
+/**
+ * \def MBEDTLS_TEST_HOOKS
+ *
+ * Enable features for invasive testing such as introspection functions and
+ * hooks for fault injection. This enables additional unit tests.
+ *
+ * Merely enabling this feature should not change the behavior of the product.
+ * It only adds new code, and new branching points where the default behavior
+ * is the same as when this feature is disabled.
+ * However, this feature increases the attack surface: there is an added
+ * risk of vulnerabilities, and more gadgets that can make exploits easier.
+ * Therefore this feature must never be enabled in production.
+ *
+ * Uncomment to enable invasive tests.
+ */
+//#define MBEDTLS_TEST_HOOKS
+
 /**
  * \def MBEDTLS_THREADING_ALT
  *