ESP32 - Actuador con Retroalimentación

En un tutorial anterior, hemos aprendido sobre el actuador lineal sin retroalimentación. En este tutorial, vamos a aprender sobre el actuador lineal con retroalimentación (también llamado actuador lineal retroalimentado). La retroalimentación del actuador lineal proporciona la información para identificar la posición de su recorrido y, a continuación, controlar la posición. En detalle, vamos a aprender:

Acerca del actuador lineal con retroalimentación

Un actuador lineal con retroalimentación es un actuador lineal que cuenta con una señal de retroalimentación que permite identificar su posición y controlarla. La retroalimentación es un potenciómetro que entrega un voltaje proporcional a la posición del recorrido.

Disposición de pines del actuador lineal con retroalimentación

Un actuador lineal con retroalimentación tiene 5 cables:

  • Cable positivo del actuador: este cable se usa para controlar el actuador lineal mediante voltaje alto (12V, 24V, 48V...).
  • Cable negativo del actuador: este cable se usa para controlar el actuador lineal mediante voltaje alto (12V, 24V, 48V...).
  • Cable de 5V: este cable se utiliza para el potenciómetro de retroalimentación. Conecta este cable a 5V o a 3.3V
  • Cable GND: este cable se utiliza para el potenciómetro de retroalimentación. Conecta este cable a GND
  • Cable del potenciómetro: (también llamado cable de retroalimentación o cable de salida) este cable entrega un voltaje proporcional a la posición del recorrido.
Diagrama de pines del actuador lineal con retroalimentación

Cómo funciona

Si suministramos alto voltaje a los cables positivo y negativo, el recorrido del actuador se extenderá o se retraerá. Con más detalle, si conectamos:

  • 12V (12V, 24V, 48V...) y GND al cable positivo y al cable negativo, respectivamente: el actuador lineal se extiende a toda velocidad hasta que alcanza el límite.
  • 12V (12V, 24V, 48V...) y GND al cable negativo y al cable positivo, respectivamente: el actuador lineal se retrae a toda velocidad hasta que alcanza el límite.
  • Mientras se extiende o se retrae, si dejamos de alimentar el actuador (GND en ambos cables, positivo y negativo), el actuador deja de extenderse/retraerse

※ Nota:

  • El valor de voltaje para controlar el actuador depende de la especificación del actuador. Lee la hoja de datos o el manual para conocer el valor de voltaje correspondiente.
  • El actuador puede mantener la posición incluso cuando deja de recibir energía mientras soporta una carga.

El voltaje en el cable del potenciómetro es proporcional a la posición del recorrido en el actuador. Midiendo este voltaje, podemos conocer la posición del recorrido.

Diagrama de cableado

El motor del actuador funciona con 12V, así que necesita un controlador entre él y el ESP32. Este tutorial usa el módulo controlador de motor BTS7960. Mueve un actuador en ambas direcciones. Puede dar mucha corriente, lo cual es bueno, porque un actuador consume una corriente grande cuando arranca y al final de su recorrido.

Diagrama de pines del controlador de motor BTS7960

Los pines del módulo BTS7960 que usamos:

  • RPWM y LPWM: el ESP32 pone uno de ellos en HIGH para extender (RPWM) o para retraer (LPWM) el actuador.
  • R_EN y L_EN: el ESP32 mantiene ambos en HIGH, así el controlador queda encendido.
  • VCC y GND: la alimentación de 5V para el pequeño chip lógico del módulo. VCC va al pin VIN del ESP32 (5V del USB).
  • B+ y B-: la alimentación de 12V para el actuador.
  • M+ y M-: los dos cables del motor del actuador.
  • R_IS y L_IS: no se usan.

Los pines del ESP32 funcionan a 3.3V. Por eso el potenciómetro de retroalimentación recibe su energía del pin 3.3V, y su salida nunca pasa de 3.3V. GPIO36 es un pin solo de entrada, lo cual está bien aquí porque solo leemos en él el voltaje de retroalimentación.

Diagrama de cableado del ESP32 con actuador lineal con retroalimentación y controlador BTS7960

This image is created using Fritzing. Click to enlarge image

Si no sabe c\u00f3mo alimentar ESP32 y otros componentes, encuentre instrucciones en el siguiente tutorial: C\u00f3mo alimentar ESP32.

Pieza Pin Conectar a
Módulo BTS7960 RPWM GPIO16 del ESP32
Módulo BTS7960 LPWM GPIO17 del ESP32
Módulo BTS7960 R_EN GPIO19 del ESP32
Módulo BTS7960 L_EN GPIO18 del ESP32
Módulo BTS7960 VCC VIN (5V) del ESP32
Módulo BTS7960 GND GND del ESP32
Módulo BTS7960 B+, B- + y - del adaptador de 12V (a través del conector de alimentación DC)
Módulo BTS7960 M+, M- los cables positivo y negativo del actuador
Actuador cable de 5V (VCC del potenciómetro) 3.3V del ESP32
Actuador cable GND GND del ESP32
Actuador cable del potenciómetro (OUT) GPIO36 del ESP32

Cómo controlar la extensión y la retracción de un actuador lineal

En resumen: con R_EN y L_EN en HIGH, RPWM en HIGH y LPWM en LOW hacen que el actuador se extienda, RPWM en LOW y LPWM en HIGH hacen que se retraiga, y ambos en LOW lo detienen. Consulta el tutorial ESP32 - Actuador para más detalles.

Cómo encontrar la posición del actuador lineal

A continuación se muestra cómo identificar la posición del recorrido en un actuador lineal.

Calibración

  • Identifica la longitud del recorrido del actuador (en milímetros) midiéndola (con una regla) o leyendo la hoja de datos
  • Identifica los valores de salida cuando el actuador lineal está completamente extendido y completamente retraído ejecutando el código que se muestra a continuación
/* * Este código de ESP32 fue desarrollado por es.newbiely.com * Este código de ESP32 se proporciona al público sin ninguna restricción. * Para tutoriales completos y diagramas de cableado, visite: * https://es.newbiely.com/tutorials/esp32/esp32-actuator-with-feedback */ // the code for getting the feedback when the actuator fully extended and retracted // the actuator is driven by the BTS7960 motor driver #define RPWM_PIN 16 // The ESP32 pin GPIO16 connected to the RPWM pin of the BTS7960 #define LPWM_PIN 17 // The ESP32 pin GPIO17 connected to the LPWM pin of the BTS7960 #define R_EN_PIN 19 // The ESP32 pin GPIO19 connected to the R_EN pin of the BTS7960 #define L_EN_PIN 18 // The ESP32 pin GPIO18 connected to the L_EN pin of the BTS7960 #define POTENTIOMETER_PIN 36 // The ESP32 pin GPIO36 (ADC1_CH0, input only) connected to the potentiometer of the actuator void setup() { Serial.begin(9600); // set the ADC attenuation to 11 dB (up to ~3.3V input) analogSetAttenuation(ADC_11db); // initialize digital pins as outputs. pinMode(RPWM_PIN, OUTPUT); pinMode(LPWM_PIN, OUTPUT); pinMode(R_EN_PIN, OUTPUT); pinMode(L_EN_PIN, OUTPUT); // the actuator does not move yet, then turn the driver on digitalWrite(RPWM_PIN, LOW); digitalWrite(LPWM_PIN, LOW); digitalWrite(R_EN_PIN, HIGH); digitalWrite(L_EN_PIN, HIGH); } void loop() { // extend the actuator at full speed digitalWrite(LPWM_PIN, LOW); digitalWrite(RPWM_PIN, HIGH); delay(20000); // wait for actuator fully extends. It will stop extending automatically when reaching the limit // read the analog in value: int POTENTIOMETER_MAX = analogRead(POTENTIOMETER_PIN); Serial.print("POTENTIOMETER_MAX = "); Serial.println(POTENTIOMETER_MAX); // retracts the actuator at full speed digitalWrite(RPWM_PIN, LOW); digitalWrite(LPWM_PIN, HIGH); delay(20000); // wait for actuator fully retracts. It will stop retracting automatically when reaching the limit int POTENTIOMETER_MIN = analogRead(POTENTIOMETER_PIN); Serial.print("POTENTIOMETER_MIN = "); Serial.println(POTENTIOMETER_MIN); }
  • Verás el registro en el Monitor Serial como en el siguiente ejemplo
∞
Newbiely | Arduino IDE 2.3.8
──
☐
✕
File
Edit
Sketch
Tools
Help
ESP32 Dev Module
Newbiely.ino
···
8 Serial.println("Hello World!");
Output
Serial Monitor
Message (Enter to send message to 'ESP32 Dev Module' on 'COM15')
New Line
9600 baud
POTENTIOMETER_MAX = 987 POTENTIOMETER_MIN = 13
Ln 11, Col 1
ESP32 Dev Module on COM15
2
  • Anota estos valores
  • ¿Los valores mínimo y máximo están al revés? Entonces pasa el cable del actuador que está en M+ a M-, y el que está en M- a M+ (o intercambia los números de RPWM_PIN y LPWM_PIN en el código)
  • Actualiza tres valores en el código de abajo
  • Código ESP32 que calcula la posición del actuador

    /* * Este código de ESP32 fue desarrollado por es.newbiely.com * Este código de ESP32 se proporciona al público sin ninguna restricción. * Para tutoriales completos y diagramas de cableado, visite: * https://es.newbiely.com/tutorials/esp32/esp32-actuator-with-feedback */ // ESP32 reads the position of a feedback linear actuator (BTS7960 motor driver) #define RPWM_PIN 16 // The ESP32 pin GPIO16 connected to the RPWM pin of the BTS7960 #define LPWM_PIN 17 // The ESP32 pin GPIO17 connected to the LPWM pin of the BTS7960 #define R_EN_PIN 19 // The ESP32 pin GPIO19 connected to the R_EN pin of the BTS7960 #define L_EN_PIN 18 // The ESP32 pin GPIO18 connected to the L_EN pin of the BTS7960 #define POTENTIOMETER_PIN 36 // The ESP32 pin GPIO36 (ADC1_CH0, input only) connected to the potentiometer of the actuator #define STROKE_LENGTH 102 // PLEASE UPDATE THIS VALUE (in millimeter) #define POTENTIOMETER_MAX 2340 // PLEASE UPDATE THIS VALUE #define POTENTIOMETER_MIN 13 // PLEASE UPDATE THIS VALUE void setup() { Serial.begin(9600); // set the ADC attenuation to 11 dB (up to ~3.3V input) analogSetAttenuation(ADC_11db); // initialize digital pins as outputs. pinMode(RPWM_PIN, OUTPUT); pinMode(LPWM_PIN, OUTPUT); pinMode(R_EN_PIN, OUTPUT); pinMode(L_EN_PIN, OUTPUT); // turn the driver on (both halves) digitalWrite(R_EN_PIN, HIGH); digitalWrite(L_EN_PIN, HIGH); } void loop() { // extend the actuator at full speed digitalWrite(LPWM_PIN, LOW); digitalWrite(RPWM_PIN, HIGH); int potentiometer_value = analogRead(POTENTIOMETER_PIN); int stroke_pos = map(potentiometer_value, POTENTIOMETER_MIN, POTENTIOMETER_MAX, 0, STROKE_LENGTH); Serial.print("The stroke's position = "); Serial.print(stroke_pos); Serial.println(" mm"); }
    • Actualiza los tres valores calibrados en el código
    • Sube el código al ESP32
    • Mira el resultado en el Monitor Serial
    ∞
    Newbiely | Arduino IDE 2.3.8
    ──
    ☐
    ✕
    File
    Edit
    Sketch
    Tools
    Help
    ESP32 Dev Module
    Newbiely.ino
    ···
    8 Serial.println("Hello World!");
    Output
    Serial Monitor
    Message (Enter to send message to 'ESP32 Dev Module' on 'COM15')
    New Line
    9600 baud
    The stroke's position = 2 mm The stroke's position = 35 mm The stroke's position = 43 mm The stroke's position = 60 mm The stroke's position = 68 mm The stroke's position = 79 mm The stroke's position = 83 mm The stroke's position = 96 mm The stroke's position = 100 mm
    Ln 11, Col 1
    ESP32 Dev Module on COM15
    2

    Cómo controlar un actuador lineal a una posición específica

    /* * Este código de ESP32 fue desarrollado por es.newbiely.com * Este código de ESP32 se proporciona al público sin ninguna restricción. * Para tutoriales completos y diagramas de cableado, visite: * https://es.newbiely.com/tutorials/esp32/esp32-actuator-with-feedback */ // ESP32 moves a feedback linear actuator to a target position (BTS7960 motor driver) #define RPWM_PIN 16 // The ESP32 pin GPIO16 connected to the RPWM pin of the BTS7960 #define LPWM_PIN 17 // The ESP32 pin GPIO17 connected to the LPWM pin of the BTS7960 #define R_EN_PIN 19 // The ESP32 pin GPIO19 connected to the R_EN pin of the BTS7960 #define L_EN_PIN 18 // The ESP32 pin GPIO18 connected to the L_EN pin of the BTS7960 #define POTENTIOMETER_PIN 36 // The ESP32 pin GPIO36 (ADC1_CH0, input only) connected to the potentiometer of the actuator #define STROKE_LENGTH 102 // PLEASE UPDATE THIS VALUE (in millimeter) #define POTENTIOMETER_MAX 2340 // PLEASE UPDATE THIS VALUE #define POTENTIOMETER_MIN 13 // PLEASE UPDATE THIS VALUE #define TOLERANCE 5 // in millimeter int targetPosition_mm = 50; // in millimeter void setup() { Serial.begin(9600); // set the ADC attenuation to 11 dB (up to ~3.3V input) analogSetAttenuation(ADC_11db); // initialize digital pins as outputs. pinMode(RPWM_PIN, OUTPUT); pinMode(LPWM_PIN, OUTPUT); pinMode(R_EN_PIN, OUTPUT); pinMode(L_EN_PIN, OUTPUT); // the actuator does not move yet, then turn the driver on ACTUATOR_stop(); digitalWrite(R_EN_PIN, HIGH); digitalWrite(L_EN_PIN, HIGH); } void loop() { int potentiometer_value = analogRead(POTENTIOMETER_PIN); int stroke_pos = map(potentiometer_value, POTENTIOMETER_MIN, POTENTIOMETER_MAX, 0, STROKE_LENGTH); Serial.print("The stroke's position = "); Serial.print(stroke_pos); Serial.println(" mm"); if (stroke_pos < (targetPosition_mm - TOLERANCE)) ACTUATOR_extend(); else if (stroke_pos > (targetPosition_mm + TOLERANCE)) ACTUATOR_retract(); else ACTUATOR_stop(); } void ACTUATOR_extend() { digitalWrite(LPWM_PIN, LOW); // LPWM off first digitalWrite(RPWM_PIN, HIGH); // RPWM HIGH: extend at full speed } void ACTUATOR_retract() { digitalWrite(RPWM_PIN, LOW); // RPWM off first digitalWrite(LPWM_PIN, HIGH); // LPWM HIGH: retract at full speed } void ACTUATOR_stop() { digitalWrite(RPWM_PIN, LOW); // both LOW while R_EN and L_EN are HIGH: brake digitalWrite(LPWM_PIN, LOW); }

    ※ Nota:

    Este tutorial utiliza la función analogRead() para leer valores de un ADC (Convertidor Analógico-Digital) conectado a un potenciómetro. El ADC del ESP32 es bueno para proyectos que NO requieren alta precisión. Sin embargo, para proyectos que requieren mediciones precisas, ten en cuenta:

    • El ADC del ESP32 no es perfectamente preciso y podría necesitar calibración para obtener resultados correctos. Cada placa ESP32 puede ser un poco diferente, por lo que necesitas calibrar el ADC para cada placa individual.
    • La calibración puede ser difícil, especialmente para principiantes, y no siempre da los resultados exactos que esperas.

    Para proyectos que requieren alta precisión, considera usar un ADC externo (por ejemplo, ADS1115) con el ESP32 o usar un Arduino, que tiene un ADC más fiable. Si aún quieres calibrar el ADC del ESP32, consulta ESP32 ADC Calibration Driver

    Video Tutorial

    Estamos considerando crear tutoriales en video. Si considera que los tutoriales en video son importantes, suscríbase a nuestro canal de YouTube para motivarnos a crear los videos.

    Referencias de funciones

    Tutoriales Relacionados

    ※ NUESTROS MENSAJES

    • No dude en compartir el enlace de este tutorial. Sin embargo, por favor no use nuestro contenido en otros sitios web. Hemos invertido mucho esfuerzo y tiempo en crear el contenido, ¡por favor respete nuestro trabajo!