INSTRUMENTOS LÍQUIDOS Moku Lab LabVIEW Guía de usuario de migración de API

Acabadoview

Moku: A versión 3.0 do software Lab é unha actualización importante que trae novo firmware, interfaces de usuario e API ao hardware de Moku:Lab. A actualización fai que Moku:Lab se axuste a Moku:Fro e Moku:Go, facilitando compartir scripts en todas as plataformas Moku. A actualización desbloquea unha serie de novas funcións para moitos dos instrumentos existentes. tamén engade dúas novas funcións: Modo multiinstrumento e Moku Cloud Compile. Hai algunhas diferenzas de comportamento sutís que tamén se describen na sección de compatibilidade con versións anteriores.

Esta actualización tamén afecta á arquitectura APl e, polo tanto, o novo paquete de API non será compatible con scripts APl existentes. Os usuarios de APlus terán que portar os seus scripts ao novo paquete Moku APl se actualizan o seu Moku:Lab á versión 3.C. Os usuarios de API cun importante desenvolvemento de software personalizado deben considerar coidadosamente o nivel de esforzo necesario para portar o seu coce existente. Moku:Lab 1.9 non se recomenda para novas implementacións e recoméndase a todos os clientes a actualizar. Finalmente, a versión 1.9 de Moku:Lab perderá a compatibilidade, de acordo coa nosa Política de fin de vida útil. Se xurden problemas despois da actualización, os usuarios terán a opción de baixar á versión 19 do software.

Esta guía de migración describe advantages de actualización e posibles complicacións da actualización a Moku:Lab versión 3.0. Tamén describe o proceso para actualizar o LabVIEW APl e como degradar o teu Moku:Lab se é necesario.

Novas características da versión 3.0

Novas características
A versión de software 3.0 trae por primeira vez o modo Multi-Instrument e Moku Cloud Compile a Moku:Lab, así como moitas actualizacións de rendemento e usabilidade no conxunto de instrumentos.

Modo multiinstrumento
O modo Muli-instrument en Moku:Lab permite aos usuarios implementar dous instrumentos á vez para crear unha estación de proba personalizada. Cada instrumento ten acceso total ás entradas e saídas analóxicas, xunto coas interconexións entre as ranuras do instrumento. As interconexións entre os instrumentos admiten comunicación dixital en tempo real de alta velocidade e baixa latencia de ata 2 Gb/s, polo que os instrumentos poden funcionar de forma independente ou conectarse para construír canalizacións de procesamento de sinal avanzadas. Os usuarios poden intercambiar de forma dinámica os instrumentos dentro e fóra sen interromper o outro adxacente. Os usuarios avanzados tamén poden implementar os seus propios algoritmos personalizados no modo multiinstrumento usando Moku Cloud Compile.

Compilación Moku Cloud
Moku Cloud Compile permítelle implementar o procesamento de sinal dixital personalizado (DSP) directamente no Moku:Lab FPGA en modo multiinstrumento. Escribe código usando a web navegador e compílao na nube; despois usa Moku Cloud Compile para implementar o bitstream nun ou máis dispositivos Moku de destino.

Osciloscopio

• Modo de memoria profunda: aforra ata 4M samples por canle ao s completoamptaxa de pesca (500 MSa/s)

• Mellora do chan de ruído
• Escala Vrms e Vpp logarítmicas
• Cinco novas funcións da fiestra (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasímetro

• Os usuarios agora poden emitir compensación de frecuencia, fase e amplitude como analóxico voltage sinais
• Os usuarios agora poden engadir unha compensación de CC aos sinais de saída
• A saída de onda sinusoidal con bloqueo de fase agora pódese multiplicar a frecuencia ata 250x ou dividirse ata 0.125x
• Ancho de banda mellorado (1 Hz a 100 kHz)
• Funcións avanzadas de axuste de fase e auto-reinicio

Xerador de formas de onda

• Saída de ruído
• Modulación de ancho de impulso (PWM)

Bloqueo Amplifier (LIA) 

• Mellora do rendemento do bloqueo PLL de baixa frecuencia
• A frecuencia mínima de PLL reduciuse a 10 Hz
• O sinal PLL interno agora pódese multiplicar a frecuencia ata 250x ou dividirse ata 0.125x para o seu uso na demodulación.
• Precisión de 6 díxitos para valores de fase

Analizador de resposta en frecuencia

• Aumento da frecuencia máxima de 120 MHz a 200 MHz
• Aumentáronse os puntos de varrido máximo de 512 a 8192
• Nova dinámica AmpA función Litude optimiza o sinal de saída automaticamente para obter o mellor rango dinámico de medición
• Novo modo de medición In/Int
• Avisos de saturación de entrada
• A canle matemática agora admite ecuacións arbitrarias de valores complexos que inclúen os sinais da canle, o que permite novos tipos de medicións de funcións de transferencia complexas
• Os usuarios agora poden medir os sinais de entrada en dBVpp e dBVrms ademais de dBm
• O progreso do varrido móstrase agora no gráfico
• Agora pódese bloquear o eixe de frecuencia para evitar cambios accidentais durante o varrido ao longo

Caixa de bloqueo láser

• O diagrama de bloques mellorado mostra as rutas de sinal de exploración e modulación
• Novo bloqueo stages característica permite aos usuarios personalizar o seu procedemento de bloqueo
• Mellora do rendemento do bloqueo P_L de baixa frecuencia
• Precisión de 6 díxitos para valores de fase
• Mellora do rendemento do bloqueo P_L de baixa frecuencia
• A frecuencia mínima de PLL reduciuse a 10 Hz
• O sinal PLL agora pódese multiplicar a frecuencia ata 250x ou dividirse ata 0.125x para o seu uso na demodulación.

OUTROS

• Engadido soporte para a función sinc ao editor de ecuacións que se pode usar para xerar formas de onda personalizadas no xerador de formas de onda arbitrarias
• Converter LI binario files aos formatos CSV, MATLAB ou NumPy ao descargar desde o dispositivo

Compatibilidade con API actualizada
O novo paquete Moku API ofrece unha funcionalidade e estabilidade melloradas. Recibirá actualizacións periódicas para mellorar o rendemento e introducir novas funcións.

Limitacións de compatibilidade con versións anteriores

API
O novo Moku LabVIEW O paquete API non é compatible con versións anteriores co Moku:LabLab anteriorVIEW API. As entradas e saídas son totalmente diferentes. Se fixeches un amplo desenvolvemento de software personalizado utilizando Moku:Lab LabVIEW API, considere o impacto da migración de todo o seu software para que sexa compatible coa nova API.

Mentres que o Moku:Lab 1.9 LabVIEW O paquete API xa non recibirá actualizacións, Liquid Instruments seguirá proporcionando soporte aos usuarios que non poidan migrar ao novo paquete API.ampficheiros para cada instrumento no novo Moku LabVIEW Paquete de API para servir como base para converter o desenvolvemento de APl anterior ao novo paquete de APl.

Regresións

Disco RAM para rexistro de datos
A versión 1.9 a tiña 512 MB filesistema na memoria RAM do dispositivo, que podería usarse para rexistrar datos con s altosamptaxas de ling. Isto xa non está dispoñible na versión 3.0. Para activar o rexistro de datos, é necesaria unha tarxeta SD. Isto limita a velocidade de rexistro de datos a aproximadamente 250 kSa/s para 1 canle e 125 kSa/s para dúas canles.

Rexistro de datos en CSV
A versión 1.9 tiña a capacidade de gardar datos directamente nun CSV file mentres rexistra. Esta función non está dispoñible directamente na versión 3.0. Usuarios cuxo fluxo de traballo incluíu gardar CSV files directamente a unha tarxeta SD ou agora o cliente terá que converter primeiro o binario file a CSV, usando a aplicación cliente ou instalando o Liquid Instruments autónomo File Converter ao ordenador que usan para o procesamento de datos.

Cambios non compatibles con versións anteriores

Escalado de datos en LIA
Na versión 1.9, implementamos a escala de datos de tal xeito que a multiplicación de dous sinais de 0.1 V CC deu como resultado unha saída de 0.02 V CC. Na versión 3.0, cambiamos isto para que o resultado fose 0.01 V CC, o que está máis en liña coas expectativas intuitivas dos clientes.

A saída do xerador de formas de onda debe estar habilitada para usala como fonte/disparador de modulación
Na versión 1.9, a forma de onda dunha canle diferente podería usarse como fonte de modulación ou disparador no xerador de formas de onda, aínda que a saída desa canle estivese desactivada. Isto foi eliminado na versión 3.0. Os usuarios que queiran facer a modulación cruzada sen necesidade de desconectar as saídas do seu dispositivo deberán axustar o seu fluxo de traballo.

Laboratorio MokuVIEW API

Laboratorio MokuVIEW O paquete API está destinado a proporcionar LabVIEW desenvolvedores os recursos necesarios para controlar calquera dispositivo Moku e, en definitiva, a capacidade de incorporar estes controis a aplicacións de usuarios finais máis grandes.

O novo Moku LabVIEW O paquete API ofrece o seguinte:

• Totalmente funcional exampos para cada instrumento.
• Unha estrutura de diagrama de bloques que é fácil de entender e que pode servir como punto de partida do usuario final para a personalización e adaptación
• As funcións Vl proporcionan control total sobre o dispositivo Moku.

Instrumentos soportados actualmente

1. Xerador de formas de onda arbitrarias
2. Registrador de datos
3. Caixa de filtro dixital
4. Creador de filtros FIR
5. Analizador de resposta en frecuencia
6. Bloqueo Ampmáis vivo
7. Caixa de bloqueo láser
8. Analizador lóxico
9. Osciloscopio
10. Fasímetro
11. Analizador de espectro
12. Xerador de formas de onda
13. Controlador PID
14. Modo multiinstrumento
15. Compilación Moku Cloud

Instalación

Requisitos

• LaboratorioVIEW versión 2016 ou posterior
• Xestor de paquetes VIP (VIPM)

Se xa tes unha versión anterior do Moku LabVIEW APinstalado, desinstáleo antes de continuar. Podes desinstalar o paquete do xestor de paquetes VI seleccionando Desinstalar paquete.

1. Descarga e instala Moku LabVIEW paquete de Liquid Instruments websitio en
2. O paquete instalarase a través do xestor de paquetes VI. Unha vez completado, debería poder ver o paquete listado en "instalado" en VI Package Manager.
   Figura 1: Xestor de paquetes JKI VI
   
   Nota: Os outros paquetes enumerados aquí son dependencias utilizadas para a transmisión de datos.

Cambios na API de Moku

O novo Moku LabVIEW A arquitectura APl é suficientemente diferente da súa predecesora e, polo tanto, non é compatible con scripts de API existentes. O seguinte osciloscopio simplificado example mostra as diferenzas entre os paquetes de API legados e os novos e serve como folla de ruta para portar o código existente.

Osciloscopio example
Figura 2: comparación do osciloscopio APl

Pasos de secuencia

1. Comeza a sesión do cliente e carga o fluxo de bits do osciloscopio a Moku
2. Establece a base de tempo e establece o intervalo á esquerda e á dereita para o eixe do tempo
3. Xera forma de onda, configura e xera unha onda sinusoidal na canle 1
4. Obtén datos, adquire un único fotograma dos datos do osciloscopio.
5. CENITENOS
6. Finalizar a sesión do cliente

A secuencia descrita anteriormente é un exemplo simplificadoample para ilustrar as diferenzas entre os paquetes APL legados e os novos. Ademais de comezar unha sesión de cliente, cargar un fluxo de bits de instrumento a Moku e finalizar a sesión de cliente, un usuario final pode exercer calquera número de funcións en varias ordes para satisfacer as necesidades da súa aplicación.

Diferenzas
Aquí, observamos as diferenzas entre as dúas API para cada paso da secuencia.

1. Comeza a sesión Maku-Client e cargue o fluxo de bits do osciloscopio a Moku
   O novo APl dividiu a conexión da sesión do cliente e subiu o fluxo de bits do instrumento en funcións separadas, 1A e 1B. Todos os scripts comezan con estas dúas funcións.
   
2. Base horaria
   As funcións do instrumento no novo APl agora son funcións únicas. Anteriormente, este era un proceso de dous pasos na API antiga. A primeira función converte os parámetros de entrada nunha cadea JSON e a función de segundos envía o comando ao Moku. Ademais, os parámetros de función do APl herdado estaban contidos en clústeres. A maioría dos parámetros de función do novo APl son controis individuais.
   Figura 4 Establecer a base de tempo
   
3. Xerar forma de onda
   A función de xerar forma de onda é unha única función na nova API. Neste caso, os parámetros da función están contidos nun clúster. Hai varias funcións no novo AP que requiren moitos parámetros de entrada; neses casos, úsase un clúster.
   
4. Obter datos
   A función de obter datos tamén é unha única función na nova API. Neste caso, os parámetros da función son controis individuais para ambas as API. O ARl herdado require unha función adicional para converter os datos de saída do formato de cadea JSON en matrices numéricas para cada canle.
   Figura 7: Pechar a API
   
   
5. Finalizar a sesión Moku-Client
   A función Pechar API é unha única función na nova API. Todos os scripts rematan con esta función.
   Figura 7: Pechar a API
   

Comparación de paletas
Podes atopar cartafoles de instrumentos equivalentes na paleta principal de Liquid Instruments Moku, que se ve na Figura 8. Despois, en cada cartafol de instrumentos atoparás as funcións equivalentes do instrumento, que se ve na Figura 9 e na Figura 10.
Figura : Paleta principal, paleta API antiga á esquerda, paleta API nova á dereita.

Figura 9: Cartafol de instrumentos do osciloscopio herdado á esquerda, novo cartafol de instrumentos do osciloscopio á dereita.

Figura 10: Funcións do instrumento

Laboratorio MokuVIEW APl baséase na API de Moku. Para obter a documentación completa de Moku APl, consulte a Referencia da API de Moku que se atopa aquí https://apisliquidinstruments.com/reference/. Detalles adicionais para comezar con Moku LabVIEW A API pódese atopar en
https://apis.liquidinstruments.com/starting-labview.html.

Proceso de downgrade

Se a actualización á versión 3.0 demostrou limitar, ou afectar negativamente, algo crítico para a súa aplicación, pode baixar á versión anterior 1.9. Isto pódese facer a través dun web navegador.

Pasos

1. Contacta con Liquid Instruments e obtén o file para a versión de firmware 1.9.
2. Escriba o seu enderezo IP de Moku:Lab en a web navegador (ver captura de pantalla).
3. En Actualizar firmware, busque e seleccione o firmware file proporcionado por Liquid Instruments.
4. Seleccione Cargar e actualizar. O proceso de actualización pode tardar máis de 10 minutos en completarse.
   Figura 11: Procedemento de downgrade
   

Documentos/Recursos

INSTRUMENTOS LÍQUIDOS Moku Lab LabVIEW Migración de API [pdfGuía do usuario Laboratorio MokuVIEW Migración de API, LabVIEW Migración de API, Migración de API, Migración

Referencias

• Manual de usuario