LIQUID INSTRUMENTS MATLAB API Integração Fusíveis

Guia de migração de API MATLAB

A atualização do Moku: Lab para a versão 3.0 do software desbloqueia uma série de novos recursos. Ao atualizar, os usuários da API devem realizar etapas extras para migrar seus scripts para o novo pacote da API Moku. Este guia de migração descreve alterações na API, novos recursos disponíveis na atualização da versão 3.0 e quaisquer limitações de compatibilidade com versões anteriores.

Sobreview

O software Moku:Lab versão 3.0 é uma atualização importante que traz novo firmware, interface de usuário e APls para o hardware Moku:Lab. A atualização alinha o Moku:Lab com o Moku:Pro e o Moku:Go, facilitando o compartilhamento de scripts em todas as plataformas Moku. A atualização desbloqueia uma série de novos recursos para muitos dos instrumentos existentes. Ele também adiciona dois novos recursos: Modo Multi-instrumento e Moku Cloud Compile. Existem também algumas diferenças comportamentais sutis, descritas na seção Compatibilidade com versões anteriores.

Esta é uma atualização importante que afeta a arquitetura da API e, portanto, o novo pacote MATLAB API v3.0 não será compatível com versões anteriores dos scripts MATLAB existentes. Os usuários da API precisarão portar seus scripts para o novo pacote da API Moku se atualizarem seu Moku:Lab para a versão 3.0. Os usuários de API com desenvolvimento significativo de software personalizado devem considerar cuidadosamente o nível de esforço necessário para portar seu código existente. Moku:Lab 1.9 não é recomendado para novas implantações e todos os clientes são incentivados a atualizar. Se surgirem problemas após a atualização, os usuários terão a opção de fazer downgrade para a versão 1.9 do software.

Este guia de migração descreve o avançotagproblemas de atualização e possíveis complicações para o Moku:Lab versão 3.0. Ele também descreve o processo de atualização da API MATLAB e como fazer o downgrade do seu Moku:Lab, se necessário.

Novos recursos da versão 3.0

Novos recursos

A versão 3.0 do software traz o modo Multi-Instrument e Moku Cloud Compile para o Moku:Lab pela primeira vez, bem como muitas atualizações de desempenho e usabilidade em todo o conjunto de instrumentos.

Modo Multi-instrumento

O modo multiinstrumento no Moku:Lab permite aos usuários implantar dois instrumentos simultaneamente para criar uma estação de teste personalizada. Cada instrumento tem acesso total às entradas e saídas analógicas, juntamente com interconexões entre slots de instrumentos. As interconexões entre instrumentos suportam comunicação digital de alta velocidade, baixa latência e em tempo real de até 2 Gb/s, para que os instrumentos possam funcionar de forma independente ou serem conectados para construir pipelines avançados de processamento de sinais. Os instrumentos podem ser trocados dinamicamente sem interromper o outro instrumento. Usuários avançados também podem implantar seus próprios algoritmos personalizados no modo multiinstrumento usando Moku Cloud Compile.

Compilação da nuvem Moku

O Moku Cloud Compile permite que você implante DSP personalizado diretamente no Moku:Lab FPGA no modo multiinstrumento. Escreva o código usando um web navegador e compilá-lo na nuvem; O Moku Cloud Compile implanta o fluxo de bits em um ou mais dispositivos Moku de destino.

Osciloscópio

• Modo de memória profunda: economize até 4M samparquivos por canal em full samptaxa de flutuação (500 MSa/s)

Analisador de espectro

• Piso de ruído melhorado
• Escala logarítmica Vrms e Vpp
• Cinco novas funções de janela (Bartlett, Hamming, Nuttall, Gaussian, Kaiser)

Fasímetro

• Deslocamento de frequência, fase e amplitude agora pode ser emitida como volume analógicotage sinais
• Os usuários agora podem adicionar deslocamento DC aos sinais de saída
• A saída de onda senoidal com fase bloqueada agora pode ser multiplicada por frequência em até 2 50x ou dividida em 125x
• Faixa de largura de banda aprimorada (1 Hz a 100 kHz)
• Funções avançadas de encapsulamento de fase e reinicialização automática

Gerador de forma de onda

• Saída de ruído
• Modulação de largura de pulso (PWM)

trancar Ampmais vivo

• Melhor desempenho de baixa frequência PLL bloqueio
• A frequência mínima PLL foi reduzida para 10 Hz
• O sinal PLL interno agora pode ser multiplicado em frequência em até 250x ou dividido em 125x para uso em demodulação
• Precisão de 6 dígitos para valores de fase

Analisador de Resposta de Frequência

• Aumento da frequência máxima de 120 MHz para 200 MHz
• Aumente os pontos máximos de varredura de 512 para 8192
• A Nova Dinâmica AmpO recurso litude otimiza o sinal de saída automaticamente para melhor faixa dinâmica de medição
• Novo modo de medição ln/ln1
• Avisos de saturação de entrada
• O canal matemático agora suporta equações arbitrárias de valores complexos envolvendo os sinais do canal, permitindo novos tipos de medições complexas de funções de transferência
• Os sinais de entrada agora podem ser medidos em dBVpp e dBVrms, além de dBm
• O progresso da varredura agora é exibido no gráfico
• O eixo de frequência agora pode ser bloqueado para evitar alterações acidentais durante uma varredura longa

Caixa de bloqueio a laser

• O diagrama de blocos aprimorado mostra caminhos de sinal de varredura e modulação
• O novo bloqueiotagO recurso permite personalizar o procedimento de bloqueio
• Melhor desempenho de baixa frequência PLL bloqueio
• Precisão de 6 dígitos para valores de fase
• Melhor desempenho de baixa frequência PLL bloqueio
• A frequência mínima PLL foi reduzida para 10 Hz
• O PLL o sinal agora pode ser multiplicado em frequência em até 250x ou dividido em 0.125x para uso em demodulação

Outro

Adicionado suporte para a função senoidal ao editor de equações que pode ser usado para gerar formas de onda personalizadas no Gerador de Forma de Onda Arbitrária

Converter binário LI files para os formatos CSV, MATLAB ou NumPy ao fazer download do dispositivo

Suporte de API atualizado

O novo pacote Moku MATLAB API v3.0 oferece funcionalidade e estabilidade aprimoradas. Ele receberá atualizações regulares para melhorar o desempenho e introduzir novos recursos.

Limitações de compatibilidade com versões anteriores

API

O novo pacote Moku MATLAB API v3.0 não é compatível com versões anteriores do pacote Moku:Lab MATLAB v1.9 anterior. Os argumentos de script MATLAB e os valores de retorno são totalmente diferentes. Se você possui um amplo desenvolvimento de software personalizado utilizando o Moku:Lab MATLAB, considere o impacto da migração de todo o seu software para ser compatível com a nova API.

Embora o pacote Moku:Lab MATLAB não receba mais atualizações, a Liquid Instruments continuará a fornecer suporte para usuários que não conseguem migrar para o novo pacote API.

Encontre ex detalhadoamparquivos para cada instrumento no novo pacote Moku MATLAB API v3.0 para servir como uma linha de base para converter o desenvolvimento anterior do MATLAB para o novo pacote API.

Regressões

Disco RAM para registro de dados

A versão 1.9 tinha 512 MB filesistema na RAM do dispositivo, que pode ser usado para registrar dados em alta velocidadeamptaxas de câmbio. Na versão 3.0, o registro na RAM não está mais disponível. Para ativar o registro de dados, é necessário um cartão SD. Conseqüentemente, a velocidade máxima de aquisição também muda. A versão 1.9 suporta até 1 MSa/s, enquanto a versão 3.0 suporta até 250 kSa/s em 1 canal e 125 kSa/s em 2 canais. Mesmo em velocidades mais baixas e com um cartão SD, os fluxos de trabalho que incluíam salvar vários registros de alta velocidade na RAM e depois copiá-los para o cartão SD ou para o cliente não serão mais suportados.

Registro de dados em CSV

A versão 1.9 tinha a capacidade de salvar dados diretamente em um CSV file durante o registro. Este recurso não está disponível diretamente na versão 3.0. Usuários cujo fluxo de trabalho incluía salvar CSVfiles diretamente para um cartão SD ou o cliente precisará primeiro converter o binário file para CSV, usando o aplicativo cliente ou instalando o Liquid Instruments independente File Conversor para o computador que eles usam para processamento de dados.

Alterações não compatíveis com versões anteriores

Dimensionamento de dados no LIA

Na versão 1.9, implementamos o escalonamento de dados de forma que a multiplicação de dois sinais de 0.1 V CC resultasse em uma saída de 0.02 V CC. Na versão 3.0, alteramos isso para que o resultado fosse 0.01 V DC, o que está mais de acordo com as expectativas intuitivas dos clientes.

A saída do gerador de forma de onda deve estar habilitada para ser usada como fonte/trigger de modulação

Na versão 1.9, a forma de onda de um canal diferente poderia ser usada como modulação ou fonte de disparo no Gerador de Forma de Onda, mesmo que a saída desse canal estivesse desabilitada. Isso foi removido na versão

• Os usuários que desejam fazer modulação cruzada sem precisar desconectar as saídas de seus dispositivos precisarão ajustar seus

API Moku MATLAB

O pacote Moku MATLAB API v3.0 tem como objetivo fornecer aos desenvolvedores do MATLAB os recursos necessários para controlar qualquer dispositivo Moku e, em última análise, a capacidade de incorporar esses controles em aplicativos maiores de usuário final. O novo pacote Moku MATLAB API v3.0 fornece o seguinte:

• Ex totalmente funcionalample scripts MATLAB para cada
• Todos os scripts MATLAB são fornecidos com comentários, que são fáceis de entender e podem servir como ponto de partida do usuário final para personalização e
• Um conjunto de funções que fornecem controle total sobre o Moku

Instrumentos atualmente suportados

1. Gerador de forma de onda arbitrária
2. Registrador de dados
3. Caixa de filtro digital
4. Construtor de filtro FIR
5. Analisador de Resposta de Frequência
6. Caixa de bloqueio a laser
7. Bloqueio Ampmais vivo
8. Osciloscópio
9. Fasímetro
10. Controlador PID
11. Analisador de espectro
12. Gerador de forma de onda
13. Modo Multi-instrumento
14. Compilação da nuvem Moku

Instalação

Requisitos

• MATLAB versão 2015 ou posterior

Se você já possui uma versão anterior da API Moku MATLAB instalada, desinstale-a antes de continuar. Você pode desinstalar o pacote do Gerenciador de complementos.

1. Abra o Gerenciador de complementos na guia Página inicial> Ambiente.
2. Procurar Moku in the Add-on Manager and click ‘Add’. The toolbox will show up as Moku- MATLAB.
3. Alternativamente, você pode baixar a caixa de ferramentas diretamente do Liquid Instruments website em https://www.liquidinstruments.com/products/apis/matlab-api/. Você terá que definir o caminho de pesquisa manualmente se fizer isso.
4. Verifique se o caminho correto foi adicionado à caixa de ferramentas selecionando 'Definir Caminho' na guia Início > Ambiente.
5. Certifique-se de que haja uma entrada apontando para o local de instalação da caixa de ferramentas. Um caminho típico pode ser CAUserskusername>\AppDataRoaming\Mathworks\MATLABAdd-Ons\Toolboxes\oku- MATLAB.
6. Baixe os dados do instrumento files digitando 'moku_download####) na janela de comando do MATLAB. O ### deve ser substituído pela versão atual do firmware. Yol pode encontrar sua versão atual do firmware por meio do aplicativo de desktop Moku: clicando com o botão direito em seu Moku e passando o mouse sobre 'Informações do dispositivo' ou no aplicativo para iPad pressionando longamente seu Moku.
7. Confirme se sua caixa de ferramentas está configurada corretamente digitando 'help Moku' na janela de comando do MATLAB. Se este comando for bem-sucedido. então a caixa de ferramentas foi instalada com sucesso

Mudanças na API Moku

A nova arquitetura da API Moku MATLAB é suficientemente diferente de sua antecessora e, portanto, não é compatível com versões anteriores dos scripts de API existentes. O seguinte osciloscópio simplificado exampO arquivo mostra as diferenças entre os pacotes de API legados e novos e serve como um roteiro para portar o código existente.

Osciloscópio example

Etapas de sequência

1. Importe a API Moku MATLAB 3.0
2. Reivindique a propriedade do Moku e carregue o fluxo de bits do osciloscópio para
3. Defina a base de tempo e defina o intervalo esquerdo e direito do eixo do tempo.
4. Obtenha dados, adquira um único quadro de dados do osciloscópio
5. Encerre a sessão do cliente renunciando à propriedade do Moku

A sequência descrita acima é um ex simplificadoamparquivo para ilustrar as diferenças entre os pacotes de API legados e novos. Além de iniciar uma sessão do cliente, enviar um fluxo de bits do instrumento para o Moku e encerrar a sessão do cliente, um usuário final pode exercer qualquer número de funções em várias ordens para atender às necessidades de sua aplicação.

Diferenças

Aqui, examinamos as diferenças entre os dois APls para cada etapa da sequência.

Reivindique a propriedade do Moku e carregue o fluxo de bits do osciloscópio para o dispositivo. Comparada com o Moku MATLAB 1.9, a nova API possui funções completamente diferentes:

	Moku MATLAB 1.9		Moku MATLAB 3.0
Função	obter_por_nome()	implantar_or_conn ect()	Osciloscópio()
Campos e valores permitidos	nome: string tempo limite: float	instrumento: a classe do instrumento que deseja implantar	ip: cadeia de caracteres serial: cadeia de caracteres
	força: bool	set_defauIt: booI	force_connect: bool
		use_externa I: bool	ignore_busy: bool
			persist_state: bool
			connect_timeout: flutuante
			read_timeout: flutuante

 

1. Definir base de tempo. A função é a mesma, mas os argumentos permitidos são ligeiramente diferentes:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Função	definir_base_de_tempo()	definir_base_de_tempo()
   Campos e valores permitidos	t1: flutuante t2: flutuante	t1: float t2: float estrito: bool

2. Adquirir dados. As funções e os argumentos permitidos são os mesmos, mas o tipo e o comprimento dos dados retornados são diferentes:
   

   	Moku MATLAB 1.9	Moku MATLAB 3.0
   Função	adquirir dados()	adquirir dados()
   Campos e valores permitidos	tempo limite: float espera: bool	tempo limite: float wait_reacquire: bool
   Comprimento de retorno	16383 pontos por quadro	1024 pontos por quadro

3. Liberar a propriedade do Moku:
   

   	Moku MATLAB 1.9	API Moku v3.0
   Função	fechar()	renunciar_propriedade()

Lista de funções do osciloscópio

Moku MATLAB 1.9	Moku MATLAB 3.0
set_sourceO	set_sourcesO
set_triggerO	set_triggerO
obter_dadosQ	obter_dadosQ
definir_frontendQ	definir_frontendQ
set_defau!tsQ set_timebaseO definir_xmodeQ	set_defau!tsQ set_timebaseQ desabilitar_inputO enable_rollmodeQ
definir_modo_de_precisãoQ	definir_modo_de_aquisiçãoQ
fase_sincronizaçãoQ	sincronização_output_phaseQ
obter_frontendQ	obter_frontendQ
obter_samp!erateO obter_dados_de_tempo_realQ	obter_samp!erateO salvar_buffer_de_alta_resoluçãoO
gen_rampondaO gen_sinewaveO	gerar_formadeondaO obter_modo_de_aquisiçãoQ
gen_squarewaveQ	obter_fontesQ
gen_offQ	obter_base_de_tempoQ obter_saída_!loadQ
conjunto_samplerateQ definir_taxa_de_quadrosQ	obter_interposiçãoO definir_saída_!oadQ
	set_histereseQ set_interpo!ationO
	set_input_attenuationO
	set_sourceO osc_measurementQ
	resumoQ

A API Moku MATLAB é baseada na API Moku. Para obter a documentação completa da API Moku, consulte a referência da API Moku encontrada aqui https://apis.liq uidinstrume nts.com/re fe res/.

Detalhes adicionais para começar a usar a API Moku MATLAB podem ser encontrados em https://a pis.liquid instruments.com/sta avaliação-Matlab.lar

Processo de downgrade

Se a atualização para a versão 3.0 limitar ou afetar adversamente algo crítico para seu aplicativo, você poderá fazer downgrade para a versão anterior 1.9. Isto pode ser feito através de um web navegador.

Passos

1. Entre em contato com a Liquid Instruments e obtenha o file para firmware versão 9.
2. Digite seu endereço IP do Moku:Lab em um web navegador (veja a captura de tela).
3. Em Atualizar firmware, navegue e selecione o firmware file fornecido pela Liquid Instruments.
4. Selecione Carregar e atualizar. O processo de atualização pode levar mais de 10 minutos para ser concluído

© 2023 Instrumentos Líquidos. reservado.

laudinstruments.com

Documentos / Recursos

LIQUID INSTRUMENTS MATLAB API Integração Fusíveis [pdf] Guia do Usuário API MATLAB, Fusíveis de integração API MATLAB, Fusíveis de integração, Fusíveis

Referências

• Manual do usuário