HowTo: ESPEasy - Conectar el sensor de gestos APDS-9960 al ESP8266 / ESP32 y leerlo

El APDS-9960 es un sensor que se puede conectar a un microcontrolador como el ESP8266 a través del bus I2C.

Con la ayuda del sensor es posible reconocer gestos simples, medir el brillo, la distancia de un objeto al sensor y el color de la luz que incide en el sensor.

La integración en ESPEasy es bastante fácil gracias al complemento apropiado.

Los pasos necesarios para integrar el APDS-9960 en su instancia de ESPEasy se describen en el siguiente artículo.

Instrucciones de seguridad

Sé que las siguientes notas siempre son un poco molestas y parecen innecesarias. Desafortunadamente, muchas personas que sabían "mejor" han perdido ojos, dedos u otras cosas debido a un descuido o se lesionaron. La pérdida de datos es casi insignificante en comparación, pero incluso estos pueden ser realmente molestos. Por lo tanto, tómese cinco minutos para leer las instrucciones de seguridad. Porque incluso el proyecto más genial no vale la pena lesionarse u otros problemas.
https://www.nerdiy.de/sicherheitshinweise/

Enlaces afiliados / enlaces publicitarios

Los enlaces a las tiendas en línea enumerados aquí son los llamados enlaces de afiliados. Si hace clic en dicho enlace de afiliado y realiza una compra a través de este enlace, Nerdiy.de recibirá una comisión de la tienda en línea o el proveedor correspondiente. El precio no cambia para usted. Si realiza sus compras a través de estos enlaces, ayuda a Nerdiy.de a poder ofrecer otros proyectos útiles en el futuro. 🙂 

Requisitos

Artículos útiles:
Puede encontrar consejos adicionales sobre ESPEasy en los siguientes artículos.

• ESPEasy: ejecuta comandos y acciones a través de HTTP, MQTT, UDP y directamente
• ESPEasy: compila y actualiza el firmware y configura los datos de acceso WiFi
• ESPEasy / Wemos D1 Mini: ajuste el ADC a un voltaje máximo diferente

Herramienta requerida:

Material requerido:

Conecte el APDS-9960 al ESP8266

El APDS-9960 está conectado al ESP8266 o Wemos D1 Mini a través del bus I2C.

Si el bus I2C está configurado de manera predeterminada, puede usar el diagrama de circuito que se muestra como guía.

Configuración del APDS-9960 en ESPEasy

Para que el APDS-9960 pueda configurarse en ESPEasy, el firmware ESPEasy ya debe estar instalado y accesible en el ESP8266 o ESP32. También puede encontrar información al respecto en el artículo ESPEasy: compila y actualiza el firmware y configura los datos de acceso WiFi.

Primero abra el sitio web de configuración de su ESP8266 programado con ESPEasy ingresando su dirección IP en su navegador web. La información sobre cómo averiguar la dirección IP también se encuentra en el artículo. Mostrar/averiguar la dirección IP de los dispositivos en la red resumido.

En cuanto haya abierto el sitio web de configuración, debe pasar a la pestaña "Dispositivos". Para ello, haz clic en el botón "Dispositivos".

En la pestaña "Dispositivos", pulse el botón "Añadir" en una de las filas vacías.

A continuación, será redirigido automáticamente a la vista mostrada y...

...puedes elegir aquí qué dispositivo quieres crear.

Seleccione la entrada aquí

• Gesto – APDS9960 [DESARROLLO]

fuera de.

Si la entrada que está buscando no está visible, el complemento no está incluido en su instalación de ESPEasy. Un binario precompilado que también contiene este complemento se puede encontrar en el siguiente enlace.

• https://github.com/Nerdiyde/pxlBlck/tree/main/plugin/bin

Esto le llevará de vuelta a una página de resumen.

Aquí puede realizar todos los ajustes relacionados con el APDS-9960.

Si ha utilizado el diagrama de circuito que se muestra arriba, puede aceptar los ajustes que se muestran.

Es importante que marques "Forzar velocidad lenta I2C".

También hay que configurar en el apartado “Modo Plugin” si el sensor debe medir gestos, valores de proximidad y brillo o los valores de color RGB de la luz incidente.

Para la medición de color RGB, el APDS-9960 debe configurarse como se muestra a la izquierda.

Por otro lado, para medir los valores de proximidad y brillo del gesto, el APDS-9960 debe configurarse como se muestra aquí.

Vista de ajustes adicionales en el modo de medición de gestos, proximidad y brillo.

Para aplicar la configuración, haga clic en "Enviar".

Vista de los ajustes adicionales en el modo de medición de color RGB

Para aplicar la configuración, haga clic en "Enviar".

Mostrar valores medidos del APDS-9960

Una vez que haya configurado el APDS-9960, puede probarlo directamente.

En la vista general de los dispositivos configurados, los valores medidos se pueden ver en la línea del APDS-9960 en el lado derecho.

Estos se actualizan al menos cada 60 segundos. Este intervalo se puede configurar en la configuración del APDS-9960 en el apartado “Intervalo”.

Si configuró previamente el APDS-9960 para medir valores de color RGB, la vista se verá como la que se muestra a la izquierda.

Use el valor de brillo del APDS-9960 usando reglas

Si usa el APDS-9960 en el modo para medir los valores de gesto, proximidad y brillo, también puede usar el valor de brillo medido, por ejemplo, para ajustar automáticamente el brillo de una lámpara al brillo ambiental. Esto también es útil para ajustar el brillo de la pantalla, ya que la pantalla no se muestra demasiado brillante en entornos oscuros ni demasiado oscura en entornos brillantes.

Un ejemplo del uso automático del valor de brillo medido por el APDS-9960 se puede encontrar en las siguientes reglas. El ejemplo mostrado significa que el brillo de los LED que de Complemento pxlBlck controlado se ajusta automáticamente a la luminosidad ambiental.

En gesto#Light haz pbbr,0,[gesture#Light],1,1,15, endon

Enviar datos del sensor a través de MQTT

Ahora también puede enviar los datos del sensor recopilados a su SmartHome a través de MQTT y procesarlos allí si es necesario. Lo que tienes que configurar para esto se describe en el siguiente artículo.

• ESPEasy: configure el servidor MQTT en el ESP8266 y suscríbase a los temas

Más sensores para conectar al ESP8266 / ESP32

Puede encontrar una descripción general de otros elementos para conectar sensores y actuadores a ESPEasy en la siguiente categoría.

• ESPEasy: sensores y actuadores

Diviértete con el proyecto.

Espero que todo te haya funcionado como se describe. Si no es así, o si tiene alguna pregunta o sugerencia, hágamelo saber en los comentarios. Si es necesario, lo añadiré al artículo.
Las ideas para nuevos proyectos siempre son bienvenidas. 🙂

PS Muchos de estos proyectos, especialmente los proyectos de hardware, cuestan mucho tiempo y dinero. Por supuesto que hago esto porque lo disfruto, pero si crees que es genial que comparta la información contigo, me encantaría hacer una pequeña donación al fondo del café. 🙂