STMicroelectronics UM3469 X-CUBE-ISO1 سافٹ ویئر کی توسیع
تعارف
STM32Cube کے لیے X-CUBE-ISO1 توسیعی سافٹ ویئر پیکج STM32 پر چلتا ہے اور اس میں X-NUCLEO-ISO1A1 کے لیے فرم ویئر شامل ہے۔ سافٹ ویئر X-NUCLEO کی طرف سے فراہم کردہ بنیادی PLC ڈیوائس کی ترقی کے لیے استعمال میں آسان حل فراہم کرتا ہے۔ یہ توسیع STM32Cube سافٹ ویئر ٹیکنالوجی پر بنائی گئی ہے تاکہ مختلف STM32 مائیکرو کنٹرولرز میں پورٹیبلٹی کو آسان بنایا جا سکے۔
یہ سافٹ ویئر NUCLEO-G071RB ڈویلپمنٹ بورڈ (یا یا تو NUCLEO-G0B1RE یا NUCLEO-G070RB) سے منسلک X-NUCLEO-ISO1A1 توسیعی بورڈ پر عمل درآمد کے ساتھ آتا ہے۔ اب سے، دستاویز میں سادگی کے لیے صرف NUCLEO-G071RB کا ذکر کیا جائے گا۔
X-NUCLEO-ISO1A1 بورڈ ان پٹ اور آؤٹ پٹ کی صلاحیتوں کو بڑھانے کے لیے مناسب جمپر سیٹنگز کے ساتھ دو بورڈز کے اسٹیکنگ کو سپورٹ کرنے کے لیے ڈیزائن کیا گیا ہے۔
مخففات اور مخففات
جدول 1۔ مخففات کی فہرست
| مخفف | تفصیل |
| پی ایل سی | قابل پروگرام منطق کنٹرولر |
| API | ایپلیکیشن پروگرامنگ انٹرفیس |
| پی ڈبلیو ایم | نبض کی چوڑائی ماڈیولیشن |
| جی پی آئی او | عام مقصد کا ان پٹ/آؤٹ پٹ۔ |
| ایچ اے ایل | ہارڈ ویئر تجریدی پرت |
| PC | پرسنل کمپیوٹر |
| FW | فرم ویئر |
STM32Cube کیا ہے؟
STM32Cube™ STMicroelectronics پہل کی نمائندگی کرتا ہے تاکہ ترقیاتی کوششوں، وقت اور لاگت کو کم کر کے ڈویلپرز کی زندگیوں کو آسان بنایا جا سکے۔ STM32Cube STM32 پورٹ فولیو کا احاطہ کرتا ہے۔
STM32Cube ورژن 1.x میں شامل ہیں:
- STM32CubeMX، ایک گرافیکل سافٹ ویئر کنفیگریشن ٹول جو گرافیکل وزرڈز کا استعمال کرتے ہوئے C انیشیلائزیشن کوڈ بنانے کی اجازت دیتا ہے۔
- ہر سیریز کے لیے مخصوص ایک جامع ایمبیڈڈ سافٹ ویئر پلیٹ فارم (جیسے STM32G0 سیریز کے لیے STM32CubeG0)، جس میں شامل ہیں:
- STM32Cube HAL ایمبیڈڈ ایبسٹریکشن لیئر سافٹ ویئر، STM32 پورٹ فولیو میں زیادہ سے زیادہ پورٹیبلٹی کو یقینی بناتا ہے۔
- مڈل ویئر کے اجزاء کا ایک مستقل سیٹ جیسے RTOS، USB، TCP/IP، اور گرافکس
- سابق کے مکمل سیٹ کے ساتھ تمام ایمبیڈڈ سافٹ ویئر یوٹیلیٹیزamples
STM32Cube فن تعمیر
STM32Cube فرم ویئر سلوشن تین آزاد سطحوں کے ارد گرد بنایا گیا ہے جو ایک دوسرے کے ساتھ آسانی سے تعامل کر سکتے ہیں، جیسا کہ نیچے دی گئی تصویر میں بیان کیا گیا ہے۔
STM32Cube کے لیے X-CUBE-ISO1 سافٹ ویئر کی توسیع
ختمview
X-NUCLEO-ISO1A1 کے لیے فرم ویئر، صنعتی الگ تھلگ ان پٹ/آؤٹ پٹ توسیعی بورڈ، جو STM32 ماحول اور لائبریریوں کے ارد گرد تیار کیا گیا ہے، ڈیجیٹل ان پٹس، مربوط تشخیص کے ساتھ آؤٹ پٹس کے ساتھ PWM کرنٹ جنریشن کی حد اور ڈائنامک کرنٹ جنریشن کے انتظام کے لیے STM32 نیوکلیو بورڈز کے اعلیٰ کارکردگی والے MCU کا فائدہ اٹھاتا ہے۔ اس میں بورڈ کی جامع ترتیب اور کنٹرول شامل ہے، جس میں پہلے سے طے شدہ اور متبادل حالات کے لیے فریم ورک، پری اسکیلر اقدار کو ترتیب دینے کے لیے میکرو، اور GPIO پورٹس اور پنوں کی تعریفیں شامل ہیں۔
یہ مختلف ایس کی حمایت کرتا ہے۔ample ایپلیکیشن کے استعمال کے معاملات جیسے ڈیجیٹل ان پٹ ٹو آؤٹ پٹ مررنگ، نیوکلیو بورڈ کے ذریعے UART کمیونیکیشن، فالٹ ڈٹیکشن، ٹیسٹ کیسز، اور PWM جنریشن جو براہ راست استعمال کیے جا سکتے ہیں اور آسانی سے اپنی مرضی کے مطابق اور بڑھا سکتے ہیں۔
API ڈیجیٹل ان پٹ/آؤٹ پٹ کنٹرول، فالٹ ڈٹیکشن، اور بورڈ اسٹیٹس اپ ڈیٹس کے لیے فنکشنز کا ایک مضبوط سیٹ فراہم کرتا ہے، جس میں مختلف موڈز میں بیک وقت دو بورڈز چلانے کے لیے کنفیگریشن سیٹنگز ہیں۔ ڈیجیٹل آؤٹ پٹ چینلز کے لیے PWM سگنلز کو شروع کرنے، شروع کرنے، روکنے اور ترتیب دینے کے لیے مخصوص API فنکشنز دستیاب ہیں۔
بورڈ سپورٹ پیکج میں IPS1025H-32 کے ساتھ انٹرفیس والے GPIO پنوں کو کنٹرول اور مانیٹر کرنے کے فنکشنز شامل ہیں اور ڈیجیٹل الگ تھلگ کے ذریعے CLT03-2Q3 کے ساتھ انٹرفیس کردہ GPIO پنوں کی حالت کو پڑھیں۔
ترتیب اور ابتداء STM32CubeMX پر مبنی ہے، جس میں STM32CubeIDE، IAR سسٹمز، اور Keil® ٹولز کے ذریعے ترقی اور ڈیبگنگ کی حمایت کی گئی ہے۔
فن تعمیر
X-NUCLEO-ISO1A1 کے فرم ویئر کو کئی مختلف فنکشنل بلاکس میں تقسیم کیا جا سکتا ہے، ہر ایک سسٹم کے آپریشنز کے مختلف پہلوؤں کے لیے ذمہ دار ہے:
- بورڈ کی ترتیب اور کنٹرول:
- board_config.h file بورڈ کو پہلے سے طے شدہ یا متبادل حالات، یا دونوں میں چلانے کے لیے ترتیب دینے کے لیے میکرو پر مشتمل ہے۔ اس میں پری اسکیلر ویلیوز اور GPIO پورٹس اور پنوں کی تعریفیں بھی شامل ہیں۔
- یہ بلاک اس بات کو یقینی بناتا ہے کہ بورڈ مطلوبہ آپریٹنگ حالات کے لیے درست طریقے سے ترتیب دیا گیا ہے اور تمام ضروری ہارڈویئر کنفیگریشنز اپنی جگہ پر ہیں۔
- درخواست کے استعمال کے معاملات:
- st_iso_app.h اور st_iso_app.c files میں بورڈ کے مختلف فنکشنلٹیز کو جانچنے کے لیے ڈیزائن کردہ ایپلیکیشن استعمال کے کیسز شامل ہیں۔
- ان استعمال کے معاملات میں ڈیجیٹل ان پٹ ٹو آؤٹ پٹ مررنگ، فالٹ ڈیٹیکشن ٹیسٹ، اور PWM سگنل جنریشن شامل ہیں۔
- Exampدو بورڈز کو بیک وقت مختلف طریقوں میں چلانے کے لیے لی کنفیگریشنز فراہم کی جاتی ہیں، جو فرم ویئر کی استعداد اور لچک کو ظاہر کرتی ہیں۔
- API افعال:
- iso1a1.h اور iso1a1.c files مختلف افعال کو سپورٹ کرنے کے لیے APIs کا ایک جامع سیٹ فراہم کرتا ہے۔
- ان APIs میں ڈیجیٹل ان پٹ/آؤٹ پٹ کنٹرول، فالٹ ڈیٹیکشن، اور بورڈ اسٹیٹس اپ ڈیٹس کے فنکشنز شامل ہیں۔
- APIs کو سادہ اور بدیہی بنانے کے لیے ڈیزائن کیا گیا ہے، جس سے صارفین کے لیے بورڈ کے ساتھ بات چیت کرنا اور ضروری کارروائیاں کرنا آسان ہو جاتا ہے۔
- PWM سگنل کنٹرول:
- pwm_api.h اور pwm_api.c files PWM سگنل جنریشن سے متعلق مخصوص API افعال پر مشتمل ہے۔
- یہ فنکشنز ڈیجیٹل آؤٹ پٹ چینلز کے لیے PWM سگنلز کو شروع کرنے، ترتیب دینے، شروع کرنے اور روکنے کی اجازت دیتے ہیں۔
- PWM فعالیت پہلے سے طے شدہ انتخاب نہیں ہے۔ ان کو فعال کرنے کے لیے بورڈ کی ترتیب میں ترمیم کی گئی ہے۔ مزید تفصیلات کے لیے سیکشن 3.5: APIs سے رجوع کریں۔
- بورڈ سپورٹ پیکیج:
- بورڈ سپورٹ پیکج میں شامل ہے۔ fileIPS1025H-32 کے ساتھ انٹرفیس والے GPIO پنوں کو کنٹرول کرنے اور ان کی نگرانی کرنے اور CLT03-2Q3 کے ساتھ انٹرفیس والے GPIO پنوں کی حالت کو پڑھنے کے لیے۔
- ips1025h_32.h اور ips1025h_32.c files IPS1025H-32 کے ساتھ انٹرفیس والے GPIO پنوں پر فالٹس سیٹ کرنے، صاف کرنے اور ان کا پتہ لگانے کے فنکشن فراہم کرتا ہے۔
- clt03_2q3.h اور clt03_2q3.c files CLT03-2Q3 کے ساتھ انٹرفیس والے GPIO پنوں کی حالت کو پڑھنے کے لیے فنکشن فراہم کرتا ہے۔
مظاہرے کا فرم ویئر سسٹم کی صلاحیتوں کو ظاہر کرنے کے لیے استعمال کے کئی آسان کیسز کو لاگو کرتا ہے۔ ہموار آپریشن اور درست نتائج کو یقینی بنانے کے لیے یہ استعمال کے کیسز اور صارف APIs کو مربوط طریقے سے انجام دیا جاتا ہے۔ فن تعمیر کو آسانی سے توسیع پذیر ہونے کے لیے ڈیزائن کیا گیا ہے، جس سے صارفین نئی خصوصیات شامل کر سکتے ہیں اور ضرورت کے مطابق کیسز استعمال کر سکتے ہیں۔ ڈیجیٹل صنعتی IO کے ساتھ ایک بورڈ چلانے کے لیے پہلے سے طے شدہ ترتیب فراہم کی جاتی ہے۔ جمپر سیٹنگ کو بھی ڈیفالٹ موڈ میں ہونے کی ضرورت ہے جیسا کہ ٹیبل 2 میں بیان کیا گیا ہے۔ ڈیجیٹل ان پٹ ڈیجیٹل آؤٹ مررنگ (DIDO) پہلے سے طے شدہ فرم ویئر ایپلیکیشن یوز کیس ہے۔
فولڈر کا ڈھانچہ
سافٹ ویئر پیکج میں درج ذیل فولڈرز شامل ہیں:
- دستاویز میں ایک مرتب شدہ HTML شامل ہے۔ file سورس کوڈ سے تیار کردہ، سافٹ ویئر کے اجزاء اور APIs کی تفصیل۔
- ڈرائیوروں پر مشتمل ہے:
- ایک STM32Cube HAL فولڈر، STM32G0xx_HAL_Driver ذیلی فولڈر میں واقع ہے۔ یہ files کو یہاں بیان نہیں کیا گیا ہے کیونکہ وہ X-CUBE-ISO1 سافٹ ویئر کے لیے مخصوص نہیں ہیں بلکہ STM32Cube فریم ورک سے براہ راست آتے ہیں۔
- ایک CMSIS فولڈر جس میں Cortex® microcontroller سافٹ ویئر انٹرفیس معیاری ہوتا ہے۔ fileبازو سے s. یہ files Cortex®-M پروسیسر سیریز کے لیے وینڈر سے آزاد ہارڈویئر تجریدی پرت ہیں۔ یہ فولڈر STM32Cube فریم ورک سے بھی بغیر کسی تبدیلی کے آتا ہے۔
- ایک BSP فولڈر جس میں اجزاء IPS1025H-32 اور CLT03-2Q3 اور X-NUCLEO-ISO1A1 سے متعلق APIs کے کوڈ ہیں۔
- درخواست میں صارف کا فولڈر ہوتا ہے جس میں main.c fileدرخواست کے استعمال کا کیس file, st_iso_app.c اور board_config.h fileNUCLEO-G071RB پلیٹ فارم کے لیے فراہم کردہ۔
بی ایس پی فولڈر
X-CUBE-ISO1 سافٹ ویئر دو مختلف اجزاء استعمال کرتا ہے۔ files، جو BSP/اجزاء کے اندر ہیں:
آئی پی ایس 1025
ips1025h_32.h اور ips1025h_32.c files IPS1025H-32 کے ساتھ انٹرفیس والے GPIO پنوں کے لیے ڈرائیور کا ایک جامع نفاذ فراہم کرتا ہے، بشمول تمام پنوں کو کنٹرول کرنے اور خرابیوں کا پتہ لگانے کے لیے مکمل فعالیت۔ یہ files ڈیوائس کو شروع کرنے، چینل کی حیثیت کو ترتیب دینے اور صاف کرنے، خرابی کے حالات کا پتہ لگانے، اور PWM فعالیت کو منظم کرنے کے افعال کو نافذ کرتا ہے۔ ڈرائیور انفرادی چینل یا گروپ دونوں کے لیے مکمل صلاحیتوں کے ساتھ متعدد آلات اور چینلز کو سپورٹ کرتا ہے۔
CLT03
clt03_2q3.h اور clt03_2q3.c files تمام پن کی حالتوں کو پڑھنے کی مکمل صلاحیتوں کے ساتھ CLT03-2Q3 کے ساتھ انٹرفیس والے GPIO پنوں کے لیے ایک مکمل خصوصیات والے ڈرائیور کو نافذ کریں۔ ڈرائیور ڈیوائس کو شروع کرنے، انفرادی چینل کی حیثیت کو پڑھنے، اور بیک وقت تمام چینلز کے لیے اسٹیٹس کی معلومات حاصل کرنے کے فنکشن فراہم کرتا ہے۔ یہ متعدد ڈیوائس کنفیگریشنز کو سپورٹ کرتا ہے اور مؤثر چینل مینجمنٹ کے لیے اندرونی حالت کو برقرار رکھتا ہے۔
X-CUBE-ISO1 سافٹ ویئر APIs کو دو بڑے ماخذ میں تقسیم کیا گیا ہے۔ files، جو ISO1A1 ذیلی فولڈر کے اندر ہیں:
ISO1A1
ISO1A1 files بورڈ کنفیگریشن، اجزاء کے تعامل، اور فالٹ مینجمنٹ کے لیے ڈیزائن کیے گئے API افعال کا ایک جامع سیٹ شامل کرتا ہے۔ یہ فنکشنز پڑھنے اور لکھنے کے آپریشنز، غلطی کا پتہ لگانے اور اپ ڈیٹس میں سہولت فراہم کرتے ہیں، اور بنیادی API فنکشنز کو سپورٹ کرنے کے لیے مختلف مددگار یوٹیلیٹیز شامل کرتے ہیں۔ مزید برآں، files LED کنٹرول، GPIO ابتداء، مداخلت ہینڈلنگ، اور UART مواصلات کے لیے فعالیت فراہم کرتا ہے۔
PWM API
PWM API PWM سگنلز کو شروع کرنے، ترتیب دینے، شروع کرنے اور روکنے کے لیے افعال فراہم کرتا ہے۔ یہ مخصوص ٹائمر پنوں کے لیے PWM فریکوئنسی اور ڈیوٹی سائیکل سیٹ کرنے کی اجازت دیتا ہے، PWM آپریشنز پر قطعی کنٹرول کو یقینی بناتا ہے۔
ایپلیکیشن فولڈر
ایپلیکیشن فولڈر مین پر مشتمل ہے۔ files فرم ویئر کے لیے درکار ہے، بشمول ہیڈر اور سورس files ذیل میں ایک تفصیلی وضاحت ہے fileاس فولڈر میں s:
- board_config.h: بورڈ کے لیے کنفیگریشن میکرو۔
- main.c: مین پروگرام (سابق کا کوڈample جو کہ ISO1A1 کی لائبریری پر مبنی ہے)۔
- st_iso_app.c: بورڈ ٹیسٹنگ اور کنفیگریشن کے لیے درخواست کے افعال۔
- stm32g0xx_hal_msp.c: HAL ابتداء کے معمولات۔
- stm32g0xx_it.c: انٹرپٹ ہینڈلر۔
- syscalls.c: سسٹم کال کے نفاذ۔
- sysmem.c: سسٹم میموری مینجمنٹ۔
- system_stm32g0xx.c: سسٹم کی شروعات۔
سافٹ ویئر مطلوبہ وسائل
نیوکلیو ڈیوائس GPIOs کے ذریعے X-NUCLEO-ISO1A1 بورڈ کے ساتھ کنٹرول اور بات چیت کرتی ہے۔ اس کے لیے X-NUCLEO-ISO1A1 بورڈ میں موجود صنعتی IO آلات کے ان پٹ، آؤٹ پٹ، اور غلطی کا پتہ لگانے کے لیے کئی GPIOs کے استعمال کی ضرورت ہے۔ مزید تفصیلات اور جمپر کنفیگریشنز کے لیے ہارڈ ویئر یوزر مینوئل UM3483 سے رجوع کریں۔
بورڈ کنفیگریشن (board_config.h)
board_config.h file بورڈ کنفیگریشن کے مطابق سافٹ ویئر کو کنفیگر کرنے کے لیے استعمال شدہ وسائل اور کنفیگریشنل میکروز کی وضاحت کرتا ہے۔ یہ دو بورڈز تک ہینڈل کرتا ہے (جیسے کہ دو بورڈز کا اسٹیکنگ)۔
سافٹ ویئر ڈیفالٹ کنفیگریشن X-NUCLEO-ISO1A1 ایکسپینشن بورڈ کے ساتھ اس کے جمپرز کے ساتھ ڈیفالٹ پوزیشنوں میں منسلک ہے۔ X-NUCLEO-ISO1A1 کے لیے سافٹ ویئر کو اس کی ڈیفالٹ ترتیب میں ترتیب دینے کے لیے، board_config.h میں BOARD_ID_DEFAULT میکرو کو غیر تبصرہ کریں۔ file.
سافٹ ویئر ALTERNATE کنفیگریشن بورڈ_config.h میں BOARD_ID_ALTERNATE میکرو کو غیر تبصرہ کرتے ہوئے ترتیب دیا گیا ہے۔ file اور بورڈ پر جمپر کی پوزیشنوں کو تبدیل کرنا۔
اسٹیک اپ کنفیگریشن میں بیک وقت دو بورڈز استعمال کرنے کے لیے، BOARD_ID_DEFAULT اور BOARD_ID_ALTERNATE میکرو دونوں کو غیر تبصرہ کریں اور یقینی بنائیں کہ ایک بورڈ کے جمپر پہلے سے طے شدہ پوزیشن میں ہیں اور دوسرا متبادل پوزیشن میں۔ نوٹ کریں کہ دونوں بورڈز کو ایک ہی ترتیب میں رکھنے کی سفارش نہیں کی جاتی ہے (یا تو دونوں پہلے سے طے شدہ میں یا دونوں متبادل میں) اور اس کے نتیجے میں ناپسندیدہ سلوک ہو سکتا ہے۔
صرف ایک بورڈ چلاتے وقت، اس بات کو یقینی بنائیں کہ سافٹ ویئر صرف ایک کنفیگریشن کے لیے ترتیب دیا گیا ہے اور دوسری کنفیگریشن کے مطابق میکرو پر تبصرہ کیا گیا ہے۔
پری اسکیلرز
ہم board_config.h میں پری اسکیلر ویلیوز کو ترتیب دے سکتے ہیں تاکہ PWM آؤٹ پٹ کے لیے مناسب میکرو سیٹ کر کے مختلف فریکوئنسی رینج حاصل کر سکیں۔ پری اسکیلر ویلیو استعمال کرنے کے لیے، متعلقہ میکرو کو غیر تبصرہ کریں اور دوسروں پر تبصرہ کریں۔ پہلے سے طے شدہ طور پر، DEFAULT_PRESCALAR استعمال کیا جاتا ہے۔
- PRESCALER_1
- PRESCALER_2
- DEFAULT_PRESCALER
prescaler اقدار صرف اس وقت استعمال ہوتی ہیں جب ٹائمر استعمال کیے جا رہے ہوں، اور کسی بنیادی I/O آپریشن کے لیے اس کی ضرورت نہیں ہوتی ہے۔ پری اسکیلر میکروز کی اقدار اور ان کے متعلقہ فریکوئنسی رینجز کو کوڈ دستاویزات میں یا خود کوڈ میں دیکھا جا سکتا ہے۔
دل کی دھڑکن ایل ای ڈی
ہم NUCLEO-G071RB بورڈ سے مناسب کنکشن کے ٹیسٹ کے طور پر سبز صارف LED, D7 کو دل کی دھڑکن کے انداز میں پلک جھپکنے کے لیے ترتیب دے سکتے ہیں۔ میکرو، HEARTBEAT_LED جب غیر تبصرہ کیا جاتا ہے، X-NUCLEO-ISO1A1 پر سبز LED کو جھپکتا ہے جب یہ NUCLEO سے منسلک ہوتا ہے۔ یہ 1 سیکنڈ کے لیے آن اور 2 سیکنڈ کے لیے بند رہتا ہے، جس میں ٹائمرز کا خیال رکھا جاتا ہے۔ جب اسے استعمال نہیں کیا جاتا ہے یا کوئی فنکشن جس میں ایل ای ڈی کو بلایا جاتا ہے، تو میکرو کو غیر تبصرہ کیا جانا چاہیے۔
ان پٹ اور آؤٹ پٹ GPIO کنفیگریشن
ہر X-NUCLEO-ISO1A1 بورڈ دو ان پٹ پورٹس اور دو آؤٹ پٹ پورٹس سے لیس ہے۔ بورڈ کی صلاحیتوں کو ایک دوسرے کے اوپر دو X-NUCLEO-ISO1A1 بورڈ لگا کر بڑھایا جا سکتا ہے، اس طرح چار ڈیجیٹل ان پٹ پورٹس اور چار ڈیجیٹل آؤٹ پٹ پورٹس کے استعمال کو قابل بنایا جا سکتا ہے۔ فراہم کردہ سافٹ ویئر میں جامع APIs شامل ہیں جو بندرگاہوں کو پڑھنے، ترتیب دینے اور صاف کرنے میں سہولت فراہم کرتے ہیں۔ مزید برآں، APIs تمام بندرگاہوں کو بیک وقت ترتیب دینے، پڑھنے یا صاف کرنے کی اجازت دیتے ہیں۔ API افعال کے بارے میں تفصیلی معلومات کوڈ دستاویزات کے ساتھ ساتھ اس دستاویز کے API سیکشن میں بھی دستیاب ہے۔
یہاں پریفکس DI ڈیجیٹل ان پٹ پورٹ کی نشاندہی کرتا ہے اور DO ڈیجیٹل آؤٹ پٹ پورٹ کی نشاندہی کرتا ہے۔ متبادل کنفیگریشن کے لیے، سافٹ ویئر _alt لاحقہ منسلک کے ساتھ وہی نام دینے کے کنونشنز کا استعمال کرتا ہے۔
مندرجہ ذیل جدول مختلف IO پورٹس سے متعلق سافٹ ویئر میں بیان کردہ GPIO میکروز کی تفصیلات دیتا ہے۔
جدول 2۔ ڈیفالٹ اور متبادل سافٹ ویئر کنفیگریشنز کے لیے مختص کردہ GPIOs
| نام | فنکشن | پہلے سے طے شدہ ترتیب | متبادل ترتیب |
| ان پٹ پن | ان پٹ پن 1 | GPIOC، IA0_IN_1_PIN | GPIOD، IA0_IN_1_PIN |
| ان پٹ پن 2 | GPIOD، IA1_IN_2_PIN | GPIOC، IA1_IN_1_PIN | |
| آؤٹ پٹ پن | آؤٹ پٹ پن 1 | GPIOC، QA0_CNTRL_1_PIN | GPIOD، QA0_CNTRL_1_PIN |
| آؤٹ پٹ پن 2 | GPIOC، QA1_CNTRL_2_PIN | GPIOC، QA1_CNTRL_2_PIN | |
| فالٹ پن | فالٹ پن 1 | GPIOC، FLT1_QA0_2_OT_PIN | GPIOD، FLT1_QA0_1_OT_PIN |
| فالٹ پن 2 | GPIOC، FLT2_QA0_2_OL_PIN | GPIOD، FLT2_QA0_1_OL_PIN | |
| فالٹ پن 3 | GPIOC، FLT1_QA1_2_OT_PIN | GPIOC، FLT1_QA1_1_OT_PIN | |
| فالٹ پن 4 | GPIOC، FLT2_QA1_1_OL_PIN | GPIOD، FLT2_QA1_2_OL_PIN | |
| کنفیگریشن میکرو | BOARD_ID_DEFAULT | BOARD_ID_ALTERNATE |
ٹائمر اور پی ڈبلیو ایم
مخصوص پنوں کے لیے PWM سگنل تیار کرنے کے لیے X-CUBE-ISO1 فرم ویئر میں ٹائمر استعمال کیے جا سکتے ہیں۔ پہلے سے طے شدہ طور پر، ٹائمرز TIM3 کے علاوہ شروع نہیں کیے جاتے ہیں۔ PWM سگنلز بنانے سے پہلے متعلقہ ٹائمرز کو شروع کیا جانا چاہیے اور متعلقہ آؤٹ پٹ پورٹس کو PWM موڈ میں شروع کرنا چاہیے۔
عام GPIO ان پٹ/آؤٹ پٹ آپریشنز کے لیے، کسی ٹائمر یا آؤٹ پٹ پورٹ کو کنفیگر کرنے کی ضرورت نہیں ہے، کیونکہ اس کا پہلے سے ہی خیال رکھا جاتا ہے۔ تاہم، اگر ایک بار آؤٹ پٹ پن PWM موڈ میں سیٹ ہو جاتے ہیں، تو ہمیں انہیں GPIO موڈ میں دوبارہ ترتیب دینے کی ضرورت ہے تاکہ GPIO پنوں کے طور پر استعمال کیا جا سکے۔
نوٹ: جب آؤٹ پٹ پنوں کو PWM جنریشن کے لیے استعمال کیا جا رہا ہو، تو GPIO آؤٹ پٹ غیر فعال ہو جاتا ہے، دونوں فنکشنلٹیز کو ایک ساتھ لاگو نہیں کیا جا سکتا۔ PWM کے استعمال کے بعد GPIO کو دوبارہ فعال کرنے کے لیے، کوئی بھی API فنکشن ST_ISO_BoardConfigureDefault() یا ST_ISO_InitGPIO() کو کال کر سکتا ہے تاکہ تمام پورٹس کو GPIO کے طور پر ایک ساتھ کنفیگر کیا جا سکے یا ST_ISO_Init_GPIO() کو کسی خاص GPIO پورٹ اور پن کے ساتھ۔
جیسا کہ اوپر ذکر کیا گیا ہے، سافٹ ویئر ڈیفالٹ کے طور پر ایک ٹائمر بھی استعمال کرتا ہے، TIM3، جو صارف کی LED ٹائمنگ، گھڑی، اور UART ٹائمنگ کے نفاذ کے لیے استعمال ہوتا ہے۔ یہ پہلے سے طے شدہ طور پر 1 سیکنڈ کی مدت کے لیے ترتیب دیا گیا ہے۔
درج ذیل جدول میں ہمارے کوڈ میں ہر پن کے لیے دستیاب ٹائمرز کی تفصیلات دی گئی ہیں۔
جدول 3۔ ہر پن کے لیے ٹائمر دستیاب ہیں۔
| پن کا نام | سافٹ ویئر کی نمائندگی | ٹائمر | ٹائمر چینل | متبادل فنکشن |
| QA0_CNTRL_1_PIN | QA_0 | TIM2 | TIM_CHANNEL_4 | GPIO_AF2_TIM2 |
| QA1_CNTRL_2_PIN | QA_1 | TIM1 | TIM_CHANNEL_3 | GPIO_AF2_TIM1 |
| QA0_CNTRL_2_PIN | QA_0_ALT | TIM1 | TIM_CHANNEL_4 | GPIO_AF2_TIM1 |
| QA1_CNTRL_1_PIN | QA_1_ALT | TIM17 | TIM_CHANNEL_1 | GPIO_AF2_TIM17 |
فرم ویئر کی اضافی افادیت
فرم ویئر میں X-NUCLEO-ISO1A1 ایویلیویشن بورڈ کی فعالیت کو بڑھانے کے لیے اضافی افادیتیں شامل ہیں۔ جن میں سے کچھ ذیل میں بیان کیے گئے ہیں۔
UART
UART کمیونیکیشن فیچر PC یوٹیلیٹیز جیسے TeraTerm، PuTTY اور اسی طرح کی دیگر ایپلی کیشنز کے ذریعے بورڈ کی حیثیت کی اصل وقت کی نگرانی اور ڈیبگنگ کی اجازت دیتا ہے۔ سافٹ ویئر NUCLEO-G071RB بورڈ میں موجود UART کے ذریعے UART ڈیٹا کی ترسیل کو قابل بناتا ہے۔ 'ST_ISO_UART' فنکشن UART پر بورڈ کے اسٹیٹس کی تفصیلی معلومات بھیجتا ہے، بشمول سسٹم اپ ٹائم، فرم ویئر کنفیگریشن، اور فالٹ اسٹیٹس۔ یہ ڈیٹا ہو سکتا ہے۔ viewed کسی بھی سیریل پورٹ ایپلیکیشن کا استعمال کرتے ہوئے، جیسے TeraTerm. `ST_ISO_APP_DIDOandUART` فنکشن ڈیجیٹل ان پٹ/آؤٹ پٹ آپریشنز کو UART کمیونیکیشن کے ساتھ جوڑتا ہے، تمام ان پٹ اور آؤٹ پٹ چینلز کی حیثیت کو مخصوص وقفوں پر منتقل کرتا ہے۔ ذیل میں کنفیگریشن سیٹنگز اور اس طرح ہیں۔ampTeraTerm میں ڈیٹا کس طرح ظاہر ہوتا ہے۔ پورٹ کا نام سسٹم اور سیریل پورٹ کے استعمال کی بنیاد پر مختلف ہو سکتا ہے۔
IO پن موڈ کنفیگریشن
IO پن موڈ کنفیگریشن یوٹیلیٹی صارفین کو ST_ISO_BoardConfigure() فنکشن کا استعمال کرتے ہوئے بورڈ کے ان پٹ اور آؤٹ پٹ پورٹس کو سیٹ کرنے کی اجازت دیتی ہے۔ یہ فنکشن دو آؤٹ پٹ پورٹس (QA0, QA1) اور دو ان پٹ پورٹس (IA0, IA1) کو ان پٹ/آؤٹ پٹ موڈ، PWM آؤٹ پٹ موڈ، یا انٹرپٹ ان پٹ موڈ میں ترتیب دینے کی حمایت کرتا ہے۔ پیرامیٹرز کو ایڈجسٹ کرکے اور اس فنکشن کو کال کرکے، صارف مخصوص ضروریات کو پورا کرنے کے لیے بورڈ کی IO کنفیگریشن کو آسانی سے اپنی مرضی کے مطابق بنا سکتے ہیں۔
ان پٹ/آؤٹ پٹ موڈ میں، یوٹیلیٹی عام مقصد کے ڈیجیٹل آپریشنز کے لیے GPIO پنوں کو شروع کرتی ہے۔ PWM آؤٹ پٹ موڈ میں، یہ درست PWM سگنل کنٹرول کے لیے ٹائمر سیٹ کرتا ہے۔ انٹرپٹ ان پٹ موڈ میں ہونے پر، یوٹیلیٹی پنوں کو انٹرپٹس کو ہینڈل کرنے کے لیے ترتیب دیتی ہے، جس سے ریسپانسیو ایونٹ پر مبنی پروگرامنگ کی اجازت ملتی ہے۔
ہینڈلنگ میں خلل ڈالنا
FAULT سگنلز کو سنبھالنے کے لیے، سافٹ ویئر متعلقہ انٹرپٹ لائنوں کو فعال کرتا ہے، جس سے ریسپانسیو ایونٹ پر مبنی پروگرامنگ کی اجازت ہوتی ہے۔ ایک اپنی مرضی کے مطابق ہینڈلر کو ان مداخلتوں کے ساتھ منسلک کیا جا سکتا ہے
HAL_GPIO_EXTI_Rising_Callback فنکشن API میں بیان کیا گیا ہے۔ سافٹ ویئر میں ST_ISO_BoardConfigure فنکشن کے ذریعے GPIO پنوں کو انٹرپٹ موڈ میں شروع کرنے اور EXTI IRQ ہینڈلرز میں مخصوص کارروائیوں کو ترتیب دینے کی خصوصیات شامل ہیں۔ یہ صارفین کو اپنی مرضی کے مطابق کرنے کی اجازت دیتا ہے کہ بورڈ بیرونی واقعات پر کس طرح ردعمل دیتا ہے، اس بات کو یقینی بناتا ہے کہ یہ مختلف خرابی کے حالات اور محرکات کو مؤثر طریقے سے منظم کر سکتا ہے۔
APIs
X-CUBE-ISO1 سافٹ ویئر API X-NUCLEO-ISO1A1 بورڈ کو کنٹرول اور مانیٹر کرنے کے لیے فنکشنز کا ایک جامع سیٹ فراہم کرتا ہے، بشمول PWM سگنل جنریشن اور GPIO آپریشنز۔ API کو بورڈ کی فعالیت پر لچک اور کنٹرول فراہم کرتے ہوئے مختلف ایپلی کیشنز میں استعمال اور انضمام میں آسان ہونے کے لیے ڈیزائن کیا گیا ہے۔
X-CUBE-ISO1 سافٹ ویئر API کی وضاحت BSP/ISO1A1 فولڈر میں کی گئی ہے۔ اس کے فنکشنز ST_ISO کے ساتھ سابقہ ہیں۔ API iso1a1.c اور pwm_api.c کے ذریعے ایپلی کیشنز کو نظر آتا ہے۔ files مستقل، ڈیٹا ڈھانچے، اور افعال کا مجموعہ ہے۔
Sample فرم ویئر ایپلی کیشنز ان افعال کے کچھ ممکنہ استعمال کو دکھانے کے لیے ان APIs کا استعمال کرتی ہے۔
X-CUBE-ISO1 سافٹ ویئر پیکج APIs کے دو سیٹ فراہم کرتا ہے:
- ISO1A1 API
- PWM API
ISO1A1 API
ISO1A1 API کی وضاحت iso1a1.h اور iso1a1.c میں کی گئی ہے۔ files یہ ISO1A1 بورڈ کو ترتیب دینے اور کنٹرول کرنے کے لیے فنکشن فراہم کرتا ہے، بشمول GPIO ان پٹ/آؤٹ پٹ آپریشنز اور غلطی کا پتہ لگانا۔
کلیدی افعال
- ST_ISO_BoardConfigureDefault: بورڈ کے IO پورٹس کو ڈیفالٹ GPIO کنفیگریشن کے ساتھ کنفیگر کرتا ہے۔
- ST_ISO_BoardConfigure: بورڈ کے لیے ان پٹ اور آؤٹ پٹ پورٹس کے موڈ کو کنفیگر کرتا ہے۔
- ST_ISO_BoardInit: بورڈ ہارڈویئر کو شروع کرتا ہے۔
- ST_ISO_BoardMapInit: چینل ہینڈل کنفیگریشن کی بنیاد پر بورڈ کی فعالیت کو شروع کرتا ہے۔
- ST_ISO_GetFWVersion: موجودہ فرم ویئر ورژن لوٹاتا ہے۔
- ST_ISO_GetChannelHandle: ایک مخصوص چینل کے نام کے لیے چینل ہینڈل کو بازیافت کرتا ہے۔
- ST_ISO_InitGPIO: دیے گئے ماڈیول ID کے ساتھ مخصوص GPIO پن کو شروع کرتا ہے۔
- ST_ISO_InitInterrupt: مخصوص GPIO پن کو دی گئی ماڈیول ID کے ساتھ مداخلت کے طور پر شروع کرتا ہے۔
- ST_ISO_EnableFaultInterrupt: فالٹ GPIO پنوں کو انٹرپٹ موڈ میں شروع کرتا ہے۔
- ST_ISO_SetChannelStatus: ایک مخصوص چینل کی حیثیت کا تعین کرتا ہے۔
- ST_ISO_SetOne_DO: ایک واحد ڈیجیٹل آؤٹ پٹ چینل سیٹ کرتا ہے۔
- ST_ISO_ClearOne_DO: ایک ڈیجیٹل آؤٹ پٹ چینل کو صاف کرتا ہے۔
- ST_ISO_WriteAllChannels: تمام ڈیجیٹل آؤٹ پٹ چینلز پر ڈیٹا لکھتا ہے۔
- ST_ISO_GetOne_DI: ایک واحد ڈیجیٹل ان پٹ چینل کی حیثیت حاصل کرتا ہے۔
- ST_ISO_ReadAllChannel: تمام ان پٹ چینلز کی حیثیت کو پڑھتا ہے۔
- ST_ISO_ReadAllOutputChannel: تمام آؤٹ پٹ چینلز کی حیثیت کو پڑھتا ہے۔
- ST_ISO_ReadFaultStatus: تمام فالٹ ڈیٹیکشن پورٹس سے فالٹ اسٹیٹس پڑھتا ہے۔
- ST_ISO_ReadFaultStatusPolling: پولنگ موڈ میں بورڈز کی غلطی کا پتہ لگانے کی جانچ کرتا ہے۔
- ST_ISO_DisableOutputChannel: اس چینل کے لیے آؤٹ پٹ کو غیر فعال کرتا ہے۔
- ST_ISO_UpdateBoardStatusInfo: بورڈ کی حیثیت کی معلومات کو اپ ڈیٹ کرتا ہے۔
- ST_ISO_UpdateFaultStatus: ایک مخصوص چینل کے لیے فالٹ اسٹیٹس کو اپ ڈیٹ کرتا ہے۔
- ST_ISO_BlinkLed: دی گئی تاخیر اور دوبارہ گنتی کے ساتھ مخصوص LED کو جھپکتا ہے۔
- ST_ISO_UART: UART پر بورڈ کی حیثیت کی معلومات بھیجتا ہے۔
- ST_ISO_SwitchInit: سوئچ کے اجزاء کو شروع کرتا ہے۔
- ST_ISO_SwitchDeInit: سوئچ کی مثال کو ڈی-انیشیلائز کرتا ہے۔
- ST_ISO_DigitalInputInit: ڈیجیٹل ان پٹ اجزاء کو شروع کرتا ہے۔
- ST_ISO_DigitalInputDeInit: ڈیجیٹل ان پٹ مثال کو ڈی-انیشیلائز کرتا ہے۔
PWM API
PWM API کی وضاحت pwm_api.h اور pwm_api.c میں کی گئی ہے۔ files یہ مخصوص پنوں کے لیے PWM سگنلز کو شروع کرنے اور کنٹرول کرنے کے لیے درج ذیل افعال فراہم کرتا ہے۔
- ST_ISO_Init_PWM_Signal: PWM سگنل کے لیے ٹائمرز اور مخصوص پن کو شروع کرتا ہے۔
- ST_ISO_Set_PWM_Frequency: مخصوص پن کے لیے PWM فریکوئنسی سیٹ کرتا ہے۔
- ST_ISO_Set_PWM_Duty_Cycle: مخصوص پن کے لیے PWM ڈیوٹی سائیکل سیٹ کرتا ہے۔
- ST_ISO_Start_PWM_Signal: مخصوص پن پر PWM سگنل شروع کرتا ہے۔
- ST_ISO_Stop_PWM_Signal: PWM سگنل کو مخصوص پن پر روکتا ہے۔
متعلقہ چینل پر PWM سگنل شروع کرنے کے لیے، پہلے ST_ISO_Init_PWM_Signal فنکشن کو کال کریں، پھر ST_ISO_Set_PWM_Frequency کو کال کرکے مطلوبہ فریکوئنسی اور ڈیوٹی سائیکل سیٹ کریں اور
ST_ISO_Set_PWM_Duty_Cycle بالترتیب کام کرتا ہے اور پھر آپ ST_ISO_Start_PWM_Signal فنکشن کو کال کرکے PWM سگنل شروع کر سکتے ہیں اور ST_ISO_Stop_PWM_Signal کو کال کر کے روک سکتے ہیں۔
فنکشن کو متعلقہ پن نام اور دستیاب ٹائمرز کے ساتھ کال کرنے کی ضرورت ہے، جس کی تفصیلات جدول 3 میں فراہم کی گئی ہیں۔ مختلف فریکوئنسی اور ڈیوٹی سائیکل کے ساتھ مختلف آؤٹ پٹ چینلز قائم کیے جا سکتے ہیں۔ فریکوئنسی یا ڈیوٹی سائیکل کو تبدیل کرنے سے دوسرے پر کوئی اثر نہیں پڑتا، یہ وہی رہتا ہے۔
صارف کے لیے دستیاب APIs کے بارے میں تفصیلی تکنیکی معلومات مرتب کردہ HTML میں مل سکتی ہیں۔ file سافٹ ویئر پیکج کے "دستاویزات" فولڈر کے اندر واقع ہے جہاں تمام افعال اور پیرامیٹرز مکمل طور پر بیان کیے گئے ہیں۔
درخواست کی تفصیل
مظاہرے کی درخواست کئی آسان استعمال کے معاملات کو لاگو کرتی ہے۔ st_iso_app اور board_config files بورڈ اور اس کے اطلاق کے افعال کو ترتیب دینے اور استعمال کرنے میں ایک اہم کردار ادا کرتا ہے۔ ان افعال کو استعمال کرنے سے پہلے یقینی بنائیں کہ بورڈ اور سافٹ ویئر کی ترتیب ایک دوسرے کے ساتھ ہم آہنگ ہے۔
درخواست کے افعال (st_iso_app.h اور st_iso_app.c)
ایپلیکیشن کے فنکشنز ST_ISO_APP کے ذریعہ پہلے سے لگائے گئے ہیں۔ وہ اعلی درجے کے فنکشنز ہیں جو صارف کو نظر آتے ہیں جو ان کے نفاذ کے لیے API فنکشنز کو کال کرتے ہیں۔ درخواست کے فنکشنز کو main.c میں بلایا جا سکتا ہے۔ file ان کے کام کے لیے۔
- کیس سلیکشن کا استعمال کریں: صارف st_iso_app.c میں مطلوبہ استعمال کیس میکرو کو غیر تبصرہ کر سکتا ہے۔ file. فنکشن ST_ISO_APP_SelectUseCaseMacro(، جسے main.c میں کہا جاتا ہے، استعمال کے کیس کو شروع کرتا ہے، اور فنکشن ST_ISO_APP_SelectedFunction() اسے main.c میں لاگو کرتا ہے۔ یہ نقطہ نظر صرف میکرو تعریفوں میں ترمیم کرکے آپریشنل موڈ کی آسانی سے ترتیب دینے کی اجازت دیتا ہے، اس بات کو یقینی بناتا ہے کہ منتخب کردہ استعمال کے معاملے کی بنیاد پر مناسب فعالیت کو انجام دیا جائے۔ پہلے سے طے شدہ طور پر، استعمال کیس DIDO کو منتخب کیا جاتا ہے، اور صارف کو اسے لاگو کرنے کے لیے کوڈ میں کوئی تبدیلی کرنے کی ضرورت نہیں ہوتی ہے۔
- ڈیجیٹل ان پٹ ٹو ڈیجیٹل آؤٹ پٹ مررنگ (ST_ISO_APP_UsecaseDIDO): یہ فنکشن تمام ان پٹ چینلز کا اسٹیٹس پڑھتا ہے اور تمام آؤٹ پٹ چینلز پر وہی اسٹیٹس لکھتا ہے۔ یہ ڈیجیٹل ان پٹ کو ڈیجیٹل آؤٹ پٹس میں عکس بند کرنے کے لیے مفید ہے۔
- UART (ST_ISO_APP_DIDOandUART) کے ساتھ ڈیجیٹل آؤٹ پٹ مررنگ میں ڈیجیٹل ان پٹ: یہ فنکشن ST_ISO_APP_UsecaseDIDO فنکشن کی طرح ڈیجیٹل آؤٹ پٹ میں ڈیجیٹل ان پٹ کا عکس دیتا ہے۔ مزید برآں، یہ نیوکلیو ڈیوائس پر UART انٹرفیس کے ذریعے بورڈ کی حیثیت کو منتقل کرتا ہے، جس سے اسٹیٹس کو viewٹیرا ٹرم جیسی ایپلی کیشنز کا استعمال کرتے ہوئے سیریل پورٹ پر ایڈ۔
- ٹیسٹ کیس فنکشن (ST_ISO_APP_TestCase): یہ فنکشن بورڈ کنفیگریشن کی بنیاد پر ٹیسٹ اور کارروائیوں کا ایک سلسلہ انجام دیتا ہے۔ یہ غلطی کی حیثیت کی جانچ کرتا ہے، دو ڈیجیٹل ان پٹ چینلز کی حیثیت کو پڑھتا ہے، اور ان کی اقدار کی بنیاد پر اعمال انجام دیتا ہے۔ یہ فنکشن بورڈ کی کارکردگی اور فعالیت کا تیزی سے جائزہ لینے اور مختلف LED پیٹرن کے ذریعے بصری فیڈ بیک حاصل کرنے میں مدد کرتا ہے۔ بورڈ_config.h میں HEARTBEAT_LED میکرو کو یقینی بنائیں file مناسب ایل ای ڈی پیٹرن کا مشاہدہ کرنے کے لئے تبصرہ کیا جاتا ہے.
- PWM جنریشن (ST_ISO_APP_PWM _OFFSET): یہ فنکشن PWM سگنل کو دونوں آؤٹ پٹ چینلز پر 1 Hz اور ڈیوٹی سائیکل 50% کی فریکوئنسی کے ساتھ شروع کرتا ہے۔ یہ PWM سگنل کو شروع کرتا ہے، فریکوئنسی اور ڈیوٹی سائیکل سیٹ کرتا ہے، اور مخصوص بورڈ ID کے لیے PWM سگنل شروع کرتا ہے۔ PWM سگنل دونوں چینلز کے درمیان ایک آفسیٹ کے ساتھ پیدا ہوتا ہے اور اس طرح وہ مرحلے میں نہیں ہیں۔
- فالٹ ڈیٹیکشن ٹیسٹ (ST_ISO_APP_FaultTest): یہ فنکشن سمارٹ آؤٹ پٹ ماڈیول IPS1025 کے ان بلٹ ڈائیگنوسٹک پنوں کی موٹرنگ کے ذریعے غلطی کی نشاندہی کا اندازہ کرتا ہے۔ پولنگ یا مداخلت کے موڈ میں۔ یہ غلطی کا پتہ لگانے کے موڈ کو ترتیب دیتا ہے، غلطی کا پتہ لگانے کو شروع کرتا ہے، اور منتخب کردہ موڈ کی بنیاد پر غلطی کی حیثیت کے ڈھانچے کو اپ ڈیٹ کرتا ہے۔ یہ فنکشن خرابیوں کا پتہ لگانے اور مؤثر طریقے سے نمٹنے کے ذریعے بورڈ کی وشوسنییتا اور حفاظت کو یقینی بنانے کے لیے اہم ہے۔ جب یہ پولنگ موڈ میں ہوتا ہے، تو فالٹ اسٹیٹس کو ٹائمر کی مدد سے ہر سیکنڈ میں اپ ڈیٹ کیا جاتا ہے اور ڈھانچہ defaultBoardFaultStatus یا AlternateBoardFaultStatus میں ظاہر ہوتا ہے۔ جب یہ انٹرپٹ موڈ میں ہوتا ہے، تو غلطی کی صورتحال صرف اس وقت اپ ڈیٹ ہوتی ہے جب غلطی ہوتی ہے، اور یہ سافٹ ویئر کو متعلقہ آؤٹ پٹ پورٹ کو صاف کرنے کے لیے متحرک کرتا ہے۔
- PWM ویری ایشن ٹیسٹ (ST_ISO_APP_PwmVariationTest): یہ فنکشن بورڈ کنفیگریشن کی بنیاد پر مختلف آؤٹ پٹ چینلز پر PWM (Pulse Width Modulation) سگنلز کے تغیرات کو جانچنے کے لیے ڈیزائن کیا گیا ہے۔ یہ پہلے سے طے شدہ اور متبادل بورڈ کنفیگریشن دونوں کے لیے PWM سگنلز کو شروع کرتا ہے، ان کی فریکوئنسی 100 Hz اور ابتدائی ڈیوٹی سائیکل کو 0% پر سیٹ کرتا ہے۔ اس کے بعد فنکشن ڈیوٹی سائیکل کو 0% سے 100% تک 5% کے اضافے میں، اور 5% کی کمی میں 100% سے 0% تک، ہر قدم کے درمیان 2 سیکنڈ کی تاخیر کے ساتھ۔ یہ کنٹرول شدہ تغیر پہلے سے طے شدہ بورڈ کے لیے چینلز QA_0 اور QA_1، اور متبادل بورڈ کے لیے QA_0_ALT اور QA_1_ALT پر PWM سگنل کے رویے کے مشاہدے اور تشخیص کی اجازت دیتا ہے۔
ان کنفیگریشنز پر عمل کرتے ہوئے اور فراہم کردہ ایپلیکیشن فنکشنز کو استعمال کرتے ہوئے، آپ مختلف مظاہرے کے استعمال کے کیسز کے لیے X-NUCLEO-ISO1A1 بورڈ کو مؤثر طریقے سے ترتیب اور استعمال کر سکتے ہیں۔
سسٹم سیٹ اپ گائیڈ
ہارڈ ویئر کی تفصیل
STM32 نیوکلیو پلیٹ فارم
STM32 نیوکلیو ڈویلپمنٹ بورڈز صارفین کو کسی بھی STM32 مائیکرو کنٹرولر لائن کے ساتھ حل کی جانچ کرنے اور پروٹو ٹائپ بنانے کا ایک سستا اور لچکدار طریقہ فراہم کرتے ہیں۔
Arduino® کنیکٹیویٹی سپورٹ اور ST مورفو کنیکٹرز STM32 نیوکلیو اوپن ڈویلپمنٹ پلیٹ فارم کی فعالیت کو وسعت دینا آسان بناتے ہیں جس میں سے انتخاب کرنے کے لیے خصوصی توسیعی بورڈز کی ایک وسیع رینج ہے۔
STM32 نیوکلیو بورڈ کو الگ الگ تحقیقات کی ضرورت نہیں ہے کیونکہ یہ ST-LINK/V2-1 ڈیبگر/پروگرامر کو مربوط کرتا ہے۔
STM32 نیوکلیو بورڈ جامع STM32 سافٹ ویئر HAL لائبریری کے ساتھ آتا ہے اور اس کے ساتھ مختلف پیکیجڈ سافٹ ویئر سابقamples
STM32 نیوکلیو بورڈ سے متعلق معلومات پر دستیاب ہے۔ www.st.com/stm32nucleo
X-NUCLEO-ISO1A1 توسیعی بورڈ
X-NUCLEO-ISO1A1 الگ تھلگ صنعتی ان پٹ/آؤٹ پٹ کے ساتھ ایک تشخیصی بورڈ ہے جو STM32 نیوکلیو بورڈ کو بڑھانے اور مائیکرو-PLC فعالیت فراہم کرنے کے لیے ڈیزائن کیا گیا ہے۔ X-NUCLEO-ISO1A1 بورڈز میں سے دو کو GPIO انٹرفیس میں تصادم سے بچنے کے لیے توسیعی بورڈ پر جمپروں کے مناسب انتخاب کے ساتھ STM32 نیوکلیو بورڈ کے اوپر ایک ساتھ اسٹیک کیا جا سکتا ہے۔ UL1577 مصدقہ ڈیجیٹل آئیسولیٹر STISO620 اور STISO621 منطق اور عمل کے ضمنی اجزاء کے درمیان تنہائی فراہم کرتے ہیں۔ عمل کی طرف سے دو موجودہ محدود ہائی سائیڈ ان پٹ CLT03-2Q3 کے ذریعے حاصل کیے گئے ہیں۔ CLT03-2Q3 صنعتی حالات کے لیے تحفظ، تنہائی، اور توانائی سے کم حیثیت کا اشارہ فراہم کرتا ہے، جو IEC61000-4-2، IEC61000-4-4، اور IEC61000-4-5 جیسے معیارات کو پورا کرنے کے لیے ڈیزائن کیا گیا ہے۔ ہائی سائیڈ سوئچز میں سے ہر ایک IPS1025H-32/HQ-32 تشخیصی اور سمارٹ ڈرائیونگ خصوصیات کے ساتھ 5.6 A تک محفوظ آؤٹ پٹ فراہم کرتا ہے۔ یہ capacitive، resistive، یا inductive بوجھ چلا سکتے ہیں۔ X-NUCLEO-ISO1A1 X-CUBE-ISO1 سافٹ ویئر پیکج کا استعمال کرتے ہوئے جہاز پر موجود ICs کی تیز رفتار تشخیص کی اجازت دیتا ہے۔
ہارڈ ویئر سیٹ اپ
مندرجہ ذیل ہارڈویئر اجزاء کی ضرورت ہے:
- ایک STM32 نیوکلیو ڈویلپمنٹ پلیٹ فارم (تجویز کردہ آرڈر کوڈ: NUCLEO-GO71RB)
- ایک صنعتی ڈیجیٹل آؤٹ پٹ توسیعی بورڈ (آرڈر کوڈ: X-NUCLEO-ISO1A1)
- STM32 نیوکلیو کو پی سی سے جوڑنے کے لیے ایک USB قسم A سے مائیکرو USB کیبل
- X-NUCLEO-ISO1A1 توسیعی بورڈ کو سپلائی کرنے کے لیے ایک بیرونی پاور سپلائی (24 V) اور متعلقہ تاریں۔
سافٹ ویئر سیٹ اپ
X-NUCLEO-ISO1A1 توسیعی بورڈ سے لیس STM32 نیوکلیو کے لیے ایپلی کیشنز بنانے کے لیے ایک مناسب ترقیاتی ماحول قائم کرنے کے لیے درج ذیل سافٹ ویئر کے اجزاء کی ضرورت ہے۔
- X-CUBE-ISO1: STM32Cube کے لیے ایک توسیع جو ایپلیکیشن ڈیولپمنٹ کے لیے وقف ہے جس کے لیے X-NUCLEO-ISO1A1 بورڈ کے استعمال کی ضرورت ہے۔ X-CUBE-ISO1 فرم ویئر اور متعلقہ دستاویزات پر دستیاب ہے۔ www.st.com
- ڈویلپمنٹ ٹول چین اور کمپائلر: STM32Cube توسیعی سافٹ ویئر مندرجہ ذیل تین ماحول کی حمایت کرتا ہے:
- ARM® (IAR-EWARM) ٹول چین کے لیے IAR ایمبیڈڈ ورک بینچ
- اصلیView مائیکرو کنٹرولر ڈویلپمنٹ کٹ (MDK-ARM-STM32) ٹول چین
- STM32CubeIDE۔
بورڈ سیٹ اپ
بورڈ کو مناسب جمپر سیٹنگز کے ساتھ ترتیب دیا جانا چاہیے جیسا کہ ہارڈ ویئر یوزر مینوئل (UM3483) میں بیان کیا گیا ہے۔ مناسب فعالیت کو یقینی بنانے اور ممکنہ مسائل سے بچنے کے لیے ان ہدایات پر احتیاط سے عمل کرنا ضروری ہے۔
سسٹم سیٹ اپ گائیڈ
یہ سیکشن اس بات کی وضاحت کرتا ہے کہ X-NUCLEO-ISO1A1 توسیعی بورڈ کے ساتھ STM32 Nucleo، NUCLEO-G071RB بورڈ پر ایپلیکیشن تیار کرنے اور اس پر عمل کرنے سے پہلے ہارڈ ویئر کے مختلف حصوں کو کیسے ترتیب دیا جائے۔
X-CUBE-ISO1 توسیعی پیکیج کے لیے سیٹ اپ
X-NUCLEO-ISO1A1 کو مخصوص جمپر پوزیشنز کے ساتھ کنفیگر کیا جانا چاہیے جس کی بنیاد پر آپ بورڈ چلا رہے ہیں۔ جس کی تفصیلات ہم ہارڈ ویئر مینوئل میں مزید دیکھ سکتے ہیں۔
- مرحلہ 1۔ X-NUCLEO-ISO1A1 توسیعی بورڈ کو مورفو کنیکٹرز کے ذریعے STM32 نیوکلیو کے اوپر لگائیں۔
اگر آپ ایک دوسرے کے اوپر دو تختے استعمال کر رہے ہیں، تو انہیں تصویر 11 کی طرح اسٹیک کریں۔ - مرحلہ 2۔ بورڈ کو پاور کرنے کے لیے USB کنیکٹر CN1 کے ذریعے USB کیبل کے ساتھ STM32 نیوکلیو بورڈ کو پی سی سے جوڑیں۔
- مرحلہ 3۔ J1 کو 24V DC پاور سپلائی سے جوڑ کر X-NUCLEO-ISO1A1 توسیعی بورڈ کو آن کریں۔ اگر اسٹیکڈ بورڈز استعمال کررہے ہیں تو یقینی بنائیں کہ دونوں بورڈز پاورڈ ہیں۔
- مرحلہ 4۔ اپنا پسندیدہ ٹول چین کھولیں (Keil سے MDK-ARM، IAR سے EWARM، یا STM32CubeIDE)۔
- مرحلہ 5۔ سافٹ ویئر پروجیکٹ کھولیں اور board_config.h میں ضروری تبدیلیاں کریں۔ file استعمال کیے جانے والے بورڈ (زبانیں) کی ترتیب کے مطابق۔
- مرحلہ 6۔ st_iso_app.c میں مناسب استعمال کیس میکرو سیٹ کریں۔ file یا main.c میں ST_ISO_APP_SelectUseCase فنکشن کا استعمال کرتے ہوئے مطلوبہ استعمال کیس کو کال کریں۔ file کسی دوسرے مطلوبہ فنکشن کے ساتھ۔
- مرحلہ 7۔ سب کو مرتب کرنے کے لیے پروجیکٹ بنائیں files اور مرتب شدہ کوڈ کو STM32 نیوکلیو بورڈ کی میموری میں لوڈ کریں۔
- مرحلہ 8۔ کوڈ کو STM32 نیوکلیو بورڈ پر چلائیں اور متوقع رویے کی تصدیق کریں۔
نظرثانی کی تاریخ
جدول 4۔ دستاویز پر نظر ثانی کی تاریخ
| تاریخ | نظر ثانی | تبدیلیاں |
| 14-مئی-2025 | 1 | ابتدائی رہائی۔ |
اہم نوٹس - غور سے پڑھیں
STMicroelectronics NV اور اس کے ذیلی ادارے ("ST") بغیر اطلاع کے کسی بھی وقت ST مصنوعات اور/یا اس دستاویز میں تبدیلیاں، تصحیحات، اضافہ، ترمیمات اور بہتری کا حق محفوظ رکھتے ہیں۔ خریداروں کو آرڈر دینے سے پہلے ST مصنوعات کے بارے میں تازہ ترین متعلقہ معلومات حاصل کرنی چاہیے۔ ST پروڈکٹس کو آرڈر کی منظوری کے وقت ST کی فروخت کی شرائط و ضوابط کے مطابق فروخت کیا جاتا ہے۔
خریدار ST مصنوعات کے انتخاب، انتخاب اور استعمال کے لیے مکمل طور پر ذمہ دار ہیں اور ST درخواست کی مدد یا خریداروں کی مصنوعات کے ڈیزائن کے لیے کوئی ذمہ داری قبول نہیں کرتا ہے۔
یہاں ST کے ذریعہ کسی بھی دانشورانہ املاک کے حق کو کوئی لائسنس، ایکسپریس یا مضمر نہیں دیا گیا ہے۔
یہاں بیان کردہ معلومات سے مختلف دفعات کے ساتھ ST مصنوعات کی دوبارہ فروخت ایسی مصنوعات کے لیے ST کی طرف سے دی گئی کسی بھی وارنٹی کو کالعدم قرار دے گی۔
ST اور ST لوگو ST کے ٹریڈ مارک ہیں۔ ST ٹریڈ مارکس کے بارے میں اضافی معلومات کے لیے www.st.com/trademarks سے رجوع کریں۔ دیگر تمام پروڈکٹ یا سروس کے نام ان کے متعلقہ مالکان کی ملکیت ہیں۔
اس دستاویز میں موجود معلومات اس دستاویز کے کسی بھی سابقہ ورژن میں پہلے سے فراہم کردہ معلومات کی جگہ لے لیتی ہے۔
© 2025 STMicroelectronics – جملہ حقوق محفوظ ہیں۔
دستاویزات / وسائل
 |
STMicroelectronics UM3469 X-CUBE-ISO1 سافٹ ویئر کی توسیع [پی ڈی ایف] یوزر مینوئل X-NUCLEO-ISO1A1, NUCLEO-G071RB, UM3469 X-CUBE-ISO1 سافٹ ویئر کی توسیع, UM3469, X-CUBE-ISO1 سافٹ ویئر کی توسیع, سافٹ ویئر کی توسیع |