هذا هو الدليل الهندسي للطراز: ما ينفّذه، سجلًا بسجل، لمن يكتبون برامج ثابتة تعمل عليه. لاستخدام اللوحة في المحرر، ابدأ من لوحة Arduino Uno و صفحة اللوحة.
المتحكم الدقيق الثاني. مكوّن نواة واحد (uno في crates/parts) يغلّف نموذج SoC لشريحة ATmega328P (crates/atmega328p) مبنيًا على نواة AVR (crates/avr-core، مثبت صحتها في proofs/avr/REPORT.md). البرنامج الثابت هو ملف AVR ELF (أو صورة flash خام) يتخاطب مع الملحقات أدناه عند عناوينها الحقيقية في ATmega328P، لذا فالبرنامج المبني لـ Mokxi يعمل على لوحة Uno R3 حقيقية. تشغيل الملفات الثنائية المبنية بنواة Arduino ومكتبة avr-libc هدفٌ نسعى إليه: الملحقات هنا هي التي تتعامل معها نواة Arduino في pinMode وdigitalWrite وanalogWrite وanalogRead وmillis وdelay وSerial وattachInterrupt؛ ومثال وميض مبني من المصنّع ينبغي أن يعمل دون تغيير متى صارت هذه صحيحة (جرّبه إن كان لديك ملف مسبق البناء؛ لا تجلب ملفات نواة Arduino المصدرية فهي بترخيص LGPL).
نوع المجموعة في الفهرس هو uno (Arduino Uno R3). ثلاثة عناصر تُبنى اعتمادًا على هذا الملف: نظام SoC والقطعة (Rust)، وبيئة تشغيل البرنامج الثابت والأمثلة (++C، clang)، وصورة اللوحة (TypeScript). غيّره فقط بتعديل هذا الملف أولًا. كل ما ورد في docs/esp32c3.md عن سلوك قطعة اللوحة (الشرائح، وقناة المضيف، وإعادة الضبط، وسطر الانهيار) ينطبق هنا إلا إذا نصّ هذا الملف على خلافه.
1. أطراف اللوحة (بترتيب الفهرس)
منظر علوي، ومنفذ USB ومقبس التغذية على اليسار. الرأس العلوي من اليسار إلى اليمين: SCL، SDA، AREF، GND، 13، 12، 11، 10، 9، 8، 7، 6، 5، 4، 3، 2، 1، 0. الرأس السفلي من اليسار إلى اليمين: IOREF، RESET، 3V3، 5V، GNDb، GNDc، VIN، A0، A1، A2، A3، A4، A5. 31 طرفًا. رؤوس ICSP ليست أطرافًا.
كهربائيًا:
- يوفر
5VوIOREFجهد 5 V عندR_SUPPLY؛ ويوفر3V3جهد 3.3 V؛ وتوفرGND*جهد 0 V. أماVINفهو مدخل تتجاهله اللوحة (التغذية دائمًا من USB). اللوحة تعمل كمصدر تغذية. -
RESETمدخل به مقاومة سحب 10 k إلى 5 V؛ ما دون 2.5 V يُبقي المعالج في وضع إعادة الضبط؛ وعند الإفلات يُعاد التشغيل من متجه إعادة الضبط. - Digital
0..13andA0..A5are inout GPIO. Port mapping:0..7= PD0..PD7,8..13= PB0..PB5,A0..A5= PC0..PC5.SDAis strapped toA4andSCLtoA5(same net,R_STRAP). Output (DDR bit set): push-pull at 5 V or 0 V throughR_STRONG. Input (DDR clear): high-Z, plus a 35 k pull-up to 5 V when the PORT bit is set (andPUDclear). Input threshold 2.5 V. A contended (Unknown) net reads 0. A floating input (nothing driving its net, no pull resistor, noINPUT_PULLUP) reads noise, as it does on the bench: it holds the level it was last driven to for 2 ms (the charge on the pin), then reads a fresh random bit every millisecond, so a button wired to 5 V with no pull-down flickers once it is let go.analogReadof a floating pin wanders smoothly between about 15 and 65 percent of the rail, starting from wherever the pin was last held. The noise is a hash of the board, the pin and the simulated time (crates/parts/src/floating.rs, shared by every board), so a run repeats exactly. A header hole with no wire at all still reads what its own pad holds: an output reads back its level andINPUT_PULLUPreads high.AREFis an input; when the ADC reference isAREF(REFS = 0) its voltage is the reference, otherwise it is high-Z. - الطرف
13متصل بـ LED على اللوحة عبر مقاومة 1 كيلوأوم إلى الأرضي (حمولة؛ يُظهر العرض المرئي إضاءته من بت المجس، انظر القسم 5). الطرفان0/1هما أيضًا USART0 RX/TX على اللوحة الحقيقية؛ هنا يتصل الـ USART بقناة المضيف وتبقى الأطراف GPIO. - المحول التناظري:
A0..A5تقرأ جهد الشبكة عند الطرف مقابل المرجع المختار (5 فولت لـAVCC، و1.1 فولت للمرجع الداخلي، وجهد طرفAREFللمرجع الخارجي)، بدقة 10 بت، مع تجاهل العينة والاحتفاظ.
2. خريطة الذاكرة (ATmega328P الحقيقية)
| فضاء | العنوان | الحجم |
|---|---|---|
| فلاش (البرنامج) | عنوان الكلمة 0x0000 | 32 KB (0x4000 كلمة)؛ قسم الإقلاع غير مُمثَّل، عمليات الكتابة SPM تذهب مباشرة إلى الذاكرة الفلاش |
| السجلات | البيانات 0x0000..0x001F | R0..R31 (داخل النواة) |
| I/O | البيانات 0x0020..0x005F | عناوين IN/OUT من 0x00 إلى 0x3F |
| مداخل ومخارج موسعة | data 0x0060..0x00FF | |
| SRAM | data 0x0100..0x08FF | 2 KB |
| EEPROM | منفصل، سعة 1 KB | عبر EECR/EEDR/EEAR، تستغرق الكتابة 3.3 ms (26,368 دورة من مذبذب RC البالغ 8 MHz، كما يذكر ذلك ورق البيانات؛ 1.8 ms في وضع المسح وحده أو الكتابة وحدها)، وEEPE يقرأ 1 حتى تنتهي، وEERIE يرفع EE_READY كمستوى ثابت |
loadProgram takes an ELF32 AVR executable (e_machine 83; PT_LOAD at flash addresses, .data initializers at their LMA in flash the way avr-gcc and clang lay them out; the loader in crates/avr-core/src/elf.rs already does this) or a raw binary flash image when the bytes are not an ELF. Reset: pc = 0, SP = 0x08FF, SREG = 0, I/O at datasheet reset values, SRAM and registers undefined (zero). A load at run time resets the board.
3. الملحقات (عناوين حقيقية، بترقيم فضاء البيانات، ومواضع بتات حقيقية)
كل ما لم يُذكر يُقرأ عند قيمة إعادة الضبط ويتجاهل الكتابة، مع عدّاد للتشخيص.
3.1 المنافذ
| عنوان البيانات | سجل |
|---|---|
0x23 0x24 0x25 |
PINB DDRB PORTB (البِتات 0..5 = الأطراف 8..13؛ و6 و7 للمذبذب البلوري، وليس أطراف GPIO أبدًا) |
0x26 0x27 0x28 |
PINC DDRC PORTC (البِتات 0..5 = A0..A5) |
0x29 0x2A 0x2B |
PIND DDRD PORTD (البِتات 0..7 = الأطراف 0..7) |
0x55 |
البِت 4 PUD في MCUCR يعطّل كل مقاومات السحب لأعلى |
كتابة 1 في بِت PINx تعكس قيمة البِت المقابل في PORTx (ورقة البيانات 14.2.2). تعليمتا SBI/CBI على هذه العناوين تعملان بقراءة-تعديل-كتابة عند السجل، تمامًا كما على الشريحة.
3.2 المؤقت/العدّاد Timer/Counter0 (8 بت، مؤقت millis())
| عنوان البيانات | سجل | البتات |
|---|---|---|
0x44 |
TCCR0A |
بِتات COM0A1:0 في 7..6، وCOM0B1:0 في 5..4، وWGM01:0 في 1..0 |
0x45 |
TCCR0B |
FOC0A في 7، FOC0B في 6، WGM02 في 3، CS02:0 في 2..0 |
0x46 |
TCNT0 |
|
0x47 |
OCR0A |
|
0x48 |
OCR0B |
|
0x6E |
TIMSK0 |
OCIE0B في 2، OCIE0A في 1، TOIE0 في 0 |
0x35 |
TIFR0 |
OCF0B في 2، OCF0A في 1، TOV0 في 0؛ الكتابة 1 تُصفّرها |
الأطوار (WGM02:0): 0 عادي، 1 PWM صحيح الطور (القيمة العليا 0xFF)، 2 CTC (القيمة العليا OCR0A)، 3 PWM سريع (القيمة العليا 0xFF)، 5 صحيح الطور (القيمة العليا OCR0A)، 7 PWM سريع (القيمة العليا OCR0A). المقسّم CS02:0: 0 متوقف، 1 = 1، 2 = 8، 3 = 64، 4 = 256، 5 = 1024، 6/7 خارجي (غير مُحاكى، العد 0). مخارج المقارنة: OC0A على الطرف 6 (PD6)، وOC0B على الطرف 5 (PD5)؛ وأطوار COM وفق جداول ورقة البيانات (0 غير متصل، 1 تبديل في غير PWM / محجوز أو تبديل في PWM حسب الجدول، 2 غير عاكس، 3 عاكس). في PWM السريع يحدث تطابق المقارنة بعد نبضة ساعة المؤقت واحدة من مساواة TCNT0 لقيمة OCR0x، لذا يكون المخرج غير العاكس مرتفعًا بمقدار OCR0x + 1 من عددات الـ256، وقيمة OCR0x = 0 هي النبضة أحادية الساعة المذكورة في ورقة البيانات وليست مستوى منخفضًا ثابتًا. تُطبَّق أولوية المخرج فقط عندما يكون بِت DDR مضبوطًا. متجهات المقاطعات: TIMER0_COMPA 14، وTIMER0_COMPB 15، وTIMER0_OVF 16.
3.3 المؤقت/العدّاد Timer/Counter1 (16 بت)
| عنوان البيانات | سجل | البتات |
|---|---|---|
0x80 |
TCCR1A |
COM1A1:0 في 7..6، وCOM1B1:0 في 5..4، وWGM11:10 في 1..0 |
0x81 |
TCCR1B |
ICNC1 في 7، ICES1 في 6، WGM13:12 في 4..3، CS12:0 في 2..0 |
0x82 |
TCCR1C |
FOC1A في 7، FOC1B في 6 |
0x84 0x85 |
TCNT1L TCNT1H |
الوصول إلى 16 بت عبر بايت TEMP المشترك (القراءة: قراءة المنخفض أولًا تُقفِل العالي؛ الكتابة: العالي أولًا) |
0x86 0x87 |
ICR1L ICR1H |
|
0x88 0x89 |
OCR1AL OCR1AH |
|
0x8A 0x8B |
OCR1BL OCR1BH |
|
0x6F |
TIMSK1 |
ICIE1 في 5، OCIE1B في 2، OCIE1A في 1، TOIE1 في 0 |
0x36 |
TIFR1 |
ICF1 في 5، OCF1B في 2، OCF1A في 1، TOV1 في 0 |
جميع أطوار WGM الـ16 وفق جدول ورقة البيانات (عادي، PWM بـ8/9/10 بت، CTC على OCR1A أو ICR1، PWM سريع بقيمة عليا ICR1 أو OCR1A، صحيح الطور والتردد). OC1A على الطرف 9 (PB1)، وOC1B على الطرف 10 (PB2). الالتقاط من الطرف 8 (ICP1، PB0) عند الحافة المحددة، مع تجاهل ملغِي التشويش. المتجهات: TIMER1_CAPT 10، وCOMPA 11، وCOMPB 12، وOVF 13.
3.4 المؤقت/العدّاد Timer/Counter2 (8 بت)
| عنوان البيانات | سجل |
|---|---|
0xB0 0xB1 0xB2 0xB3 0xB4 |
TCCR2A TCCR2B TCNT2 OCR2A OCR2B (نفس تخطيط البِتات كما في المؤقت 0) |
0x70 |
TIMSK2 |
0x37 |
TIFR2 |
0xB6 |
ASSR (يُقرأ 0؛ وضع عدم التزامن غير مُحاكى) |
المقسّم CS22:0: 0 متوقف، 1، 8، 32، 64، 128، 256، 1024. OC2A على الطرف 11 (PB3)، وOC2B على الطرف 3 (PD3). المتجهات: TIMER2_COMPA 7، وCOMPB 8، وOVF 9.
3.5 USART0
| عنوان البيانات | سجل | البتات |
|---|---|---|
0xC0 |
UCSR0A |
RXC0 في 7، TXC0 في 6، UDRE0 في 5، FE0 في 4، DOR0 في 3، UPE0 في 2، U2X0 في 1، MPCM0 في 0 |
0xC1 |
UCSR0B |
RXCIE0 في 7، TXCIE0 في 6، UDRIE0 في 5، RXEN0 في 4، TXEN0 في 3، UCSZ02 في 2 |
0xC2 |
UCSR0C |
صيغة الإطار، تُخزَّن ويُقرأ حدّها؛ ويُفترض 8N1 لضبط الإيقاع |
0xC4 0xC5 |
UBRR0L UBRR0H |
السرعة baud = 16 MHz / (16 (UBRR + 1))، أو / 8 مع U2X0 |
0xC6 |
UDR0 |
write: transmit (when UDRE0); read: received byte |
الإرسال فقط عندما يكون TXEN0 مضبوطًا، وهو ليس كذلك بعد إعادة الضبط حتى استدعاء Serial.begin: فالكتابة في UDR0 مع توقف المرسِل تُهمَل ويبقى UDRE0 مضبوطًا، لذا فإن كودًا يطبع دون Serial.begin لا يضع شيئًا على الشاشة التسلسلية، كما يحدث على لوحة حقيقية. الاستثناء الوحيد سطر من Mokxi نفسه ([Mokxi] ...، mokxi_notice)، فهو يصل إلى الشاشة مهما كانت حالة TXEN0، لأن المتحدث هو المحاكي لا الكود. مع ضبط TXEN0، فالكتابة في UDR0 مع ضبط UDRE0 تذهب إلى مخزن إرسال مؤقت بسعة بايت واحد؛ يُصفَّر UDRE0، ثم يأخذ سجل الإزاحة البايت ويُضبط UDRE0 مجددًا (تخزين مؤقت مزدوج ببايت واحد، مثل الشريحة)؛ ويصل البايت إلى قناة المضيف بعد زمن إطار واحد (10 بِتات بالسرعة baud) من دخوله سجل الإزاحة، وعندها يُضبط TXC0 إن لم يتبعه بايت آخر في سجل الإزاحة (وهو ما تعنيه ورقة البيانات بـ"لا توجد بيانات جديدة حاليًا في مخزن الإرسال")، لذا ينتظر flush() آخر بايت. الاستقبال: تُصفّ بايتات المضيف في FIFO بحجم مخزن الاستقبال الحقيقي ذي المستويين مضافًا إليه مخزون عند المضيف من 256 بايت حتى لا يضيع النص المكتوب؛ ويُضبط RXC0 ما دامت بيانات بانتظار، وقراءة UDR0 تُخرج بايتًا. المتجهات: USART_RX 18، وUSART_UDRE 19، وUSART_TX 20. وكتابة TXC0 = 1 تُصفّره.
3.6 المحوّل التناظري ADC
| عنوان البيانات | سجل | البتات |
|---|---|---|
0x78 0x79 |
ADCL ADCH |
النتيجة، مضبوطة إلى اليمين إلا مع ADLAR |
0x7A |
ADCSRA |
ADEN في 7، ADSC في 6، ADATE في 5، ADIF في 4، ADIE في 3، ADPS2:0 في 2..0 |
0x7B |
ADCSRB |
مخزَّن |
0x7C |
ADMUX |
REFS1:0 في 7..6، ADLAR في 5، MUX3:0 في 3..0 (0..5 = A0..A5، 8 = درجة الحرارة (يُقرأ 0x150)، 14 = مرجع النطاق 1.1 V، 15 = 0 V) |
0x7E |
DIDR0 |
مخزَّن |
يستغرق التحويل 13 نبضة ساعة ADC (25 للأول بعد ADEN) عند 16 MHz / المقسّم؛ تُقرأ ADSC بقيمة 1 حتى الانتهاء، ثم يُضبط ADIF وتكون النتيجة round(1023 * Vin / Vref) مع تقييد الحد، من جهد شبكة الطرف وقت بدء التحويل. المتجه: ADC 21.
3.7 المقاطعات الخارجية ومقاطعات تغيير الأطراف
| عنوان البيانات | سجل |
|---|---|
0x69 |
EICRA (ISC11:10 بِتات 3..2، ISC01:00 بِتات 1..0: 0 مستوى منخفض، 1 أي تغيير، 2 حافة هابطة، 3 حافة صاعدة) |
0x3D |
EIMSK (INT1 في 1، INT0 في 0) |
0x3C |
EIFR (الكتابة 1 تُصفّر) |
0x68 |
PCICR (PCIE2 في 2 = PORTD، PCIE1 في 1 = PORTC، PCIE0 في 0 = PORTB) |
0x6B 0x6C 0x6D |
PCMSK0 PCMSK1 PCMSK2 |
0x3B |
PCIFR |
INT0 هو الطرف 2 (PD2)، وINT1 هو الطرف 3 (PD3). المتجهات: INT0 1، وINT1 2، وPCINT0 3، وPCINT1 4، وPCINT2 5.
3.7a SPI (مُسمّى، وغير مُحاكى)
| عنوان البيانات | سجل | البتات |
|---|---|---|
0x4C |
SPCR |
SPIE في 7، SPE في 6، DORD في 5، MSTR في 4، CPOL في 3، CPHA في 2، SPR1 في 1، SPR0 في 0 |
0x4D |
SPSR |
SPIF في 7، WCOL في 6، SPI2X في 0 |
0x4E |
SPDR |
بايت البيانات |
لا يحتوي النموذج على وحدة SPI: هذه العناوين تُقرأ 0 وتتجاهل الكتابة، فلا يُضبط SPIF أبدًا ولا تنطلق مقاطعة اكتمال النقل. يُسمّيها uno.h حتى تتم الترجمة لأي كود كُتب بناءً عليها، مثل تابع SPI مع ISR(SPI_STC_vect)، كما تتم على Uno حقيقي. أما SPI.h فهو رئيس (master) برمجي على الأطراف 10 إلى 13. المتجه: SPI_STC 17.
3.8 السبات، ومراقب النظام، ومتفرقات
| عنوان البيانات | سجل |
|---|---|
0x53 |
SMCR (SM2:0 بِتات 3..1، SE البِت 0) |
0x54 |
MCUSR (أعلام إعادة الضبط؛ يُضبط PORF بعد التشغيل، وEXTRF بعد إعادة ضبط بطرف RESET؛ أما WDRF فيُصفَّر مجددًا قبل تشغيل الكود، كما يفعل Optiboot) |
0x60 |
WDTCSR (المراقب watchdog، أدناه) |
0x61 |
CLKPR (مخزَّن؛ يبقى الساعة عند 16 MHz) |
0x5F 0x5E 0x5D |
SREG SPH SPL (داخل النواة، لا تصل إلى الناقل أبدًا) |
كان SMCR وMCUSR عند 0x33 و0x34 هنا وفي firmware/uno/include/uno.h حتى 2026-11 (عنواني الإدخال/الإخراج لديهما مأخوذين كعنواني بيانات)؛ وما زال النموذج يستجيب عند هذين العنوانين أيضًا، بحيث تستمر الصور المبنية مقابل ذلك الترويسة في العمل، بينما ملف ELF مبني مع avr-libc يصل إليهما عند عنواني ورق البيانات أعلاه.
SLEEP مع ضبط SE يوقف النواة. في وضع الخمول (SM = 0) يوقظها أي مقاطعة مفعَّلة ومعلّقة. أما الأوضاع الأخرى فتوقف ساعة الإدخال/الإخراج، لذا لا يوقظها إلا ما تذكره قائمة أوضاع النوم في ورقة البيانات: في وضعَي الإطفاء الشامل (power-down) والاستعداد (standby) توقظها المقاطعات الخارجية، وتغيّر الطرف (pin change)، والمراقب (watchdog)، وTWI؛ ويضيف وضعا حفظ الطاقة (power-save) والاستعداد الممتد (extended standby) المؤقت 2؛ ويضيف تقليل تشويش ADC كلاً من المؤقت 2 وADC وجهوزية EEPROM/SPM. المؤقتان 0 و1 وUSART لا يستطيعان إيقاظ نوم power-down، لذا فإن كودًا يستخدم SLEEP_MODE_PWR_DOWN ينام متجاوزًا نبضة millis() حتى يأتي زره أو مراقبه. المقاطعتان INT0 وINT1 توقظان تلك الأوضاع، بما فيها تقليل تشويش ADC، فقط عند مستوى LOW (ISCn1:0 = 00): فكاشف الحواف لديهما يعمل على ساعة الإدخال/الإخراج، لذا حين تتوقف لا تُرى الحافة ولا تُثبَّت في EIFR، وينام الكود عبر attachInterrupt(0, wake, FALLING) متجاوزًا الزر كما على لوحة Uno حقيقية. مقاطعات تغيّر الطرف غير متزامنة وتوقظ عند أي تغيير. المؤقتات تستمر في العد أثناء النوم هنا، بينما تتوقف في القطعة الحقيقية، لذا تعود millis() متقدمة نبضة واحدة (الفيض المعلّق) بدلًا من العودة إلى حيث كانت بالضبط. أما delay() في بيئة التشغيل فينام في وضع الخمول، وبهذا يصبح الكود الخامل رخيص الكلفة.
مراقب التشغيل (watchdog) مطابق لورق البيانات (crates/avr-core/src/wdt.rs): فهو يَعُدّ بمذبذبه الخاص البالغ 128 kHz، لذا فإن WDTO_15MS حتى WDTO_8S تعني من 16 ms إلى 8.2 s مهما كان ترديد المعالج؛ وWDE وWDIE يحددان وضع إعادة الضبط أو المقاطعة (المتجه WDT، الذي يصفّر WDIF عند تنفيذه) أو وضع المقاطعة ثم إعادة الضبط؛ وتصفير WDE أو تغيير المقسّم يتطلب تتابع WDCE ذا الدورات الأربع؛ وWDR يعيد بدء العد. انتهاء المهلة في وضع إعادة الضبط يعيد تشغيل البرنامج من متجه إعادة الضبط مع الاحتفاظ بذاكرة SRAM، كما تفعل الشريحة. على الشريحة الحقيقية كان سيُضبط WDRF وسيبقى WDE مفعّلًا، عند 16 ms، إلى أن يصفّر الكود قيمة MCUSR؛ لكن Uno و Nano و Pro Mini تأتي مع Optiboot، وOptiboot 4.4 (optiboot_atmega328.hex) ينفّذ ch = MCUSR; MCUSR = 0; ثم appStart، الذي يستدعي watchdogConfig(WATCHDOG_OFF) فيكتب WDCE|WDE ثم WDTCSR = 0 قبل أن يقفز إلى الكود. والنموذج يفعل الشيء نفسه: فبعد إعادة ضبط بواسطة مراقب التشغيل يبدأ الكود وWDRF مصفّر ومراقب التشغيل متوقف، بحيث يعمل wdt_enable(WDTO_15MS); while (1); كإعادة ضبط برمجية مهما كان setup() بطيئًا. أما PORF وEXTRF فيُحتفظ بهما (Optiboot 4.4 كان سيصفّرهما أيضًا؛ أما Optiboot الأحدث فيحتفظ بهما في r2)، فيستطيع الكود طباعة سبب إعادة الضبط.
3.9 المقاطعات
الدالة set_interrupt(vector, pending) في النواة تمثل مستوى لكل متجه: يرفع نظام-on-chip متجهًا طالما أن بتّ الراية مضبوط وبتمكين مضبوط (وفي حالة USART، طالما أن الشرط قائم)، وتمسح النواة الراية عند الدخول لمتجهات المؤقت والخارجي وADC تمامًا كما تفعل العتاد (سجلات الرايات تخص النظام، لذا تخبر النواةُ النظامَ أي متجه أخذته عبر خطاف ناقل فيمسح النظام الراية). رايات USART RXC0/UDRE0/TXC0 لا تمسحها عملية الدخول، بل الإجراء المقابل فقط، كما على الشريحة.
4. قناة المضيف
host = "utf-8 bytes on USART0". نفس دلالات قناة ESP32-C3.
5. نموذج الزمن والقطعة
تردد 16 MHz، وعدّ الدورات من النواة (الدالة run(cycle_budget) تعيد الدورات؛ عدّاد دورات النواة هو الساعة). شرائح مدتها 10 us = 160 دورة. تُقدَّم المؤقتات دفعة واحدة لكل شريحة انطلاقًا من عدد الدورات مع أوقات حدث دقيقة لمطابقات المقارنة والفيض (حدث المؤقت التالي قابل للحساب من عدّاده وقمته ومقسِّمه ووضعه؛ احسبه، شغّل النواة حتى تلك الدورة، طبّق الحدث، تابع)، لذا تقع حافة PWM أو مقاطعة مؤقت على الدورة الدقيقة. تغيّرات الأطراف تحمل إزاحة دورتها داخل الشريحة إلى drive_after. قراءات PINx ترى مستويات الأطراف كما كانت عند بداية الشريحة زائد أي تغيير أحدثه الكود نفسه داخل الشريحة.
المجس: البت 0 = يعمل (1 أثناء التنفيذ، 0 أثناء إعادة الضبط أو التوقف)، البت 1 = نائم، البت 2 = LED اللوحة (الطرف 13 PORTB5 مرتفع و DDRB5 مضبوط)، البت 3 = نشاط TX خلال آخر 20 ms، البت 4 = نشاط RX خلال آخر 20 ms. إذن probe قناع بتات صغير، يساوي 0 من دون برنامج. وPoke: 2 = ضغط RESET، و3 = تحريره.
معالجة الانهيار كما في القسم 5 من docs/esp32c3.md: لا يستطيع AVR إطلاق مصائد (traps)، لذا يعني "انهار" أن النواة نفّذت شيفرة تشغيل غير قانونية (BREAK أو شيفرة لا تملكها القطعة) أو أن PC خرج من الذاكرة الوميضية. تتوقف القطعة وتطبع firmware crashed at pc=0x0123 (word address), reason مرة واحدة على قناة المضيف.
6. بيئة تشغيل البرنامج الثابت (firmware/uno/)
بيئة تشغيل مستقلة للغة C وC++ للمعالج ATmega328P مبنية بأدوات clang 18 (--target=avr -mmcu=atmega328p -Os) وlld، دون avr-libc، ودون نواة Arduino، ودون GPL: جدول المتجهات و_start (نسخ .data من الذاكرة الفلاشية عبر LPM، وتصفير .bss، وضبط المكدس، وتمكين المقاطعات، ثم main)، وuno.h (السجلات السابقة كوحدات ماكرو بأسمائها الحقيقية)، ونفس واجهة arduino.h المتوفرة في بيئة تشغيل ESP32-C3 إضافة إلى analogRead(A0..A5)، وanalogWrite(pin, 0..255) على الأطراف الستة PWM باستخدام المؤقتات بالطريقة نفسها التي تتبعها نواة Arduino (المؤقت 0 بوضع PWM السريع للطرفين 5 و6 عند 976 Hz، والمؤقتان 1 و2 بوضع الطور الصحيح للأطراف 9 و10 و11 و3 عند 490 Hz)، وmillis()/micros() من فيض المؤقت 0 كل 1024 us مع التصحيح الكسري نفسه المستخدم في Arduino، وdelay() بالنوم في وضع الخمول بين نبضات المؤقت، وdelayMicroseconds بانتظار مشغول، وSerial على USART0 (حلقتا استقبال وإرسال بسعة 64 بايت لكل منهما، تُملأ حلقة الاستقبال بـ USART_RX وتُفرغ حلقة الإرسال بـ USART_UDRE، كما تفعل HardwareSerial في نواة Arduino)، وattachInterrupt(digitalPinToInterrupt(2|3), fn, mode)، وtone/noTone اختياريًا. الأمثلة في firmware/uno/examples/<name>/sketch.ino، وتُبنى إلى web/public/firmware/uno/<name>.elf مع web/public/firmware/uno/index.json بالشكل نفسه لفهرس ESP32 إضافة إلى حقل "program": "elf32 avr atmega328p" في كل مدخلة: blink (الطرف 13)، وbutton (الطرف 2 بوضع INPUT_PULLUP إلى الطرف 13)، وserial، وfade (analogWrite على الطرف 9)، وanalog (يطبع analogRead(A0) خمس مرات في الثانية)، وcounter (74HC595 على الأطراف 4/5/6)، وinterrupt (attachInterrupt على الطرف 2). تختار الواجهة قائمة البرامج الثابتة وفق سلسلة program في فهرس القطعة: "elf32 riscv32imc" يقرأ /firmware/index.json، و"elf32 avr atmega328p" يقرأ /firmware/uno/index.json.
7. ما تثق به هذه المواصفة، وما لا تثق به
ثلاث مجموعات، بالتصنيف نفسه الذي يستخدمه القسم 7 من docs/esp32c6.md. وهي موجودة لأن نموذج لوحة يخمّن عنوانًا بصمت هو أسوأ من نموذج يقول إنه لم يعرف.
مأخوذة من ورقة البيانات، ومُجرَّبة ببرنامج ثابت حقيقي. كل عنوان وموضع بت وقيمة إعادة ضبط في القسم 3 مأخوذ من ATmega48A/PA/88A/PA/168A/PA/328/P
Data Sheet (DS40002061)، بترقيم فضاء البيانات، ولا شيء منه تخمين: هذه القطعة عمرها عشرون عامًا وخريطة سجلاتها عامة ومستقرة. كما أن كل كتلة مُختبرة باختبار يحمّل ملف ELF حقيقيًا ويشغّله بالطريقة التي يعمل بها البرنامج الثابت: crates/atmega328p/tests/peripherals.rs يكتب في السجلات عبر نافذة الإدخال/الإخراج للنواة على صورة قيد التشغيل، وtests/runtime.rs يشغّل الكود الستة التي يُشحنها المنتج فعلًا. المنافذ، والمؤقتات/العدادات الثلاثة، وUSART0، والمحوّل ADC مع مقسّمه الترددي ومراجعه الثلاثة، والمقاطعات الخارجية ومقاطعات تغيّر الطرف، وEEPROM، والنوم، وكتابة SPM للذاكرة الفلاشية، كلها ضمن تلك المجموعة. والمذبذب البلوري 16 MHz هو مذبذب Uno نفسه.
تمّت النمذجة، لكن دون التقيد بأرقام ورقة البيانات. هذه سلوكيات لا عناوين، وكل واحدة منها تقريب تختاره هذه الوثيقة:
- المحوّل ADC لا يحتوي على أي خطأ. التحويل هو
round(1023 × Vin / Vref)مأخوذ في اللحظة التي بدأ فيها. لا يوجد أخذ عينة وتثبيت، ولا مقاومة دخل، ولا لا خطية تكاملية أو تفاضلية، ولا ضجيج، ولا انزياح 1 LSB، ولورقة البيانات أرقام لجميع هذه العوامل. قراءة مقسّم جهد هنا تعطي العدد نفسه في كل مرة. - الزمن دقيق تمامًا. المذبذب البلوري يعمل عند 16 MHz دون سماحية ولا انجراف ولا اهتزاز، لذا فإن
millis()لا تتقدم ولا تتأخر أبدًا مقارنة بساعة الحائط كما يحدث مع الرنان الخزفي الحقيقي. - الأطراف ثلاث حالات وعتبة واحدة. دفع-جذب عند 5 V، أو مقاومة عالية، أو مقاومة سحب لأعلى بقيمة 35 kΩ (تعطي ورقة البيانات مدى من 20 kΩ إلى 50 kΩ)، وتُقرأ القيمة بمقارنتها بنصف جهد التغذية. لا يوجد تخلخل في الدخل، ولا مقاومة خرج، ولا زمن صعود أو هبوط، ولا حد لتيار المصدر أو المُغرق، ولا ميزانية تيار لكل طرف أو إجمالية.
- اللوحة مصدر تغذية مثالي. جهد 5 V و3.3 V والأرضيات محفوظة عند مقاومة سكة مثالية إلى الأبد؛ لا شيء يهبط جهده، ولا يوجد منظم جهد ولا حد لتيار USB. والـ LED الموجود على اللوحة هو LED خلف مقاومة 1 kΩ على الطرف 13 ولا شيء غير ذلك.
- الإقلاع هو ما تحدده الفيوزات، 66 ms. تأتي Uno بفيوز منخفض
0xFF(CKSEL = 1111،SUT = 11: مذبذب بلوري، مع صعود بطيء للطاقة)، وهو ما تعطيه الفقرة 9-4 من ورقة البيانات كـ 16K CK لبدء تشغيل المذبذب و14 CK + 65 ms تأخير من إعادة الضبط. يقفز Optiboot مباشرة إلى الكود بعد إعادة ضبط الطاقة، لذا يبدأsetup()بعد 66.0 ms من تطبيق الطاقة («تشغيل»)، وتبقى كل الأطراف بمقاومة عالية حتى ذلك الحين، ويكون زمن إقلاع أي حساس قد انقضى بحلول الوقت الذي يتحدث إليه الكود. أما بعد إعادة ضبط لاحقة (RESETيُترك، أو مقاطعة كلب الحراسة) فيُعاد تشغيل الكود فورًا: فالمهلة بعد تلك الحالات، وانتظار Optiboot لمبرمج بعد إعادة ضبط خارجية، غير مُمثَّلة في المحاكي. - الشريحة الزمنية 10 µs. تُخطى النواة تعليمة واحدة في كل مرة داخلها، لذا يحمل تغيّر أي طرف دوره الزمني الدقيق، لكن النظام على الشريحة والدائرة لا يلتقيان إلا عند حدود الشرائح الزمنية أو عند ما تنتظره الشريحة.
غائبة عمدًا. تُركت خارجًا بدلًا من اختلاقها، وتُقرأ سجلاتها بقيمة إعادة الضبط وتُحسب ضمن السجلات الشاردة: SPI، وTWI/I2C، والمقارن التماثلي، وقسم محمّل الإقلاع وفيوزاته، ومقسّم التردد للساعة، والوضع غير المتزامن للمؤقت 2، وجسر USB-التسلسلي (Serial يصل إلى الشاشة عبر قناة المضيف، ويبقى الطرفان 0 و1 كـ GPIO عاديين). الدروع (Shields) ليست قطعًا؛ ونواة Arduino ومنظومة مكتباتها غير موجودة هنا، وبيئة التشغيل في القسم 6 هي من صنعنا.