Escriba su propia integración de dispositivos Modbus para SmartgridOne. Una guía práctica para crear drivers, con un vídeo, mapeo de mediciones, lógica de control y pruebas.
Esta guía está dirigida a instaladores e integradores que desean escribir su propia integración de dispositivos a partir del mapa de registros Modbus de un fabricante. Abarca la creación de un driver, el mapeo de mediciones, la implementación de comandos de control y la validación del resultado.
almacenada en la batería, esperando para usarse. El beneficio solo aparece en un día drivers Modbus personalizados módulo, puede integrar usted mismo un dispositivo Modbus con SmartgridOne, sin necesidad de que un programador de Eniris cree la integración. En la interfaz de puesta en marcha de un controlador, describa cómo reconocer el dispositivo, leer sus mediciones y controlarlo. Esta guía utiliza un ejemplo práctico: el inversor híbrido Playground integrado.
Vea el tutorial completo anterior: aproximadamente 30 minutos, con narración en neerlandés y capítulos. Sigue la interfaz de puesta en marcha desde la creación de un driver hasta su prueba, guardado y reutilización.
En SmartgridX, abra la vista de SmartgridOne, desplácese hacia abajo y haga clic en Configuración, seleccione su controlador y abra Configuración del controlador. Consulte Acceder a la interfaz de puesta en marcha para consultar las instrucciones de acceso completas.
En la interfaz de puesta en marcha, seleccione Dispositivos → Custom Modbus drivers → Gestionar drivers personalizados.
Primero, compruebe si ya existe un driver adecuado. Para crear el suyo, obtenga el manual Modbus del fabricante o el mapa de registros del modelo y firmware exactos. Debe explicar las direcciones de los registros, los tipos de datos, las unidades, el escalado y las operaciones de lectura/escritura permitidas. Para el control, también necesita la secuencia requerida para activar el control externo, escribir consignas y volver al funcionamiento automático.
Necesitará los datos de conexión del dispositivo: una dirección IP, un puerto TCP y una dirección Modbus, o el puerto RS485 del controlador y la configuración serie del dispositivo. Playground le permite aprender el proceso antes de conectar equipos físicos.
Haga clic en Nuevo driver, asígnele un nombre reconocible, seleccione la marca y elija el ejemplo inversor híbrido Playground. Esto proporciona un driver operativo que puede explorar. También puede empezar con un tipo de dispositivo compatible vacío al crear su propia integración.
Abra Prueba, seleccione inversor híbrido PlaygroundSeñales de Control RemotoConexión en la que realizar la prueba y haga clic en Conectar. Compruebe Reconocimiento, y después examine las mediciones y la instalación simulada. Lista de registros abre el mapa de registros del ejemplo junto al editor.
Playground simula un inversor trifásico de 10 kW con 8 kW de FV, una batería de 10 kWh, un contador de red y una salida de respaldo. La luz solar y las cargas cambian para que pueda observar las mediciones y el comportamiento del control. Se trata de dispositivos simulados dentro del controlador; las direcciones y configuraciones del ejemplo son específicas de estos dispositivos.
El editor está organizado de la siguiente manera:
| Pestaña | Qué puede hacer aquí |
|---|---|
| Driver | Describa el driver, la documentación, los valores predeterminados de conexión y las preguntas para el instalador. |
| Estructura del dispositivo | Defina el dispositivo y sus componentes, mediciones, identificación y opciones de control. |
| Lógica de comandos | Convierta los comandos en las operaciones de registro requeridas por el dispositivo. |
| Prueba | Pruebe el driver actual y examine sus lecturas y comandos. |
| Live | Supervise los dispositivos que ya utilizan el driver. |
| Historial | Compare y recupere versiones guardadas. |
En Driver, introduzca la información del modelo compatible e indique qué documento de protocolo sigue el driver. Un nombre claro, la lista de modelos y la versión del documento ayudan a otro instalador a decidir si el driver coincide con su equipo.
Establezca los valores predeterminados de conexión del fabricante. Para Modbus TCP, distinga el puerto de red de la dirección Modbus, también denominada ID de unidad. Para RS485, la velocidad en baudios, la paridad, los bits de datos y los bits de parada deben coincidir con los del dispositivo. Los ajustes de búsqueda adicionales pueden ayudar a encontrar equipos configurados de otra manera, pero las combinaciones adicionales hacen que la búsqueda tarde más.
Entradas del usuario del driver permiten al instalador responder preguntas al añadir un dispositivo. Por ejemplo, Playground pregunta si el contador de red del inversor está conectado y si la batería puede cargarse desde la red. Utilice estas entradas cuando un driver deba admitir varias configuraciones de instalación.
En Estructura del dispositivo, cree los componentes que el dispositivo realmente expone. Un inversor híbrido puede contener un total FV, entradas MPPT, strings, un total de batería y baterías individuales. Añada un contador de red o una salida de respaldo cuando el dispositivo proporcione esas lecturas.
Seleccione un componente y asigne sus registros. Cada fila identifica qué se mide, la dirección, el tipo de registro, el tipo de datos, el factor de escala y la unidad. Para la potencia y la corriente, especifique también qué significa un valor positivo del registro. Coloque las mediciones de la batería en la batería y las mediciones FV en el componente FV correspondiente.
Empiece por el reconocimiento y por algunas mediciones que pueda comprobar. En el inversor de ejemplo, la tensión L1-N y la frecuencia establecen lecturas de reconocimiento plausibles. Después, añada la potencia, el estado de carga de la batería, los contadores de energía y otros valores útiles. Los componentes controlados necesitan sus mediciones de potencia correspondientes, ya sean directas o derivadas de lecturas adecuadas.
Mantenga la identificación y las características nominales separadas de las mediciones en tiempo real. El fabricante, el modelo, el número de serie y la potencia nominal describen el dispositivo; las mediciones muestran su funcionamiento actual. Asigne los valores de estado, como Running o Standby, por separado de los códigos o bits de alarma. Proporcione a las alarmas un texto claro y la gravedad adecuada para que el instalador pueda comprender el problema.
Elija la opción de control que coincida con los registros del protocolo del fabricante. Esto determina qué consignas y límites proporciona SmartgridOne a la lógica de comandos.
Playground utiliza Consigna de batería y límite FV. SmartgridOne puede solicitar una potencia de carga o descarga de la batería y limitar de forma independiente la producción FV. Otros dispositivos pueden admitir únicamente una consigna de batería, únicamente un límite FV, una consigna de CA del inversor o solo monitorización, sin control.
Una consigna solicita un objetivo; un límite especifica un máximo. Limitar la FV a 4 kW no produce 4 kW cuando no hay suficiente luz solar. Distinga también los terminales de CA del inversor del punto de conexión de la instalación a la red: un registro que controla uno no controla automáticamente el otro.
Configure el watchdog según el protocolo. Permite que el equipo vuelva a su propio funcionamiento si dejan de llegar comandos. El ejemplo de Playground escribe 300 segundos en el registro de cuenta atrás 1005 y repite los comandos cada 20 segundos. Otros dispositivos requieren un contador cambiante, valores alternos o la conmutación de un bit. El reinicio del watchdog y el ajuste de su tiempo de espera pueden estar en registros separados.
En Lógica de comandos, siga los cables grises continuos entre los puertos triangulares para ver el orden de las acciones. Los cables de puntos de colores entre los puertos redondos transportan valores. Estas dos conexiones explican tanto qué ocurre como qué valor se utiliza.
Playground muestra las siguientes conversiones:
| Acción | Implementación de ejemplo |
|---|---|
| Activar el control remoto | Escriba 1Problemas conocidos1000, un valor sin signo de 16 bits, mediante la función 6. |
| Escribir la consigna de la batería | Invierta el signo con Negar, y después escriba un valor con signo de 32 bits empezando en 1001, utilizando la función 16 para sus dos registros. |
| Escribir el límite FV | Convierta la potencia solicitada en un porcentaje de la capacidad FV de 8 kW del ejemplo y, después, escriba ese porcentaje en 1003. |
| Liberar el dispositivo | En Lógica de liberación, escriba 0x11000 para restaurar el autoconsumo automático. |
SmartgridOne utiliza una potencia positiva de batería para la carga. El dispositivo de ejemplo utiliza una potencia positiva para la descarga. Por tanto, una solicitud final de carga a +3,000 W se convierte en −3,000 en su registro. El ejemplo completo también limita los cambios a 2 kW por comando posterior, por lo que los valores intermedios pueden diferir mientras se aproxima a la potencia solicitada.
Para la FV, 4 kW divididos entre 8 kW dan un 50 %. Utilice la referencia correcta: la capacidad FV del ejemplo es de 8 kW, mientras que la potencia nominal de CA del inversor es de 10 kW. Un dispositivo real puede utilizar otra referencia o escala.
Compruebe la gestión de errores además del funcionamiento normal. Por ejemplo, si falla la activación del control remoto, puede no ser adecuado escribir después la consigna. La salida En caso de excepción puede gestionar una operación fallida; sin una continuación conectada, esa excepción detiene el comando. Finalice las rutas normales con Volver del comando.
El Prueba La pestaña ejecuta el driver que se muestra actualmente en el editor, incluidos los cambios no guardados. Empiece con Playground y, después, repita las comprobaciones en el equipo previsto.
En un dispositivo físico, los comandos de prueba y las escrituras manuales tienen efectos reales. Seleccione para la prueba un equipo que pueda controlarse. La interfaz también identifica las conexiones que no pueden utilizarse simultáneamente con un dispositivo instalado.
Para el diagnóstico, utilice lecturas manuales de registros y Tramas sin procesar. La función ilegal indica una operación no compatible; una dirección de datos ilegal indica un registro no válido o inaccesible; un valor de datos ilegal significa que no se acepta el valor solicitado. Compruébelos con el protocolo antes de cambiar el driver.
Resuelva los problemas de la lista y verifique los resultados de las pruebas; después, haga clic en Guardar. Se puede guardar un borrador con problemas bloqueantes, pero no se puede utilizar para añadir un dispositivo nuevo. Si está disponible, la última versión válida existente del driver continúa ejecutándose.
Añadir un dispositivo abre el asistente normal con este driver seleccionado. Utiliza la versión guardada, por lo que debe guardar primero. Elija la conexión real y responda a las preguntas del instalador. Después de añadir el dispositivo, vuelva a comprobar su reconocimiento, sus mediciones y su funcionamiento. Guardar la definición de un driver y añadir equipos a la instalación son pasos independientes.
Utilice Live para inspeccionar los dispositivos instalados, sus mediciones y los comandos más recientes. Los drivers que ya utilizan los dispositivos se abren en modo de solo lectura. Después de Desbloquear la edición, los cambios pueden afectar a esos dispositivos. Aplicar temporalmente la lógica de comandos a un dispositivo es diferente de Guardar, que actualiza el driver guardado utilizado por todos sus dispositivos. Siga los avisos del editor cuando un cambio estructural o de identificación requiera acciones adicionales.
Historial permite comparar versiones y fijar una instantánea con nombre. Volver a esta versión la restaura como cambios no guardados; guarde para continuar a partir de ella. Exportación descarga el driver guardado como JSON, excluyendo las modificaciones no guardadas. Utilice Importar un driver en otro controlador para reutilizarlo. Compruebe si está importando una copia independiente o sustituyendo un driver existente. Un driver que requiera un motor más reciente necesita un software de controlador compatible. La distribución desde Driver store es independiente del guardado en este controlador.
Utilice la dirección basada en cero transmitida por el bus. Si un manual utiliza la notación de registros de retención del tipo 40001, 40101 corresponde a la dirección 100; no reste esta base cuando el manual ya proporcione las direcciones del bus.
Haga coincidir el tipo de datos, el factor de escala, la unidad y el orden de palabras/bytes. Para un registro en pasos de 0.1 V, el valor bruto 2301 significa 230.1 V. Los valores con signo pueden ser negativos; los valores sin signo no. Configure Sin valor cuando únicamente para los códigos especiales documentados por el fabricante.
Las mediciones calculadas pueden sumar las potencias de las fases o multiplicar la tensión de CC por la corriente de CC. En CA, tensión multiplicada por corriente proporciona potencia aparente, no automáticamente potencia activa. Los bloques matemáticos y lógicos adaptan los comandos mediante conversiones, condiciones, límites o temporización. Las variables recuerdan los valores entre comandos; sus actualizaciones están disponibles para el comando siguiente y se restablecen después de reiniciar el controlador. Las funciones agrupan la lógica que desea reutilizar.
Use la (?) para obtener explicaciones sobre los campos y bloques, y Ayuda → Tutorial para consultar un ejemplo guiado. Ayúdame a escribir un nuevo driver con IA puede ayudar a preparar un driver a partir del manual mediante Ask Niri. Compruebe las direcciones, conversiones y secuencia de control resultantes con la documentación del fabricante y los resultados de sus pruebas.