Başvuru

Mokxi neyi simüle eder: simülatör sözleşmesi

Dijital çekirdek, analog adacıklar, SPICE destesi çalıştırıcısı ve her birinin modellemediği şeyler.

Mokxi bir devreyi üç motorla simüle eder ve bu sayfa, her birinin uyduğu sözleşmedir.

  • Dijital çekirdek. Olay güdümlü bir çekirdek her mikrodenetleyiciyi, mantık çipini ve dijital ağı çalıştırır. Bir ağın gerilimi üzerindeki sürücülerden gelir; her sürücü bir kaynak empedansının arkasında bir gerilimdir ve mantık seviyesi en güçlü olandan belirlenir (bölüm 6). Birkaç yüz parçanın ve bir CPU çekirdeğinin tarayıcı sekmesinde gerçek zamanlı çalışmasını sağlayan şey budur.
  • Analog adacıklar. Bir kondansatör, bir bobin, bir işlemsel yükselteç, bir sinyal üreteci, bir diyot veya bir transistör, dokunduğu ağları bir adacığa çeker ve bu adacık, değiştirilmiş nodal analiz ile tek bir matris olarak çözülür; yarı iletkenlerin arkasında aygıt modelleri vardır: jonksiyon kapasitanslı Shockley diyotlar, Gummel-Poon transistörler ve seviye 1 MOSFET'ler, Newton-Raphson ile çözülür (bölüm 6a ve 6b). Tuval üzerinde DC çalışma noktasını okuyabilir, bir değeri tarayabilir ve frekans yanıtı çizebilirsiniz (bölüm 7).
  • SPICE destesi çalıştırıcısı. Düzenleyici menüsündeki SPICE destesi çalıştır seçeneği, bir SPICE ağ listesini kendi motorunda çalıştırır: iç içe taramalarla .op, .tran, .ac, .dc, .tf, .noise ve .meas, ayrıca alt devreler, parametreler, .include, Gummel-Poon BJT'ler, seviye 1 ila 3 MOSFET'ler, JFET'ler, davranışsal kaynaklar ve .temp. Sonuçlar 42 karşılaştırma devresi üzerinde ngspice ile doğrulanır ve her biri belirtilen toleranslar içinde kalır (bölüm 7e).

Her birinin yapmadığı şeyler, açıkça:

  • Canlı tuvalde gürültü, sıcaklık veya bozulma analizi yoktur ve aktarım fonksiyonu yoktur; üzerindeki her jonksiyon 27 C'dir. İşlemsel yükselteci, kazanç-bant genişliği çarpımı, dönüş hızı, baş payı, ofset ve akım sınırı olan tek kutuplu bir makromodeldir ama ikinci kutbu yoktur.
  • SPICE destesi çalıştırıcısı BSIM MOSFET modellerini, kayıplı iletim hatlarını, XSPICE aygıtlarını veya .four, .sens, .pz ve .disto analizlerini çalıştırmaz ve bir deste bunlardan birini kullanırsa bunu satır satır söyler. Monte Carlo analizi yoktur ve üretici modelleri kütüphanesi yoktur.
  • Hiçbir şeyin güç derecesi yoktur. Bir parça asla yanmaz, bir beslemenin gerilimi asla düşmez ve bir pinin akım sınırı yoktur; burada çalışan bir devre gerçek tezgahta yine başarısız olabilir (parçaların nasıl modellendiği).

Sözleşme

Bu sayfanın geri kalanı, Rust simülatörü (crates: sim-kernel, parts, analog, spice, sim-wasm) ile TypeScript arayüzü (web/) arasındaki sınırdır. İki taraf da bu dosyaya göre derlenir. Değiştirmek isterseniz önce bu dosyayı düzenleyin.

1. Ağ listesi JSON (arayüz -> simülatör)

Diyagramın sahibi arayüzdür (konumlar, kablolar, breadboard'lar). Bir simülasyonu başlatmadan önce arayüz diyagramı bir ağ listesine düzleştirir: breadboard şeritleri ve kablolar, union-find ile ağlarda birleştirilir. Breadboard'lar asla simülatöre ulaşmaz.

{
  "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"]
  ]
}
  • parts[i] sırası, probes() ve poke() tarafından kullanılan partIndex değerini belirler.
  • nets[j] sırası, netLevels() ve netVoltages() tarafından kullanılan netIndex değerini belirler.
  • Bir pin referansı "<partId>:<pinName>" biçimindedir. Pin adları katalogdan gelir. Bilinmeyen parça türü, bilinmeyen pin veya iki ağda bulunan bir pin, create aşamasında hatadır.
  • Verilmeyen özellikler katalog varsayılanını alır. Bilinmeyen özellikler hatadır.
  • Bir ağ tek bir pin içerebilir. Bir pin breadboard şeridinde tek başına durduğunda arayüz bunu yayar (anahtarlar için gereken gerçek bir düğüm); simülatör bunu kabul eder.

2. WASM yüzeyi (crates/sim-wasm, wasm-bindgen, --target web)

Rust snake_case kullanır; TypeScript'in tam olarak şunu görmesi için js_name ile dışa aktarın:

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;

Kararlı hâle gelmeyen bir döngü çalıştırmayı durdurmaz. Simüle edilen zamanın bir anı 1000 delta döngüsünden fazlasına ihtiyaç duyduğunda (parçalar sıfır sürede bir ağı ileri geri geçiriyor, genellikle bir breadboard satırında iki bacağı olan iki parça), motor döngüyü olduğu yerde keser: hâlâ değişmekte olan ağlar son bir kez çözülür ve orada tutulur, zaman akar ve her çağrı 0 döndürmeye devam eder. Bu an, çalışma başına döngü başına bir kez takeUnsettled() üzerinden bildirilir; nets, nets[] dizisinin dizinleridir; düzenleyici bunu bir seri monitör satırına ve Circuit Doctor bulgusuna çevirir (web/src/ui/unsettled-watch.ts). Bir çalışmada 16 böyle andan sonra sonraki her biri 200 delta döngüsünde kesilir, böylece hızlı bir PWM'in her kenarında tetiklenen bir döngü sayfayı donduramaz. Yukarıdaki 1 = oscillation kodları, hatalı dizin durumları ve bundan önce derlenmiş bir motor için korunur.

Derleme: wasm-pack build --target web --release --out-dir ../../web/src/sim/wasm --out-name sim crates/sim-wasm (seçenekler crate yolundan önce gelir). Çıktı git'e işlendiği için arayüz Rust olmadan derlenir.

3. Katalog JSON (simülatör -> arayüz)

[
  {
    "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, bu parça için loadProgram öğesinin ne aldığını söyler (bir kart için "elf32 riscv32imc") ya da null'dır. host, host bayt kanalının ne taşıdığını söyler ("utf-8 bytes on UART0") ya da null'dır. host kanalı olan parça, seri monitörün bağlandığı parçadır.

dir şu olabilir: in, out veya inout. kind şu olabilir: number, string veya bool. options isteğe bağlıdır; varsa arayüzde bir seçim listesi gösterilir. number türü bir özellik ayrıca alabileceği aralığı da taşır: min ve max; "minOpen": true, min değerinin kendisinin kabul edilmediği durumlarda, "integer": true ise yalnızca tam sayılar için kullanılır (crates/parts/src/ranges.rs, her iki yönde en fazla 1e15). Parçayı oluştururken aralık dışındaki bir değer reddedilir; özellikler paneli de girişte bu değeri engeller. Bir arayüz parçası görseli (web/src/parts/<type>.ts), katalogdaki her pin için bir pin konumu bildirmelidir ve başka bir şey bildirmemelidir; web/ içindeki bir test bunu, wasm derleme adımının da yazdığı web/src/sim/wasm/catalog.json dosyasıyla karşılaştırarak denetler.

4. Faz 1 arayüz iskeleti için dondurulmuş parça türleri

Çekirdek tarafı bunları ilk olarak sunar, böylece arayüzün yöneteceği bir şey olur. Daha fazla parça parça aracılarından gelir ve bunlar yalnızca girdi ekler.

type pins props prob poke
led A, C color dizisi (red) parlaklık 0..1 yok
resistor 1, 2 value ohm (1000) amper cinsinden akım yok
pushbutton 1a, 1b, 2a, 2b (1a-1b kısa devrede, 2a-2b kısa devrede, basınca çiftler birleşir) bounce dizesi ("typical", none/typical/worst değerlerinden biri), bkz. 4a 1 basıldı, 0 bırakıldı 1 = basma, 0 = bırakma
vcc VCC voltage (5) gerilim yok
gnd GND yok 0 yok
clock OUT hz (1) yüksekken 1, düşükken 0 yok

4a. Faz 1 parça seti (kabuktan sonra eklendi, yalnızca sonuna eklenir)

Birimler: resistor.value ohm, capacitor.value mikrofarad. Çipler pinlerini paket pin numarası sırasıyla listeler. Birden fazla bit taşıyan bir prob, f32 içine bir bit maskesi paketler.

type pins props prob poke
capacitor 1, 2 value sayısı (10) üzerindeki gerilim, V(1) - V(2) yok
gate A, B, Y function dizgesi ("and", and/or/nand/nor/xor/xnor değerlerinden biri) Y yüksekken 1, düşükken 0, bilinmiyorken 0.5 yok
not A, Y yok Y yüksekken 1, düşükken 0, bilinmiyorken 0.5 yok
bitin Q label metni ("A"); value (0, 0 veya 1) Q yüksekken 1, düşükken 0 0, Q'yu düşük sürer, 1 yüksek sürer; bir pull üzerinden sürdüğü için ağdaki herhangi bir çıkış kazanır
bitout A label dizisi ("Y"); color dizisi ("green", green/red/amber/blue değerlerinden biri) yüksekse 1, düşükse 0, bilinmiyorsa veya sürülmüyorsa 0.5 yok
bytein D0..D7 label dizisi ("A"); value (0, 0 ile 255 arası); width (8, 1 ile 8 arası) D0..D(width-1) üzerindeki değer; genişliğin üzerindeki pinler high-Z'dir 0..255 değeri ayarlar (genişliğe göre maskelenir); 2^32 bir artırır
byteout D0..D7 label dizgisi ("S"); width (8, 1'den 8'e) değer, sürülmeyen bitler 0; sürülen bir bit bilinmiyorsa -1 yok
bitconst Q value (0, 0 veya 1) sürdüğü değer yok; bir kapı çıkışı gibi push-pull sürer
stepclock CLK hz (2); mode dizgesi ("step", step/run değerlerinden biri) seviye (0 veya 1), serbest çalışırken ayrıca 2 0 durdurur (adım modu), 1 serbest çalıştırır, 2 durmuşken bir tik verir (bir yükselme, yarım periyot sonra bir düşme)
progrom giriş A0..A7; çıkış C0..C7, K0..K7 program metni (Kestrel assembly, crates/parts/src/kestrel.rs) okunan adres; bilinmiyorsa -1 yok; adresteki kelime 10 ns sonra C (yüksek bayt) ve K (düşük bayt) pinlerini sürer
terminal D0..D7, WE, CLK mode dizisi ("text", text/numbers değerlerinden biri) açılıştan beri yazılan baytlar yok; ana bilgisayar kanalı: her bayt, WE yüksekken CLK'nın yükselen kenarında yazılır
sevenseg E, D, COM1, C, DP, G, F, COM2, A, B common dizisi ("cathode", cathode/anode değerlerinden biri); color dizisi ("red", red/green/blue/yellow/white değerlerinden biri) yanan segmentler 0..255 bit maskesi olarak: bit 0 A, 1 B, 2 C, 3 D, 4 E, 5 F, 6 G, 7 DP yok
slideswitch 1, 2, 3 yok 0 = ortak pin 1'de, 1 = ortak pin 3'te 0 = 2'yi 1'e bağla, 1 = 2'yi 3'e bağla
buzzer 1, 2 yok ses çalarken 1, sessizken 0 yok
74hc00 1A, 1B, 1Y, 2A, 2B, 2Y, GND, 3Y, 3A, 3B, 4Y, 4A, 4B, VCC yok çıktılar bit maskesi olarak, bit 0 = 1Y .. bit 3 = 4Y; güç yoksa 0 yok
74hc08 74hc00 ile aynı pin dizilimi yok aynı yok
74hc32 74hc00 ile aynı pin dizilimi yok aynı yok
74hc86 74hc00 ile aynı pin dizilimi yok aynı yok
74hc04 1A, 1Y, 2A, 2Y, 3A, 3Y, GND, 4Y, 4A, 5Y, 5A, 6Y, 6A, VCC yok çıktılar bit maskesi olarak, bit 0 = 1Y .. bit 5 = 6Y; güç yoksa 0 yok
74hc74 1RD, 1D, 1CP, 1SD, 1Q, 1QN, GND, 2QN, 2Q, 2SD, 2CP, 2D, 2RD, VCC yok Q çıkışları bir bit maskesi olarak, bit 0 = 1Q, bit 1 = 2Q; 0 = gücü yok veya X yok
74hc595 Q1, Q2, Q3, Q4, Q5, Q6, Q7, GND, Q7S, MR, SHCP, STCP, OE, DS, Q0, VCC yok Q0..Q7 üzerindeki bayt, bit 0 = Q0; OE yüksekken veya güç yokken 0 yok
ne555 GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC yok OUT yüksekken 1, düşükken veya güç yokken 0 yok
tlc555 GND, TRIG, OUT, RESET, CTRL, THR, DIS, VCC yok OUT yüksekken 1, düşükken veya güç yokken 0 yok
ne556 1DIS, 1THR, 1CTRL, 1RESET, 1OUT, 1TRIG, GND, 2TRIG, 2OUT, 2RESET, 2CTRL, 2THR, 2DIS, VCC yok bit 0 = 1OUT, bit 1 = 2OUT yüksek yok
inductor 1, 2 değer milihenri (100) amper cinsinden akım, pin 1'den pin 2'ye doğru pozitif yok
opamp IN+, IN-, OUT, V+, GND kazanç (100000) GND pininin üzerindeki çıkış gerilimi yok
lm358 1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC kayma milivolt (0) bit 0 = 1OUT, bit 1 = 2OUT orta beslemenin üzerinde yok
lm324 1OUT, 1IN-, 1IN+, VCC, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, GND, 4IN+, 4IN-, 4OUT kayma milivolt (0) bit 0 = 1OUT .. bit 3 = 4OUT orta beslemenin üzerinde yok
tl072 1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ kayma milivolt (0) bit 0 = 1OUT, bit 1 = 2OUT orta beslemenin üzerinde yok
lm741 NULL1, IN-, IN+, V-, NULL2, OUT, V+, NC kayma milivolt (0) OUT besleme orta seviyesinin üzerindeyken 1 yok
ne5532 1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ kayma milivolt (0) bit 0 = 1OUT, bit 1 = 2OUT orta beslemenin üzerinde yok
lm833 1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ kayma milivolt (0) bit 0 = 1OUT, bit 1 = 2OUT orta beslemenin üzerinde yok
opa2134 1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ kayma milivolt (0) bit 0 = 1OUT, bit 1 = 2OUT orta beslemenin üzerinde yok
mcp6002 VOUTA, VINA-, VINA+, VSS, VINB+, VINB-, VOUTB, VDD kayma milivolt (0) bit 0 = VOUTA, bit 1 = VOUTB orta beslemenin üzerinde yok
mcp6004 VOUTA, VINA-, VINA+, VDD, VINB+, VINB-, VOUTB, VOUTC, VINC-, VINC+, VSS, VIND+, VIND-, VOUTD kayma milivolt (0) bit 0 = VOUTA .. bit 3 = VOUTD orta beslemenin üzerinde yok
lmv358 1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC kayma milivolt (0) bit 0 = 1OUT, bit 1 = 2OUT orta beslemenin üzerinde yok
tl081 NULL1, IN-, IN+, VCC-, NULL2, OUT, VCC+, NC kayma milivolt (0) OUT besleme orta seviyesinin üzerindeyken 1 yok
tl084 1OUT, 1IN-, 1IN+, VCC+, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, VCC-, 4IN+, 4IN-, 4OUT kayma milivolt (0) bit 0 = 1OUT .. bit 3 = 4OUT orta beslemenin üzerinde yok
op07 NULL1, IN-, IN+, V-, NC, OUT, V+, NULL2 kayma milivolt (0) OUT besleme orta seviyesinin üzerindeyken 1 yok
ca3140 NULL1, IN-, IN+, V-, NULL2, OUT, V+, STROBE kayma milivolt (0) OUT besleme orta seviyesinin üzerindeyken 1 yok
lm393 1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC kayma milivolt (0) bit 0 = 1OUT, bit 1 = 2OUT serbest (IN+, IN-'nin üzerinde) yok
lm339 1OUT, 2OUT, VCC, 2IN-, 2IN+, 1IN-, 1IN+, 3IN-, 3IN+, 4IN-, 4IN+, GND, 4OUT, 3OUT kayma milivolt (0) bit 0 = 1OUT .. bit 3 = 4OUT serbest yok
lm311 EMIT, IN+, IN-, VCC-, BAL, STRB, COL, VCC+ kayma milivolt (0) COL serbest (veya strobe edilmiş) iken 1 yok
uln2003a 1B, 2B, 3B, 4B, 5B, 6B, 7B, E, COM, 7C, 6C, 5C, 4C, 3C, 2C, 1C yok bit 0..6 = E'nin en az 1.4 V üzerindeki 1B..7B girişleri yok
uln2803a 1B, 2B, 3B, 4B, 5B, 6B, 7B, 8B, GND, COM, 8C, 7C, 6C, 5C, 4C, 3C, 2C, 1C yok bit 0..7 = GND'nin en az 1.4 V üzerindeki 1B..8B girişleri yok
uln2003board IN1, IN2, IN3, IN4, VCC, GND, OUT1, OUT2, OUT3, OUT4 yok bit 0..3 = A..D LED'leri: OUT1..OUT4, VCC'nin en az 1.7 V altında yok
generator OUT, GND wave değeri ("sine", sine/square/triangle değerlerinden biri); frequency Hz (1000); amplitude tepe voltaj (2.5); offset volt (2.5); duty yüzde (50, sadece square) GND pininin üzerindeki çıkış gerilimi yok
funcgen OUT, GND wave metni ("sine", sine/square/triangle/sawtooth değerlerinden biri); frequency Hz (1000); amplitude tepe volt (2.5); offset volt (2.5); duty yüzde (50, sadece square) klemenslerde, GND pininin üzerindeki çıkış voltajı yok
scope CH1, CH2, GND window saniye (0.02, 0.0001 ile 10 arası); volts tam ölçek (5) toprak mandalına göre kanal 1 volt değeri (1 << 32) | pencere mikrosaniye cinsinden veya (2 << 32) | tam ölçek milivolt cinsinden
multimeter V, A, COM mode dizge ("dcv", dcv/acv/dca/aca/ohms/continuity değerlerinden biri) moda göre okunan değer: volt, amper veya ohm; aralık dışı veya açık devrede NaN yok
lm35 VS, VOUT, GND temperature sayı (22.5) Santigrat derece cinsinden sıcaklık derecenin onda biri artı 1000
aht20 VCC, GND, SCL, SDA (0x38 adresinde I2C) temperature sayı (22); humidity sayı (45) Santigrat derece cinsinden sıcaklık (1 << 32) | (tenths + 1000) sıcaklık, (2 << 32) | tenths nem
bh1750 VCC, GND, SCL, SDA, ADDR (ADDR yüksekken 0x23 ve 0x5C adreslerinde I2C) yok lüks cinsinden ışık lüks cinsinden ışık, 0 ile 100000 arası
a3144 VCC, GND, OUT (açık kolektör) operate sayısı (210 gauss); histerezis sayısı (55) mıknatıs kodu, OUT açıkken artı 100000 mm'nin onda biri, 0 ile 400 arası, kuzey kutbu için artı 10000
ss49e VCC, GND, OUT yok sensördeki alan gauss cinsinden, güney pozitif mm'nin onda biri, 0 ile 400 arası (400 mıknatıs yok demektir), kuzey kutbu için artı 10000
photointerrupter SIG, VCC, GND (wheel ayarlıyken ek olarak SHAFT) slots sayı (20), wheel dizge ("": tekerleğin birlikte döndüğü dcmotor veya encmotor kimliği, sürgü için boş) tekerlek kodu (RPM, kart takılıyken artı 10000), SIG yüksekken artı 100000, tekerlek bir motordayken artı 1000000 RPM 0 ile 600 arası (motorda yok sayılır), kart takılıyken artı 10000
linearray GND, VCC, S1 ile S5 arası eşik sayısı (0.5) çizgi kodu, artı siyah üzerindeki kanalların 1000 x'i bit olarak (bit 0 = S1) 100 + mm orta sensörden uzaklıkta (40 ile 160 arası); 1 = enine siyah çubuk; 0 = çizgi yok
fc51 OUT, GND, VCC eşik sayısı (0.5) engel kodu (cm, 80 yok demektir, siyah için 10000 eklenir), lamba yanarken 100000 eklenir 1 ile 80 arası cm, siyah bir nesne için 10000 eklenir
thermalprinter VH, GND, RX, TX, DTR baud sayı (19200); paper bool (true) yazdırılan satır sayısı kağıt: 1 yüklü, 0 bitti
fingerprint VCC, GND, TX, RX baud sayı (57600); enrolled sayı (2); capacity sayı (162); password sayı (0) cam üzerindeki parmak; arama sonucunda bulunduysa 100, bulunamadıysa 200 eklenir parmak, 1 ile 9 arası, veya 0 kaldırmak için
ds1302 VCC, GND, CLK, DAT, RST start metin ("2026-01-01 12:00:00"); halted bool (false) gece yarısından beri geçen saniyeler; durdurulmuşken 100000 eklenir (1 << 32), yani gece yarısından beri geçen saniyeler veya (2 << 32), yani 2000-01-01'den beri geçen günler
amg8833 VIN, GND, SCL, SDA, INT (0x69 adresinde I2C) address sayı (105); background sayı (22); spot sayı (34); pixel sayı (27) en sıcak piksel, C cinsinden (1 << 32) arka plan, (2 << 32) nokta, onda birler + 1000; (3 << 32) noktanın pikseli, yoksa 64
mlx90614 VIN, GND, SCL, SDA (0x5A adresinde SMBus) nesne sıcaklığı (36.6); ortam sıcaklığı (22) nesnenin sıcaklığı, C cinsinden (1 << 32) nesne veya (2 << 32) ortam, artı derecenin onda birleri + 1000
mpr121 VIN, GND, SCL, SDA, IRQ, ADDR (0x5A adresinde I2C) adres numarası (90) dokunma durumu: elektrot 0, 0. bitte parmağın üzerinde olduğu elektrotlar, maske olarak
gp2y0a21 VO, GND, VCC distance sayı (30) mesafe, santimetre cinsinden mesafe, santimetre cinsinden, 1 ile 150 arası
mg996r GND, VCC, PWM min_pulse sayı (544); max_pulse sayı (2400); range sayı (180) boynuz açısı, derece cinsinden, 0 ile aralık arasında yok
yfs201 VCC, GND, SIG flow sayı (0) dakikada litre cinsinden akış akış, dakikada litrenin onda birleri cinsinden, 0 ile 300 arası
adxl335 VCC, X, Y, Z, GND tilt_x sayı (0); tilt_y sayı (0) derece cinsinden X eğimi (1 << 32) veya (2 << 32), artı X veya Y eğimi + 90
pulsesensor S, VCC, GND bpm sayı (72); swing sayı (0.8) kalp atış hızı, dakikadaki atış sayısı (parmak yoksa 0), ana tepe geçerken 1000 eklenir kalp atış hızı, dakikadaki atış sayısı, 30 ile 220 arası, veya parmak yoksa 0
coinacceptor DC12V, COIN, GND, COUNTER pulse sayı (50); nc bool (false) açılıştan beri gönderilen darbeler, COIN aktifken 100000 eklenir bu kadar darbeye değer bir madeni para, 1 ile 50 arası
waterpump V+, V- voltage sayısı (6); flow sayısı (120); resistance sayısı (4); inertia sayısı (50); back_emf sayısı (0.85) saatte litre cinsinden akış yok
fanmodule INA, INB, VCC, GND gerilim sayısı (5); atalet sayısı (250) pervane hızının tam hıza göre yüzdesi, ters yönde negatif yok
laser S, VCC, GND resistor sayısı (100) ışının algılanan parlaklığı, 0 ile 1 arası yok
trafficlight R, Y, G, GND direnç sayısı (220) yanan LED'ler bit maskesi olarak: kırmızı bit 0, sarı bit 1, yeşil bit 2 yok
sw420 VCC, GND, DO eşik sayısı (0.5) 0 sabit, 1 sallanıyor, 2 vuruyor, ayrıca lamba yanarken 100000 eklenir (DO düşük) 0 sabit, 1 bir sonraki dokunuşa kadar sallanıyor, 2 tek vuruş
mq3 hedefine mq137 (mq3, mq4, mq5, mq6, mq7, mq8, mq9, mq131, mq135, mq137) VCC, GND, DO, AO gas metin (sensöre göre, grafiğinden); r0 ohm; rl ohm; threshold sayı; warmup saniye (20) gaz, sensörün biriminde (ppm; MQ-3'te mg/L'nin yüzde biri; MQ-131'de ppb), ayrıca DO lambası yanarken 100000, ısınırken 200000 eklenir gaz, o birimde, 0 ile grafiğin tepesi arası
ky037 AO, GND, VCC, DO threshold sayısı (0.505); sensitivity dBV/Pa (-42) ky038 gibi ky038 gibi
ky004, ky017, ky021, ky031 S, VCC, GND resistor değer ("pull-up" veya "pull-down"); settle ms (ky004 3, ky017 0, ky021 0.5); ky021 close mm (15), release (0.8) ky004 1 basıldı; ky017 1 devrildi; ky021 mıknatısın mm cinsinden değeri; ky031 0 sabit, 1 sallanıyor, 2 vuruyor aynı kodlar
sw18010p 1, 2 yok 0 sabit, 1 sallanıyor, 2 tıklatıyor 0 sabit, 1 bir sonraki dokunuşa kadar sallanıyor, 2 tek vuruş
ky024, ky025, ky028 AO, GND, VCC, DO threshold sayısı (0.6, 0.5, 0.45); ky025 close mm (15), release (0.8); ky028 beta K (3950) dokunuş kodu, ayrıca DO lambası yanarken 100000 eklenir (DO yüksek) ky024 mm'nin onda biri, kuzey için artı 10000; ky025 mıknatısın mm'si, 0 ile 60 arası; ky028 derecenin onda biri artı 1000
ky035 VCC, GND, S yok ss49e gibi ss49e gibi
temt6000 SIG, GND, VCC sensitivity lüks başına uA (0.5) lüks cinsinden ışık lüks, 0 ile 2000 arası
rotation GND, S, VCC value ohm (10000); taper dizge potentiometer gibi potentiometer gibi
steam S, VCC, GND full kesir (0.66) taranın ıslak kısmı, yüzde olarak yüzde, 0 ile 100 arası
e18d80nk VCC, GND, OUT range cm (40, 3 ile 80 arası); pullup bayrağı (false) hedefin cm'si (100 yok demektir), ayrıca algılarken 100000 eklenir cm, 1 ile 100 arası
ttp223 SIG, VCC, GND toggle bool (false); activelow bool (false) bit 0 parmak ped üzerinde, bit 1 SIG yüksek 1 parmak üzerinde, 0 kapalı
battery V+, V- kind dizge ("9v", 9v/aa2/aa3/aa4/18650/18650x2 değerlerinden biri); charge sayısı (100) uçlar arasındaki volt yok
solar +, - yok panel üzerindeki volt metrekare başına watt, 0 ile 1200 arasında (1000 tam güneştir)
tp4056 IN+, IN-, BAT+, BAT- yok mA cinsinden şarj akımı, bekleme lambası yanarken artı 10000 yok
regulator IN, GND, OUT model dizisi ("7805", 7805/AMS1117-3.3/MCP1700-3.3 seçeneklerinden biri) GND'ye göre OUT, volt cinsinden yok
tb6612 PWMA, AIN2, AIN1, STBY, BIN1, BIN2, PWMB, GND1, VM, VCC, GND2, AO1, AO2, BO2, BO1, GND3 yok kanal modları, A 0-1 bitlerinde ve B 2-3 bitlerinde: 0 kapalı, 1 saat yönü, 2 saat yönünün tersi, 3 fren yok
l9110 BIA, BIB, GND, VCC, AIA, AIB, OA1, OA2, OB1, OB2 yok motor sürüşü, A 0-1 bitlerinde ve B 2-3 bitlerinde: 0 kapalı, 1 ileri, 2 geri, 3 fren yok
encmotor M1, M2, VCC, GND, A, B düz motorun voltajı (6), rpm (200), direnci (6), ataleti (120), back_emf (0.85), ayrıca ppr sayısı (11) ve ratio sayısı (30) tekerlek hızı rpm cinsinden, işaretli yok
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) derece cinsinden eğim, ileri yönde pozitif 1 onu dik kaldırır, 3 bırakır, (2 << 32) | (push in mN s + 1000000)
clawcabinet XA1, XA2, XB1, XB2, YA1, YA2, YB1, YB2, VCC, GND, W+, W-, CLAW, XHOME, YHOME, BEAM genişlik (200 mm), derinlik (160 mm), düşme (90 mm), start_x (120 mm), start_y (80 mm), ödül (3), uzanma (20 mm), tutuş (130 derece), akım (1.7 A), max_steps (1000) pençenin üstten aşağı mm cinsinden derinliği; enstrüman kanalında tüm durum 1 ödülleri geri koyar
clawcabinetdc X+, X-, Y+, Y-, VCC, GND, W+, W-, CLAW, XHOME, YHOME, BEAM clawcabinet gibi, ama akım ve max_steps yerine dişli motorların voltaj (6) ve rpm (200) değerleri clawcabinet gibi 1 ödülleri geri koyar
vendingcabinet M1, M2, M3, M4, VCC, GND, DROP stock (her spiral için 3), rpm (110) bölmedeki atıştırmalıklar; enstrüman kanalında tüm durum 1, her spirali yeniden doldurur ve kutuyu boşaltır
pinballcabinet FL, FR, VCC, GND, KICK1, KICK2, TA, TB, TC, B1, B2, DRAIN, LAUNCH flip_speed (saniyede 1200 derece) topun masada yukarı doğru yüksekliği (mm), geri yuvarlanırken -1; tüm durum enstrüman kanalında 1 topu fırlatıcı kol üzerine koyar; 0x100 + n n anahtarını tutar (TA, TB, TC, B1, B2, tahliye huzmesi, fırlatıcı kol) ve 0x200 + n onu bırakır
barriercabinet VCC, GND, TRIG, ECHO, R, Y, G, ARM, V+ açı (0 derece) kolun açısı; enstrüman kanalında tüm durum 1, şeridi yukarı doğru bir araba gönderir
sortercabinet VCC, GND, SCL, SDA, SERVO şeker (12), periyot (2000 ms) bölmelerdeki şekerler; enstrüman kanalındaki tüm durum 1 hazneyi yeniden doldurur ve bölmeleri boşaltır; 0x1000000 + 0xRRGGBB sıradaki şekeri o renkte yapar
soapcabinet VCC, GND, OUT, M+, M- eşik (0.5), şişe (30 ml), ml_per_turn (0.5), voltaj (6), rpm (200) şişe doldurulduğundan beri pompalanan sabun, ml cinsinden; enstrüman kanalında tüm durum musluğun cm altında bir el, 1 ile 80 arasında (80 kimse yok), artı siyah eldiven için 10000; 1000000 şişeyi doldurur

Bir foto kesicinin motora takılı wheel parçası, ağ listesi yoluyla ona bağlanır (web/src/sim/wheel-mount.ts): iki parçanın SHAFT pinleri aynı ağda ve dcmotor ya da encmotor üzerinde shaft: true, kataloğun atladığı iç bir işaret (PropInfo::internal) motora o pini verir. Çıkış milinin hızını, işaretsiz olarak, rpm başına 1 mV ile taşır.

Çipler, VCC ve GND pinleri arasındaki voltaj en az 2 V olduğunda güç alır (NE555 için 4.5 V); gücü yokken tüm çıkışlar yüksek empedanstır.

Birimler: resistor.value ohm, capacitor.value mikrofarad, inductor.value milihenry.

Osiloskopun örnek kanalı

Osiloskop örneklerini, bir ekranın piksellerinin izlediği yolun aynısından taşır: readHost, kare başına bir kez toplanır, katalog host alanı null'dır çünkü o alan "seri monitörün konuştuğu bir metin kanalı" anlamına gelir ve bunlar örnektir.

readHost(scopeIndex), son çağrıdan beri örneklenen her şeyi tek bir küçük endian mesaj olarak döndürür; hiç örnek alınmamışsa hiçbir şey döndürür:

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

Hiçbir yere bağlanmamış bir prob NaN okur. Parça, toplamayı bırakmış bir ana makine için 1024 örnek tutar, sonra en eskisini düşürür ve düşürme bayrağını ayarlar.

Zaman tabanı ve tam ölçek özelliklerdir ve ayrıca poke edilebilirler, çünkü bir izi izlerken kişinin değiştirdiği iki şey bunlardır ve birini değiştirmek için ağ listesini yeniden oluşturmak simülasyonu yeniden başlatırdı. Bir pencere poke'u anında etkili olur: parça göndermediği her şeyi temizler, UI çizdiği ekranı bıraksın diye bir sonraki mesajında yeniden başlat bayrağını ayarlar ve devre fark etmeden yeni hızda örneklemeye devam eder.

Tezgah enstrümanları

funcgen, scope ve multimeter, tuvale bırakıp devreye bağladığın üç alettir ve sıradan parçalardır: motora ayrıcalıklı bir yol yok, katalogda bulunmayan hiçbir şey yok.

  • funcgen şudur generator testere dişi ve gerçek bir çıkış empedansıyla: 50 ohm, Norton çifti olarak damgalanır (bir akım kaynağı: v(t)/50 üzerinde 50 ohm ile), çünkü bir parçanın seri direnç asılacak iç düğümü yoktur. Bir yük buna karşı bölünür; bu, bir tezgah jeneratörünün öğrettiği ilk şeydir. generator ideal kalır ve bir düğümü sürüp unutmak için hâlâ doğru parçadır.
  • scope iki 1 Mohm probla bir toprak klipsidir; bir adaya katılır, asla ada başlatmaz.
  • multimeter aralarında 10 Mohm'dur, V ve COM voltaj kademelerinde aralarında 1 ohm şönt bulunan A ve COM (ikisi de hızlı dijital yolda bir Thevenin geçirir ve bir ada onlara ulaştığında damgalanır); ohm ve süreklilik kademelerinde ise üzerinde 100 kohm olan 30 uA'lık bir test akımı vardır ve bu bir ada başlatır. 250 ms'lik bir açıklıkta 4 kHz ile integrasyon yapar ve saniyede dört kez bir okuma yayınlar: DC kademesinde ortalama, AC kademesinde AC kısmın gerçek RMS değeri, ohm kademelerinde ise o test akımının ima ettiği direnç, NaN 1 Mohm üzeri. Yaklaşık bir kilohertz üzerinde AC okuma yeterince örneklenmez ve düşük değer gösterir.

pushbutton üzerindeki temas zıplaması

Gerçek bir mekanik buton kapanır, seker ve yerleşir; bu yüzden pushbutton her basışta ve her bırakışta seker. bounce özelliği profili seçer:

bounce basış veya bırakış başına geçiş süresi içinde yerleşir
none 1 hemen
typical 3 ila 8 1 ila 5 ms
worst 20'ye kadar 10 ila 20 ms

Varsayılan typicaldır: buton devrenin ana konusu değilse none seç, bir kodun neden debounce yapması gerektiğini göstermek için worst seç. Butona kablolanan her şey sekmeyi sıradan kenarlar olarak görür (bir 74HC girişi, bir NE555 tetiği, bir kartın GPIO'su), çünkü buton ağlarını her zaman olduğu gibi sürer; sözleşmedeki başka hiçbir şey değişmez.

Her sekme dizisi anında bir kenarla başlar (temas basıldığında gerçekten kapanır) ve kalanını zamanlama çarkındaki uyandırmalar olarak oynatır; sonuncusu tam yerleşme zamanına denk düşer. Sayı tek olduğu için bir sekme dizisi her zaman istenen durumla biter. Sekme dizisinin ortasında gelen bir poke (hâlâ sekerken bırakma) kalanını iptal eder ve yeni bir sekme dizisi başlatır. Boşluk uzunlukları, parçanın ağ listesindeki indeksinden tohumlanan parça başına rastgele bir akıştan gelir; böylece bir devredeki iki buton farklı şekilde seker, art arda basışlar farklıdır ve aynı ağ listesi aynı şekilde poke edildiğinde pikosaniyeye kadar aynı kenarları üretir: bir çalıştırma tekrarlanabilir.

Bir parça görseli interaction: 'hold' (işaretçi aşağıdayken 1, yukarıdayken 0 poke eder) veya 'toggle' (prob en az 0.5 olduğunda bir tıklama 0, değilse 1 poke eder) bildirebilir. Tuval asla bir parça türü adı vermez.

UI'nin bir parçayı çizmek için gerektiği her şey web/ içindedir. Bir parçanın davranması için gerektiği her şey crates/parts içindedir. Bunlar yalnızca type, pin adları ve props üzerinde buluşur.

5. Çalıştırma döngüsü (UI tarafı)

Sim.runForNs(ns), simüle edilmiş zamanı ns kadar ilerletir ve döner; nowNs() yeni toplamı bildirir. UI bunu requestAnimationFrame içinden çağırır ve simüle edilmiş zaman = duvar zamanı hedefler, kare başına bir duvar bütçesiyle (örneğin 12 ms); simülatör geride kalırsa UI donmak yerine elde edilen hız oranını gösterir. Simülatör bir Web Worker içinde çalışır (web/src/sim/client.ts), böylece çalışırken sayfa duyarlı kalır.

probes(), netLevels() ve netEdges() her karede bir kez, birlikte okunur ve arayüzün çizim yaptığı anlık görüntüye aktarılır. netEdges() şunun için vardır: karede bir kez okunan seviye, yalnızca her ağın sonuçta nerede kaldığını gösterir; titreşen bir kontak birkaç milisaniyede yirmi kenar üretir, bu da 16 ms'lik bir karenin içine rahatça sığar ve bunları isteyen bir ders bunları sayabilmelidir. Kenar, temiz seviyenin değişimidir (düşükten belirsizse ve yüksele çıkarsa bir kenardır; düşükten yüzen duruma ve tekrar düşüğe dönerse kenar sayılmaz) ve aynı anda geri alınan bir sıçrama hiç sayılmaz. Sayaçları okumak onları sıfırlar, bu yüzden kare döngüsü tek çağırıcıdır. netVoltages() aynı geçişte okunur ama yalnızca sayfada volt gösteren bir şey varsa: varsayılan olarak kapalı olan Seviyeleri göster göstergesi (web/src/ui/levels.ts). Bunları istemeyen bir anlık görüntü boş bir dizi taşır, böylece ağ başına kare başına bir ağ voltajı, okunmadığı sürece hiçbir şeye mal olmaz.

6. Elektriksel model

Bir ağdaki her sürücü, bir kaynak empedansıyla bir voltajdır (Drive { voltage, impedance, level }). Bir ağın voltajı, sürücülerinin empedans ağırlıklı ortalamasıdır (Millman). Güçlü bir dijital çıkışın empedansı onlarca ohm kadardır, bir pull-up'ınki direnç değeridir, yüksek-Z'ninki sonsuzdur. Bir ağın dijital level'i en düşük empedanslı sürücüden gelir; eşit empedanslı sürücüler aynı fikirde değilse Bilinmiyor'dur; sürücü yoksa Yüzen'dir. İki uçlu parçalar bir pinden görülen Thevenin eşdeğerini okur (kendi katkısı hariç) ve öbür pini ona göre sürer.

Hızlı yol budur ve üzerinde analog bir şey bulunmayan her ağ hâlâ bunu yapar.

6a. Analog adalar

Davranışı aynı anda birkaç düğüm üzerinden diferansiyel denklem olan bir parça (kondansatör, bobin, op-amp, sinyal üreteci) kendisini Component::analog yeteneğiyle analog olarak bildirir ve çekirdek, dokunduğu her ağı island içine toplar; bu ada crates/analog tarafından tek bir matris olarak çözülür: değiştirilmiş düğüm analizi, kısmi pivotlu LU çözümleme, açılışta tüm kondansatörler boşalmış ve tüm bobinler akımı sıfırken bir DC çalışma noktası, ve yamuk (trapezoidal) eşlik modelleri ile yerel kesme hatasına göre seçilen adımla bir geçici analiz.

İki yarı üç yerde ve başka hiçbir yerde buluşur.

  • Giriyoruz. Bir ada ağında bulunup adaya ait olmayan her sürücü, Millman ile tek bir direncin arkasında tek bir voltaja çökertilir ve o düğümde bir Thevenin kaynağı olarak damgalanır. Bir dijital pin bir Thevenin kaynağıdır; arayüzün tamamı budur.
  • Çıkışta. Ada, herhangi bir pin gibi, ağlarının her birinde bir sürücü yuvasına sahiptir ve o düğümde adanın kendi Thevenin eşdeğerini (o ağın sınır sürücüsü çıkarılmış ada) yazar; böylece ikisinin sıradan Millman kuralıyla çözülmesi, çözülmüş düğüm gerilimini tam olarak yeniden üretir.
  • Zaman. Ada, zamanlama çarkında kendi sonraki adımını ayırır. Hareket eden bir kaynağı olmayan yerleşmiş bir ada hiçbir şey ayırmaz, dolayısıyla boşta duran bir analog devrenin maliyeti, boşta duran bir dijital devreninki kadardır.

Analog giriş eşiği olan bir parça (bir karşılaştırıcı, bir 555'in iki tetikleme noktası) Ctx::watch(pin, volts, hysteresis) çağırır; ada bu durumda adımını geçiş üzerine iyileştirir ve üzerinden atlamak yerine geçişi yakalar, böylece tetikleme zamanı bir entegrasyon adımının uzunluğuna değil, bir mikrosaniyeye kadar doğru olur. Ada dışındayken bu çağrı hiçbir şeye mal olmaz ve hiçbir şeyi değiştirmez. Bir mikrodenetleyicinin dijital girişi de aynı şeyi Ctx::read_input(pin, threshold) üzerinden yapar; bu, pini çipin kendi anahtarlama seviyesinde izler ve sonra okur: her kart giriş pedlerini bu şekilde okur, dolayısıyla yavaş bir analog kenar, 3.3 V'luk bir parçaya ve 5 V'luk bir parçaya, çekirdeğin tek bir LOGIC_THRESHOLD değerinde değil, her birinin gerçekte anahtarlanacağı gerilimde ulaşır. Bir giriş pini, firmware'inin etkinleştirdiği pull-up veya pull-down dışında adaya hiçbir yük getirmez; gerçek bir CMOS girişinin alt-mikroamper sızıntısı modellenmez.

Adalar en fazla her 2 ms'de bir, en az her 100 ns'de bir adım atar ve adımı, en hızlı hareket eden zaman sabitinin altmış dörtte birinde tutarlar, böylece adımlar arasında örneklenen bir iz bundan daha fazla geride kalmaz. Bir direnç, kendisine ulaşan bir adaya katılır ama asla ada yaratmaz; bir osiloskop probu, topraklama kelepçesine göre 1 Mohm'dur ve aynı şeyi yapar.

6b. Doğrusal olmayan adalar

İçinde aygıt fiziği barındıran bir parça (bir diyot, bir LED, bir bipolar transistör, bir MOSFET), elemanlarının yanına AnalogPart::devices bildirir ve bunları bir Element::Device { nodes: [Node; 4], dev: u32 } üzerinden adlandırır; buradaki dev, o parçanın kendi aygıt listesine işaret eder. Element Copy olarak kalır; aygıtlar ada üzerinde Box<dyn Device> olur. Çekirdek, parçaları bir adaya birleştirirken her parçanın aygıt indekslerini kaydırır ve onlar hakkında başka hiçbir şey bilmez: hiçbir aygıt adı sim-kernel içine ulaşmaz ve fizik, tamamen crates/analog içinde tanımlanmış bir trait'in arkasındaki crates/parts içinde yaşar.

Bir Device üç şey yapar. Mevcut yinelemedeki uç gerilimlerinden bir eşlik modeli (iletkenlikler ve eşdeğer akım kaynakları) yükler. Bir sonraki yüklemeden önce son çözümün ürettiği gerilimleri sınırlar; bu, bir pn eklemi için SPICE'ın pnjlim fonksiyonudur ve yakınsayan bir diyot ile exp taşması yapan bir diyot arasındaki farktır. Ve parametrelerini düz bir sayı vektörü olarak raporlar, böylece Ctx::restamp_device(which, params), bir adayı yeniden kurmadan bir beta değerini taşıyabilir; tıpkı Ctx::restamp bir direnci taşıdığı gibi.

Çözüm Newton-Raphson'dur: her aygıtı yükle, çarpanlara ayır, çöz, her bilinmeyeni reltol |x| + abstol ile sına (düğüm satırında volt, dal satırında amper), sınırla, tekrarla; en fazla Limits::max_iter kez. Aygıtı olmayan bir ada tam olarak bir geçiş yapar ve her zaman ürettiği matrisi üretir; ders kitabı testleri bunu son basamağına kadar doğrular. Soğuk bir başlangıçtan Newton'un ulaşamadığı bir çalışma noktası gmin adımlamasına düşer (her düğümde miliohm ölçeğinde bir kaçak, GMIN'e kadar geri yürütülür), sonra kaynak adımlamasına düşer ve sonra bir şeyi uydurmak yerine başarısızlığı raporlar. Yakınsamayan bir geçici adım yarıya iner ve hata denetleyicisinin kullandığı bütçeyle yeniden dener; tabanda yineleme olduğu gibi kalır ve başarısızlık Solver::stats() içinde sayılır; bu aynı zamanda yinelemeleri, sınırlanmış yinelemeleri ve reddedilen adımları da taşır, böylece testler duvar zamanına değil bunlara göre doğrulama yapabilir.

1. fazdaki aygıtlar: bir diyot (Shockley modeli, Is, N ve bir gövde Rs ile), bir LED (arkasında renge göre düşüşü 20 mA'de veren aynı bağlantı), bir bipolar transistör (taşıma biçiminde Ebers-Moll, Bf, Br, Is ve bir Early gerilimi ile, NPN ve PNP; Ekim 2026'dan beri transistor parçası, her üreticinin kendi kartında tam Gummel-Poon modelidir) ve bir MOSFET (1. seviye Shichman-Hodges, Vto, beta ve lambda ile, N ve P kanal). Bir parça, aynı aygıtı adada da adanın dışında da kullanır: iki uçlu bir parça, aynı denkleme karşı kendi üzerinden geçen tek döngüyü çözer ve üç uçlu bir parça, üzerinde kendi aygıtı bulunan özel bir üç düğümlü ada kurar ve aynı çözücüye sorar. Her aygıt için tek bir model vardır, asla iki değil.

Bunlar 1. aşamanın aygıtlarıydı. O zamandan beri analizler geldi (çalışma noktası, DC ve parametre taramaları ile AC frekans yanıtı, bölüm 7), her aygıt kartı eklem kapasitansını taşıyor ve operasyonel yükselteç tek kutuplu bir makromodel. Tuvalde sıcaklık hâlâ 27 C olarak sabittir; bir SPICE destesi (bölüm 7e) .temp içerir.

Uygulamanın, yukarıdaki üç kuralın söylemediği şeyler

  • Adalar bir kez, Kernel::init sırasında bulunur. Çekirdek topolojisini orada dondurur, dolayısıyla bir kablo değişikliği yeni bir ağ listesi ve yeni bir çekirdektir; zaten arayüz her düzenlemede bunu yapıyor. Artımlı yeniden keşif yok ve buna gerek de yok.
  • Bir parçaya katılıp katılmadığı söylenir. Component::analog_joined(bool), keşiften sonra bir kez çağrılır. Damgalanmış bir parça pinlerini ayrıca sürmemelidir ve bir kondansatörün kendi entegratörünü durdurması, bir direncin bir Thevenin'i aktarmayı bırakması ve bir potansiyometrenin sürgüsünü sürmeyi bırakması tam burada olur.
  • Bir parça çözülmüş değerleri isteyebilir. Component::analog_solved(currents, volts), her çözümden sonra, o parçanın bildirdiği elemanlar için, AnalogPart bunu reporting() ile istediğinde çağrılır. Bir bobinin akımı, düğüm gerilimlerinin bir fonksiyonu değil matrisin bir durumudur, dolayısıyla bir parçanın kendi ağlarından okuyamadığı tek şey budur.
  • Değerler yeniden kurulum olmadan değişebilir. Ctx::restamp(&[Element]), çekirdeğe parçanın damgalarını oldukları haliyle verir; çekirdek değerleri onlardan alır, düğümlere dokunmaz ve her kondansatör gerilimini ve her bobin akımını tutarak o anda yeniden çözer. Bir potansiyometrenin düğmesi tam olarak bunun içindir. Bir adanın şekli asla değişmez; sadece içindeki sayılar değişir.
  • Havada bir pin kendi başına bir düğümdür. Hiçbir şeye kablolanmamış bir analog pin, üzerinde yalnızca gmin bulunan yeni bir düğüm alır, böylece bir bacağı havada asılı duran bir kondansatör yükünü korur ve hiçbir şeyi sürmez.
  • Bir ada bir saniyelik ufka park eder. Tuttuğu hiçbir şeyin, simüle edilmiş zamanın önümüzdeki bir saniyesinde bir toleranstan fazla hareket etmeyeceği zaman adım ayırmayı bırakır. Önümüzdeki step içinde bir şey olup olmayacağını sormak yanlış bir sorudur: bir üstelinin kuyruğu, varmadan çok önce adım başına bir toleranstan az hareket eder.
  • Çekirdek ne kadarını çözdüğünü söyleyebilir. Kernel::island_count, island_of_net ve island_nodes, bu sözün hızlı yolunu tutan testler için var. Dijital bir ağ listesi ada oluşturmaz ve crates/sim-kernel/tests/kernel.rs bunu, 497 parçalı kanıt devresi üzerinde, o devrenin her zaman gerektirdiği dispatch sayısıyla birlikte doğrular.

Her iki potansiyometre de bir direncin yaptığı gibi bir adaya katılır: bir iz iki dirençtir, alt uçtan süpürgeye R x f ve süpürgeden üst uca R x (1 - f), ve bir ada dışındayken bu iki direnç, pin başına bir Thevenin kaynağına katlanır.

7. Analizler

Simüle edilen zamanı ilerletmeyen çağrılar. Yüzeydeki başka her şey runForNs üzerinden geçer; bunlar bir analiz çalıştırır ve bir cevap döndürür, bu da sözleşme için farklı bir şekildedir ve bu bölümün var olma sebebi budur.

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 ve analogNets, nets[] sırasına göre ağ başına bir giriştir; probes, parts[] sırasına göre parça başına birdir. Sayı olmayan bir gerilim (yüzen bir ağ) null olarak döner, asla sayı olarak değil.

Motorun şu anda tuttuğu çözümü raporlar ve asla yeniden çözmez. Hiçbir şey çalışmadan önce, tNs sıfırken bu, açılış anındaki çalışma noktasıdır: her kondansatör boşalmış, her bobinin akımı sıfırdır. Bu, az önce açılmış bir devredir ve kondansatörün açık devre sayıldığı SPICE'teki .op ile aynı değildir. Oturmuş DC cevabı için, devre oturana kadar çalıştır ve çalışma noktasını o an al. Sonuçta tNs yer alır, böylece bir göstergenin hangisinin gösterildiğini söyleyebilir.

analogNets[i], i ağı matrisle çözüldüyse true, sürücü başına modelle çözüldüyse false'tur. Bunlar farklı türde cevaplardır ve bir göstergenin bunu söyleyebilmesi gerekir.

parts yalnızca analog bir adaya damgalanan parçaları tutar, damgaladıkları her eleman için bir girişle, damga sırasına göre. amps, elemanın ilk ucundan ikincisine doğru akan akı pozitiftir ve volts, aynı sırada bu iki uç arasındaki gerilimdir. Girişi olmayan bir parçanın matriste dal akımı yoktur; bu, akımının olmamasıyla aynı şey değildir ve orada cevap genellikle probes'tir: bir direncin probu, matrise girip girmediğine bakılmaksızın akımıdır (katalogdaki probe, her parçanın probunun ne anlama geldiğini söyler).

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 ikisine de eklenebilir; her noktayı okumadan önce açılıştan o kadar ileri çalıştırır ve sıfırdan büyük herhangi bir değer, artık noktanın bir DC cevabı olmadığı anlamına gelir.

{
  "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, parts ile paraleldir ve her analog parçanın ilk elemanını taşır. Çalıştırılamayan bir analiz, error ayarlanmış ve points boş olarak döner; asla istisna fırlatmaz.

İki yol, çünkü bu motorda ayarlanabilir iki tür şey vardır.

  • prop her noktada devreyi ağ listesinden, yalnızca o sayı değiştirilmiş şekilde yeniden kurar ve açar, dolayısıyla her nokta bir soğuk başlangıç DC çalışma noktasıdır ve continued yanlıştır. Sayı olmayan bir özellik sözle reddedilir, parçada olmayan bir özellik de öyle.
  • poke: true parçanın poke kodunu canlı devrede (bir potansiyometrenin mili) çalıştırır, bu da yerinde yeniden damgalar ve yeniden çözer, yani continued doğrudur ve discrete doğrudur, çünkü bir mil bütün bir sayıdır, bir süreklilik değil. Parça, taramanın bulduğu yere geri konur.

Bir taramanın aldığı en çok nokta sayısı 1001'dir. Ötesi, çalıştırılmak yerine sayı mesajda verilerek reddedilir.

7c. setMaxStepNs(ns, fixed) ve stepLimitNs()

Bir ayar olarak Limits.dt_max. ns, herhangi bir analog adanın atlayabileceği en uzun adımdır; fixed, tabanı da buna sabitler, böylece hata denetleyicisinin seçebileceği tam olarak tek bir adım kalır. Sıfır veya daha küçük bir değer bu ayarı kaldırır ve her adayı çekirdeğin kendi 2 ms tavanına geri döndürür.

Zorlanan bir adımı hâlâ kısaltan iki şey vardır ve ikisi de bilinçlidir: bir kaynaktaki süreksizlik üzerinden entegre etmek yerine tam üzerine inilir ve bir adımın içindeki izlenen mantık eşiği, kesişimin üzerine inceltilir. Hiçbir şey onu uzatmaz, dolayısıyla zorlanan bir adım, "en az bu kadar ince" sözüdür.

Bir parça, kendi adasında aynı şeyi Ctx::limit_step(dt, fixed) ile isteyebilir ve bir adadaki en ince istek kazanır. scope parçasının step özelliği o çağrıdır: varsayılan olan sıfır, denetleyiciyi rahat bırakır.

7d. acSweep(specJson: string): string

{ "source": "gen1", "probe": 4, "fStart": 10, "fStop": 100000, "pointsPerDecade": 20 }

input eklenebilir: kazancın hangi ağ indeksine göre alındığı. Belirtilmezse, kaynağın kendi elemanının sürdüğü ağdır; bu da kişi bir üreteç seçtiğinde "giriş" ile kastettiği şeydir.

{
  "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": ""
}

Beş dizi paraleldir ve frekans başına bir eleman uzunluğundadır. magDb ve phaseDeg, çıkış fazörünün giriş fazörüne oranıdır (20 log10 |Vout / Vin| ve derece cinsinden arg(Vout / Vin)); burada aktarım fonksiyonu olan tek şey budur. inputMag ve outputMag, uyarım hangi birimdeyse o birimde ham fazör büyüklükleridir ve source.drive hangisi olduğunu söyler: vsource kaynak boyunca bir volt, isource kaynağa içeri bir amper, thevenin direncinin arkasında açık devrede bir volt. Bir fonksiyon üreteci bir Norton çiftidir, dolayısıyla sürüşü isource değeridir ve inputMag değeri volt yerine ohm cinsinden bir empedanstır; oran bundan etkilenmez, zaten oran raporlamanın da amacı budur.

freq, fStop dahil olmak üzere fStart * 10^(k / pointsPerDecade) değeridir; bu, .ac dec komutunun izlediği aynı ızgaradır, yani buradaki bir tarama ile aynı üç sayıya sahip bir referans simülatördeki tarama nokta nokta karşılaştırılabilir. fStart sıfırdan büyük olmalıdır: sıfır hertz DC'dir, bu da bir çalışma noktasıdır ve logaritmik taramanın bir noktası değildir. Bir taramanın alabileceği en çok nokta sayısı 1001'dir; bu, sweep ile aynı üst sınırdır.

Motorun o anda bulunduğu çalışma noktası etrafında alınır, tam operatingPoint'in raporladığı gibi, ve hiçbir şeyi yeniden çözmez. Şurada: tNs sıfırken bu açılış öngerelmesidir; zaman ilerledikten sonra o anki durumdur ve tNs hangisi olduğunu söyler. Doğrusal olmayan her cihaz, Newton'un bıraktığı yerdeki yinelemede doğrusallaştırılır ve her op-amp, çalışma noktasının hangi kipe koyduysa o kiptedir: doyuma girmiş bir op-amp doygun damgalanır, dolayısıyla küçük işaret kazancı sıfırdır.

Analog 3 faz 1'den beri her cihaz kartı kendi jonksiyon kapasitansını taşır ve AC damgası, geçici analizin entegre ettiği aynı dQ/dv değerinde j w C olur; böylece bir transistörün kendi yüksek frekans köşesi vardır ve ortak emiter katı Miller etkisini gösterir. Modelde olmayan şeyler crates/analog/src/ac.rs dosyasında ve docs/help/editor/analysis.md dosyasında tekrarlanır: BJT'de ters geçiş süresi TR yoktur, bir MOSFET'in kapı-tahliye kapasitansı sabittir ve bu yüzden Miller platosu yoktur, TIP120 Darlington'da hiç kapasitans yoktur; gürültü analizi ve bozulma analizi yoktur, çünkü doğrusallaştırılmış bir devrede ikisi de bulunmaz; ve operasyonel yükselteç hâlâ ray sınırlı, doğrusal ve kazancı sonsuz frekansa kadar düz olan modeldir.

Çalıştırılamayan bir analiz error değeriyle ve boş dizilerle döner; asla hata fırlatmaz. Ters giden üç şey hangisi olduğunu söyler: adı geçen parçanın bir AC analizinin sürebileceği bir kaynağı yoktur, bir ağ kaynakla aynı analog adada değildir, ya da aralık bir aralık değildir.

7e. spiceRun(deck: string, filesJson: string): string

Modülün serbest bir fonksiyonudur, Sim sınıfının metodu değildir: crates/spice üzerinde bir SPICE destesi çalıştırır ve yüklenmiş herhangi bir devreyle ilgisi yoktur. filesJson şöyle görünür: [{ "name": "models.lib", "text": "..." }]; bunlar destenin .include veya .lib ile çağırabileceği dosyalardır (önce tam adla, sonra yalnızca dosya adıyla eşleştirilir) ya da boş bir dizgidir. Yanıt:

{ "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.

Sorular

Bu SPICE mı?

Netlistler için evet: düzenleyici menüsündeki SPICE destesi çalıştır seçeneği, .op, .tran, .ac, .dc, .tf, .noise ve .meas komutlarını, 42 kıyaslama devresinde ngspice ile doğrulanmış bir SPICE motorunda çalıştırır; BSIM MOSFET modelleri, XSPICE veya bozulma analizi yoktur. Tuvalde bir devrenin analog köşeleri düğüm analiziyle, SPICE'ın yaptığı gibi bir matris olarak çözülür, geri kalan her şey olay güdümlü dijital yolda çalışır; birkaç yüz parçanın bir dizüstünde gerçek zamanlı çalışmasını sağlayan da budur.

Bana ne söylemez?

Canlı tuvalde: gürültü, sıcaklık, bozulma veya bir aktarım fonksiyonu yoktur ve hiçbir parçanın güç değeri yoktur, dolayısıyla hiçbir şey yanmaz. Tuval DC çalışma noktası, taramalar ve frekans yanıtı verir; bir SPICE destesi gürültü, .tf ve .temp ekler. Bir deste BSIM MOSFET modelleri, XSPICE aygıtları, Monte Carlo veya bozulma analizi çalıştırmaz.

Gerçekte ne kadar hızlı?

Çekirdek, birkaç yüz parçayı gerçek zamanlı tutar ve CPU çekirdekleri sıradan bir dizüstünde gerçek çiplerle kabaca aynı hızda çalışır.