مشروع واحد لكل لوحة
الجزء الأيمن ليس مجرد مربع نص، بل محطة عمل. تُبرمَج كل لوحة في المخطط على حدة ولها ملفات خاصة بها: كود، وأي ملفات ترويسة ومصادر إضافية تضيفها، تمامًا كما في مشروع حقيقي. منتقي اللوحات في الأعلى يحدد أي لوحة تنظر إليها؛ وتحته شريط ملفات فيه ألسنة وأزرار لإضافة ملف وإعادة تسميته وحذفه.
تنتقل الملفات مع المخطط. تُحفظ بجواره وفق معرّف اللوحة، وتُصدَّر وتُستورد معه، وتُحذف مع اللوحة.
المخطط الذي لا يحتوي على أي لوحة يظل فيه كود واحد، لذا يمكنك كتابة الكود قبل أن تقرر ما الذي سيشغّله. قد تحتوي أسماء الملفات على الحروف والأرقام و_ و. و-، وأي اسم ينتهي بـ .ino أو .c أو .cpp أو .cc أو .h أو .hpp أو .hh يظهر بتلوين C++.
إخفاء لوحة الكود
عندما تكون مساحة العمل والكود جنبًا إلى جنب، يقوم الزر في الطرف الأيمن من ترويسة لوحة الكود بطيّ الكود لتشغل مساحة العمل العرض كله. يبقى شريط كود رفيع عند الحافة اليمنى لمساحة العمل: اضغط عليه لإرجاع الكود بالعرض الذي كان عليه. ويقوم Ctrl+\ (Cmd+\ على Mac) بالأمرين، أينما كان التركيز، بما في ذلك الكود.
يتذكر متصفحك هذا الاختيار، فيبقى الكود مطويًا في المرة التالية التي تفتح فيها المحرر. أما في نافذة أضيق، حيث تكون مساحة العمل والكود مكدّسين، وعلى الهاتف، فتبقى لوحة الكود في مكانها.
ألسنة لغة التجميع
التبويب الذي ينتهي بـ .S أو .s هو لغة تجميع، ويتم بناؤه وربطه مع تبويبات .ino و.cpp للوحة نفسها، تمامًا كما يبني Arduino IDE ملفًا بجانب الكود. ملف .S يمر أولًا بالمعالج المسبق لـ C، لذا يعمل فيه #include <avr/io.h> و#define؛ أما .s فيُجمَّع كما هو مكتوب. تستدعي C والتجميع بعضهما عبر extern "C"، وتبويبات التجميع تحصل على تلوين خاص بها وعلى نفس شريط نقاط التوقف كالكود.
يمكن أن تكون اللوحة أيضًا مشروع لغة تجميع كاملًا بدون نواة Arduino: اختر قالبًا تحت لغة التجميع (بدون Arduino) في قسم البرنامج الثابت من خصائص اللوحة، على Uno أو Nano أو Pro Mini أو Pico أو STM32F411 Black Pill. يغطي كتابة لغة التجميع الحالتين معًا، واصطلاحات الاستدعاء، وavr/io.h في ملف .S، وasm volatile داخل الكود، ومعاني الأخطاء.
Writing code
تعمل لوحة الكود بالطريقة التي يعمل بها محرر أكواد سطح المكتب، وSublime Text على وجه الخصوص، والمفاتيح هي تلك التي يمدّها مستخدموه أيديهم إليها أصلًا. كل واحدة منها مدرجة في اختصارات لوحة المفاتيح.
- Completion as you type. The list offers the Arduino calls of the board
the files belong to (
pinMode,digitalWrite,analogRead,millis, the pin names), the C and C++ keywords, and the names the project already uses. After a dot it offers the object's methods:Serial.listsprint,println,availableand the rest, andlcd.lists what aLiquidCrystal_I2C lcd(...)declared in the file can do. After#include <it lists the libraries the board can compile. - أسماء تُترجم بنجاح فقط. تُقرأ القائمة من ملفات الترويسة التي يستخدمها المترجم نفسه لتلك اللوحة، لذا تعرض ESP32 التوابع
ledcAttachولا تعرضها Uno، وتظهر أصناف المكتبة بمجرد أن يضمّنها الملف. يُترجم اختبار كل اقتراح على كل لوحة. - Snippets.
setupwrites bothsetup()andloop();for,if,ifelse,else,switch,whileanddowrite the whole block.Tabmoves to the next blank to fill in. - عدة مؤشرات.
Ctrl/Cmd+Dيحدد الكلمة ثم تطابقها التالي، وAlt مع نقرة يضيف مؤشرًا، وAlt مع سحب يحدد عمودًا. - بحث واستبدال، بالتعبيرات النمطية، والانتقال إلى سطر، ومطابقة الأقواس وإغلاقها، والطي، وتبديل التعليق، وتكرار السطر ونقله، وEnter يزيد إزاحة السطر التالي ولا يترك مسافات زائدة في نهاية الأسطر.
- التنسيق التلقائي.
Ctrl/Cmd+T، كما في Arduino IDE، أوCtrl/Cmd+Shift+Fيعيد تنسيق الملف المفتوح بإزاحة مستوى كل مسافتين، ويترك النصوص والتعليقات كما هي. في نافذة المتصفح العادية يفتحCtrl/Cmd+Tعلامة تبويب جديدة بدلًا من ذلك، لذاCtrl/Cmd+Shift+Fهو الذي ينبغي حفظه. تفاصيل أكثر في اختصارات لوحة المفاتيح. - الأسطر الطويلة تلتف عند حافة اللوحة، تحت إزاحتها الخاصة، حتى لا يدفع تعليق طويل بداية الكود خارج النظر.
Alt+Zيوقف الالتفاف، والمحرر يتذكر اختيارك. على الهاتف تبقى الأسطر كاملة ويتحرك الكود جانبيًا بالحجم المناسب للملف. - أخطاء في الكود. بعد كل بناء، يُخط كل خطأ وتحذير أصدره المترجم في سطره. أشر إليه لقراءة الرسالة، أو اضغط
F8للانتقال إلى التالي، أوCtrl/Cmd+Shift+Mلعرض القائمة. البناء التالي يمسحها.
ماذا يحدث عند الضغط على «تشغيل»
تُطرح على كل لوحة سؤال واحد: هل يحتاج هذا إلى بناء؟ هناك ثلاثة أجوبة.
- تشغيل الصورة كما هي. ملف ELF مرفوع لم يُبنَ من هذه الملفات، ومثال مدمج لم يُمَس هو مبني بالفعل.
- إعادة استخدام آخر بناء. القرار يعتمد على بصمة كل اسم ملف وكل بايت فيه، لذا ضغطة مفتاح ثم تراجع تتركانك حيث كنت تمامًا.
- بناؤه. الترجمة، ثم تشغيل النتيجة.
البناء نفسه هو clang حقيقي وlld حقيقي، مُترجمان إلى WebAssembly ويعملان في Web Worker حتى لا يكلف بناء أول مدته أربع ثوانٍ مساحة العمل إطارًا واحدًا. لا يُرفع شيء، ولا يوجد خادم بناء ولا قائمة انتظار ولا دقائق بناء.
أول بناء، وكل بناء بعده
حجم سلسلة الأدوات نحو سبعين ميغابايت من clang، تُنقل مرة واحدة من مخزننا الخاص ثم تبقى في ذاكرة المتصفح المؤقتة. يستغرق البناء الأول في متصفح جديد بضع ثوان؛ والزيارة التالية نحو ثانية ونصف، والتعديل والتشغيل بعدها نحو خُمسي الثانية (0.2 ثانية) تقريبًا.
ويأتي معها وقت التشغيل: نسختنا الخاصة من C وC++ القائمة بذاتها لتلك العائلة من اللوحات، بنفس ملفات الترويسة وكود الإقلاع ونص الرابط والوسائط التي يستخدمها نص البناء في المستودع نفسه. لهذا يُترجم بنجاح أي كود يتضمن أحد المشغلات المشتركة على أي لوحة تتوفر عليها.
لغة Arduino، على كل لوحة
وقت التشغيل خاص بـ Mokxi، لكنه يتبع مرجع لغة Arduino: الكود المنسوخ من درس يستخدم هنا نفس النداءات التي يستخدمها على لوحة حقيقية.
- الفاصلة العائمة. عمليات
floatوdoubleتعمل في كل مكان، من مكتبة فاصلة عائمة برمجية في وقت التشغيل، كما على Uno حقيقية لا تحتوي شريحتها على عتاد فاصلة عائمة أيضًا.doubleحجمه 32 بت على لوحات AVR (Uno وNano وMega وLeonardo وATtiny85)، تمامًا كما في Arduino AVR core، و64 بت على البقية.Serial.print(x, 3)يطبع ثلاثة منازل عشرية. - The math library.
sqrt,pow,sin,cos,tan,atan2,log,exp,floor,roundand the rest ofmath.h, plusPI,radians(),degrees(),map()andconstrain(). Include<math.h>or not; either works. - String. Arduino's
Stringclass:+and+=,indexOf,substring,toInt,toFloat,trim,replaceand the rest. Its text lives on the heap, which on an Uno is whatever of its 2 KB the sketch leaves free, so building long Strings in a loop runs out here as it does on the bench. - قراءة المنفذ التسلسلي.
parseIntوparseFloatوreadStringوreadStringUntilوreadBytesوfindوsetTimeout، وتُستدعى دالةserialEvent()بين تكراراتloop()عند وصول مدخلات. - قياس نبضة. تعيد
pulseInوpulseInLongطول النبضة بالميكروثانية، و0 عند انتهاء المهلة، وهكذا تُقرأ HC-SR04. أماshiftInوshiftOutفتُدخلان بايت أو تُخرجانه بتوقيت الساعة. - الصوت.
tone(pin, frequency)وtone(pin, frequency, duration)يشغّلان موجة مربعة من مقاطعة مؤقت دون إيقاف الكود، وnoTone(pin)يوقفها. على Uno يستخدم المؤقت 2، تمامًا كما في Arduino core، لذا يتوقف PWM على الطرفين 3 و11 أثناء تشغيل النغمة. وعلى XIAO وUno R4 تُشغَّل النغمة على أطراف PWM.#include "pitches.h"يمنحك أسماءNOTE_. - مكتبة C.
sprintf، وsnprintf، وatoi، وatof، وstrtol، وstrcpy، وstrcmp، وstrtok، وdtostrf، وitoa، وmallocوما شابهها. كما هو الحال في لوحة Uno حقيقية،%fفيsprintfيطبع?على لوحات AVR؛ استخدمdtostrfهناك. - المحارف.
isDigitوisAlphaوisSpaceوisUpperCaseوغيرها. std::atomic.#include <atomic>يعمل على كل لوحة يتوفر في Arduino core الحقيقي لديها: لوحات ESP32 وESP8266 ولوحات RP2040 ولوحات STM32 وUno R4 وXIAO SAMD21 وmicro:bit.load,store,fetch_add,compare_exchange,atomic_flagوتعمل الحواجز كلها. أما core لوحات AVR فلا يحتوي<atomic>، لذا على Uno أو Nano أو Mega أو Leonardo أو ATtiny85 يتوقف البناء، كما في Arduino IDE، مع سطر يوضح ما الذي يُستخدم بدلًا منه: متغيرvolatileمعnoInterrupts()وinterrupts()حول الكود الذي يلمسه.ATOMIC_BLOCKمن<util/atomic.h>يعمل على لوحات AVR أيضًا.
يحتوي ATtiny85 على 8 KB من ذاكرة flash ولا تصل نداءاته إلا إلى 4 KB، لذا فإن كودًا يجلب مكتبة الرياضيات أو كثيرًا من عمليات الفاصلة العائمة يكون غالبًا أكبر من طاقته، هنا كما على المنضدة.
Arduino libraries that compile as they are
الصق درسًا تعليميًا وستعمل تضميناته: وقت التشغيل يحمل المكتبات الشائعة التي يستخدمها الناس أكثر من غيرها، بأسمائها المعتادة. كل واحدة منها ملف ترويسة خاص بـ Mokxi، مكتوب فوق المشغّلات الخاصة بالقطع في الصندوق؛ ولا شيء منها هو كود المكتبة الأصلية، وكل واحدة تحتفظ بالنداءات التي تستخدمها الدروس التعليمية.
الجدول يضم القليل الذي تلجأ إليه الدروس التعليمية أكثر من غيره، وليس القائمة كاملة. اكتب #include < في المحرر لترى كل مكتبة يمكن للوحة التي تعمل عليها ترجمتها.
| الترويسة | ما الذي تشغّله | اللوحات |
|---|---|---|
Servo.h، ESP32Servo.h |
محرك سيرفو هواية على أي طرف | كل لوحة يمكن ترجمتها |
Wire.h |
I2C كجهاز رئيسي (master)، على أطراف I2C الخاصة باللوحة أو على أي طرفين | كل لوحة يمكن ترجمتها |
SPI.h |
SPI على أطراف SPI الخاصة باللوحة | كل لوحة يمكن ترجمتها |
EEPROM.h |
read، write، update، get، put، EEPROM[i] |
كل لوحة يمكن ترجمتها |
LiquidCrystal_I2C.h |
the 16x2 LCD behind its I2C backpack | كل لوحة يمكن ترجمتها |
Adafruit_GFX.h، Adafruit_SSD1306.h |
شاشة OLED بالمنفذ I2C بدقة 128x64 | كل اللوحات عدا ATtiny85 |
Adafruit_NeoPixel.h |
WS2812 strips and panels | لوحات AVR وعائلة ESP32 وPico وUno R4 |
DHT.h |
حساسا DHT11 وDHT22 | كل لوحة يمكن ترجمتها |
OneWire.h، DallasTemperature.h |
مقاييس حرارة DS18B20، أي عدد منها على طرف واحد | كل اللوحات عدا ATtiny85 |
Adafruit_BME280.h، Adafruit_BMP280.h، SparkFunBME280.h |
حساسات الضغط من Bosch | كل اللوحات عدا ATtiny85 |
RTClib.h |
ساعتا DS3231 وDS1307، وDateTime وTimeSpan |
كل اللوحات عدا ATtiny85 |
Adafruit_INA219.h |
مراقب التيار INA219 | كل اللوحات عدا ATtiny85 |
Adafruit_ADS1X15.h |
المحوّل التناظري إلى رقمي ADS1115 بدقة ست عشرية | كل اللوحات عدا ATtiny85 |
Adafruit_MCP23X17.h |
موسّع المنافذ MCP23017 | كل اللوحات عدا ATtiny85 |
SoftwareSerial.h |
منفذ تسلسلي على طرفين عاديين، لجهاز HC-05 أو مستقبل GPS | Uno، Nano، Pro Mini، Mega، Leonardo، Pro Micro، ESP8266، ESP32، ESP32-S3 |
TinyGPS++.h |
رسائل NMEA من مستقبل GPS من نوع NEO-6M | مجرّب على Uno وMega وNodeMCU |
أما الفروق عن المكتبات الأصلية، التي تشرحها صفحة المساعدة الخاصة بكل قطعة:
- يرسل محرك سيرفو نبضة واحدة عند كل
write()بدلًا من النبض من مؤقّت. عرضا نبضاته هما نفس قيم المكتبة الأصلية:attach(pin)من 544 إلى 2400 ميكروثانية، وwrite(90)تساوي 1472، وattach(pin, min, max)يحدّد نطاقًا آخر. القيمتان الافتراضيتان لقطعة السيرفو هما نفس النطاق من 544 إلى 2400. - EEPROM هو ذاكرة EEPROM الخاصة بالشريحة على Uno وNano وMega وLeonardo وATtiny85، و4 كيلوبايت من الذاكرة RAM على كل لوحة أخرى، إذ لا تحتوي نماذجها على شيء قابل للكتابة ينجو من إعادة التشغيل. وكل تشغيل جديد بـ«تشغيل» يبدأ بذاكرة ممسوحة في الحالتين.
- خط الشاشة في شاشات Adafruit GFX هو خط Mokxi الخاص بحجم 5x8، مع الحروف الصغيرة، داخل خانة 6x8 كما في المكتبة الأصلية.
setFont()يرسم خطًا يحمله الكود كما هو بالضبط، وترويساتFonts/هي حروف Mokxi بحجم كل خط، وليست خطوط GNU FreeFont. - يعيد DHT أعدادًا عشرية (floats) مبنية من أجزاء العشرة الكاملة التي يقرؤها الحساس. تُطبع، و
isnanوcomputeHeatIndexيعملان، وكذلك أي حساب تكتبه أنت عليها. - سلك يعمل كطرف رئيسي (master) فقط، ومنفّذ برمجيًا بالنبضات، مثل كل النواقل هنا.
- يعمل SoftwareSerial على لوحات AVR كما في مكتبة Arduino: مقاطعة تغيّر الطرف وحلقات معدودة، منفذ واحد يستمع في كل مرة، نصف مزدوج (half duplex)، وذاكرة وسيطة مشتركة بسعة 64 بايت. يحتاج الاستلام إلى طرف عليه مقاطعة تغيّر الطرف، وهي على Mega الأطراف من 10 إلى 15 ومن 50 إلى 53 وA8 إلى A15. أما على ESP8266 وESP32 وESP32-S3 فهو بطريقة EspSoftwareSerial: حوافّ مقيسة عبر مقاطعة، فيستلم عدة منافذ في وقت واحد. بتنسيق 8N1 فقط. وكل لوحة أخرى تخبرك بذلك وقت الترجمة.
- مكتبات الحساسات تعيد أعدادًا عشرية كما يفعل DHT، مبنية من عدّادات الشرائح نفسها.
DEVICE_DISCONNECTED_Cيقارن مع قراءة كما تفعل الدروس التعليمية، وreadPressure() / 100.0Fفي دروس الضغط تعمل كما هي مكتوبة؛ وreadPressureHPa()موجودة كذلك.
تذكر مقالة المساعدة لكل لوحة أي أطراف يستخدمها Wire.begin() عليها.
إضافة مكتبة
تتولى ثلاثة أشرطة تحت الكود أمر المكتبات، وإضافة واحدة مجاني في كل الباقات:
- يعرض المكتبات مكتبات المشروع نفسه، ولكل منها زر إزالة. + إضافة مكتبة يقبل ملف
.zipبتنسيق Arduino، أو ملفات.hو.cppمتفرقة، ويخبرك بأي الملفات أبقاها وأيها تجاوز، مثل الأمثلة. - مدير مكتبات Arduino: كل المكتبات بلمسة واحدة. اضغط بحث واكتب اسمًا أو ترويسة أو كلمة عنها. لكل نتيجة زر تثبيت يجلبها مع المكتبات التي تعتمد عليها. المكتبة التي يبنيها Mokxi أصلًا تظهر بعبارة مدمجة، والتي في المشروع تظهر بعبارة مثبّتة، والتي لا تدعم اللوحة التي تحررها تُثبَّت مع تنبيه.
- المكتبات المدمجة. اضغط استعراض للبحث في المكتبات التي يحملها Mokxi، مع خيار هذه اللوحة فقط للاحتفاظ بما يُبنى على اللوحة التي تعمل عليها. إضافة #include يضع ترويسة المكتبة أعلى الملف المفتوح (أو يخبرك أنها موجودة أصلًا)، والتفاصيل يعرض ترويساتها وفتح مثال.
الكود الذي يضمّن مكتبة لا يملكها المشروع يتوقف عند رسالة clang file not found. عندها تذكر لوحة البناء ترويسة Mokxi التي تؤدي نفس المهمة، أو تعرض تثبيت للمكتبة من مدير مكتبات Arduino، فيضعها في المشروع ويبني من جديد.
Python على Pico وESP32 وRaspberry Pi
يمكن لهذه اللوحات تشغيل Python بدل الكود. الاختيار يكون من قائمة البرنامج في قسم البرنامج الثابت من خصائص اللوحة:
- Raspberry Pi Pico. اختر MicroPython (main.py) واكتب
main.py. زر «تشغيل» يقلع بالبرنامج الثابت الرسمي MicroPython على الشريحة المحاكاة وينسخ ملفات.pyعليها، بالطريقة نفسها التي يفعلها Thonny.print()يظهر في الشاشة التسلسلية. ويفعل Pico W الشيء نفسه بنسخته الخاصة، معnetwork.WLANعلى الشبكة المحاكاة. راجع لوحة Pico و لوحة Pico W. - لوحات ESP32. الاختيار نفسه يشغّل البرنامج الثابت الرسمي بلغة MicroPython للشريحة، مع
network.WLANعلى الشبكة المحاكاة، على ESP32 الكلاسيكية (DevKit V1 وDevKitC وLOLIN32 Lite)، وESP32-S3 (مع XIAO ESP32-S3 وNano ESP32)، وESP32-C3 (مع XIAO ESP32-C3 وSuperMini) وESP32-C6 (مع XIAO ESP32-C6). لا توجد MicroPython لـ ESP8266 هنا. راجع MicroPython على ESP32. - CircuitPython على Pico وPico W وArduino Nano RP2040 Connect وESP32-S3. اختر CircuitPython (code.py) واكتب
code.py. زر «تشغيل» يقلع بالبرنامج الثابت الرسمي لـ CircuitPython ويحفظcode.pyعلى محرّك CIRCUITPY الخاص باللوحة، مع مكتبات Adafruit التي يستوردها. راجع CircuitPython على Pico. - Raspberry Pi 4 وPi 5 وZero 2 W. تحصل اللوحة على
main.py، ويبدأ «تشغيل» تشغيلها معgpiozeroوRPi.GPIOيقود الأطراف. لا يوجد نظام Linux تحته. راجع لوحة Raspberry Pi.
تبويب البناء
تحت شريط الملفات. يبقى بعيدًا عن الطريق حتى يكون لديه ما يقوله، ثم يعرض ثلاثة أشياء: الخطوات مع أزمنتها، بحيث يُقرأ البناء الأول البطيء كتقدّم لا كتوقّف؛ وتشخيصات المترجم على هيئة أسطر يمكنك النقر عليها للوصول إلى الملف والسطر والعمود الذي يشير إليها؛ وجملة واحدة واضحة في النهاية، مثل Built esp1.elf, 1.5 KB, 0.21 s.
كل لوحة، سلسلة أدوات واحدة
تُترجَم كل لوحة في المتصفح على سلسلة أدوات clang نفسها، كل واحدة لشريحتها الخاصة: لوحات AVR من أردوينو مثل Uno (avr -mmcu=atmega328p)، ولوحات RISC-V من ESP32 مثل ESP32-C3 (riscv32 -march=rv32imc)، ولوحات Arm مثل Pico (thumbv6m، Cortex-M0+) وSTM32F411 (thumbv7em، Cortex-M4، soft float). تعرض صفحة اللوحات كل واحدة منها.
التفاصيل الكاملة، وصولًا إلى قائمة الأوامر ومفاتيح الذاكرة المؤقتة، موجودة في الترجمة في المتصفح.
إذا فشل البناء، فإن الكود لا تتم ترجمته يشرح لك خطوة بخطوة ما يخبرك به تبويب البناء.