Mokxi mô phỏng một mạch bằng ba engine, và trang này là hợp đồng mà mỗi engine phải tuân theo.
- Nhân kỹ thuật số. Một nhân điều khiển bằng sự kiện chạy mọi vi điều khiển, chip logic và đường nối kỹ thuật số. Điện áp của một đường nối đến từ các bộ kéo trên đó, mỗi bộ kéo là một nguồn điện áp sau một trở kháng nguồn, và mức logic lấy từ bộ kéo mạnh nhất (mục 6). Nhờ vậy vài trăm linh kiện cùng một lõi CPU chạy thời gian thực ngay trong một thẻ trình duyệt.
- Các đảo analog. Tụ điện, cuộn cảm, khuếch đại thuật toán, máy phát tín hiệu, diode hay transistor sẽ kéo các đường nối nó chạm vào thành một đảo, và đảo được giải bằng một ma trận duy nhất với phương pháp phân tích nút cải tiến, sau các bán dẫn là các mô hình: diode Shockley, transistor Gummel-Poon và MOSFET level 1, mỗi loại có điện dung tiếp giáp, giải bằng Newton-Raphson (mục 6a và 6b). Trên khung vẽ bạn có thể đọc điểm làm việc DC, quét một giá trị và vẽ đáp ứng tần số (mục 7).
- Trình chạy SPICE deck. Run a SPICE deck, trong menu trình soạn thảo, chạy một netlist SPICE trên engine riêng:
.op,.tran,.ac,.dcvới quét lồng nhau,.tf,.noisevà.meas, kèm mạch con, tham số,.include, BJT Gummel-Poon, MOSFET level 1 đến 3, JFET, nguồn hành vi và.temp. Nó được đối chiếu với ngspice trên 42 mạch chuẩn, mỗi mạch trong dung sai công bố (mục 7e).
Nói rõ ràng, mỗi cái không làm những gì:
- Khung vẽ trực tiếp không có phân tích nhiễu, nhiệt độ hay méo tín hiệu, và không có hàm truyền; mọi nút nối trên đó đều ở 27 C. Khuếch đại thuật toán của nó là macromodel một cực với tích gain-bandwidth, tốc độ chuyển đổi, headroom, điện áp lệch và giới hạn dòng, nhưng không có cực thứ hai.
- Trình chạy SPICE deck không chạy mô hình MOSFET BSIM, đường truyền có tổn hao, thiết bị XSPICE, hay các phân tích
.four,.sens,.pzvà.disto, và nó nói rõ điều đó, từng dòng, khi một deck dùng đến. Không có phân tích Monte Carlo và không có thư viện mô hình của nhà sản xuất. - Không linh kiện nào có định mức công suất. Linh kiện không bao giờ cháy, nguồn không bao giờ sụt và chân không có giới hạn dòng, nên một mạch chạy tốt ở đây vẫn có thể hỏng trên bàn thí nghiệm (cách linh kiện được mô hình hóa).
Hợp đồng
Phần còn lại của trang này là ranh giới giữa trình mô phỏng Rust (các crate: sim-kernel, parts, analog, spice, sim-wasm) và UI TypeScript (web/). Cả hai phía đều build theo tệp này. Muốn thay đổi thì phải sửa tệp này trước.
1. Netlist JSON (UI -> trình mô phỏng)
UI quản lý sơ đồ (vị trí, dây nối, breadboard). Trước khi bắt đầu mô phỏng, nó làm phẳng sơ đồ thành một netlist: các dải breadboard và dây nối được gộp bằng union-find thành các đường nối. Breadboard không bao giờ đến trình mô phỏng.
{
"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"]
]
}
- Thứ tự
parts[i]định nghĩapartIndexđược dùng bởiprobes()vàpoke(). - Thứ tự
nets[j]định nghĩanetIndexđược dùng bởinetLevels()vànetVoltages(). - Tham chiếu chân là
"<partId>:<pinName>". Tên chân lấy từ danh mục. Kiểu linh kiện lạ, chân lạ, hay một chân nằm trên hai đường nối là lỗi tạicreate. - Thuộc tính không được cung cấp thì lấy mặc định từ danh mục. Thuộc tính lạ sẽ gây lỗi.
- Một đường nối có thể chứa một chân duy nhất. Giao diện tạo ra một đường nối như vậy khi một chân nằm một mình trên dải breadboard (một nút thực, cần cho công tắc); trình mô phỏng chấp nhận điều đó.
2. Tầng WASM (crates/sim-wasm, wasm-bindgen, --target web)
Rust dùng snake_case; xuất bằng js_name để TypeScript thấy đúng như sau:
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;
Một vòng lặp không hội tụ sẽ không làm dừng lần chạy. Khi một khoảnh khắc của thời gian mô phỏng cần hơn 1000 chu kỳ delta (các linh kiện truyền một đường nối qua lại trong thời gian bằng không, thường là hai linh kiện mỗi cái có hai chân cắm trong cùng một hàng breadboard), engine sẽ cắt vòng lặp tại chỗ: các đường nối vẫn đang thay đổi được giải quyết lần cuối rồi giữ nguyên tại đó, thời gian vẫn trôi, và mọi lần gọi cứ tiếp tục trả về 0. Khoảnh khắc đó được báo cáo một lần mỗi vòng lặp mỗi lần chạy qua takeUnsettled(), nets là các chỉ số vào nets[]; trình soạn thảo biến nó thành một dòng trong Serial Monitor và một phát hiện của Circuit Doctor (web/src/ui/unsettled-watch.ts). Sau 16 khoảnh khắc như vậy trong một lần chạy, mỗi khoảnh khắc tiếp theo bị cắt tại 200 chu kỳ delta, nên một vòng lặp kích hoạt ở mọi sườn của một PWM nhanh không thể làm đóng băng trang. Các mã 1 = oscillation phía trên vẫn được giữ cho các trường hợp chỉ số sai và cho engine dựng trước khi có tính năng này.
Build: wasm-pack build --target web --release --out-dir ../../web/src/sim/wasm --out-name sim crates/sim-wasm (các tùy chọn đứng trước đường dẫn crate). Kết quả được commit vào git để UI build được mà không cần Rust.
3. Catalog JSON (trình mô phỏng -> 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 cho biết loadProgram nhận gì cho linh kiện này ("elf32 riscv32imc" cho một bo mạch), hoặc null. host cho biết kênh byte của host mang gì ("utf-8 bytes on UART0"), hoặc null. Linh kiện có kênh host chính là thứ mà Serial Monitor giao tiếp.
dir là in, out, hoặc inout. kind là number, string, hoặc bool. options là tùy chọn; khi có thì UI hiển thị một ô chọn. Một prop kiểu number còn mang theo khoảng giá trị nhận được, min và max, với "minOpen": true khi chính min bị từ chối và "integer": true nếu chỉ nhận số nguyên (crates/parts/src/ranges.rs, tối đa 1e15 mỗi chiều); việc tạo linh kiện sẽ từ chối giá trị ngoài khoảng, và bảng thuộc tính chặn ngay khi nhập. Phần hiển thị của linh kiện trong UI (web/src/parts/<type>.ts) phải khai báo vị trí chân cho mọi chân trong catalog và không thêm gì khác; một test trong web/ kiểm tra điều này với web/src/sim/wasm/catalog.json, mà bước build wasm cũng ghi ra.
4. Các kiểu linh kiện được cố định cho khung UI giai đoạn 1
Phía kernel chuyển giao những linh kiện này trước để UI có thứ để thao tác. Các linh kiện khác đến từ các part agent và chỉ thêm mục mới.
| type | pins | props | probe | poke |
|---|---|---|---|---|
led |
A, C |
color string (đỏ) |
brightness 0..1 | không có |
resistor |
1, 2 |
value ôm (1000) |
dòng điện theo ampe | không có |
pushbutton |
1a, 1b, 2a, 2b (1a-1b nối tắt, 2a-2b nối tắt, nhấn sẽ nối hai cặp) |
bounce string ("typical", một trong none/typical/worst), xem 4a |
1 là đang nhấn, 0 là đã nhả | 1 = nhấn, 0 = nhả |
vcc |
VCC |
voltage (5) |
điện áp | không có |
gnd |
GND |
không có | 0 | không có |
clock |
OUT |
hz (1) |
1 khi mức cao, 0 khi mức thấp | không có |
4a. Bộ linh kiện giai đoạn 1 (thêm sau shell, chỉ được phép nối thêm vào cuối)
Đơn vị: resistor.value ohm, capacitor.value microfarad. Chip liệt kê chân theo thứ tự số chân của vỏ. Que đo mang nhiều hơn một bit sẽ đóng gói thành bitmask trong f32.
| type | pins | props | probe | poke |
|---|---|---|---|---|
capacitor |
1, 2 |
value number (10) |
điện áp trên hai đầu nó, V(1) - V(2) | không có |
gate |
A, B, Y |
function string ("and", một trong and/or/nand/nor/xor/xnor) |
1 khi Y mức cao, 0 khi mức thấp, 0.5 khi không xác định | không có |
not |
A, Y |
không có | 1 khi Y mức cao, 0 khi mức thấp, 0.5 khi không xác định | không có |
bitin |
Q |
label string ("A"); value (0, 0 hoặc 1) |
1 khi Q mức cao, 0 khi mức thấp | 0 kéo Q xuống mức thấp, 1 lên mức cao; dẫn qua điện trở kéo, nên bất kỳ ngõ ra nào trên đường nối cũng thắng |
bitout |
A |
label string ("Y"); color string ("green", một trong green/red/amber/blue) |
1 mức cao, 0 mức thấp, 0.5 không xác định hoặc không được điều khiển | không có |
bytein |
D0..D7 |
label string ("A"); value (0, 0 đến 255); width (8, 1 đến 8) |
giá trị trên D0..D(width-1); các chân trên width ở trạng thái high-Z | 0..255 đặt giá trị (che theo độ rộng); 2^32 đếm tăng lên một |
byteout |
D0..D7 |
label string ("S"); width (8, 1 đến 8) |
giá trị, các bit không được điều khiển tính là 0; -1 khi có bit được điều khiển mà không xác định | không có |
bitconst |
Q |
value (0, 0 hoặc 1) |
giá trị mà nó điều khiển ra | không có; điều khiển push-pull, giống ngõ ra của cổng logic |
stepclock |
CLK |
hz (2); chuỗi mode ("step", một trong step/run) |
mức (0 hoặc 1), cộng thêm 2 khi đang chạy tự do | 0 dừng lại (chế độ từng bước), 1 chạy tự do, 2 tạo một xung (mức cao rồi mức thấp sau nửa chu kỳ) khi đang dừng |
progrom |
A0..A7 vào; C0..C7, K0..K7 ra |
chuỗi program (hợp ngữ Kestrel, crates/parts/src/kestrel.rs) |
địa chỉ đang được đọc; -1 khi chưa xác định | không có; từ tại địa chỉ sẽ đưa ra C (byte cao) và K (byte thấp) sau 10 ns |
terminal |
D0..D7, WE, CLK |
chuỗi mode ("text", một trong text/numbers) |
số byte đã ghi từ lúc cấp nguồn | không có; kênh máy chủ: mỗi byte được ghi tại sườn lên của CLK khi WE ở mức cao |
sevenseg |
E, D, COM1, C, DP, G, F, COM2, A, B |
chuỗi common ("cathode", một trong cathode/anode); chuỗi color ("red", một trong red/green/blue/yellow/white) |
các đoạn sáng dưới dạng bitmask 0..255: bit 0 A, 1 B, 2 C, 3 D, 4 E, 5 F, 6 G, 7 DP | không có |
slideswitch |
1, 2, 3 |
không có | 0 = chân chung ở chân 1, 1 = chân chung ở chân 3 | 0 = nối 2 với 1, 1 = nối 2 với 3 |
buzzer |
1, 2 |
không có | 1 khi kêu, 0 khi im lặng | không có |
74hc00 |
1A, 1B, 1Y, 2A, 2B, 2Y, GND, 3Y, 3A, 3B, 4Y, 4A, 4B, VCC |
không có | các ngõ ra dưới dạng bitmask, bit 0 = 1Y .. bit 3 = 4Y; 0 khi không có nguồn | không có |
74hc08 |
sơ đồ chân giống 74hc00 |
không có | tương tự | không có |
74hc32 |
sơ đồ chân giống 74hc00 |
không có | tương tự | không có |
74hc86 |
sơ đồ chân giống 74hc00 |
không có | tương tự | không có |
74hc04 |
1A, 1Y, 2A, 2Y, 3A, 3Y, GND, 4Y, 4A, 5Y, 5A, 6Y, 6A, VCC |
không có | các ngõ ra dưới dạng bitmask, bit 0 = 1Y .. bit 5 = 6Y; 0 khi không có nguồn | không có |
74hc74 |
1RD, 1D, 1CP, 1SD, 1Q, 1QN, GND, 2QN, 2Q, 2SD, 2CP, 2D, 2RD, VCC |
không có | Các ngõ ra Q dưới dạng bitmask, bit 0 = 1Q, bit 1 = 2Q; 0 khi không được cấp nguồn hoặc X | không có |
74hc595 |
Q1, Q2, Q3, Q4, Q5, Q6, Q7, GND, Q7S, MR, SHCP, STCP, OE, DS, Q0, VCC |
không có | byte trên Q0..Q7, bit 0 = Q0; 0 khi OE ở mức cao hoặc không có nguồn | không có |
ne555 |
GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC |
không có | 1 khi OUT ở mức cao, 0 khi ở mức thấp hoặc không có nguồn | không có |
tlc555 |
GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC |
không có | 1 khi OUT ở mức cao, 0 khi ở mức thấp hoặc không có nguồn | không có |
ne556 |
1DIS, 1THR, 1CTRL, 1RESET, 1OUT, 1TRIG, GND, 2TRIG, 2OUT, 2RESET, 2CTRL, 2THR, 2DIS, VCC |
không có | bit 0 = 1OUT, bit 1 = 2OUT ở mức cao | không có |
inductor |
1, 2 |
value milihenry (100) |
dòng điện theo ampe, dương từ chân 1 đến chân 2 | không có |
opamp |
IN+, IN-, OUT, V+, GND |
độ lợi (100000) |
điện áp ngõ ra so với chân GND | không có |
lm358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT trên mức giữa nguồn | không có |
lm324 |
1OUT, 1IN-, 1IN+, VCC, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, GND, 4IN+, 4IN-, 4OUT |
offset milivolt (0) |
bit 0 = 1OUT .. bit 3 = 4OUT trên mức giữa nguồn | không có |
tl072 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT trên mức giữa nguồn | không có |
lm741 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, NC |
offset milivolt (0) |
1 khi OUT cao hơn mức giữa nguồn | không có |
ne5532 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT trên mức giữa nguồn | không có |
lm833 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT trên mức giữa nguồn | không có |
opa2134 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT trên mức giữa nguồn | không có |
mcp6002 |
VOUTA, VINA-, VINA+, VSS, VINB+, VINB-, VOUTB, VDD |
offset milivolt (0) |
bit 0 = VOUTA, bit 1 = VOUTB trên mức giữa nguồn | không có |
mcp6004 |
VOUTA, VINA-, VINA+, VDD, VINB+, VINB-, VOUTB, VOUTC, VINC-, VINC+, VSS, VIND+, VIND-, VOUTD |
offset milivolt (0) |
bit 0 = VOUTA .. bit 3 = VOUTD trên mức giữa nguồn | không có |
lmv358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT trên mức giữa nguồn | không có |
tl081 |
NULL1, IN-, IN+, VCC-, NULL2, OUT, VCC+, NC |
offset milivolt (0) |
1 khi OUT cao hơn mức giữa nguồn | không có |
tl084 |
1OUT, 1IN-, 1IN+, VCC+, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, VCC-, 4IN+, 4IN-, 4OUT |
offset milivolt (0) |
bit 0 = 1OUT .. bit 3 = 4OUT trên mức giữa nguồn | không có |
op07 |
NULL1, IN-, IN+, V-, NC, OUT, V+, NULL2 |
offset milivolt (0) |
1 khi OUT cao hơn mức giữa nguồn | không có |
ca3140 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, STROBE |
offset milivolt (0) |
1 khi OUT cao hơn mức giữa nguồn | không có |
lm393 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
offset milivolt (0) |
bit 0 = 1OUT, bit 1 = 2OUT mở (IN+ cao hơn IN-) | không có |
lm339 |
1OUT, 2OUT, VCC, 2IN-, 2IN+, 1IN-, 1IN+, 3IN-, 3IN+, 4IN-, 4IN+, GND, 4OUT, 3OUT |
offset milivolt (0) |
bit 0 = 1OUT .. bit 3 = 4OUT được nhả | không có |
lm311 |
EMIT, IN+, IN-, VCC-, BAL, STRB, COL, VCC+ |
offset milivolt (0) |
1 khi COL được nhả (hoặc khi có xung strobe) | không có |
uln2003a |
1B, 2B, 3B, 4B, 5B, 6B, 7B, E, COM, 7C, 6C, 5C, 4C, 3C, 2C, 1C |
không có | bit 0..6 = các đầu vào 1B..7B cao hơn E ít nhất 1.4 V | không có |
uln2803a |
1B, 2B, 3B, 4B, 5B, 6B, 7B, 8B, GND, COM, 8C, 7C, 6C, 5C, 4C, 3C, 2C, 1C |
không có | các bit 0..7 = các đầu vào 1B..8B cao hơn GND ít nhất 1.4 V | không có |
uln2003board |
IN1, IN2, IN3, IN4, VCC, GND, OUT1, OUT2, OUT3, OUT4 |
không có | bit 0..3 = các LED A..D: OUT1..OUT4 thấp hơn VCC từ 1.7 V trở lên | không có |
generator |
OUT, GND |
chuỗi wave ("sine", một trong sine/square/triangle); frequency Hz (1000); amplitude volt đỉnh (2.5); offset volt (2.5); duty phần trăm (50, chỉ dùng cho sóng vuông) |
điện áp ngõ ra so với chân GND | không có |
funcgen |
OUT, GND |
chuỗi wave ("sine", một trong sine/square/triangle/sawtooth); frequency Hz (1000); amplitude volt đỉnh (2.5); offset volt (2.5); duty phần trăm (50, chỉ dùng cho sóng vuông) |
điện áp ngõ ra so với chân GND, ở hai cực | không có |
scope |
CH1, CH2, GND |
window giây (0.02, từ 0.0001 đến 10); volts thang đo đầy đủ (5) |
volt của kênh 1 so với kẹp đất (ground clip) | (1 << 32) | window tính bằng microgiây, hoặc (2 << 32) | toàn thang đo tính bằng millivolt |
multimeter |
V, A, COM |
chuỗi mode ("dcv", một trong dcv/acv/dca/aca/ohms/continuity) |
giá trị đo: volt, ampe hoặc ohm tùy chế độ, NaN khi vượt thang đo hoặc hở mạch | không có |
lm35 |
VS, VOUT, GND |
số temperature (22.5) |
nhiệt độ tính theo độ C | mười phần một độ, cộng thêm 1000 |
aht20 |
VCC, GND, SCL, SDA (I2C tại 0x38) |
số temperature (22); số humidity (45) |
nhiệt độ tính theo độ C | (1 << 32) | (tenths + 1000) nhiệt độ, (2 << 32) | tenths độ ẩm |
bh1750 |
VCC, GND, SCL, SDA, ADDR (I2C tại 0x23, 0x5C khi ADDR mức cao) |
không có | cường độ ánh sáng tính bằng lux | cường độ ánh sáng tính bằng lux, từ 0 đến 100000 |
a3144 |
VCC, GND, OUT (collector hở) |
số operate (210 gauss); số hysteresis (55) |
mã nam châm, cộng 100000 khi OUT đang bật | tính bằng phần mười mm, từ 0 đến 400, cộng thêm 10000 cho cực bắc |
ss49e |
VCC, GND, OUT |
không có | từ trường tại cảm biến tính bằng gauss, cực nam là dương | mười phần của một mm, từ 0 đến 400 (400 là không có nam châm), cộng thêm 10000 cho cực bắc |
photointerrupter |
SIG, VCC, GND (thêm SHAFT khi gắn wheel) |
số slots (20), chuỗi wheel ("": id của dcmotor hoặc encmotor mà bánh xe quay cùng, để trống cho thanh trượt) |
mã bánh xe (RPM, cộng 10000 khi có thẻ cắm), cộng 100000 khi SIG mức cao, cộng 1000000 khi bánh xe nằm trên động cơ | RPM từ 0 đến 600 (bị bỏ qua trên động cơ), cộng 10000 khi cắm thẻ vào |
linearray |
GND, VCC, S1 đến S5 |
số threshold (0.5) |
mã đường, cộng 1000 x các kênh trên nền đen ở dạng bit (bit 0 là S1) | 100 + mm từ cảm biến giữa (40 đến 160); 1 là có vạch đen băng qua; 0 là không có vạch |
fc51 |
OUT, GND, VCC |
số threshold (0.5) |
giá trị vật cản (cm, 80 là không có, cộng 10000 nếu màu đen), cộng 100000 khi đèn sáng | cm từ 1 đến 80, cộng 10000 nếu là vật màu đen |
thermalprinter |
VH, GND, RX, TX, DTR |
baud số (19200); paper logic (true) |
số dòng đã in | giấy: 1 là còn giấy, 0 là hết giấy |
fingerprint |
VCC, GND, TX, RX |
baud số (57600); enrolled số (2); capacity số (162); password số (0) |
ngón tay trên mặt kính, cộng 100 sau khi tìm thấy, 200 sau khi không tìm thấy | ngón tay, từ 1 đến 9, hoặc 0 để nhấc lên |
ds1302 |
VCC, GND, CLK, DAT, RST |
start chuỗi ("2026-01-01 12:00:00"); halted logic (false) |
số giây kể từ nửa đêm, cộng 100000 khi đang tạm dừng | (1 << 32) hoặc số giây kể từ nửa đêm, hoặc (2 << 32) hoặc số ngày kể từ 2000-01-01 |
amg8833 |
VIN, GND, SCL, SDA, INT (I2C tại 0x69) |
address số (105); background số (22); spot số (34); pixel số (27) |
điểm ảnh nóng nhất tính bằng độ C | (1 << 32) nền, (2 << 32) điểm đo, phần mười + 1000; (3 << 32) điểm ảnh của điểm đo, 64 nếu không có |
mlx90614 |
VIN, GND, SCL, SDA (SMBus tại 0x5A) |
object số (36.6); ambient số (22) |
nhiệt độ của vật tính bằng độ C | (1 << 32) vật thể hoặc (2 << 32) môi trường, cộng một phần mười độ + 1000 |
mpr121 |
VIN, GND, SCL, SDA, IRQ, ADDR (I2C tại 0x5A) |
số địa chỉ (90) |
trạng thái chạm: điện cực 0 ở bit 0 | các điện cực có ngón tay chạm vào, dạng mặt nạ bit |
gp2y0a21 |
VO, GND, VCC |
distance số (30) |
khoảng cách tính bằng cm | khoảng cách tính bằng cm, từ 1 đến 150 |
mg996r |
GND, VCC, PWM |
min_pulse số (544); max_pulse số (2400); range số (180) |
góc của cần điều khiển tính bằng độ, từ 0 đến range | không có |
yfs201 |
VCC, GND, SIG |
flow số (0) |
lưu lượng tính bằng lít mỗi phút | lưu lượng tính bằng phần mười lít mỗi phút, từ 0 đến 300 |
adxl335 |
VCC, X, Y, Z, GND |
tilt_x số (0); tilt_y số (0) |
góc nghiêng theo trục X tính bằng độ | (1 << 32) hoặc (2 << 32), cộng góc nghiêng X hoặc Y + 90 |
pulsesensor |
S, VCC, GND |
bpm số (72); swing số (0.8) |
nhịp tim tính bằng nhịp mỗi phút (0 nếu không có ngón tay), cộng 1000 khi đỉnh sóng chính đi qua | nhịp tim tính bằng nhịp mỗi phút, 30 đến 220, hoặc 0 nếu không có ngón tay |
coinacceptor |
DC12V, COIN, GND, COUNTER |
pulse số (50); nc logic (false) |
số xung đã gửi từ khi bật nguồn, cộng 100000 khi COIN đang hoạt động | một đồng xu có giá trị bằng số xung này, từ 1 đến 50 |
waterpump |
V+, V- |
voltage số (6); flow số (120); resistance số (4); inertia số (50); back_emf số (0.85) |
lưu lượng tính bằng lít một giờ | không có |
fanmodule |
INA, INB, VCC, GND |
voltage giá trị số (5); inertia giá trị số (250) |
tốc độ cánh quạt theo phần trăm tốc độ tối đa, âm khi quay ngược | không có |
laser |
S, VCC, GND |
điện trở số (100) |
độ sáng cảm nhận được của chùm tia, từ 0 đến 1 | không có |
trafficlight |
R, Y, G, GND |
điện trở số (220) |
các LED sáng dưới dạng bitmask: bit đỏ là bit 0, bit vàng là bit 1, bit xanh lá là bit 2 | không có |
sw420 |
VCC, GND, DO |
số threshold (0.5) |
0 là yên tĩnh, 1 là rung, 2 là gõ, cộng thêm 100000 khi đèn sáng (DO mức thấp) | 0 là yên tĩnh, 1 là rung đến lần chạm tiếp theo, 2 là một cú gõ |
mq3 thành mq137 (mq3, mq4, mq5, mq6, mq7, mq8, mq9, mq131, mq135, mq137) |
VCC, GND, DO, AO |
gas chuỗi (tùy cảm biến, lấy từ biểu đồ của nó); r0 ôm; rl ôm; threshold số; warmup giây (20) |
khí theo đơn vị của cảm biến (ppm; một phần trăm mg/L với MQ-3; ppb với MQ-131), cộng thêm 100000 khi đèn DO sáng, cộng thêm 200000 khi đang khởi động | khí theo đơn vị đó, từ 0 đến đỉnh của biểu đồ |
ky037 |
AO, GND, VCC, DO |
threshold số (0.505); sensitivity dBV/Pa (-42) |
giống ky038 |
giống ky038 |
ky004, ky017, ky021, ky031 |
S, VCC, GND |
điện trở chuỗi ("pull-up" hoặc "pull-down"); settle ms (ky004 3, ky017 0, ky021 0.5); ky021 close mm (15), release (0.8) |
ky004 1 khi nhấn; ky017 1 khi nghiêng; ky021 là khoảng cách nam châm theo mm; ky031 0 là yên tĩnh, 1 là rung, 2 là gõ | các mã giống nhau |
sw18010p |
1, 2 |
không có | 0 là yên tĩnh, 1 là rung, 2 là gõ | 0 là yên tĩnh, 1 là rung đến lần chạm tiếp theo, 2 là một cú gõ |
ky024, ky025, ky028 |
AO, GND, VCC, DO |
ngưỡng số (0.6, 0.5, 0.45); ky025 đóng mm (15), nhả (0.8); ky028 beta K (3950) |
mã poke, cộng thêm 100000 khi đèn DO sáng (DO mức cao) | ky024 bằng phần mười mm, cộng thêm 10000 khi là cực bắc; ky025 là khoảng cách nam châm theo mm, từ 0 đến 60; ky028 bằng phần mười độ cộng thêm 1000 |
ky035 |
VCC, GND, S |
không có | giống ss49e |
giống ss49e |
temt6000 |
SIG, GND, VCC |
sensitivity uA trên lux (0.5) |
cường độ ánh sáng tính bằng lux | lux, từ 0 đến 2000 |
rotation |
GND, S, VCC |
value ôm (10000); taper chuỗi |
dưới dạng potentiometer |
dưới dạng potentiometer |
steam |
S, VCC, GND |
full tỉ lệ (0.66) |
phần ướt của lược, theo phần trăm | phần trăm, từ 0 đến 100 |
e18d80nk |
VCC, GND, OUT |
range cm (40, từ 3 đến 80); pullup cờ pullup (false) |
khoảng cách đến vật mục tiêu theo cm (100 là không có gì), cộng thêm 100000 khi phát hiện | cm, từ 1 đến 100 |
ttp223 |
SIG, VCC, GND |
toggle bool (false); activelow bool (false) |
bit 0 là ngón tay trên miếng cảm ứng, bit 1 là SIG mức cao | 1 là có ngón tay, 0 là không |
battery |
V+, V- |
kind chuỗi ("9v", một trong 9v/aa2/aa3/aa4/18650/18650x2); charge số (100) |
số vôn giữa hai cực | không có |
solar |
+, - |
không có | vôn trên panel | watt trên mét vuông, từ 0 đến 1200 (1000 là cường độ nắng tối đa) |
tp4056 |
IN+, IN-, BAT+, BAT- |
không có | dòng sạc tính bằng mA, cộng thêm 10000 khi đèn chờ sáng | không có |
regulator |
IN, GND, OUT |
chuỗi model ("7805", một trong 7805/AMS1117-3.3/MCP1700-3.3) |
điện thế của OUT so với GND, tính bằng vôn | không có |
tb6612 |
PWMA, AIN2, AIN1, STBY, BIN1, BIN2, PWMB, GND1, VM, VCC, GND2, AO1, AO2, BO2, BO1, GND3 |
không có | chế độ các kênh, A ở bit 0-1 và B ở bit 2-3: 0 tắt, 1 quay thuận, 2 quay nghịch, 3 phanh | không có |
l9110 |
BIA, BIB, GND, VCC, AIA, AIB, OA1, OA2, OB1, OB2 |
không có | điều khiển động cơ, A ở bit 0-1 và B ở bit 2-3: 0 tắt, 1 tới, 2 lùi, 3 phanh | không có |
encmotor |
M1, M2, VCC, GND, A, B |
các thuộc tính của động cơ thường: voltage (6), rpm (200), resistance (6), inertia (120), back_emf (0.85), cộng thêm số ppr (11) và số ratio (30) |
tốc độ bánh xe tính bằng rpm, có dấu | không có |
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) |
góc nghiêng theo độ, dương là nghiêng về trước | 1 cho đứng thẳng dậy, 3 là thả ra, (2 << 32) | (lực đẩy theo 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 độ), current (1.7 A), max_steps (1000) |
độ sâu của càng gắp tính từ mép trên theo mm; toàn bộ trạng thái nằm trên kênh đo | 1 đặt lại các phần thưởng vào chỗ cũ |
clawcabinetdc |
X+, X-, Y+, Y-, VCC, GND, W+, W-, CLAW, XHOME, YHOME, BEAM |
giống clawcabinet, nhưng thay current và max_steps bằng voltage (6) và rpm (200) của động cơ bánh răng |
giống clawcabinet |
1 đặt lại các phần thưởng vào chỗ cũ |
vendingcabinet |
M1, M2, M3, M4, VCC, GND, DROP |
stock (3 mỗi vòng xoắn), rpm (110) |
các gói snack trong hộc nhận; toàn bộ trạng thái nằm trên kênh đo | 1 nạp lại mọi vòng xoắn và làm rỗng hộc đựng |
pinballcabinet |
FL, FR, VCC, GND, KICK1, KICK2, TA, TB, TC, B1, B2, DRAIN, LAUNCH |
flip_speed (1200 độ mỗi giây) |
độ cao của bóng trên bàn tính bằng mm, bằng -1 khi bóng lăn ngược lại; toàn bộ trạng thái nằm trên kênh đo | 1 đặt bóng lên càng bắn; 0x100 + n giữ công tắc n (TA, TB, TC, B1, B2, tia chắn cống, càng bắn) và 0x200 + n thả ra |
barriercabinet |
VCC, GND, TRIG, ECHO, R, Y, G, ARM, V+ |
angle (0 độ) |
góc của tay máy; toàn bộ trạng thái nằm trên kênh đo | 1 cho một xe chạy lên làn đường |
sortercabinet |
VCC, GND, SCL, SDA, SERVO |
candies (12), period (2000 ms) |
những viên kẹo trong các hộp; toàn bộ trạng thái trên kênh đo | 1 nạp lại phễu kẹo và làm rỗng các ô; 0x1000000 + 0xRRGGBB đặt một viên kẹo có màu đó ở ngay cạnh |
soapcabinet |
VCC, GND, OUT, M+, M- |
threshold (0.5), bottle (30 ml), ml_per_turn (0.5), voltage (6), rpm (200) |
lượng xà phòng đã bơm kể từ khi chai được đổ đầy, tính bằng ml; toàn bộ trạng thái nằm trên kênh đo | bàn tay cách vòi cm, từ 1 đến 80 (80 là không có ai), cộng thêm 10000 nếu đeo găng đen; 1000000 đổ đầy chai |
Bánh wheel của bộ ngắt quang gắn trên động cơ được nối với nó qua netlist (web/src/sim/wheel-mount.ts): chân SHAFT của cả hai linh kiện trên cùng một đường nối, và shaft: true trên dcmotor hoặc encmotor, một cờ nội bộ mà catalog không liệt kê (PropInfo::internal), sẽ cho động cơ có chân đó. Chân này mang tốc độ của trục ra, không dấu, với 1 mV cho một rpm.
Chip được cấp nguồn khi hiệu điện thế giữa chân VCC và GND ít nhất là 2 V (4,5 V với NE555); khi chưa có nguồn, mọi ngõ ra đều ở trạng thái trở kháng cao.
Đơn vị: resistor.value ôm, capacitor.value microfarad, inductor.value milihenri.
Kênh lấy mẫu của máy hiện sóng
Máy hiện sóng chuyển các mẫu tín hiệu của nó trên cùng con đường với các điểm ảnh của màn hình: readHost, được thu thập mỗi khung hình một lần, với một catalog host là null vì trường đó nghĩa là "một kênh văn bản mà Serial Monitor giao tiếp" còn đây là các mẫu tín hiệu.
readHost(scopeIndex) trả về tất cả những gì đã lấy mẫu kể từ lần gọi trước, dưới dạng một thông điệp little-endian, hoặc không trả về gì khi chưa có mẫu nào:
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
Một que đo không kẹp vào đâu sẽ đọc được NaN. Linh kiện giữ 1024 mẫu cho phía máy chủ đã ngừng thu thập rồi bỏ mẫu cũ nhất, đặt cờ dropped.
Cơ sở thời gian và thang đo đầy đủ là các thuộc tính, và chúng cũng có thể được poke, vì đây là hai thứ mà người dùng thay đổi trong lúc xem một đường sóng, mà việc dựng lại netlist chỉ để thay đổi một trong hai cái sẽ làm khởi động lại mô phỏng. Một lệnh poke áp dụng ngay lập tức: linh kiện xóa phần chưa gửi, đặt cờ restart trong thông điệp tiếp theo để UI bỏ màn hình đang vẽ, và tiếp tục lấy mẫu ở tốc độ mới mà mạch không hề nhận ra.
Các dụng cụ đo trên bàn
funcgen, scope và multimeter là ba dụng cụ bạn thả vào khung vẽ và nối dây vào, và chúng là những linh kiện bình thường: không có đường đặc quyền vào engine, không có gì mà catalog không mô tả.
funcgenlàgeneratorcó sóng răng cưa và trở kháng đầu ra thực: 50 ohm, được ghi là cặp Norton (nguồn dòngv(t)/50với 50 ohm song song) vì linh kiện không có nút nội để treo điện trở nối tiếp vào. Một tải sẽ phân áp với nó, và đó là bài học đầu tiên mà một máy phát tín hiệu để bàn dạy.generatorvẫn lý tưởng và vẫn là linh kiện đúng để điều khiển một nút và không cần bận tâm nữa.scopelà hai que đo 1 Mohm và một kẹp đất; nó tham gia vào một island, không bao giờ tự tạo island.multimeterlà 10 Mohm giữaVvàCOMtrên các thang đo điện áp, một điện trở shunt 1 ohm giữaAvàCOMtrên các thang đo dòng điện (cả hai đều đưa một Thevenin qua trên đường số nhanh và được đánh dấu khi một island chạm tới chúng), và, trên thang đo ôm và thông mạch, một dòng kiểm tra 30 uA với 100 kohm song song, thứ này thì có tự tạo island. Nó tích phân trên một cửa sổ 250 ms ở 4 kHz và xuất một số đọc bốn lần mỗi giây: giá trị trung bình trên thang DC, giá trị RMS thật của phần AC trên thang AC, và, trên thang ôm, điện trở mà dòng kiểm tra đó ngụ ý,NaNtrên 1 Mohm. Từ khoảng một kilohertz trở lên, số đọc AC bị lấy mẫu thiếu và thấp hơn thực tế.
Rung tiếp điểm ở pushbutton
Một nút nhấn thực khi nhấn sẽ khép, nảy lại và ổn định, nên pushbutton rung ở mỗi lần nhấn và mỗi lần nhả. Thuộc tính bounce của nó chọn kiểu rung:
bounce |
số lần chuyển tiếp mỗi lần nhấn hoặc nhả | ổn định trong |
|---|---|---|
none |
1 | ngay lập tức |
typical |
3 đến 8 | 1 đến 5 ms |
worst |
tới 20 | 10 đến 20 ms |
Mặc định là typical: chọn none khi nút nhấn không phải là trọng tâm của mạch, và worst để cho thấy tại sao sketch phải chống rung. Mọi thứ được nối vào nút nhấn đều thấy sự rung này như những cạnh xung bình thường (một ngõ vào 74HC, một chân kích hoạt NE555, một GPIO của bo mạch), vì nút nhấn điều khiển các đường nối của nó đúng như nó vẫn luôn làm; không có gì khác trong hợp đồng thay đổi.
Mỗi chuỗi rung bắt đầu bằng một sườn cạnh tức thời (tiếp điểm khép thật khi được nhấn) và diễn ra phần còn lại như các wakeup trên bánh xe thời gian, cái cuối cùng rơi đúng vào lúc ổn định. Số lượng là số lẻ, nên một chuỗi rung luôn kết thúc ở trạng thái được yêu cầu. Một lệnh poke đến giữa chuỗi rung (nhả ra khi vẫn còn rung) sẽ hủy phần còn lại và bắt đầu một chuỗi rung mới. Độ dài các khoảng đến từ một luồng ngẫu nhiên riêng cho từng linh kiện, được gieo từ chỉ số của linh kiện trong netlist, nên hai nút nhấn trong một mạch rung khác nhau, các lần nhấn liên tiếp khác nhau, và cùng một netlist được poke theo cùng cách thì tạo ra cùng những sườn cạnh chính xác đến từng picosecond: một lần chạy có thể tái lập được.
Phần hiển thị của một linh kiện có thể khai báo interaction: 'hold' (nhấn con trỏ poke 1, nhả poke 0) hoặc 'toggle' (một cú nhấp poke 0 khi que đo đang từ 0.5 trở lên, nếu không thì 1). Khung vẽ không bao giờ nêu tên loại linh kiện.
Mọi thứ UI cần để vẽ một linh kiện nằm trong web/. Mọi thứ một linh kiện cần để hoạt động nằm trong crates/parts. Chúng chỉ gặp nhau ở type, tên các chân, và props.
5. Vòng lặp chạy (phía UI)
Sim.runForNs(ns) tiến thời gian mô phỏng thêm ns rồi trả về, với nowNs() báo tổng mới. UI gọi nó từ requestAnimationFrame, nhắm đến thời gian mô phỏng = thời gian thực, với ngân sách thời gian thực cho mỗi khung (chẳng hạn 12 ms); nếu trình mô phỏng bị tụt lại, UI hiển thị tỷ lệ tốc độ đạt được thay vì bị đóng băng. Trình mô phỏng chạy trong một Web Worker (web/src/sim/client.ts), nên trang vẫn phản hồi trong lúc nó chạy.
probes(), netLevels() và netEdges() được đọc một lần mỗi khung, cùng lúc với nhau, vào bản chụp mà UI vẽ từ đó. netEdges() tồn tại vì mức logic đọc mỗi khung một lần chỉ cho biết mỗi đường nối kết thúc ở đâu: một tiếp điểm rung tạo ra hai mươi sườn xung trong vài mili-giây, gọn trong một khung 16 ms, và một bài học yêu cầu đếm chúng thì phải đếm được. Một sườn xung là một thay đổi của mức sạch (thấp sang không xác định sang cao là một; thấp sang lửng lơ sang thấp là không), và một cú lật bị hoàn lại trong cùng một khoảnh khắc thì không được đếm. Đọc số đếm sẽ đặt lại chúng, nên vòng lặp khung là nơi gọi duy nhất. netVoltages() được đọc trên cùng một lượt nhưng chỉ khi có thứ gì đó trên trang đang hiển thị vôn: phần đọc Show levels (web/src/ui/levels.ts), vốn tắt theo mặc định. Một bản chụp không yêu cầu chúng sẽ mang một mảng rỗng, nên điện áp mỗi đường nối mỗi khung không tốn gì cho đến khi nó được đọc.
6. Mô hình điện
Mỗi driver trên một đường nối là một điện áp với một trở kháng nguồn (Drive { voltage, impedance, level }). Điện áp của một đường nối là trung bình có trọng số trở kháng của các driver (Millman). Một ngõ ra số mạnh có vài chục ohm, một pull-up có giá trị điện trở của nó, high-Z là vô cùng. level số của một đường nối đến từ driver có trở kháng thấp nhất; nếu các driver trở kháng bằng nhau không đồng ý thì là Unknown; không có driver thì là Floating. Linh kiện hai đầu đọc tương đương Thevenin nhìn từ một chân, không tính phần đóng góp của chính nó, rồi kéo chân kia tương ứng.
Đó là đường đi nhanh, và mọi đường nối không có linh kiện analog nào vẫn hoạt động như thế.
6a. Đảo analog
Một linh kiện mà hành vi của nó là một phương trình vi phân trên nhiều nút cùng lúc (tụ điện, cuộn cảm, op-amp, máy phát tín hiệu) tự khai báo analog qua capability Component::analog, và kernel gom mọi đường nối mà nó chạm vào thành một đảo được giải như một ma trận duy nhất bởi crates/analog: phân tích nút sửa đổi, LU với chọn trục một phần, một điểm làm việc DC lúc cấp nguồn với mọi tụ điện xả hết và mọi cuộn cảm ở dòng bằng không, và một chế độ quá độ với các mô hình đồng hành hình thang và bước thời gian được chọn theo sai số cắt cục bộ.
Hai nửa gặp nhau ở ba nơi và không nơi nào khác.
- Vào thôi. Mỗi driver trên một đường nối của đảo mà không thuộc về đảo sẽ được gộp bằng Millman thành một điện áp sau một điện trở và ghi vào như một nguồn Thevenin trên nút đó. Một chân số là một nguồn Thevenin; đó là toàn bộ giao diện.
- Ra ngoài. Đảo chiếm một ô trình điều khiển trên mỗi đường nối của nó, giống như bất kỳ chân nào khác, và ghi tương đương Thevenin riêng của đảo tại nút đó (đảo với trình điều khiển biên của đường nối đó bị loại bỏ), sao cho việc giải hai giá trị này bằng quy tắc Millman thông thường tái tạo chính xác điện áp nút đã giải.
- Thời gian. Đảo tự đặt bước tiếp theo của mình trên bánh xe thời gian. Một đảo đã ổn định mà không có nguồn chuyển động thì không đặt gì cả, nên một mạch tương tự nhàn rỗi tốn kém đúng bằng một mạch số nhàn rỗi.
Một linh kiện có ngưỡng vào tương tự (một bộ so sánh, hai điểm chuyển của một con 555) gọi Ctx::watch(pin, volts, hysteresis); khi đó đảo sẽ tinh chỉnh bước của mình sao cho dừng đúng lúc băng qua thay vì bước qua nó, nên thời điểm chuyển được chính xác đến micro giây thay vì chỉ đến độ dài một bước tích phân. Ngoài đảo, lời gọi này không tốn kém gì và không thay đổi gì. Ngõ vào số của vi điều khiển cũng làm vậy qua Ctx::read_input(pin, threshold), hàm này theo dõi chân ở đúng mức chuyển mạch của chip rồi mới đọc: mọi bo mạch đều đọc các chân vào theo cách này, nên một sườn tương tự chậm sẽ đến một linh kiện 3.3 V và một linh kiện 5 V ở điện áp mà từng linh kiện thực sự chuyển mạch, chứ không phải ở một mức LOGIC_THRESHOLD duy nhất của kernel. Một chân vào không tạo tải cho đảo ngoài điện trở kéo lên hoặc kéo xuống mà firmware của nó bật; dòng rỉ cỡ dưới micro ampe của một ngõ vào CMOS thật không được mô hình hóa.
Các đảo bước tối đa mỗi 2 ms và tối thiểu mỗi 100 ns, và giữ bước bằng một phần sáu mươi tư của hằng số thời gian đang chuyển động nhanh nhất, nên một dạng sóng lấy mẫu giữa các bước không bao giờ chậm hơn mức đó. Một điện trở đấu vào một đảo chạm tới nó nhưng không bao giờ tự tạo đảo; một que đo của máy hiện sóng có trở kháng 1 Mohm so với kẹp đất của nó và cũng làm như vậy.
6b. Đảo phi tuyến
Một linh kiện có vật lý thiết bị bên trong (diode, LED, transistor lưỡng cực, MOSFET) khai báo AnalogPart::devices cùng với các phần tử của nó và đặt tên chúng từ một Element::Device { nodes: [Node; 4], dev: u32 }, trong đó dev lập chỉ mục vào danh sách thiết bị riêng của linh kiện đó. Element vẫn là Copy; các thiết bị là Box<dyn Device> trên đảo. Kernel dịch chuyển chỉ số thiết bị của từng linh kiện khi hợp nhất các linh kiện vào một đảo và không biết gì thêm về chúng: không có tên thiết bị nào đến được sim-kernel, và phần vật lý nằm hoàn toàn trong crates/parts đằng sau một trait được định nghĩa trong crates/analog.
Một Device làm ba việc. Nó loads một mô hình đồng hành (điện dẫn và các nguồn dòng tương đương) từ các điện áp đầu cực tại lần lặp hiện tại. Nó limits các điện áp mà lần giải trước tạo ra trước lần load kế tiếp, với một junction pn đây là pnjlim của SPICE và là khác biệt giữa một diode hội tụ và một diode tràn số exp. Và nó báo cáo parameters của mình như một vector số thuần, nên Ctx::restamp_device(which, params) có thể di chuyển một beta mà không cần dựng lại island, hệt như Ctx::restamp di chuyển một điện trở.
Phép giải là Newton-Raphson: nạp mọi thiết bị, phân tích, giải, kiểm tra mọi ẩn số với reltol |x| + abstol (volt trên hàng nút, ampe trên hàng nhánh), giới hạn, lặp lại, đến giới hạn Limits::max_iter. Một đảo không có thiết bị mất đúng một lượt và cho ra đúng ma trận như cũ, điều mà các bài kiểm tra sách giáo khoa khẳng định đến từng chữ số. Một điểm làm việc mà Newton không đạt được từ khởi đầu lạnh sẽ chuyển sang gmin stepping (một dòng rỉ cỡ miliohm trên mọi nút, hạ dần về GMIN), rồi tới source stepping, và rồi báo lỗi thay vì giả vờ thành công. Một bước quá độ không hội tụ thì giảm một nửa và thử lại trên cùng ngân sách mà bộ điều khiển sai số dùng; ở mức sàn, nghiệm lặp giữ nguyên và lỗi được đếm trong Solver::stats(), nơi cũng mang số lần lặp, số lần lặp bị giới hạn và số bước bị loại để các bài kiểm tra khẳng định trên đó thay vì trên thời gian thực.
Các thiết bị trong giai đoạn 1: một diode (Shockley với Is, N và điện trở khối Rs), một LED (cùng mắt nối đó với sụt áp của màu đèn tại 20 mA phía sau), một transistor lưỡng cực (Ebers-Moll dạng transport với Bf, Br, Is và một điện áp Early, NPN và PNP; từ tháng 10 năm 2026 linh kiện transistor là mô hình Gummel-Poon đầy đủ trên chính thẻ của từng nhà sản xuất) và một MOSFET (level 1 Shichman-Hodges với Vto, beta và lambda, kênh N và P). Một linh kiện dùng cùng một thiết bị khi ngoài đảo cũng như khi trên đảo: một linh kiện hai đầu cuối giải vòng mạch duy nhất qua chính nó với cùng phương trình, và một linh kiện ba đầu cuối dựng một đảo ba nút riêng với thiết bị của riêng nó trên đó và hỏi cùng bộ giải. Mỗi thiết bị có đúng một mô hình và không bao giờ có hai.
Đó là các thiết bị của giai đoạn 1. Kể từ đó các phép phân tích đã hoàn thành (điểm làm việc, quét DC và quét tham số, cùng đáp ứng tần số AC, mục 7), mọi thẻ thiết bị đều mang điện dung chuyển tiếp của nó, và op-amp là một macromodel một cực. Trên khung vẽ, nhiệt độ vẫn cố định ở 27 C; một SPICE deck (mục 7e) có .temp.
Những gì phần cài đặt làm mà ba quy tắc trên không nói
- Các đảo được tìm thấy một lần, tại
Kernel::init. Kernel đóng băng cấu trúc liên kết tại đó, nên một thay đổi dây nối là một netlist mới và một kernel mới, điều mà UI đã làm ở mỗi lần chỉnh sửa. Không có quá trình khám phá lại theo từng bước và cũng không cần phải có. - Một linh kiện được báo biết nó có tham gia hay không.
Component::analog_joined(bool)được gọi một lần sau khi khám phá. Một linh kiện đã được đóng dấu thì không được đồng thời điều khiển các chân của nó, và đây là nơi một tụ điện ngừng chạy bộ tích phân riêng, một điện trở ngừng truyền tương đương Thevenin và một biến trở ngừng điều khiển con chạy của nó. - Một linh kiện có thể yêu cầu các giá trị đã giải.
Component::analog_solved(currents, volts)được gọi sau mỗi lần giải, cho các phần tử mà linh kiện đó khai báo, khiAnalogPartcủa nó yêu cầu quareporting(). Dòng qua một cuộn cảm là một trạng thái của ma trận chứ không phải hàm của các điện áp nút, nên đó là thứ duy nhất một linh kiện không thể đọc lại từ chính các đường nối của mình. - Các giá trị có thể thay đổi mà không cần dựng lại.
Ctx::restamp(&[Element])trao cho kernel các dấu đóng của linh kiện như hiện tại; kernel lấy các giá trị từ chúng, giữ nguyên các nút, và giải lại ngay tại thời điểm đó trong khi giữ mọi điện áp tụ điện và mọi dòng cuộn cảm. Núm của biến trở chính là mục đích của điều này. Hình dạng của một đảo không bao giờ thay đổi; chỉ những con số trong nó thay đổi. - Một chân lơ lửng là một nút riêng của nó. Một chân analog không nối với gì sẽ nhận một nút mới chẳng có gì ngoài gmin, nên một tụ điện có một chân treo sẽ giữ điện tích của mình và không tác động gì cả.
- Một đảo đỗ trên chân trời một giây. Nó ngừng đặt lịch các bước khi không có gì mà nó giữ sẽ chuyển động quá một dung sai trong giây tiếp theo của thời gian mô phỏng. Hỏi liệu có chuyện gì xảy ra trong step tiếp theo là một câu hỏi sai: đuôi của một hàm mũ chuyển động ít hơn một dung sai mỗi bước lâu trước khi nó đến nơi.
- Kernel có thể cho biết nó đang giải đến đâu.
Kernel::island_count,island_of_netvàisland_nodestồn tại cho các bài kiểm tra giữ lối đi nhanh tới lời hứa của nó. Một netlist kỹ thuật số không tạo island nào, vàcrates/sim-kernel/tests/kernel.rskiểm chứng điều đó trên mạch chứng minh 497 linh kiện cùng với số lần dispatch mà mạch đó luôn tốn.
Cả hai biến trở đều gia nhập một island theo cách giống điện trở: một track là hai điện trở, R x f từ đầu thấp đến con chạy và R x (1 - f) từ con chạy đến đầu cao, và khi ở ngoài island thì hai cái này được gộp thành một nguồn Thevenin cho mỗi chân.
7. Các phân tích
Những lệnh gọi không làm thời gian mô phỏng tiến lên. Mọi thứ khác trên bề mặt đều đi qua runForNs; những lệnh này chạy một phân tích và trả về câu trả lời, đó là một dạng khác cho hợp đồng và là lý do phần này tồn tại.
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 và analogNets có một mục cho mỗi đường nối theo thứ tự trong nets[]; probes có một mục cho mỗi linh kiện theo thứ tự trong parts[]. Một điện áp không phải là số (một đường nối lơ lửng) trả về null, không bao giờ là một số.
Nó báo cáo nghiệm mà engine đang giữ hiện tại và không bao giờ giải lại. Tại tNs bằng không, trước khi bất cứ thứ gì chạy, đó là điểm làm việc lúc vừa cấp nguồn: mọi tụ điện đã phóng hết, mọi cuộn cảm ở dòng điện không. Đó là một mạch vừa được bật và nó không phải là .op của SPICE, nơi tụ điện là mạch hở. Để lấy nghiệm DC ổn định, hãy chạy mạch đến khi ổn định rồi lấy điểm làm việc lúc đó. tNs có trong kết quả để phần hiển thị có thể nói nó đang cho thấy cái nào trong hai trạng thái.
analogNets[i] là true khi đường nối i được giải bằng ma trận và false khi nó được giải bằng mô hình theo từng driver. Chúng là hai loại câu trả lời khác nhau và phần hiển thị phải nói rõ được điều đó.
parts chỉ chứa các linh kiện được đóng vào một analog island, với một mục cho mỗi phần tử chúng đóng, theo thứ tự đóng. amps dương khi dòng chảy từ cực thứ nhất của phần tử sang cực thứ hai và volts là hiệu điện thế giữa hai cực đó theo cùng thứ tự. Một linh kiện không có mục thì không có dòng nhánh trong ma trận; điều đó không có nghĩa là không có dòng, và probes thường là câu trả lời trong trường hợp đó: que đo của một điện trở chính là dòng của nó dù nó có nằm trong ma trận hay không (mục probe trong catalog nói rõ que đo của từng linh kiện nghĩa là gì).
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 có thể được thêm vào cả hai; nó chạy mỗi điểm thêm chừng đó sau lúc cấp nguồn trước khi đọc, và giá trị nào trên không nghĩa là điểm đó không còn là nghiệm 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 song song với parts và mang phần tử đầu tiên của từng linh kiện analog. Một phân tích không chạy được sẽ trả về với error được đặt và points rỗng; nó không bao giờ ném lỗi.
Hai đường đi, vì trong engine này có hai loại thứ có thể đặt được.
propdựng lại mạch tại mỗi điểm từ netlist với đúng số đó được thay đổi rồi cấp nguồn, nên mỗi điểm là một điểm làm việc DC khởi động nguội vàcontinuedlà false. Một thuộc tính không phải số sẽ bị từ chối với thông báo lỗi, và thuộc tính mà linh kiện không có cũng vậy.poke: truethực thi poke code của linh kiện trên mạch đang chạy (trục của một biến trở), điều này áp dụng lại và giải lại ngay tại chỗ, nêncontinuedlà true vàdiscretelà true, vì một trục là một số nguyên chứ không phải một dải liên tục. Linh kiện được đặt lại đúng vị trí mà sweep tìm thấy nó.
Một sweep lấy tối đa 1001 điểm. Vượt quá số đó sẽ bị từ chối kèm số điểm trong thông báo thay vì chạy.
7c. setMaxStepNs(ns, fixed) và stepLimitNs()
Limits.dt_max như một cài đặt. ns là bước dài nhất mà một island analog có thể lấy; fixed ghim cả sàn lên giá trị đó, nên bộ điều khiển sai số có đúng một bước để chọn. Bằng không hoặc nhỏ hơn sẽ xóa nó và đưa mọi island về trần 2 ms của chính kernel.
Hai thứ vẫn làm ngắn lại một bước bị ép và cả hai đều là chủ ý: một điểm gián đoạn của nguồn thì bước được đưa rơi đúng vào đó thay vì tích phân xuyên qua, và một ngưỡng logic đang theo dõi nằm trong một bước được tinh chỉnh đúng lên điểm giao. Không gì làm dài bước ra, nên một bước bị ép là lời hứa "mịn ít nhất đến mức này".
Một linh kiện có thể tự yêu cầu điều tương tự trên island của mình bằng Ctx::limit_step(dt, fixed), và yêu cầu mịn nhất trên một island thắng. Thuộc tính step của linh kiện scope chính là lệnh gọi đó: bằng không, mặc định, để bộ điều khiển yên.
7d. acSweep(specJson: string): string
{ "source": "gen1", "probe": 4, "fStart": 10, "fStop": 100000, "pointsPerDecade": 20 }
input có thể được thêm vào: chỉ số đường nối mà độ lợi được lấy so với. Nếu bỏ qua, đó là đường nối mà phần tử của chính nguồn điều khiển, đúng như ý người ta nói "đầu vào" khi chọn một bộ tạo tín hiệu.
{
"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": ""
}
Năm mảng song song và dài một mục cho mỗi tần số. magDb và phaseDeg là tỉ số của phasor đầu ra trên phasor đầu vào (20 log10 |Vout / Vin| và arg(Vout / Vin) theo độ), đây là thứ duy nhất ở đây đúng nghĩa là một hàm truyền. inputMag và outputMag là biên độ phasor thô theo đơn vị của tín hiệu kích, và source.drive cho biết đó là đơn vị nào: vsource là một vôn đặt ngang qua nguồn, isource một ampe đi vào nó, thevenin một vôn mạch hở phía sau điện trở của nó. Một bộ tạo hàm là một cặp Norton, nên drive của nó là isource và inputMag của nó là một trở kháng theo ôm chứ không phải vôn; tỉ số không bị ảnh hưởng, và đó chính là mục đích của việc báo cáo tỉ số.
freq là fStart * 10^(k / pointsPerDecade) đến và bao gồm fStop, cùng lưới mà .ac dec đi qua, nên một sweep ở đây và một sweep trong trình mô phỏng tham chiếu với cùng ba con số so sánh được từng điểm một. fStart phải trên không: không hertz là DC, đó là điểm làm việc chứ không phải một điểm của sweep log. Số điểm nhiều nhất một sweep lấy là 1001, cùng giới hạn mà sweep có.
Nó được lấy quanh điểm làm việc mà engine đang giữ hiện tại, đúng như operatingPoint báo cáo, và không giải lại gì cả. Tại tNs bằng không đó là điểm phân cực lúc cấp nguồn; sau khi thời gian đã chạy nó là trạng thái tại thời điểm đó, và tNs nói rõ là cái nào. Mọi linh kiện phi tuyến được tuyến hóa tại nghiệm lặp mà Newton dừng lại, và mọi op-amp ở chế độ mà điểm làm việc đặt nó vào: một op-amp đã bão hòa được đóng ở trạng thái bão hòa, nên độ lợi tín hiệu nhỏ của nó bằng không.
Từ Analog 3 giai đoạn 1, mọi thẻ linh kiện đều mang điện dung chuyển tiếp của nó, và phần đóng dấu AC là j w C tại cùng dQ/dv mà phần quá độ tích phân, nên một transistor có điểm cắt tần số cao của riêng nó và một tầng phát chung thể hiện hiệu ứng Miller. Những gì mô hình không có nằm ở crates/analog/src/ac.rs và lặp lại trong docs/help/editor/analysis.md: BJT không có thời gian quá độ ngược TR, điện dung cổng-drain của MOSFET là hằng số nên không có đoạn phẳng Miller, Darlington TIP120 không có điện dung nào cả; không có phân tích nhiễu và không có phân tích méo tín hiệu, vì một mạch tuyến tính hóa không có cả hai; và op-amp vẫn là loại tuyến tính giới hạn theo nguồn với độ lợi phẳng đến tần số vô hạn.
Một phân tích không chạy được sẽ trả về error được đặt và các mảng rỗng; nó không bao giờ ném lỗi. Ba lỗi có thể xảy ra tự nói rõ mình là gì: linh kiện được nêu không có nguồn nào bên trong mà phân tích AC có thể kích hoạt, một đường nối không nằm trên cùng một khu vực tương tự với nguồn, hoặc khoảng tần số không phải là một khoảng hợp lệ.
7e. spiceRun(deck: string, filesJson: string): string
Một hàm tự do của module, không phải phương thức của Sim: nó chạy một SPICE deck trên crates/spice và không liên quan gì đến mạch đang được tải. filesJson là [{ "name": "models.lib", "text": "..." }], các tệp mà deck có thể .include hoặc .lib (khớp theo đúng tên, sau đó chỉ theo tên tệp), hoặc một chuỗi rỗng. Câu trả lời:
{ "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.