ESP32 Bit Pirate

ESP32 Bit Pirate هو برنامج ثابت مفتوح المصدر يحوّل جهازك إلى أداة تطوير وتحليل متعددة البروتوكولات، مستوحى من أداة Bus Pirate الأسطورية.

يدعم التنصت (Sniffing) والإرسال والبرمجة النصية والتفاعل مع مختلف البروتوكولات الرقمية (I2C، UART، 1-Wire، SPI، إلخ) عبر طرفية تسلسلية أو واجهة أوامر قائمة على الويب. كما يتواصل مع بروتوكولات لاسلكية مثل Bluetooth وWi-Fi وSub-GHz وRFID.

الموقع الرسمي للمشروع يجمع كل شيء في مكان واحد: موقع ESP32 Bit Pirate.

من هناك يمكنك تثبيت البرنامج الثابت، وفتح الأدوات عبر الويب، ومتابعة أدلة العتاد، واستكشاف الوصفات، والوصول إلى التوثيق.

الميزات

• واجهة أوامر تفاعلية (CLI) عبر USB Serial أو WiFi Web.

• أوضاع (Modes) لـ:

  • HiZ (الافتراضي)
  • I2C (مسح، إحداث خلل، وضع التابع، تفريغ، eeprom)
  • SPI (eeprom، flash، sdcard، وضع التابع)
  • UART / Half-Duplex UART (جسر، قراءة، كتابة)
  • 1WIRE (ibutton، eeprom)
  • 2WIRE (تنصت، بطاقة ذكية) / 3WIRE (eeprom)
  • DIO (إدخال/إخراج رقمي، قراءة، سحب للأعلى، ضبط، pwm)
  • Infrared (إرسال، تسجيل، جهاز تحكم عن بُعد عام)
  • USB (HID، flashrom، تخزين، usb-uart)
  • Bluetooth (BLE HID، مسح، انتحال، تنصت)
  • Wi-Fi / Ethernet (تنصت، deauth، nmap، netcat)
  • JTAG (مسح، SWD، openOCD)
  • LED (رسوم متحركة، ضبط LEDs)
  • I2S (اختبار مكبرات الصوت، ميكروفون، تشغيل الصوت)
  • CAN (تنصت، إرسال واستقبال الإطارات)
  • SUBGHZ (تحليل، تسجيل، إعادة تشغيل)
  • (قراءة، كتابة، استنساخ)

• متشمّات البروتوكولات I2C، UART، SPI، 1Wire، 2wire، CAN، Wi-Fi، Bluetooth، SubGhz.

• الكشف التلقائي عن معدل الباود (Baudrate)، وأوامر AT وأدوات متنوعة لـ UART.

• التلاعب بالسجلات (Registers)، أدوات تفريغ EEPROM، وتحديد الأجهزة لـ I2C.

• قراءة جميع أنواع EEPROM وFlash وأدوات أخرى متنوعة لـ SPI.

• برمجة نصية باستخدام تعليمات bytecode بأسلوب Bus Pirate أو Python.

• أمر Device-B-Gone مع دعم أكثر من 80 بروتوكولًا للأشعة تحت الحمراء (INFRARED).

• إدارة مباشرة للإدخال/الإخراج، حالة PWM وServo وGPIOs.

• تحليل الإشارات والترددات اللاسلكية على جميع النطاقات.

• دعم ما يقارب 50 بروتوكولًا من بروتوكولات LEDs القابلة للعنونة.

• دعم Ethernet وWiFi للوصول إلى الشبكات.

• استيراد وتصدير البيانات باستخدام LittleFS عبر HTTP.

• مساعد القرصان (Pirate Assistant) لمساعدتك في استخدام البرنامج الثابت.

• دونغل USB-Uart، مبرمج SPI، محلل منطقي والمزيد.

• أدوات Web Serial لاستخدام USB Serial عبر متصفح الويب.

الأجهزة المدعومة

• لوحات أخرى مبنية على ESP32-S3

  • جميع اللوحات المبنية على ESP32-S3 مدعومة، بشرط أن تحتوي على ذاكرة فلاش بسعة 8 MB على الأقل.

  • يمكنك وميض برنامج s3 dev-kit الثابت على أي لوحة ESP32-S3.

  • ضع في اعتبارك أن تخطيط الدبابيس الافتراضي في البرنامج الثابت قد لا يتطابق مع لوحتك المحددة.

البدء

1. 🔧 وميض البرنامج الثابت (Flash)

   • استخدم ESP32 Bit Pirate Web Flasher لحرق البرنامج الثابت مباشرة من متصفح الويب.
   • يمكنك أيضًا حرقه عبر M5Burner، ضمن فئة StickS3 أو AtomS3 أو M5StampS3 أو Cardputer.

2. 🔌 الاتصال عبر Serial أو Web

   • Serial: أي تطبيق طرفية، أو طرفية Web Serial المجانية القائمة على المتصفح (انظر الاتصال عبر Serial)
   • Web: قم بإعداد Wi-Fi والوصول إلى CLI عبر المتصفح (انظر اتصال Wi-Fi)

3. 🧪 استخدم أوامر مثل:

   root@kitploit:~

   mode
   help
   scan
   sniff
   ...
   

الويكي

📚 قم بزيارة الويكي للحصول على توثيق مفصّل لكل وضع وأمر.

يتضمن:

• وضع الطرفية - حول الطرفية التسلسلية والويب.
• نظرة عامة على الأوضاع - تصفّح الأوضاع المدعومة.
• إعداد Serial - الوصول التسلسلي عبر USB.

الويكي هو أفضل مكان لتعلّم كيفية عمل كل شيء.

البرمجة النصية

🛠️ أتمتة التفاعلات مع ESP32 Bit Pirate باستخدام نصوص Python عبر Serial.

يمكنك كتابة واختبار النصوص مباشرة في المتصفح باستخدام ESP32 Bit Pirate Python Lab.

يشمل: تسجيل البيانات في ملف، تفريغ eeprom وflash، التفاعل مع GPIOs، تحريك LEDs...

الموسّع (Expander)

🔌 وسّع قدرات ESP32 Bit Pirate بوحدات عتاد إضافية. يضيف الموسّع دعمًا لـ WiFi 5 GhZ أو بروتوكولات لاسلكية أخرى.

قاعدة الإرساء (Dock)

🔧 قاعدة إرساء لـ ESP32 S3 DevKit مصممة للعمل مع محولات Bus Pirate الأصلية. تتيح لك توصيل واستخدام النظام البيئي الأصلي لمحولات وملحقات Bus Pirate.

احصل على ESP32 Bit Pirate Dock من PCBWay.

واجهات سطر الأوامر

يوفر برنامج ESP32 Bit Pirate الثابت ثلاثة أوضاع لواجهة سطر الأوامر (CLI):

تشترك جميع الواجهات في نفس بنية الأوامر ويمكن استخدامها بالتبادل (مزيد من التفاصيل).

واجهة الويب المحمولة عبر WiFi

الوضع المستقل لجهاز Cardputer

أدوات Web Serial القائمة على المتصفح

توفر ESP32 Bit Pirate Web Serial Tools وصولًا مباشرًا إلى Serial CLI من متصفح متوافق، دون الحاجة إلى تثبيت PuTTY أو minicom أو أي تطبيق طرفية آخر.

المساهمة

راجع قسم كيفية المساهمة، الذي يوضح طريقة بسيطة لإضافة أمر جديد إلى أي وضع.

المواد البصرية

راجع الصور، الشعار، العروض التقديمية، الصور الفوتوغرافية، الفيديو، الرسوم التوضيحية. يمكن استخدام هذه المواد البصرية بحرية في منشورات المدونات والوثائق ومقاطع الفيديو أو المقالات للمساعدة في شرح البرنامج الثابت والترويج له.

تحذير

⚠️ تحذير الجهد: يجب أن تعمل الأجهزة فقط عند 3.3V أو 5V.

• لا توصّل الأجهزة الطرفية بمستويات جهد أخرى — فقد يؤدي ذلك إلى تلف جهاز ESP32 لديك.

⚠️ تحذير الاستخدام: يُوفَّر هذا البرنامج الثابت لأغراض تعليمية وتشخيصية واختبار قابلية التشغيل البيني فقط.

• لا تستخدمه للتدخل في الأجهزة أو فحصها أو التلاعب بها دون الحصول على إذن مناسب.
• تجنّب أي إرسالات لاسلكية (RF) غير مصرح بها (مثل sub-GHz) قد تنتهك اللوائح المحلية أو تعطل الشبكات والاتصالات.
• المؤلفون غير مسؤولين عن أي إساءة استخدام لهذا البرنامج أو العتاد، بما في ذلك العواقب القانونية الناتجة عن الوصول غير المصرح به أو إصدار الإشارات.
• التزم دائمًا بحدود قوانين بلدك وسياسات الإفصاح المسؤول.