يحاكي Mokxi الدائرة بثلاثة محرّكات، وهذه الصفحة هي العقد الذي يلتزم به كل واحد منها.
- النواة الرقمية. نواة مدفوعة بالأحداث تُشغّل كل متحكم دقيق وشريحة منطقية وشبكة رقمية. يأتي جهد الشبكة من المشغّلات عليها، وكل مشغّل جهد خلف مقاومة مصدر، ويأتي مستواها المنطقي من أقوى مشغّل (القسم 6). هذا ما يسمح بتشغيل بضع مئات من القطع ونواة معالج في الوقت الحقيقي داخل تبويب متصفح.
- الجزر التناظرية. المكثف أو المحث أو مكبر العمليات أو مولد الإشارة أو الدايود أو الترانزستور يسحب الشبكات التي يلمسها إلى جزيرة، وتُحلّ الجزيرة كمصفوفة واحدة بتحليل العقد المعدّل، مع نماذج أجهزة خلف أشباه الموصلات: دايودات Shockley وترانزستورات Gummel-Poon وMOSFET من المستوى 1، لكل منها سعة وصلة، وتُحل بطريقة نيوتن-رافسون (القسمان 6a و6b). في مساحة العمل يمكنك قراءة نقطة التشغيل بالتيار المستمر، ومسح قيمة، ورسم استجابة الترددات (القسم 7).
- مشغّل ملفات SPICE. «تشغيل ملف SPICE»، في قائمة المحرر، يشغّل netlist بصيغة SPICE على محرّكه الخاص:
.opو.tranو.acو.dcمع مسحات متداخلة، و.tfو.noiseو.meas، مع دوائر فرعية ومعاملات و.includeوBJTs بنموذج Gummel-Poon وMOSFET من المستويات 1 إلى 3 وJFETs ومصادر سلوكية و.temp. وقد جرى التحقق منه مقابل ngspice على 42 دائرة قياسية، كل واحدة ضمن تفاوت معلن (القسم 7e).
ما لا يفعله كل واحد منها، بوضوح:
- مساحة العمل الحيّة لا فيها تحليل ضجيج ولا حرارة ولا تشويه، ولا دالة تحويل؛ كل وصلة عليها عند 27 C. مكبّر العمليات فيها نموذج كلي أحادي القطب بحاصل ضرب الكسب في عرض النطاق ومعدل انحدار وهامش تضمين وانزياح وحد للتيار، لكن بلا قطب ثانٍ.
- مشغّل ملفات SPICE لا يشغّل نماذج BSIM MOSFET ولا خطوط نقل ذات فقد ولا أجهزة XSPICE ولا تحليلات
.fourو.sensو.pzو.disto، ويقول ذلك، سطرًا بسطر، عندما يستخدم ملفٌ أحدها. لا يوجد تحليل Monte Carlo ولا مكتبة لنماذج الشركات المصنّعة. - لا شيء له قدرة مقنّنة. لا تحترق أي قطعة أبدًا، ولا يهبط جهد أي مصدر أبدًا، ولا حدّ للتيار في أي طرف، لذا فالدائرة التي تعمل هنا قد تفشل مع ذلك على المنضدة (كيفية نمذجة القطع).
العقد
بقية هذه الصفحة تمثل الحدود بين محاكي Rust (الحِزم: sim-kernel وparts وanalog وspice وsim-wasm) وواجهة TypeScript (web/). كلا الجانبين يبنيان بالاعتماد على هذا الملف. لا تغيّره إلا بتعديل هذا الملف أولًا.
1. ملف Netlist بصيغة JSON (من الواجهة إلى المحاكي)
تمتلك الواجهة المخطط (المواضع، الأسلاك، لوحات التجارب). قبل بدء المحاكاة تُسطّح الواجهة المخطط إلى netlist: تُدمج شرائط لوحة التجارب والأسلاك باتحاد-بحث في شبكات. لوحات التجارب لا تصل إلى المحاكي أبدًا.
{
"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]يحددpartIndexالمستخدم فيprobes()وpoke(). - ترتيب
nets[j]يحددnetIndexالمستخدم فيnetLevels()وnetVoltages(). - مرجع الطرف هو
"<partId>:<pinName>". أسماء الأطراف تأتي من الفهرس. نوع قطعة مجهول، أو طرف مجهول، أو طرف في شبكتين، خطأ عندcreate. - الخصائص غير المعطاة تأخذ القيمة الافتراضية من الفهرس. الخصائص المجهولة خطأ.
- قد تحتوي شبكة على طرف واحد. تُصدرها الواجهة عندما يقف طرف وحده على شريط لوحة تجارب (عقدة حقيقية، تلزم للمفاتيح)؛ والمحاكي يقبلها.
2. سطح WASM (crates/sim-wasm وwasm-bindgen و--target web)
يستخدم Rust صيغة snake_case؛ صدّر باستخدام js_name ليرى TypeScript هذا الاسم بالضبط:
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;
الحلقة التي لا تستقر لا توقف التشغيل. عندما تحتاج لحظة واحدة من الزمن المحاكى إلى أكثر من 1000 دورة دلتا (قطع تتناقل شبكة ذهابًا وإيابًا في زمن صفر، عادة قطعتان لكل منهما ساقان في صف واحد من لوحة التجارب)، يقطع المحرّك الحلقة كما هي: تُحلّ الشبكات التي ما زالت تتغير حلًّا أخيرًا وتُثبّت هناك، ويستمر الزمن، ويستمر كل استدعاء في إرجاع 0. تُبلَّغ اللحظة مرة واحدة لكل حلقة لكل تشغيل عبر takeUnsettled()، حيث nets فهارس في nets[]؛ والمحرر يحوّلها إلى سطر في الشاشة التسلسلية ونتيجة في طبيب الدائرة (web/src/ui/unsettled-watch.ts). بعد 16 لحظة من هذا النوع في تشغيل واحد، تُقطع كل لحظة تالية عند 200 دورة دلتا، فلا يمكن لحلقة تنطلق عند كل حافة PWM سريع أن تجمّد الصفحة. رموز 1 = oscillation أعلاه محفوظة لحالات الفهرس السيئ ولمحرّك بُني قبل هذا.
البناء: wasm-pack build --target web --release --out-dir ../../web/src/sim/wasm --out-name sim crates/sim-wasm (الخيارات تأتي قبل مسار الـ crate). يُودَع الناتج في git حتى تُبنى الواجهة بلا Rust.
3. ملف الفهرس JSON (المحاكي -> الواجهة)
[
{
"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 يحدد ما يأخذه loadProgram لهذه القطعة ("elf32 riscv32imc" للوحة)، أو null. وhost يحدد ما يحمله قناة البايتات لدى المضيف ("utf-8 bytes on UART0")، أو null. القطعة ذات قناة host هي ما تتحدث إليه الشاشة التسلسلية.
dir هو in أو out أو inout. وkind هو number أو string أو bool. وoptions اختياري؛ وعند وجوده تعرض الواجهة قائمة اختيار. خاصية number تحمل أيضًا المدى الذي تقبله، min وmax، مع "minOpen": true عندما تُرفض قيمة min نفسها، و"integer": true للأعداد الصحيحة فقط (crates/parts/src/ranges.rs، بحد أقصى 1e15 في كل اتجاه)؛ وإنشاء القطعة يرفض قيمة خارج المدى، ولوحة الخصائص تمنعها عند الإدخال. يجب أن يصرّح شكل القطعة في الواجهة (web/src/parts/<type>.ts) عن موضع لكل طرف في الفهرس ولا شيء غيره؛ واختبار في web/ يتحقق من هذا مقابل web/src/sim/wasm/catalog.json الذي تكتبه خطوة بناء wasm أيضًا.
4. أنواع القطع المثبّتة لهيكل واجهة المستخدم للمرحلة 1
يسلّم جانب النواة هذه أولًا ليكون لدى الواجهة ما تقوده. تصل قطع أخرى من وكلاء القطع وتضيف مدخلات فقط.
| type | pins | props | probe | poke |
|---|---|---|---|---|
led |
A، C |
color نص (red) |
السطوع 0..1 | لا شيء |
resistor |
1، 2 |
value أوم (1000) |
التيار بالأمبير | لا شيء |
pushbutton |
1a، 1b، 2a، 2b (1a و1b متصلان، 2a و2b متصلان، والضغط يوصل الزوجين) |
bounce نص ("typical"، أحد none/typical/worst)، انظر 4a |
1 مضغوط، 0 غير مضغوط | 1 = ضغط، 0 = تحرير |
vcc |
VCC |
voltage (5) |
الجهد | لا شيء |
gnd |
GND |
لا شيء | 0 | لا شيء |
clock |
OUT |
hz (1) |
1 عندما تكون الإشارة مرتفعة، و0 عندما تكون منخفضة | لا شيء |
4a. طقم قطع المرحلة 1 (أضيفت بعد الهيكل، ولا يُضاف إليها إلا قطع)
الوحدات: resistor.value بالأوم، وcapacitor.value بالميكروفاراد. الشرائح تسرد أطرافها بترتيب أرقام أطراف الحزمة. المجس الذي يحمل أكثر من بت يعبّئ قناع بتات في f32.
| type | pins | props | probe | poke |
|---|---|---|---|---|
capacitor |
1، 2 |
value عدد (10) |
الجهد عبرها، V(1) - V(2) | لا شيء |
gate |
A، B، Y |
function نص ("and"، واحد من and/or/nand/nor/xor/xnor) |
1 عندما تكون Y مرتفعة، و0 عندما تكون منخفضة، و0.5 عندما تكون مجهولة | لا شيء |
not |
A، Y |
لا شيء | 1 عندما تكون Y مرتفعة، و0 عندما تكون منخفضة، و0.5 عندما تكون مجهولة | لا شيء |
bitin |
Q |
label نص ("A")؛ قيمة (0، 0 أو 1) |
1 عندما تكون Q مرتفعة، و0 عندما تكون منخفضة | 0 تجعل Q منخفضة، و1 تجعلها مرتفعة؛ تدفع عبر مقاومة سحب، لذا أي مخرج على الشبكة يتغلب |
bitout |
A |
label نص ("Y")؛ color نص ("green"، واحد من green/red/amber/blue) |
1 مرتفع، 0 منخفض، 0.5 مجهول أو غير مدفوع | لا شيء |
bytein |
D0..D7 |
label نص ("A")؛ value (0، من 0 إلى 255)؛ width (8، من 1 إلى 8) |
القيمة على D0..D(width-1)؛ الأطراف التي يتجاوز رقمها العرض تكون عالية المقاومة (high-Z) | 0..255 تضبط القيمة (مع قناع حسب العرض)؛ 2^32 تزيد بمقدار واحد |
byteout |
D0..D7 |
label نص ("S")؛ width (8، من 1 إلى 8) |
القيمة، والبتات غير المدفوعة تكون 0؛ -1 عندما تكون قيمة أحد البتات المدفوعة مجهولة | لا شيء |
bitconst |
Q |
value (0 أو 0 أو 1) |
القيمة التي يدفعها | لا شيء؛ يدفع دفعًا وشدًا (push-pull)، مثل مخرج بوابة منطقية |
stepclock |
CLK |
hz (2)؛ mode نص ("step"، واحد من step/run) |
المستوى (0 أو 1)، زائد 2 أثناء التشغيل الحر | 0 يوقفه (وضع الخطوة)، و1 يشغّله حرًا، و2 يعطي نبضة واحدة (صعود، ثم هبوط بعد نصف دورة) أثناء التوقف |
progrom |
A0..A7 مداخل؛ C0..C7، K0..K7 مخارج |
سلسلة program (لغة تجميع Kestrel، crates/parts/src/kestrel.rs) |
العنوان الجاري قراءته؛ -1 عندما يكون مجهولًا | لا شيء؛ الكلمة الموجودة عند العنوان تُغذّي C (البايت الأعلى) وK (البايت الأدنى) بعد 10 ns |
terminal |
D0..D7، WE، CLK |
mode نص ("text"، واحد من text/numbers) |
عدد البايتات المكتوبة منذ التشغيل | لا شيء؛ قناة المضيف: كل بايت يُكتب عند حافة CLK صاعدة مع WE مرتفع |
sevenseg |
E، D، COM1، C، DP، G، F، COM2، A، B |
common نص ("cathode"، واحد من cathode/anode)؛ color نص ("red"، واحد من red/green/blue/yellow/white) |
المقاطع المضيئة كقناع بتات 0..255: البت 0 للـ A، و1 للـ B، و2 للـ C، و3 للـ D، و4 للـ E، و5 للـ F، و6 للـ G، و7 للـ DP | لا شيء |
slideswitch |
1، 2، 3 |
لا شيء | 0 = المشترك على الطرف 1، و1 = المشترك على الطرف 3 | 0 = وصّل 2 بـ 1، و1 = وصّل 2 بـ 3 |
buzzer |
1، 2 |
لا شيء | 1 عند إصدار الصوت، و0 عند الصمت | لا شيء |
74hc00 |
1A، 1B، 1Y، 2A، 2B، 2Y، GND، 3Y، 3A، 3B، 4Y، 4A، 4B، VCC |
لا شيء | المخارج كقناع بتات، البت 0 = 1Y حتى البت 3 = 4Y؛ القيمة 0 تعني بلا تغذية | لا شيء |
74hc08 |
نفس توزيع الأطراف مثل 74hc00 |
لا شيء | نفس الشيء | لا شيء |
74hc32 |
نفس توزيع الأطراف مثل 74hc00 |
لا شيء | نفس الشيء | لا شيء |
74hc86 |
نفس توزيع الأطراف مثل 74hc00 |
لا شيء | نفس الشيء | لا شيء |
74hc04 |
1A، 1Y، 2A، 2Y، 3A، 3Y، GND، 4Y، 4A، 5Y، 5A، 6Y، 6A، VCC |
لا شيء | المخارج كقناع بتات، البت 0 = 1Y حتى البت 5 = 6Y؛ 0 بدون تغذية | لا شيء |
74hc74 |
1RD، 1D، 1CP، 1SD، 1Q، 1QN، GND، 2QN، 2Q، 2SD، 2CP، 2D، 2RD، VCC |
لا شيء | مخارج Q كقناع بتات، البت 0 = 1Q، والبت 1 = 2Q؛ 0 بدون تغذية أو X | لا شيء |
74hc595 |
Q1, Q2, Q3, Q4, Q5, Q6, Q7, GND, Q7S, MR, SHCP, STCP, OE, DS, Q0, VCC |
لا شيء | البايت على Q0..Q7، البت 0 = Q0؛ القيمة 0 عندما يكون OE مرتفعًا أو دون تغذية كهربائية | لا شيء |
ne555 |
GND، TRIG، OUT، RESET، CTRL، THR، DIS، VCC |
لا شيء | 1 عندما يكون OUT مرتفعًا، و0 عندما يكون منخفضًا أو بدون تغذية | لا شيء |
tlc555 |
GND، TRIG، OUT، RESET، CTRL، THR، DIS، VCC |
لا شيء | 1 عندما يكون OUT مرتفعًا، و0 عندما يكون منخفضًا أو بدون تغذية | لا شيء |
ne556 |
1DIS، 1THR، 1CTRL، 1RESET، 1OUT، 1TRIG، GND، 2TRIG، 2OUT، 2RESET، 2CTRL، 2THR، 2DIS، VCC |
لا شيء | البت 0 = 1OUT، والبت 1 = 2OUT مرتفعان | لا شيء |
inductor |
1، 2 |
القيمة بالمليهنري (100) |
التيار بالأمبير، موجب من الطرف 1 إلى الطرف 2 | لا شيء |
opamp |
IN+, IN-, OUT, V+, GND |
الكسب (100000) |
جهد الخرج فوق طرف GND | لا شيء |
lm358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT، البت 1 = 2OUT فوق منتصف جهد التغذية | لا شيء |
lm324 |
1OUT, 1IN-, 1IN+, VCC, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, GND, 4IN+, 4IN-, 4OUT |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT .. البت 3 = 4OUT فوق منتصف جهد التغذية | لا شيء |
tl072 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT، البت 1 = 2OUT فوق منتصف جهد التغذية | لا شيء |
lm741 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, NC |
الإزاحة بالملي فولت (0) |
1 طالما يكون OUT أعلى من منتصف التغذية | لا شيء |
ne5532 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT، البت 1 = 2OUT فوق منتصف جهد التغذية | لا شيء |
lm833 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT، البت 1 = 2OUT فوق منتصف جهد التغذية | لا شيء |
opa2134 |
1OUT, 1IN-, 1IN+, VCC-, 2IN+, 2IN-, 2OUT, VCC+ |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT، البت 1 = 2OUT فوق منتصف جهد التغذية | لا شيء |
mcp6002 |
VOUTA, VINA-, VINA+, VSS, VINB+, VINB-, VOUTB, VDD |
الإزاحة بالملي فولت (0) |
البت 0 = VOUTA، البت 1 = VOUTB فوق منتصف التغذية | لا شيء |
mcp6004 |
VOUTA, VINA-, VINA+, VDD, VINB+, VINB-, VOUTB, VOUTC, VINC-, VINC+, VSS, VIND+, VIND-, VOUTD |
الإزاحة بالملي فولت (0) |
البت 0 = VOUTA .. البت 3 = VOUTD فوق منتصف التغذية | لا شيء |
lmv358 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT، البت 1 = 2OUT فوق منتصف جهد التغذية | لا شيء |
tl081 |
NULL1, IN-, IN+, VCC-, NULL2, OUT, VCC+, NC |
الإزاحة بالملي فولت (0) |
1 طالما يكون OUT أعلى من منتصف التغذية | لا شيء |
tl084 |
1OUT, 1IN-, 1IN+, VCC+, 2IN+, 2IN-, 2OUT, 3OUT, 3IN-, 3IN+, VCC-, 4IN+, 4IN-, 4OUT |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT .. البت 3 = 4OUT فوق منتصف جهد التغذية | لا شيء |
op07 |
NULL1, IN-, IN+, V-, NC, OUT, V+, NULL2 |
الإزاحة بالملي فولت (0) |
1 طالما يكون OUT أعلى من منتصف التغذية | لا شيء |
ca3140 |
NULL1, IN-, IN+, V-, NULL2, OUT, V+, STROBE |
الإزاحة بالملي فولت (0) |
1 طالما يكون OUT أعلى من منتصف التغذية | لا شيء |
lm393 |
1OUT, 1IN-, 1IN+, GND, 2IN+, 2IN-, 2OUT, VCC |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT، البت 1 = 2OUT مُفلت (IN+ فوق IN-) | لا شيء |
lm339 |
1OUT, 2OUT, VCC, 2IN-, 2IN+, 1IN-, 1IN+, 3IN-, 3IN+, 4IN-, 4IN+, GND, 4OUT, 3OUT |
الإزاحة بالملي فولت (0) |
البت 0 = 1OUT .. البت 3 = 4OUT غير مضغوط | لا شيء |
lm311 |
EMIT, IN+, IN-, VCC-, BAL, STRB, COL, VCC+ |
الإزاحة بالملي فولت (0) |
1 طالما أن COL غير مفعّل (أو أُطلق) | لا شيء |
uln2003a |
1B, 2B, 3B, 4B, 5B, 6B, 7B, E, COM, 7C, 6C, 5C, 4C, 3C, 2C, 1C |
لا شيء | البِتّات 0..6 = المداخل 1B..7B عند جهد أعلى من E بمقدار 1.4 V على الأقل | لا شيء |
uln2803a |
1B، 2B، 3B، 4B، 5B، 6B، 7B، 8B، GND، COM، 8C، 7C، 6C، 5C، 4C، 3C، 2C، 1C |
لا شيء | البِتّات 0..7 = المداخل 1B..8B عند جهد أعلى من GND بمقدار 1.4 V على الأقل | لا شيء |
uln2003board |
IN1, IN2, IN3, IN4, VCC, GND, OUT1, OUT2, OUT3, OUT4 |
لا شيء | البِتّات 0..3 = LED A..D: عندما يكون OUT1..OUT4 أدنى من VCC بمقدار 1.7 V أو أكثر | لا شيء |
generator |
OUT, GND |
نص wave ("sine"، واحد من sine/square/triangle)؛ frequency Hz (1000)؛ amplitude volts ذروة (2.5)؛ offset volts (2.5)؛ duty بالمئة (50، للموجة المربعة فقط) |
جهد الخرج فوق طرف GND | لا شيء |
funcgen |
OUT, GND |
نص wave ("sine"، واحد من sine/square/triangle/sawtooth)؛ frequency Hz (1000)؛ amplitude فولت ذروة (2.5)؛ offset فولت (2.5)؛ duty بالمئة (50، للموجة المربعة فقط) |
جهد المخرج فوق طرف GND، عند الطرفيات | لا شيء |
scope |
CH1، CH2، GND |
window بالثواني (0.02، من 0.0001 إلى 10)؛ volts للمقياس الكامل (5) |
جهد القناة 1 أعلى من مشبك الأرضية | (1 << 32) | النافذة بالميكروثانية، أو (2 << 32) | المقياس الكامل بالمللي فولت |
multimeter |
V، A، COM |
سلسلة mode ("dcv"، إحدى dcv/acv/dca/aca/ohms/continuity) |
القراءة: فولت أو أمبير أو أوم حسب الوضع، NaN عند تجاوز المدى أو عند فتح الدائرة | لا شيء |
lm35 |
VS، VOUT، GND |
رقم temperature (22.5) |
درجة الحرارة بالدرجات المئوية | أعشار الدرجة مضافة إلى 1000 |
aht20 |
VCC، GND، SCL، SDA (I2C على العنوان 0x38) |
رقم درجة الحرارة (22)؛ رقم الرطوبة (45) |
درجة الحرارة بالدرجات المئوية | (1 << 32) | (tenths + 1000) درجة الحرارة، (2 << 32) | tenths الرطوبة |
bh1750 |
VCC، GND، SCL، SDA، ADDR (I2C على العنوان 0x23، و0x5C عندما يكون ADDR مرتفعًا) |
لا شيء | الإضاءة باللكس | الإضاءة باللكس، من 0 إلى 100000 |
a3144 |
VCC، GND، OUT (مُجمِّع مفتوح) |
operate رقم (210 gauss)؛ hysteresis رقم (55) |
رمز المغناطيس، أضف 100000 أثناء تشغيل OUT | أعشار mm، من 0 إلى 400، زائد 10000 للقطب الشمالي |
ss49e |
VCC، GND، OUT |
لا شيء | شدّة المجال عند الحساس بالغاوس، الجنوبي موجب | أعشار الملم، من 0 إلى 400 (400 تعني عدم وجود مغناطيس)، زائد 10000 للقطب الشمالي |
photointerrupter |
SIG، VCC، GND (بالإضافة إلى SHAFT عند تفعيل wheel) |
slots رقم (20)؛ wheel نص ("": معرّف dcmotor أو encmotor الذي تدور معه العجلة، فارغ للمنزلق) |
رمز العجلة (RPM، زائد 10000 عند إدخال البطاقة)، زائد 100000 أثناء ارتفاع SIG، زائد 1000000 عند تركيب العجلة على محرك | RPM من 0 إلى 600 (يُهمَل على المحرك)، زائد 10000 عند إدخال البطاقة |
linearray |
GND، VCC، S1 إلى S5 |
العتبة رقم (0.5) |
رمز الخط، زائد 1000 مضروبة في القنوات فوق الأسود كبتات (البت 0 هو S1) | 100 + المليمترات من الحساس الأوسط (من 40 إلى 160)؛ 1 تعني شريطًا أسود بالعرض؛ 0 تعني عدم وجود خط |
fc51 |
OUT، GND، VCC |
العتبة رقم (0.5) |
رمز العائق (بالسنتيمتر، 80 تعني لا عائق، زائد 10000 للأسود)، زائد 100000 أثناء إضاءة المصباح | cm من 1 إلى 80، بالإضافة إلى 10000 لجسم أسود |
thermalprinter |
VH، GND، RX، TX، DTR |
baud رقم (19200)؛ paper قيمة منطقية (true) |
عدد الأسطر المطبوعة | الورق: 1 يعني مُحمَّلًا، 0 يعني نفد |
fingerprint |
VCC، GND، TX، RX |
baud رقم (57600)؛ enrolled رقم (2)؛ capacity رقم (162)؛ password رقم (0) |
الإصبع على الزجاج، بإضافة 100 بعد أن يعثر عليه البحث، و200 بعد ألّا يعثر عليه | الإصبع، من 1 إلى 9، أو 0 لرفعه |
ds1302 |
VCC، GND، CLK، DAT، RST |
start سلسلة نصية ("2026-01-01 12:00:00")؛ halted قيمة منطقية (false) |
الثواني منذ منتصف الليل، زائد 100000 أثناء التوقف | (1 << 32) أو الثواني منذ منتصف الليل، أو (2 << 32) أو الأيام منذ 2000-01-01 |
amg8833 |
VIN، GND، SCL، SDA، INT (I2C على العنوان 0x69) |
address رقم (105)؛ background رقم (22)؛ spot رقم (34)؛ pixel رقم (27) |
أسخن بكسل بوحدة C | (1 << 32) الخلفية، (2 << 32) النقطة، أعشار + 1000؛ (3 << 32) بكسل النقطة، 64 يعني لا شيء |
mlx90614 |
VIN، GND، SCL، SDA (SMBus على العنوان 0x5A) |
object رقم (36.6)؛ ambient رقم (22) |
درجة حرارة الجسم بالدرجة المئوية | (1 << 32) الجسم أو (2 << 32) المحيط، زائد أعشار الدرجة + 1000 |
mpr121 |
VIN، GND، SCL، SDA، IRQ، ADDR (I2C على العنوان 0x5A) |
address رقم (90) |
حالة اللمس: القطب 0 في البت 0 | الأقطاب التي يقع عليها الإصبع، كقناع بتات |
gp2y0a21 |
VO، GND، VCC |
رقم المسافة (30) |
المسافة بالسنتيمترات | المسافة بالسنتيمترات، من 1 إلى 150 |
mg996r |
GND، VCC، PWM |
رقم min_pulse (544)؛ رقم max_pulse (2400)؛ رقم range (180) |
زاوية القرن بالدرجات، من 0 إلى قيمة المدى | لا شيء |
yfs201 |
VCC، GND، SIG |
رقم flow (0) |
معدل التدفق باللتر في الدقيقة | التدفق بأعشار اللتر في الدقيقة، من 0 إلى 300 |
adxl335 |
VCC، X، Y، Z، GND |
رقم tilt_x (0)؛ رقم tilt_y (0) |
الميل على محور X بالدرجات | (1 << 32) أو (2 << 32)، مضافًا إليه ميل X أو Y + 90 |
pulsesensor |
S، VCC، GND |
رقم bpm (72)؛ رقم swing (0.8) |
معدل ضربات القلب في الدقيقة (0 بدون إصبع)، مضافًا إليه 1000 أثناء مرور القمة الرئيسية | معدل ضربات القلب في الدقيقة، من 30 إلى 220، أو 0 عند عدم وجود إصبع |
coinacceptor |
DC12V، COIN، GND، COUNTER |
pulse قيمة رقمية (50)؛ nc قيمة منطقية (false) |
عدد النبضات المُرسلة منذ التشغيل، مضافًا إليه 100000 أثناء تنشيط COIN | عملة بقيمة هذا العدد من النبضات، من 1 إلى 50 |
waterpump |
V+، V- |
رقم voltage (6)؛ رقم flow (120)؛ رقم resistance (4)؛ رقم inertia (50)؛ رقم back_emf (0.85) |
التدفق باللتر في الساعة | لا شيء |
fanmodule |
INA، INB، VCC، GND |
رقم voltage (5)؛ رقم inertia (250) |
سرعة المروحة كنسبة مئوية من السرعة الكاملة، وتكون سالبة عند الاتجاه المعاكس | لا شيء |
laser |
S، VCC، GND |
رقم المقاومة (100) |
السطوع المُدرك للشعاع، من 0 إلى 1 | لا شيء |
trafficlight |
R، Y، G، GND |
رقم resistor (220) |
مصابيح LED المضاءة كقناع بتّي: البت 0 للأحمر، والبت 1 للأصفر، والبت 2 للأخضر | لا شيء |
sw420 |
VCC، GND، DO |
العتبة رقم (0.5) |
0 ساكن، 1 اهتزاز، 2 طرق، مضافًا إليه 100000 أثناء إضاءة المصباح (DO منخفض) | 0 ساكن، 1 اهتزاز حتى النقرة التالية، 2 طرقة واحدة |
mq3 إلى mq137 (mq3, mq4, mq5, mq6, mq7, mq8, mq9, mq131, mq135, mq137) |
VCC، GND، DO، AO |
نص gas (لكل حساس، من مخططه)؛ r0 بالأوم؛ rl بالأوم؛ رقم threshold؛ warmup بالثواني (20) |
الغاز بوحدة الحساس (ppm؛ أجزاء من مئة من المليجرام/لتر على MQ-3؛ ppb على MQ-131)، مضافًا إليه 100000 أثناء إضاءة مصباح DO، ومضافًا إليه 200000 أثناء الإحماء | الغاز بهذه الوحدة، من 0 إلى قمة المخطط |
ky037 |
AO، GND، VCC، DO |
رقم threshold (0.505)؛ sensitivity dBV/Pa (-42) |
مثل ky038 |
مثل ky038 |
ky004، ky017، ky021، ky031 |
S، VCC، GND |
نص resistor ("pull-up" أو "pull-down")؛ settle ms (ky004 هي 3، وky017 هي 0، وky021 هي 0.5)؛ لـ ky021 close mm (15)، وrelease (0.8) |
ky004: 1 مضغوط؛ ky017: 1 مائل؛ ky021: المسافة المغناطيسية بالمليمتر؛ ky031: 0 ساكن، 1 اهتزاز، 2 طرق | الرموز نفسها |
sw18010p |
1، 2 |
لا شيء | 0 ساكن، 1 اهتزاز، 2 طرق | 0 ساكن، 1 اهتزاز حتى النقرة التالية، 2 طرقة واحدة |
ky024، ky025، ky028 |
AO، GND، VCC، DO |
رقم threshold (0.6، 0.5، 0.45)؛ لـ ky025 close mm (15)، وrelease (0.8)؛ لـ ky028 beta K (3950) |
رمز النقرة، مضافًا إليه 100000 أثناء إضاءة مصباح DO (DO مرتفع) | ky024: أعشار المليمتر، مضافًا إليه 10000 للشمال؛ ky025: المسافة المغناطيسية بالمليمتر، من 0 إلى 60؛ ky028: أعشار الدرجة مضافًا إليها 1000 |
ky035 |
VCC، GND، S |
لا شيء | كما في ss49e |
كما في ss49e |
temt6000 |
SIG، GND، VCC |
sensitivity uA لكل lux (0.5) |
الإضاءة باللكس | lux، من 0 إلى 2000 |
rotation |
GND، S، VCC |
value أوم (10000)؛ taper نص |
كما في potentiometer |
كما في potentiometer |
steam |
S، VCC، GND |
full كسر (0.66) |
الجزء المبلّل من المشط، بالنسبة المئوية | بالمئة، من 0 إلى 100 |
e18d80nk |
VCC، GND، OUT |
range سم (40، من 3 إلى 80)؛ pullup علامة (false) |
مسافة الهدف بالسنتيمتر (100 تعني لا شيء)، بالإضافة إلى 100000 أثناء الكشف | سم، من 1 إلى 100 |
ttp223 |
SIG، VCC، GND |
toggle قيمة منطقية (false)؛ activelow قيمة منطقية (false) |
البِت 0 إصبع على اللوحة، البِت 1 إشارة SIG مرتفعة | 1 إصبع موجود، 0 غير موجود |
battery |
V+، V- |
kind نص ("9v"، أحد القيم: 9v/aa2/aa3/aa4/18650/18650x2)؛ charge رقم (100) |
الجهد عبر الأطراف بالفولت | لا شيء |
solar |
+، - |
لا شيء | الجهد عبر اللوحة بالفولت | واط لكل متر مربع، من 0 إلى 1200 (1000 تعني شمسًا ساطعة تمامًا) |
tp4056 |
IN+، IN-، BAT+، BAT- |
لا شيء | تيار الشحن بالمللي أمبير، بالإضافة إلى 10000 أثناء إضاءة مصباح الاستعداد | لا شيء |
regulator |
IN، GND، OUT |
model نص ("7805"، أحد القيم: 7805/AMS1117-3.3/MCP1700-3.3) |
OUT فوق GND، بالفولت | لا شيء |
tb6612 |
PWMA، AIN2، AIN1، STBY، BIN1، BIN2، PWMB، GND1، VM، VCC، GND2، AO1، AO2، BO2، BO1، GND3 |
لا شيء | أنماط القنوات، A في البِتات 0-1 و B في 2-3: 0 إيقاف، 1 دوران مع عقارب الساعة، 2 دوران عكسها، 3 فرملة | لا شيء |
l9110 |
BIA، BIB، GND، VCC، AIA، AIB، OA1، OA2، OB1، OB2 |
لا شيء | تشغيل المحرك: A في البِتات 0-1 و B في 2-3: 0 إيقاف، 1 للأمام، 2 للخلف، 3 كبح | لا شيء |
encmotor |
M1، M2، VCC، GND، A، B |
voltage (6)، rpm (200)، resistance (6)، inertia (120)، back_emf (0.85) للمحرك العادي، بالإضافة إلى رقم ppr (11) ورقم ratio (30) |
سرعة العجلة بالدورة في الدقيقة (rpm)، بإشارة | لا شيء |
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) |
الميل بالدرجات، الأمام موجب | 1 يرفعه واقفًا، 3 يتركه، (2 << 32) | (push in 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 degrees)، current (1.7 A)، max_steps (1000) |
عمق المخلب أسفل الحافة العلوية بـ mm؛ الحالة كاملة على قناة القياس | 1 يعيد الجوائز إلى أماكنها |
clawcabinetdc |
X+، X-، Y+، Y-، VCC، GND، W+، W-، CLAW، XHOME، YHOME، BEAM |
كما في clawcabinet، مع استبدال voltage (6) و rpm (200) لمحركات التروس بدل current و max_steps |
باسم clawcabinet |
1 يعيد الجوائز إلى أماكنها |
vendingcabinet |
M1، M2، M3، M4، VCC، GND، DROP |
stock (3 لكل حلزون)، rpm (110) |
الوجبات الخفيفة في الحاوية؛ الحالة كاملة على قناة القياس | 1 يعيد تعبئة كل حلزون ويفرغ الحاوية |
pinballcabinet |
FL، FR، VCC، GND، KICK1، KICK2، TA، TB، TC، B1، B2، DRAIN، LAUNCH |
flip_speed (1200 درجة في الثانية) |
ارتفاع الكرة على الطاولة بالمليمتر، -1 أثناء رجوعها؛ الحالة كاملة على قناة القياس | 1 يضع الكرة على المكبس؛ 0x100 + n يُبقي المفتاح n مضغوطًا (TA, TB, TC, B1, B2، شعاع المخرج، المكبس) و0x200 + n يتركه |
barriercabinet |
VCC، GND، TRIG، ECHO، R، Y، G، ARM، V+ |
angle (0 درجة) |
زاوية الذراع؛ الحالة الكاملة على قناة القياس | 1 يرسل سيارة إلى أعلى المسار |
sortercabinet |
VCC، GND، SCL، SDA، SERVO |
candies (12)، period (2000 ms) |
الحلوى في الصناديق؛ الحالة الكاملة على قناة القياس | 1 يعيد ملء القمع ويفرّغ الأدراج؛ 0x1000000 + 0xRRGGBB يجعل الحلوى التالية بهذا اللون |
soapcabinet |
VCC، GND، OUT، M+، M- |
threshold (0.5)، bottle (30 ml)، ml_per_turn (0.5)، voltage (6)، rpm (200) |
كمية الصابون التي تم ضخها منذ تعبئة الزجاجة، بالمليلتر؛ الحالة الكاملة على قناة القياس | يد على بُعد cm تحت الصنبور، من 1 إلى 80 (80 تعني لا أحد)، زائد 10000 لقفاز أسود؛ و1000000 يملأ الزجاجة |
تربط الـnetlist (web/src/sim/wheel-mount.ts) عجلة قاطع ضوئي (wheel) مثبتة على محرك بذلك المحرك: طرفا SHAFT في القطعتين على شبكة واحدة، مع shaft: true على dcmotor أو encmotor، وهي علامة داخلية يستثنيها الفهرس (PropInfo::internal) تمنح المحرك ذلك الطرف. يحمل الطرف سرعة عمود الإخراج، بقيمة موجبة دائمًا، بواقع 1 mV لكل rpm.
تتغذى الرقائق عندما يبلغ الجهد بين طرفَي VCC وGND لديها 2 V على الأقل (4.5 V للـNE555)؛ وبدون تغذية يصبح كل مخرج في حالة مقاومة عالية (high-Z).
الوحدات: resistor.value أوم، capacitor.value ميكروفاراد، inductor.value ملليهنري.
قناة العينات في راسم الإشارة
يحمل راسم الإشارة عيناته على المسار نفسه الذي تسلكه بكسلات الشاشة: readHost، تُجمَّع مرة كل إطار، مع قيمة host في الفهرس تساوي null لأن ذلك الحقل يعني «قناة نصية تتواصل معها الشاشة التسلسلية» وهذه عينات.
يعيد readHost(scopeIndex) كل ما جُمِّع منذ آخر استدعاء، كرسالة واحدة بالترتيب الأصغر للبايت (little-endian)، أو لا شيء إذا لم تُؤخذ أي عينة:
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
المجس الموصول بلا شيء يقرأ NaN. تحتفظ القطعة بـ1024 عينة لمضيف توقف عن جمع العينات ثم تُسقط الأقدم، مع ضبط علامة الإسقاط.
قاعدة الزمن والمدى الكامل خاصيتان، وهما أيضًا قابلتان للنقر (poke)، لأنهما الشيئان اللذان يغيّرهما المستخدم أثناء مشاهدة الأثر، وإعادة بناء الـnetlist لتغيير أحدهما كانت ستعيد تشغيل المحاكاة. النقر على النافذة يسري فورًا: تمسح القطعة ما لم ترسله بعد، وتضبط علامة إعادة التشغيل في رسالتها التالية فتترك الواجهة الشاشة التي كانت ترسمها، وتواصل أخذ العينات بالمعدل الجديد دون أن تلاحظ الدائرة شيئًا.
أجهزة المنضدة
funcgen وscope وmultimeter هي الأجهزة الثلاثة التي تضعها على مساحة العمل وتوصّلها، وهي قطع عادية: لا مسار مميّز إلى محرك المحاكاة، ولا شيء لا يصفه الفهرس.
funcgenهوgeneratorمع موجة سنّ منشارية ومعاوقة خرج حقيقية: 50 أوم، تُسجَّل كزوج نورتون (مصدر تيار بقيمةv(t)/50مع 50 أوم على التوازي) لأنه لا توجد عقد داخلية في القطعة لتوصيل مقاومة على التوالي منها. الحمل يتقاسم الجهد معها، وهو أول ما يعلّمه مولّد المنضدة.generatorيبقى مثاليًا ويظل القطعة المناسبة لقيادة عقدة ونسيان أمرها.scopeهو مجسّان بمقاومة 1 Mohm ومشبس أرضي؛ ينضم إلى جزيرة ولا يبدأ واحدة أبدًا.multimeterهو 10 Mohm بينVوCOMعلى مدى الفولتات، مقاومة تحويل بقيمة 1 أوم بينAوCOMعلى مدى التيار (كلاهما يمرر ثيفنين على المسار الرقمي السريع ويُسجَّل عند وصول جزيرة إليه)، وعلى مدى الأوم والاستمرارية، تيار اختبار 30 uA مع 100 kohm على التوازي، وهو ما يبدأ جزيرة فعلًا. يجمع القراءة على نافذة 250 ms بمعدل 4 kHz وينشر قراءة واحدة أربع مرات في الثانية: المتوسط على مدى DC، والقيمة الحقيقية RMS للجزء المتردد على مدى AC، وعلى مدى الأوم، المقاومة التي يدل عليها تيار الاختبار هذا،NaNفوق 1 Mohm. وفوق كيلوهرتز تقريبًا تصبح قراءة AC ناقصة العينات وتَقرأ أقل من الحقيقة.
ارتداد التلامس في الزر
المفتاح اللمسي الحقيقي يغلق ثم يرتد ثم يستقر، لذا يرتجف pushbutton عند كل ضغطة وعند كل إفلات. خاصية bounce تحدد نمط الاهتزاز:
bounce |
انتقالات لكل ضغطة أو إفلات | يستقر خلال |
|---|---|---|
none |
1 | في الحال |
typical |
من 3 إلى 8 | من 1 إلى 5 ms |
worst |
حتى 20 | من 10 إلى 20 ms |
الافتراضي هو typical: اختر none عندما لا يكون الزر هو موضوع الدائرة، وworst لتوضيح سبب حاجة الكود إلى إزالة الارتداد. كل ما هو موصول بالزر يرى الارتجاف كحواف عادية (مدخل 74HC، أو إطلاق NE555، أو GPIO في لوحة)، لأن الزر يقود شبكاته كما كان يفعل دائمًا؛ لا يتغير أي شيء آخر في العقد.
يبدأ كل تتابع بحافة فورية (التلامس يحدث فعلًا عند الضغط) ثم تُنفَّذ بقية الحواف كتنبيهات على عجلة التوقيت، آخرها يقع تمامًا على زمن الاستقرار. العدد فردي، لذا ينتهي التتابع دائمًا على الحالة المطلوبة. النقر الواصل في منتصف التتابع (إفلات أثناء الارتجاف) يلغي الباقي ويبدأ تتابعًا جديدًا. تأتي أطوال الفواصل من مجرى عشوائي خاص بكل قطعة، يُبذَّر بفهرس القطعة في الـnetlist، فزرّان في دائرة واحدة يرتجفان بشكل مختلف، والضغطات المتتالية تختلف، والـnetlist نفسه المنقور بالطريقة نفسها ينتج الحواف نفسها بدقة البيكوثانية: كل تشغيل قابل للتكرار.
قد يصرّح شكل القطعة بـinteraction: 'hold' (الضغط بالمؤشر يرسل poke بقيمة 1، والرفع يرسل 0) أو 'toggle' (النقر يرسل 0 إذا كانت قيمة المجس 0.5 على الأقل، وإلا 1). مساحة العمل لا تذكر نوع القطعة أبدًا.
كل ما تحتاجه الواجهة لرسم قطعة موجود في web/. وكل ما تحتاجه القطعة لتعمل موجود في crates/parts. يلتقيان فقط عند type وأسماء الأطراف والخصائص.
5. حلقة التشغيل (جهة الواجهة)
يقدّم Sim.runForNs(ns) الزمن المحاكى بمقدار ns ثم يعيد، مع قيام nowNs() بالإبلاغ عن المجموع الجديد. تستدعيه الواجهة من requestAnimationFrame، مستهدفة الزمن المحاكى = الزمن الحقيقي، مع ميزانية زمنية لكل إطار (نحو 12 ms)؛ وإذا تأخر المحاكي، تعرض الواجهة نسبة السرعة المحققة بدلًا من التجميد. يعمل المحاكي في Web Worker (web/src/sim/client.ts)، فتبقى الصفحة مستجيبة أثناء عمله.
probes() و netLevels() و netEdges() تُقرأ مرة واحدة في كل إطار، معًا، في اللقطة التي ترسم منها الواجهة. netEdges() موجودة لأن قراءة المستوى مرة واحدة في الإطار تخبرك فقط أين انتهت كل شبكة: تلامس مرتد يصنع عشرين حافة في بضعة أجزاء من الثانية، أي داخل إطار واحد مدته 16 ms بسهولة، ودرس يطلبها يجب أن يكون قادرًا على عدّها. الحافة هي تغيّر في المستوى النظيف (من منخفض إلى مجهول إلى مرتفع تُحسب واحدة؛ من منخفض إلى عائم إلى منخفض لا تُحسب)، والانقلاب الذي يُتراجع عنه في اللحظة نفسها لا يُحسب أبدًا. قراءة العدّادات تعيد تصفيرها، لذا فحلقة الإطار هي المستدعي الوحيد. netVoltages() تُقرأ في المرور نفسه لكن فقط عندما يعرض شيء ما في الصفحة قيم الفولت: قراءة «إظهار المستويات» (web/src/ui/levels.ts)، وهي معطلة افتراضيًا. اللقطة التي لم تطلبها تحمل مصفوفة فارغة، لذا فجهد الشبكة لكل شبكة في كل إطار لا يكلّف شيئًا حتى يُقرأ.
6. النموذج الكهربائي
كل مشغّل على شبكة هو جهد بممانعة مصدر (Drive { voltage, impedance, level }). جهد الشبكة هو المتوسط المرجّح بالممانعات لمشغّلاتها (قاعدة Millman). المخرج الرقمي القوي ممانعته بضع عشرات من الأوم، ومقاومة السحب لأعلى تساوي قيمة مقاومتها، والحالة العالية الممانعة (high-Z) لانهائية. المستوى الرقمي لشبكة يأتي من المشغّل الأقل ممانعة؛ وإذا اختلف مشغّلان بممانعتين متساويتين فالمستوى مجهول، وبدون مشغّلات فهو عائم. القطع ثنائية الأطراف تقرأ مكافئ Thevenin كما يُرى من طرف واحد، مستبعدة مساهمتها الذاتية، وتشغّل الطرف الآخر وفقًا لذلك.
هذا هو المسار السريع، وهو ما تفعله كل شبكة لا يوجد عليها شيء تناظري.
6a. الجزر التناظرية
القطعة التي سلوكها معادلة تفاضلية على عدة عقد في وقت واحد (مكثف، ملف حث، مكبر عمليات، مولد إشارة) تعلن عن نفسها كقطعة تناظرية عبر القدرة Component::analog، فيجمع النواة كل شبكة تلمسها في جزيرة تُحل كمصفوفة واحدة بواسطة crates/analog: تحليل عُقَدي معدّل، وترتيب LU مع تدوير جزئي، ونقطة تشغيل تيار مستمر عند التشغيل مع كل مكثف مفروغ وكل ملف حث بتيار صفري، وحالة عابرة بنماذج رفيقة شبه منحرفة وخطوة تُختار بحسب خطأ الاقتطاع المحلي.
النصفان يلتقيان في ثلاثة مواضع ولا مكان آخر.
- ها نحن ندخل. كل مُشغِّل على شبكة معزولة لا ينتمي إلى تلك الشبكة يُدمج بقاعدة Millman في جهد واحد خلف مقاومة واحدة ويُسجَّل كمصدر Thevenin على تلك العقدة. الطرف الرقمي هو مصدر Thevenin؛ هذا هو كامل الواجهة.
- عند الخروج. الجزيرة تملك خانة مشغّل واحدة على كل من شبكاتها، مثل أي طرف آخر، وتكتب مكافئ Thevenin الخاص بالجزيرة عند تلك العقدة (الجزيرة مع حذف مشغّل الحدود الخاص بتلك الشبكة)، بحيث إنّ حلّ الاثنين بقاعدة Millman العادية يعيد إنتاج جهد العقدة الناتج عن الحل بدقة تامة.
- الوقت. الجزيرة تحجز خطوتها التالية بنفسها على عجلة التوقيت. الجزيرة المستقرة بلا مصدر متحرك لا تحجز شيئًا أبدًا، لذا فإن دائرة تناظرية خاملة تكلّف ما تكلّفه دائرة رقمية خاملة.
القطعة ذات عتبة مدخل تناظرية (مقارن، نقطتا انقلاب مؤقت 555) تستدعي Ctx::watch(pin, volts, hysteresis)؛ عندئذ تنقّح الجزيرة خطوتها لتصل إلى نقطة العبور بدل أن تتجاوزها، فيكون زمن الانقلاب صحيحًا بدقة ميكروثانية بدلًا من طول خطوة تكامل. خارج الجزيرة لا تكلّف الاستدعاء شيئًا ولا تغيّر شيئًا. المدخل الرقمي لمتحكم دقيق يفعل الشيء نفسه عبر Ctx::read_input(pin, threshold)، الذي يراقب الطرف عند مستوى التبديل الخاص بالشريحة نفسها ثم يقرأه: كل لوحة تقرأ وسائد مدخلاتها بهذه الطريقة، لذا فالحافة التناظرية البطيئة تصل إلى قطعة 3.3 V وقطعة 5 V عند الجهد الذي تتبدّل عنده كل منهما فعلًا، لا عند LOGIC_THRESHOLD الواحد الخاص بالنواة. طرف المدخل لا يقدّم أي حمل على الجزيرة سوى مقاومة السحب لأعلى أو لأسفل التي يفعّلها البرنامج الثابت؛ تسرّب ما دون الميكرو أمبير الذي يميز مدخل CMOS حقيقي غير مُنمذج.
تتخذ الجزر خطوة كل 2 ms على الأكثر وكل 100 ns على الأقل، وتُبقي الخطوة عند جزء من أربعة وستين من أسرع ثابت زمني نشط، فالأثر الذي يُعيَّن بين الخطوات لا يتأخر أكثر من ذلك أبدًا. المقاومة تنضم إلى جزيرة تصل إليها لكنها لا تنشئ واحدة أبدًا؛ مجس راسم الإشارة مقاومته 1 Mohm تجاه مشبك التأريض ويفعل الشيء نفسه.
6b. جزر اللاخطية
القطعة التي فيها فيزياء أجهزة (دايود، LED، ترانزستور ثنائي القطبية، MOSFET) تعلن AnalogPart::devices إلى جانب عناصرها وتسمّيها من Element::Device { nodes: [Node; 4], dev: u32 }، حيث dev يفهرس قائمة الأجهزة الخاصة بتلك القطعة. Element يبقى Copy؛ والأجهزة هي Box<dyn Device> على الجزيرة. النواة تُزيح فهارس أجهزة كل قطعة أثناء دمج القطع في جزيرة ولا تعرف عنها شيئًا آخر: لا اسم جهاز يصل إلى sim-kernel، والفيزياء تسكن كليًا في crates/parts خلف سمة معرّفة في crates/analog.
يقوم الجهاز بثلاثة أمور. أولًا يحمّل نموذجًا مرافقًا (الموصلية ومصادر التيار المكافئة) من جهود الأطراف عند التكرار الحالي. وثانيًا يحدّ من الجهود التي أنتجها الحل الأخير قبل التحميل التالي، وهو ما يُنفَّذ في وصلة pn عبر pnjlim في SPICE، وهو الفرق بين دايود يتقارب وآخر يفيض في exp. وثالثًا يُبلّغ عن مُعامِلاته على شكل متجه بسيط من الأرقام، بحيث يمكن لـ Ctx::restamp_device(which, params) تغيير قيمة بيتا دون إعادة بناء الجزيرة، تمامًا كما ينقل Ctx::restamp قيمة مقاومة.
الحل هو Newton-Raphson: حمّل كل جهاز، حلّل المصفوفة، حلّ، اختبر كل مجهول مقابل reltol |x| + abstol (فولت على صف عقدة، أمبير على صف فرع)، حدّ، كرّر، حتى سقف Limits::max_iter. الجزيرة بلا أجهزة تأخذ مرورًا واحدًا بالضبط وتنتج المصفوفة التي كانت تنتجها دائمًا، وهو ما تتحقق منه اختبارات الكتاب المدرسي حتى آخر خانة. نقطة تشغيل لا يصلها Newton من بداية باردة تتراجع إلى خطوات gmin (تسرّب بمرتبة الملي أوم على كل عقدة، يُمشى به عائدًا إلى GMIN)، ثم إلى خطوات المصدر، ثم تُبلّغ عن فشل بدل التظاهر. الخطوة العابرة التي لا تتقارب تنصّف وتعيد المحاولة على الميزانية نفسها التي يستخدمها ضابط الخطأ؛ وعند الأرضية يبقى التكرار قائمًا ويُحتسب الفشل في Solver::stats()، الذي يحمل أيضًا التكرارات والتكرارات المحدودة والخطوات المرفوضة ليمكن للاختبارات أن تتحقق منها بدل الوقت الفعلي.
الأجهزة في المرحلة 1: دايود (Shockley مع Is وN ومقاومة كتلة Rs)، وLED (الوصلة نفسها مع هبوط الجهد الخاص بلونه عند 20 mA خلفها)، وترانزستور ثنائي القطب (Ebers-Moll في صورته الانتقالية مع Bf وBr وIs وجهد Early، بأنواعي NPN وPNP؛ ومنذ أكتوبر 2026 أصبحت قطعة transistor هي نموذج Gummel-Poon الكامل على بطاقة كل مُصنّع بنفسه)، وموسفيت (مستوى 1 Shichman-Hodges مع Vto وbeta وlambda بقناتي N وP). تستخدم القطعة الجهاز نفسه داخل جزيرة أو خارجها: فالقطعة ذات الطرفين تحل الحلقة الوحيدة عبر نفسها مقابل المعادلة نفسها، والقطعة ذات الأطراف الثلاثة تبني جزيرة خاصة بثلاث عقد عليها جهازها الخاص وتطلب من الحالّ نفسه. هناك نموذج واحد لكل جهاز، ولا اثنان أبدًا.
تلك كانت أجهزة المرحلة 1. ومنذ ذلك الحين أصبحت التحليلات متاحة (نقطة التشغيل، والمسح بمصدر DC والمسح بالمعاملات، واستجابة التردد AC، القسم 7)، وكل بطاقة جهاز تتضمن سعة وصلتها، والمضخم التشغيلي صار نموذجًا كليًا أحادي القطب. في مساحة العمل، ما تزال الحرارة مثبتة عند 27 C؛ أما ملف SPICE (القسم 7e) فيتضمّن .temp.
ما يفعله التنفيذ ولا تقوله القواعد الثلاث أعلاه
- تُكتشف الجزر مرة واحدة، عند
Kernel::init. يثبّت النواة طوبولوجياها هناك، لذا فإن أي تغيير في سلك يعني netlist جديدة ونواة جديدة، وهو ما تفعله الواجهة أصلًا عند كل تعديل. لا اكتشاف تدريجي جديد، ولا حاجة إلى ذلك. - تُخبَر القطعة بما إذا كانت قد انضمت. يُستدعى
Component::analog_joined(bool)مرة واحدة بعد الاكتشاف. القطعة التي خُتمت يجب ألا تقود أطرافها أيضًا، وهنا يتوقف المكثف عن تشغيل مُكاملها الخاص، وتتوقف المقاومة عن تمرير مصدر Thevenin، ويتوقف المقاوم المتغيّر عن قيادة wiper الخاص به. - يمكن للقطعة طلب القيم المحلولة. يُستدعى
Component::analog_solved(currents, volts)بعد كل عملية حل، للعناصر التي أعلنتها القطعة، عندما تطلبAnalogPartالخاص بها ذلك عبرreporting(). تيار الملف المستحث حالة في المصفوفة وليس دالة لجهود العقد، لذا فهو الشيء الوحيد الذي لا تستطيع القطعة قراءته من شبكاتها الخاصة. - يمكن للقيم أن تتغير دون إعادة بناء. يسلّم
Ctx::restamp(&[Element])للنواة أختام القطعة كما هي الآن؛ تأخذ النواة القيم منها، وتترك العقد كما هي، وتعيد الحل في تلك اللحظة مع تثبيت كل جهد مكثف وكل تيار ملف مستحث. مقبض المقاوم المتغيّر هو ما صُمم هذا لأجله. شكل الجزيرة لا يتغير أبدًا؛ الأرقام وحدها هي التي تتغير فيها. - الطرف المعلّق في الهواء هو عقدة قائمة بذاتها. الطرف التماثلي الموصول بلا شيء يحصل على عقدة جديدة لا تحمل سوى gmin، فالمكثف الذي يتدلى أحد رجليه يحتفظ بشحنته ولا يقود شيئًا.
- تستقر الجزيرة على أفق مدته ثانية واحدة. تتوقف عن حجز الخطوات عندما لا شيء عليها سيتحرك أكثر من حد التسامح خلال الثانية التالية من الزمن المحاكى. السؤال عمّا إذا كان شيء ما سيحدث في step التالي هو سؤال خاطئ: ذيل الدالة الأسية يتحرك أقل من حد التسامح في كل خطوة وقتًا طويلًا قبل أن يصل.
- يمكن للنواة أن تخبرك بكم مسألة تحلّ. الدوال
Kernel::island_countوisland_of_netوisland_nodesموجودة من أجل الاختبارات التي تُلزم المسار السريع بوعده. الـ netlist الرقمي لا يبني أي جزيرة، والملفcrates/sim-kernel/tests/kernel.rsيتحقق من ذلك على دائرة البرهان ذات الـ 497 قطعة إلى جانب عدد مرات الإرسال الذي كلفت هذه الدائرة دائمًا.
ينضم المقاومان المتغيّران إلى جزيرة بالطريقة نفسها التي تنضم بها المقاومة: المسار مقاومتان، R x f من الطرف المنخفض إلى الذراع المنزلق وR x (1 - f) من الذراع المنزلق إلى الطرف المرتفع، وخارج الجزيرة تُدمج هاتان المقاومتان في مصدر Thevenin لكل طرف بدلًا من ذلك.
7. التحليلات
استدعاءات لا تقدّم الزمن المحاكى. كل ما عداها على السطح يمر عبر runForNs؛ هذه تشغّل تحليلًا وتعيد جوابًا، وهو شكل مختلف بالنسبة للعقد، وهو سبب وجود هذا القسم.
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 وanalogNets هي مدخل واحد لكل شبكة بترتيب nets[]؛ وprobes مدخل واحد لكل قطعة بترتيب parts[]. الجهد الذي ليس عددًا (شبكة عائمة) يعود null، ولا يعود عددًا أبدًا.
يُبلّغ عن الحل الذي يحتفظ به المحرك الآن ولا يعيد الحل أبدًا. عند tNs يساوي صفرًا، قبل تشغيل أي شيء، فهذه نقطة التشغيل لحظة التشغيل: كل مكثف مفرَّغ من الشحن، وكل ملف مستحث عند تيار صفر. هذه دائرة شُغّلت للتو وهي ليست أمر .op في SPICE، حيث يكون المكثف دائرة مفتوحة. للحصول على جواب DC المستقر، شغّل الدائرة حتى تستقر ثم خذ نقطة التشغيل وقتها. يظهر tNs في النتيجة ليستطيع العارض أن يقول أيًّا من الأمرين يعرض.
يكون analogNets[i] صحيحًا عندما تكون الشبكة i قد حُلّت بالمصفوفة، وخاطئًا عندما حُلّت بنموذج كل مُشغِّل. إنهما نوعان مختلفان من الأجوبة، ولا بد للعارض أن يكون قادرًا على قول ذلك.
يحمل parts القطع المختمة في جزيرة تماثلية فقط، بمدخل واحد لكل عنصر ختمته، بترتيب الختم. amps موجب عندما يتدفق من الطرف الأول للعنصر إلى طرفه الثاني، وvolts هو الجهد بين هذين الطرفين بالترتيب نفسه. القطعة التي لا مدخل لها ليس لها تيار فرع في المصفوفة؛ وهذا ليس الشيء نفسه كعدم وجود تيار، وprobes غالبًا هو الجواب هناك: مجس المقاومة هو تيارها سواء انتهى بها الأمر في مصفوفة أم لا (يخبرك الفهرس probe بما يعنيه مجس كل قطعة).
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 إلى أي منهما؛ فهو يشغّل كل نقطة هذه المدة بعد التشغيل قبل قراءتها، وأي قيمة أعلى من الصفر تعني أن النقطة لم تعد إجابة 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 موازٍ لـ parts ويحمل العنصر الأول لكل قطعة تماثلية. التحليل الذي تعذّر تشغيله يعود ومعه error مضبوطًا وpoints فارغًا؛ ولا يرمي استثناءً أبدًا.
مساران، لأن هناك نوعين من الأشياء القابلة للضبط في هذا المحرك.
propيعيد بناء الدائرة عند كل نقطة من الـ netlist مع تغيير ذلك الرقم الواحد ثم يشغّلها، لذا فكل نقطة هي نقطة تشغيل DC ببدء بارد، وcontinuedخاطئة. الخاصية التي ليست عددًا تُرفض برسالة نصية، وكذلك الخاصية التي لا تملكها القطعة.poke: trueينفّذ كود النقر (poke) الخاص بالقطعة على الدائرة الحيّة (عمود المقاوم المتغيّر)، مما يعيد الختم والحل في المكان، لذاcontinuedصحيحة وdiscreteصحيحة، لأن العمود عدد صحيح وليس متصلًا. تُعاد القطعة إلى حيث وجدها المسح.
أقصى عدد نقاط يأخذه المسح الواحد هو 1001. بعد ذلك يُرفض مع ذكر العدد في الرسالة بدلًا من تشغيله.
7c. setMaxStepNs(ns, fixed) وstepLimitNs()
Limits.dt_max كإعداد. ns هو أطول خطوة يمكن لأي جزيرة تماثلية اتخاذها؛ وfixed يثبّت الحد الأدنى عليها أيضًا، فلا يبقى أمام متحكم الخطأ سوى خطوة واحدة للاختيار منها. الصفر أو أقل يزيله ويعيد كل جزيرة إلى سقف النواة نفسها البالغ 2 ms.
أمران فقط يمكنهما تقصير خطوة مفروضة، وكلاهما مقصود: الاصطدام بانقطاع في المصدر بدلاً من الاندماج عبره، وتنقيح عتبة منطقية مراقَبة داخل الخطوة عند نقطة العبور. لا شيء يطيل الخطوة أبدًا، لذا فالخطوة المفروضة وعد بأن الدقة ستكون "على الأقل بهذه الدرجة من الدقة".
يمكن لأي قطعة أن تطلب الأمر نفسه على جزيرتها الخاصة عبر Ctx::limit_step(dt, fixed)، والطلب الأدق على الجزيرة هو الذي يسود. خاصية step في قطعة scope هي هذا الطلب نفسه: القيمة صفر، وهي الافتراضية، تترك وحدة التحكم وشأنها.
7d. acSweep(specJson: string): string
{ "source": "gen1", "probe": 4, "fStart": 10, "fStop": 100000, "pointsPerDecade": 20 }
يمكن إضافة input: وهو فهرس الشبكة التي يُقاس الكسب بالنسبة إليها. وإذا حُذف، فهي الشبكة التي يقودها عنصر المصدر نفسه، وهذا ما يقصده الشخص بـ"المدخل" عندما اختار مولّدًا.
{
"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": ""
}
المصفوفات الخمس متوازية وطول كل منها إدخال واحد لكل تردد. magDb وphaseDeg هما النسبة بين phasor الخرج و phasor الدخل (20 log10 |Vout / Vin| وarg(Vout / Vin) بالدرجات)، وهذا هو الشيء الوحيد هنا الذي يُعد دالة نقل. أمّا inputMag وoutputMag فهما مقدارا phasor الخام بوحدة الإشارة المحفّزة أيًّا كانت، وsource.drive يحدد ذلك: vsource تعني فولتًا واحدًا عبر المصدر، وisource أمبيرًا واحدًا داخله، وthevenin فولتًا واحدًا في دائرة مفتوحة خلف مقاومته. مولّد الدوال هو زوج Norton، لذا قيمته المحرِّكة isource وinputMag الخاص به هي معاوقة بالأوم لا فولت، لكن النسبة لا تتأثر، وهذا هو الغرض من عرض النسبة.
freq هو fStart * 10^(k / pointsPerDecade) حتى fStop بما فيه، وهو نفس الشبكة التي يسير عليها .ac dec، لذا فالمسح هنا والمسح في محاكٍ مرجعي بنفس الأرقام الثلاثة يتقابلان نقطة بنقطة. يجب أن يكون fStart أكبر من صفر: صفر هرتز هو التيار المستمر، وهو نقطة التشغيل وليس نقطة في مسح لوغاريتمي. أقصى عدد نقاط يأخذه مسح واحد هو 1001، وهو نفس الحد الأقصى لدى sweep.
يُؤخذ حول نقطة التشغيل التي يثبّتها المحرك الآن، تمامًا كما تبلّغ عنها operatingPoint، دون إعادة حل أي شيء. عند tNs بالصفر فهو انحياز التشغيل عند التوصيل؛ وبعد مرور الوقت فهو الحالة في تلك اللحظة، و tNs يحدد أيهما. كل جهاز غير خطي يُخطَّط عند النقطة التي تركه عندها تكرار Newton، وكل مضخم عمليات في أي وضع وضعته فيه نقطة التشغيل: المضخم الذي تشبّع يُختم متشبعًا، فكسبه للإشارات الصغيرة صفر.
منذ Analog 3 phase 1 تحمل كل بطاقة جهاز سعة الوصلة عندها، وبصمة AC هي j w C عند نفس dQ/dv الذي يُكامله التحليل الانتقالي، فلكل ترانزستور زاوية تردد عالٍ خاصة به، ولمرحلة الباعث المشترك أثر Miller. أما ما ينقص النموذج فهو في crates/analog/src/ac.rs ومكرر في docs/help/editor/analysis.md: ليس لدى BJT زمن عبور عكسي TR، وسعة البوابة-المصرف في MOSFET ثابتة فلا توجد هضبة Miller، وTIP120 Darlington بلا سعة إطلاقًا؛ لا يوجد تحليل ضوضاء ولا تحليل تشويه، لأن الدائرة بعد الخطية لا تحوي أيًّا منهما؛ والمضخم التشغيلي لا يزال الخطي المحدود بجهدي التغذية بكسب مسطح حتى تردد لانهائي.
التحليل الذي تعذّر تشغيله يعود مع ضبط error والمصفوفات فارغة؛ ولا يرمي استثناءً أبدًا. الأمور الثلاثة التي قد تسوء تخبرك بأيها حدث: القطعة المسماة لا تحتوي على مصدر يمكن لتحليل AC أن يغذّيه، أو أن الشبكة ليست على نفس الجزيرة التناظرية التي عليها المصدر، أو أن المدى ليس مدى صالحًا.
7e. spiceRun(deck: string, filesJson: string): string
دالة حرة في الوحدة، لا تابعة لـSim: تشغّل ملف SPICE على crates/spice ولا علاقة لها بأي دائرة محمّلة. filesJson هو [{ "name": "models.lib", "text": "..." }]، وهي الملفات التي قد يشملها الملف عبر .include أو .lib (بالمطابقة على الاسم الكامل، ثم على اسم الملف وحده)، أو سلسلة نصية فارغة. والجواب:
{ "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.