
Leer un sensor de luz y enviar los datos a ThingSpeak con la Heltec ESP32 WiFi Kit 32 V3
En los tutoriales anteriores aprendimos a comprobar el funcionamiento de la pantalla OLED integrada, conectar la Heltec ESP32 a una red WiFi y enviar un valor de prueba a ThingSpeak.
En esta ocasión vamos a sustituir ese número por un dato real procedente de un sensor de luz analógico Keyestudio, construyendo así nuestro primer proyecto IoT completamente funcional.
Material necesario
- Heltec ESP32 WiFi Kit 32 V3
- Sensor de luz Keyestudio de 3 pines
- Protoboard
- Tres cables Dupont
- Arduino IDE
- Librería oficial Heltec ESP32 Dev-Boards
- Librería oficial ThingSpeak de MathWorks
Conexión del sensor
La conexión es muy sencilla.
| Sensor Keyestudio | Heltec ESP32 |
|---|---|
| S | GPIO2 |
| + | 3V3 |
| − | GND |
Utilizamos el GPIO2 como entrada analógica para leer el nivel de iluminación.
Funcionamiento del programa
El programa realiza las siguientes operaciones:
- Inicializa la pantalla OLED.
- Conecta la placa a la red WiFi.
- Inicializa la comunicación con ThingSpeak.
- Lee continuamente el sensor mediante
analogRead(). - Muestra el valor en el Monitor Serie.
- Envía el dato al Field 1 del canal de ThingSpeak.
- Presenta la lectura y una barra de progreso en la pantalla OLED.
- Espera veinte segundos antes del siguiente envío, respetando las limitaciones de la versión gratuita de ThingSpeak.
Código
Lectura del sensor
La lectura del sensor se realiza con una única instrucción:
int luz = analogRead(sensorLuz);
En el ESP32 el conversor analógico-digital proporciona valores comprendidos entre:
- 0 → mínima iluminación.
- 4095 → máxima iluminación.
Estos valores pueden variar ligeramente según el módulo utilizado y las condiciones de iluminación.
Envío a ThingSpeak
La librería oficial simplifica enormemente el proceso de envío.
Basta con utilizar:
ThingSpeak.writeField(channelID, 1, luz, writeAPIKey);
La función devuelve un código de estado.
Si devuelve 200, el dato se ha almacenado correctamente en el canal.
Visualización en la pantalla OLED
Además del Monitor Serie, el programa muestra:
- Confirmación del envío.
- Nivel de luz leído.
- Barra gráfica proporcional a la iluminación.
Esta representación visual facilita mucho la comprensión del funcionamiento del sensor y resulta especialmente útil durante las prácticas de laboratorio.
¿Por qué utilizar primero un sensor sencillo?
En esta serie seguimos siempre la misma metodología:
- Comprobar que el hardware funciona.
- Leer correctamente el sensor.
- Mostrar el resultado.
- Enviarlo a Internet.
- Analizar los datos.
Esta forma de trabajar permite detectar los errores mucho más fácilmente y construir proyectos cada vez más complejos sobre una base sólida.
Próximo tutorial
En el siguiente capítulo utilizaremos los datos almacenados en ThingSpeak para construir un pequeño sistema de monitorización ambiental y continuaremos incorporando nuevos sensores a la Heltec ESP32 WiFi Kit 32 V3.



