hpm_cam_drv.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021-2025 HPMicro
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *
 */
 
#ifndef HPM_CAM_DRV_H
#define HPM_CAM_DRV_H
 
#include "hpm_common.h"
#include "hpm_display_common.h"
#include "hpm_cam_regs.h"
#include "hpm_soc_feature.h"
 
#define CAM_DATA_STORE_MODE_NORMAL (0U)
#define CAM_DATA_STORE_MODE_Y_UV_PLANES (CAM_CR1_STORAGE_MODE_SET(1))
#define CAM_DATA_STORE_MODE_Y_ONLY (CAM_CR1_STORAGE_MODE_SET(2))
#define CAM_DATA_STORE_MODE_BINARY (CAM_CR1_STORAGE_MODE_SET(3))
 
#define CAM_SENSOR_BITWIDTH_8BITS (CAM_CR1_SENSOR_BIT_WIDTH_SET(0))
#define CAM_SENSOR_BITWIDTH_10BITS (CAM_CR1_SENSOR_BIT_WIDTH_SET(1))
#define CAM_SENSOR_BITWIDTH_24BITS (CAM_CR1_SENSOR_BIT_WIDTH_SET(3))
 
typedef enum {
    cam_irq_unsupported_configuration = CAM_INT_EN_ERR_CL_BWID_CFG_INT_EN_MASK,
    cam_irq_hist_calculation_done = CAM_INT_EN_HIST_DONE_INT_EN_MASK,
    cam_irq_hresponse_error = CAM_INT_EN_HRESP_ERR_EN_MASK,
    cam_irq_end_of_frame = CAM_INT_EN_EOF_INT_EN_MASK,
    cam_irq_rx_fifo_overrun = CAM_INT_EN_RF_OR_INTEN_MASK,
    cam_irq_fb2_dma_transfer_done = CAM_INT_EN_FB2_DMA_DONE_INTEN_MASK,
    cam_irq_fb1_dma_transfer_done = CAM_INT_EN_FB1_DMA_DONE_INTEN_MASK,
    cam_irq_start_of_frame = CAM_INT_EN_SOF_INT_EN_MASK
} cam_irq_mask_t;
 
typedef enum {
    cam_status_unsupported_configuration = CAM_STA_ERR_CL_BWID_CFG_MASK,
    cam_status_hist_calculation_done = CAM_STA_HIST_DONE_MASK,
    cam_status_rx_fifo_overrun = CAM_STA_RF_OR_INT_MASK,
    cam_status_fb2_dma_transfer_done = CAM_STA_DMA_TSF_DONE_FB2_MASK,
    cam_status_fb1_dma_transfer_done = CAM_STA_DMA_TSF_DONE_FB1_MASK,
    cam_status_end_of_frame = CAM_STA_EOF_INT_MASK,
    cam_status_start_of_frame = CAM_STA_SOF_INT_MASK,
    cam_status_hresponse_error = CAM_STA_HRESP_ERR_INT_MASK
} cam_status_mask_t;
 
#define CAM_COLOR_FORMAT_RGB888 (CAM_CR1_COLOR_FORMATS_SET(2))
#define CAM_COLOR_FORMAT_RGB565 (CAM_CR1_COLOR_FORMATS_SET(4))
#define CAM_COLOR_FORMAT_RGB555 (CAM_CR1_COLOR_FORMATS_SET(6))
#define CAM_COLOR_FORMAT_YCBCR422_YUV422 (CAM_CR1_COLOR_FORMATS_SET(7))
#define CAM_COLOR_FORMAT_YUV444 (CAM_CR1_COLOR_FORMATS_SET(8))
#define CAM_COLOR_FORMAT_RAW8 (CAM_CR1_COLOR_FORMATS_SET(0xf))
#define CAM_COLOR_FORMAT_UNSUPPORTED (1)
 
typedef struct {
    uint32_t width;
    uint32_t height;
    bool pixclk_sampling_falling;
#if defined(HPM_IP_FEATURE_CAM_INV_DEN) && (HPM_IP_FEATURE_CAM_INV_DEN == 1)
    bool de_active_low; /* de_active_low must is same with hsync_active_low when dvp be used */
#endif
    bool hsync_active_low;
    bool vsync_active_low;
    bool color_ext;
    bool data_pack_msb;
    uint16_t data_store_mode;
    uint8_t color_format;
    uint8_t sensor_bitwidth;
    uint32_t buffer1;
    uint32_t buffer2;
    display_yuv2rgb_config_t csc_config;
    uint32_t colorkey_low;
    uint32_t colorkey_high;
} cam_config_t;
 
typedef enum {
    cam_input_pixel_yuv444 = 0,    /* Y[23:16] U[15:8] V[7:0] */
    cam_input_pixel_yvu444 = 1,    /* Y[23:16] V[15:8] U[7:0] */
    cam_input_pixel_uyv444 = 2,    /* U[23:16] Y[15:8] V[7:0] */
    cam_input_pixel_vyu444 = 3,    /* V[23:16] Y[15:8] U[7:0] */
    cam_input_pixel_uvy444 = 4,    /* U[23:16] V[15:8] Y[7:0] */
    cam_input_pixel_vuy444 = 5,    /* V[23:16] U[15:8] Y[7:0] */
    cam_input_pixel_yuyv422 = 0,   /* Y0[31:24] U0[23:16] Y1[15:8] V0[7:0] */
    cam_input_pixel_yvyu422 = 1,   /* Y0[31:24] V0[23:16] Y1[15:8] U0[7:0] */
    cam_input_pixel_uyvy422 = 2,   /* U0[31:24] Y0[23:16] V0[15:8] Y1[7:0] */
    cam_input_pixel_vyuy422 = 3,   /* V0[31:24] Y0[23:16] U0[15:8] Y1[7:0] */
    cam_input_pixel_rgb565 = 0,    /* R[15:11] G[10:8] G[7:5] B[4:0] */
    cam_input_pixel_bgr565 = 1,    /* B[15:11] G[10:8] G[7:5] R[4:0] */
    cam_input_pixel_gbr888 = 0,    /* G[23:16] B[15:8] R[7:0] */
    cam_input_pixel_grb888 = 1,    /* G[23:16] R[15:8] B[7:0] */
    cam_input_pixel_bgr888 = 2,    /* B[23:16] G[15:8] R[7:0] */
    cam_input_pixel_rgb888 = 3,    /* R[23:16] G[15:8] B[7:0] */
    cam_input_pixel_brg888 = 4,    /* B[23:16] R[15:8] G[7:0] */
    cam_input_pixel_rbg888 = 5,    /* R[23:16] B[15:8] G[7:0] */
} cam_input_pixel_byte_order_t;
 
#ifdef __cplusplus
extern "C" {
#endif
 
static inline uint32_t cam_get_pixel_format(display_pixel_format_t format)
{
    switch (format) {
    case display_pixel_format_rgb565:
        return CAM_COLOR_FORMAT_RGB565;
    case display_pixel_format_yuv422:
    case display_pixel_format_ycbcr422:
        return CAM_COLOR_FORMAT_YCBCR422_YUV422;
    case display_pixel_format_raw8:
        return CAM_COLOR_FORMAT_RAW8;
    default:
        return CAM_COLOR_FORMAT_UNSUPPORTED;
    }
}
 
static inline void cam_set_color_key(CAM_Type *ptr, uint32_t high, uint32_t low)
{
    ptr->CLRKEY_LOW = CAM_CLRKEY_LOW_LIMIT_SET(low);
    ptr->CLRKEY_HIGH = CAM_CLRKEY_HIGH_LIMIT_SET(high);
}
 
void cam_get_default_config(CAM_Type *ptr, cam_config_t *config, display_pixel_format_t pixel_format);
 
hpm_stat_t cam_init(CAM_Type *ptr, cam_config_t *config);
 
void cam_start(CAM_Type *ptr);
 
void cam_stop(CAM_Type *ptr);
 
static inline void cam_update_buffer(CAM_Type *ptr, uint32_t buffer)
{
    ptr->DMASA_FB1 = buffer;
}
 
static inline void cam_update_buffer2(CAM_Type *ptr, uint32_t buffer)
{
    ptr->DMASA_FB2 = buffer;
}
 
static inline void cam_enable_binary_output(CAM_Type *ptr)
{
    ptr->CR20 |= CAM_CR20_BINARY_EN_MASK;
}
 
static inline void cam_disable_binary_output(CAM_Type *ptr)
{
    ptr->CR20 &= ~CAM_CR20_BINARY_EN_MASK;
}
 
static inline void cam_set_binary_threshold(CAM_Type *ptr, uint8_t threshold)
{
    ptr->CR20 = (ptr->CR20 & (~CAM_CR20_THRESHOLD_MASK)) | CAM_CR20_THRESHOLD_SET(threshold);
}
 
static inline void cam_enable_argb8888_output(CAM_Type *ptr)
{
    ptr->CR1 |= CAM_CR1_COLOR_EXT_MASK;
}
 
static inline void cam_disable_argb8888_output(CAM_Type *ptr)
{
    ptr->CR1 &= ~CAM_CR1_COLOR_EXT_MASK;
}
 
static inline void cam_set_input_pixel_byte_order(CAM_Type *ptr, cam_input_pixel_byte_order_t order)
{
    ptr->CR2 = (ptr->CR2 & (~CAM_CR2_CLRBITFORMAT_MASK)) | CAM_CR2_CLRBITFORMAT_SET(order);
}
 
static inline void cam_enable_irq(CAM_Type *ptr, cam_irq_mask_t irq_mask)
{
    ptr->INT_EN |= irq_mask;
}
 
 
static inline void cam_disable_irq(CAM_Type *ptr, cam_irq_mask_t irq_mask)
{
    ptr->INT_EN &= ~irq_mask;
}
 
static inline bool cam_check_status(CAM_Type *ptr, cam_status_mask_t sta_mask)
{
    return ((ptr->STA & sta_mask) != 0U) ? true : false;
}
 
static inline void cam_clear_status(CAM_Type *ptr, cam_status_mask_t sta_mask)
{
    ptr->STA = sta_mask;
}
 
void cam_stop_safely(CAM_Type *ptr);
 
#ifdef __cplusplus
}
#endif
 
#endif /* HPM_CAM_DRV_H */