96 Chapter 8 Serial Communication www.freenove.

com █

Project 8.2 Serial Read and Write

From last section, we use serial port on Freenove ESP32 to send data to a computer, now we will use that to
receive data from computer.

Component and circuit are the same as in the previous project.

Sketch

Sketch_08.2_SerialRW

Download the code to ESP32-WROVER, open the serial monitor, and set the bottom to Newline, 115200. As
shown in the following figure:

Any concerns?  [email protected]

 █ www.freenove.com Chapter 8 Serial Communication 97

Newline, 115200 baud

Then type characters like 'ABCDEG' into the data sent at the top and click the Send button to print out the
data ESP32 receives.

Any concerns?  [email protected]

98 Chapter 8 Serial Communication www.freenove.com █

The following is the program code:

1 String inputString = ""; //a String to hold incoming data
2 bool stringComplete = false; // whether the string is complete
3
4 void setup() {
5 Serial.begin(115200);
6 Serial.println(String("\nESP32 initialization completed! \n")
7 + String("Please input some characters,\n")
8 + String("select \"Newline\" below and click send button. \n"));
9 }
10
11 void loop() {
12 if (Serial.available()) { // judge whether data has been received
13 char inChar = Serial.read(); // read one character
14 inputString += inChar;
15 if (inChar == '\n') {
16 stringComplete = true;
17 }
18 }
19 if (stringComplete) {
20 Serial.printf("inputString: %s \n", inputString);
21 inputString = "";
22 stringComplete = false;
23 }
24 }

In loop(), determine whether the serial port has data, if so, read and save the data, and if the newline
character is read, print out all the data that has been read.

Reference
String();
Constructs an instance of the String class.
For more information, please visit
https://www.arduino.cc/reference/en/language/variables/data-types/stringobject/
int available(void);
Get the number of bytes (characters) available for reading from the serial port. This is data that’s already
arrived and stored in the serial receive buffer.
Serial.read();
Reads incoming serial data.

Any concerns?  [email protected]

 █ www.freenove.com Chapter 9 AD/DA Converter 99

Chapter 9 AD/DA Converter

We have learned how to control the brightness of LED through PWM and understood that PWM is not the
real analog before. In this chapter, we will learn how to read analog, convert it into digital and convert the
digital into analog output. That is, ADC and DAC.

Project 9.1 Read the Voltage of Potentiometer

In this project, we will use the ADC function of ESP32 to read the voltage value of potentiometer. And then
output the voltage value through the DAC to control the brightness of LED.

Component List

ESP32-WROVER x1 GPIO Extension Board x1

Breadboard x1

Rotary potentiometer x1 Resistor 220Ω x1 LED x1 Jumper M/M x5

Any concerns?  [email protected]

100 Chapter 9 AD/DA Converter www.freenove.com █

Related knowledge

ADC
An ADC is an electronic integrated circuit used to convert analog signals such as voltages to digital or binary
form consisting of 1s and 0s. The range of our ADC on ESP32 is 12 bits, that means the resolution is
2^12=4096, and it represents a range (at 3.3V) will be divided equally to 4096 parts. The rage of analog values
corresponds to ADC values. So the more bits the ADC has, the denser the partition of analog will be and the
greater the precision of the resulting conversion.

Subsection 1: the analog in rang of 0V---3.3/4095 V corresponds to digital 0;

Subsection 2: the analog in rang of 3.3/4095 V---2*3.3 /4095V corresponds to digital 1;
…
The following analog will be divided accordingly.
The conversion formula is as follows:

Analog Voltage
𝐴𝐷𝐶 𝑉𝑎𝑙𝑢𝑒 = ∗ 4095
3.3
DAC
The reversing of this process requires a DAC, Digital-to-Analog Converter. The digital I/O port can output
high level and low level (0 or 1), but cannot output an intermediate voltage value. This is where a DAC is
useful. ESP32 has two DAC output pins with 8-bit accuracy, GPIO25 and GPIO26, which can divide VDD
(here is 3.3V) into 2*8=256 parts. For example, when the digital quantity is 1, the output voltage value is
3.3/256 *1 V, and when the digital quantity is 128, the output voltage value is 3.3/256 *128=1.65V, the higher
the accuracy of DAC, the higher the accuracy of output voltage value will be.

The conversion formula is as follows:

DAC Value
𝐴𝑛𝑎𝑙𝑜𝑔 𝑉𝑜𝑙𝑡𝑎𝑔𝑒 = ∗ 3.3 (V)
255

Any concerns?  [email protected]

 █ www.freenove.com Chapter 9 AD/DA Converter 101

ADC on ESP32
ESP32 has two digital analog converters with successive approximations of 12-bit accuracy, and a total of 16
pins can be used to measure analog signals. GPIO pin sequence number and analog pin definition are
shown in the following table.
Pin number in Arduino GPIO number ADC channel
A0 GPIO 36 ADC1_CH0
A3 GPIO 39 ADC1_CH3
A4 GPIO 32 ADC1_CH4
A5 GPIO 33 ADC1_CH5
A6 GPIO 34 ADC1_CH6
A7 GPIO 35 ADC1_CH7
A10 GPIO 4 ADC2_CH0
A11 GPIO 0 ADC2_CH1
A12 GPIO 2 ADC2_CH2
A13 GPIO 15 ADC2_CH3
A14 GPIO 13 ADC2_CH4
A15 GPIO 12 ADC2_CH5
A16 GPIO 14 ADC2_CH6
A17 GPIO 27 ADC2_CH7
A18 GPIO 25 ADC2_CH8
A19 GPIO 26 ADC2_CH9
The analog pin number is also defined in ESP32's code base. For example, you can replace GPIO36 with A0
in the code.
Note: ADC2 is disabled when ESP32's WiFi function is enabled.
DAC on ESP32
ESP32 has two 8-bit digital analog converters to be connected to GPIO25 and GPIO26 pins, respectively, and
it is immutable. As shown in the following table.
Simulate pin number GPIO number
DAC1 25
DAC2 26
The DAC pin number is already defined in ESP32's code base; for example, you can replace GPIO25 with DAC1
in the code.
Note: In this ESP32, GPIO26 is used as the camera's IIC-SDA pin, which is connected to 3.3V through a
resistor.Therefore, DAC2 cannot be used.

Any concerns?  [email protected]

102 Chapter 9 AD/DA Converter www.freenove.com █

Component knowledge

Potentiometer
A potentiometer is a three-terminal resistor. Unlike the resistors that we have used thus far in our project
which have a fixed resistance value, the resistance value of a potentiometer can be adjusted. A potentiometer
is often made up by a resistive substance (a wire or carbon element) and movable contact brush. When the
brush moves along the resistor element, there will be a change in the resistance of the potentiometer’s output
side (3) (or change in the voltage of the circuit that is a part). The illustration below represents a linear sliding
potentiometer and its electronic symbol on the right.

What between potentiometer pin 1 and pin 2 is the resistor body, and pins 3 is connected to brush. When
brush moves from pin 1 to pin 2, the resistance between pin 1 and pin 3 will increase up to body resistance
linearly, and the resistance between pin 2 and pin 3 will decrease down to 0 linearly.
In the circuit. The both sides of resistance body are often connected to the positive and negative electrode of
the power. When you slide the brush pin 3, you can get a certain voltage in the range of the power supply.

Rotary potentiometer
Rotary potentiometer and linear potentiometer have similar function; their only difference is: the resistance
is adjusted by rotating the potentiometer.

Any concerns?  [email protected]

 █ www.freenove.com Chapter 9 AD/DA Converter 103

Circuit

Schematic diagram

Hardware connection. If you need any support, please feel free to contact us via: [email protected]

Any concerns?  [email protected]

104 Chapter 9 AD/DA Converter www.freenove.com █

Sketch

Sketch_09.1_ADC_DAC

Download the code to ESP32-WROVER, open the serial monitor, and set the baud rate to 115200. As shown
in the following figure,

Any concerns?  [email protected]

 █ www.freenove.com Chapter 9 AD/DA Converter 105

The serial monitor prints ADC values, DAC values, and the output voltage of the potentiometer. In the code,
we made the voltage output from the DAC pin equal to the voltage input from the ADC pin. Rotate the handle
of the potentiometer and the print will change. When the voltage is greater than 1.6V (voltage needed to turn
on red LED), LED starts emitting light. If you continue to increase the output voltage, the LED will become
more and more brighter. When the voltage is less than 1.6v, the LED will not light up, because it does not
reach the voltage to turn on LED, which indirectly proves the difference between DAC and PWM. (if you have
an oscilloscope, you can check the waveform of the DAC output through it.)
The following is the code:
1 #define PIN_ANALOG_IN 4
2
3 void setup() {
4 Serial.begin(115200);
5 }
6
7 void loop() {
8 int adcVal = analogRead(PIN_ANALOG_IN);
9 int dacVal = map(adcVal, 0, 4095, 0, 255);
10 double voltage = adcVal / 4095.0 * 3.3;
11 dacWrite(DAC1, dacVal);
12 Serial.printf("ADC Val: %d, \t DAC Val: %d, \t Voltage: %.2fV\n", adcVal, dacVal, voltage);
13 delay(200);
14 }
In loop()，the analogRead() function is used to obtain the ADC value, and then the map() function is used to
convert the value into an 8-bit precision DAC value. The function dacWrite() is used to output the value. The
input and output voltage are calculated according to the previous formula, and the information is finally
printed out.
8 int adcVal = analogRead(PIN_ANALOG_IN);
9 int dacVal = map(adcVal, 0, 4095, 0, 255);
10 double voltage = adcVal / 4095.0 * 3.3;
11 dacWrite(DAC1, dacVal);
12 Serial.printf("ADC Val: %d, \t DAC Val: %d, \t Voltage: %.2fV\n", adcVal, dacVal, voltage);

Reference
uint16_t analogRead(uint8_t pin);
Reads the value from the specified analog pin. Return the analog reading on the pin. (0-4095 for 12 bits).
void dacWrite(uint8_t pin, uint8_t value);
This writes the given value to the supplied analog pin.
long map(long value,long fromLow,long fromHigh,long toLow,long toHigh);
Re-maps a number from one range to another. That is, a value of fromLow would get mapped to toLow, a
value of fromHigh to toHigh, values in-between to values in-between, etc.

Any concerns?  [email protected]

106 Chapter 9 AD/DA Converter www.freenove.com █

Project 9.2 Get Voltage (use idf)

If you have a voltmeter, in the previous project, you may discover there is a slight error between the voltage
values for ESP32 and the voltmeter values.
ESP32 provides ADC calibration, but the Arduino code base doesn't use it. The functions in the IDF-SDK library
help to obtain more accurate ADC and voltage values.

Related Knowledge

Minimizing Noise
The ESP32 ADC’s sensitive to noise will lead to large discrepancies in ADC readings. To minimize noise, users
may connect a 0.1uF capacitor to the ADC input pad in use. Multisampling may also be used to further
mitigate the effects of noise.

Graph illustrating noise mitigation using capacitor and multisampling of 64 samples.

Any concerns?  [email protected]

 █ www.freenove.com Chapter 9 AD/DA Converter 107

ADC Calibration
The esp_adc_cal/include/esp_adc_cal.h API provides functions to correct for differences in measured voltages
caused by variation of ADC reference voltages (Vref) between chips. The designed ADC reference voltage is
1100mV, however the true reference voltage can range from 1000mV to 1200mV amongst different ESP32s.

Graph illustrating the effect of differing reference voltages on the ADC voltage curve.

Correcting ADC readings using this API involves characterizing one of the ADCs at a given attenuation to
obtain a characteristics curve (ADC-Voltage curve) that takes into account the difference in ADC reference
voltage. The characteristics curve is in the form of y = coeff_a * x + coeff_b and is used to convert ADC
readings to voltages in mV. Calculation of the characteristics curve is based on calibration values, which can
be stored in eFuse or provided by the user.

For more details, please visit:

https://docs.espressif.com/projects/esp-idf/en/latest/api-reference/peripherals/adc.html

Any concerns?  [email protected]

108 Chapter 9 AD/DA Converter www.freenove.com █

PIN Numbering
ADC serial pin number of Arduino pin number of IDF- GPIO number
number SDK
A0 ADC1_CHANNEL_0 GPIO 36
A1 ADC1_CHANNEL_1 GPIO 37
A2 ADC1_CHANNEL_2 GPIO 38
A3 ADC1_CHANNEL_3 GPIO 39
ADC1 A4 ADC1_CHANNEL_4 GPIO 32
A5 ADC1_CHANNEL_5 GPIO 33
A6 ADC1_CHANNEL_6 GPIO 34
A7 ADC1_CHANNEL_7 GPIO 35
A10 ADC2_CHANNEL_0 GPIO 4
A11 ADC2_CHANNEL_1 GPIO 0
A12 ADC2_CHANNEL_2 GPIO 2
A13 ADC2_CHANNEL_3 GPIO 15
A14 ADC2_CHANNEL_4 GPIO 13
ADC2 A15 ADC2_CHANNEL_5 GPIO 12
A16 ADC2_CHANNEL_6 GPIO 14
A17 ADC2_CHANNEL_7 GPIO 27
A18 ADC2_CHANNEL_8 GPIO 25
A19 ADC2_CHANNEL_9 GPIO 26

Any concerns?  [email protected]

 █ www.freenove.com Chapter 9 AD/DA Converter 109

Sketch

Sketch_09.2_ADC

Download the code to ESP32-WROVER, open the serial monitor, and set the baud rate to 115200. As shown
in the following illustration,

By rotating the handle of the potentiometer, the voltage value printed by the serial monitor will change. If
you have a voltmeter, you can verify that this value is more accurate than the value using analogRead(), but
there are some limits to the range.

Any concerns?  [email protected]

110 Chapter 9 AD/DA Converter www.freenove.com █

The following is the program code:

1 #include "esp_adc_cal.h"
2 #define PIN_ANALOG_IN 4 // A10, ADC2_CHANNEL_0D
3
4 #define DEFAULT_VREF 1100 //Use adc2_vref_to_gpio() to obtain a better estimate
5 #define NUM_OF_SAMPLES 64 //Multisampling, and get average
6
7 adc_channel_t channel = ADC_CHANNEL_0; // ADC1:GPIO36, ADC2:GPIO4
8 adc_unit_t unit = ADC_UNIT_2; // ADC2
9 adc_atten_t atten = ADC_ATTEN_DB_11; // Full scale 0-3.9V, precision range 150mV-2450mV
10
11 esp_adc_cal_characteristics_t *adc_chars;
12
13 esp_adc_cal_value_t val_type;
14
15
16 void setup() {
17 Serial.begin(115200);
18 //Check if Two Point or Vref are burned into eFuse
19 check_efuse();
20 //Configure ADC
21 if (unit == ADC_UNIT_1) { // ADC1 and ADC2 are initialized differently
22 adc1_config_width(ADC_WIDTH_BIT_12);
23 adc1_config_channel_atten((adc1_channel_t)channel, atten);
24 }
25 else {
26 adc2_config_channel_atten((adc2_channel_t)channel, atten);
27 }
28 //Characterize ADC
29 adc_chars = (esp_adc_cal_characteristics_t*)calloc(1,
30 sizeof(esp_adc_cal_characteristics_t));
31 esp_adc_cal_value_t val_type = esp_adc_cal_characterize(unit, atten, ADC_WIDTH_BIT_12,
32 DEFAULT_VREF, adc_chars);
33 print_char_val_type(val_type);
34 }
35
36 void loop() {
37 uint32_t adc_reading = 0;
38 for (int i = 0; i < NUM_OF_SAMPLES; i++) { // Multisampling
39 if (unit == ADC_UNIT_1) {
40 adc_reading += adc1_get_raw((adc1_channel_t)channel);
41 }
42 else {
43 int raw;

Any concerns?  [email protected]

 █ www.freenove.com Chapter 9 AD/DA Converter 111

44 adc2_get_raw((adc2_channel_t)channel, ADC_WIDTH_BIT_12, &raw);

45 adc_reading += raw;
46 }
47 }
48 adc_reading /= NUM_OF_SAMPLES;
49 //Convert adc_reading to voltage in mV
50 uint32_t voltage = esp_adc_cal_raw_to_voltage(adc_reading, adc_chars);
51 printf("Raw: %d\tVoltage: %dmV\n", adc_reading, voltage);
52 delay(1000);
53 }
54
55 void check_efuse()
56 {
57 //Check TP is burned into eFuse
58 if (esp_adc_cal_check_efuse(ESP_ADC_CAL_VAL_EFUSE_TP) == ESP_OK) {
59 printf("eFuse Two Point: Supported\n");
60 }
61 else {
62 printf("eFuse Two Point: NOT supported\n");
63 }
64
65 //Check Vref is burned into eFuse
66 if (esp_adc_cal_check_efuse(ESP_ADC_CAL_VAL_EFUSE_VREF) == ESP_OK) {
67 printf("eFuse Vref: Supported\n");
68 }
69 else {
70 printf("eFuse Vref: NOT supported\n");
71 }
72 }
73
74 void print_char_val_type(esp_adc_cal_value_t val_type)
75 {
76 if (val_type == ESP_ADC_CAL_VAL_EFUSE_TP) {
77 printf("Characterized using Two Point Value\n");
78 }
79 else if (val_type == ESP_ADC_CAL_VAL_EFUSE_VREF) {
80 printf("Characterized using eFuse Vref\n");
81 }
82 else {
83 printf("Characterized using Default Vref\n");
84 }
85 }

Any concerns?  [email protected]

112 Chapter 9 AD/DA Converter www.freenove.com █

For most ADC related applications, analogRead() is sufficient. This method can be used in applications where
ADC conversion accuracy is required.
About the project used in the IDF API, here is a detailed description:
https://docs.espressif.com/projects/esp-idf/en/latest/api-reference/peripherals/adc.html

Any concerns?  [email protected]