Inicio rápido

Este capítulo le ayuda a completar la primera experiencia con la edición open source de FastBee en 15 minutos. Una vez finalizado el despliegue, siga los pasos siguientes para crear su primer producto IoT e integrar un dispositivo en 5 minutos.

Guía de la página

Contenido de la páginaFlujo principal de la sección de inicio rápido: la ruta completa de la primera experiencia, desde el inicio de sesión en la plataforma, la creación del producto y la definición del Thing Model hasta la verificación de la integración MQTT.

Escenarios de usoAdecuada para quienes utilizan la plataforma por primera vez tras el despliegue: siga los pasos para crear un producto, definir el Thing Model, añadir un dispositivo y completar la prueba de conexión MQTT.

Requisitos previosInstalación y despliegue completados, acceso normal a la consola web y un cliente MQTT (como MQTTX) preparado.

Criterios de aceptaciónLa plataforma muestra el estado en línea del dispositivo, el dispositivo puede reportar datos de propiedades y recibir los comandos enviados por la plataforma.

1. Iniciar sesión en la plataforma

Acceda desde el navegador a http://IP-del-servidor e inicie sesión con la cuenta predeterminada:

• Nombre de usuario: admin
• Contraseña: admin123

2. Crear un producto

1. Vaya a IoT > Gestión de productos
2. Haga clic en el botón Añadir
3. Rellene la información del producto:
   • Nombre del producto: por ejemplo, «Sensor de temperatura y humedad»
   • Clasificación del producto: seleccione o cree una clasificación
   • Tipo de dispositivo: seleccione «Dispositivo de conexión directa»
   • Método de autenticación: seleccione «Autenticación simple (una clave por dispositivo)»
4. Haga clic en Aceptar para guardar

3. Definir el Thing Model

En la página de detalles del producto, haga clic en la pestaña Thing Model.

1. Añada una propiedad: por ejemplo, «Temperatura» (tipo de dato: float, unidad: ℃)
2. Añada una propiedad: por ejemplo, «Humedad» (tipo de dato: float, unidad: %RH)
3. Añada una función (opcional): por ejemplo, «Interruptor» (tipo de dato: bool)
4. Haga clic en Publicar para activar el Thing Model

4. Añadir un dispositivo

1. Vaya a IoT > Gestión de dispositivos
2. Haga clic en el botón Añadir
3. Seleccione el producto que acaba de crear
4. Introduzca el nombre del dispositivo (por ejemplo, «sensor-001»)
5. El sistema genera automáticamente el número de dispositivo y la clave de autenticación; anote esta información

5. Prueba de conexión MQTT

Utilice cualquier cliente MQTT (como MQTTX o MQTT.fx) para conectarse a la plataforma:

Parámetro	Valor
Dirección del servidor	La IP de su servidor
Puerto	1883 (TCP)
Client ID	S&deviceNumber&productId&userId
Nombre de usuario	Cuenta MQTT
Contraseña	Contraseña MQTT

Reportar datos de propiedades

Envíe datos JSON al siguiente topic:

Topic: /{productId}/{deviceNumber}/property/post

[{
  "id": "temperature",
  "value": "25.6",
  "remark": ""
}, {
  "id": "humidity",
  "value": "60.2",
  "remark": ""
}]

Tras la publicación, consulte los datos en tiempo real en Datos del Thing Model, dentro de la página de detalles del dispositivo.

6. Consultar los datos

• Datos en tiempo real: Detalles del dispositivo > Datos del Thing Model
• Registros del dispositivo: Detalles del dispositivo > Registros del dispositivo
• Estado en línea: compruebe en la lista de dispositivos si el dispositivo está en línea

Pasos siguientes

• Aprenda la integración MQTT en detalle
• Configure Scene Linkage (简体中文)
• Escriba scripts de reglas (简体中文)

Preguntas frecuentes

¿Cuál es la relación entre el inicio rápido y la instalación y despliegue?

La instalación y el despliegue son el requisito previo: sirven para poner la plataforma en marcha. El inicio rápido es la guía del primer uso después del despliegue y cubre el camino más corto desde la creación del producto hasta la integración del dispositivo.

¿Cuál es la cuenta de inicio de sesión predeterminada de la edición open source de FastBee?

El nombre de usuario predeterminado es admin y la contraseña es admin123. Una vez finalizado el despliegue, acceda desde el navegador a http://IP-del-servidor para iniciar sesión en la plataforma.

¿Cómo se rellenan los parámetros de conexión del cliente MQTT?

La dirección del servidor es la IP de su servidor, el puerto es 1883 (TCP), el formato del Client ID es S&deviceNumber&productId&userId, y el nombre de usuario y la contraseña son la cuenta MQTT y la contraseña MQTT, respectivamente.

¿Qué topic se utiliza para que el dispositivo reporte datos de propiedades?

Envíe los datos en formato de array JSON al topic /{productId}/{deviceNumber}/property/post; tras la publicación podrá consultar los datos en tiempo real en los datos del Thing Model de la página de detalles del dispositivo.

¿Cómo confirmar que la integración del dispositivo se ha realizado correctamente?

Tome como referencia tres criterios de aceptación: el dispositivo aparece en línea en la lista de dispositivos, los datos en tiempo real reportados pueden consultarse en Detalles del dispositivo > Datos del Thing Model, y el dispositivo recibe con normalidad los comandos enviados por la plataforma.

Lecturas relacionadas

• Instalación y despliegue (简体中文): guía completa del despliegue con Docker en un solo comando y del despliegue tradicional del sistema
• Integración MQTT: explicación detallada de los parámetros de conexión, la publicación de mensajes y la verificación del ciclo completo en el lado de la plataforma
• Preguntas frecuentes sobre la integración de dispositivos (简体中文): resolución de problemas de activación en línea, aprovisionamiento de red y almacenamiento de datos de dispositivos