207 lines
9.2 KiB
C
207 lines
9.2 KiB
C
/******************************************************************************
|
||
* 版权所有：苏州领慧立芯科技有限公司
|
||
* Copyright (c) 2020-2025 Suzhou Legendsemi Technology Co., Ltd.
|
||
******************************************************************************
|
||
* All rights reserved. Distributed under MIT license.
|
||
* The file is encoded in UTF-8 without signature.
|
||
* @file lh32m0g30x_dac.h
|
||
* @version 2025-09-22
|
||
******************************************************************************/
|
||
|
||
/* Define to prevent recursive inclusion -------------------------------------*/
|
||
#ifndef __LH32M0G3x_DMA_H
|
||
#define __LH32M0G3x_DMA_H
|
||
|
||
#ifdef __cplusplus
|
||
extern "C" {
|
||
#endif
|
||
|
||
/* Includes ------------------------------------------------------------------*/
|
||
#include "lh32m0xx_lhl.h"
|
||
|
||
/* Defines -------------------------------------------------------------------*/
|
||
/**
|
||
* @brief DMA传输模式
|
||
* @note EMLM默认始终开启，以实现多种地址调节方式
|
||
*/
|
||
typedef enum {
|
||
|
||
DMA_MEMORY_TO_MEMORY = 0u, /*!< 源地址和目的地址主循环内自动递增，结束后自动恢复起始地址 */
|
||
|
||
DMA_PERIPH_TO_MEMORY, /*!< 源地址次循环内递增，次/主循环结束后自动恢复起始地址；
|
||
* 目的地址主循环内递增，主循环结束后自动恢复起始地址 */
|
||
|
||
DMA_MEMORY_TO_PERIPH, /*!< 源地址主循环内递增，主循环结束后自动恢复起始地址；
|
||
* 目的地址次循环内递增，次/主循环结束后自动恢复起始地址 */
|
||
|
||
DMA_PERIPH_TO_PERIPH, /*!< 源地址和目的地址次循环内递增，次/主循环结束后自动恢复起始地址 */
|
||
|
||
DMA_FIFO_TO_MEMORY, /*!< 源地址始终固定不变；目的地址主循环内自动递增，结束后自动恢复起始地址 */
|
||
|
||
DMA_MEMROY_TO_FIFO, /*!< 源地址主循环内自动递增，结束后自动恢复起始地址；目的地址始终固定不变 */
|
||
|
||
} DMA_TRANS_TYPE_t;
|
||
|
||
/**
|
||
* @brief DMA_Memory_data_size DMA Memory data size
|
||
* @note 为了与正数区分，负数定义为正数加1取反，实际使用时注意额外计算
|
||
*/
|
||
typedef enum {
|
||
DMA_DATA_WIDTH_1B = 0, /*!< Memory data alignment : Byte, 8-bit */
|
||
DMA_DATA_WIDTH_2B = 1, /*!< Memory data alignment : HalfWord, 16-bit */
|
||
DMA_DATA_WIDTH_4B = 2, /*!< Memory data alignment : Word, 32-bit */
|
||
DMA_DATA_WIDTH_16B = 4, /*!< Memory data alignment : 16-byte */
|
||
DMA_DATA_WIDTH_32B = 5, /*!< Memory data alignment : 32-byte */
|
||
// DMA_DATA_WIDTH_N1B = -1, /*!< Memory data alignment : Negtive Byte, 8-bit */
|
||
// DMA_DATA_WIDTH_N2B = -2, /*!< Memory data alignment : Negtive HalfWord, 16-bit */
|
||
// DMA_DATA_WIDTH_N4B = -3, /*!< Memory data alignment : Negtive Word, 32-bit */
|
||
// DMA_DATA_WIDTH_N16B = -5, /*!< Memory data alignment : Negtive 16-byte */
|
||
// DMA_DATA_WIDTH_N32B = -6, /*!< Memory data alignment : Negtive 32-byte */
|
||
} DMA_DATA_WIDTH_t;
|
||
|
||
typedef enum {
|
||
DMA_HARDWARE_REQUEST = 0x0u,
|
||
DMA_SOFTWARE_REQUEST = 0x1u,
|
||
} DMA_REQ_t;
|
||
|
||
typedef enum {
|
||
DMA_CHANNEL_0 = 0x0u,
|
||
DMA_CHANNEL_1 = 0x1u,
|
||
DMA_CHANNEL_2 = 0x2u,
|
||
DMA_CHANNEL_3 = 0x3u,
|
||
} DMA_CHANNEL_t;
|
||
|
||
typedef enum {
|
||
TO_DMA_CHANNEL_0 = 0x0u,
|
||
TO_DMA_CHANNEL_1 = 0x1u,
|
||
TO_DMA_CHANNEL_2 = 0x2u,
|
||
TO_DMA_CHANNEL_3 = 0x3u,
|
||
TO_DMA_CHANNEL_NONE = 0x10u, /* 参数NONE仅供Chaining_Channel调用 */
|
||
} DMA_CHAINING_t;
|
||
|
||
typedef enum {
|
||
DMA_BANDWIDTH_FULL = 0x0u,
|
||
DMA_BANDWIDTH_MEDIUM = 0x2u,
|
||
DMA_BANDWIDTH_LOW = 0x3u,
|
||
} DMA_BANDWIDTH_LIMIT_t;
|
||
|
||
typedef enum {
|
||
DMA_IT_MAJOR = 0x2u,
|
||
DMA_IT_HALF = 0x4u,
|
||
} DMA_IT_t;
|
||
|
||
typedef enum {
|
||
DMA_DIRECT_MODE = 0x1u, /*!< 直接模式 */
|
||
|
||
DMA_CHAINING_MODE = 0x2u, /*!< 链式模式 */
|
||
|
||
DMA_SCATTER_GATHER_MODE = 0x4u, /*!< 分散聚合模式 */
|
||
} DMA_MODE_t;
|
||
|
||
typedef enum {
|
||
DMA_CYCLIC_TRANSMISSION = 0x0u, /*!< 循环模式，传输Repetition次数后重新开始，
|
||
* 源和目的地址指针自动恢复到初始值*/
|
||
DMA_SINGLE_TRANSMISSION = 0x1u, /*!< 单次模式，传输Repetition次数后自动停止，
|
||
* 源和目的地址指针自动恢复到初始值 */
|
||
DMA_INTERVAL_TRANSMISSION = 0x10u, /*!< 间隔模式，传输Repetition次数后重新开始，
|
||
* 传输间隔由参数Interval决定，完成后源和目的地址指针自动恢复到初始值 */
|
||
} DMA_TRANS_MODE_t;
|
||
|
||
/**
|
||
* @brief DMA 初始化参数结构体
|
||
*/
|
||
typedef struct {
|
||
|
||
uint32_t Src_Address; /*!< 源地址 */
|
||
|
||
uint32_t Dest_Address; /*!< 目标地址 */
|
||
|
||
uint16_t Data_Size; /*!< 以源数据宽度为单位的DMA传输数据量 Max=256Word/1024Byte */
|
||
|
||
uint16_t Repetition; /*!< 当DMA为重复模式下的循环次数：Min=1；Max=2^9（ELINK=1）/2^15（ELINK=0）*/
|
||
|
||
int32_t TCD_Address; /*!< DMA_SCATTER_GATHER_MODE下，向下一个加载的TCD链表 */
|
||
|
||
FunctionalState INT_Major; /*!< DMA_SCATTER_GATHER_MODE下，使能或禁用主中断 */
|
||
|
||
FunctionalState INT_Half; /*!< DMA_SCATTER_GATHER_MODE下，使能或禁用半中断 */
|
||
|
||
FunctionalState Auto_Start; /*!< DMA_SCATTER_GATHER_MODE下，使能或禁用通道自启动功能*/
|
||
|
||
DMA_BANDWIDTH_LIMIT_t Bandwidth; /*!< DMA_SCATTER_GATHER_MODE下，带宽控制位 */
|
||
|
||
DMA_CHAINING_t Chaining; /*!< DMA_CHAINING_MODE下，指向下一个链式启动的通道 */
|
||
|
||
DMA_TRANS_MODE_t Trans_Mode; /*!< DMA传输模式：单次，重复，间隔 */
|
||
|
||
DMA_DATA_WIDTH_t Data_Width; /*!< 数据宽度 */
|
||
|
||
DMA_TRANS_TYPE_t Direction; /*!< 传输方式：外设<->内存等六种方式，地址偏移由Direction和DataWidth共同决定 */
|
||
|
||
int16_t Src_Interval_Factor; /*!< 在间隔模式下，单次DMA操作后，源地址偏移量的系数 */
|
||
|
||
int16_t Dest_Interval_Factor; /*!< 在间隔模式下，单次DMA操作后，目的地址偏移量的系数 */
|
||
|
||
} DMA_InitTypeDef;
|
||
|
||
/**
|
||
* @brief DMA Handle 操作句柄
|
||
*/
|
||
typedef struct {
|
||
|
||
DMA_CHANNEL_t Channel; /*!< DMA Channel Instance */
|
||
|
||
DMA_MODE_t Mode; /*!< DMA模式选择 */
|
||
|
||
DMA_REQ_t Request; /*!< DMA请求源 */
|
||
|
||
uint8_t TCD_Count; /*!< DMA_SCATTER_GATHER_MODE下，TCD描述符数量 */
|
||
|
||
DMA_DES_N_TypeDef* TCD_List; /*!< DMA_SCATTER_GATHER_MODE下，TCD描述符指针 */
|
||
|
||
DMA_InitTypeDef* TCD_Init; /*!< DMA_SCATTER_GATHER_MODE下，DMA初始化参数结构体指针 */
|
||
|
||
DMA_InitTypeDef Init; /*!< DMA初始化参数结构体 */
|
||
|
||
} DMA_HandleTypeDef;
|
||
|
||
/* Declaration ---------------------------------------------------------------*/
|
||
|
||
LHL_StatusTypeDef LHL_DMA_Init(DMA_HandleTypeDef* handle);
|
||
|
||
void LHL_DMA_Start(DMA_HandleTypeDef* handle);
|
||
|
||
void LHL_DMA_Stop(DMA_HandleTypeDef* handle);
|
||
|
||
void LHL_DMA_SetChainingChannel(DMA_HandleTypeDef* handle, DMA_CHANNEL_t ChainingChannel, FunctionalState NewState);
|
||
|
||
void LHL_DMA_SetELink(DMA_HandleTypeDef* handle, DMA_CHANNEL_t LinkedChannel, FunctionalState NewState);
|
||
|
||
void LHL_DMA_SetMLink(DMA_HandleTypeDef* handle, DMA_CHANNEL_t LinkedChannel, FunctionalState NewState);
|
||
|
||
void LHL_DMA_ITConfig(DMA_HandleTypeDef* handle, uint32_t DMA_IT, FunctionalState NewState);
|
||
|
||
DMA_IT_t LHL_DMA_GetPending(DMA_CHANNEL_t channel);
|
||
|
||
void LHL_DMA_ClearPending(DMA_CHANNEL_t channel);
|
||
|
||
LHL_StatusTypeDef LHL_DMA_GenerateTCD(DMA_HandleTypeDef* handle, DMA_InitTypeDef* DMA_Init, DMA_DES_N_TypeDef* tcd);
|
||
|
||
LHL_StatusTypeDef LHL_DMA_CopyTCD(DMA_HandleTypeDef* handle, DMA_DES_N_TypeDef* tcd);
|
||
|
||
LHL_StatusTypeDef LHL_DMA_SGAInit(DMA_HandleTypeDef* handle, DMA_DES_N_TypeDef* tcd);
|
||
|
||
uint32_t LHL_DMA_GetDestAddress(DMA_CHANNEL_t channel);
|
||
|
||
uint16_t LHL_DMA_GetCiter(DMA_CHANNEL_t channel);
|
||
|
||
uint16_t LHL_DMA_GetBiter(DMA_CHANNEL_t channel);
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif
|
||
|
||
/*********************************End of File**********************************/
|