xref: /device/soc/hisilicon/hi3516dv300/sdk_liteos/include/mpi_sys.h

/*
 * Copyright (c) 2022 HiSilicon (Shanghai) Technologies CO., LIMITED.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef __MPI_SYS_H__
#define __MPI_SYS_H__

#include "hi_type.h"
#include "hi_common.h"
#include "hi_comm_sys.h"

#ifdef __cplusplus
extern "C" {
#endif /* End of #ifdef __cplusplus */

HI_S32 HI_MPI_SYS_Init(HI_VOID);
HI_S32 HI_MPI_SYS_Exit(HI_VOID);

HI_S32 HI_MPI_SYS_SetConfig(const MPP_SYS_CONFIG_S *pstSysConfig);
HI_S32 HI_MPI_SYS_GetConfig(MPP_SYS_CONFIG_S *pstSysConfig);

HI_S32 HI_MPI_SYS_Bind(const MPP_CHN_S *pstSrcChn, const MPP_CHN_S *pstDestChn);
HI_S32 HI_MPI_SYS_UnBind(const MPP_CHN_S *pstSrcChn, const MPP_CHN_S *pstDestChn);
HI_S32 HI_MPI_SYS_GetBindbyDest(const MPP_CHN_S *pstDestChn, MPP_CHN_S *pstSrcChn);
HI_S32 HI_MPI_SYS_GetBindbySrc(const MPP_CHN_S *pstSrcChn, MPP_BIND_DEST_S *pstBindDest);

HI_S32 HI_MPI_SYS_GetVersion(MPP_VERSION_S *pstVersion);

HI_S32 HI_MPI_SYS_GetChipId(HI_U32 *pu32ChipId);
HI_S32 HI_MPI_SYS_GetUniqueId(HI_UNIQUE_ID_S *pstUniqueId);

HI_S32 HI_MPI_SYS_GetCustomCode(HI_U32 *pu32CustomCode);

/*
 * u64Base is the global PTS of the system.
 * ADVICE:
 * 1. Better to call HI_MPI_SYS_GetCurPTS on the host board to get u64Base.
 * 2. When os start up, call HI_MPI_SYS_InitPTSBase to set the init PTS.
 * 3. When media bussines is running, synchronize the PTS one time per minute
 *     by calling HI_MPI_SYS_SyncPTS.
 */
HI_S32 HI_MPI_SYS_GetCurPTS(HI_U64 *pu64CurPTS);
HI_S32 HI_MPI_SYS_InitPTSBase(HI_U64 u64PTSBase);
HI_S32 HI_MPI_SYS_SyncPTS(HI_U64 u64PTSBase);

/* alloc mmz memory in user context */
HI_S32 HI_MPI_SYS_MmzAlloc(HI_U64 *pu64PhyAddr, HI_VOID **ppVirAddr,
                           const HI_CHAR *strMmb, const HI_CHAR *strZone, HI_U32 u32Len);

/* alloc mmz memory with cache */
HI_S32 HI_MPI_SYS_MmzAlloc_Cached(HI_U64 *pu64PhyAddr, HI_VOID **ppVirAddr,
                                  const HI_CHAR *pstrMmb, const HI_CHAR *pstrZone, HI_U32 u32Len);

/* free mmz memory in user context */
HI_S32 HI_MPI_SYS_MmzFree(HI_U64 u64PhyAddr, HI_VOID *pVirAddr);

/* fulsh cache */
HI_S32 HI_MPI_SYS_MmzFlushCache(HI_U64 u64PhyAddr, HI_VOID *pVirAddr, HI_U32 u32Size);

/*
 * Call the mmap function to map physical address to virtual address
 * The system function mmap is too complicated, so we packge it.
 */
HI_VOID *HI_MPI_SYS_Mmap(HI_U64 u64PhyAddr, HI_U32 u32Size);
HI_VOID *HI_MPI_SYS_MmapCache(HI_U64 u64PhyAddr, HI_U32 u32Size);
HI_S32 HI_MPI_SYS_Munmap(HI_VOID *pVirAddr, HI_U32 u32Size);
HI_S32 HI_MPI_SYS_MflushCache(HI_U64 u64PhyAddr, HI_VOID *pVirAddr, HI_U32 u32Size);

HI_S32 HI_MPI_SYS_SetMemConfig(const MPP_CHN_S *pstMppChn, const HI_CHAR *pcMmzName);
HI_S32 HI_MPI_SYS_GetMemConfig(const MPP_CHN_S *pstMppChn, HI_CHAR *pcMmzName);

/* Close all the FD which is used by sys module */
HI_S32 HI_MPI_SYS_CloseFd(HI_VOID);

/* Get virtual meminfo according to virtual addr, should be in one process */
HI_S32 HI_MPI_SYS_GetVirMemInfo(const void *pVirAddr, SYS_VIRMEM_INFO_S *pstMemInfo);

/* Set/get Scale coefficient level for VPSS/VGS */
HI_S32 HI_MPI_SYS_SetScaleCoefLevel(const SCALE_RANGE_S *pstScaleRange,
                                    const SCALE_COEFF_LEVEL_S *pstScaleCoeffLevel);
HI_S32 HI_MPI_SYS_GetScaleCoefLevel(const SCALE_RANGE_S *pstScaleRange, SCALE_COEFF_LEVEL_S *pstScaleCoeffLevel);

/* Set/Get local timezone, range: [-86400, 86400] seconds (that is: [-24, 24] hours) */
HI_S32 HI_MPI_SYS_SetTimeZone(HI_S32 s32TimeZone);
HI_S32 HI_MPI_SYS_GetTimeZone(HI_S32 *ps32TimeZone);

HI_S32 HI_MPI_SYS_SetGPSInfo(const GPS_INFO_S *pstGPSInfo);
HI_S32 HI_MPI_SYS_GetGPSInfo(GPS_INFO_S *pstGPSInfo);

HI_S32 HI_MPI_SYS_SetTuningConnect(HI_S32 s32Connect);
HI_S32 HI_MPI_SYS_GetTuningConnect(HI_S32 *ps32Connect);

HI_S32 HI_MPI_SYS_SetVIVPSSMode(const VI_VPSS_MODE_S *pstVIVPSSMode);
HI_S32 HI_MPI_SYS_GetVIVPSSMode(VI_VPSS_MODE_S *pstVIVPSSMode);

HI_S32 HI_MPI_SYS_GetVPSSVENCWrapBufferLine(VPSS_VENC_WRAP_PARAM_S *pWrapParam, HI_U32 *pu32BufLine);

HI_S32 HI_MPI_LOG_SetLevelConf(LOG_LEVEL_CONF_S *pstConf);
HI_S32 HI_MPI_LOG_GetLevelConf(LOG_LEVEL_CONF_S *pstConf);

HI_S32 HI_MPI_SYS_SetRawFrameCompressParam(const RAW_FRAME_COMPRESS_PARAM_S *pstCompressParam);
HI_S32 HI_MPI_SYS_GetRawFrameCompressParam(RAW_FRAME_COMPRESS_PARAM_S *pstCompressParam);

HI_S32 HI_MPI_LOG_SetWaitFlag(HI_BOOL bWait);

HI_S32 HI_MPI_LOG_Read(HI_CHAR *pBuf, HI_U32 u32Size);

HI_VOID HI_MPI_LOG_Close(HI_VOID);

#ifdef __cplusplus
}
#endif /* End of #ifdef __cplusplus */

#endif /* __MPI_SYS_H__ */