O editor

Netlists SPICE no Mokxi

Rode um deck SPICE e plote os resultados, exporte um circuito como arquivo .cir, ou importe uma netlist como componentes e fios.

Onde fica

Os três estão no menu Salvar (a setinha ao lado de Salvar). Rodar um deck SPICE… roda uma netlist sozinha. Baixar SPICE grava o circuito como um arquivo, e Abrir JSON ou SPICE… lê um. Um arquivo terminado em .cir, .sp ou .spice é lido como netlist; qualquer outro é lido como um projeto do Mokxi.

Rodar um deck

Rodar um deck SPICE… abre uma folha com o deck em uma caixa de texto. Cole um, escolha um em Exemplos..., ou aperte Abrir arquivos e escolha o deck junto com quaisquer arquivos que ele inclui com .include. Aperte Rodar. Cada análise volta como um resultado que você escolhe na lista: uma transiente ou uma varredura como formas de onda, com uma caixa para cada tensão de nó e corrente de ramo, uma análise AC como um gráfico de Bode de ganho e fase, uma análise de ruído como o seu espectro, e um ponto de operação, .tf ou .meas como uma tabela. Baixar CSV salva o resultado na tela.

What it reads. A title line, * and ; comments, + continuations and SPICE's scale suffixes; .param with expressions and .func; .subckt and .ends with parameters, nested to any depth; .include and .lib of the files you opened with it; .model cards; .ic, .nodeset, .options, .temp, .step and .end. Elements: R, C, L and K; independent V and I sources with DC, AC, SIN, PULSE, PWL, EXP, SFFM and AM; the controlled sources E, F, G and H, including POLY; B sources with the usual functions of v(), i() and time; S and W switches; T lossless transmission lines; D diodes with breakdown, capacitance and series resistance; Q Gummel-Poon bipolar transistors with the Early effect and junction capacitances; J JFETs; M MOSFETs of levels 1, 2 and 3 with their capacitances; and X subcircuit instances.

As análises. .op; .tran, com UIC e um passo máximo; .ac em dec, oct ou lin; .dc, com uma segunda varredura aninhada; .tf; .noise; e .meas em suas formas comuns (TRIG/TARG, WHEN, FIND, AVG, RMS, MIN, MAX, PP, INTEG). Um ponto de operação que o Newton-Raphson simples não encontra é encontrado por gmin stepping, source stepping ou continuação pseudo-transiente, e o resultado diz qual foi necessário.

How far to trust it. The engine is checked against ngspice 42 on 42 benchmark circuits, from a voltage divider and RC, RL and RLC filters through rectifiers, a Zener regulator, transistor and MOSFET amplifiers, a differential pair, current mirrors, op-amp amplifiers, integrators and active filters, to oscillators, a latch, a Schmitt trigger and a buck converter. Every one agrees within a stated tolerance: DC values within 1% or 1 mV, AC within 0.1 dB and 1 degree, waveforms within 1% of their range (2% for switching waveforms), oscillator frequencies within 1%. The same checks run on every change to the engine.

O que ele não faz. Modelos de MOSFET acima do nível 3 (BSIM), MESFETs, linhas de transmissão com perdas, XSPICE e dispositivos digitais, fontes Laplace e de tabela de frequências, e as análises .four, .sens, .pz e .disto. Um deck que usa uma delas recebe uma mensagem apontando a linha. O KAPPA do MOSFET nível 3 difere do ngspice em até cerca de 4% na saturação, e o nível 2 não modela VMAX, DELTA, XJ nem NFS (um card que os define gera um aviso).

Um deck roda por conta própria, à parte do canvas: o circuito no canvas não é alterado, e os componentes do deck não aparecem nele. Para transformar uma netlist em componentes e fios, importe-a (abaixo).

Exportar

O arquivo é um deck do ngspice que roda como está: ngspice -b circuit.cir. Ele contém:

No Mokxi No arquivo
resistor, capacitor, indutor R, C, L
potenciômetro, potenciômetro deslizante dois resistores, com o cursor no meio do curso
vcc, fonte da bancada uma fonte V de corrente contínua
gerador de sinal, gerador de funções uma fonte V: SIN para senoide, PULSE para onda quadrada, triangular ou dente de serra
multímetro em uma faixa de corrente a zero-volt V source, which is SPICE's ammeter
diodo, Zener, LED D, com um card .model
transistor Q, com um card NPN ou PNP .model
MOSFET M com o corpo ligado à fonte, W=1 L=1, e um card NMOS ou PMOS de nível 1
amplificador operacional X, uma instância de um subcircuito para seu modelo

Os cards de modelo são do próprio motor. Cada card .model é escrito pelo motor a partir do dispositivo que ele constrói para o modelo daquele componente, então um 1N4148 no arquivo tem o mesmo Is, N, Rs, capacitância de junção e tempo de trânsito que o que o Mokxi resolve. Uma propriedade que você define no componente e que o card pode carregar entra nele: o beta de um transistor vira Bf, e o vto, beta e lambda de um MOSFET viram Vto, Kp e Lambda. Esse componente ganha então um card próprio, com seu nome. Um ajuste que o card não pode carregar (o forward de um diodo, o vz de um Zener) é citado numa linha * NOTE.

O amplificador operacional é o seu macromodelo. Cada modelo de amplificador operacional usado ganha um subcircuito (OPAMP_741, OPAMP_RAIL_TO_RAIL e assim por diante), e cada amplificador operacional é uma instância dele com seus números resolvidos na linha: ganho em malha aberta, produto ganho-largura de banda, slew rate, offset, folga, trilho negativo, limite de corrente e resistência de saída. Dentro dele estão o mesmo polo único, limitador de excursão e limite de corrente que o motor resolve. Um 741 com ganho não inversor de 11 exportado assim tem sua frequência de canto de 3 dB dentro de 1% da do próprio Mokxi no ngspice.

The run. The file ends with .op and a .tran. The run is as long as the widest scope window in the circuit, or five periods of the slowest generator, or 10 ms. If you set a longest step in Analysis… (o passo de tempo), ele é o quarto número da linha .tran line's fourth number, TMAX. A .print line lists the scope channels and op-amp outputs.

O que fica de fora. Uma placa, uma porta lógica, um display, um sensor ou qualquer outra coisa sem elemento SPICE fica de fora, e o arquivo avisa numa linha de comentário que nomeia o componente e o motivo: * OMITTED uno1 (uno): a board runs firmware, which SPICE cannot. Instrumentos que só observam (um osciloscópio, um voltímetro) são listados em linhas * INSTRUMENT com os nós que observam. O Darlington TIP120 também fica de fora, pois são dois transistores e um diodo e não tem forma de um card só. Depois de baixar, a nota sobre o canvas diz quantos componentes ficaram de fora, e o What os lista.

Os nós são chamados n1, n2 e assim por diante na ordem em que o arquivo os usa pela primeira vez, e o terra é 0. Uma linha .options rshunt=1e12 põe um teraohm de cada nó ao terra, então um nó deixado pendurado por um componente omitido não pode impedir o ngspice de resolver.

Importar

O importador lê o mesmo conjunto de volta, de um arquivo do Mokxi ou de um deck de livro-texto:

  • R, C, L com os sufixos de escala do SPICE (4.7k, 100n, 10meg);
  • V sources: a DC source to ground becomes a supply (vcc), a floating one a bench supply, SIN and PULSE a signal generator, a zero-volt source a multimeter on its current range, and a source with an AC magnitude a generator you can drive from Frequency response;
  • D, Q e M com seus cards .model;
  • instâncias X dos subcircuitos de amplificador operacional do próprio Mokxi, com seus números;
  • .tran, cujo TMAX vira o passo máximo do transitório.

Um card de modelo do Mokxi volta como o mesmo modelo de componente. Um card de qualquer outro lugar é casado por nome quando nomeia um dos modelos do Mokxi e, caso contrário, vira o componente mais próximo: um card NPN vira um 2N2222 com o Bf do card como seu beta, e um card NMOS um 2N7000 com seu Vto, Kp W / L e Lambda. Um card de diodo que não é do Mokxi vira o diodo padrão, e seus parâmetros não são carregados.

Nada é descartado sem aviso. Um elemento ou instrução que o importador não lê é nomeado: uma fonte de corrente (o Mokxi não tem componente de fonte de corrente), uma fonte controlada (E, F, G, H, B), uma chave, um subcircuito que não é do próprio Mokxi, .param, .include, e um valor que ele não consegue ler. Eles são listados no painel Serial, e a nota sobre o canvas tem um botão What que os lista por completo.

The layout. A netlist has no picture, so the importer draws a first one: the sources in a column on the left, every other part in a column by how many parts stand between it and a source, a ground symbol under every pin that goes to ground, and the wires routed by Organizar fios. É um ponto de partida para mover as coisas, não um esquemático pronto.

Ida e volta

Exportar, importar e exportar de novo dá a mesma netlist: os mesmos elementos, os mesmos valores e cartões, ligados do mesmo jeito. O que muda é a imagem, os nomes dos componentes onde um deck os numerou, e tudo o que nunca esteve no arquivo: instrumentos, placas e a janela de um osciloscópio.