Mokxi mensimulasikan rangkaian dengan tiga engine, dan halaman ini adalah kontrak yang dipegang masing-masing.
- Kernel digital. Kernel berbasis event menjalankan setiap mikrokontroler, chip logika, dan net digital. Tegangan sebuah net berasal dari driver-driver di atasnya, masing-masing berupa tegangan di balik impedansi sumber, dan level logikanya dari yang paling kuat (bagian 6). Inilah yang membuat beberapa ratus komponen dan satu inti CPU bisa berjalan di waktu nyata dalam satu tab browser.
- Pulau analog. Kapasitor, induktor, op-amp, generator sinyal, dioda, atau transistor menarik net yang disentuhnya ke dalam sebuah pulau, dan pulau itu diselesaikan sebagai satu matriks dengan modified nodal analysis, dengan model komponen di balik semikonduktor: dioda Shockley, transistor Gummel-Poon, dan MOSFET level 1, masing-masing dengan kapasitansi junction, diselesaikan dengan Newton-Raphson (bagian 6a dan 6b). Di kanvas kamu bisa membaca titik kerja DC, melakukan sweep pada sebuah nilai, dan memplot respons frekuensi (bagian 7).
- Runner deck SPICE. Jalankan deck SPICE, di menu editor, menjalankan netlist SPICE pada engine tersendiri:
.op,.tran,.ac,.dcdengan sweep bersarang,.tf,.noise, dan.meas, dengan subcircuit, parameter,.include, BJT Gummel-Poon, MOSFET level 1 sampai 3, JFET, sumber behavioral, dan.temp. Semuanya diuji terhadap ngspice pada 42 rangkaian benchmark, masing-masing dalam toleransi yang ditetapkan (bagian 7e).
Apa yang tidak dilakukan masing-masing, secara jujur:
- Kanvas live tidak punya analisis noise, suhu, atau distorsi, dan tidak ada fungsi transfer; setiap junction di dalamnya berada pada 27 C. Op-ampnya adalah makromodel satu kutub dengan gain-bandwidth product, slew rate, headroom, offset, dan batas arus, tapi tanpa kutub kedua.
- Runner deck SPICE tidak menjalankan model MOSFET BSIM, transmission line lossy, perangkat XSPICE, atau analisis
.four,.sens,.pz, dan.disto, dan ia mengatakannya, per baris, saat sebuah deck memakai salah satunya. Tidak ada analisis Monte Carlo dan tidak ada library model dari pabrikan. - Tidak ada yang punya peringkat daya. Komponen tidak pernah terbakar, catu daya tidak pernah turun, dan pin tidak punya batas arus, jadi rangkaian yang berhasil di sini masih bisa gagal di meja kerja (bagaimana komponen dimodelkan).
Kontraknya
Bagian selanjutnya dari halaman ini adalah batas antara simulator Rust (crate: sim-kernel, parts, analog, spice, sim-wasm) dan UI TypeScript (web/). Kedua sisi di-build terhadap file ini. Ubah hanya dengan menyunting file ini terlebih dahulu.
1. Netlist JSON (UI -> simulator)
UI memiliki diagram (posisi, kabel, breadboard). Sebelum memulai simulasi, ia meratakan diagram menjadi netlist: strip breadboard dan kabel digabung dengan union-find menjadi net. Breadboard tidak pernah sampai ke simulator.
{
"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"]
]
}
- Urutan
parts[i]menentukanpartIndexyang dipakai olehprobes()danpoke(). - Urutan
nets[j]menentukannetIndexyang dipakai olehnetLevels()dannetVoltages(). - Referensi pin adalah
"<partId>:<pinName>". Nama pin berasal dari katalog. Tipe komponen tidak dikenal, pin tidak dikenal, atau pin berada di dua net adalah error saatcreate. - Props yang tidak diberikan memakai bawaan katalog. Props tidak dikenal adalah error.
- Sebuah net boleh berisi satu pin. UI mengeluarkannya saat sebuah pin sendirian di strip breadboard (node sungguhan, diperlukan untuk saklar); simulator menerimanya.
2. Permukaan WASM (crates/sim-wasm, wasm-bindgen, --target web)
Rust memakai snake_case; ekspor dengan js_name supaya TypeScript melihat persis ini:
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;
Loop yang tidak menetap tidak menghentikan jalannya simulasi. Saat satu instan waktu simulasi membutuhkan lebih dari 1000 siklus delta (komponen yang saling melempar net bolak-balik dalam waktu nol, biasanya dua komponen yang masing-masing punya dua kaki di satu baris breadboard), engine memotong loop di tempatnya: net yang masih berubah diselesaikan sekali lagi dan ditahan di situ, waktu berjalan terus, dan setiap pemanggilan tetap mengembalikan 0. Instan ini dilaporkan sekali per loop per run melalui takeUnsettled(), nets berupa indeks ke dalam nets[]; editor mengubahnya menjadi satu baris di serial monitor dan satu temuan Circuit Doctor (web/src/ui/unsettled-watch.ts). Setelah 16 instan semacam itu dalam satu run, setiap instan berikutnya dipotong pada 200 siklus delta, jadi loop yang aktif di setiap sinyal PWM cepat tidak bisa membekukan halaman. Kode 1 = oscillation di atas tetap dipakai untuk kasus indeks yang buruk dan untuk engine yang dibangun sebelum ini.
Build: wasm-pack build --target web --release --out-dir ../../web/src/sim/wasm --out-name sim crates/sim-wasm (opsi sebelum path crate). Output-nya di-commit ke git supaya UI bisa dibangun tanpa Rust.
3. JSON katalog (simulator -> UI)
[
{
"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 menyatakan apa yang diterima loadProgram untuk komponen ini ("elf32 riscv32imc" untuk sebuah board), atau null. host menyatakan apa yang dibawa oleh kanal byte host ("utf-8 bytes on UART0"), atau null. Komponen dengan kanal host adalah yang diajak bicara oleh serial monitor.
dir bernilai in, out, atau inout. kind bernilai number, string, atau bool. options sifatnya opsional; jika ada, UI menampilkan sebuah select. Prop number juga membawa rentang nilainya, min dan max, dengan "minOpen": true bila nilai min itu sendiri ditolak dan "integer": true untuk bilangan bulat saja (crates/parts/src/ranges.rs, maksimal 1e15 ke dua arah); membuat komponen menolak nilai di luar rentang itu, dan panel properti menghentikannya saat diisi. Visual komponen UI (web/src/parts/<type>.ts) harus mendeklarasikan posisi pin untuk setiap pin katalog dan tidak lebih; ada tes di web/ yang memeriksa ini terhadap web/src/sim/wasm/catalog.json, yang juga ditulis oleh langkah build wasm.
4. Tipe komponen yang dibekukan untuk shell UI Fase 1
Sisi kernel mengirimkan yang ini lebih dulu supaya UI punya sesuatu untuk dikendalikan. Komponen lain datang dari part agent dan hanya menambah entri.
| type | pins | props | probe | poke |
|---|---|---|---|---|
led |
A, C |
string color (red) |
brightness 0..1 | tidak ada |
resistor |
1, 2 |
value ohm (1000) |
arus dalam ampere | tidak ada |
pushbutton |
1a, 1b, 2a, 2b (1a-1b terhubung singkat, 2a-2b terhubung singkat, menekan menyatukan kedua pasangan) |
string bounce ("typical", salah satu dari none/typical/worst), lihat 4a |
1 tertekan, 0 lepas | 1 = ditekan, 0 = dilepas |
vcc |
VCC |
voltage (5) |
tegangan | tidak ada |
gnd |
GND |
tidak ada | 0 | tidak ada |
clock |
OUT |
hz (1) |
1 saat tinggi, 0 saat rendah | tidak ada |
4a. Set komponen Fase 1 (ditambah setelah shell, hanya bisa ditambah di akhir)
Satuan: resistor.value ohm, capacitor.value microfarad. Chip mencantumkan pin-nya sesuai urutan nomor pin kemasan. Probe yang membawa lebih dari satu bit mengemas bitmask ke dalam f32.
| type | pins | props | probe | poke |
|---|---|---|---|---|
capacitor |
1, 2 |
value angka (10) |
tegangan pada komponen, V(1) - V(2) | tidak ada |
gate |
A, B, Y |
string function ("and", salah satu dari and/or/nand/nor/xor/xnor) |
1 saat Y tinggi, 0 saat rendah, 0.5 saat tidak diketahui | tidak ada |
not |
A, Y |
tidak ada | 1 saat Y tinggi, 0 saat rendah, 0.5 saat tidak diketahui | tidak ada |
bitin |
Q |
string label ("A"); value (0, 0 atau 1) |
1 saat Q tinggi, 0 saat rendah | 0 membuat Q rendah, 1 tinggi; mendorong lewat pull, jadi output apa pun di net itu yang menang |
bitout |
A |
string label ("Y"); string color ("green", salah satu dari green/red/amber/blue) |
1 tinggi, 0 rendah, 0.5 tidak diketahui atau tidak didorong | tidak ada |
bytein |
D0..D7 |
string label ("A"); value (0, 0 sampai 255); width (8, 1 sampai 8) |
nilai pada D0..D(width-1); pin di atas width berstatus high-Z | 0..255 mengatur nilainya (dimask ke width); 2^32 menaikkan satu |
byteout |
D0..D7 |
string label ("S"); width (8, 1 sampai 8) |
nilainya, bit yang tidak didorong bernilai 0; -1 bila ada bit terdorong yang tidak diketahui | tidak ada |
bitconst |
Q |
value (0, 0 atau 1) |
nilai yang didorongnya | tidak ada; mendorong push-pull, seperti output gerbang |
stepclock |
CLK |
hz (2); string mode ("step", salah satu dari step/run) |
level (0 atau 1), plus 2 saat berjalan bebas | 0 menghentikannya (mode step), 1 menjalankannya bebas, 2 memberi satu tick (naik, lalu turun setengah periode kemudian) saat berhenti |
progrom |
A0..A7 masukan; C0..C7, K0..K7 keluaran |
string program (assembly Kestrel, crates/parts/src/kestrel.rs) |
alamat yang sedang dibaca; -1 selama belum diketahui | tidak ada; word di alamat tersebut menggerakkan C (byte tinggi) dan K (byte rendah) setelah 10 ns |
terminal |
D0..D7, WE, CLK |
string mode ("text", salah satu dari text/numbers) |
byte yang ditulis sejak dinyalakan | tidak ada; kanal host: setiap byte ditulis pada tepi naik CLK dengan WE tinggi |
sevenseg |
E, D, COM1, C, DP, G, F, COM2, A, B |
string common ("cathode", salah satu dari cathode/anode); string color ("red", salah satu dari red/green/blue/yellow/white) |
segmen yang menyala sebagai bitmask 0..255: bit 0 A, 1 B, 2 C, 3 D, 4 E, 5 F, 6 G, 7 DP | tidak ada |
slideswitch |
1, 2, 3 |
tidak ada | 0 = common di pin 1, 1 = common di pin 3 | 0 = sambungkan 2 ke 1, 1 = sambungkan 2 ke 3 |
buzzer |
1, 2 |
tidak ada | 1 saat berbunyi, 0 saat senyap | tidak ada |
74hc00 |
1A, 1B, 1Y, 2A, 2B, 2Y, GND, 3Y, 3A, 3B, 4Y, 4A, 4B, VCC |
tidak ada | keluaran sebagai bitmask, bit 0 = 1Y .. bit 3 = 4Y; 0 saat tanpa daya | tidak ada |
74hc08 |
pinout sama dengan 74hc00 |
tidak ada | sama | tidak ada |
74hc32 |
pinout sama dengan 74hc00 |
tidak ada | sama | tidak ada |
74hc86 |
pinout sama dengan 74hc00 |
tidak ada | sama | tidak ada |
74hc04 |
1A, 1Y, 2A, 2Y, 3A, 3Y, GND, 4Y, 4A, 5Y, 5A, 6Y, 6A, VCC |
tidak ada | keluaran sebagai bitmask, bit 0 = 1Y .. bit 5 = 6Y; 0 saat tanpa daya | tidak ada |
74hc74 |
1RD, 1D, 1CP, 1SD, 1Q, 1QN, GND, 2QN, 2Q, 2SD, 2CP, 2D, 2RD, VCC |
tidak ada | keluaran Q sebagai bitmask, bit 0 = 1Q, bit 1 = 2Q; 0 saat tanpa daya atau X | tidak ada |
74hc595 |
Q1, Q2, Q3, Q4, Q5, Q6, Q7, GND, Q7S, MR, SHCP, STCP, OE, DS, Q0, VCC |
tidak ada | byte di Q0..Q7, bit 0 = Q0; 0 saat OE tinggi atau tanpa daya | tidak ada |
ne555 |
GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC |
tidak ada | 1 saat OUT tinggi, 0 saat rendah atau tanpa daya | tidak ada |
tlc555 |
GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC |
tidak ada | 1 saat OUT tinggi, 0 saat rendah atau tanpa daya | tidak ada |
ne556 |
1DIS, 1THR, 1CTRL, 1RESET, 1OUT, 1TRIG, GND, 2TRIG, 2OUT, 2RESET, 2CTRL, 2THR, 2DIS, VCC |
tidak ada | bit 0 = 1OUT, bit 1 = 2OUT tinggi | tidak ada |
inductor |
1, 2 |
value milihenri (100) |
arus dalam ampere, positif dari pin 1 ke pin 2 | tidak ada |
opamp |
IN+, IN-, OUT, V+, GND |
gain (100000) |
tegangan keluaran di atas pin GND | tidak ada |
lm358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT di atas pertengahan suplai | tidak ada |
lm324 |
1OUT, 1IN-, 1IN+, VCC, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, GND, 4IN+, 4IN-, 4OUT |
offset milivolt (0) |
bit 0 = 1OUT .. bit 3 = 4OUT di atas pertengahan suplai | tidak ada |
tl072 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT di atas pertengahan suplai | tidak ada |
lm741 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, NC |
offset milivolt (0) |
1 selama OUT di atas pertengahan suplai | tidak ada |
ne5532 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT di atas pertengahan suplai | tidak ada |
lm833 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT di atas pertengahan suplai | tidak ada |
opa2134 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT di atas pertengahan suplai | tidak ada |
mcp6002 |
VOUTA, VINA-, VINA+, VSS, VINB+, VINB-, VOUTB, VDD |
offset milivolt (0) |
bit 0 = VOUTA, bit 1 = VOUTB di atas pertengahan suplai | tidak ada |
mcp6004 |
VOUTA, VINA-, VINA+, VDD, VINB+, VINB-, VOUTB, VOUTC, VINC-, VINC+, VSS, VIND+, VIND-, VOUTD |
offset milivolt (0) |
bit 0 = VOUTA .. bit 3 = VOUTD di atas pertengahan suplai | tidak ada |
lmv358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT di atas pertengahan suplai | tidak ada |
tl081 |
NULL1, IN-, IN+, VCC-, NULL2, OUT, VCC+, NC |
offset milivolt (0) |
1 selama OUT di atas pertengahan suplai | tidak ada |
tl084 |
1OUT, 1IN-, 1IN+, VCC+, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, VCC-, 4IN+, 4IN-, 4OUT |
offset milivolt (0) |
bit 0 = 1OUT .. bit 3 = 4OUT di atas pertengahan suplai | tidak ada |
op07 |
NULL1, IN-, IN+, V-, NC, OUT, V+, NULL2 |
offset milivolt (0) |
1 selama OUT di atas pertengahan suplai | tidak ada |
ca3140 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, STROBE |
offset milivolt (0) |
1 selama OUT di atas pertengahan suplai | tidak ada |
lm393 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT lepas (IN+ di atas IN-) | tidak ada |
lm339 |
1OUT, 2OUT, VCC, 2IN-, 2IN+, 1IN-, 1IN+, 3IN-, 3IN+, 4IN-, 4IN+, GND, 4OUT, 3OUT |
offset milivolt (0) |
bit 0 = 1OUT .. bit 3 = 4OUT lepas | tidak ada |
lm311 |
EMIT, IN+, IN-, VCC-, BAL, STRB, COL, VCC+ |
offset milivolt (0) |
1 saat COL lepas (atau di-strobe) | tidak ada |
uln2003a |
1B, 2B, 3B, 4B, 5B, 6B, 7B, E, COM, 7C, 6C, 5C, 4C, 3C, 2C, 1C |
tidak ada | bit 0..6 = input 1B..7B minimal 1,4 V di atas E | tidak ada |
uln2803a |
1B, 2B, 3B, 4B, 5B, 6B, 7B, 8B, GND, COM, 8C, 7C, 6C, 5C, 4C, 3C, 2C, 1C |
tidak ada | bit 0..7 = input 1B..8B minimal 1,4 V di atas GND | tidak ada |
uln2003board |
IN1, IN2, IN3, IN4, VCC, GND, OUT1, OUT2, OUT3, OUT4 |
tidak ada | bit 0..3 = LED A..D: OUT1..OUT4 1,7 V atau lebih di bawah VCC | tidak ada |
generator |
OUT, GND |
string wave ("sine", salah satu dari sine/square/triangle); frequency Hz (1000); amplitude volt puncak (2,5); offset volt (2,5); duty persen (50, hanya square) |
tegangan keluaran di atas pin GND | tidak ada |
funcgen |
OUT, GND |
string wave ("sine", salah satu dari sine/square/triangle/sawtooth); frequency Hz (1000); amplitude volt puncak (2,5); offset volt (2,5); duty persen (50, hanya square) |
tegangan output di atas pin GND, di terminal | tidak ada |
scope |
CH1, CH2, GND |
window detik (0,02, 0,0001 sampai 10); volts skala penuh (5) |
tegangan channel 1 di atas klip ground | (1 << 32) | window dalam mikrodetik, atau (2 << 32) | skala penuh dalam milivolt |
multimeter |
V, A, COM |
string mode ("dcv", salah satu dari dcv/acv/dca/aca/ohms/continuity) |
hasil pengukuran: volt, ampere, atau ohm sesuai mode, NaN saat melebihi jangkauan atau terbuka | tidak ada |
lm35 |
VS, VOUT, GND |
angka temperature (22,5) |
suhu dalam derajat Celsius | persepuluh derajat ditambah 1000 |
aht20 |
VCC, GND, SCL, SDA (I2C di 0x38) |
angka temperature (22); angka humidity (45) |
suhu dalam derajat Celsius | (1 << 32) | (persepuluh + 1000) suhu, (2 << 32) | persepuluh kelembapan |
bh1750 |
VCC, GND, SCL, SDA, ADDR (I2C di 0x23, 0x5C dengan ADDR tinggi) |
tidak ada | cahaya dalam lux | cahaya dalam lux, 0 sampai 100000 |
a3144 |
VCC, GND, OUT (open collector) |
angka operate (210 gauss); angka hysteresis (55) |
kode magnet, ditambah 100000 saat OUT aktif | persepuluh mm, 0 sampai 400, ditambah 10000 untuk kutub utara |
ss49e |
VCC, GND, OUT |
tidak ada | medan di sensor dalam gauss, selatan positif | persepuluh mm, 0 sampai 400 (400 berarti tanpa magnet), ditambah 10000 untuk kutub utara |
photointerrupter |
SIG, VCC, GND (plus SHAFT jika wheel diatur) |
angka slots (20), string wheel ("": id dari dcmotor atau encmotor yang berputar bersama rodanya, kosong untuk slider) |
kode roda (RPM, ditambah 10000 jika kartu terpasang), ditambah 100000 saat SIG tinggi, ditambah 1000000 jika roda ada di motor | RPM 0 sampai 600 (diabaikan di motor), ditambah 10000 jika kartu terpasang |
linearray |
GND, VCC, S1 sampai S5 |
angka threshold (0,5) |
kode garis, ditambah 1000 x channel di atas hitam sebagai bit (bit 0 adalah S1) | 100 + mm dari sensor tengah (40 sampai 160); 1 ada batang hitam melintang; 0 tanpa garis |
fc51 |
OUT, GND, VCC |
angka threshold (0,5) |
kode halangan (cm, 80 berarti tidak ada, ditambah 10000 untuk warna hitam), ditambah 100000 saat lampu menyala | cm 1 sampai 80, plus 10000 untuk benda berwarna hitam |
thermalprinter |
VH, GND, RX, TX, DTR |
baud angka (19200); paper bool (true) |
jumlah baris yang tercetak | kertas: 1 terpasang, 0 habis |
fingerprint |
VCC, GND, TX, RX |
baud angka (57600); enrolled angka (2); capacity angka (162); password angka (0) |
jari di kaca, plus 100 setelah pencarian menemukannya, 200 jika tidak ditemukan | jari, 1 sampai 9, atau 0 untuk mengangkatnya |
ds1302 |
VCC, GND, CLK, DAT, RST |
start string ("2026-01-01 12:00:00"); halted bool (false) |
detik sejak tengah malam, plus 100000 saat dijeda | (1 << 32) atau detik sejak tengah malam, atau (2 << 32) atau hari sejak 2000-01-01 |
amg8833 |
VIN, GND, SCL, SDA, INT (I2C di 0x69) |
address angka (105); background angka (22); spot angka (34); pixel angka (27) |
piksel terpanas dalam C | (1 << 32) background, (2 << 32) spot, persepuluh + 1000; (3 << 32) piksel spot, 64 jika tidak ada |
mlx90614 |
VIN, GND, SCL, SDA (SMBus di 0x5A) |
object angka (36.6); ambient angka (22) |
suhu benda dalam C | (1 << 32) object atau (2 << 32) ambient, plus persepuluh derajat + 1000 |
mpr121 |
VIN, GND, SCL, SDA, IRQ, ADDR (I2C di 0x5A) |
address angka (90) |
status sentuh: elektroda 0 di bit 0 | elektroda yang ditekan jari, sebagai mask |
gp2y0a21 |
VO, GND, VCC |
distance angka (30) |
jarak dalam sentimeter | jarak dalam sentimeter, 1 sampai 150 |
mg996r |
GND, VCC, PWM |
min_pulse angka (544); max_pulse angka (2400); range angka (180) |
sudut horn dalam derajat, 0 sampai range | tidak ada |
yfs201 |
VCC, GND, SIG |
flow angka (0) |
aliran dalam liter per menit | aliran dalam persepuluh liter per menit, 0 sampai 300 |
adxl335 |
VCC, X, Y, Z, GND |
tilt_x angka (0); tilt_y angka (0) |
kemiringan X dalam derajat | (1 << 32) atau (2 << 32), plus kemiringan X atau Y + 90 |
pulsesensor |
S, VCC, GND |
bpm angka (72); swing angka (0.8) |
detak jantung dalam denyut per menit (0 tanpa jari), plus 1000 saat puncak utama lewat | detak jantung dalam denyut per menit, 30 sampai 220, atau 0 tanpa jari |
coinacceptor |
DC12V, COIN, GND, COUNTER |
pulse angka (50); nc bool (false) |
pulsa terkirim sejak dinyalakan, plus 100000 saat COIN aktif | koin bernilai sebanyak ini pulsa, 1 sampai 50 |
waterpump |
V+, V- |
voltage angka (6); flow angka (120); resistance angka (4); inertia angka (50); back_emf angka (0.85) |
aliran dalam liter per jam | tidak ada |
fanmodule |
INA, INB, VCC, GND |
voltage angka (5); inertia angka (250) |
kecepatan baling-baling dalam persen dari maksimal, negatif saat mundur | tidak ada |
laser |
S, VCC, GND |
resistor angka (100) |
tingkat kecerahan cahaya yang terlihat, 0 sampai 1 | tidak ada |
trafficlight |
R, Y, G, GND |
resistor angka (220) |
LED yang menyala sebagai bitmask: merah bit 0, kuning bit 1, hijau bit 2 | tidak ada |
sw420 |
VCC, GND, DO |
angka threshold (0,5) |
0 diam, 1 bergetar, 2 mengetuk, plus 100000 selama lampu menyala (DO rendah) | 0 diam, 1 bergetar sampai sentuhan berikutnya, 2 satu ketukan |
mq3 ke mq137 (mq3, mq4, mq5, mq6, mq7, mq8, mq9, mq131, mq135, mq137) |
VCC, GND, DO, AO |
gas string (per sensor, dari grafiknya); r0 ohm; rl ohm; threshold angka; warmup detik (20) |
gas dalam satuan sensor (ppm; seperseratus mg/L pada MQ-3; ppb pada MQ-131), plus 100000 selama lampu DO menyala, plus 200000 selama pemanasan | gas dalam satuan itu, 0 sampai batas atas grafik |
ky037 |
AO, GND, VCC, DO |
threshold angka (0.505); sensitivity dBV/Pa (-42) |
seperti ky038 |
seperti ky038 |
ky004, ky017, ky021, ky031 |
S, VCC, GND |
resistor string ("pull-up" atau "pull-down"); settle ms (ky004 3, ky017 0, ky021 0.5); ky021 close mm (15), release (0.8) |
ky004 1 ditekan; ky017 1 miring; ky021 mm magnet; ky031 0 diam, 1 bergetar, 2 mengetuk | kode yang sama |
sw18010p |
1, 2 |
tidak ada | 0 diam, 1 bergetar, 2 mengetuk | 0 diam, 1 bergetar sampai sentuhan berikutnya, 2 satu ketukan |
ky024, ky025, ky028 |
AO, GND, VCC, DO |
threshold angka (0.6, 0.5, 0.45); ky025 close mm (15), release (0.8); ky028 beta K (3950) |
kode sentuhan, plus 100000 selama lampu DO menyala (DO tinggi) | ky024 sepersepuluh mm, plus 10000 untuk utara; ky025 mm magnet, 0 sampai 60; ky028 sepersepuluh derajat plus 1000 |
ky035 |
VCC, GND, S |
tidak ada | seperti ss49e |
seperti ss49e |
temt6000 |
SIG, GND, VCC |
sensitivity uA per lux (0.5) |
cahaya dalam lux | lux, 0 sampai 2000 |
rotation |
GND, S, VCC |
value ohm (10000); taper string |
seperti potentiometer |
seperti potentiometer |
steam |
S, VCC, GND |
full pecahan (0.66) |
bagian sisir yang basah, dalam persen | persen, 0 sampai 100 |
e18d80nk |
VCC, GND, OUT |
range cm (40, 3 sampai 80); pullup flag (false) |
cm target (100 berarti tidak ada), ditambah 100000 selama mendeteksi | cm, 1 sampai 100 |
ttp223 |
SIG, VCC, GND |
toggle bool (false); activelow bool (false) |
bit 0 jari di pad, bit 1 SIG tinggi | 1 jari menempel, 0 lepas |
battery |
V+, V- |
kind string ("9v", salah satu dari 9v/aa2/aa3/aa4/18650/18650x2); charge angka (100) |
tegangan pada kedua terminal | tidak ada |
solar |
+, - |
tidak ada | volt pada panel | watt per meter persegi, 0 sampai 1200 (1000 adalah sinar matahari penuh) |
tp4056 |
IN+, IN-, BAT+, BAT- |
tidak ada | arus pengisian dalam mA, ditambah 10000 selama lampu standby menyala | tidak ada |
regulator |
IN, GND, OUT |
string model ("7805", salah satu dari 7805/AMS1117-3.3/MCP1700-3.3) |
OUT di atas GND, dalam volt | tidak ada |
tb6612 |
PWMA, AIN2, AIN1, STBY, BIN1, BIN2, PWMB, GND1, VM, VCC, GND2, AO1, AO2, BO2, BO1, GND3 |
tidak ada | mode channel, A di bit 0-1 dan B di 2-3: 0 mati, 1 CW, 2 CCW, 3 rem | tidak ada |
l9110 |
BIA, BIB, GND, VCC, AIA, AIB, OA1, OA2, OB1, OB2 |
tidak ada | penggerak motor, A di bit 0-1 dan B di 2-3: 0 mati, 1 maju, 2 mundur, 3 rem | tidak ada |
encmotor |
M1, M2, VCC, GND, A, B |
voltage (6), rpm (200), resistance (6), inertia (120), back_emf (0.85) motor biasa, ditambah angka ppr (11) dan angka ratio (30) |
kecepatan roda dalam rpm, bertanda | tidak ada |
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) |
kemiringan dalam derajat, maju positif | 1 membuatnya berdiri, 3 melepaskannya, (2 << 32) | (dorongan dalam 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 derajat), current (1.7 A), max_steps (1000) |
kedalaman cakar di bawah bagian atas dalam mm; seluruh status di channel instrumen | 1 mengembalikan semua hadiah |
clawcabinetdc |
X+, X-, Y+, Y-, VCC, GND, W+, W-, CLAW, XHOME, YHOME, BEAM |
seperti clawcabinet, dengan voltage (6) dan rpm (200) motor gear menggantikan current dan max_steps |
seperti clawcabinet |
1 mengembalikan semua hadiah |
vendingcabinet |
M1, M2, M3, M4, VCC, GND, DROP |
stock (3 tiap spiral), rpm (110) |
camilan di wadah; seluruh status di channel instrumen | 1 mengisi ulang setiap spiral dan mengosongkan wadah |
pinballcabinet |
FL, FR, VCC, GND, KICK1, KICK2, TA, TB, TC, B1, B2, DRAIN, LAUNCH |
flip_speed (1200 derajat per detik) |
tinggi bola di meja dalam mm, -1 saat menggelinding kembali; seluruh status di channel instrumen | 1 menaruh bola di plunger; 0x100 + n menahan saklar n (TA, TB, TC, B1, B2, berkas drain, plunger) dan 0x200 + n melepaskannya |
barriercabinet |
VCC, GND, TRIG, ECHO, R, Y, G, ARM, V+ |
angle (0 derajat) |
sudut lengan; seluruh status di channel instrumen | 1 mengirim mobil ke atas jalur |
sortercabinet |
VCC, GND, SCL, SDA, SERVO |
candies (12), period (2000 ms) |
permen di wadah; seluruh status di channel instrumen | 1 mengisi ulang wadah dan mengosongkan wadah; 0x1000000 + 0xRRGGBB mengeluarkan permen dengan warna itu berikutnya |
soapcabinet |
VCC, GND, OUT, M+, M- |
threshold (0.5), bottle (30 ml), ml_per_turn (0.5), voltage (6), rpm (200) |
sabun yang dipompa sejak botol diisi, dalam ml; seluruh state di channel instrumen | tangan cm di bawah keran, 1 sampai 80 (80 tidak ada orang), plus 10000 untuk sarung tangan hitam; 1000000 mengisi botol |
Roda wheel milik photo interrupter yang dipasang pada motor disambungkan ke motor itu oleh netlist (web/src/sim/wheel-mount.ts): pin SHAFT kedua komponen pada satu net yang sama, dan shaft: true pada dcmotor atau encmotor, flag internal yang tidak dimuat katalog (PropInfo::internal) yang memberi motor pin itu. Ia membawa kecepatan poros keluaran, tanpa tanda, sebesar 1 mV per rpm.
Chip mendapat daya saat tegangan antara pin VCC dan GND-nya minimal 2 V (4,5 V untuk NE555); tanpa daya, semua output berada dalam keadaan high-Z.
Satuan: resistor.value ohm, capacitor.value mikrofarad, inductor.value milihenri.
Channel sampel milik Osiloskop
Osiloskop membawa sampelnya lewat jalan yang sama dengan piksel sebuah display: readHost, dikumpulkan sekali per frame, dengan katalog host bernilai null karena field itu berarti "channel teks yang digunakan serial monitor" dan ini adalah sampel.
readHost(scopeIndex) mengembalikan semua yang ter-sample sejak panggilan terakhir, sebagai satu pesan little-endian, atau tidak ada apa pun saat belum ada sampel yang diambil:
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
Probe yang tidak menjepit apa pun membaca NaN. Komponen menyimpan 1024 sampel untuk host yang sudah berhenti mengumpulkan lalu membuang yang tertua, dengan menyetel flag dropped.
Time base dan full scale adalah properti, dan juga bisa di-poke, karena keduanya adalah hal yang diubah seseorang saat melihat sebuah trace, dan membangun ulang netlist hanya untuk mengubah salah satunya akan memulai ulang simulasi. Sebuah poke window berlaku seketika: komponen menghapus apa yang belum terkirim, menyetel flag restart pada pesan berikutnya agar UI membuang layar yang sedang digambar, dan lanjut sampling pada rate baru tanpa rangkaian menyadarinya.
Instrumen meja kerja
funcgen, scope dan multimeter adalah tiga instrumen yang kamu letakkan di kanvas dan sambungkan kabelnya, dan semuanya adalah komponen biasa: tidak ada jalur istimewa ke engine, tidak ada yang tidak dideskripsikan katalog.
funcgenadalahgeneratordengan gelombang sawtooth dan impedansi output nyata: 50 ohm, distempel sebagai pasangan Norton (sumber arusv(t)/50dengan 50 ohm paralel dengannya) karena sebuah komponen tidak punya node internal untuk menggantung resistor seri. Sebuah beban membagi tegangan terhadapnya, dan itulah hal pertama yang diajarkan generator meja kerja.generatortetap ideal dan masih menjadi komponen yang tepat untuk menggerakkan sebuah node dan melupakannya.scopeadalah dua probe 1 Mohm dan satu ground clip; ia bergabung ke sebuah pulau terisolasi, tidak pernah menumbuhkan satu.multimeteradalah 10 Mohm antaraVdanCOMpada rentang volts, shunt 1 ohm antaraAdanCOMpada rentang arus (keduanya meneruskan sebuah Thevenin di jalur digital cepat dan distempel saat sebuah island mencapainya), dan, pada ohms dan continuity, arus uji 30 uA dengan 100 kohm paralel, yang memang menumbuhkan sebuah island. Ia mengintegrasi selama aperture 250 ms pada 4 kHz dan menerbitkan satu pembacaan empat kali per detik: rata-rata pada rentang DC, RMS sejati dari komponen AC pada rentang AC, dan, pada ohms, resistansi yang tersirat oleh arus uji itu,NaNdi atas 1 Mohm. Di atas kira-kira satu kilohertz pembacaan AC under-sampled dan terbaca lebih rendah.
Contact bounce pada pushbutton
Saklar taktil sungguhan menutup, memantul, lalu menetap, jadi pushbutton bergetar pada setiap penekanan dan setiap pelepasan. Properti bounce-nya memilih profilnya:
bounce |
transisi per penekanan atau pelepasan | menetap dalam |
|---|---|---|
none |
1 | seketika |
typical |
3 sampai 8 | 1 sampai 5 ms |
worst |
hingga 20 | 10 sampai 20 ms |
Bawaannya adalah typical: pilih none saat tombol bukan inti rangkaian, dan worst untuk menunjukkan mengapa sebuah sketch harus melakukan debounce. Semua yang tersambung ke tombol melihat getaran itu sebagai edge biasa (input 74HC, trigger NE555, GPIO board), karena tombol menggerakkan net-nya seperti biasa; tidak ada yang lain dalam kontraknya yang berubah.
Setiap burst dimulai dengan satu edge seketika (kontak memang menutup saat ditekan) dan memainkan sisanya sebagai wakeup pada timing wheel, yang terakhir mendarat tepat pada waktu settle. Jumlahnya ganjil, jadi sebuah burst selalu berakhir pada keadaan yang diminta. Poke yang datang di tengah burst (dilepas saat masih bergetar) membatalkan sisanya dan memulai burst baru. Panjang celah berasal dari stream acak per komponen yang di-seed dari indeks komponen di netlist, jadi dua tombol dalam satu rangkaian bergetar berbeda, penekanan berturut-turut berbeda, dan netlist yang sama di-poke dengan cara yang sama menghasilkan edge yang sama hingga pikodetik: sebuah run bisa direproduksi.
Visual sebuah komponen bisa mendeklarasikan interaction: 'hold' (pointer ditekan men-poke 1, dilepas men-poke 0) atau 'toggle' (satu klik men-poke 0 saat probe minimal 0,5, selain itu 1). Kanvas tidak pernah menyebut nama tipe komponen.
Semua yang dibutuhkan UI untuk menggambar komponen ada di web/. Semua yang dibutuhkan komponen untuk berperilaku ada di crates/parts. Mereka bertemu hanya pada type, nama pin, dan props.
5. Run loop (sisi UI)
Sim.runForNs(ns) memajukan waktu tersimulasi sebesar ns lalu kembali, dengan nowNs() melaporkan total baru. UI memanggilnya dari requestAnimationFrame, menargetkan waktu tersimulasi = waktu nyata, dengan anggaran wall time per frame (misalnya 12 ms); jika simulator tertinggal, UI menampilkan rasio kecepatan yang tercapai alih-alih membeku. Simulator berjalan di Web Worker (web/src/sim/client.ts), jadi halaman tetap responsif selama itu berlangsung.
probes(), netLevels() dan netEdges() dibaca sekali per frame, bersamaan, ke dalam snapshot yang dilukis UI darinya. netEdges() ada karena level yang dibaca sekali per frame hanya menunjukkan hasil akhir tiap net: kontak yang memantul membuat dua puluh edge dalam beberapa milidetik, sepenuhnya di dalam satu frame 16 ms, dan pelajaran yang meminta edge itu harus bisa menghitungnya. Sebuah edge adalah perubahan level bersih (rendah ke unknown ke tinggi adalah satu; rendah ke floating ke rendah adalah nol), dan flip yang ditarik kembali di dalam saat yang sama tidak dihitung sama sekali. Membaca hitungannya me-reset hitungan itu, jadi frame loop adalah satu-satunya pemanggil. netVoltages() dibaca pada pass yang sama tetapi hanya saat ada sesuatu di halaman yang menampilkan volt: readout Show levels (web/src/ui/levels.ts), yang mati secara bawaan. Snapshot yang tidak memintanya membawa array kosong, jadi tegangan net per net per frame tidak berbiaya apa pun sampai dibaca.
6. Model listrik
Setiap driver pada sebuah net adalah tegangan dengan impedansi sumber (Drive { voltage, impedance, level }). Tegangan sebuah net adalah rata-rata terbobot impedansi dari driver-drivernya (Millman). Output digital kuat punya puluhan ohm, pull-up punya nilai resistornya, highZ tak terhingga. level digital sebuah net berasal dari driver berimpedansi terendah; jika driver berimpedansi sama tidak sepakat, hasilnya Unknown; tanpa driver, hasilnya Floating. Komponen dua terminal membaca ekuivalen Thevenin yang terlihat dari satu pin, tidak termasuk kontribusinya sendiri, dan menggerakkan pin lainnya sesuai itu.
Itulah jalur cepat, dan itulah yang masih dilakukan setiap net tanpa apa pun yang analog padanya.
6a. Island analog
Komponen yang perilakunya adalah persamaan diferensial atas beberapa node sekaligus (kapasitor, induktor, op-amp, generator sinyal) mendeklarasikan dirinya analog lewat kapabilitas Component::analog, dan kernel mengumpulkan setiap net yang disentuhnya ke dalam sebuah island yang diselesaikan sebagai satu matriks oleh crates/analog: modified nodal analysis, LU dengan partial pivoting, titik kerja DC saat power-on dengan setiap kapasitor dalam keadaan kosong (tidak bermuatan) dan setiap induktor berarus nol, dan transient dengan companion model trapesoidal serta langkah yang dipilih oleh local truncation error.
Dua belahan itu bertemu di tiga tempat dan tidak di tempat lain.
- Masuk. Setiap driver pada net island yang tidak termasuk dalam island tersebut diringkas oleh Millman menjadi satu tegangan di belakang satu resistansi dan distempel sebagai sumber Thevenin pada node itu. Pin digital adalah sumber Thevenin; itulah seluruh antarmukanya.
- Keluar. Island memiliki satu slot driver di setiap net miliknya, seperti pin lainnya, dan menulis Thevenin equivalent milik island itu sendiri pada node tersebut (island dengan driver batas net itu dikeluarkan), sehingga menyelesaikan keduanya dengan aturan Millman biasa mereproduksi tegangan node yang telah diselesaikan secara tepat.
- Waktu. Island mencatat langkah berikutnya miliknya sendiri pada roda waktu. Island yang sudah stabil tanpa sumber yang bergerak tidak mencatat apa pun, jadi rangkaian analog yang menganggur biayanya sama dengan rangkaian digital yang menganggur.
Komponen dengan ambang input analog (komparator, dua titik trip pada 555) memanggil Ctx::watch(pin, volts, hysteresis); island lalu memperhalus langkahnya agar tepat menempel pada persilangan alih-alih melompatinya, sehingga waktu trip akurat hingga satu mikrodetik, bukan hanya sepanjang satu langkah integrasi. Di luar island, panggilan itu tidak menimbulkan biaya apa pun dan tidak mengubah apa pun. Input digital pada mikrokontroler melakukan hal yang sama lewat Ctx::read_input(pin, threshold), yang mengawasi pin pada level switching milik chip itu sendiri lalu membacanya: setiap board membaca pad inputnya dengan cara ini, sehingga tepi analog yang lambat sampai ke komponen 3,3 V dan komponen 5 V pada tegangan yang benar-benar membuat masing-masing berpindah, bukan pada satu LOGIC_THRESHOLD milik kernel. Pin input tidak memberi beban apa pun pada island selain pull-up atau pull-down yang diaktifkan firmware-nya; kebocoran sub-mikroampere dari input CMOS sungguhan tidak dimodelkan.
Island melangkah paling cepat setiap 2 ms dan paling lambat setiap 100 ns, dan menahan langkahnya pada satu per enam puluh empat dari konstanta waktu apa pun yang bergerak paling cepat, sehingga trace yang disampel di antara langkah tidak pernah tertinggal lebih dari itu. Resistor bergabung ke island yang menjangkaunya tapi tidak pernah membuat island baru; probe osiloskop adalah 1 Mohm ke ground clip-nya dan berperilaku sama.
6b. Island nonlinier
Komponen dengan fisika perangkat di dalamnya (dioda, LED, transistor bipolar, MOSFET) mendeklarasikan AnalogPart::devices bersama elemennya dan menamai mereka dari Element::Device { nodes: [Node; 4], dev: u32 }, yang dev-nya mengindeks daftar perangkat milik komponen itu sendiri. Element tetap Copy; perangkatnya berupa Box<dyn Device> di island. Kernel menggeser indeks perangkat setiap komponen saat menggabungkan komponen ke dalam sebuah island dan tidak tahu apa pun selain itu: tidak ada nama perangkat yang sampai ke sim-kernel, dan fisikanya sepenuhnya tinggal di crates/parts di balik trait yang didefinisikan di crates/analog.
Sebuah Device melakukan tiga hal. Ia loads model pendamping (konduktansi dan sumber arus ekuivalen) dari tegangan terminal pada iterasi saat ini. Ia limits tegangan yang dihasilkan solve terakhir sebelum load berikutnya, yang untuk persambungan pn adalah pnjlim milik SPICE dan menjadi pembeda antara dioda yang konvergen dan yang meluapkan exp. Dan ia melaporkan parameters-nya sebagai vektor angka biasa, sehingga Ctx::restamp_device(which, params) bisa memindahkan beta tanpa membangun ulang island, persis seperti Ctx::restamp memindahkan resistansi.
Solve-nya adalah Newton-Raphson: load setiap perangkat, faktorkan, solve, uji setiap unknown terhadap reltol |x| + abstol (volt pada baris node, ampere pada baris cabang), limit, ulangi, sampai batas Limits::max_iter. Island tanpa perangkat hanya butuh satu pass dan menghasilkan matriks yang selalu dihasilkannya dulu, yang ditegaskan oleh tes buku teks hingga digit terakhir. Titik kerja yang tidak bisa dicapai Newton dari awal dingin beralih ke gmin stepping (kebocoran skala miliohm di setiap node, diturunkan bertahap sampai GMIN), lalu ke source stepping, lalu melaporkan kegagalan alih-alih berpura-pura. Langkah transient yang tidak konvergen dibagi dua dan dicoba ulang pada anggaran yang sama dengan pengendali error; di lantai bawahnya, iterasi dibiarkan berdiri dan kegagalannya dihitung dalam Solver::stats(), yang juga membawa jumlah iterasi, iterasi ter-limit, dan langkah yang ditolak sehingga tes bisa menegaskannya alih-alih bergantung pada waktu dinding.
Perangkat di fase 1: dioda (Shockley dengan Is, N, dan Rs bulk), LED (junction yang sama dengan tegangan maju sesuai warnanya pada 20 mA), transistor bipolar (Ebers-Moll dalam bentuk transportnya dengan Bf, Br, Is dan tegangan Early, NPN dan PNP; sejak Oktober 2026 komponen transistor memakai model Gummel-Poon penuh pada kartu masing-masing vendor) dan MOSFET (Shichman-Hodges level 1 dengan Vto, beta, dan lambda, kanal N dan P). Sebuah komponen memakai perangkat yang sama di dalam maupun di luar island: komponen dua terminal menyelesaikan satu loop melalui dirinya sendiri terhadap persamaan yang sama, dan komponen tiga terminal membangun island pribadi bertiga node dengan perangkatnya sendiri di dalamnya lalu memanggil solver yang sama. Ada satu model per perangkat dan tidak pernah dua.
Itulah perangkat fase 1. Sejak itu analisis-analisisnya telah hadir (titik kerja, sweep DC dan parameter, serta respons frekuensi AC, bagian 7), setiap kartu perangkat membawa kapasitansi persambungannya, dan op-amp adalah makromodel satu kutub. Di kanvas, suhu masih tetap 27 C; sebuah deck SPICE (bagian 7e) punya .temp.
Apa yang dilakukan implementasi ini yang tidak disebut oleh tiga aturan di atas
- Island ditemukan sekali saja, di
Kernel::init. Kernel membekukan topologinya di sana, jadi perubahan kabel berarti netlist baru dan kernel baru, dan memang itulah yang sudah dilakukan UI pada setiap edit. Tidak ada penemuan ulang inkremental dan tidak perlu ada. - Komponen diberi tahu apakah ia bergabung.
Component::analog_joined(bool)dipanggil sekali setelah penemuan. Komponen yang sudah distamp tidak boleh sekaligus menggerakkan pin-nya, dan di sinilah kapasitor berhenti menjalankan integratornya sendiri, resistor berhenti meneruskan Thevenin, dan pot berhenti menggerakkan wipernya. - Komponen bisa meminta nilai hasil solve.
Component::analog_solved(currents, volts)dipanggil setelah setiap solve, untuk elemen yang dideklarasikan komponen itu, ketikaAnalogPart-nya memintanya lewatreporting(). Arus induktor adalah keadaan matriks alih-alih fungsi dari tegangan node, jadi itulah satu-satunya hal yang tidak bisa dibaca kembali oleh komponen dari net miliknya sendiri. - Nilai bisa berubah tanpa membangun ulang.
Ctx::restamp(&[Element])menyerahkan stamp komponen kepada kernel sebagaimana adanya sekarang; kernel mengambil nilainya, membiarkan node-nya tetap, dan menyelesaikan ulang pada saat itu juga sambil menahan setiap tegangan kapasitor dan setiap arus induktor. Knob potensiometer adalah kegunaan utamanya. Bentuk sebuah island tidak pernah berubah; hanya angka di dalamnya yang berubah. - Pin di udara adalah node tersendiri. Pin analog yang tak tersambung ke apa pun mendapat node baru dengan tidak ada apa-apa selain gmin padanya, sehingga kapasitor dengan satu kaki menggantung menahan muatannya dan tidak menggerakkan apa pun.
- Island parkir pada horizon satu detik. Ia berhenti mencatat langkah ketika tidak ada apa pun yang dipegangnya akan bergerak lebih dari toleransi selama satu detik waktu simulasi berikutnya. Bertanya apakah sesuatu akan terjadi pada step berikutnya adalah pertanyaan yang salah: ekor eksponensial bergerak kurang dari toleransi per langkah jauh sebelum ia tiba.
- Kernel dapat menyatakan seberapa banyak ia selesaikan.
Kernel::island_count,island_of_netdanisland_nodesada untuk pengujian yang menjaga janji jalur cepat tersebut. Sebuah netlist digital tidak membangun island apa pun, dancrates/sim-kernel/tests/kernel.rsmenegaskannya pada rangkaian bukti 497 komponen beserta jumlah dispatch yang selalu dibutuhkan rangkaian itu.
Kedua potensiometer bergabung ke island dengan cara yang sama seperti resistor: satu track adalah dua resistor, R x f dari ujung bawah ke wiper dan R x (1 - f) dari wiper ke ujung atas, dan di luar island keduanya dilipat menjadi sumber Thevenin per pin.
7. Analisis
Panggilan yang tidak memajukan waktu simulasi. Segala hal lain di permukaan lewat runForNs; panggilan ini menjalankan sebuah analisis dan mengembalikan jawaban, yang bentuk kontraknya berbeda dan itulah alasan bagian ini ada.
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 dan analogNets memiliki satu entri per net dalam urutan nets[]; probes satu per komponen dalam urutan parts[]. Tegangan yang bukan angka (net mengambang) dikembalikan sebagai null, bukan sebagai angka.
Ia melaporkan solusi yang sedang dipegang engine dan tidak pernah menyelesaikan ulang. Pada tNs nol, sebelum apa pun dijalankan, itu adalah titik kerja saat dinyalakan: setiap kapasitor kosong muatannya, setiap induktor berarus nol. Itu adalah rangkaian yang baru saja dinyalakan dan bukan .op milik SPICE, tempat kapasitor adalah rangkaian terbuka. Untuk jawaban DC yang sudah mantap, jalankan rangkaian sampai mantap lalu ambil titik kerjanya saat itu. tNs ada di hasilnya agar tampilan dapat menyebutkan mana dari keduanya yang sedang ditunjukkan.
analogNets[i] bernilai true bila net i diselesaikan oleh matriks dan false bila diselesaikan oleh model per-driver. Keduanya jenis jawaban yang berbeda dan tampilan harus bisa menyatakannya.
parts hanya berisi komponen yang di-stamp ke dalam island analog, dengan satu entri per elemen yang mereka stamp, dalam urutan stamp. amps positif mengalir dari terminal pertama elemen ke terminal keduanya dan volts adalah tegangan di antara keduanya dalam urutan yang sama. Komponen tanpa entri tidak punya arus cabang di dalam matriks; itu tidak sama dengan tidak punya arus, dan probes biasanya jawabannya di situ: probe sebuah resistor adalah arusnya, termasuk atau tidak di matriks (katalog probe menjelaskan arti probe tiap komponen).
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 boleh ditambahkan ke keduanya; ia menjalankan tiap titik sampai sejauh itu melewati momen dinyalakan sebelum membacanya, dan nilai di atas nol berarti titik itu bukan lagi jawaban 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 sejajar dengan parts dan membawa elemen pertama tiap komponen analog. Analisis yang tidak bisa dijalankan kembali dengan error terisi dan points kosong; ia tidak pernah melempar error.
Dua jalur, karena ada dua jenis hal yang bisa diatur di engine ini.
propmembangun ulang rangkaian di tiap titik dari netlist dengan satu angka itu diubah lalu menyalakannya, jadi setiap titik adalah titik kerja DC dari cold-start, dancontinuedbernilai false. Properti yang bukan angka ditolak dengan pesan, begitu juga properti yang tidak dimiliki komponen itu.poke: truemenjalankan kode poke komponen pada rangkaian yang hidup (poros sebuah potensiometer), yang me-restamp dan menyelesaikan ulang di tempat, jadicontinuedbernilai true dandiscretebernilai true, karena poros berupa hitungan utuh, bukan kontinum. Komponen dikembalikan ke keadaan saat sweep menemukannya.
Jumlah titik terbanyak dalam satu sweep adalah 1001. Lebih dari itu ditolak dengan jumlahnya disebutkan di pesan, bukan dijalankan.
7c. setMaxStepNs(ns, fixed) dan stepLimitNs()
Limits.dt_max sebagai pengaturan. ns adalah langkah terpanjang yang boleh diambil island analog mana pun; fixed juga mengunci batas bawah ke nilai itu, sehingga pengendali error hanya punya satu langkah untuk dipilih. Nol atau kurang menghapusnya dan mengembalikan setiap island ke batas atas 2 ms milik kernel sendiri.
Dua hal masih memendekkan langkah yang dipaksa dan keduanya disengaja: diskontinuitas sumber dijatuhkan tepat di titiknya, bukan diintegrasikan tembus, dan ambang logika yang dipantau di dalam satu langkah dihaluskan tepat ke persilangannya. Tidak ada yang pernah memperpanjangnya, jadi langkah yang dipaksa adalah janji "sekurang-kurangnya sehalus ini".
Sebuah komponen bisa meminta hal yang sama untuk island-nya sendiri dengan Ctx::limit_step(dt, fixed), dan permintaan terhalus pada sebuah island yang menang. Properti step milik komponen scope adalah panggilan itu: nol, bawaannya, membiarkan pengendali sendiri.
7d. acSweep(specJson: string): string
{ "source": "gen1", "probe": 4, "fStart": 10, "fStop": 100000, "pointsPerDecade": 20 }
input boleh ditambahkan: indeks net yang menjadi acuan pengambilan gain. Bila ditinggalkan, itu adalah net yang didorong oleh elemen sumber itu sendiri, yang memang maksud orang saat memilih sebuah generator.
{
"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": ""
}
Lima array itu sejajar dan panjang satu entri per frekuensi. magDb dan phaseDeg adalah ratio fasor keluaran terhadap fasor masukan (20 log10 |Vout / Vin| dan arg(Vout / Vin) dalam derajat), satu-satunya hal di sini yang merupakan fungsi transfer. inputMag dan outputMag adalah besar fasor mentah dalam satuan apa pun rangsangannya, dan source.drive menyebutkan yang mana: vsource satu volt melintasi sumber, isource satu amp ke dalamnya, thevenin satu volt rangkaian terbuka di belakang resistansinya. Generator fungsi adalah pasangan Norton, jadi drive-nya isource dan inputMag-nya adalah impedansi dalam ohm, bukan volt; rasionya tidak terpengaruh, dan justru itulah gunanya melaporkan rasio.
freq adalah fStart * 10^(k / pointsPerDecade) sampai dan termasuk fStop, grid yang sama dengan yang dilalui .ac dec, jadi sweep di sini dan sweep di simulator referensi dengan tiga angka yang sama dapat dibandingkan titik demi titik. fStart harus di atas nol: nol hertz adalah DC, yang merupakan titik kerja, bukan titik sebuah sweep logaritmik. Jumlah titik terbanyak dalam satu sweep adalah 1001, batas yang sama dengan sweep.
Ia diambil di sekitar titik kerja yang sedang dipegang engine, persis seperti yang dilaporkan operatingPoint, dan tidak menyelesaikan ulang apa pun. Pada tNs nol itu adalah bias saat dinyalakan; setelah waktu berjalan, itu adalah keadaan pada saat itu, dan tNs menyebutkan yang mana. Setiap perangkat nonlinier dilinearkan pada iterasi terakhir yang ditinggalkan Newton, dan setiap op-amp dalam mode mana pun titik kerja menempatkannya: op-amp yang jenuh di-stamp jenuh, jadi penguatan small-signal-nya nol.
Sejak Analog 3 fase 1 setiap kartu komponen membawa kapasitansi junction-nya sendiri, dan stempel AC-nya j w C pada dQ/dv yang sama yang diintegrasikan oleh transient, jadi sebuah transistor memiliki batas frekuensi tinggi tersendiri dan tahap common-emitter menunjukkan efek Miller. Yang tidak dimiliki model ada di crates/analog/src/ac.rs dan diulang di docs/help/editor/analysis.md: BJT tidak punya reverse transit time TR, kapasitansi gate-drain MOSFET bernilai konstan sehingga tidak ada plateau Miller, Darlington TIP120 tidak punya kapasitansi sama sekali; tidak ada analisis noise dan analisis distorsi, karena rangkaian yang dilinearkan tidak punya keduanya; dan op-amp masih yang linear dengan batas rail dan penguatan datar sampai frekuensi tak terhingga.
Analisis yang tidak bisa dijalankan kembali dengan error terisi dan array kosong; ia tidak pernah melempar error. Tiga hal yang bisa salah menyebutkan yang mana: komponen yang disebut tidak punya sumber yang bisa digerakkan oleh analisis AC, sebuah net tidak berada di pulau analog yang sama dengan sumbernya, atau rentangnya bukan rentang yang valid.
7e. spiceRun(deck: string, filesJson: string): string
Fungsi bebas dari modul, bukan method dari Sim: ia menjalankan deck SPICE di crates/spice dan tidak berhubungan dengan rangkaian apa pun yang dimuat. filesJson berupa [{ "name": "models.lib", "text": "..." }], file yang bisa .include atau .lib oleh deck (dicocokkan dengan nama persis, lalu dengan nama file saja), atau string kosong. Jawabannya:
{ "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.