نظرة عامة مع أمثلة قيد التشغيل تجدها في صفحة اللوحة و نموذج Arduino Uno R4 Minima (كل السجلات).
ما هي
شريحة Renesas RA4M1 بسرعة 48 MHz: وهي Arm Cortex-M4 مع 256 KB من الذاكرة الوميضية و32 KB من SRAM، بينما تعمل Uno R3 بشريحة ATmega328P عند 16 MHz مع 32 KB و2 KB. مقاس اللوحة 68.6 في 53.3 ملم، وهو مخطط Uno بدقة عُشر المليمتر، لذا فهي تقبل درع Uno ولا تدخل في لوحة التجارب: وصّلها بأسلاك توصيل من الرؤوس. صفحة المرجع هي نموذج Arduino Uno R4 Minima.
هذه هي Minima، ذات مقبس USB-C وبدون WiFi. أما Uno R4 WiFi، بشاشة مصفوفة LED وWiFi، فهي لوحة منفصلة في صندوق القطع: انظر نموذج Uno R4 WiFi.
التسلسلي هو USB
هذا أول ما يفاجئ القادم من Uno R3.
على Uno تحوّل شريحة ثانية إشارة USB إلى UART، و Serial هي USART0 الخاص بالمتحكم الدقيق على الطرفين 0 و1. أما على R4 فلا شريحة ثانية: جهاز USB موجود على شريحة RA4M1 نفسها. Serial هي المقبس، و Serial1 هو UART الطرفين 0 و1، منفذ قائم بذاته.
إذن في المحرر:
- ما تطبعه إلى
Serialيظهر في الشاشة التسلسلية. - ما تطبعه على
Serial1يظهر أيضًا في الشاشة (فللوحة قناة مضيف واحدة هنا)، ويخرج من الطرف 1 على شكل بتات أيضًا، لذا يراه راسم إشارة أو لوحة ثانية موصّلة بذلك الطرف.
برنامج التسلسلي المدمج يطبع إلى كليهما، لذا يظهر الفرق على الشاشة.
يمثّل Mokxi جهاز USB على أنه أنبوب بايتات تحمل أسماء السجلات: يكفي لمنفذ تسلسلي، ولا شيء فوق ذلك. لا يوجد تعداد ولا موصّفات ولا مضيف، لذا فإن while (!Serial) {} يعود فورًا هنا بينما يتوقف لحظة على طاولة حقيقية.
Pins
عشرون منها، معدودة على طريقة الطباعة الحريرية:
- من
0إلى13على طول رأس الأطراف الرقمية، مع LED المدمج على13. - من
A0إلىA5على طول الجانب السفلي، وهي أيضًا الأطراف الرقمية من 14 إلى 19.
الLED الموجود على 13 يعمل بالمنطق الموجب: digitalWrite(LED_BUILTIN, HIGH) يضيئه، كما على Uno.
ستة أطراف تدعم PWM عتاديًا عبر analogWrite، بتردد 490 Hz: 3 و5 و6 و9 و10 و11: وهي الستة التي تحمل علامة التلدة على الطباعة الحريرية، وهي الستة نفسها كما على Uno.
SDA وSCL بجانب AREF هما A4 وA5، كما على Uno. مسار واحد وفتحتان.
لا يوجد لا INPUT_PULLDOWN على هذه الشريحة. طرف RA4M1 فيه مقاومة سحب لأعلى ولا شيء غيرها؛ وطلب سحب لأسفل يعطيك مدخلًا عائمًا عاديًا، وبيئة التشغيل تخبرك بذلك بدل التظاهر بخلافه.
محوّل ADC أربعة عشر بتًا وanalogRead يعطيك عشرة
محوّل RA4M1 أربعة عشر بتًا، من 0 إلى 16383. يُرجع analogRead عشرة (من 0 إلى 1023) لأن هذا ما تفعله نواة Arduino وما يتوقعه كل كود كُتب لأجل Uno: فعبارة analogRead(A0) > 512 يجب أن تعني الشيء نفسه على اللوحتين.
نادِ analogReadResolution(14) وستحصل على الأربعة عشر كلها. البرنامج المدمج تماثلي يطبع القيمتين من الطرف نفسه بفاصل نصف ثانية، ليظهر الفرق.
المدى الكامل هو خط 5 V وليس 3.3، ولهذا يعمل حساس كُتب لأجل Uno مباشرة بدون مقسّم جهد.
لا يوجد attachInterrupt
على RA4M1، يتم تحديد أي حدث من الملحقات يصل إلى أي مقاطعة عبر سجلات ربط الأحداث في ICU. لا يتم تمثيل ICU هنا، وأرقام أحداثه ليست شيئًا يستطيع هذا النموذج ذكره بصدق، فتُرك خارجًا بدل اختلاقه. لا شيء يطلق مقاطعة ملحقات؛ وSysTick، وهو استثناء نواة لا يحتاج إلى ربط، هو كل قصة المقاطعات هنا.
لذا يقوم الكود بالاستقصاء. بالنسبة لزر (وهذا ما عليه معظم أكواد attachInterrupt)، فهذا ما تفعله معظم الأكواد أصلًا، والبرنامج المدمج Button مكتوب على هذه الطريقة.
العمليات العشرية العائمة تعمل، وهي برمجية (soft float)
لدى RA4M1 الحقيقية وحدة FPU أحادية الدقة. أما النواة التي يعمل عليها هذا النموذج فلا، لذا بُنيت بيئة التشغيل لوضع soft float: عمليات float تعطي الإجابات الصحيحة وتُنفَّذ بتعليمات صحيحة. ملف ثنائي مبني في مكان آخر بواجهة hard-float يخطئ عند أول تعليمة VFP بدلًا من إرجاع رقم خاطئ.
مكتبات Arduino الرسمية
درس تعليمي يتضمن Servo.h و Wire.h و SPI.h و EEPROM.h و LiquidCrystal_I2C.h و Adafruit_GFX.h مع Adafruit_SSD1306.h و DHT.h يُترجم هنا كما هو. كل منها ملف ترويسة خاص بـ Mokxi بالاسم الأصلي، مبني على مشغّلات القطع في الصندوق، وليس أي منها كود المكتبة الأصلية.
- يضع
Wire.begin()ناقل I2C علىA4(SDA) وA5(SCL). - يعمل
EEPROM.h، لكن النموذج لا يحتوي على ذاكرة البيانات الخاصة بـRA4M1، لذا تسكن البايتات في 4 KB من RAM: تُقرأ مرة أخرى ضمن جلسة تشغيل واحدة وتضيع عند إعادة الضبط. - تقود مكتبة
Adafruit_NeoPixel.hشريط WS2812. يوقّت النواة كل بت عبر SysTick عند 48 MHz، داخل النوافذ الزمنية المحددة في ورقة البيانات، مع تعطيل المقاطعات أثناء إرسال الإطار.
يسرد محرر الكود والترجمة ما يغطيه كل منها وكيف يختلف عن المكتبة الأصلية.
The firmware
أربعة برامج مدمجة: Blink وButton والتسلسلي وتماثلي.
يُبنى عادة كود Uno من المصدر ليعمل على R4. أما ملف ELF المترجم لـ Uno فلن يعمل عليه: معمارية مختلفة، وخريطة مسجلات مختلفة، وجدول متجهات مختلف. ابنِه لـ R4 وسيعمل.
ما هو دقيق، وما ليس كذلك
بعض عناوين هذا النموذج مأخوذة من دليل مستخدم RA4M1، وبعضها اجتهاد من النموذج نفسه. هذا التمييز مكتوب بوضوح بدلاً من تجاهله: القسم 7 من الاتفاقية يسرد، واحدًا تلو الآخر، أي رقم هو أي.
وما هو تقريبي، في مقابل ما هو غير مُتحقَّق منه. تعمل النواة عند 48 MHz مهما تمت برمجة مسجلات الساعة عليه، لأن شجرة الساعة غير مُنمذجة. لا يحتوي ADC14 على أي خطأ: لا استبقاء للعينة، ولا لا-خطية، ولا ضجيج، ولا انزياح. الأطراف ثلاث حالات وعتبة واحدة، بلا تخلّف وبلا إعداد لقوة الدفع. خط 5 V مصدر مثالي لا يتراجع. وأنبوب Serial لا يمتلئ أبدًا، فالكود الذي قد يتعطل عند حد إطار USB على المنضدة لا ينتظر شيئًا هنا.
باختصار: النواة والساعة وخريطة الذاكرة ومسجلات المنافذ وPFS ومنفذ SCI وخريطة الأطراف كلها من الدليل. أما العنوان الأساسي لـ GPT وإزاحات مسجلاته، وإزاحات ADC14، ومسجلات USB، وقنوات المحول لـ A4 وA5، وأي قناة GPT تخص كل طرف PWM، فهي اجتهادية ومعلَّمة كغير مُتحقَّق منها. الساعة وmillis يتحقق منهما اختبار يشغّل البرنامج الثابت المرفق (crates/unor4/tests/runtime.rs)، لا مجرد ادعاء.
ما لم يُنمذج
طبقة USB فوق أنبوب البايتات. وحدة ICU، وبالتالي كل مقاطعات الملحقات. وAGT، ودارة توليد الساعة، وعدادات المراقبة، وI2C، وSPI، وCAN، وDTC، وRTC، وDAC، والمقارنات، ووحدة اللمس. الملفات الثنائية للمورّد (Renesas FSP ونواة Arduino R4) لا تعمل هنا؛ بيئة تشغيل البرنامج الثابت من عندنا. الدروع (Shields) ليست قطعاً فيزيائية هنا؛ وصّل الدائرة نفسها على لوحة التجارب.
Related
- صفحة اللوحة: /boards/uno-r4
- وثيقة الاتفاقية: نموذج Arduino Uno R4 Minima
- الشريحة نفسها مع مصفوفة وWiFi: Uno R4 WiFi
- اللوحة التي تحل محلها: Arduino Uno
- مشروع للمبتدئين: Uno R4 knob