stm32_adc_gpdma.hpp

#pragma once
 
#include <cstddef>
#include <cstdint>
 
#include "main.h"
 
#if defined(STM32H5) && defined(HAL_ADC_MODULE_ENABLED) && defined(HAL_DMA_MODULE_ENABLED)
#if !defined(DMA_LINKEDLIST_CIRCULAR) || !defined(DMA_GPDMA_LINEAR_NODE)
#error "STM32H5 ADC requires the HAL GPDMA linked-list API"
#endif
#define LIBXR_STM32_ADC_GPDMA 1
#endif
 
#if defined(LIBXR_STM32_ADC_GPDMA) || defined(__DOXYGEN__)
namespace LibXR
{
class STM32GpdmaAdcAdapter
{
 public:
  STM32GpdmaAdcAdapter() = default;
 
  HAL_StatusTypeDef Start(ADC_HandleTypeDef* adc_handle, uint32_t* buffer,
                          uint32_t sample_count, size_t buffer_size);
 
  HAL_StatusTypeDef Stop(ADC_HandleTypeDef* adc_handle);
 
 private:
  // DMA 读取的节点寄存器按 32 字节对齐，避免跨越链表地址窗口。
  // Align the DMA node registers to 32 bytes to avoid crossing the list address window.
  struct alignas(32) StateBlock
  {
    DMA_NodeTypeDef node{};
    DMA_QListTypeDef queue{};
    DMA_QListTypeDef* original_queue = nullptr;
  };
  static_assert(offsetof(StateBlock, node) == 0U);
 
  void BuildAndAttach(ADC_HandleTypeDef* adc_handle, uint32_t* buffer,
                      uint32_t sample_count, size_t buffer_size);
  static void FinalizeStopped(DMA_HandleTypeDef* dma_handle);
  StateBlock state_{};
};
}  // namespace LibXR
#endif