hpm_pixelmux_drv.h

Go to the documentation of this file.

/*
 * Copyright (c) 2023 HPMicro
 *
 * SPDX-License-Identifier: BSD-3-Clause
 *
 */
 
#ifndef HPM_PIXELMUX_DRV_H
#define HPM_PIXELMUX_DRV_H
 
#include "hpm_common.h"
#include "hpm_soc.h"
#include "hpm_pixelmux_regs.h"
 
typedef enum {
    pixelmux_rgb_sel_lcdc0 = 0,
    pixelmux_rgb_sel_lcdc1
} pixelmux_rgb_select_t;
 
typedef enum {
    pixelmux_gwc1_sel_lcdc0 = 0,
    pixelmux_gwc1_sel_lcdc1
} pixelmux_gwc1_select_t;
 
typedef enum {
    pixelmux_gwc0_sel_lcdc0 = 0,
    pixelmux_gwc0_sel_lcdc1
} pixelmux_gwc0_select_t;
 
typedef enum {
    pixelmux_lvb_di1_sel_lcdc0 = 0,
    pixelmux_lvb_di1_sel_lcdc1
} pixelmux_lvb_di1_select_t;
 
typedef enum {
    pixelmux_lvb_di0_sel_lcdc0 = 0,
    pixelmux_lvb_di0_sel_lcdc1
} pixelmux_lvb_di0_select_t;
 
typedef enum {
    pixelmux_mipi_dsi1_sel_lcdc0 = 0,
    pixelmux_mipi_dsi1_sel_lcdc1
} pixelmux_mipi_dsi1_select_t;
 
typedef enum {
    pixelmux_mipi_dsi0_sel_lcdc0 = 0,
    pixelmux_mipi_dsi0_sel_lcdc1
} pixelmux_mipi_dsi0_select_t;
 
typedef enum {
    pixelmux_mipi_dsi_data_type_rgb565 = 0,
    pixelmux_mipi_dsi_data_type_rgb666 = 3,
    pixelmux_mipi_dsi_data_type_rgb666_packed = 4,
    pixelmux_mipi_dsi_data_type_rgb888 = 5,
} pixelmux_mipi_dsi_data_type_t;
 
typedef enum {
    pixelmux_cam1_sel_dvp = 0,
    pixelmux_cam1_sel_mipi_csi0,
    pixelmux_cam1_sel_mipi_csi1,
    pixelmux_cam1_sel_lcdc0,
    pixelmux_cam1_sel_lcdc1,
    pixelmux_cam1_sel_lcb_do0,
    pixelmux_cam1_sel_lcb_do1,
} pixelmux_cam1_select_t;
 
typedef enum {
    pixelmux_cam0_sel_dvp = 0,
    pixelmux_cam0_sel_mipi_csi0,
    pixelmux_cam0_sel_mipi_csi1,
    pixelmux_cam0_sel_lcdc0,
    pixelmux_cam0_sel_lcdc1,
    pixelmux_cam0_sel_lcb_do0,
    pixelmux_cam0_sel_lcb_do1,
} pixelmux_cam0_select_t;
 
#define PIXELMUX_LVDS_TX_PHY_PFD_FREQ_MAX 40000000UL
#define PIXELMUX_LVDS_TX_PHY_PFD_FREQ_MIN 10000000UL
 
#define PIXELMUX_LVDS_TX_PHY_VCO_FREQ_MAX 4000000000UL
#define PIXELMUX_LVDS_TX_PHY_VCO_FREQ_MIN 2000000000UL
 
#define PIXELMUX_LVDS_TX_PHY_DATA_LANE_FREQ_MAX 1000000000UL
 
typedef struct lvds_phy_clk_reg {
    uint32_t rate_lvds; 
    uint32_t data_rate_div4;
    uint32_t refclk_div; 
    uint32_t pll_div; 
} lvds_phy_clk_reg_t;
 
typedef struct lvds_phy_clk_param {
    lvds_phy_clk_reg_t reg;
    uint32_t fvco_freq_hz;
    uint32_t pfd_freq_hz;
    uint32_t lane_data_rate_hz;
    uint32_t hsclk_freq_hz;
} lvds_phy_clk_param_t;
 
typedef enum pixelmux_tx_phy_mode {
    pixelmux_tx_phy_mode_gpio = 0,
    pixelmux_tx_phy_mode_lvds = 1,
    pixelmux_tx_phy_mode_mipi = 2
} pixelmux_tx_phy_mode_t;
 
typedef enum pixelmux_rx_phy_mode {
    pixelmux_rx_phy_mode_gpio = 0,
    pixelmux_rx_phy_mode_lvds = 1,
    pixelmux_rx_phy_mode_mipi = 2,
    pixelmux_rx_phy_mode_lvds_camera = 3
} pixelmux_rx_phy_mode_t;
 
 
#ifdef __cplusplus
extern "C" {
#endif
 
void pixelmux_rgb_data_source_enable(pixelmux_rgb_select_t src);
 
void pixelmux_rgb_data_source_disable(void);
 
void pixelmux_gwc1_data_source_enable(pixelmux_gwc1_select_t src);
 
void pixelmux_gwc1_data_source_disable(void);
 
void pixelmux_gwc0_data_source_enable(pixelmux_gwc0_select_t src);
 
void pixelmux_gwc0_data_source_disable(void);
 
void pixelmux_lvb_di1_data_source_enable(pixelmux_lvb_di1_select_t src);
 
void pixelmux_lvb_di1_data_source_disable(void);
 
void pixelmux_lvb_di0_data_source_enable(pixelmux_lvb_di0_select_t src);
 
void pixelmux_lvb_di0_data_source_disable(void);
 
void pixelmux_mipi_dsi1_data_source_enable(pixelmux_mipi_dsi1_select_t src);
 
void pixelmux_mipi_dsi1_data_source_disable(void);
 
void pixelmux_mipi_dsi0_data_source_enable(pixelmux_mipi_dsi0_select_t src);
 
void pixelmux_mipi_dsi0_data_source_disable(void);
 
void pixelmux_mipi_dsi1_set_data_type(pixelmux_mipi_dsi_data_type_t type);
 
void pixelmux_mipi_dsi0_set_data_type(pixelmux_mipi_dsi_data_type_t type);
 
void pixelmux_cam1_data_source_enable(pixelmux_cam1_select_t src);
 
void pixelmux_cam1_data_source_disable(void);
 
void pixelmux_cam0_data_source_enable(pixelmux_cam0_select_t src);
 
void pixelmux_cam0_data_source_disable(void);
 
hpm_stat_t pixelmux_lvds_phy_calc_pll_cfg(uint32_t pixel_freq_hz, bool is_split, lvds_phy_clk_param_t *param);
 
void pixelmux_config_tx_phy0_mode(pixelmux_tx_phy_mode_t mode);
 
void pixelmux_config_tx_phy1_mode(pixelmux_tx_phy_mode_t mode);
 
void pixelmux_config_lvds_tx_phy0_clk(const lvds_phy_clk_reg_t *clk_reg);
 
void pixelmux_config_lvds_tx_phy1_clk(const lvds_phy_clk_reg_t *clk_reg);
 
void pixelmux_config_rx_phy0_mode(pixelmux_rx_phy_mode_t mode);
 
void pixelmux_config_rx_phy1_mode(pixelmux_rx_phy_mode_t mode);
 
#ifdef __cplusplus
}
#endif
 
#endif /* HPM_PIXELMUX_DRV_H */