rt-thread/bsp/phytium/libraries/standalone/drivers/dma/fddma/fddma.c

380 lines
12 KiB
C
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
* Copyright : (C) 2022 Phytium Information Technology, Inc.
* All Rights Reserved.
*
* This program is OPEN SOURCE software: you can redistribute it and/or modify it
* under the terms of the Phytium Public License as published by the Phytium Technology Co.,Ltd,
* either version 1.0 of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY;
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
* See the Phytium Public License for more details.
*
*
* FilePath: fddma.c
* Date: 2022-02-10 14:53:42
* LastEditTime: 2022-02-18 08:24:47
* Description:  This files is for ddma interface implementation
*
* Modify History:
* Ver   Who        Date         Changes
* ----- ------     --------    --------------------------------------
* 1.0 Zhugengyu 2022/5/13 init commit
*/
/***************************** Include Files *********************************/
#include <string.h>
#include "fkernel.h"
#include "fparameters.h"
#include "fassert.h"
#include "fdebug.h"
#include "fddma_hw.h"
#include "fddma.h"
/************************** Constant Definitions *****************************/
/**************************** Type Definitions *******************************/
/************************** Variable Definitions *****************************/
/***************** Macros (Inline Functions) Definitions *********************/
#define FDDMA_DEBUG_TAG "DDMA"
#define FDDMA_ERROR(format, ...) FT_DEBUG_PRINT_E(FDDMA_DEBUG_TAG, format, ##__VA_ARGS__)
#define FDDMA_WARN(format, ...) FT_DEBUG_PRINT_W(FDDMA_DEBUG_TAG, format, ##__VA_ARGS__)
#define FDDMA_INFO(format, ...) FT_DEBUG_PRINT_I(FDDMA_DEBUG_TAG, format, ##__VA_ARGS__)
#define FDDMA_DEBUG(format, ...) FT_DEBUG_PRINT_D(FDDMA_DEBUG_TAG, format, ##__VA_ARGS__)
/************************** Function Prototypes ******************************/
static FError FDdmaReset(FDdma *const instance);
/****************************************************************************/
/**
* @name: FDdmaCfgInitialization
* @msg: 初始化DDMA控制器
* @return {FError} FDDMA_SUCCESS表示初始化成功其它返回值表示初始化失败
* @param {FDdma} *instance, DDMA控制器实例
* @param {FDdmaConfig} *input_config, DDMA控制器配置
*/
FError FDdmaCfgInitialization(FDdma *const instance, const FDdmaConfig *input_config)
{
FASSERT(instance && input_config);
uintptr base_addr = input_config->base_addr;
FError ret = FDDMA_SUCCESS;
if (FT_COMPONENT_IS_READY == instance->is_ready)
{
FDDMA_WARN("device is already initialized!!!");
}
FDdmaDeInitialization(instance);
instance->config = *input_config;
ret = FDdmaReset(instance);
if (FDDMA_SUCCESS == ret)
{
instance->is_ready = FT_COMPONENT_IS_READY;
FDDMA_INFO("ddma@0x%x init success !!!", base_addr);
}
return ret;
}
/**
* @name: FDdmaStart
* @msg: 启动DDMA控制器开始传输
* @return {FError} FDDMA_SUCCESS表示启动成功其它返回值表示启动失败
* @param {FDdma} *instance, DDMA控制器实例
*/
FError FDdmaStart(FDdma *const instance)
{
FASSERT(instance);
FError ret = FDDMA_SUCCESS;
uintptr base_addr = instance->config.base_addr;
if (FT_COMPONENT_IS_READY != instance->is_ready)
{
FDDMA_ERROR("dma instance not init !!!");
return FDDMA_ERR_NOT_INIT;
}
FDdmaEnableGlobalIrq(base_addr); /* enable ddma irq */
FDdmaEnable(base_addr);
return FDDMA_SUCCESS;
}
/**
* @name: FDdmaStop
* @msg: 停止DDMA控制器
* @return {FError} FDDMA_SUCCESS表示停止成功其它返回值表示停止失败
* @param {FDdma} *instance, DDMA控制器实例
*/
FError FDdmaStop(FDdma *const instance)
{
FASSERT(instance);
FError ret = FDDMA_SUCCESS;
uintptr base_addr = instance->config.base_addr;
if (FT_COMPONENT_IS_READY != instance->is_ready)
{
FDDMA_ERROR("dma instance not init !!!");
return FDDMA_ERR_NOT_INIT;
}
FDdmaDisableGlobalIrq(base_addr); /* enable ddma irq */
FDdmaDisable(base_addr);
return FDDMA_SUCCESS;
}
/**
* @name: FDdmaDeInitialization
* @msg: 去初始化DDMA控制器
* @return {无}
* @param {FDdma} *instance, DDMA控制器实例
*/
void FDdmaDeInitialization(FDdma *const instance)
{
FASSERT(instance);
u32 chan;
for (chan = 0; chan < FDDMA_NUM_OF_CHAN; chan++)
{
if (instance->bind_status & BIT(chan))
{
FDDMA_WARN("channel %d has not been unbind", chan);
}
}
memset(instance, 0, sizeof(*instance));
return;
}
/**
* @name: FDdmaAllocateChan
* @msg: 按照配置分配DDMA通道
* @return {FError} FDDMA_SUCCESS表示分配成功其它返回值表示分配失败
* @param {FDdma} *instance, DDMA控制器实例
* @param {FDdmaChan} *dma_chan, DDMA通道实例
* @param {FDdmaChanConfig} *dma_chan_config, DDMA通道配置
*/
FError FDdmaAllocateChan(FDdma *const instance, FDdmaChan *const dma_chan, const FDdmaChanConfig *dma_chan_config)
{
FASSERT(instance && dma_chan && dma_chan_config);
FError ret = FDDMA_SUCCESS;
const FDdmaChanIndex chan_idx = dma_chan_config->id;
u32 reg_val;
uintptr base_addr = instance->config.base_addr;
if (FT_COMPONENT_IS_READY != instance->is_ready)
{
FDDMA_ERROR("dma instance not init !!!");
return FDDMA_ERR_NOT_INIT;
}
if ((TRUE == dma_chan->is_used) || (BIT(chan_idx) & instance->bind_status))
{
FDDMA_ERROR("chan-%d is already is use !!!", chan_idx);
return FDDMA_ERR_CHAN_BINDED;
}
if (FDdmaIsChanRunning(base_addr, chan_idx))
{
FDDMA_ERROR("chan-%d is already running !!!", chan_idx);
return FDDMA_ERR_CHAN_BINDED;
}
if (dma_chan_config->ddr_addr % FDDMA_DDR_ADDR_ALIGMENT)
{
FDDMA_ERROR("ddr addr 0x%x must align with %d bytes",
dma_chan_config->ddr_addr, FDDMA_DDR_ADDR_ALIGMENT);
return FDDMA_ERR_INVALID_DDR_ADDR;
}
if ((FDDMA_MAX_TRANSFER_LEN < dma_chan_config->trans_len) ||
(FDDMA_MIN_TRANSFER_LEN > dma_chan_config->trans_len) ||
(0 != dma_chan_config->trans_len % FDDMA_MIN_TRANSFER_LEN))
{
FDDMA_ERROR("invalid transfer size %d Bytes !!!", dma_chan_config->trans_len);
return FDDMA_ERR_INVALID_TRANS_SIZE;
}
dma_chan->dma = instance;
instance->chan[chan_idx] = dma_chan;
if (&(dma_chan->config) != dma_chan_config)
dma_chan->config = *dma_chan_config;
FDdmaStop(instance); /* disable irq */
if (FDDMA_SUCCESS != FDdmaDisableChan(base_addr, chan_idx))
{
FDDMA_ERROR("disable DDMA@0x%x channel %d failed !!!", base_addr, chan_idx);
return FDDMA_ERR_WAIT_TIMEOUT;
}
FDdmaResetChan(base_addr, chan_idx); /* reset channel */
FDdmaSetChanSelection(base_addr, chan_idx, dma_chan->config.slave_id); /* select channel */
FDdmaSetChanBind(base_addr, chan_idx, TRUE); /* bind channel */
/* setup transfer src and dst */
/* dma_tx_req: ddr --> dev 从内存中读取数据,写入外设 */
/* dma_rx_req: dev --> ddr 从外设读取数据到内存 */
#ifdef __aarch64___
FDdmaWriteReg(base_addr, FDDMA_CHAN_DDR_LOW_ADDR_OFFSET(chan_idx), LOWER_32_BITS(dma_chan_config->ddr_addr));
FDdmaWriteReg(base_addr, FDDMA_CHAN_DDR_UP_ADDR_OFFSET(chan_idx), UPPER_32_BITS(dma_chan_config->ddr_addr));
#else
FDdmaWriteReg(base_addr, FDDMA_CHAN_DDR_LOW_ADDR_OFFSET(chan_idx), (u32)(dma_chan_config->ddr_addr));
FDdmaWriteReg(base_addr, FDDMA_CHAN_DDR_UP_ADDR_OFFSET(chan_idx), 0);
#endif
FDdmaWriteReg(base_addr, FDDMA_CHAN_DEV_ADDR_OFFSET(chan_idx), dma_chan_config->dev_addr);
FDdmaWriteReg(base_addr, FDDMA_CHAN_TS_OFFSET(chan_idx), dma_chan_config->trans_len); /* block size */
/* set channel request direction */
FDdmaSetChanDirection(base_addr, chan_idx,
(FDDMA_CHAN_REQ_RX == dma_chan->config.req_mode) ? TRUE : FALSE);
FDDMA_INFO("chan-%d ddr @0x%x", chan_idx, FDDMA_CHAN_DDR_LOW_ADDR_OFFSET(chan_idx));
FDDMA_INFO("ddr addr: 0x%x", FDdmaReadReg(base_addr, FDDMA_CHAN_DDR_LOW_ADDR_OFFSET(chan_idx)));
FDDMA_INFO("dev addr: 0x%x", FDdmaReadReg(base_addr, FDDMA_CHAN_DEV_ADDR_OFFSET(chan_idx)));
FDDMA_INFO("trans len: %d", FDdmaReadReg(base_addr, FDDMA_CHAN_TS_OFFSET(chan_idx)));
FDdmaSetChanTimeout(base_addr, chan_idx, 0xffff);
FDdmaEnableChanIrq(base_addr, chan_idx);
if (FDDMA_SUCCESS == ret)
{
instance->bind_status |= BIT(chan_idx);
dma_chan->is_used = TRUE;
FDDMA_INFO("allocate channel %d", chan_idx);
}
return ret;
}
/**
* @name: FDdmaDellocateChan
* @msg: 释放之前分配的DDMA通道
* @return {FError} FDDMA_SUCCESS表示释放成功其它返回值表示释放失败
* @param {FDdmaChan} *dma_chan, DDMA控制器实例
*/
FError FDdmaDellocateChan(FDdmaChan *const dma_chan)
{
FASSERT(dma_chan && dma_chan->dma);
FDdma *const instance = dma_chan->dma;
const FDdmaChanIndex chan_idx = dma_chan->config.id;
uintptr base_addr = instance->config.base_addr;
FError ret = FDDMA_SUCCESS;
if (FT_COMPONENT_IS_READY != instance->is_ready)
{
FDDMA_ERROR("dma instance not init !!!");
return FDDMA_ERR_NOT_INIT;
}
if (FDDMA_SUCCESS != FDdmaDisableChan(base_addr, chan_idx))
{
FDDMA_ERROR("disable DDMA@0x%x channel %d failed !!!", base_addr, chan_idx);
return FDDMA_ERR_WAIT_TIMEOUT;
}
FDdmaResetChan(base_addr, chan_idx);
FDdmaSetChanBind(base_addr, chan_idx, FALSE); /* unbind channel */
ret = FDdmaDisableChan(base_addr, chan_idx);
if (FDDMA_SUCCESS != ret) /* disable channel */
{
FDDMA_ERROR("disable ddma@%p channel %d failed !!!", base_addr, chan_idx);
return ret;
}
FDdmaDisableChanIrq(base_addr, chan_idx); /* disable channel irq */
instance->bind_status &= ~BIT(chan_idx); /* set bind status */
instance->chan[chan_idx] = NULL;
FDDMA_INFO("deallocate channel %d", chan_idx);
memset(dma_chan, 0, sizeof(*dma_chan));
return ret;
}
/**
* @name: FDdmaActiveChan
* @msg: 使能指定的DDMA通道
* @note: 调用FDdmaAllocateChan后无需调用此函数
* @return {FError} 返回FDDMA_SUCCESS表示成功返回其它表示失败
* @param FDdmaChan *const dma_chan, DDMA通道实例
*/
FError FDdmaActiveChan(FDdmaChan *const dma_chan)
{
FASSERT(dma_chan && dma_chan->dma);
FDdma *const instance = dma_chan->dma;
uintptr base_addr = instance->config.base_addr;
if (FT_COMPONENT_IS_READY != instance->is_ready)
{
FDDMA_ERROR("dma instance not init !!!");
return FDDMA_ERR_NOT_INIT;
}
FDdmaEnableChan(base_addr, dma_chan->config.id);
FDdmaClearChanIrq(base_addr, dma_chan->config.id); /* clear interrupt status */
return FDDMA_SUCCESS;
}
FError FDdmaDeactiveChan(FDdmaChan *const dma_chan)
{
FASSERT(dma_chan && dma_chan->dma);
FDdma *const instance = dma_chan->dma;
uintptr base_addr = instance->config.base_addr;
if (FT_COMPONENT_IS_READY != instance->is_ready)
{
FDDMA_ERROR("dma instance not init !!!");
return FDDMA_ERR_NOT_INIT;
}
return FDdmaDisableChan(base_addr, dma_chan->config.id);
}
/**
* @name: FDdmaReset
* @msg: 重置DDMA控制器
* @return {FError} FDDMA_SUCCESS表示重置成功其它返回值表示失败
* @param {FDdma} *instance, DDMA控制器实例
*/
static FError FDdmaReset(FDdma *const instance)
{
FASSERT(instance);
uintptr base_addr = instance->config.base_addr;
FError ret = FDDMA_SUCCESS;
u32 reg_val;
u32 chan;
if (0 != instance->bind_status)
{
FDDMA_WARN("some channel not yet un-bind !!!");
}
FDdmaDisable(base_addr); /* disable ddma */
FDdmaSoftwareReset(base_addr); /* do software reset */
FDdmaDisableGlobalIrq(base_addr);
/* disable channel and its irq */
for (u32 chan = FDDMA_CHAN_0; chan < FDDMA_NUM_OF_CHAN; chan++)
{
/* disable channel */
ret = FDdmaDisableChan(base_addr, chan);
if (FDDMA_SUCCESS != ret)
{
FDDMA_ERROR("disable ddma@%p channel %d failed !!!", base_addr, chan);
break;
}
}
FDdmaDumpRegisters(base_addr);
return ret;
}