
لغة خاصة بالمجال لكتابة نماذج أجهزة وظيفية سريعة للمنصات الافتراضية. يقوم بترجمة DML إلى C مع استدعاءات API مخصصة لمحاكي Intel Simics، مما يتيح محاكاة الأجهزة واختبار الأمان.
لغة نمذجة الأجهزة (DML) هي لغة خاصة بمجال معين لكتابة نماذج أجهزة وظيفية أو على مستوى المعاملات سريعة للمنصات الافتراضية. توفر DML تجريدات عالية المستوى مناسبة لنماذج الأجهزة الوظيفية، بما في ذلك بنى مثل بنوك السجلات، والسجلات، وحقول البتات، ونشر الأحداث، والواجهات بين النماذج، والتسجيل. يتم تجميع كود DML بواسطة مترجم DML (DMLC)، مما ينتج كود C مع استدعاءات API مصممة خصيصًا لمحاكٍ معين.
حاليًا، يدعم المترجم بناء نماذج لمحاكي Intel® Simics®، ولكن قد تُضاف خلفيات أخرى في المستقبل.
لبناء DMLC، تحتاج إلى تثبيت محاكي Simics وإعداد مشروع Simics.
إذا لم يكن لديك بالفعل تثبيت لمحاكي Simics أو وصول إلى محاكي Simics عبر القنوات التجارية، فقم بتثبيت الإصدار العام من محاكي Intel Simics وأنشئ مشروع Simics (تلقائي في تدفق التثبيت الافتراضي).
يجب إعداد مشروع Simics الخاص بك لاستخدام python المضيف (عن طريق تمرير
--python إلى project-setup)، ويجب ألا يثبّت ply==3.4 في ملف
requirements.txt الخاص به.
في ذلك المشروع، اسحب مستودع DML إلى دليل modules/dmlc. ثم قم بتكوين CMake* (انظر استخدام CMake مع محاكي Intel
Simics)،
مع تمرير -DSIMICS_DMLC_DIR=<your-project>/<hosttype>/bin لضمان أن الأجهزة
التي تبنيها عبر CMake تستفيد من DMLC المحلي الخاص بك. بعد ذلك، يمكن بناء DMLC عبر
cmake --build bt --target dmlc.
لتشغيل اختبارات الوحدة المرفقة مع DMLC، شغّل
bin/test-runner --suite modules/dmlc/test من المستوى الأعلى للمشروع.
متغيرات البيئة التالية مفيدة عند تطوير DMLC. إذا كنت تعمل
بانتظام مع DMLC مبني محليًا، ففكر في تعيين المتغيرات
DMLC_DIR وT126_JOBS وDMLC_PATHSUBST وPY_SYMLINKS في ملف
.bashrc الخاص بك. من الأفضل تفعيل المتغيرات المتبقية فقط عند الحاجة.
بعد بناء DMLC، تحتاج إلى تعيين DMLC_DIR إلى <your-project>/<hosttype>/bin
في الاستدعاءات اللاحقة لـ make من أجل بناء الأجهزة باستخدام المترجم
المبني محليًا. <hosttype> إما linux64 أو win64 اعتمادًا على
نوع المضيف الخاص بك.
عند تعيينه، يتم تشغيل العدد المحدد من الاختبارات بالتوازي.
ينسخ بناء DMLC بعض ملفات مكتبة DML، مثل dml-builtins.dml، إلى
<hosttype>/bin. عندما يحدث خطأ في التجميع، ستشير رسائل الخطأ عادةً
إلى هذه النسخة بدلاً من المصدر. عن طريق تعيين DMLC_PATHSUBST إلى
<hosttype>/bin/dml=modules/dmlc/lib، ستُعاد كتابة رسائل الخطأ لتشير
إلى ملف المصدر بدلاً من ذلك. <hosttype> إما linux64 أو win64
اعتمادًا على نوع المضيف الخاص بك.
عند تعيينه إلى 1، سيقوم make dmlc بإنشاء روابط رمزية لملفات Python بدلاً من نسخها.
لهذا تأثيران: ستأخذك تتبعات Python إلى ملف المصدر
في المستودع، ولن تحتاج إلى إعادة تشغيل make بعد تحرير ملفات
Python.
عند تعيينه إلى 1، تُطبع الاستثناءات غير المتوقعة في المترجم إلى
stderr. الافتراضي هو إخفاء التتبعات في ملف dmlc-error.log.
تجاوز المترجم الافتراضي في اختبارات الوحدة.
عند تعيينه، يقوم DMLC بالتنميط الذاتي ويكتب الملف الشخصي إلى ملف .prof.
عند تعيينه، يُصدر DMLC أرشيفًا بصيغة .tar.bz2 يحتوي على جميع ملفات مصدر DML،
مُحزَّمة بصيغة يمكن تجميعها بشكل مستقل. يكون هذا مفيدًا عندما تظهر مشكلة DML
داخل بيئة بناء معقدة، وتريد إعادة إنتاج المشكلة بمعزل عن غيرها. في الأرشيف المُنشأ، توجد جميع ملفات DML في
الدليل نفسه (إما في المستوى الأعلى أو ضمن سلسلة من الأدلة الفرعية المسماة
_)، ويتم التعامل مع الاستيرادات النسبية عبر تضمين روابط رمزية أيضًا في
الأرشيف. على Windows، يعجز DMLC أحيانًا عن حل هذه الروابط الرمزية
بشكل صحيح؛ لهذا السبب، يُوصى باستخراج الأرشيف وتجميعه على Linux فقط.
عند تعيينه، يُخرج DMLC ملفًا ينتهي بـ -size-stats.json، يعرض إحصاءات
توليد الشيفرة المفيدة لتقليل حجم الشيفرة المُولَّدة وزيادة سرعة
التجميع. يسرد الملف مقدار شيفرة C المُولَّدة لكل طريقة DML. المخرجات
عبارة عن قائمة من الثلاثيات [tot_size, location, num]، حيث tot_size هو
إجمالي عدد بايتات شيفرة C المُولَّدة من تصريح طريقة واحد،
وnum هو عدد المرات التي وُلِّدت فيها شيفرة C من هذا التصريح (لأنه
وُسِّع بواسطة قالب)، وlocation هو موقع المصدر
للتصريح.
يمكن تقليل إدخال ذي tot_size كبير وnum كبير عبر تصريح
الطريقة كـ shared؛ إذ ينبغي أن يقسّم هذا الحجم تقريبًا على num. الإدخال
ذي tot_size كبير مع num يساوي 1 يعني عادةً أن الطريقة يهيمن عليها
تركيب مثل #foreach أو #select، ويمكن تقليله عبر فصل جسم الحلقة
إلى طريقة منفصلة، أو عبر إعادة صياغة الحلقة إلى
تركيب آخر مثل foreach.
لاحظ أن الإحصاءات تتضمن فقط الشيفرة المُولَّدة مباشرة من تصريحات الطرق؛ أما إجمالي حجم الشيفرة فيتضمن أكثر من ذلك بكثير. عادةً ما يساهم ميغابايت واحد من حجم الشيفرة الناتج عن تصريحات الطرق ببضع ثوانٍ من وقت التجميع.