ESP32 - Actuador
Este tutorial te enseña cómo usar el ESP32 para controlar un actuador lineal. En detalle, aprenderemos:
- Cómo funciona un actuador lineal
- Cómo hacer que un actuador lineal se extienda o se retraiga.
- Qué hace el controlador BTS7960 y cómo el ESP32 lo usa para mover un actuador lineal.
- Cómo controlar la velocidad de un actuador lineal.
Este tutorial es para un actuador lineal sin retroalimentación. Si quieres aprender sobre un actuador lineal con retroalimentación, consulta el tutorial ESP32 - Actuador con retroalimentación.
Hardware Requerido
Or you can buy the following kits:
| 1 | × | DIYables ESP32 Starter Kit (ESP32 included) | |
| 1 | × | DIYables ESP32 S3 Starter Kit (ESP32 S3 included) | |
| 1 | × | DIYables Sensor Kit (18 sensors/displays) |
Acerca del actuador lineal

Diagrama de pines del actuador lineal
El actuador lineal tiene dos cables:
- Cable positivo: normalmente rojo
- Cable negativo: normalmente negro

Cómo funciona
Al comprar un actuador lineal, debes saber con qué voltaje funciona. Tomemos como ejemplo un actuador lineal de 12V.
Al alimentar el actuador lineal de 12V con una fuente de alimentación de 12V:
- 12V y GND al cable positivo y al cable negativo, respectivamente: el actuador lineal se extiende a máxima velocidad hasta que alcanza el límite.
- 12V y GND al cable negativo y al cable positivo, respectivamente: el actuador lineal se retrae a máxima 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 o retraerse
※ Nota:
Los motores de corriente continua, los servomotores y los motores paso a paso sin engranajes, cuando llevan una carga, no pueden mantener la posición si dejamos de alimentarlos. A diferencia de estos motores, el actuador puede mantener la posición incluso cuando deja de recibir energía mientras soporta una carga.
Si alimentamos los actuadores lineales con menos de 12V, el actuador lineal todavía se extiende/retrae, pero no a la velocidad máxima. Eso significa que si cambiamos el voltaje de la fuente de alimentación, podemos cambiar la velocidad del actuador lineal. Sin embargo, este método no se utiliza en la práctica debido a la dificultad para controlar el voltaje de la fuente de alimentación. En su lugar, fijamos el voltaje de la fuente de alimentación y controlamos la velocidad del actuador lineal mediante una señal PWM. Cuanto mayor es el ciclo de trabajo del PWM, mayor es la velocidad a la que el actuador lineal se extiende o se retrae.

Cómo controlar un actuador lineal con ESP32
El control de un actuador lineal incluye:
- Extender el actuador lineal a la velocidad máxima.
- Retraer el actuador lineal a la velocidad máxima.
- (opcional) controlar la velocidad de extensión/retracción
El ESP32 puede generar la señal para controlar el actuador lineal. Sin embargo, esta señal tiene bajo voltaje y poca corriente; no podemos usarla para controlar el actuador lineal. Necesitamos usar un controlador de hardware entre el ESP32 y el actuador lineal. El controlador realiza dos funciones:
- Amplificar la señal de control del ESP32 (corriente y voltaje)
- Recibir otra señal de control del ESP32 para intercambiar los polos de la fuente de alimentación → para controlar la dirección.
※ Nota:
- Este tutorial se puede aplicar a todos los actuadores lineales. El actuador lineal de 12V es solo un ejemplo.
- Cuando controlas un actuador lineal de 5V, aún necesitas un controlador entre el ESP32 y el actuador lineal, porque el pin del ESP32 solo entrega 3.3V y no proporciona suficiente corriente para el actuador lineal.
Muchos chips y módulos pueden funcionar como controlador de actuador lineal. El BTS7960 es el controlador que elegimos. Reemplazó al L298N en esta página: un actuador consume una corriente grande cuando arranca y cuando llega al final de su recorrido, y el BTS7960 lo soporta con facilidad, casi sin pérdida de voltaje.
※ Nota:
También puedes usar relés como controlador. Sin embargo, se requieren 4 relés para controlar un único actuador lineal (tanto para extender como para retraer)
Acerca del controlador BTS7960
El módulo BTS7960 (también vendido como IBT-2) mueve UN motor o UN actuador lineal en ambas direcciones. Tiene dos chips de potencia BTS7960B. Cada chip conecta un cable del actuador al + o al - de la fuente de alimentación. Juntos, los dos chips forman un puente H completo, así la corriente puede pasar por el actuador en ambas direcciones.
Diagrama de pines del controlador BTS7960

El módulo tiene un conector de 8 pines para las señales de control y cuatro bornes de tornillo para la alimentación.
Los pines del conector:
- Pin RPWM: una señal PWM en este pin hace que el actuador se extienda. El valor fija la velocidad.
- Pin LPWM: una señal PWM en este pin hace que el actuador se retraiga. El valor fija la velocidad.
- Pines R_EN y L_EN: las entradas de habilitación. Un nivel HIGH enciende cada mitad del controlador y un nivel LOW la apaga. El actuador solo se mueve cuando ambos están en HIGH.
- Pines R_IS y L_IS: salidas de medición de corriente. No las usamos en este tutorial.
- Pin VCC: la alimentación del pequeño chip lógico (un buffer 74HC244) del módulo. Necesita 5V. En el ESP32, conéctalo al pin VIN, que da 5V desde el cable USB.
- Pin GND: conéctalo a GND del ESP32.
Los bornes de tornillo:
- Bornes B+ y B-: la alimentación del actuador, de 5.5V a 27V. Aquí usamos un adaptador de 12V.
- Bornes M+ y M-: aquí van los dos cables del actuador lineal.
Las entradas de control funcionan con señales de 3.3V y 5V, así que el ESP32 puede manejarlas directamente. Tienen resistencias pull-down internas, así que no vuelven 5V a los pines del ESP32. El controlador puede dar hasta 43A durante poco tiempo, mucho más de lo que necesita un actuador de 12V.
Cómo controlar un actuador lineal
Aquí, el ESP32 envía sus órdenes a un módulo BTS7960, y el módulo alimenta el actuador.
Diagrama de cableado
El ESP32 recibe su energía del cable USB. El actuador recibe su energía del adaptador de 12V, a través de los bornes B+ y B-.

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.
| Módulo BTS7960 | ESP32 / Otro |
|---|---|
| RPWM | → GPIO16 |
| LPWM | → GPIO17 |
| R_EN | → GPIO19 |
| L_EN | → GPIO18 |
| VCC | → VIN (5V) |
| GND | → GND |
| R_IS, L_IS | sin conectar |
| B+, B- | → + y - del adaptador de 12V (a través del conector de alimentación DC) |
| M+, M- | → los dos cables del actuador lineal |
Cómo hacer que un actuador lineal se extienda o se retraiga
Primero, el ESP32 pone R_EN y L_EN en HIGH, así el controlador queda encendido. Luego los dos pines PWM eligen la dirección. La tabla a continuación muestra cómo funciona.
| Pin RPWM | Pin LPWM | Dirección |
|---|---|---|
| 0 | 0 | El actuador lineal se detiene |
| 255 (HIGH) | 0 | El actuador lineal se extiende |
| 0 | 255 (HIGH) | El actuador lineal se retrae |
Uno de RPWM y LPWM siempre queda en 0, así los dos pines nunca reciben PWM al mismo tiempo.
- Extender el actuador lineal
- Retraer el actuador lineal
※ Nota:
La dirección de movimiento se invierte si los bornes M+ y M- se conectan a los dos pines del actuador lineal al revés. Para corregirlo, intercambia los dos cables en M+ y M-. Intercambiar los valores de RPWM y LPWM en tu código también funciona.
Cómo evitar que el actuador lineal se extienda o se retraiga
El actuador lineal deja de extenderse o retraerse automáticamente cuando alcanza el límite. También podemos detenerlo desde el programa mientras no haya alcanzado el límite.
Hay dos maneras de detener un actuador lineal
- Frenar: deja R_EN y L_EN en HIGH y baja RPWM y LPWM a 0. El actuador se detiene de inmediato.
- Desactivar ambos medios puentes con LOW en R_EN y L_EN. Las salidas se apagan y el actuador se detiene.
Cómo controlar la velocidad del actuador lineal mediante el controlador BTS7960
Para cambiar la velocidad, usa un valor menor que 255 en el pin PWM activo. Creamos la señal PWM con la función analogWrite(). El BTS7960 repite esta señal débil a 12V, con mucha corriente para el actuador.
La velocidad es un valor entre 0 y 255. Si la velocidad es 0, el actuador lineal se detiene. Si la velocidad es 255, el actuador lineal se extiende o se retrae a la velocidad máxima.
Código de ejemplo para ESP32
Lo que hace el código a continuación:
- Extender el actuador a la velocidad máxima
- Detener el actuador lineal
- Retraer el actuador a la velocidad máxima
- Detener el actuador lineal
Pasos R\u00e1pidos
- Realiza el cableado como en la imagen de arriba. Conecta el adaptador de 12V al final.
- Copia el código anterior y pégalo en el IDE de Arduino
- Compila y sube el código a la placa ESP32 haciendo clic en el botón Upload en el IDE de Arduino
- Verás:
- El actuador lineal se extiende y luego se detiene al alcanzar el límite
- El actuador lineal mantiene la posición durante un tiempo
- El actuador lineal se retrae y luego se detiene al alcanzar el límite
- El actuador lineal mantiene la posición durante un tiempo
- El proceso anterior se repite una y otra vez.
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.