AM263Px MCU+ SDK: ADC Global Force

| AM263Px MCU+ SDK 26.00.00 |

ADC Global Force

# Introduction

This example demonstrates the Global SOC force feature. The ADCs that need to be forced globally are first selected in the Global Control using the API `SOC_enableAdcGlobalForce` with the instance number and the enable (TRUE/ FALSE) as arguments. then the API `SOC_adcSocGlobalForce` can be used to set a software trigger globally on the given SOC number at all the ADCs selected above.

## Configurations

- ADCx SOC0 is configured for Software only trigger and generate interrupt at EOC0. x is 0,1,2,3,4.

# External Connections

External connections are arbitrary for this feature demonstration. for instance, ADC0 SOC0 is configured for Channel 0. Feed Analog voltages on ADC0_AIN2

## AM263Px-CC E2 or AM261x-SOM E1

- ADC0_AIN2, i.e., HSEC PIN 15

## AM263Px-LP

- ADC0_AIN2, i.e., J5/7 PIN 66

## AM261x-LP

- ADC0_AIN2, i.e., J5/7 PIN 63

# Watch Variables

The below watch variables can be used to view ADC conversion results.

- gAdc0Results[] : Digital representation of the voltage converted by ADC0 when triggered by Global Software force
- gAdc1Results[] : Digital representation of the voltage converted by ADC1 when triggered by Global Software force
- gAdc2Results[] : Digital representation of the voltage converted by ADC2 when triggered by Global Software force
- gAdc3Results[] : Digital representation of the voltage converted by ADC3 when triggered by Global Software force
- gAdc4Results[] : Digital representation of the voltage converted by ADC4 when triggered by Global Software force

# Supported Combinations

Parameter | Value
--- | ---
CPU + OS | r5fss0-0 nortos
Toolchain | ti-arm-clang
Board | am263px-cc, am263px-lp
Example folder | examples/drivers/adc/adc_global_force/

# Steps to Run the Example

- When using CCS projects to build, import the CCS project for the required combination and build it using the CCS project menu (see Using SDK with CCS Projects).
- When using makefiles to build, note the required combination and build using make command (see Using SDK with Makefiles)
- Establish connections as mentioned in External Connections section
- Launch a CCS debug session and run the executable, see CCS Launch, Load and Run
- Using watch variables, view the ADC conversion results.
- View the ADC conversion results in UART console logs

# See Also

ADC

# Sample Output

Shown below is a sample output when the application is run,

ADC Triggered by Global Software Force Test Started ...
ADC Triggered by Global Software Force Test Passed
All tests have passed!!