rt-thread-official/bsp/nuvoton/libraries/m480/StdDriver/src/nu_ccap.c

297 lines
8.9 KiB
C

/**************************************************************************//**
* @file ccap.c
* @version V1.00
* @brief M480 Series CCAP Driver Source File
*
* SPDX-License-Identifier: Apache-2.0
* @copyright (C) 2016-2020 Nuvoton Technology Corp. All rights reserved.
*****************************************************************************/
#include "NuMicro.h"
/** @addtogroup Standard_Driver Standard Driver
@{
*/
/** @addtogroup CCAP_Driver CCAP Driver
@{
*/
/** @addtogroup CCAP_EXPORTED_FUNCTIONS CCAP Exported Functions
@{
*/
/**
* @brief Open engine clock and sensor clock
*
* @param[in] u32InFormat The bits corresponding VSP, HSP, PCLK, INFMT, SNRTYPE, OUTFMT, PDORD and PNFMT configurations.
* - VSP should be ether \ref CCAP_PAR_VSP_LOW or \ref CCAP_PAR_VSP_HIGH
* - HSP should be ether \ref CCAP_PAR_HSP_LOW or \ref CCAP_PAR_HSP_HIGH
* - PCLK should be ether \ref CCAP_PAR_PCLKP_LOW or \ref CCAP_PAR_PCLKP_HIGH
* - INFMT should be ether \ref CCAP_PAR_INFMT_YUV422 or \ref CCAP_PAR_INFMT_RGB565
* - SNRTYPE should be ether \ref CCAP_PAR_SENTYPE_CCIR601 or \ref CCAP_PAR_SENTYPE_CCIR656
* - OUTFMT should be one of the following setting
* - \ref CCAP_PAR_OUTFMT_YUV422
* - \ref CCAP_PAR_OUTFMT_ONLY_Y
* - \ref CCAP_PAR_OUTFMT_RGB555
* - \ref CCAP_PAR_OUTFMT_RGB565
* - PDORD should be one of the following setting
* - \ref CCAP_PAR_INDATORD_YUYV
* - \ref CCAP_PAR_INDATORD_YVYU
* - \ref CCAP_PAR_INDATORD_UYVY
* - \ref CCAP_PAR_INDATORD_VYUY
* - \ref CCAP_PAR_INDATORD_RGGB
* - \ref CCAP_PAR_INDATORD_BGGR
* - \ref CCAP_PAR_INDATORD_GBRG
* - \ref CCAP_PAR_INDATORD_GRBG
* - PNFMT should be one of the following setting
* - \ref CCAP_PAR_PLNFMT_YUV422
* - \ref CCAP_PAR_PLNFMT_YUV420
*
* @param[in] u32OutFormet Capture output format, should be one of following setting
* - \ref CCAP_CTL_PKTEN
*
* @return None
*
* @details Initialize the Image Capture Interface. Register a call back for driver internal using
*/
void CCAP_Open(uint32_t u32InFormat, uint32_t u32OutFormet)
{
CCAP->PAR = (CCAP->PAR & ~(0x000007BFUL)) | u32InFormat;
CCAP->CTL = (CCAP->CTL & ~(0x00000040UL)) | u32OutFormet;
}
/**
* @brief Set Cropping Window Starting Address and Size
*
* @param[in] u32VStart: Cropping Window Vertical Starting Address. It should be 0 ~ 0x7FF.
*
* @param[in] u32HStart: Cropping Window Horizontal Starting Address. It should be 0 ~ 0x7FF.
*
* @param[in] u32Height: Cropping Window Height . It should be 0 ~ 0x7FF.
*
* @param[in] u32Width: Cropping Window Width. It should be 0 ~ 0x7FF.
*
* @return None
*
* @details Set Cropping Window Starting Address Register
*/
void CCAP_SetCroppingWindow(uint32_t u32VStart,uint32_t u32HStart, uint32_t u32Height, uint32_t u32Width)
{
CCAP->CWSP = (CCAP->CWSP & ~(CCAP_CWSP_CWSADDRV_Msk | CCAP_CWSP_CWSADDRH_Msk))
| (((u32VStart << 16) | u32HStart));
CCAP->CWS = (CCAP->CWS & ~(CCAP_CWS_CWH_Msk | CCAP_CWS_CWW_Msk))
| ((u32Height << 16)| u32Width);
}
/**
* @brief Set System Memory Packet Base Address0 Register
*
* @param[in] u32Address : set PKTBA0 register, It should be 0x0 ~ 0xFFFFFFFF
*
* @return None
*
* @details Set System Memory Packet Base Address Register
*/
void CCAP_SetPacketBuf(uint32_t u32Address )
{
CCAP->PKTBA0 = u32Address;
CCAP->CTL |= CCAP_CTL_UPDATE_Msk;
}
/**
* @brief Close Camera Capture Interface
*
* @return None
*/
void CCAP_Close(void)
{
CCAP->CTL &= ~CCAP_CTL_CCAPEN;
}
/**
* @brief Set CCAP Interrupt
*
* @param[in] u32IntMask Interrupt settings. It could be
* - \ref CCAP_INT_VIEN_Msk
* - \ref CCAP_INT_MEIEN_Msk
* - \ref CCAP_INT_ADDRMIEN_Msk
* @return None
*
* @details Set Video Frame End Interrupt Enable,
* System Memory Error Interrupt Enable,
* Address Match Interrupt Enable,
* Motion Detection Output Finish Interrupt Enable.
*/
void CCAP_EnableInt(uint32_t u32IntMask)
{
CCAP->INT = (CCAP->INT & ~(CCAP_INT_VIEN_Msk | CCAP_INT_MEIEN_Msk | CCAP_INT_ADDRMIEN_Msk ) )
| u32IntMask;
}
/**
* @brief Disable CCAP Interrupt
*
* @param[in] u32IntMask Interrupt settings. It could be
* - \ref CCAP_INT_VINTF_Msk
* - \ref CCAP_INT_MEINTF_Msk
* - \ref CCAP_INT_ADDRMINTF_Msk
* @return None
*
* @details Disable Video Frame End Interrupt ,
* System Memory Error Interrupt ,
* Address Match Interrupt and
* Motion Detection Output Finish Interrupt .
*/
void CCAP_DisableInt(uint32_t u32IntMask)
{
CCAP->INT = (CCAP->INT & ~(u32IntMask) ) ;
}
/**
* @brief Enable Monochrome CMOS Sensor
*
* @param[in] u32Interface I/O interface settings. It could be
* - \ref CCAP_CTL_MY8_MY4
* - \ref CCAP_CTL_MY8_MY8
* @return None
*
*/
void CCAP_EnableMono(uint32_t u32Interface)
{
CCAP->CTL = (CCAP->CTL & ~CCAP_CTL_MY8_MY4) | CCAP_CTL_MONO_Msk |u32Interface;
}
/**
* @brief Disable Monochrome CMOS Sensor
*
* @return None
*
*/
void CCAP_DisableMono(void)
{
CCAP->CTL |= CCAP_CTL_MONO_Msk;
}
/**
* @brief Enable Luminance 8-bit Y to 1-bit Y Conversion
*
* @param[in] u32th Luminance Y8 to Y1 Threshold Value, It should be 0 ~ 255.
*
* @return None
*
*/
void CCAP_EnableLumaYOne(uint32_t u32th)
{
CCAP->CTL |= CCAP_CTL_Luma_Y_One_Msk;
CCAP->LUMA_Y1_THD = u32th & 0xff;
}
/**
* @brief Disable Luminance 8-bit Y to 1-bit Y Conversion
*
* @return None
*
*/
void CCAP_DisableLumaYOne(void)
{
CCAP->CTL &= ~CCAP_CTL_Luma_Y_One_Msk;
}
/**
* @brief Start Camera Capture Interface
*
* @return None
*/
void CCAP_Start(void)
{
CCAP->CTL |= CCAP_CTL_CCAPEN;
}
/**
* @brief Stop Camera Capture Interface
*
* @param[in] u32FrameComplete :
* TRUE: Capture module automatically disable the CCAP module after a frame had been captured
* FALSE: Stop Capture module now
* @return None
*
* @details if u32FrameComplete is set to TRUE then get a new frame and disable CCAP module
*/
void CCAP_Stop(uint32_t u32FrameComplete)
{
if(u32FrameComplete==FALSE)
CCAP->CTL &= ~CCAP_CTL_CCAPEN;
else
{
CCAP->CTL |= CCAP_CTL_SHUTTER_Msk;
while(CCAP_IS_STOPPED());
}
}
/**
* @brief Set Packet Scaling Vertical and Horizontal Factor Register
*
* @param[in] u32VNumerator: Packet Scaling Vertical Factor N. It should be 0 ~ FFFF.
*
* @param[in] u32VDenominator: Packet Scaling Vertical Factor M. It should be 0 ~ FFFF.
*
* @param[in] u32HNumerator: Packet Scaling Vertical Factor N. It should be 0 ~ FFFF.
*
* @param[in] u32HDenominator: Packet Scaling Vertical Factor M. It should be 0 ~ FFFF.
*
* @return None
*
*/
void CCAP_SetPacketScaling(uint32_t u32VNumerator, uint32_t u32VDenominator, uint32_t u32HNumerator, uint32_t u32HDenominator)
{
uint32_t u32NumeratorL, u32NumeratorH;
uint32_t u32DenominatorL, u32DenominatorH;
u32NumeratorL = u32VNumerator&0xFF;
u32NumeratorH=u32VNumerator>>8;
u32DenominatorL = u32VDenominator&0xFF;
u32DenominatorH = u32VDenominator>>8;
CCAP->PKTSL = (CCAP->PKTSL & ~(CCAP_PKTSL_PKTSVNL_Msk | CCAP_PKTSL_PKTSVML_Msk))
| ((u32NumeratorL << 24)| (u32DenominatorL << 16));
CCAP->PKTSM = (CCAP->PKTSM & ~(CCAP_PKTSM_PKTSVNH_Msk | CCAP_PKTSM_PKTSVMH_Msk))
| ((u32NumeratorH << 24) | (u32DenominatorH << 16));
u32NumeratorL = u32HNumerator&0xFF;
u32NumeratorH=u32HNumerator>>8;
u32DenominatorL = u32HDenominator&0xFF;
u32DenominatorH = u32HDenominator>>8;
CCAP->PKTSL = (CCAP->PKTSL & ~(CCAP_PKTSL_PKTSHNL_Msk | CCAP_PKTSL_PKTSHML_Msk))
| ((u32NumeratorL << 8)| u32DenominatorL);
CCAP->PKTSM = (CCAP->PKTSM & ~(CCAP_PKTSM_PKTSHNH_Msk | CCAP_PKTSM_PKTSHMH_Msk))
| ((u32NumeratorH << 8) | u32DenominatorH);
}
/**
* @brief Set Packet Frame Output Pixel Stride Width.
*
* @param[in] u32Stride : set PKTSTRIDE register, It should be 0x0 ~ 0x3FFF
*
* @return None
*
* @details Set Packet Frame Output Pixel Stride Width
*/
void CCAP_SetPacketStride(uint32_t u32Stride )
{
CCAP->STRIDE = (CCAP->STRIDE & ~CCAP_STRIDE_PKTSTRIDE_Msk) | u32Stride;
}
/*@}*/ /* end of group CCAP_EXPORTED_FUNCTIONS */
/*@}*/ /* end of group CCAP_Driver */
/*@}*/ /* end of group Standard_Driver */
/*** (C) COPYRIGHT 2016 Nuvoton Technology Corp. ***/