Mokxi simula un circuito con tres motores, y esta página es el contrato que cada uno cumple.
- El kernel digital. Un kernel basado en eventos ejecuta cada microcontrolador, chip lógico y red digital. El voltaje de una red proviene de los controladores que están en ella, cada uno un voltaje detrás de una impedancia de fuente, y su nivel lógico proviene del más fuerte (sección 6). Esto es lo que permite que unos cientos de componentes y un núcleo de CPU corran en tiempo real en una pestaña del navegador.
- Islas analógicas. Un capacitor, un inductor, un amplificador operacional, un generador de señales, un diodo o un transistor lleva las redes que toca hacia una isla, y la isla se resuelve como una sola matriz mediante análisis nodal modificado, con modelos de dispositivo detrás de los semiconductores: diodos de Shockley, transistores de Gummel-Poon y MOSFET de nivel 1, cada uno con capacitancia de unión, resueltos por Newton-Raphson (secciones 6a y 6b). En el lienzo puedes leer el punto de operación en DC, hacer un barrido de un valor y graficar una respuesta en frecuencia (sección 7).
- El ejecutor de decks de SPICE. Ejecutar un deck de SPICE, en el menú del editor, corre una netlist de SPICE en su propio motor:
.op,.tran,.ac,.dccon barridos anidados,.tf,.noisey.meas, con subcircuitos, parámetros,.include, BJTs Gummel-Poon, MOSFET de niveles 1 a 3, JFET, fuentes de comportamiento y.temp. Se verifica contra ngspice en 42 circuitos de referencia, cada uno dentro de una tolerancia declarada (sección 7e).
Lo que cada uno no hace, sin rodeos:
- El lienzo en vivo no tiene análisis de ruido, temperatura ni distorsión, y tampoco función de transferencia; cada unión en él está a 27 C. Su amplificador operacional es un macromodelo de un solo polo con un producto de ganancia por ancho de banda, una velocidad de respuesta (slew rate), margen de voltaje, un desplazamiento (offset) y un límite de corriente, pero sin segundo polo.
- El ejecutor de decks de SPICE no corre modelos MOSFET BSIM, líneas de transmisión con pérdidas, dispositivos XSPICE, ni los análisis
.four,.sens,.pzy.disto, y lo indica, línea por línea, cuando un deck usa uno. No hay análisis de Monte Carlo ni biblioteca de modelos de fabricantes. - Nada tiene una potencia nominal. Un componente nunca se quema, una fuente nunca cae y un pin no tiene límite de corriente, así que un circuito que funciona aquí todavía puede fallar en el banco de trabajo (cómo se modelan los componentes).
El contrato
El resto de esta página es la frontera entre el simulador en Rust (crates: sim-kernel, parts, analog, spice, sim-wasm) y la interfaz en TypeScript (web/). Ambos lados se compilan contra este archivo. Cámbialo solo editando primero este archivo.
1. Netlist JSON (UI -> simulador)
La interfaz es dueña del diagrama (posiciones, cables, protoboards). Antes de iniciar una simulación, aplana el diagrama en un netlist: las tiras de la protoboard y los cables se fusionan con union-find en redes. Las protoboards nunca llegan al simulador.
{
"version": 1,
"parts": [
{ "id": "led1", "type": "led", "props": { "color": "red" } },
{ "id": "r1", "type": "resistor", "props": { "value": 220 } },
{ "id": "vcc1", "type": "vcc", "props": { "voltage": 5 } },
{ "id": "gnd1", "type": "gnd" }
],
"nets": [
["vcc1:VCC", "r1:1"],
["r1:2", "led1:A"],
["led1:C", "gnd1:GND"]
]
}
- El orden de
parts[i]define elpartIndexque usanprobes()ypoke(). - El orden de
nets[j]define elnetIndexque usannetLevels()ynetVoltages(). - Una referencia de pin es
"<partId>:<pinName>". Los nombres de pin vienen del catálogo. Un tipo de componente desconocido, un pin desconocido o un pin en dos redes son un error encreate. - Las propiedades no especificadas toman el valor predeterminado del catálogo. Las propiedades desconocidas son un error.
- Una red puede contener un solo pin. La interfaz emite una cuando un pin queda solo en una tira de protoboard (un nodo real, necesario para los interruptores); el simulador la acepta.
2. Superficie WASM (crates/sim-wasm, wasm-bindgen, --target web)
Rust usa snake_case; exporta con js_name para que TypeScript vea exactamente esto:
export class Sim {
static create(netlistJson: string): Sim; // throws Error(message) on a bad netlist
runForNs(ns: number): number; // advance simulated time by ns (a duration, not an absolute target); 0 = ok, 1 = oscillation (see lastError)
lastError(): string;
nowNs(): number;
probes(): Float32Array; // one f32 per part, in parts[] order; meaning is per part type (catalog "probe")
netLevels(): Uint8Array; // one u8 per net: 0 Low, 1 High, 2 Unknown, 3 Floating
netVoltages(): Float32Array; // one f32 per net, NaN when floating
netEdges(): Uint32Array; // one u32 per net: changes between low and high since the last call, which resets them
poke(partIndex: number, code: number): number; // external stimulus; code meaning is per part type; 0 = ok, 1 = oscillation
stats(): string; // JSON: { events, dispatches, parts, nets, memoryBytes }
loadProgram(partIndex: number, data: Uint8Array): string; // program image for a part (catalog "program"); "" = ok, else the reason
writeHost(partIndex: number, data: Uint8Array): number; // host -> part bytes (catalog "host"); 0 = ok, 1 = oscillation
readHost(partIndex: number): Uint8Array; // part -> host bytes since the last call; empty when the part has no channel
operatingPoint(): string; // JSON, see section 7a; runs no time
sweep(specJson: string): string; // JSON in, JSON out, see section 7b; runs no time on the circuit it is called on
setMaxStepNs(ns: number, fixed: boolean): void; // section 7c; 0 or less clears it
acSweep(specJson: string): string; // section 7d; the small-signal frequency response
stepLimitNs(): Float64Array; // [dtMinNs, dtMaxNs], empty when the circuit has no analog island
takeUnsettled(): string; // JSON [{ timeNs, deltaCycles, nets }]: loops cut short since the last call, see below
free(): void;
}
export function catalog(): string; // JSON, see section 3
export function version(): string;
Un bucle que no se estabiliza no detiene la ejecución. Cuando un instante de tiempo simulado necesita más de 1000 ciclos delta (componentes que se pasan una red de un lado a otro en tiempo cero, normalmente dos componentes cada uno con dos patas en una misma fila de la protoboard), el motor corta el bucle tal como está: las redes que siguen cambiando se resuelven una última vez y se quedan así, el tiempo avanza, y cada llamada sigue devolviendo 0. El instante se reporta una vez por bucle por ejecución a través de takeUnsettled(), donde nets son índices en nets[]; el editor lo convierte en una línea del monitor serie y en un hallazgo del Doctor de Circuitos (web/src/ui/unsettled-watch.ts). Después de 16 de estos instantes en una ejecución, cada uno adicional se corta a 200 ciclos delta, de modo que un bucle que se dispara en cada flanco de un PWM rápido no puede congelar la página. Los códigos 1 = oscillation anteriores se conservan para los casos de índice incorrecto y para un motor anterior a esto.
Compilación: wasm-pack build --target web --release --out-dir ../../web/src/sim/wasm --out-name sim crates/sim-wasm (las opciones van antes de la ruta del crate). El resultado se sube a git para que la interfaz se compile sin Rust.
3. JSON de catálogo (simulador -> interfaz)
[
{
"type": "led",
"pins": [ { "name": "A", "dir": "inout" }, { "name": "C", "dir": "inout" } ],
"props": [ { "name": "color", "kind": "string", "default": "red", "options": ["red", "green", "blue", "yellow", "white"] } ],
"probe": "brightness 0..1",
"poke": null,
"program": null,
"host": null
}
]
program indica qué recibe loadProgram para este componente ("elf32 riscv32imc" para una placa), o null. host indica qué transporta el canal de bytes del host ("utf-8 bytes on UART0"), o null. Un componente con canal de host es con el que habla el monitor serie.
dir es in, out o inout. kind es number, string o bool. options es opcional; cuando está presente la interfaz muestra un select. Una propiedad number también lleva el rango que acepta, min y max, con "minOpen": true cuando el propio min se rechaza y "integer": true para solo números enteros (crates/parts/src/ranges.rs, a lo más 1e15 en cualquier sentido); crear el componente rechaza un valor fuera de ese rango, y el panel de propiedades lo detiene al escribirlo. Un visual de componente de la interfaz (web/src/parts/<type>.ts) debe declarar una posición de pin para cada pin del catálogo y nada más; una prueba en web/ verifica esto contra web/src/sim/wasm/catalog.json, que el paso de compilación de wasm también escribe.
4. Tipos de componente congelados para la estructura inicial de la interfaz de la Fase 1
El lado del núcleo entrega estos primero para que la interfaz tenga algo que manejar. Llegan más componentes desde los agentes de componentes y solo agregan entradas.
| tipo | pines | props | sonda | escritura |
|---|---|---|---|---|
led |
A, C |
color cadena (red) |
brillo 0..1 | ninguno |
resistor |
1, 2 |
value ohms (1000) |
corriente en amperes | ninguno |
pushbutton |
1a, 1b, 2a, 2b (1a-1b en corto, 2a-2b en corto, presionar une los pares) |
bounce cadena ("typical", uno de none/typical/worst), ver 4a |
1 presionado, 0 liberado | 1 = presionar, 0 = liberar |
vcc |
VCC |
voltage (5) |
voltaje | ninguno |
gnd |
GND |
ninguno | 0 | ninguno |
clock |
OUT |
hz (1) |
1 cuando está en alto, 0 cuando está en bajo | ninguno |
4a. Conjunto de componentes de la Fase 1 (agregados después de la estructura inicial, solo se añaden, nunca se quitan)
Unidades: resistor.value ohms, capacitor.value microfarads. Los chips listan sus pines en orden de número de pin del paquete. Una sonda que transporta más de un bit empaqueta una máscara de bits en el f32.
| tipo | pines | props | sonda | escritura |
|---|---|---|---|---|
capacitor |
1, 2 |
value número (10) |
voltaje a través de él, V(1) - V(2) | ninguno |
gate |
A, B, Y |
function cadena ("and", uno de and/or/nand/nor/xor/xnor) |
1 cuando Y está en alto, 0 cuando está en bajo, 0.5 cuando es desconocido | ninguno |
not |
A, Y |
ninguno | 1 cuando Y está en alto, 0 cuando está en bajo, 0.5 cuando es desconocido | ninguno |
bitin |
Q |
label cadena ("A"); value (0, 0 o 1) |
1 cuando Q está en alto, 0 cuando está en bajo | 0 lleva Q a bajo, 1 a alto; conduce a través de una pull, así que cualquier salida en la red gana |
bitout |
A |
label cadena ("Y"); color cadena ("green", uno de green/red/amber/blue) |
1 alto, 0 bajo, 0.5 desconocido o sin conducir | ninguno |
bytein |
D0..D7 |
label cadena ("A"); value (0, 0 a 255); width (8, 1 a 8) |
el valor en D0..D(width-1); los pines por encima del ancho están en alta impedancia | 0..255 fija el valor (enmascarado al ancho); 2^32 cuenta una unidad hacia arriba |
byteout |
D0..D7 |
label cadena ("S"); width (8, 1 a 8) |
el valor, los bits sin conducir como 0; -1 cuando un bit conducido es desconocido | ninguno |
bitconst |
Q |
value (0, 0 o 1) |
el valor que conduce | ninguno; conduce en push-pull, como la salida de una compuerta |
stepclock |
CLK |
hz (2); mode cadena ("step", uno de step/run) |
el nivel (0 o 1), más 2 durante la ejecución libre | 0 lo detiene (modo de pasos), 1 lo ejecuta libre, 2 da un tic (un flanco de subida y luego uno de bajada medio periodo después) mientras está detenido |
progrom |
A0..A7 de entrada; C0..C7, K0..K7 de salida |
cadena program (ensamblador de Kestrel, crates/parts/src/kestrel.rs) |
la dirección que se está leyendo; -1 mientras se desconoce | ninguna; la palabra en la dirección controla C (byte alto) y K (byte bajo) después de 10 ns |
terminal |
D0..D7, WE, CLK |
cadena mode ("text", uno de text/numbers) |
bytes escritos desde el encendido | ninguna; canal del host: cada byte se escribe en un flanco de subida de CLK con WE en alto |
sevenseg |
E, D, COM1, C, DP, G, F, COM2, A, B |
cadena common ("cathode", uno de cathode/anode); cadena color ("red", uno de red/green/blue/yellow/white) |
segmentos encendidos como máscara de bits 0..255: bit 0 A, 1 B, 2 C, 3 D, 4 E, 5 F, 6 G, 7 DP | ninguno |
slideswitch |
1, 2, 3 |
ninguno | 0 = común en el pin 1, 1 = común en el pin 3 | 0 = conectar 2 con 1, 1 = conectar 2 con 3 |
buzzer |
1, 2 |
ninguno | 1 cuando suena, 0 cuando está en silencio | ninguno |
74hc00 |
1A, 1B, 1Y, 2A, 2B, 2Y, GND, 3Y, 3A, 3B, 4Y, 4A, 4B, VCC |
ninguno | salidas como máscara de bits, bit 0 = 1Y .. bit 3 = 4Y; 0 sin alimentación | ninguno |
74hc08 |
mismo pinout que 74hc00 |
ninguno | el mismo | ninguno |
74hc32 |
mismo pinout que 74hc00 |
ninguno | el mismo | ninguno |
74hc86 |
mismo pinout que 74hc00 |
ninguno | el mismo | ninguno |
74hc04 |
1A, 1Y, 2A, 2Y, 3A, 3Y, GND, 4Y, 4A, 5Y, 5A, 6Y, 6A, VCC |
ninguno | salidas como máscara de bits, bit 0 = 1Y .. bit 5 = 6Y; 0 sin alimentación | ninguno |
74hc74 |
1RD, 1D, 1CP, 1SD, 1Q, 1QN, GND, 2QN, 2Q, 2SD, 2CP, 2D, 2RD, VCC |
ninguno | salidas Q como máscara de bits, bit 0 = 1Q, bit 1 = 2Q; 0 sin alimentación o X | ninguno |
74hc595 |
Q1, Q2, Q3, Q4, Q5, Q6, Q7, GND, Q7S, MR, SHCP, STCP, OE, DS, Q0, VCC |
ninguno | byte en Q0..Q7, bit 0 = Q0; 0 cuando OE está en alto o sin alimentación | ninguno |
ne555 |
GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC |
ninguno | 1 cuando OUT está en alto, 0 cuando está en bajo o sin alimentación | ninguno |
tlc555 |
GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC |
ninguno | 1 cuando OUT está en alto, 0 cuando está en bajo o sin alimentación | ninguno |
ne556 |
1DIS, 1THR, 1CTRL, 1RESET, 1OUT, 1TRIG, GND, 2TRIG, 2OUT, 2RESET, 2CTRL, 2THR, 2DIS, VCC |
ninguno | bit 0 = 1OUT, bit 1 = 2OUT en alto | ninguno |
inductor |
1, 2 |
value milihenrios (100) |
corriente en amperes, positiva del pin 1 al pin 2 | ninguno |
opamp |
IN+, IN-, OUT, V+, GND |
gain (100000) |
voltaje de salida respecto al pin GND | ninguno |
lm358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolts (0) |
bit 0 = 1OUT, bit 1 = 2OUT por encima del punto medio de alimentación | ninguno |
lm324 |
1OUT, 1IN-, 1IN+, VCC, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, GND, 4IN+, 4IN-, 4OUT |
offset milivolts (0) |
bit 0 = 1OUT .. bit 3 = 4OUT por encima del punto medio de alimentación | ninguno |
tl072 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolts (0) |
bit 0 = 1OUT, bit 1 = 2OUT por encima del punto medio de alimentación | ninguno |
lm741 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, NC |
offset milivolts (0) |
1 mientras OUT está por encima del punto medio de alimentación | ninguno |
ne5532 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolts (0) |
bit 0 = 1OUT, bit 1 = 2OUT por encima del punto medio de alimentación | ninguno |
lm833 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolts (0) |
bit 0 = 1OUT, bit 1 = 2OUT por encima del punto medio de alimentación | ninguno |
opa2134 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolts (0) |
bit 0 = 1OUT, bit 1 = 2OUT por encima del punto medio de alimentación | ninguno |
mcp6002 |
VOUTA, VINA-, VINA+, VSS, VINB+, VINB-, VOUTB, VDD |
offset milivolts (0) |
bit 0 = VOUTA, bit 1 = VOUTB por encima del punto medio de alimentación | ninguno |
mcp6004 |
VOUTA, VINA-, VINA+, VDD, VINB+, VINB-, VOUTB, VOUTC, VINC-, VINC+, VSS, VIND+, VIND-, VOUTD |
offset milivolts (0) |
bit 0 = VOUTA .. bit 3 = VOUTD por encima del punto medio de alimentación | ninguno |
lmv358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolts (0) |
bit 0 = 1OUT, bit 1 = 2OUT por encima del punto medio de alimentación | ninguno |
tl081 |
NULL1, IN-, IN+, VCC-, NULL2, OUT, VCC+, NC |
offset milivolts (0) |
1 mientras OUT está por encima del punto medio de alimentación | ninguno |
tl084 |
1OUT, 1IN-, 1IN+, VCC+, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, VCC-, 4IN+, 4IN-, 4OUT |
offset milivolts (0) |
bit 0 = 1OUT .. bit 3 = 4OUT por encima del punto medio de alimentación | ninguno |
op07 |
NULL1, IN-, IN+, V-, NC, OUT, V+, NULL2 |
offset milivolts (0) |
1 mientras OUT está por encima del punto medio de alimentación | ninguno |
ca3140 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, STROBE |
offset milivolts (0) |
1 mientras OUT está por encima del punto medio de alimentación | ninguno |
lm393 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolts (0) |
bit 0 = 1OUT, bit 1 = 2OUT liberado (IN+ por encima de IN-) | ninguno |
lm339 |
1OUT, 2OUT, VCC, 2IN-, 2IN+, 1IN-, 1IN+, 3IN-, 3IN+, 4IN-, 4IN+, GND, 4OUT, 3OUT |
offset milivolts (0) |
bit 0 = 1OUT .. bit 3 = 4OUT liberado | ninguno |
lm311 |
EMIT, IN+, IN-, VCC-, BAL, STRB, COL, VCC+ |
offset milivolts (0) |
1 mientras COL esté liberado (o con strobe) | ninguno |
uln2003a |
1B, 2B, 3B, 4B, 5B, 6B, 7B, E, COM, 7C, 6C, 5C, 4C, 3C, 2C, 1C |
ninguno | bits 0..6 = entradas 1B..7B al menos 1.4 V por encima de E | ninguno |
uln2803a |
1B, 2B, 3B, 4B, 5B, 6B, 7B, 8B, GND, COM, 8C, 7C, 6C, 5C, 4C, 3C, 2C, 1C |
ninguno | bits 0..7 = entradas 1B..8B al menos 1.4 V por encima de GND | ninguno |
uln2003board |
IN1, IN2, IN3, IN4, VCC, GND, OUT1, OUT2, OUT3, OUT4 |
ninguno | bits 0..3 = LEDs A..D: OUT1..OUT4 a 1.7 V o más por debajo de VCC | ninguno |
generator |
OUT, GND |
cadena wave ("sine", una de sine/square/triangle); frequency Hz (1000); amplitude voltios pico (2.5); offset voltios (2.5); duty por ciento (50, solo square) |
voltaje de salida respecto al pin GND | ninguno |
funcgen |
OUT, GND |
cadena wave ("sine", una de sine/square/triangle/sawtooth); frequency Hz (1000); amplitude voltios pico (2.5); offset voltios (2.5); duty por ciento (50, solo square) |
voltaje de salida por encima del pin GND, en las terminales | ninguno |
scope |
CH1, CH2, GND |
window segundos (0.02, de 0.0001 a 10); volts escala completa (5) |
voltios del canal 1 por encima del clip de tierra | (1 << 32) | ventana en microsegundos, o (2 << 32) | escala completa en milivoltios |
multimeter |
V, A, COM |
cadena mode ("dcv", una de dcv/acv/dca/aca/ohms/continuity) |
la lectura: voltios, amperios u ohmios según el modo, NaN cuando está fuera de rango o abierto | ninguno |
lm35 |
VS, VOUT, GND |
número temperature (22.5) |
temperatura en grados Celsius | décimas de grado más 1000 |
aht20 |
VCC, GND, SCL, SDA (I2C en 0x38) |
número temperature (22); número humidity (45) |
temperatura en grados Celsius | (1 << 32) | (décimas + 1000) temperatura, (2 << 32) | décimas humedad |
bh1750 |
VCC, GND, SCL, SDA, ADDR (I2C en 0x23, 0x5C con ADDR en alto) |
ninguno | la luz en lux | la luz en lux, de 0 a 100000 |
a3144 |
VCC, GND, OUT (colector abierto) |
número operate (210 gauss); número hysteresis (55) |
código del imán, más 100000 mientras OUT está activo | décimas de mm, de 0 a 400, más 10000 para el polo norte |
ss49e |
VCC, GND, OUT |
ninguno | el campo en el sensor en gauss, sur positivo | décimas de mm, de 0 a 400 (400 es sin imán), más 10000 para el polo norte |
photointerrupter |
SIG, VCC, GND (más SHAFT con wheel configurado) |
número slots (20), cadena wheel ("": el id del dcmotor o encmotor con el que gira la rueda, vacío para el deslizador) |
código de la rueda (RPM, más 10000 con la tarjeta insertada), más 100000 mientras SIG está en alto, más 1000000 con la rueda en un motor | RPM de 0 a 600 (se ignora en un motor), más 10000 con la tarjeta insertada |
linearray |
GND, VCC, S1 a S5 |
número threshold (0.5) |
el código de línea, más 1000 x los canales sobre negro como bits (el bit 0 es S1) | 100 + mm desde el sensor central (40 a 160); 1 una barra negra atravesada; 0 sin línea |
fc51 |
OUT, GND, VCC |
número threshold (0.5) |
código del obstáculo (cm, 80 es ninguno, más 10000 si es negro), más 100000 mientras la lámpara está encendida | cm de 1 a 80, más 10000 si el objeto es negro |
thermalprinter |
VH, GND, RX, TX, DTR |
baud número (19200); paper booleano (true) |
el número de líneas impresas | el papel: 1 cargado, 0 agotado |
fingerprint |
VCC, GND, TX, RX |
baud número (57600); enrolled número (2); capacity número (162); password número (0) |
el dedo sobre el vidrio, más 100 cuando una búsqueda lo encontró, 200 cuando no | el dedo, de 1 a 9, o 0 para levantarlo |
ds1302 |
VCC, GND, CLK, DAT, RST |
start texto ("2026-01-01 12:00:00"); halted booleano (false) |
segundos desde la medianoche, más 100000 mientras está detenido | (1 << 32) o segundos desde la medianoche, o (2 << 32) o días desde el 2000-01-01 |
amg8833 |
VIN, GND, SCL, SDA, INT (I2C en 0x69) |
address número (105); background número (22); spot número (34); pixel número (27) |
el píxel más caliente en C | (1 << 32) fondo, (2 << 32) punto, décimas + 1000; (3 << 32) el píxel del punto, 64 si no hay |
mlx90614 |
VIN, GND, SCL, SDA (SMBus en 0x5A) |
object número (36.6); ambient número (22) |
la temperatura del objeto en C | (1 << 32) objeto o (2 << 32) ambiente, más décimas de grado + 1000 |
mpr121 |
VIN, GND, SCL, SDA, IRQ, ADDR (I2C en 0x5A) |
address número (90) |
estado del tacto: electrodo 0 en el bit 0 | los electrodos sobre los que hay un dedo, como máscara |
gp2y0a21 |
VO, GND, VCC |
distance número (30) |
la distancia en centímetros | la distancia en centímetros, de 1 a 150 |
mg996r |
GND, VCC, PWM |
min_pulse número (544); max_pulse número (2400); range número (180) |
ángulo del brazo en grados, de 0 al rango | ninguno |
yfs201 |
VCC, GND, SIG |
flow número (0) |
el flujo en litros por minuto | el flujo en décimas de litro por minuto, de 0 a 300 |
adxl335 |
VCC, X, Y, Z, GND |
tilt_x número (0); tilt_y número (0) |
la inclinación en X en grados | (1 << 32) o (2 << 32), más la inclinación en X o Y + 90 |
pulsesensor |
S, VCC, GND |
bpm número (72); swing número (0.8) |
el ritmo cardíaco en pulsaciones por minuto (0 sin dedo), más 1000 mientras pasa el pico principal | el ritmo cardíaco en pulsaciones por minuto, de 30 a 220, o 0 si no hay dedo |
coinacceptor |
DC12V, COIN, GND, COUNTER |
pulse número (50); nc booleano (false) |
pulsos enviados desde el encendido, más 100000 mientras COIN está activo | una moneda que vale esta cantidad de pulsos, de 1 a 50 |
waterpump |
V+, V- |
voltage número (6); flow número (120); resistance número (4); inertia número (50); back_emf número (0.85) |
el caudal en litros por hora | ninguno |
fanmodule |
INA, INB, VCC, GND |
voltage número (5); inertia número (250) |
velocidad de la hélice en porcentaje del máximo, negativa en reversa | ninguno |
laser |
S, VCC, GND |
resistor número (100) |
el brillo percibido del haz, de 0 a 1 | ninguno |
trafficlight |
R, Y, G, GND |
resistor número (220) |
LEDs encendidos como máscara de bits: bit 0 rojo, bit 1 amarillo, bit 2 verde | ninguno |
sw420 |
VCC, GND, DO |
número threshold (0.5) |
0 quieto, 1 vibrando, 2 golpecitos, más 100000 mientras la lámpara está encendida (DO en bajo) | 0 quieto, 1 vibrando hasta el siguiente toque, 2 un golpecito |
mq3 a mq137 (mq3, mq4, mq5, mq6, mq7, mq8, mq9, mq131, mq135, mq137) |
VCC, GND, DO, AO |
gas texto (según el sensor, de su gráfica); r0 ohms; rl ohms; threshold número; warmup segundos (20) |
el gas en la unidad del sensor (ppm; centésimas de mg/L en el MQ-3; ppb en el MQ-131), más 100000 mientras la lámpara DO está encendida, más 200000 durante el calentamiento | el gas en esa unidad, de 0 hasta el tope de la gráfica |
ky037 |
AO, GND, VCC, DO |
threshold número (0.505); sensitivity dBV/Pa (-42) |
como ky038 |
como ky038 |
ky004, ky017, ky021, ky031 |
S, VCC, GND |
resistor texto ("pull-up" o "pull-down"); settle ms (ky004 3, ky017 0, ky021 0.5); ky021 close mm (15), release (0.8) |
ky004 1 presionado; ky017 1 inclinado; ky021 los mm del imán; ky031 0 quieto, 1 vibrando, 2 golpecitos | los mismos códigos |
sw18010p |
1, 2 |
ninguno | 0 quieto, 1 vibrando, 2 golpecitos | 0 quieto, 1 vibrando hasta el siguiente toque, 2 un golpecito |
ky024, ky025, ky028 |
AO, GND, VCC, DO |
threshold número (0.6, 0.5, 0.45); ky025 close mm (15), release (0.8); ky028 beta K (3950) |
el código del toque, más 100000 mientras la lámpara DO está encendida (DO en alto) | ky024 décimas de mm, más 10000 para el norte; ky025 los mm del imán, de 0 a 60; ky028 décimas de grado más 1000 |
ky035 |
VCC, GND, S |
ninguno | como ss49e |
como ss49e |
temt6000 |
SIG, GND, VCC |
sensitivity uA por lux (0.5) |
la luz en lux | lux, de 0 a 2000 |
rotation |
GND, S, VCC |
value ohms (10000); taper texto |
como potentiometer |
como potentiometer |
steam |
S, VCC, GND |
full fracción (0.66) |
la parte mojada del peine, en porcentaje | porcentaje, de 0 a 100 |
e18d80nk |
VCC, GND, OUT |
range cm (40, de 3 a 80); pullup indicador (false) |
los cm del objetivo (100 es nada), más 100000 mientras detecta | cm, de 1 a 100 |
ttp223 |
SIG, VCC, GND |
toggle booleano (false); activelow booleano (false) |
bit 0 dedo sobre el pad, bit 1 SIG en alto | 1 dedo puesto, 0 quitado |
battery |
V+, V- |
kind texto ("9v", uno de 9v/aa2/aa3/aa4/18650/18650x2); charge número (100) |
voltios entre las terminales | ninguno |
solar |
+, - |
ninguno | voltios a través del panel | vatios por metro cuadrado, de 0 a 1200 (1000 es sol pleno) |
tp4056 |
IN+, IN-, BAT+, BAT- |
ninguno | corriente de carga en mA, más 10000 mientras la lámpara de espera está encendida | ninguno |
regulator |
IN, GND, OUT |
cadena model ("7805", una de 7805/AMS1117-3.3/MCP1700-3.3) |
OUT por encima de GND, en voltios | ninguno |
tb6612 |
PWMA, AIN2, AIN1, STBY, BIN1, BIN2, PWMB, GND1, VM, VCC, GND2, AO1, AO2, BO2, BO1, GND3 |
ninguno | modos de canal, A en los bits 0-1 y B en los 2-3: 0 apagado, 1 horario, 2 antihorario, 3 freno | ninguno |
l9110 |
BIA, BIB, GND, VCC, AIA, AIB, OA1, OA2, OB1, OB2 |
ninguno | accionamiento del motor, A en los bits 0-1 y B en los 2-3: 0 apagado, 1 adelante, 2 atrás, 3 freno | ninguno |
encmotor |
M1, M2, VCC, GND, A, B |
la voltage del motor simple (6), rpm (200), resistance (6), inertia (120), back_emf (0.85), más el número ppr (11) y el número ratio (30) |
velocidad de la rueda en rpm, con signo | ninguno |
balancebot |
VCC, GND, SCL, SDA, STBY, AIN1, AIN2, PWMA, BIN1, BIN2, PWMB, LA, LB, RA, RB |
mass (800 g), com (70 mm), inertia (17 kg cm^2), height (160 mm), wheel (68 mm), wheel_mass (40 g), voltage (7.4), battery (7.4), rpm (280), stall (4 kg cm), rotor (4 g cm^2), ratio (30), ppr (13), friction (20 mN m), damping (0.5 mN m s), imu (120 mm), noise (1), gyro_bias (0), tilt (2), release (1000 ms) |
inclinación en grados, positiva hacia adelante | 1 lo pone de pie, 3 lo suelta, (2 << 32) | (empuje en mN s + 1000000) |
clawcabinet |
XA1, XA2, XB1, XB2, YA1, YA2, YB1, YB2, VCC, GND, W+, W-, CLAW, XHOME, YHOME, BEAM |
width (200 mm), depth (160 mm), drop (90 mm), start_x (120 mm), start_y (80 mm), prizes (3), reach (20 mm), grip (130 grados), current (1.7 A), max_steps (1000) |
la profundidad de la garra por debajo del borde superior en mm; todo el estado en el canal de instrumentación | 1 vuelve a poner los premios |
clawcabinetdc |
X+, X-, Y+, Y-, VCC, GND, W+, W-, CLAW, XHOME, YHOME, BEAM |
como clawcabinet, con la voltage (6) y las rpm (200) de los motores con engranajes en lugar de current y max_steps |
como clawcabinet |
1 vuelve a poner los premios |
vendingcabinet |
M1, M2, M3, M4, VCC, GND, DROP |
stock (3 por espiral), rpm (110) |
los bocadillos en el depósito; todo el estado en el canal de instrumentación | 1 rellena cada espiral y vacía el depósito |
pinballcabinet |
FL, FR, VCC, GND, KICK1, KICK2, TA, TB, TC, B1, B2, DRAIN, LAUNCH |
flip_speed (1200 grados por segundo) |
la altura de la pelota sobre la mesa en mm, -1 mientras regresa; todo el estado en el canal de instrumentación | 1 pone la pelota en el émbolo; 0x100 + n mantiene presionado el interruptor n (TA, TB, TC, B1, B2, el haz del desagüe, el émbolo) y 0x200 + n lo suelta |
barriercabinet |
VCC, GND, TRIG, ECHO, R, Y, G, ARM, V+ |
angle (0 grados) |
el ángulo del brazo; todo el estado en el canal de instrumentación | 1 envía un auto por el carril |
sortercabinet |
VCC, GND, SCL, SDA, SERVO |
candies (12), period (2000 ms) |
los dulces en los compartimientos; todo el estado en el canal de instrumentación | 1 rellena la tolva y vacía los compartimientos; 0x1000000 + 0xRRGGBB hace que el siguiente dulce sea de ese color |
soapcabinet |
VCC, GND, OUT, M+, M- |
threshold (0.5), bottle (30 ml), ml_per_turn (0.5), voltage (6), rpm (200) |
el jabón bombeado desde que se llenó el frasco, en ml; todo el estado en el canal de instrumentación | una mano a cm bajo el dispensador, de 1 a 80 (80 nadie), más 10000 por un guante negro; 1000000 llena el frasco |
La wheel de un fotointerruptor montada en un motor se une a él mediante la netlist (web/src/sim/wheel-mount.ts): los pines SHAFT de ambos componentes en una misma red, y shaft: true en el dcmotor o encmotor, una marca interna que el catálogo omite (PropInfo::internal) que le da ese pin al motor. Lleva la velocidad del eje de salida, sin signo, a 1 mV por rpm.
Los chips reciben energía cuando el voltaje entre sus pines VCC y GND es de al menos 2 V (4.5 V para el NE555); sin energía, todas las salidas quedan en alta impedancia.
Unidades: resistor.value ohms, capacitor.value microfaradios, inductor.value milihenries.
Canal de muestras del osciloscopio
El osciloscopio lleva sus muestras por el mismo camino que recorren los píxeles de una pantalla: readHost, recolectadas una vez por cuadro, con un catálogo host de null porque ese campo significa "un canal de texto al que habla el monitor serie" y estas son muestras.
readHost(scopeIndex) devuelve todo lo muestreado desde la última llamada, como un mensaje little-endian, o nada cuando no se ha tomado ninguna muestra:
byte 0 magic, 0x53
byte 1 channels, always 2
u16 2..4 number of samples that follow
f32 4..8 seconds per sample (the window divided by 256)
f32 8..12 seconds at the first sample
u16 12..14 flags: bit 0 = the time base moved, so throw away every earlier
sample; bit 1 = samples were dropped before this message
u16 14..16 reserved, zero
f32 16..20 full-scale volts the part is set to
then, per sample: f32 channel 1 volts, f32 channel 2 volts
Una sonda conectada a nada lee NaN. El componente guarda 1024 muestras para un host que dejó de recolectar y luego descarta la más antigua, marcando la bandera de descartada.
La base de tiempo y la escala completa son propiedades, y también se pueden tocar, porque son las dos cosas que una persona cambia mientras observa una traza, y reconstruir la netlist para cambiar una reiniciaría la simulación. Un toque en la ventana surte efecto de inmediato: el componente borra lo que no ha enviado, marca la bandera de reinicio en su siguiente mensaje para que la interfaz descarte la pantalla que estaba dibujando, y sigue muestreando a la nueva tasa sin que el circuito lo note.
Los instrumentos del banco de trabajo
funcgen, scope y multimeter son los tres instrumentos que sueltas en el lienzo y conectas, y son componentes comunes: sin camino privilegiado hacia el motor, nada que el catálogo no describa.
funcgenesgeneratorcon diente de sierra y una impedancia de salida real: 50 ohms, estampada como el par de Norton (una fuente de corriente dev(t)/50con 50 ohms en paralelo) porque un componente no tiene nodos internos de donde colgar una resistencia en serie. Una carga se divide contra ella, que es lo primero que enseña un generador de banco.generatorsigue siendo ideal y continúa siendo el componente correcto para excitar un nodo y olvidarte de él.scopeson dos sondas de 1 Mohm y una pinza de tierra; se une a una isla, nunca crea una.multimeteres 10 Mohm entreVyCOMen los rangos de volts, una derivación de 1 ohm entreAyCOMen los rangos de corriente (ambos dejan pasar un Thevenin por el camino digital rápido y se estampan cuando una isla los alcanza) y, en ohms y continuidad, una corriente de prueba de 30 uA con 100 kohm en paralelo, que sí crea una isla. Integra sobre una apertura de 250 ms a 4 kHz y publica una lectura cuatro veces por segundo: la media en un rango de DC, el RMS verdadero de la parte de CA en un rango de CA y, en ohms, la resistencia que implica esa corriente de prueba,NaNpor encima de 1 Mohm. Por encima de un kilohertz aproximadamente, una lectura de CA queda submuestreada y marca de menos.
Rebote de contacto en el pushbutton
Un interruptor táctil real cierra, rebota y se asienta, así que pushbutton vibra en cada pulsación y en cada liberación. Su propiedad bounce elige el perfil:
bounce |
transiciones por pulsación o liberación | se asienta en |
|---|---|---|
none |
1 | de inmediato |
typical |
de 3 a 8 | de 1 a 5 ms |
worst |
hasta 20 | de 10 a 20 ms |
El valor predeterminado es typical: elige none cuando el botón no es el punto del circuito, y worst para mostrar por qué un sketch tiene que hacer antirrebote. Todo lo conectado al botón ve el vibrado como flancos normales (una entrada 74HC, un disparo de NE555, un GPIO de una placa), porque el botón excita sus redes igual que siempre lo hizo; nada más cambia en el contrato.
Cada ráfaga comienza con un flanco inmediato (el contacto sí cierra al presionar) y reproduce el resto como despertares en la rueda de temporización, el último cayendo exactamente en el tiempo de asentamiento. La cuenta es impar, así que una ráfaga siempre termina en el estado que se pidió. Un toque que llega a mitad de la ráfaga (se libera mientras aún vibra) cancela el resto e inicia una ráfaga nueva. Las duraciones de los huecos salen de un flujo aleatorio por componente, sembrado desde el índice del componente en la netlist, así que dos botones en un circuito vibran distinto, pulsaciones sucesivas difieren, y la misma netlist tocada de la misma forma produce los mismos flancos al picosegundo: una ejecución es reproducible.
Un componente visual puede declarar interaction: 'hold' (presionar toca 1, soltar toca 0) o 'toggle' (un clic toca 0 cuando la sonda está en al menos 0.5, si no, 1). El lienzo nunca nombra un tipo de componente.
Todo lo que la interfaz necesita para dibujar un componente está en web/. Todo lo que un componente necesita para comportarse está en crates/parts. Solo se encuentran en type, nombres de pines y props.
5. Bucle de ejecución (lado de la interfaz)
Sim.runForNs(ns) avanza el tiempo simulado en ns y regresa, con nowNs() reportando el total nuevo. La interfaz lo llama desde requestAnimationFrame, apuntando a tiempo simulado = tiempo real, con un presupuesto real por cuadro (digamos 12 ms); si el simulador se queda atrás, la interfaz muestra la razón de velocidad lograda en lugar de congelarse. El simulador corre en un Web Worker (web/src/sim/client.ts), así que la página se mantiene responsiva mientras lo hace.
probes(), netLevels() y netEdges() se leen una vez por cuadro, juntas, en la instantánea de la que pinta la interfaz. netEdges() está ahí porque un nivel leído una vez por cuadro solo dice dónde quedó cada red: un contacto que rebota produce veinte flancos en unos pocos milisegundos, bien dentro de un cuadro de 16 ms, y una lección que los pida tiene que poder contarlos. Un flanco es un cambio de nivel limpio (de bajo a desconocido a alto es uno; de bajo a flotante a bajo no es ninguno), y un cambio que se revierte dentro del mismo instante no se cuenta en absoluto. Leer las cuentas las reinicia, así que el bucle de cuadros es el único que llama. netVoltages() se lee en la misma pasada pero solo cuando algo en la página muestra volts: el lector Mostrar niveles (web/src/ui/levels.ts), apagado por defecto. Una instantánea que no los pidió lleva un arreglo vacío, así que un voltaje por red por cuadro no cuesta nada hasta que se lee.
6. Modelo eléctrico
Cada excitador en una red es un voltaje con una impedancia de fuente (Drive { voltage, impedance, level }). El voltaje de una red es la media ponderada por impedancia de sus excitadores (Millman). Una salida digital fuerte tiene unas decenas de ohms, una pull-up tiene el valor de su resistencia, alta impedancia es infinita. El level digital de una red viene del excitador de menor impedancia; si excitadores de igual impedancia no están de acuerdo, es Unknown; sin excitadores es Floating. Los componentes de dos terminales leen el equivalente Thevenin visto en un pin, sin contar su propia contribución, y excitan el otro pin en consecuencia.
Ese es el camino rápido, y es lo que toda red sin nada analógico sigue haciendo.
6a. Islas analógicas
Un componente cuyo comportamiento es una ecuación diferencial sobre varios nodos a la vez (un capacitor, un inductor, un amplificador operacional, un generador de señales) se declara analógico mediante la capacidad Component::analog, y el núcleo reúne toda red que toca en una isla resuelta como una sola matriz por crates/analog: análisis nodal modificado, una LU con pivoteo parcial, un punto de operación DC al encender con cada capacitor descargado y cada inductor en corriente cero, y un transitorio con modelos acompañantes trapezoidales y un paso elegido por error local de truncamiento.
Las dos mitades se encuentran en tres lugares y en ninguno más.
- Al entrar. Cada excitador en una red de isla que no pertenece a la isla se colapsa por Millman en un voltaje detrás de una resistencia y se estampa como una fuente Thevenin en ese nodo. Un pin digital es una fuente Thevenin; esa es toda la interfaz.
- Sale del sistema. La isla posee una ranura de controlador en cada una de sus redes, como cualquier otro pin, y escribe el equivalente Thevenin propio de la isla en ese nodo (la isla con el controlador de frontera de esa red eliminado), de modo que resolver ambos con la regla ordinaria de Millman reproduce exactamente el voltaje resuelto del nodo.
- Tiempo. La isla agenda su propio siguiente paso en la rueda de temporización. Una isla asentada sin ninguna fuente en movimiento no agenda nada, así que un circuito analógico inactivo cuesta lo mismo que uno digital inactivo.
Un componente con un umbral de entrada analógico (un comparador, los dos puntos de disparo de un 555) llama a Ctx::watch(pin, volts, hysteresis); la isla luego refina su paso hasta el cruce en lugar de pasarlo por encima, de modo que el tiempo de disparo queda correcto al microsegundo y no a la duración de un paso de integración. Fuera de una isla la llamada no cuesta nada y no cambia nada. Una entrada digital de un microcontrolador hace lo mismo mediante Ctx::read_input(pin, threshold), que vigila el pin al nivel de conmutación propio del chip y luego lo lee: cada placa lee sus pads de entrada de esta forma, de modo que un flanco analógico lento llega a un componente de 3.3 V y a uno de 5 V al voltaje al que cada uno conmutaría en realidad, y no al único LOGIC_THRESHOLD del kernel. Un pin de entrada no presenta carga alguna a la isla más allá de la pull-up o pull-down que su firmware habilite; la fuga submicroamperio de una entrada CMOS real no se modela.
Las islas avanzan a lo sumo cada 2 ms y al menos cada 100 ns, y mantienen el paso a una sexagésima cuarta parte de cualquier constante de tiempo que se esté moviendo más rápido, así que una traza muestreada entre pasos nunca va más atrás que eso. Una resistencia se une a una isla que la alcanza pero nunca crea una; una sonda de osciloscopio es de 1 Mohm hacia su pinza de tierra y hace lo mismo.
6b. Islas no lineales
Un componente con física de dispositivo dentro (un diodo, un LED, un transistor bipolar, un MOSFET) declara AnalogPart::devices junto con sus elementos y los nombra desde un Element::Device { nodes: [Node; 4], dev: u32 }, cuyo dev indexa la propia lista de dispositivos de ese componente. Element sigue siendo Copy; los dispositivos son Box<dyn Device> en la isla. El kernel desplaza los índices de dispositivos de cada componente a medida que fusiona los componentes en una isla y no sabe nada más sobre ellos: ningún nombre de dispositivo llega a sim-kernel, y la física vive por completo en crates/parts detrás de un trait definido en crates/analog.
Un Device hace tres cosas. Carga un modelo complementario (conductancias y fuentes de corriente equivalentes) a partir de los voltajes terminales en la iteración actual. Limita los voltajes que la última solución produjo antes de la siguiente carga, que para una unión pn es el pnjlim de SPICE y es la diferencia entre un diodo que converge y uno que desborda exp. Y reporta sus parámetros como un vector simple de números, para que Ctx::restamp_device(which, params) pueda mover un beta sin reconstruir la isla, exactamente como Ctx::restamp mueve una resistencia.
La solución es Newton-Raphson: cargar cada dispositivo, factorizar, resolver, comprobar cada incógnita contra reltol |x| + abstol (voltios en una fila de nodo, amperios en una fila de rama), limitar, repetir, hasta un tope de Limits::max_iter. Una isla sin dispositivos toma exactamente una pasada y produce la matriz que siempre produjo, que las pruebas del libro de texto afirman dígito por dígito. Un punto de operación que Newton no alcanza desde un arranque en frío recurre al paso por gmin (una fuga a escala de miliohmio en cada nodo, retirada gradualmente hasta GMIN), luego al paso por fuentes, y luego reporta la falla en lugar de fingir. Un paso transitorio que no converge se divide a la mitad y reintenta con el mismo presupuesto que usa el controlador de error; en el piso la iteración se mantiene y la falla se cuenta en Solver::stats(), que también lleva iteraciones, iteraciones limitadas y pasos rechazados para que las pruebas puedan afirmar sobre ellos y no sobre el tiempo de pared.
Los dispositivos de la fase 1: un diodo (Shockley con Is, N y una Rs de sustrato), un LED (la misma unión con la caída del color a 20 mA detrás), un transistor bipolar (Ebers-Moll en su forma de transporte con Bf, Br, Is y un voltaje de Early, NPN y PNP; desde octubre de 2026 el componente transistor es el modelo Gummel-Poon completo en la tarjeta propia de cada fabricante) y un MOSFET (nivel 1 Shichman-Hodges con Vto, beta y lambda, canal N y P). Un componente usa el mismo dispositivo fuera de una isla que en una: un componente de dos terminales resuelve el único lazo a través de sí mismo contra la misma ecuación, y un componente de tres terminales construye una isla privada de tres nodos con su propio dispositivo en ella y consulta al mismo solucionador. Hay un modelo por dispositivo y nunca dos.
Esos fueron los dispositivos de la fase 1. Desde entonces han llegado los análisis (el punto de operación, los barridos DC y de parámetros y la respuesta en frecuencia de CA, sección 7), cada tarjeta de dispositivo lleva su capacitancia de unión, y el amplificador operacional es un macromodelo de un solo polo. En el lienzo, la temperatura sigue fija a 27 C; un deck de SPICE (sección 7e) tiene .temp.
Lo que hace la implementación que las tres reglas anteriores no dicen
- Las islas se encuentran una sola vez, en
Kernel::init. El kernel congela su topología ahí, así que un cambio de cableado es una nueva netlist y un nuevo kernel, que es lo que la interfaz ya hace en cada edición. No hay redescubrimiento incremental y no hace falta que lo haya. - A un componente se le informa si se unió.
Component::analog_joined(bool)se llama una vez tras el descubrimiento. Un componente que fue estampado no debe además manejar sus pines, y aquí es donde un capacitor deja de ejecutar su propio integrador, una resistencia deja de pasar un Thevenin y un potenciómetro deja de manejar su cursor. - Un componente puede pedir los valores resueltos.
Component::analog_solved(currents, volts)se llama después de cada solución, para los elementos que ese componente declaró, cuando suAnalogPartlo pidió conreporting(). La corriente de un inductor es un estado de la matriz y no una función de los voltajes de nodo, así que es lo único que un componente no puede leer de sus propias redes. - Los valores pueden cambiar sin una reconstrucción.
Ctx::restamp(&[Element])entrega al kernel las estampas del componente tal como están ahora; el kernel toma los valores de ellas, deja los nodos en paz, y vuelve a resolver en ese instante manteniendo cada voltaje de capacitor y cada corriente de inductor. La perilla de un potenciómetro es para lo que existe esto. La forma de una isla nunca cambia; solo cambian los números dentro de ella. - Un pin al aire es un nodo propio. Un pin analógico cableado a nada recibe un nodo nuevo con nada más que gmin encima, así que un capacitor con una pata al aire conserva su carga y no maneja nada.
- Una isla se estaciona en un horizonte de un segundo. Deja de agendar pasos cuando nada de lo que contiene se movería más que una tolerancia durante el siguiente segundo de tiempo simulado. Preguntar si algo sucederá en el siguiente step es la pregunta incorrecta: la cola de una exponencial se mueve menos que una tolerancia por paso mucho antes de haber llegado.
- El kernel puede decir cuánto está resolviendo.
Kernel::island_count,island_of_netyisland_nodesexisten para las pruebas que sostienen la vía rápida hacia su promesa. Un netlist digital no construye ninguna isla, ycrates/sim-kernel/tests/kernel.rslo afirma en el circuito de prueba de 497 componentes junto con el conteo de despachos que ese circuito siempre ha costado.
Ambos potenciómetros se unen a una isla de la misma forma que una resistencia: una pista son dos resistencias, R x f del extremo bajo al cursor y R x (1 - f) del cursor al extremo alto, y fuera de una isla esas dos se pliegan en una fuente de Thevenin por pin.
7. Análisis
Llamadas que no avanzan el tiempo simulado. Todo lo demás en la superficie pasa por runForNs; estas ejecutan un análisis y devuelven una respuesta, que es una forma distinta para el contrato y es la razón de que exista esta sección.
7a. operatingPoint(): string
{
"tNs": 0,
"levels": [1, 0, 0],
"volts": [5.0, 2.5, 0.0],
"analogNets": [false, true, false],
"probes": [5.0, 0.00025, 0.00025, 0.0],
"parts": [
{ "index": 1, "id": "r1", "type": "resistor",
"elements": [ { "kind": "resistor", "amps": 0.00025, "volts": 2.5 } ] }
],
"error": ""
}
levels, volts y analogNets tienen una entrada por red en el orden de nets[]; probes tiene una por componente en el orden de parts[]. Un voltaje que no es un número (una red flotante) se devuelve como null, nunca como un número.
Reporta la solución que el motor mantiene ahora y nunca vuelve a resolver. Con tNs en cero, antes de que algo haya corrido, ese es el punto de operación al encender: cada capacitor descargado, cada inductor con corriente cero. Eso es un circuito que acaba de encenderse y no es el .op de SPICE, donde un capacitor es un circuito abierto. Para la respuesta DC asentada, corre el circuito hasta que se asiente y toma entonces el punto de operación. tNs está en el resultado para que un indicador pueda decir cuál de los dos está mostrando.
analogNets[i] es verdadero cuando la red i fue resuelta por la matriz y falso cuando fue resuelta por el modelo por controlador. Son tipos distintos de respuesta y un indicador tiene que poder decirlo.
parts contiene solo los componentes estampados en una isla analógica, con una entrada por elemento que estamparon, en orden de estampado. amps es positivo fluyendo de la primera terminal del elemento a la segunda y volts es el voltaje entre esas dos en el mismo orden. Un componente sin entrada no tiene corriente de rama en la matriz; eso no es lo mismo que no tener corriente, y probes suele ser la respuesta ahí: la sonda de una resistencia es su corriente haya terminado o no en una matriz (el catálogo probe dice qué significa la sonda de cada componente).
7b. sweep(specJson: string): string
{ "part": "v1", "prop": "voltage", "from": 0, "to": 5, "step": 0.25 }
{ "part": "p1", "poke": true, "from": 0, "to": 1023, "step": 64 }
settleNs puede añadirse a cualquiera; corre cada punto hasta ese tiempo tras el encendido antes de leerlo, y cualquier valor mayor que cero significa que el punto ya no es una respuesta DC.
{
"source": { "part": "v1", "prop": "voltage", "discrete": false, "continued": false },
"settleNs": 0,
"parts": [ { "index": 1, "id": "r1", "type": "resistor", "kind": "resistor", "elements": 1 } ],
"points": [
{ "value": 0, "levels": [0,0,0], "volts": [0,0,0], "currents": [0], "probes": [0,0,0,0], "error": "" }
],
"error": ""
}
currents es paralelo a parts y lleva el primer elemento de cada componente analógico. Un análisis que no pudo correrse devuelve error activado y points vacío; nunca lanza una excepción.
Dos rutas, porque hay dos tipos de cosas ajustables en este motor.
propreconstruye el circuito en cada punto a partir del netlist con ese único número cambiado y lo enciende, así que cada punto es un punto de operación DC con arranque en frío ycontinuedes falso. Una propiedad que no es un número se rechaza con palabras, y lo mismo una propiedad que el componente no tiene.poke: trueejecuta el código de poke del componente en el circuito vivo (el eje de un potenciómetro), lo que reestampa y vuelve a resolver en el lugar, así quecontinuedes verdadero ydiscretees verdadero, porque un eje es un conteo entero y no un continuo. El componente se devuelve donde el barrido lo encontró.
Lo máximo que un barrido puede tomar es 1001 puntos. Más allá de eso se rechaza con el conteo en el mensaje en lugar de ejecutarse.
7c. setMaxStepNs(ns, fixed) y stepLimitNs()
Limits.dt_max como configuración. ns es el paso más largo que cualquier isla analógica puede tomar; fixed fija también el piso en ese valor, de modo que el controlador de error tiene exactamente un paso para elegir. Cero o menos lo limpia y devuelve cada isla al techo propio del kernel de 2 ms.
Dos cosas todavía acortan un paso forzado y ambas son deliberadas: una discontinuidad de fuente se aterriza sobre ella en lugar de integrarse a través, y un umbral lógico observado dentro de un paso se refina hasta el cruce. Nada nunca alarga uno, así que un paso forzado es una promesa de "al menos esta fineza".
Un componente puede pedir lo mismo en su propia isla con Ctx::limit_step(dt, fixed), y la solicitud más fina en una isla gana. La propiedad step del componente scope es esa llamada: cero, el valor por omisión, deja al controlador en paz.
7d. acSweep(specJson: string): string
{ "source": "gen1", "probe": 4, "fStart": 10, "fStop": 100000, "pointsPerDecade": 20 }
input puede añadirse: el índice de red contra el cual se toma la ganancia. Si se omite, es la red que impulsa el propio elemento de la fuente, que es lo que una persona quiere decir con "la entrada" cuando eligió un generador.
{
"source": { "part": "gen1", "type": "generator", "net": 0, "drive": "vsource" },
"input": 0,
"probe": 1,
"tNs": 0,
"freq": [10, 11.22, 12.59],
"magDb": [-0.0004, -0.0005, -0.0006],
"phaseDeg": [-0.576, -0.646, -0.725],
"inputMag": [1, 1, 1],
"outputMag": [0.99995, 0.99994, 0.99992],
"error": ""
}
Los cinco arreglos son paralelos y tienen una entrada por frecuencia. magDb y phaseDeg son la razón del fasor de salida respecto al fasor de entrada (20 log10 |Vout / Vin| y arg(Vout / Vin) en grados), que es lo único aquí que es una función de transferencia. inputMag y outputMag son las magnitudes crudas de los fasores en la unidad que tenga el estímulo, y source.drive indica cuál: vsource es un volt a través de la fuente, isource un ampere hacia ella, thevenin un volt en circuito abierto detrás de su resistencia. Un generador de funciones es un par Norton, así que su drive es isource y su inputMag es una impedancia en ohms en lugar de un volt; la razón no se ve afectada, y ese es precisamente el objetivo de reportar la razón.
freq es fStart * 10^(k / pointsPerDecade) hasta e incluyendo fStop, que es la misma rejilla que recorre .ac dec, así que un barrido aquí y un barrido en un simulador de referencia con los mismos tres números se comparan punto por punto. fStart debe ser mayor que cero: cero hercios es DC, que es el punto de operación y no un punto de un barrido logarítmico. Lo máximo que un barrido puede tomar es 1001 puntos, el mismo tope que tiene sweep.
Se toma sobre el punto de operación que el motor mantiene ahora, exactamente como lo reporta operatingPoint, y no vuelve a resolver nada. The original text does not need to be translated. tNs The original text does not need to be translated. tNs The original text does not need to be translated.
Desde la fase 1 de Analog 3 cada tarjeta de dispositivo incluye su capacitancia de unión, y el sello de CA es j w C en el mismo dQ/dv que integra el transitorio, así que un transistor tiene su propia esquina de alta frecuencia y una etapa de emisor común muestra el efecto Miller. Lo que el modelo no tiene está en crates/analog/src/ac.rs y se repite en docs/help/editor/analysis.md: un BJT no tiene tiempo de tránsito inverso TR, la capacitancia compuerta-drenador de un MOSFET es constante y por lo tanto no tiene meseta de Miller, el Darlington TIP120 no tiene capacitancia en absoluto; no hay análisis de ruido ni análisis de distorsión, porque un circuito linealizado no tiene ninguno de los dos; y el amplificador operacional sigue siendo el de ganancia lineal limitada por los rieles, con ganancia plana hasta frecuencia infinita.
Un análisis que no pudo ejecutarse regresa con error activado y los arreglos vacíos; nunca lanza una excepción. Las tres cosas que salen mal indican cuál son: el componente nombrado no tiene una fuente que un análisis de CA pueda excitar, una red no está en la misma isla analógica que la fuente, o el rango no es un rango.
7e. spiceRun(deck: string, filesJson: string): string
Es una función libre del módulo, no un método de Sim: ejecuta un deck de SPICE en crates/spice y no tiene nada que ver con ningún circuito cargado. filesJson es [{ "name": "models.lib", "text": "..." }], los archivos que el deck puede incluir con .include o .lib (primero por nombre exacto, luego solo por nombre de archivo), o una cadena vacía. La respuesta:
{ "ok": true, "title": "RC step",
"diagnostics": [{ "severity": "warning", "line": 4, "col": 1, "message": "..." }],
"results": [{ "kind": "tran", "notes": ["412 accepted steps"], "error": null,
"vectors": [{ "name": "time", "unit": "s", "data": [0, 1e-5] }] }],
"deck": "the flat deck, written back out" }
ok false means the deck did not read; diagnostics then lists every
error with its line and column and results is empty. kind is op,
tran, ac, dc, tf, noise or meas, one result per analysis card
per .step point per .temp, in that nesting, then the .meas values. AC
vectors come as pairs, re(v(out)) and im(v(out)), beside frequency; a
DC sweep has sweep (and sweep2 for the outer of a nested one). A number
that is not finite is null. The editor calls it through the simulation
worker (SimClient.spiceRun) and draws it with src/ui/spice-panel.ts.