Fusibles de integración API de MATLAB de LIQUID INSTRUMENTS

Guía de migración de API de MATLAB

Actualizar Moku: Lab a la versión 3.0 del software desbloquea una serie de funciones nuevas. Al actualizar, los usuarios de API deben tomar medidas adicionales para migrar sus scripts al nuevo paquete API de Moku. Esta guía de migración describe los cambios de API, las nuevas funciones disponibles en la actualización de la versión 3.0 y las limitaciones de compatibilidad con versiones anteriores.

Encimaview

La versión 3.0 del software Moku:Lab es una actualización importante que trae nuevo firmware, interfaz de usuario y APl al hardware Moku:Lab. La actualización alinea Moku:Lab con Moku:Pro y Moku:Go, lo que facilita compartir scripts en todas las plataformas Moku. La actualización desbloquea una serie de funciones nuevas para muchos de los instrumentos existentes. También agrega dos características nuevas: modo multiinstrumento y Moku Cloud Compile. También existen algunas diferencias sutiles de comportamiento, que se describen en la sección Compatibilidad con versiones anteriores.

Esta es una actualización importante que afecta la arquitectura API y, por lo tanto, el nuevo paquete MATLAB API v3.0 no será compatible con los scripts MATLAB existentes. Los usuarios de API deberán migrar sus scripts al nuevo paquete API de Moku si actualizan su Moku:Lab a la versión 3.0. Los usuarios de API con un importante desarrollo de software personalizado deben considerar cuidadosamente el nivel de esfuerzo necesario para migrar su código existente. Moku:Lab 1.9 no se recomienda para nuevas implementaciones y se recomienda a todos los clientes que actualicen. Si surgen problemas después de la actualización, los usuarios tendrán la opción de bajar a la versión 1.9 del software.

Esta guía de migración describe advantagEs de actualización y posibles complicaciones de Moku:Lab versión 3.0. También describe el proceso para actualizar la API de MATLAB y cómo degradar su Moku:Lab si es necesario.

Nuevas características de la versión 3.0

Nuevas funciones

La versión 3.0 del software trae el modo multiinstrumento y Moku Cloud Compile a Moku:Lab por primera vez, así como muchas mejoras de rendimiento y usabilidad en todo el conjunto de instrumentos.

Modo multiinstrumento

El modo multiinstrumento en Moku:Lab permite a los usuarios implementar dos instrumentos simultáneamente para crear una estación de prueba personalizada. Cada instrumento tiene acceso completo a las entradas y salidas analógicas junto con interconexiones entre las ranuras de instrumentos. Las interconexiones entre instrumentos admiten comunicación digital de alta velocidad, baja latencia y en tiempo real de hasta 2 Gb/s, por lo que los instrumentos pueden funcionar de forma independiente o conectarse para construir canales de procesamiento de señales avanzados. Los instrumentos se pueden intercambiar dinámicamente dentro y fuera sin interrumpir el otro instrumento. Los usuarios avanzados también pueden implementar sus propios algoritmos personalizados en modo multiinstrumento utilizando Moku Cloud Compile.

Compilación en la nube de Moku

Moku Cloud Compile le permite implementar DSP personalizado directamente en Moku:Lab FPGA en modo multiinstrumento. Escribir código usando un web navegador y compilarlo en la nube; Moku Cloud Compile implementa el flujo de bits en uno o más dispositivos Moku de destino.

Osciloscopio

• Modo de memoria profunda: guarda hasta 4 M samparchivos por canal a máxima velocidadampvelocidad lenta (500 MSa/s)

Analizador de espectro

• Piso de ruido mejorado
• Escala logarítmica Vrms y Vpp
• Cinco nuevas funciones de ventana (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasímetro

• Desplazamiento de frecuencia, fase y amplitude ahora se puede emitir como volumen analógicotage señales
• Los usuarios ahora pueden agregar compensación de CC a las señales de salida
• La salida de onda sinusoidal de fase bloqueada ahora se puede multiplicar en frecuencia hasta 2 x 50 o dividir hasta 125 x.
• Rango de ancho de banda mejorado (1 Hz a 100 kHz)
• Funciones avanzadas de ajuste de fase y reinicio automático

Generador de forma de onda

• Salida de ruido
• Modulación de ancho de pulso (PWM)

Cerrar Ampmás vivaz

• Rendimiento mejorado de baja frecuencia. LLP cierre
• La frecuencia mínima de PLL se ha reducido a 10 Hz
• La señal PLL interna ahora se puede multiplicar en frecuencia hasta 250x o dividir hasta 125x para usar en demodulación.
• Precisión de 6 dígitos para valores de fase

Analizador de respuesta de frecuencia

• Aumento de la frecuencia máxima de 120 MHz a 200 MHz
• Aumentar los puntos máximos de barrido de 512 a 8192
• La nueva dinámica AmpLa función litude optimiza la señal de salida automáticamente para obtener el mejor rango dinámico de medición
• Nuevo modo de medición ln/ln1
• Advertencias de saturación de entrada
• El canal matemático ahora admite ecuaciones arbitrarias de valor complejo que involucran las señales del canal, lo que permite nuevos tipos de mediciones de funciones de transferencia complejas.
• Las señales de entrada ahora se pueden medir en dBVpp y dBVrms además de dBm.
• El progreso del barrido ahora se muestra en el gráfico
• El eje de frecuencia ahora se puede bloquear para evitar cambios accidentales durante un barrido largo.

Caja de bloqueo láser

• El diagrama de bloques mejorado muestra las rutas de las señales de exploración y modulación.
• El nuevo bloqueo stagLa característica es permite personalizar el procedimiento de bloqueo
• Rendimiento mejorado de baja frecuencia. LLP cierre
• Precisión de 6 dígitos para valores de fase
• Rendimiento mejorado de baja frecuencia. LLP cierre
• La frecuencia mínima de PLL se ha reducido a 10 Hz
• El LLP La señal ahora se puede multiplicar en frecuencia hasta 250x o dividir hasta 0.125x para usar en demodulación.

Otro

Se agregó soporte para la función sinusoidal al editor de ecuaciones que se puede usar para generar formas de onda personalizadas en el Generador de formas de onda arbitrarias.

Convertir binario LI files a los formatos CSV, MATLAB o NumPy al descargar desde el dispositivo

Soporte API actualizado

El nuevo paquete Moku MATLAB API v3.0 proporciona funcionalidad y estabilidad mejoradas. Recibirá actualizaciones periódicas para mejorar el rendimiento e introducir nuevas funciones.

Limitaciones de compatibilidad con versiones anteriores

API

El nuevo paquete Moku MATLAB API v3.0 no es compatible con el paquete anterior Moku:Lab MATLAB v1.9. Los argumentos de scripting de MATLAB y los valores de retorno son completamente diferentes. Si tiene un amplio desarrollo de software personalizado utilizando Moku:Lab MATLAB, considere el impacto de migrar todo su software para que sea compatible con la nueva API.

Si bien el paquete Moku:Lab MATLAB ya no recibirá actualizaciones, Liquid Instruments seguirá brindando soporte a los usuarios que no puedan migrar al nuevo paquete API.

Encuentra ex detalladoamparchivos para cada instrumento en el nuevo paquete Moku MATLAB API v3.0 para que sirvan como base para convertir el desarrollo anterior de MATLAB al nuevo paquete API.

Regresiones

Disco RAM para registro de datos

La versión 1.9 tenía 512 MB. filesistema en la RAM del dispositivo, que podría usarse para registrar datos a alta samptasas de maruca. En la versión 3.0, el registro en la RAM ya no está disponible. Para habilitar el registro de datos, se requiere una tarjeta SD. En consecuencia, también cambia la velocidad máxima de adquisición. La versión 1.9 admitía hasta 1 MSa/s, mientras que la versión 3.0 admitía hasta 250 kSa/s en 1 canal y 125 kSa/s en 2 canales. Incluso a velocidades más bajas y con una tarjeta SD, los flujos de trabajo que incluían guardar múltiples registros de alta velocidad en la RAM y luego copiarlos a la tarjeta SD o al cliente ya no serán compatibles.

Registro de datos en CSV

La versión 1.9 tenía la capacidad de guardar datos directamente en un CSV file mientras inicia sesión. Esta función no está disponible directamente en la versión 3.0. Usuarios cuyo flujo de trabajo incluía guardar CSVfiles directamente a una tarjeta SD o el cliente ahora necesitará convertir primero el binario file a CSV, ya sea usando la aplicación del cliente o instalando Liquid Instruments independiente File Convertidor al ordenador que utilizan para el procesamiento de datos.

Cambios no compatibles con versiones anteriores

Escalado de datos en LIA

En la versión 1.9, implementamos el escalado de datos de modo que al multiplicar dos señales de 0.1 V CC se obtuvo una salida de 0.02 V CC. En la versión 3.0, cambiamos esto de modo que el resultado fuera 0.01 V CC, lo que está más en línea con las expectativas intuitivas de los clientes.

La salida del generador de forma de onda debe estar habilitada para usarse como fuente/disparador de modulación

En la versión 1.9, la forma de onda de un canal diferente se podía usar como fuente de modulación o disparador en el Generador de formas de onda, incluso si la salida de ese canal estaba desactivada. Esto fue eliminado en la versión

• Los usuarios que quieran realizar modulación cruzada sin necesidad de desconectar las salidas de su dispositivo deberán ajustar su

API de MokuMATLAB

El paquete Moku MATLAB API v3.0 está destinado a proporcionar a los desarrolladores de MATLAB los recursos necesarios para controlar cualquier dispositivo Moku y, en última instancia, la capacidad de incorporar estos controles en aplicaciones de usuario final más grandes. El nuevo paquete Moku MATLAB API v3.0 proporciona lo siguiente:

• Totalmente funcional examplos scripts de MATLAB para cada uno
• Todos los scripts de MATLAB cuentan con comentarios, que son fáciles de entender y pueden servir como punto de partida del usuario final para la personalización y
• Un conjunto de funciones que proporcionan control total sobre Moku.

Instrumentos actualmente soportados

1. Generador de forma de onda arbitraria
2. Registrador de datos
3. Caja de filtros digitales
4. Creador de filtros FIR
5. Analizador de respuesta de frecuencia
6. Caja de bloqueo láser
7. Encierro Ampmás vivaz
8. Osciloscopio
9. Fasímetro
10. Controlador PID
11. Analizador de espectro
12. Generador de forma de onda
13. Modo multiinstrumento
14. Compilación en la nube de Moku

Instalación

Requisitos

• MATLAB versión 2015 o posterior

Si ya tiene instalada una versión anterior de la API Moku MATLAB, desinstálela antes de continuar. Puede desinstalar el paquete desde el Administrador de complementos.

1. Abra el Administrador de complementos a través de la pestaña Inicio > Entorno.
2. Buscar Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativamente, puede descargar la caja de herramientas directamente desde Liquid Instruments websitio en https://www.liquidinstruments.com/products/apis/matlab-api/. Tendrá que configurar la ruta de búsqueda manualmente si hace esto.
4. Verifique que se haya agregado la ruta correcta a la caja de herramientas seleccionando 'Establecer ruta' en la pestaña Inicio > Entorno.
5. Asegúrese de que haya una entrada que apunte a la ubicación de instalación de la caja de herramientas. Una ruta típica podría ser CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku-MATLAB.
6. Descargar los datos del instrumento files escribiendo 'moku_download####) en la ventana de comandos de MATLAB. El ### debe reemplazarse con su versión de firmware actual. Yol puede encontrar su versión de firmware actual a través de Moku: aplicación de escritorio haciendo clic derecho en su Moku y colocando el cursor sobre "Información del dispositivo", o en la aplicación de iPad presionando prolongadamente su Moku.
7. Confirme que su caja de herramientas esté configurada correctamente escribiendo "help Moku" en la ventana de comandos de MATLAB. Si este comando tiene éxito. entonces la caja de herramientas se ha instalado correctamente

Cambios en la API de Moku

La nueva arquitectura API de Moku MATLAB es suficientemente diferente de su predecesora y, por lo tanto, no es compatible con los scripts API existentes. El siguiente osciloscopio simplificado exampEl archivo muestra las diferencias entre los paquetes de API heredados y nuevos y sirve como guía para migrar el código existente.

Osciloscopio example

Pasos de secuencia

1. Importar Moku MATLAB API 3.0
2. Reclama la propiedad de Moku y sube el flujo de bits del osciloscopio a
3. Establezca la base de tiempo y establezca el intervalo de mano izquierda y derecha para el eje de tiempo.
4. Obtenga datos, adquiera un solo cuadro de datos del osciloscopio
5. Finalice la sesión del cliente renunciando a la propiedad de Moku

La secuencia descrita anteriormente es un ejemplo simplificado.ample para ilustrar las diferencias entre los paquetes API nuevos y heredados. Además de iniciar una sesión de cliente, cargar un flujo de bits de instrumento en Moku y finalizar la sesión de cliente, un usuario final puede ejercer cualquier cantidad de funciones en diversos órdenes para satisfacer las necesidades de su aplicación.

Diferencias

Aquí, analizamos las diferencias entre las dos APl para cada paso de la secuencia.

Reclame la propiedad de Moku y cargue el flujo de bits del osciloscopio en el dispositivo. En comparación con Moku MATLAB 1.9, la nueva API tiene funciones completamente diferentes:

	MokuMATLAB 1.9		MokuMATLAB 3.0
Función	obtener_por_nombre()	implementar_o_conectar, etc.()	Osciloscopio()
Campos y valores permitidos	nombre: cadena tiempo de espera: flotante	instrumento: la clase del instrumento que desea implementar	ip: cadena serie: cadena
	fuerza: booleano	set_defauIt: booI	fuerza_conexión: booleano
		use_externa I:bool	ignorar_busy: booleano
			persist_state: booleano
			connect_timeout: flotante
			read_timeout: flotante

 

1. Establecer base de tiempo. La función es la misma, pero los argumentos permitidos son ligeramente diferentes:
   

   	MokuMATLAB 1.9	MokuMATLAB 3.0
   Función	establecer_base de tiempo()	establecer_base de tiempo()
   Campos y valores permitidos	t1: flotante t2: flotante	t1: flotante t2: flotante estricto: bool

2. Obtener datos. Las funciones y los argumentos permitidos son los mismos, pero el tipo y la longitud de los datos devueltos son diferentes:
   

   	MokuMATLAB 1.9	MokuMATLAB 3.0
   Función	obtener datos()	obtener datos()
   Campos y valores permitidos	tiempo de espera: espera flotante: bool	tiempo de espera: flotante esperar_reacquire: bool
   Longitud de retorno	16383 puntos por fotograma	1024 puntos por fotograma

3. Liberar la propiedad de Moku:
   

   	MokuMATLAB 1.9	API de Moku v3.0
   Función	cerca()	renunciar a la propiedad()

Lista de funciones del osciloscopio

MokuMATLAB 1.9	MokuMATLAB 3.0
set_sourceO	set_sourcesO
set_triggerO	set_triggerO
obtener_datosQ	obtener_datosQ
conjunto_frontendQ	conjunto_frontendQ
set_defau!tsQ set_timebaseO set_xmodeQ	set_defau!tsQ set_timebaseQ enable_inputO enable_rollmodeQ
set_precision_modeQ	set_acquisition_modeQ
sincronización_faseQ	sincronización_salida_faseQ
get_frontendQ	get_frontendQ
obtieneamp!erateO get_rea!time_dataQ	obtieneamp!erateO save_high_res_bufferO
gen_rampolaO gen_sinewaveO	generar_forma de ondaO get_acquisition_modeQ
gen_squarewaveQ	get_sourcesQ
gen_offQ	get_timebaseQ get_output_!loadQ
conjunto_samplerateQ set_framerateQ	get_interpo!ationO set_output_!loadQ
	set_hysteresisQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_mediciónQ
	resumenQ

La API Moku MATLAB se basa en la API Moku. Para obtener la documentación completa de la API de Moku, consulte la referencia de la API de Moku que se encuentra aquí. https://apis.liq uidinstrume nts.com/re fe reuna vez/.

Se pueden encontrar detalles adicionales para comenzar con Moku MATLAB API en https://a pis.liquid instruments.com/sta clasificación-Matlab.hogar

Proceso de degradación

Si se ha demostrado que la actualización a la versión 3.0 limita o afecta negativamente algo crítico para su aplicación, puede cambiar a la versión anterior 1.9. Esto se puede hacer a través de un web navegador.

Pasos

1. Póngase en contacto con Liquid Instruments y obtenga la file para la versión de firmware 9.
2. Escriba su dirección IP de Moku:Lab en un web navegador (ver captura de pantalla).
3. En Actualizar firmware, busque y seleccione el firmware file proporcionada por Liquid Instruments.
4. Seleccione Cargar y actualizar. El proceso de actualización puede tardar más de 10 minutos en completarse

© 2023 Instrumentos líquidos. reservado.

laudinstruments.com

Documentos / Recursos

Fusibles de integración API de MATLAB de LIQUID INSTRUMENTS [pdf] Guía del usuario MATLAB API, Fusibles de integración API de MATLAB, Fusibles de integración, Fusibles

Referencias

• Manual de usuario