Gestión de productos
Guía de la página
Entrada de uso y flujo recomendado
- Entre en Gestión de dispositivos → Gestión de productos y confirme primero la clasificación del producto, el tipo de dispositivo, el protocolo de transmisión, el protocolo de comunicación y el método de autenticación.
- Tras añadir el producto, entre en los detalles del producto y configure, según las capacidades del dispositivo, el Thing Model, Modbus, SIP, los subproductos, la configuración de la aplicación o la aplicación SCADA.
- Una vez completada la configuración, publique el producto y, a continuación, añada o importe dispositivos en la gestión de dispositivos.
- Cuando el dispositivo esté en línea, vuelva a las páginas del producto y del Thing Model para comprobar que los datos, los comandos, los eventos, las reglas y las alarmas se coordinan con normalidad.
1. Presentación de la gestión de productos
Un producto es un conjunto de dispositivos y suele ser la descripción de dispositivos físicos del mismo tipo y modelo. En este documento puede conocer las funciones relacionadas con los productos.
1.1. Panorama general
Un producto permite gestionar de forma unificada el protocolo de transmisión, el protocolo de comunicación, el Thing Model y la configuración Modbus de dispositivos idénticos en masa; los dispositivos iguales pertenecen al mismo producto, lo que posibilita su gestión unificada. Sobre la base del producto también se pueden configurar Scene Linkage, pantallas SCADA, etc.
1.2. Opciones de configuración del producto
| Opción de configuración | Descripción |
|---|---|
| Nombre del producto | Obligatorio, nombre del producto, personalizable |
| Clasificación del producto | Obligatorio, lista desplegable de selección única; se configura en el menú de clasificación de productos y varios productos pueden agruparse en una misma clasificación |
| Tipo de dispositivo | Obligatorio, lista desplegable de selección única; para videovigilancia seleccione directamente dispositivo de videovigilancia; para los demás tipos de dispositivo consulte la documentación de gateways y subdispositivos (简体中文) |
| Protocolo de comunicación | Obligatorio, lista desplegable de selección única; corresponde a la codificación y decodificación de los datos reportados por el dispositivo, debe elegirse el adecuado; los protocolos existentes pueden consultarse en el menú de gestión de protocolos |
| Protocolo de transmisión | Obligatorio, lista desplegable de selección única; es la forma en que el dispositivo se conecta a la plataforma IoT, debe elegirse el adecuado |
| Tipo de firmware | Obligatorio, lista desplegable de selección única; elija el adecuado, consulte la documentación de actualización OTA de dispositivos (简体中文) |
| Modo de conexión a la red | Opcional, lista desplegable de selección única; es simplemente una etiqueta, elija según el modo de conexión a la red del dispositivo |
| Producto privado | Interruptor; cuando se establece como privado, los niveles inferiores no pueden verlo |
| Autorización de dispositivos | Interruptor; función de autorización de dispositivos, deshabilitada por defecto; cuando el producto habilita el código de autorización de dispositivos, es necesario asignar un código de autorización a cada dispositivo, que se utiliza durante la autenticación |
| Método de autenticación | Obligatorio; método de autenticación para la integración de dispositivos, lista desplegable de selección única; puede consultar la documentación de integración de dispositivos con distintos protocolos en la sección de integración de dispositivos |
| Método de localización | Obligatorio, lista desplegable de selección única Localización automática: durante la autenticación del dispositivo, la plataforma obtiene automáticamente su ubicación; Localización del dispositivo: el dispositivo reporta activamente la información de longitud y latitud a través del topic /info/post; Ubicación personalizada: se configura manualmente la información de longitud y latitud en los detalles del dispositivo |
| Número de producto | Generado automáticamente por el sistema |
| Cuenta de autenticación | Obligatorio; el sistema la genera automáticamente al añadir y puede modificarse |
| Contraseña de autenticación | Obligatorio; el sistema la genera automáticamente al añadir y puede modificarse |
| Clave de autenticación | Obligatorio; el sistema la genera automáticamente al añadir y puede modificarse |
| Imagen del producto | Opcional, puede modificarse |
| Observaciones | Campo de entrada no obligatorio |
1.3. Lista de productos
1.3.1. Añadir
Haga clic en el botón "+ Añadir" para abrir la ventana de nuevo producto; tras hacer clic en Aceptar, podrá ver que el producto ya existe en la lista
提示
Nota: si el tipo de dispositivo del producto se selecciona como dispositivo gateway y el protocolo de comunicación se selecciona como ModbusRtu, protocolo de análisis Modbus a Json - Huapu Wulian, ModbusTcp o protocolo de análisis de gateway JSON, aparecerá un botón de configuración de subproductos; al seleccionarlo podrá importar subproductos directamente. El método de configuración concreto se describe en la documentación de gateways y subdispositivos (简体中文)
1.3.2. Copiar
Haga clic en el botón "Copiar" para abrir la ventana de selección de producto, elija el producto correspondiente y haga clic en Aceptar para copiar un producto completamente idéntico 
1.3.3. Importar
Haga clic en el botón "Importar" para abrir la ventana de importación de productos; primero descargue el archivo de plantilla json, después edítelo, luego haga clic en Subir archivo y, por último, haga clic en Aceptar para completar la importación
1.3.4. Mostrar los productos de la organización superior
Al marcarla se mostrarán los productos de la organización superior, pero no se pueden editar
1.4. Detalles del producto
La página de detalles del producto incluye información básica, modelo del producto, configuración Modbus, autorización de dispositivos, aplicación SCADA, configuración de la aplicación, etc.
提示
Nota: salvo los subproductos, las tareas de sondeo y la configuración de la aplicación, el resto de funciones requieren primero cancelar la publicación del producto para poder editarse
1.4.1. Información básica
Permite modificar parte de la información básica
1.4.2. Modelo del producto
El Thing Model es la descripción del dispositivo en la nube y define un dispositivo real desde las cuatro dimensiones de propiedades, funciones, eventos y etiquetas
- Importar archivo de modelo: al hacer clic se entra en la ventana de importación masiva; primero descargue el archivo de plantilla de importación del Thing Model del producto, edítelo, haga clic en Subir archivo y, por último, en Aceptar para importarlo
- Importar Thing Model general: al hacer clic se entra en la ventana de importación de Thing Models generales; elija el Thing Model general adecuado y, por último, haga clic en Importar
- Ver el modelo: al hacer clic se entra en la ventana del Thing Model, donde puede consultar la estructura de datos completa del Thing Model
1.4.3. Configuración de la aplicación
La interfaz del modo de estado del terminal móvil admite personalización: puede configurarla en la configuración de la aplicación del producto, personalizar la interfaz según sus necesidades en la pantalla de configuración y, una vez lista, hacer clic en Habilitar
1.4.4. Autorización de dispositivos
Función opcional; una vez habilitada, se utiliza principalmente para la autenticación de dispositivos y requiere asignar un código de autorización a cada dispositivo
1.4.5. Configuración SIP
Opciones de configuración del protocolo SIP, correspondientes al protocolo estándar nacional GB28181 (estándar nacional del sistema de interconexión de videovigilancia de seguridad pública); su función principal es permitir que el producto (normalmente un dispositivo de vídeo, como una cámara) se integre mediante el protocolo SIP en la plataforma de videovigilancia GB28181, logrando funciones como el registro de dispositivos, la transmisión de flujos de vídeo y el control de dispositivos
1.4.6. Subproductos
Para el tipo de dispositivo gateway, algunos protocolos de comunicación admiten la configuración de subproductos
- Añadir: al hacer clic se entra en la ventana de selección de producto; elija el subproducto correspondiente y, por último, haga clic en Aceptar para vincularlo
- Establecer dirección: al hacer clic podrá editar la dirección de subdispositivo predeterminada del subproducto, que no puede repetirse;
1.4.7. Configuración Modbus
Debe configurarse cuando el protocolo del producto es un protocolo relacionado con Modbus; se trata de la configuración de las propiedades del propio gateway o de los subdispositivos del gateway en dispositivos Modbus. El método de configuración concreto se describe en la documentación de gateways y subdispositivos (简体中文)
1.4.8. Tareas de sondeo
Los protocolos relacionados con Modbus requieren configurar tareas de sondeo para recoger datos de forma activa; en la configuración Modbus del producto - configuración de gateway/subdispositivo - método de recogida debe marcarse sondeo desde la nube, y los nuevos dispositivos lo heredarán
1.4.9. Envío de comandos
Cuando el protocolo de comunicación del producto seleccionado es ModbusTcp, se configuran una serie de comandos que los nuevos dispositivos heredan y que pueden enviarse desde el lado del dispositivo
1.4.10. Aplicación SCADA
Diseño de una pantalla SCADA para el producto; todos los dispositivos de ese producto pueden ver dicha pantalla SCADA y mostrar en tiempo real los datos reportados por el dispositivo o realizar el envío de comandos
1.5. Publicar el producto
Los productos nuevos están por defecto en estado no publicado; tras completar la definición del producto según los detalles del producto, haga clic en el botón "Publicar producto" para habilitarlo y, a partir de entonces, podrá crear los dispositivos correspondientes a ese producto
提示
Nota: si el producto está en estado no publicado, la autenticación de los dispositivos fallará
1.6. Multiinquilino
Aislamiento de inquilinos: la organización superior puede usar y editar los productos de las organizaciones inferiores; las organizaciones inferiores pueden ver y usar, pero no editar, los productos de la organización superior;
1.7. Tabla de decisiones de configuración
Las opciones en las que más se suele errar al crear un producto son el tipo de dispositivo, el protocolo de comunicación, el protocolo de transmisión y el método de autenticación. Se recomienda determinarlas primero con la tabla siguiente y crear el producto después.
| Escenario | Tipo de dispositivo | Protocolo de transmisión | Protocolo de comunicación | Descripción |
|---|---|---|---|---|
| Sensor MQTT normal | Dispositivo de conexión directa | MQTT | Análisis JSON o protocolo personalizado | El método de integración más común, adecuado para empezar rápidamente |
| Dispositivo que reporta activamente por HTTP | Dispositivo de conexión directa | HTTP | Análisis JSON o protocolo personalizado | Adecuado para dispositivos con reporte de baja frecuencia y capacidad HTTP ya disponible |
| Dispositivo con protocolo privado TCP | Dispositivo de conexión directa | TCP | Protocolo personalizado | Requiere adaptación de codificación y decodificación en el lado del servidor |
| Gateway Modbus RTU | Dispositivo gateway | Según el enlace in situ | ModbusRtu o protocolo de gateway | Requiere configurar subproductos, registros y tareas de sondeo |
| Dispositivo Modbus TCP | Dispositivo de conexión directa o gateway | Modbus TCP | Protocolo ModbusTcp | Es necesario definir si el dispositivo actúa como cliente o como servidor |
| Cámara GB28181 | Dispositivo de videovigilancia | SIP/GB28181 | Protocolo SIP/vídeo | Requiere configurar SIP y el servicio de streaming |
| Terminal de localización de vehículos | Dispositivo de conexión directa | TCP/JT808 | Protocolo JT808 | Es necesario planificar el mapeo entre el número de teléfono del terminal y el número de dispositivo |
Lista de verificación previa a la publicación
Antes de publicar el producto se recomienda comprobar punto por punto:
| Elemento de comprobación | Estado normal |
|---|---|
| Información básica del producto | Nombre del producto, clasificación, tipo de dispositivo, protocolos y método de autenticación confirmados |
| Thing Model | Identificadores de propiedades, funciones y eventos únicos, tipos de datos correctos |
| Información de autenticación | Cuentas, contraseñas y claves MQTT/HTTP/TCP generadas |
| Autorización de dispositivos | Si la autorización está habilitada, el método de asignación de códigos de autorización está preparado |
| Configuración Modbus | Registros, direcciones de esclavo, códigos de función y tareas de sondeo confirmados |
| Subproductos | El producto gateway tiene vinculados los subproductos que debe gestionar |
| Configuración SIP | El producto de vídeo tiene configurada la información SIP y el servicio de streaming |
| Configuración de la aplicación | El modo de estado del terminal móvil o la aplicación SCADA se han habilitado según las necesidades |
| Estado de publicación | El estado final del producto es «publicado» |
Preguntas frecuentes
Fallo al publicar el producto
Compruebe si los campos obligatorios están completos, si los identificadores del Thing Model están duplicados y si falta alguna configuración de protocolo. Algunas configuraciones solo pueden modificarse tras cancelar la publicación.
Fallo de autenticación del dispositivo
Compruebe prioritariamente si el producto está publicado y si el ID de producto, el número de dispositivo, la cuenta de autenticación y la contraseña de autenticación que utiliza el lado del dispositivo coinciden con el producto actual.
La página no muestra datos tras el reporte del dispositivo
Compruebe si los identificadores del Thing Model coinciden exactamente con el id del mensaje reportado, si los tipos de datos coinciden y si el producto se publicó antes de crear el dispositivo.
Las organizaciones inferiores no ven el producto
Compruebe si el producto es un producto privado, los permisos de datos de la organización, los permisos del rol actual y si está marcada la opción de mostrar los productos de la organización superior.
Entradas para el desarrollo de extensiones
| Tipo | Ruta o interfaz | Descripción |
|---|---|---|
| Página Vue3 | vue3/src/views/iot/product | Lista de productos, detalles del producto, modelo del producto y configuración de la aplicación |
| API Vue3 | vue3/src/api/iot | Encapsulación de las interfaces de productos, modelos, protocolos, etc. |
| Interfaz backend | /iot/product | Interfaz de gestión de productos |
| Interfaz backend | /iot/model | Interfaz del Thing Model del producto |
| Interfaz backend | /iot/protocol | Interfaz de gestión de protocolos |
| Módulo de protocolos | springboot/fastbee-protocol | Codificación y decodificación de protocolos de dispositivos |
| Módulo de negocio | springboot/fastbee-open-api | Controllers relacionados con productos |
| Scripts SQL | springboot/sql | Estructuras de tablas y scripts de actualización relacionados con productos, Thing Models y protocolos |