UM3088
دليل البدء السريع لمجموعة أدوات سطر الأوامر STM32Cube
دليل المستخدم

مقدمة

هذا المستند عبارة عن دليل موجز للمستخدمين لبدء استخدام STM32CubeCLT بسرعة ، وهي مجموعة أدوات سطر أوامر STMicroelectronics لوحدات MCU الخاصة بـ STM32.
تقدم STM32CubeCLT جميع مرافق STM32CubeIDE التي تم تجميعها لاستخدام موجه الأوامر بواسطة IDEs لجهات خارجية ، أو التكامل المستمر والتطوير المستمر (CD / CI).

تتضمن حزمة STM32CubeCLT الفردية المبسطة ما يلي:

• إصدارات CLI (واجهة سطر الأوامر) من أدوات ST مثل toolchain ، أداة توصيل التحقيق ، وأداة برمجة ذاكرة فلاش
• نظام حديث view واصف (SVD) files
• تتيح أي بيانات وصفية أخرى ذات صلة بـ IDE: STM32CubeCLT:
• بناء برنامج لأجهزة STM32 MCU باستخدام سلسلة أدوات GNU المحسنة لـ STM32
• برمجة الذاكرة الداخلية STM32 MCU (ذاكرة فلاش ، ذاكرة الوصول العشوائي ، OTP وغيرها) وذاكرات خارجية
• التحقق من محتوى البرمجة (المجموع الاختباري ، التحقق أثناء البرمجة وبعدها ، المقارنة مع file)
• أتمتة برمجة STM32 MCU
• تصحيح أخطاء التطبيقات من خلال واجهة منتجات STM32 MCU ، والتي توفر الوصول إلى موارد MCU الداخلية باستخدام ميزات التصحيح الأساسية

معلومات عامة

توفر مجموعة أدوات سطر الأوامر STM32CubeCLT لـ STM32 MCU أدوات لإنشاء التطبيقات وبرمجتها وتشغيلها وتصحيحها التي تستهدف المتحكمات الدقيقة STM32 استنادًا إلى معالج Arm® Cortex® ‑M.
ملحوظة:
Arm هي علامة تجارية مسجلة لشركة Arm Limited (أو الشركات التابعة لها) في الولايات المتحدة و / أو في أي مكان آخر.

وثائق مرجعية

• مجموعة أدوات سطر الأوامر لـ STM32 MCUs (DB4839) ، موجز بيانات STM32CubeCLT
• دليل تثبيت STM32CubeCLT (UM3089)
• ملاحظة إصدار STM32CubeCLT (RN0132)

لقطات الشاشة في هذا المستند
لقطات الشاشة الواردة في القسم 2 ، القسم 3 ، والقسم 4 هي أمثلة فقطampليه من استخدام الأداة من موجه الأوامر.
لم يتم توضيح التكامل في IDEs لجهة خارجية أو الاستخدام في البرامج النصية CD / CI في هذا المستند.

مبنى

تحتوي حزمة STM32CubeCLT على أدوات جنو لسلسلة أدوات STM32 لبناء برنامج لوحدة تحكم دقيقة STM32. نافذة وحدة تحكم Windows® على سبيل المثالampيظهر le في الشكل 1.

1. افتح وحدة التحكم في مجلد المشروع.
2. نفّذ الأمر التالي لإنشاء المشروع:> make -j8 all -C. \ Debug

ملحوظة: قد تتطلب الأداة المساعدة إجراء خطوة تثبيت منفصلة.

برمجة المجلس

تحتوي حزمة STM32CubeCLT على STM32CubeProgmer (STM32CubeProg) ، والذي يستخدم لبرمجة البنية التي تم الحصول عليها مسبقًا في وحدة التحكم الدقيقة STM32 المستهدفة.

1. تأكد من اكتشاف اتصال ST-LINK
2. حدد موقع مجلد المشروع في نافذة وحدة التحكم
3. اختياريًا ، امسح كل محتويات ذاكرة الفلاش (راجع الشكل 2):> منفذ STM32_Programmer_CLI.exe -c = SWD freq = 4000 -e all
4. قم بتحميل البرنامج file إلى عنوان ذاكرة فلاش 0x08000000 (راجع الشكل 3):> STM32_Programmer_CLI.exe -c port = SWD freq = 4000 -w. \ Debug \ YOUR_PROGRAM.elf 0x08000000

تصحيح الأخطاء

بالإضافة إلى أدوات GNU لسلسلة أدوات STM32 ، تحتوي حزمة STM32CubeCLT أيضًا على خادم ST-LINK GDB. كلاهما مطلوب لبدء جلسة تصحيح الأخطاء.

1. ابدأ خادم ST-LINK GDB في نافذة Windows® PowerShell® أخرى (راجع الشكل 4):> ST-LINK_gdbserver.exe -d -v -t -cp C: \ ST \ STM32CubeCLT \ STM32CubeProgrammer \ bin
2. استخدم أدوات GNU لسلسلة أدوات STM32 لبدء عميل GDB في نافذة PowerShell®:
   > arm-none-eabi-gdb.exe
   > (gdb) الهدف المضيف المحلي البعيد: المنفذ (استخدم المنفذ المشار إليه في اتصال خادم GDB المفتوح)
   يتم إنشاء الاتصال ويتم عرض رسائل جلسة خادم GDB كما هو موضح في الشكل 5. ومن الممكن بعد ذلك تشغيل أوامر GDB في جلسة التصحيح ، على سبيل المثال لإعادة تحميل برنامج .elf باستخدام GDB:> (gdb) تحميل YOUR_PROGRAM.elf

تاريخ المراجعة

الجدول 1. تاريخ مراجعة الوثيقة

تاريخ	المراجعة	التغييرات
16-فبراير-23	1	الإصدار الأولي.

إشعار هام – اقرأ بعناية
تحتفظ شركة STMicroelectronics NV والشركات التابعة لها ("ST") بالحق في إجراء تغييرات وتصحيحات وتعزيزات وتعديلات وتحسينات على منتجات ST و/أو هذه الوثيقة في أي وقت دون إشعار. يجب على المشترين الحصول على أحدث المعلومات ذات الصلة بمنتجات ST قبل تقديم الطلبات. تُباع منتجات ST وفقًا لشروط وأحكام البيع الخاصة بشركة ST السارية وقت إقرار الطلب.
يعتبر المشترون مسؤولين بشكل كامل عن اختيار منتجات ST واختيارها واستخدامها، ولا تتحمل شركة ST أي مسؤولية عن مساعدة التطبيق أو تصميم منتجات المشترين.
لا يتم منح أي ترخيص، صريحًا أو ضمنيًا، لأي حق من حقوق الملكية الفكرية من قبل شركة ST هنا.
إن إعادة بيع منتجات ST بأحكام مختلفة عن المعلومات الواردة هنا يؤدي إلى إبطال أي ضمان تمنحه شركة ST لهذا المنتج.
ST وشعار ST هما علامتان تجاريتان لشركة ST. لمزيد من المعلومات حول العلامات التجارية لشركة ST، راجع www.st.com/trademarks. جميع أسماء المنتجات أو الخدمات الأخرى هي ملك لأصحابها.
تحل المعلومات الواردة في هذه الوثيقة محل المعلومات المقدمة مسبقًا في أي إصدارات سابقة من هذه الوثيقة.

UM3088 - المراجعة 1 - فبراير 2023
لمزيد من المعلومات ، اتصل بمكتب مبيعات STMicroelectronics المحلي.
www.st.com
© 2023 STMicroelectronics – جميع الحقوق محفوظة

المستندات / الموارد

	مجموعة أدوات سطر أوامر ST STM32Cube [بي دي اف] دليل المستخدم UM3088 ، مجموعة أدوات سطر أوامر STM32Cube ، STM32Cube ، مجموعة أدوات سطر الأوامر ، مجموعة الأدوات
	مجموعة أدوات سطر أوامر ST STM32Cube [بي دي اف] دليل المالك RN0132، مجموعة أدوات سطر الأوامر STM32Cube، STM32Cube، مجموعة أدوات سطر الأوامر، مجموعة أدوات السطر، مجموعة أدوات

مراجع

• دليل المستخدم