Macros
#define	I2C_SDA_PIN 9
	I2C SDA pin for ADS1015 communication.
#define	I2C_SCL_PIN 8
	I2C SCL pin for ADS1015 communication.
#define	ADS_ALERT_PIN 10
	ADS1015 interrupt pin for completed conversions.
#define	RX_PIN 20
	UART receive pin for RS485.
#define	TX_PIN 21
	UART transmit pin for RS485.

Functions
void	setup ()
	System initialization function.
void	loop ()
	System main loop.

Variables
Adafruit_ADS1015	ads
	ADS1015 converter instance.
const int	NUM_CHANNELS = 3
	Number of ADC channels to sample.

Detailed Description

Overview

This module implements the ESP32 hardware configuration and complete flow of:

I2C peripheral configuration for ADS1015 communication.
RS485 UART configuration for Modbus RTU communication.
ADC conversion interrupt system initialization.
FreeRTOS configuration with tasks distributed across cores.

Structure and Components

Pin and peripheral configuration
- I2C_SDA_PIN, I2C_SCL_PIN: I2C bus for ADS1015.
- RX_PIN, TX_PIN: RS485 serial communication.
- ADS_ALERT_PIN: conversion complete interrupt.
Hardware objects
- Adafruit_ADS1015: analog-to-digital converter instance.
- HardwareSerial: serial port for Modbus RTU.
- ModbusServerRTU: Modbus protocol server.
System configuration
- NUM_CHANNELS: configured ADC channels (3 channels).
- Speed parameters: 19200 bps UART, 400kHz I2C, 3300 SPS ADC.
- GAIN_TWOTHIRDS: ADS1015 gain for ±6.144V range.

Main API

Configuration: I2C_SDA_PIN, I2C_SCL_PIN, ADS_ALERT_PIN, RX_PIN, TX_PIN, NUM_CHANNELS.
Objects: ads.
Functions: setup(), loop(), on_adc_data_ready().

Usage

Flow summary:

1) Hardware initialization

I2C bus configuration (SDA=9, SCL=8) at 400kHz.
ADS1015 initialization with TWOTHIRDS gain and 3300 SPS speed.
UART configuration (RX=20, TX=21) at 19200 bps, 8N1 for RS485.
Interrupt registration on pin 10 for ADS1015 ALERT signal.

2) FreeRTOS task configuration

task_adquisicion: core 0, priority 5, ADC conversion management.
task_procesamiento: core 0, priority 3, RMS calculation with FIFOs.
dataUpdateTask: core 0, priority 1, Modbus register updates.
Modbus server: core 0, RTU request handling.

3) ADC configuration

Single-ended mode on 3 channels (A0, A1, A2).
Interrupt-driven conversions using ALERT signal.
Round-robin sequence between channels managed by ISR.

4) Modbus configuration

RTU server with ID=1, timeout=2000ms.
Worker registration for function 03 (holding register read).
Discovery response (registers 0-7) and RMS data (registers 10+).

Warnings and best practices:

Verify I2C connections before ads.begin() to avoid hangs.
Use external pullups on SDA/SCL lines if communication issues occur.
Properly configure ADS1015 ALERT signal for interrupts.
Verify I2C bus speed according to cable length.
Protect concurrent hardware access using appropriate semaphores.
Ensure stable power supply for accurate ADC conversions.

Function Documentation

◆ loop()

void loop ( )

System main loop.

Executes demonstration and debugging tasks. Periodically displays sample RMS values from the system-maintained history.

◆ setup()

void setup ( )

System initialization function.

Configures hardware, initializes peripherals, creates FreeRTOS tasks and registers Modbus handlers. Establishes complete embedded system architecture.

Macros

Functions

Variables