Mirrors/esp-idf
1
0
Fork 0
mirror of https://github.com/espressif/esp-idf.git synced 2026-10-02 03:00:34 +03:00
Code Issues Packages Projects Releases Wiki Activity

feat(csi): add MIPI-CSI host error event

Browse Source
This commit is contained in:
gaoxu
2026-07-13 18:03:57 +08:00
parent df9d2b7ab8
commit 9f977715c7
6 changed files with 250 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files
components/esp_driver_cam/include/esp_cam_ctlr_types.h
+37 -2
View File
@@ -1,5 +1,5 @@
/*
* SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
* SPDX-FileCopyrightText: 2024-2026 Espressif Systems (Shanghai) CO LTD
*
* SPDX-License-Identifier: Apache-2.0
*/
@@ -8,7 +8,7 @@
#include <stdint.h>
#include <stdbool.h>
#include "esp_err.h"
#include <stddef.h>
#ifdef __cplusplus
extern "C" {
@@ -33,6 +33,26 @@ typedef struct {
size_t received_size; /*!< Received size. This value is written by the driver and indicates the actual received size. */
} esp_cam_ctlr_trans_t;
/**
* @brief ESP CAM controller CSI host error flags.
*
* @note These flags summarize the CSI host error type(s) and avoid exposing hardware bit layout.
*/
typedef enum {
ESP_CAM_CTLR_CSI_HOST_ERR_PHY = (1U << 0), /*!< PHY error. */
ESP_CAM_CTLR_CSI_HOST_ERR_PACKET = (1U << 1), /*!< Packet error. */
ESP_CAM_CTLR_CSI_HOST_ERR_FRAME = (1U << 2), /*!< Frame boundary or sequence error. */
ESP_CAM_CTLR_CSI_HOST_ERR_CRC = (1U << 3), /*!< Frame or payload CRC error. */
ESP_CAM_CTLR_CSI_HOST_ERR_DATA_ID = (1U << 4), /*!< Unrecognized or unsupported data type detected. */
} esp_cam_ctlr_csi_host_error_t;
/**
* @brief ESP CAM controller "error" event data.
*/
typedef struct {
uint32_t csi_host_err_evts; /*!< Bitwise OR of `esp_cam_ctlr_csi_host_error_t`. */
} esp_cam_ctlr_error_event_data_t;
/**
* @brief Event callbacks for the ESP CAM controller.
*/
@@ -59,6 +79,21 @@ typedef struct {
*/
bool (*on_trans_finished)(esp_cam_ctlr_handle_t handle, esp_cam_ctlr_trans_t *trans, void *user_data);
/**
* @brief Callback for when an error is detected.
*
* @note This callback is invoked from ISR context, so it must not call any blocking APIs.
* When the controller's ISR cache-safe option is enabled, this callback and its
* user data must be placed in internal RAM.
*
* @param[in] handle ESP CAM controller handle.
* @param[in] edata Error event data.
* @param[in] user_data User-registered data.
*
* @return Whether a high-priority task is woken up by this function.
*/
bool (*on_error)(esp_cam_ctlr_handle_t handle, const esp_cam_ctlr_error_event_data_t *edata, void *user_data);
} esp_cam_ctlr_evt_cbs_t;
#ifdef __cplusplus