/*******************************************************************************
 * DISCLAIMER
 * This software is supplied by Renesas Electronics Corporation and is only
 * intended for use with Renesas products. No other uses are authorized. This
 * software is owned by Renesas Electronics Corporation and is protected under
 * all applicable laws, including copyright laws.
 * THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
 * THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
 * LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
 * AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
 * TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
 * ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
 * FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
 * ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
 * BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
 * Renesas reserves the right, without notice, to make changes to this software
 * and to discontinue the availability of this software. By using this software,
 * you agree to the additional terms and conditions found by accessing the
 * following link:
 * http://www.renesas.com/disclaimer
 * Copyright 2021-2022 Renesas Electronics Corporation All rights reserved.
 *******************************************************************************/

/*******************************************************************************
 * DESCRIPTION   : DMA driver header
 ******************************************************************************/

#ifndef DMA_DRIVER_H__
#define DMA_DRIVER_H__

#include <stdint.h>
#include <dma_register.h>
#include <log.h>

/* fraction mask for 64-byte units */
#define FRACTION_MASK_64_BYTE   (0x0000003FU)
#define TRANS_SIZE_64BYTE       (0x40U)

/* Prototype */
void dma_init(void);
void dma_trans_start(uint32_t dst, uint32_t src, uint32_t len);
void dma_trans_end_check(void);
void dma_release(void);

/* Inline function */
/* Check address align when RT-DMAC/SDMAC transfer */
static inline void dma_address_align_check(uint32_t dst_addr, uint32_t src_addr)
{
    if (((src_addr & FRACTION_MASK_64_BYTE) != 0U) || ((dst_addr & FRACTION_MASK_64_BYTE) != 0U))
    {
        /* src_addr or dst_addr are not 64-byte alignment. */
        ERROR("Not 64-byte alignment in DMA transfer\n");
        panic;
    }
}

#endif  /* DMA_DRIVER_H__ */