lunes, 19 de octubre de 2026

Tutorial: Obtener Credenciales y Configurar Adafruit IO


Tutorial: Obtener Credenciales y Configurar Adafruit IO
Aquí tienes un tutorial paso a paso para navegar en la plataforma de Adafruit IO y extraer exactamente los 4 datos necesarios (Username, AIO Key, Feed y Dashboard) para configurar tu ESP32. 
Paso 1: Crear una Cuenta e Iniciar Sesión
  1. Entra al sitio oficial: adafruit.com.
  2. Haz clic en Sign Up (si no tienes cuenta) o en Sign In (si ya estás registrado).
  3. Llena los datos básicos. La cuenta gratuita (Free Plan) es perfectamente funcional para este proyecto.

Paso 2: Obtener tu Username y AIO Key
Estos datos equivalen a tu "usuario y contraseña" para que la ESP32 pueda iniciar sesión en el servidor MQTT de Adafruit.
  1. Una vez dentro de tu panel principal, dirige tu mirada a la barra superior derecha.
  2. Haz clic en el botón amarillo con un icono de llave que dice "My Key".
  3. Se abrirá una ventana emergente (pop-up) con dos campos de texto:
    • Username: Este es tu nombre de usuario único.
    • Active Key: Es una cadena larga de letras y números generada aleatoriamente.
  4. Haz clic en el botón Copy al lado de cada uno para guardarlos en tu bloc de notas. ¡Mantén tu Active Key en secreto!

Paso 3: Crear y obtener el Feed (Canal del Sensor)
El Feed es la base de datos o el "buzón" donde tu ESP32 va a depositar las lecturas del sensor.
  1. En el menú superior izquierdo de la pantalla, haz clic en la opción Feeds.
  2. Haz clic en el botón azul "+ New Feed".
  3. En la casilla Name, escribe el nombre para tu sensor (por ejemplo: Temperatura).
  4. Haz clic en Create.
  5. Ahora verás tu feed en la lista. Presta atención a la columna que dice Key:
    • Adafruit convierte automáticamente el nombre a minúsculas y reemplaza los espacios por guiones (ejemplo: si lo llamaste Sensor Uno, su clave será sensor-uno).
    • Este valor en minúsculas es tu Feed Key, el cual usarás en el código de Thonny para completar el tópico de publicación: tu_username/feeds/tu-feed-key.

Paso 4: Crear el Dashboard y la Gráfica
El Dashboard es la interfaz visual (la pantalla) donde acomodarás los gráficos y botones para interactuar desde la computadora o el celular.
  1. En el menú superior, haz clic en Dashboards.
  2. Haz clic en el botón azul "+ New Dashboard".
  3. Ponle un nombre descriptivo (por ejemplo: Control ESP32) y haz clic en Create.
  4. Haz clic sobre el nombre del Dashboard que acabas de crear para entrar en él. Verás un lienzo completamente negro o vacío.
  5. Haz clic en el botón "+" azul (Create New Block) en la barra de herramientas superior derecha.
  6. Se abrirá un catálogo de componentes visuales. Selecciona Line Chart (Gráfico de líneas).
  7. Aparecerá una lista con tus feeds. Marca la casilla de verificación al lado del feed que creaste en el Paso 3 (por ejemplo: Temperatura) y haz clic en Next Step.
  8. En esta última ventana puedes personalizar el gráfico: ponerle un título, definir los valores mínimos/máximos del eje Y, o cambiar el color de la línea.
  9. Haz clic en Create Block y ¡listo! Tu gráfica aparecerá en pantalla lista para recibir los datos de tu placa.

Resumen de lo que debes pegar en Thonny:
Al terminar este tutorial, deberías tener tus cuatro parámetros listos en tu script de MicroPython de la siguiente manera:
python
ADAFRUIT_USERNAME = "El_Username_del_Paso_2"
ADAFRUIT_AIO_KEY  = "La_Active_Key_del_Paso_2"
FEED_KEY          = "el-nombre-en-minusculas-del-Paso_3"

# Tu dirección final de publicación MQTT será:
MQTT_TOPIC = f"{ADAFRUIT_USERNAME}/feeds/{FEED_KEY}"
Usa el código con precaución.
¿Lograste visualizar la ventana emergente de "My Key" correctamente en la página web, o necesitas que preparemos el código definitivo para enlazar la rampa y el triángulo que mencionaste antes a dos feeds distintos?

No hay comentarios:

Publicar un comentario