1. Introduction

1.1. Before You Start

Before you start you need to:

  • Install the latest e²studio

  • Download the latest SDK for the DA1459x platforms

These can be downloaded from the DA1459x product page.

Additionally, for this tutorial a Pro Development kit is required.

The key goals of this tutorial are to:

  • Provide a basic understanding of Adapters concept

  • Explain the different APIs and configurations of SDADC Adapters

  • Give a complete sample project demonstrating the usage of SDADC Adapters

Note

The example repository on Github contains multiple examples involving the SDADC adapter.

1.2. SDADC Adapters Introduction

This tutorial explains the SDADC adapter and how to configure the DA1459x family of devices to perform analog-to-digital conversions. The SDADC adapter is an intermediate layer between the SDADC Low Level Drivers (LLDs) and a user application. It allows the user to utilize the SDADC interface in a simpler way than when using pure LLDs functions. The key features of SDADC adapters are:

  • Synchronous read/write operations block the calling freeRTOS task while the operation is performed using semaphores rather than relying on a polling loop approach. This means that while the hardware is busy transferring data, the operating system (OS) scheduler may select another task for execution, utilizing processor time more efficiently. When the transfer has finished, the calling task is released and resumes its execution.

  • A DMA channel can be used among various peripherals (for example, I²C, UART). Interconnected peripherals may use the same DMA channel if necessary. The adapter takes care of DMA channel resource management.

  • It ensures that only one device can occupy the SDADC controller after acquiring it.

Note

Adapters are not implemented as separate tasks and should be considered as an additional layer between the application and the LLDs. It is recommended to use adapters for accessing a hardware block.