ESPRESSIF ESP32-JCI-R ترقیاتی بورڈز

اس گائڈ کے بارے میں

اس دستاویز کا مقصد صارفین کو ESP32-JCI-R ماڈیول پر مبنی ہارڈ ویئر کا استعمال کرتے ہوئے ایپلی کیشنز تیار کرنے کے لیے بنیادی سافٹ ویئر ڈویلپمنٹ ماحول قائم کرنے میں مدد کرنا ہے۔

ریلیز نوٹس

تاریخ	ورژن	ریلیز نوٹس
2020.7	V0.1	ابتدائی ریلیز۔

دستاویزی تبدیلی کی اطلاع

ایسپریسیف صارفین کو تکنیکی دستاویزات میں ہونے والی تبدیلیوں پر اپ ڈیٹ رکھنے کے لیے ای میل اطلاعات فراہم کرتا ہے۔ پر سبسکرائب کریں www.espressif.com/en/subscribe۔

سرٹیفیکیشن

سے Espressif مصنوعات کے لیے سرٹیفکیٹ ڈاؤن لوڈ کریں۔ www.espressif.com/en/certificates۔

تعارف

ESP32-JCI-R

ESP32-JCI-R ایک طاقتور، عام Wi-Fi+BT+BLE MCU ماڈیول ہے جو مختلف قسم کی ایپلی کیشنز کو نشانہ بناتا ہے، جس میں کم طاقت والے سینسر نیٹ ورکس سے لے کر انتہائی ضروری کاموں، جیسے وائس انکوڈنگ، میوزک اسٹریمنگ اور MP3 ڈی کوڈنگ شامل ہیں۔ . اس ماڈیول کے مرکز میں ESP32-D0WD-V3 چپ ہے۔ سرایت شدہ چپ توسیع پذیر اور موافقت پذیر ہونے کے لیے ڈیزائن کی گئی ہے۔ دو سی پی یو کور ہیں جنہیں انفرادی طور پر کنٹرول کیا جا سکتا ہے، اور سی پی یو کلاک فریکوئنسی 80 میگا ہرٹز سے 240 میگاہرٹز تک ایڈجسٹ ہوتی ہے۔ صارف CPU کو بھی بند کر سکتا ہے اور کم طاقت والے کو-پروسیسر کا استعمال کر سکتا ہے تاکہ تبدیلیوں یا حدوں کو عبور کرنے کے لیے پیری فیرلز کی مسلسل نگرانی کر سکے۔ ESP32 پیری فیرلز کے ایک بھرپور سیٹ کو مربوط کرتا ہے، جس میں کیپسیٹیو ٹچ سینسرز، ہال سینسرز، SD کارڈ انٹرفیس، ایتھرنیٹ، تیز رفتار SPI،UART، I2S اور I2C شامل ہیں۔ بلوٹوتھ، بلوٹوتھ ایل ای اور وائی فائی کا انضمام اس بات کو یقینی بناتا ہے کہ ایپلی کیشنز کی ایک وسیع رینج کو نشانہ بنایا جا سکتا ہے اور یہ ماڈیول مستقبل کا ثبوت ہے: وائی فائی کا استعمال ایک بڑی فزیکل رینج اور وائی فائی کے ذریعے انٹرنیٹ سے براہ راست کنکشن کی اجازت دیتا ہے۔ بلوٹوتھ کا استعمال کرتے ہوئے روٹر صارف کو آسانی سے فون سے جڑنے یا اس کی کھوج کے لیے کم توانائی والے بیکنز نشر کرنے کی اجازت دیتا ہے۔ ESP32 چپ کا نیند کا کرنٹ 5 μA سے کم ہے، جو اسے بیٹری سے چلنے والے اور پہننے کے قابل الیکٹرانکس ایپلی کیشنز کے لیے موزوں بناتا ہے۔ ESP32 وسیع ترین فزیکل رینج کو یقینی بنانے کے لیے اینٹینا میں 150 Mbps تک ڈیٹا ریٹ اور 20 dBm آؤٹ پٹ پاور کو سپورٹ کرتا ہے۔ اس طرح یہ چپ صنعت کی معروف تصریحات اور الیکٹرانک انضمام، رینج، بجلی کی کھپت، اور کنیکٹیویٹی کے لیے بہترین کارکردگی پیش کرتی ہے۔ ESP32 کے لیے منتخب کردہ آپریٹنگ سسٹم LwIP کے ساتھ freeRTOS ہے۔ ہارڈویئر ایکسلریشن کے ساتھ TLS 1.2 بھی بلٹ ان ہے۔ سیکیور (انکرپٹڈ) اوور دی ایئر (OTA) اپ گریڈ کو بھی سپورٹ کیا جاتا ہے تاکہ ڈویلپرز اپنی مصنوعات کی رہائی کے بعد بھی مسلسل اپ گریڈ کر سکیں۔

ESP-IDF

Espressif IoT ڈویلپمنٹ فریم ورک (ESP-IDF مختصراً) Espressif ESP32 پر مبنی ایپلیکیشنز تیار کرنے کا ایک فریم ورک ہے۔ صارفین ESP-IDF کی بنیاد پر Windows/Linux/MacOS میں ایپلیکیشن تیار کر سکتے ہیں۔

تیاری

ESP32-JCI-R کے لیے درخواستیں تیار کرنے کے لیے آپ کو ضرورت ہے:

• پی سی یا تو ونڈوز، لینکس یا میک آپریٹنگ سسٹم سے بھرا ہوا ہے۔
• ESP32 کے لیے درخواست بنانے کے لیے ٹول چین
• ESP-IDF بنیادی طور پر ESP32 کے لیے API اور ٹول چین کو چلانے کے لیے اسکرپٹ پر مشتمل ہے۔
• سی میں پروگرام (پروجیکٹس) لکھنے کے لیے ایک ٹیکسٹ ایڈیٹر، جیسے، ایکلیپس
• ESP32 بورڈ خود اور اسے پی سی سے منسلک کرنے کے لیے ایک USB کیبل

شروع کریں

ٹول چین سیٹ اپ

ESP32 کے ساتھ ترقی شروع کرنے کا تیز ترین طریقہ پہلے سے تیار کردہ ٹول چین کو انسٹال کرنا ہے۔ نیچے اپنا OS اٹھائیں اور فراہم کردہ ہدایات پر عمل کریں۔

• ونڈوز
• لینکس
• میک OS

نوٹ:
ہم پہلے سے تعمیر شدہ ٹول چین، ESP-IDF اور s کو انسٹال کرنے کے لیے ~/esp ڈائریکٹری استعمال کر رہے ہیں۔ampلی ایپلی کیشنز. آپ ایک مختلف ڈائریکٹری استعمال کر سکتے ہیں، لیکن متعلقہ کمانڈز کو ایڈجسٹ کرنے کی ضرورت ہے۔ آپ کے تجربے اور ترجیحات پر منحصر ہے، پہلے سے تیار کردہ ٹول چین استعمال کرنے کے بجائے، آپ اپنے ماحول کو اپنی مرضی کے مطابق بنانا چاہتے ہیں۔ سسٹم کو اپنے طریقے سے ترتیب دینے کے لیے ٹول چین کے حسب ضرورت سیٹ اپ سیکشن پر جائیں۔
ایک بار جب آپ ٹول چین سیٹ اپ کر لیں تو پھر سیکشن حاصل کریں ESP-IDF پر جائیں۔

ESP-IDF حاصل کریں۔

ٹول چین کے علاوہ (جس میں ایپلیکیشن کو مرتب کرنے اور بنانے کے لیے پروگرام ہوتے ہیں)، آپ کو ESP32 مخصوص API/لائبریریوں کی بھی ضرورت ہوتی ہے۔ وہ ESP-IDF ذخیرہ میں Espressif کے ذریعے فراہم کیے جاتے ہیں۔
اسے حاصل کرنے کے لیے، ٹرمینل کھولیں، اس ڈائرکٹری پر جائیں جسے آپ ESP-IDF لگانا چاہتے ہیں، اور git clone کمانڈ کا استعمال کرتے ہوئے اسے کلون کریں:

• cd ~/esp
• git clone - recursive https://github.com/espressif/esp-idf.git 

ESP-IDF کو ~/esp/esp-idf میں ڈاؤن لوڈ کیا جائے گا۔

نوٹ:
recursive آپشن کو مت چھوڑیں۔ اگر آپ پہلے ہی اس اختیار کے بغیر ESP-IDF کلون کر چکے ہیں، تو تمام ذیلی ماڈلز حاصل کرنے کے لیے ایک اور کمانڈ چلائیں:

• cd ~/esp/esp-idf
• git submodule update -init

ESP-IDF کا راستہ ترتیب دیں۔ 

ٹول چین پروگرام IDF_PATH ماحولیاتی متغیر کا استعمال کرتے ہوئے ESP-IDF تک رسائی حاصل کرتے ہیں۔ یہ متغیر آپ کے پی سی پر ترتیب دیا جانا چاہئے، بصورت دیگر، پروجیکٹس نہیں بنیں گے۔ ترتیب دستی طور پر کی جا سکتی ہے، ہر بار جب پی سی دوبارہ شروع ہوتا ہے۔ دوسرا آپشن صارف پروفائل میں IDF_PATH کی وضاحت کرکے اسے مستقل طور پر ترتیب دینا ہے۔ ایسا کرنے کے لیے IDF_PATH کو صارف کی پروفائل میں شامل کریں میں دی گئی ہدایات پر عمل کریں۔

ایک پروجیکٹ شروع کریں

اب آپ ESP32 کے لیے اپنی درخواست تیار کرنے کے لیے تیار ہیں۔ تیزی سے شروع کرنے کے لیے، ہم سابق سے hello_world پروجیکٹ استعمال کریں گے۔ampIDF میں les ڈائریکٹری۔
get-started/hello_world کو ~/esp ڈائریکٹری میں کاپی کریں:

• cd ~/esp
• cp -r $IDF_PATH/examples/get-started/hello_world۔

آپ سابق کی ایک رینج بھی تلاش کر سکتے ہیں۔ampسابق کے تحت لی منصوبوںampESP-IDF میں les ڈائریکٹری۔ یہ سابقample پروجیکٹ ڈائریکٹریز کو اسی طرح کاپی کیا جاسکتا ہے جیسا کہ اوپر پیش کیا گیا ہے، آپ کے اپنے پروجیکٹ شروع کرنے کے لیے۔

نوٹ:
ESP-IDF تعمیراتی نظام ESP-IDF یا منصوبوں کے راستوں میں خالی جگہوں کی حمایت نہیں کرتا ہے۔

جڑیں۔

آپ تقریباً وہاں ہیں۔ مزید آگے بڑھنے کے قابل ہونے کے لیے، ESP32 بورڈ کو PC سے جوڑیں، چیک کریں کہ بورڈ کس سیریل پورٹ کے نیچے نظر آرہا ہے اور تصدیق کریں کہ آیا سیریل کمیونیکیشن کام کرتی ہے۔ اگر آپ کو یقین نہیں ہے کہ اسے کیسے کرنا ہے، ESP32 کے ساتھ سیریل کنکشن قائم کریں میں دی گئی ہدایات کو چیک کریں۔ پورٹ نمبر نوٹ کریں، کیونکہ اگلے مرحلے میں اس کی ضرورت ہوگی۔

ترتیب دیں۔

ٹرمینل ونڈو میں ہونے کی وجہ سے، cd ~/esp/hello_world ٹائپ کرکے hello_world ایپلی کیشن کی ڈائرکٹری میں جائیں۔ پھر پروجیکٹ کنفیگریشن یوٹیلیٹی مینو کنفگ شروع کریں:

• cd ~/esp/hello_world make menuconfig

اگر پچھلے اقدامات درست طریقے سے کیے گئے ہیں، تو درج ذیل مینو ظاہر ہوگا۔

مینو میں، سیریل پورٹ کو کنفیگر کرنے کے لیے سیریل فلیشر ترتیب > ڈیفالٹ سیریل پورٹ پر جائیں، جہاں پراجیکٹ کو لوڈ کیا جائے گا۔ انٹر دباکر انتخاب کی تصدیق کریں، محفوظ کریں۔
منتخب کرکے ترتیب ، اور پھر منتخب کرکے ایپلیکیشن سے باہر نکلیں۔ .

نوٹ:
ونڈوز پر، سیریل پورٹس کے نام COM1 جیسے ہوتے ہیں۔ macOS پر، وہ /dev/cu سے شروع ہوتے ہیں۔ لینکس پر، وہ /dev/tty سے شروع ہوتے ہیں۔ (مکمل تفصیلات کے لیے ESP32 کے ساتھ سیریل کنکشن قائم کریں دیکھیں۔)

نیویگیشن اور مینو کنفگ کے استعمال کے بارے میں کچھ نکات یہ ہیں:

• مینو نیویگیٹ کرنے کے لیے اپ اور نیچے تیر والے بٹنوں کو سیٹ کریں۔
• ذیلی مینیو میں جانے کے لیے Enter کلید، باہر جانے یا باہر نکلنے کے لیے Escape کلید استعمال کریں۔
• قسم؟ مدد کی سکرین دیکھنے کے لیے۔ Enter کلید ہیلپ اسکرین سے باہر نکلتی ہے۔
• اسپیس کلید، یا Y اور N کیز کو چالو کرنے کے لیے (ہاں) اور (نہیں) کنفیگریشن آئٹمز کو چیک باکسز "[*]" کے ساتھ غیر فعال کریں۔
• دبانا۔ کنفیگریشن آئٹم کو ہائی لائٹ کرتے وقت اس آئٹم کے بارے میں مدد دکھاتی ہے۔
• کنفیگریشن آئٹمز کو تلاش کرنے کے لیے / ٹائپ کریں۔

نوٹ:
اگر آپ آرک لینکس کے صارف ہیں، تو SDK ٹول کنفیگریشن پر جائیں اور Python 2 ترجمان کا نام python سے python2 میں تبدیل کریں۔

بنائیں اور فلیش کریں۔

اب آپ ایپلیکیشن بنا اور فلش کر سکتے ہیں۔ رن:

فلیش بنائیں

یہ ایپلیکیشن اور تمام ESP-IDF اجزاء کو مرتب کرے گا، بوٹ لوڈر، پارٹیشن ٹیبل، اور ایپلیکیشن بائنریز تیار کرے گا، اور ان بائنریز کو آپ کے ESP32 بورڈ میں پھینک دے گا۔

اگر کوئی مسئلہ نہیں ہے تو، تعمیراتی عمل کے اختتام پر، آپ کو لوڈنگ کے عمل کی پیشرفت کو بیان کرنے والے پیغامات دیکھنا چاہیے۔ آخر میں، اختتامی ماڈیول دوبارہ ترتیب دیا جائے گا اور "hello_world" ایپلیکیشن شروع ہو جائے گی۔ اگر آپ میک چلانے کے بجائے ایکلیپس IDE استعمال کرنا چاہتے ہیں تو Eclipse IDE کے ساتھ بلڈ اینڈ فلیش کو چیک کریں۔

مانیٹر

یہ دیکھنے کے لیے کہ آیا "hello_world" ایپلیکیشن واقعی چل رہی ہے، ٹائپ کرتا ہے مانیٹر۔ یہ کمانڈ IDF مانیٹر ایپلیکیشن شروع کر رہا ہے:

نیچے دی گئی کئی سطریں، اسٹارٹ اپ اور تشخیصی لاگ کے بعد، آپ کو "Hello world!" دیکھنا چاہیے۔ درخواست کے ذریعہ پرنٹ آؤٹ۔

مانیٹر سے باہر نکلنے کے لیے شارٹ کٹ Ctrl+] استعمال کریں۔

نوٹ:
اگر اوپر کے پیغامات کی بجائے، آپ کو اپ لوڈ کے فوراً بعد بے ترتیب کوڑا یا مانیٹر ناکام نظر آتا ہے، تو آپ کا بورڈ ممکنہ طور پر 26MHz کرسٹل استعمال کر رہا ہے، جبکہ ESP-IDF 40MHz کا ڈیفالٹ فرض کرتا ہے۔ مانیٹر سے باہر نکلیں، مینو کنفگ پر واپس جائیں، CONFIG_ESP32_XTAL_FREQ_SEL کو 26MHz میں تبدیل کریں، پھر ایپلیکیشن کو دوبارہ بنائیں اور فلیش کریں۔ یہ اجزاء کی ترتیب -> ESP32 مخصوص - مین XTAL فریکوئنسی کے تحت میک مینو کنفگ کے تحت پایا جاتا ہے۔ میک فلیش اور ایک ہی بار میں مانیٹر بنانے کے لیے میس فلیش مانیٹر ٹائپ کریں۔ آسان شارٹ کٹس اور اس ایپلی کیشن کو استعمال کرنے کے بارے میں مزید تفصیلات کے لیے IDF مانیٹر کا سیکشن چیک کریں۔ ESP32 کے ساتھ شروع کرنے کے لیے آپ کو بس اتنا ہی درکار ہے! اب آپ کسی اور سابق کو آزمانے کے لیے تیار ہیں۔amples یا اپنی خود کی ایپلی کیشنز تیار کرنے کے لئے سیدھے جائیں۔

دستبرداری اور کاپی رائٹ نوٹس
اس دستاویز میں معلومات بشمول۔ URL حوالہ جات، نوٹس کے بغیر تبدیلی کے تابع ہے۔ یہ دستاویز کسی بھی قسم کی وارنٹی کے بغیر فراہم کی گئی ہے، بشمول تجارتی، غیر خلاف ورزی، کسی بھی خاص مقصد کے لیے فٹنس، یا کسی بھی وارنٹی سے متعلق غیر قانونی تحفظ کی ضمانت کے بغیرAMPایل ای اس دستاویز میں معلومات کے استعمال سے متعلق کسی بھی ملکیتی حقوق کی خلاف ورزی کی ذمہ داری سمیت تمام ذمہ داریوں کو مسترد کر دیا گیا ہے۔ یہاں کسی بھی دانشورانہ املاک کے حقوق کے لیے کوئی لائسنس ظاہر یا تقلید نہیں دیا گیا ہے۔ Wi-Fi الائنس ممبر لوگو Wi-Fi الائنس کا ٹریڈ مارک ہے۔ بلوٹوتھ لوگو بلوٹوتھ SIG کا رجسٹرڈ ٹریڈ مارک ہے۔ اس دستاویز میں مذکور تمام تجارتی نام، ٹریڈ مارک، اور رجسٹرڈ ٹریڈ مارکس ان کے متعلقہ مالکان کی ملکیت ہیں اور اس کا اعتراف کیا جاتا ہے۔
کاپی رائٹ © 2018 Espressif Inc. جملہ حقوق محفوظ ہیں۔

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

ESPRESSIF ESP32-JCI-R ترقیاتی بورڈز [پی ڈی ایف] یوزر مینوئل ESP32JCIR, 2AC7Z-ESP32JCIR, 2AC7ZESP32JCIR, ESP32-JCI-R, ترقیاتی بورڈز, ESP32-JCI-R ترقیاتی بورڈز, بورڈز

حوالہ جات

• صارف دستی