Ads7952Handler.h File Reference

Unified handler for ADS7952 12-channel 12-bit SAR ADC with SPI integration. More...

#include <cstdint>
#include <memory>
#include <type_traits>
#include <utility>
#include "core/hf-core-drivers/external/hf-ads7952-driver/inc/ads7952.hpp"
#include "base/BaseSpi.h"
#include "base/BaseAdc.h"
#include "RtosMutex.h"

Go to the source code of this file.

Classes
class	Ads7952SpiAdapter
	CRTP adapter connecting BaseSpi interface to ADS7952 SpiInterface. More...
struct	Ads7952HandlerConfig
	Configuration for ADS7952 handler initialization. More...
struct	Ads7952Diagnostics
	Diagnostic information for an ADS7952 handler instance. More...
class	Ads7952Handler
	Unified handler for ADS7952 12-channel SAR ADC with BaseAdc integration. More...

Functions
Ads7952HandlerConfig	GetDefaultAds7952Config () noexcept
	Default ADS7952 handler config (2.5 V Vref, 5.0 V VA, 2×Vref range).
std::unique_ptr< Ads7952Handler >	CreateAds7952Handler (BaseSpi &spi_interface, const Ads7952HandlerConfig &config=GetDefaultAds7952Config()) noexcept
	Create ADS7952 handler instance.

Detailed Description

Unified handler for ADS7952 12-channel 12-bit SAR ADC with SPI integration.

This class provides a modern, unified interface for one or more ADS7952 ADC devices following the same architectural patterns as As5047uHandler and other core handlers:

• CRTP bridge pattern for BaseSpi integration (zero-overhead)
• Lazy initialization with lightweight construction
• Complete exception-free design with noexcept methods
• Thread-safe operations with RtosMutex protection
• Implements BaseAdc so a host can register this handler as an ADC source
• Comprehensive error handling, diagnostics, and statistics
• Factory method supporting multiple devices on the same SPI bus (different CS)

Electrical defaults (not a board pin map):

• ADS7952 is a 12-channel, 12-bit SAR ADC from TI
• Typical 2.5 V external Vref, up to 5.0 V VA supply
• Multiple devices can share the same SPI bus with different CS pins

Author

HardFOC Team

Version

1.0

Date

2026

Copyright

HardFOC

Function Documentation

CreateAds7952Handler()

std::unique_ptr< Ads7952Handler > CreateAds7952Handler ( BaseSpi &  spi_interface, const Ads7952HandlerConfig &  config = GetDefaultAds7952Config()  )

noexcept

Create ADS7952 handler instance.

Parameters

spi_interface	Reference to SPI interface
config	Handler configuration

Returns

Unique pointer to Ads7952Handler

GetDefaultAds7952Config()

Ads7952HandlerConfig GetDefaultAds7952Config ( )

inlinenoexcept

Default ADS7952 handler config (2.5 V Vref, 5.0 V VA, 2×Vref range).

Returns

Ads7952HandlerConfig covering all 12 channels in Manual mode.