UM3088
STM32Cube کمانڈ لائن ٹول سیٹ کوئیک اسٹارٹ گائیڈ
صارف دستی

تعارف

یہ دستاویز صارفین کے لیے STM32CubeCLT، STM32 MCUs کے لیے STMicroelectronics کمانڈ لائن ٹول سیٹ کے ساتھ تیزی سے شروع کرنے کے لیے ایک مختصر رہنما ہے۔
STM32CubeCLT تمام STM32CubeIDE سہولیات پیش کرتا ہے جو تھرڈ پارٹی IDEs کے ذریعے کمانڈ پرامپٹ استعمال کے لیے پیک کیا گیا ہے، یا مسلسل انضمام اور مسلسل ترقی (CD/CI)۔

ہموار سنگل STM32CubeCLT پیکیج میں شامل ہیں:

• سی ایل آئی (کمانڈ لائن انٹرفیس) ایس ٹی ٹولز کے ورژن جیسے ٹول چین، پروب کنکشن یوٹیلیٹی، اور فلیش میموری پروگرامنگ یوٹیلیٹی
• اپ ٹو ڈیٹ سسٹم view وضاحت کنندہ (SVD) files
• کوئی دوسرا IDE متعلقہ میٹا ڈیٹا STM32CubeCLT اجازت دیتا ہے:
• STM32 کے لیے بہتر GNU ٹول چین کا استعمال کرتے ہوئے STM32 MCU آلات کے لیے ایک پروگرام بنانا
• پروگرامنگ STM32 MCU اندرونی یادیں (فلیش میموری، RAM، OTP، اور دیگر) اور بیرونی یادیں
• پروگرامنگ کے مواد کی تصدیق کرنا (چیکسم، پروگرامنگ کے دوران اور بعد میں تصدیق، کے ساتھ موازنہ file)
• STM32 MCU پروگرامنگ کو خودکار کرنا
• STM32 MCU مصنوعات کے انٹرفیس کے ذریعے ایپلی کیشنز کو ڈیبگ کرنا، جو بنیادی ڈیبگ خصوصیات کا استعمال کرتے ہوئے MCU کے اندرونی وسائل تک رسائی فراہم کرتا ہے۔

عمومی معلومات

STM32 MCUs کے لیے STM32CubeCLT کمانڈ لائن ٹول سیٹ Arm® Cortex® ‑M پروسیسر پر مبنی STM32 مائیکرو کنٹرولرز کو نشانہ بنانے والی ایپلیکیشنز کو بنانے، پروگرام کرنے، چلانے اور ڈیبگ کرنے کے لیے ٹولز فراہم کرتا ہے۔
نوٹ:
آرم امریکہ اور/یا دوسری جگہوں پر آرم لمیٹڈ (یا اس کے ماتحت اداروں) کا رجسٹرڈ ٹریڈ مارک ہے۔

حوالہ دستاویزات

• STM32 MCUs (DB4839)، STM32CubeCLT ڈیٹا بریف کے لیے کمانڈ لائن ٹول سیٹ
• STM32CubeCLT انسٹالیشن گائیڈ (UM3089)
• STM32CubeCLT ریلیز نوٹ (RN0132)

اس دستاویز میں اسکرین شاٹس
سیکشن 2، سیکشن 3، اور سیکشن 4 میں فراہم کردہ اسکرین شاٹس صرف سابق ہیں۔ampکمانڈ پرامپٹ سے ٹول کے استعمال کی تفصیلات۔
فریق ثالث IDEs میں انضمام یا CD/CI اسکرپٹ میں استعمال کو اس دستاویز میں واضح نہیں کیا گیا ہے۔

عمارت

STM32CubeCLT پیکیج میں STM32 ٹول چین کے لیے GNU ٹولز شامل ہیں تاکہ STM32 مائیکرو کنٹرولر کے لیے ایک پروگرام بنایا جا سکے۔ ایک Windows® کنسول ونڈو example شکل 1 میں دکھایا گیا ہے۔

1. پروجیکٹ فولڈر میں کنسول کھولیں۔
2. پروجیکٹ بنانے کے لیے درج ذیل کمانڈ پر عمل کریں: > make -j8 all -C .\Debug

نوٹ: میک یوٹیلیٹی کو الگ انسٹالیشن مرحلہ درکار ہو سکتا ہے۔

بورڈ پروگرامنگ

STM32CubeCLT پیکیج STM32CubeProgrammer (STM32CubeProg) پر مشتمل ہے، جس کا استعمال ہدف STM32 مائیکرو کنٹرولر میں پہلے سے حاصل کردہ تعمیر کو پروگرام کرنے کے لیے کیا جاتا ہے۔

1. یقینی بنائیں کہ ST-LINK کنکشن کا پتہ چلا ہے۔
2. کنسول ونڈو میں پروجیکٹ فولڈر کا مقام منتخب کریں۔
3. اختیاری طور پر، تمام فلیش میموری مواد کو مٹا دیں (تصویر 2 دیکھیں): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -e all
4. پروگرام اپ لوڈ کریں۔ file 0x08000000 فلیش میموری ایڈریس (شکل 3 سے رجوع کریں): > STM32_Programmer_CLI.exe -c port=SWD freq=4000 -w .\Debug\YOUR_PROGRAM.elf 0x08000000

ڈیبگنگ

STM32 ٹول چین کے لیے GNU ٹولز کے علاوہ، 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. PowerShell® ونڈو میں GDB کلائنٹ شروع کرنے کے لیے STM32 ٹول چین کے لیے GNU ٹولز استعمال کریں:
   > arm-none-eabi-gdb.exe
   > (جی ڈی بی) ٹارگٹ ریموٹ لوکل ہوسٹ: پورٹ (جی ڈی بی سرور اوپن کنکشن میں اشارہ کردہ پورٹ استعمال کریں)
   کنکشن قائم ہو جاتا ہے اور GDB سرور سیشن کے پیغامات دکھائے جاتے ہیں جیسا کہ شکل 5 میں دکھایا گیا ہے۔ پھر ڈیبگ سیشن میں GDB کمانڈز کو چلانا ممکن ہے، مثال کے طور پر GDB: > (gdb) لوڈ YOUR_PROGRAM.elf کا استعمال کرتے ہوئے .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 - Rev 1 - فروری 2023
مزید معلومات کے لیے اپنے مقامی STMicroelectronics سیلز آفس سے رابطہ کریں۔
www.st.com
© 2023 STMicroelectronics – جملہ حقوق محفوظ ہیں۔

دستاویزات / وسائل

	• STM32Cube کمانڈ لائن ٹول سیٹ [پی ڈی ایف] یوزر مینوئل UM3088، STM32Cube کمانڈ لائن ٹول سیٹ، STM32Cube، کمانڈ لائن ٹول سیٹ، ٹول سیٹ
	• STM32Cube کمانڈ لائن ٹول سیٹ [پی ڈی ایف] مالک کا دستی RN0132، STM32Cube کمانڈ لائن ٹول سیٹ، STM32Cube، کمانڈ لائن ٹول سیٹ، لائن ٹول سیٹ، ٹول سیٹ

حوالہ جات

• صارف دستی