Waveshare High-Precision AD HAT

https://www.waveshare.com/wiki/High-Precision_AD_HAT
Admin
A high-precision 32-bit analog-to-digital converter expansion board for Raspberry Pi featuring the...
Tokens:3,598
Snippets:41
Trust Score:10
Update:6 months ago
Show doc for...
Tokens:
Raw
### Enable SPI Interface (Shell)

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Instructions to enable the SPI interface by editing the config.txt file. This is a prerequisite for the AD HAT to communicate with the Raspberry Pi. Requires root privileges.

```Shell
sudo nano /boot/config.txt
```

--------------------------------

### Device Control and Initialization

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Functions for resetting the chip, verifying the chip ID, and performing initial device configuration.

```APIDOC
## Device Initialization and Control

### Description
Provides core control functions for the ADS1263 chip, including hardware reset, chip identification, and system initialization.

### Methods
- `ADS1263_reset()`: Performs a hardware reset on the IC.
- `ADS1263_ReadChipID()`: Returns 1 for ADS1263, 0 for ADS1262.
- `ADS1263_init()`: Initializes the device by resetting, verifying, and configuring registers.

### Parameters
None required for these initialization functions.

### Response
- `ADS1263_ReadChipID` returns UBYTE (1 or 0).
- `ADS1263_init` returns UBYTE status code.
```

--------------------------------

### Device Reset and Initialization

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Functions to reset the IC to default register states and perform full device initialization. Resetting is required before each use to ensure a clean configuration state.

```C
static void ADS1263_reset(void);
UBYTE ADS1263_init(void);
```

--------------------------------

### ADC Configuration and Mode Setting

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Functions to configure ADC rates, PGA gain, reference voltage, and operating modes (differential vs single-ended).

```C
void ADS1263_SetMode(UBYTE Mode);
void ADS1263_ConfigADC1(ADS1263_GAIN gain, ADS1263_DRATE drate);
void ADS1263_ConfigADC2(ADS1263_ADC2_GAIN gain, ADS1263_ADC2_DRATE drate);
```

--------------------------------

### Advanced Data Retrieval and RTD Testing

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

High-level functions for batch data acquisition across all channels and specialized RTD temperature measurement calculations.

```C
void ADS1263_GetAll(UDOUBLE *ADC_Value);
void ADS1263_GetAll_ADC2(UDOUBLE *ADC_Value);
UDOUBLE ADS1263_RTD(ADS1263_DELAY delay, ADS1263_GAIN gain, ADS1263_DRATE drate);
```

--------------------------------

### ADC Configuration and Data Acquisition

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Functions to configure ADC settings (gain, rate) and read data from specific channels or all channels.

```APIDOC
## ADC Configuration and Data Acquisition

### Description
Functions to configure ADC1/ADC2 parameters and retrieve raw data from channels.

### Methods
- `ADS1263_ConfigADC1(gain, drate)`: Configures ADC1 gain and data rate.
- `ADS1263_SetChannal(channel)`: Sets the active channel for ADC1.
- `ADS1263_Read_ADC1_Data()`: Reads 32-bit data from ADC1.
- `ADS1263_GetAll(ADC_Value)`: Retrieves data for all channels.

### Parameters
- **gain** (ADS1263_GAIN) - Required - PGA gain setting.
- **drate** (ADS1263_DRATE) - Required - Data conversion rate.
- **channel** (UBYTE) - Required - Channel index to select.

### Response
- `ADS1263_Read_ADC1_Data` returns UDOUBLE (32-bit raw value).
- `ADS1263_Read_ADC2_Data` returns UDOUBLE (24-bit raw value).
```

--------------------------------

### Channel Selection and Data Acquisition

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Functions to select input channels and read raw ADC data. ADC1 provides 32-bit data, while ADC2 provides 24-bit data.

```C
static void ADS1263_SetChannal(UBYTE Channal);
static void ADS1263_SetChannal_ADC2(UBYTE Channal);
void ADS1263_SetDiffChannal(UBYTE Channal);
void ADS1263_SetDiffChannal_ADC2(UBYTE Channal);
static UDOUBLE ADS1263_Read_ADC1_Data(void);
static UDOUBLE ADS1263_Read_ADC2_Data(void);
```

--------------------------------

### Configure ADS1263 Internal Reference Voltage (C)

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

This C code snippet demonstrates how to modify the internal reference voltage (REF) for the ADS1263 chip by changing the REFMUX value in the ADS1263_ConfigADC1() function. This is often necessary when using PGA with specific voltage ranges.

```c
#Modify the internal REF voltage：
#Change the define in the ADS1263_ConfigADC1() of ADS1263.c from
UBYTE REFMUX = 0x24;
#to 
UBYTE REFMUX = 0x00;
```

--------------------------------

### DAC Test Function Configuration (C)

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Configures the DAC test function for voltage setting, output pin configuration (positive/negative polarity), and enabling/disabling DAC output. This function is crucial for setting up analog output signals.

```C
void ADS1263_DAC(ADS1263_DAC_VOLT volt, UBYTE isPositive, UBYTE isOpen)
```

--------------------------------

### Configure ADS1263 Measurement Mode (C/Python)

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

This snippet shows how to set the measurement mode for the ADS1263 chip. It includes modifications for both C and Python code. Mode 0 is typically single-ended, while Mode 1 is differential. The channel number for differential mode must be less than 5.

```c
#Modify line 33 of main.c (Python code also has the function of the same name)
#change 
ADS1263_SetMode(0);
#to 
ADS1263_SetMode(1);
```

```python
# Assuming a similar function exists in the Python library
# ADS1263_SetMode(0)  # Default single-ended
# ADS1263_SetMode(1)  # Differential mode
```

--------------------------------

### SPI Communication and Data Handling

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Low-level SPI functions for reading and writing registers and commands. Includes a checksum verification function to ensure data integrity during transmission.

```C
static void ADS1263_WriteCmd(UBYTE Cmd);
static void ADS1263_WriteReg(UBYTE Reg, UBYTE data);
static UBYTE ADS1263_Read_data(UBYTE Reg);
static UBYTE ADS1263_Checksum(UDOUBLE val, UBYTE byt);
```

--------------------------------

### RTD Temperature Measurement

Source: https://www.waveshare.com/wiki/High-Precision_AD_HAT

Specialized function for RTD sensor testing and temperature calculation.

```APIDOC
## RTD Test Function

### Description
Configures the ADS1263 for RTD measurement and performs the necessary data conversion to calculate temperature.

### Method
`ADS1263_RTD(delay, gain, drate)`

### Parameters
- **delay** (ADS1263_DELAY) - Required - Conversion delay.
- **gain** (ADS1263_GAIN) - Required - PGA gain.
- **drate** (ADS1263_DRATE) - Required - Data rate.

### Response
- Returns UDOUBLE representing the calculated resistance/temperature value based on Pt100 formula.
```
Tokens:
Raw