
أداة اختراق عتاد مع واجهة سطر أوامر قائمة على الويب تتحدث جميع البروتوكولات
# ESP32 Bit Pirate
[](https://geo-tp.github.io/ESP32-Bit-Pirate/)
**ESP32 Bit Pirate** هو برنامج ثابت مفتوح المصدر يحوّل جهازك إلى أداة تطوير وتحليل متعددة البروتوكولات، مستوحى من Bus Pirate الأسطوري.
يدعم التقاط الحزم وإرسالها والبرمجة النصية والتفاعل مع بروتوكولات رقمية متنوعة (I2C، UART، 1-Wire، SPI، إلخ) عبر طرفية تسلسلية أو واجهة سطر أوامر قائمة على الويب. كما يتواصل مع بروتوكولات راديوية مثل Bluetooth وWi-Fi وSub-GHz وLoRa وRFID.
موقع المشروع الرسمي يجمع كل شيء في مكان واحد: [موقع ESP32 Bit Pirate](https://geo-tp.github.io/ESP32-Bit-Pirate/).
من هناك يمكنك [تثبيت البرنامج الثابت](https://geo-tp.github.io/ESP32-Bit-Pirate/webflasher/)، وفتح [الأدوات الويب](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/)، ومتابعة [أدلة العتاد](https://geo-tp.github.io/ESP32-Bit-Pirate/hardware/)، واستكشاف [الوصفات](https://geo-tp.github.io/ESP32-Bit-Pirate/recipes/)، والوصول إلى [التوثيق](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki).

[](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/)
## الميزات
- واجهة سطر أوامر تفاعلية (CLI) عبر **USB Serial أو WiFi Web**.
- **أوضاع لـ:**
- [HiZ](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/01-HiZ) (افتراضي)
- [I2C](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/05-I2C) (scan, glitch, slave mode, dump, eeprom)
- [SPI](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/06-SPI) (eeprom, flash, sdcard, slave mode)
- [UART](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/03-UART) / [Half-Duplex UART](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/04-HDUART) (bridge, read, write)
- [1WIRE](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/02-1WIRE) (ibutton, eeprom)
- [2WIRE](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/07-2WIRE) (sniff, smartcard) / [3WIRE](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/08-3WIRE) (eeprom)
- [DIO](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/09-DIO) (Digital I/O, read, pullup, set, pwm)
- [Infrared](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/11-INFRARED) (send, record, universal remote)
- [USB](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/12-USB) (HID, flashrom, storage, usb-uart)
- [Bluetooth](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/13-BLUETOOTH) (BLE HID, scan, spoofing, sniffing)
- [Wi-Fi](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/14-WIFI) / [Ethernet](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/18-ETHERNET) (sniff, deauth, nmap, netcat)
- [JTAG](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/15-JTAG) (scan, SWD, openOCD)
- [LED](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/10-LED) (animations, set LEDs)
- [I2S](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/16-I2S) (test speakers, mic, play sound)
- [CAN](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/17-CAN) (sniff, send and receive frames)
- [SUBGHZ](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/19-SUBGHZ) (analyze, record, replay)
- [RFID](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/20-RFID) (read, write, clone)
- [RF24](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/21-RF24) (scan, send, receive)
- [FM](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/22-FM) (analyze, broadcast)
- [CELL](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/23-CELL) (dump sim card, sms, call)
- [LORA](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/24-LORA) (sniff, payload, meshtatic)
- **أجهزة التقاط البروتوكولات** I2C، UART، SPI، 1Wire، 2wire، CAN، Wi-Fi، Bluetooth، SubGhz.
- **الكشف التلقائي** عن معدل الباود، وأوامر AT وأدوات متنوعة لـ UART.
- معالجة السجلات، **أدوات تفريغ EEPROM**، التعرف على الأجهزة لـ I2C.
- قراءة جميع أنواع **EEPROM وFlash** وأدوات أخرى متنوعة لـ SPI.
- البرمجة النصية باستخدام تعليمات **Bus Pirate-style bytecode** أو **Python**.
- دعم الأشعة تحت الحمراء مع أكثر من **80 بروتوكولاً**.
- إدارة الإدخال/الإخراج المباشر، **PWM، servo، حالة GPIOs**.
- تحليل الإشارات والترددات الراديوية **على جميع النطاقات**.
- دعم ما يقارب **50 بروتوكولاً لعنونة LEDs**.
- **مساعد Pirate** لمساعدتك في استخدام البرنامج الثابت.
- **USB-Uart dongle، مبرمج SPI، محلل منطقي، ESP-SDR** والمزيد.
- [**أدوات Web Serial**](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/) لاستخدام USB Serial عبر متصفح الويب.
## الأجهزة المدعومة
جميع اللوحات المذكورة أدناه توفر نفس ميزات Bit Pirate بالضبط، دون أي اختلافات في الوظائف أو حالة التطوير. قد تتطلب بعض الميزات عتاداً إضافياً.
| الجهاز | | الوصف |
|-----------------------|------------------------------------------|---------------------------------------------------|
| **ESP32 S3 Dev Kit (N8, N8R2, N8R8, N16R8...)** |  | أكثر من 20 GPIO متاح، زر واحد |
| **ESP32 S3 Zero / Super Mini** |  | 15 GPIO (أطراف مكشوفة)، زر واحد |
| [**M5 AtomS3 Lite**](https://shop.m5stack.com/products/atoms3-lite-esp32s3-dev-kit?ref=pvosfmid) | [](https://shop.m5stack.com/products/atoms3-lite-esp32s3-dev-kit?ref=pvosfmid) | 8 GPIO (Grove, Header)، IR TX، زر واحد |
| **M5 Cardputer** |  | 2 GPIO (Grove)، شاشة، لوحة مفاتيح، ميكروفون، مكبر صوت، IR TX، بطاقة SD، بطارية، [وضع مستقل](#standalone-mode-for-the-cardputer) |
| [**M5 Cardputer ADV**](https://shop.m5stack.com/products/m5stack-cardputer-adv-version-esp32-s3?ref=pvosfmid) | [](https://shop.m5stack.com/products/m5stack-cardputer-adv-version-esp32-s3?ref=pvosfmid) | 12 GPIO (Grove, Header)، شاشة، لوحة مفاتيح، ميكروفون، مكبر صوت، IR TX، بطاقة SD، IMU، بطارية، [Lora](https://shop.m5stack.com/products/cap-lora-1262-for-cardputer-adv-sx1262-atgm336h?ref=pvosfmid)، [CC1101](https://shop.m5stack.com/products/cap-cc1101-nfc-for-cardputer?ref=pvosfmid)، [وضع مستقل](#standalone-mode-for-the-cardputer) |
| [**M5 StampS3**](https://shop.m5stack.com/products/m5stamps3a-with-2-54-header-pin?ref=pvosfmid) | [](https://shop.m5stack.com/products/m5stamps3a-with-2-54-header-pin?ref=pvosfmid) | 9 GPIO (أطراف مكشوفة)، زر واحد |
| [**M5 Stick S3**](https://shop.m5stack.com/products/m5sticks3-esp32s3-mini-iot-dev-kit?ref=pvosfmid) | [](https://shop.m5stack.com/products/m5sticks3-esp32s3-mini-iot-dev-kit?ref=pvosfmid) | 13 GPIO (Grove, Header)، شاشة، ميكروفون، مكبر صوت، IR TX، IR RX، IMU، 3 أزرار، بطارية |
| **LILYGO T-Display** |  | 13 GPIO (1 Qwicc)، شاشة، زرّان |
| **LILYGO T-Embed** |  | 9 GPIO (Grove, Header)، شاشة، مُرمِّز، مكبر صوت، ميكروفون، بطاقة SD |
| **LILYGO T-Embed CC1101** |  | 4 GPIO (2x Qwiic)، شاشة، مُرمِّز، مكبر صوت، ميكروفون، بطاقة SD، CC1101، PN532، IR TX، IR RX، بطارية |
| **LILYGO T-Embed CC1101 Plus** |  | 4 GPIO (2x Qwiic)، شاشة، مُرمِّز، مكبر صوت، ميكروفون، بطاقة SD، CC1101، NRF24، PN532، IR TX، IR RX، بطارية |
| **Heltec WiFi LoRa 32 V4** |  | 15 GPIO (Header)، SX1262 LoRa، زرّان، **الشاشة غير مدعومة** |
| **Heltec Vision Master T190** |  | 15 GPIO (Header, Qwiiic)، شاشة، زرّان، SX1262 LoRa |
| **Seeed Studio Xiao S3** |  | 9 GPIO (أطراف مكشوفة)، زر واحد |
| **Waveshare ESP32-S3-GEEK** |  | 7 GPIO (Dupont header)، شاشة، زر واحد، بطاقة SD |
| **Unexpected Maker ProS3**| [](https://www.adafruit.com/product/5401) | أكثر من 20 GPIO متاح (Header, STEMMA QT)، زر واحد|
- **لوحات أخرى قائمة على ESP32-S3**
- يمكن دعم **جميع اللوحات القائمة على ESP32-S3**، بشرط أن تحتوي على **4 MB من flash** على الأقل.
- يمكنك **حرق برنامج s3 dev-kit (8MB flash) أو supermini (4MB flash) الثابت على أي لوحة ESP32-S3.**
- ضع في اعتبارك أن **تعيين الأطراف الافتراضي في البرنامج الثابت قد لا يتطابق** مع لوحتك المحددة.
## البدء
[](https://geo-tp.github.io/ESP32-Bit-Pirate/webflasher/)
1. 🔧 احرق البرنامج الثابت
- استخدم [أداة حرق ESP32 Bit Pirate الويب](https://geo-tp.github.io/ESP32-Bit-Pirate/webflasher/) لحرق البرنامج الثابت مباشرة من متصفح الويب.
- يمكنك أيضاً حرقه على [M5Burner](https://docs.m5stack.com/en/download)، في فئة StickS3 أو AtomS3 أو M5StampS3 أو Cardputer.
2. 🔌 اتصل عبر Serial أو Web
- Serial: أي تطبيق طرفية، أو [طرفية Web Serial المجانية القائمة على المتصفح](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/web-serial-terminal/) (انظر [الاتصال عبر Serial](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Serial))
- Web: اضبط Wi-Fi وادخل إلى CLI عبر المتصفح (انظر [اتصال Wi-Fi](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/00-Terminal))
3. 🧪 استخدم أوامر مثل:
```
mode
help
scan
sniff
...
```
## الويكي
[](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/)
📚 **[قم بزيارة الويكي](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki)** للحصول على توثيق مفصل لكل وضع وأمر.
يتضمن:
- [وضع الطرفية](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/00-Terminal) - حول الطرفية التسلسلية والويب.
- [نظرة عامة على الأوضاع](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki) - تصفح الأوضاع المدعومة.
- [إعداد Serial](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Serial) - الوصول التسلسلي عبر USB.
الويكي هو أفضل مكان لتعلم كيفية عمل كل شيء.
## البرمجة النصية
[](https://github.com/geo-tp/ESP32-Bit-Pirate-Scripts/)
🛠️ [**أتمتة التفاعلات مع ESP32 Bit Pirate**](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Python) باستخدام **نصوص Python عبر serial.**
يمكنك كتابة واختبار النصوص مباشرة في المتصفح باستخدام [ESP32 Bit Pirate Python Lab](https://geo-tp.github.io/ESP32-Bit-Pirate/web-tools/python-lab/).
**بما في ذلك:** تسجيل البيانات في ملف، تفريغ eeprom وflash، التفاعل مع GPIOs، تحريك LED...
## الموسّع
[](https://github.com/geo-tp/ESP32-Bus-Expander)
🔌 **[وسّع قدرات ESP32 Bit Pirate](https://github.com/geo-tp/ESP32-Bus-Expander)** بوحدات عتاد إضافية.
يضيف الموسّع دعماً لـ **WiFi 5 GhZ وZigbee** أو بروتوكولات راديوية أخرى.
[](https://github.com/geo-tp/ESP32-Bus-Expander)
## قاعدة التوصيل
[](https://github.com/AndreiVladescu/ESP32-Bit-Pirate-Dock)
🔧 **[قاعدة توصيل لـ ESP32 S3 DevKit](https://github.com/AndreiVladescu/ESP32-Bit-Pirate-Dock) مصممة للعمل مع محولات Bus Pirate الأصلية.**
تتيح لك توصيل واستخدام منظومة المحولات والملحقات الأصلية لـ [Bus Pirate](https://buspirate.com/).
[](https://www.pcbway.com/project/shareproject/ESP32_Bit_Pirate_Dock_ca02ded7.html)
[**احصل على ESP32 Bit Pirate Dock على PCBWay.**](https://www.pcbway.com/project/shareproject/ESP32_Bit_Pirate_Dock_ca02ded7.html)
[](https://www.pcbway.com/project/shareproject/ESP32_Bit_Pirate_Dock_ca02ded7.html)
## واجهات سطر الأوامر
يوفر برنامج ESP32 Bit Pirate الثابت ثلاثة أوضاع لواجهة سطر الأوامر (CLI):
| الواجهة | المزايا | مثالية لـ... |
|------------------|-----------------------------------------------------------------------------|----------------------------------------|
| **واجهة الويب** | - يمكن الوصول إليها من أي متصفح<br>- حاسوب، أجهزة لوحية، هواتف محمولة<br>- تعمل عبر Wi-Fi<br>- لا حاجة لكابلات | الاختبارات السريعة، العروض التوضيحية، الإعدادات بدون شاشة |
| **واجهة Serial** | - أداء أسرع<br>- استجابة فورية<br>- تتعامل مع البيانات الكبيرة بسلاسة | الجلسات المكثفة، التفاعلات المتكررة |
| **مستقل** | - فقط لـ Cardputer<br>- لوحة مفاتيح على الجهاز<br>- شاشة على الجهاز | الجلسات المحمولة، الاختبارات السريعة |
تشترك جميع الواجهات في نفس بنية الأوامر ويمكن استخدامها بالتبادل ([مزيد من التفاصيل](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/00-Terminal)).
## واجهة الويب للهواتف المحمولة عبر WiFi

## الوضع المستقل لـ Cardputer

## المساهمة
انظر قسم [كيفية المساهمة](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Contribute)، الذي يوضح **طريقة بسيطة لإضافة لوحة جديدة أو أمر جديد**.
## الأصول المرئية
#### [](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Visual-Assets)
انظر [الصور، الشعار، العروض التقديمية، الصور الفوتوغرافية، الفيديو، الرسوم التوضيحية](https://github.com/geo-tp/ESP32-Bit-Pirate/wiki/99-Visual-Assets). يمكن **استخدام هذه المرئيات بحرية في منشورات المدونات والتوثيق والفيديوهات والمقالات** للمساعدة في شرح البرنامج الثابت والترويج له.
## تحذير
> ⚠️ **تحذير الجهد الكهربائي**: يجب تشغيل الأجهزة فقط عند **3.3V** أو **5V**.
> - **لا** توصل الأجهزة الطرفية باستخدام مستويات جهد أخرى — فقد يؤدي ذلك إلى **إتلاف ESP32 الخاص بك**.
> ⚠️ **تحذير الاستخدام**: يُقدَّم هذا البرنامج الثابت **لأغراض تعليمية وتشخيصية واختبار التوافق التشغيلي فقط**.
> - لا تستخدمه للتداخل مع الأجهزة أو فحصها أو التلاعب بها دون تصريح مناسب.
> - تجنب أي إرسالات RF غير مصرح بها (مثل sub-GHz) قد تنتهك اللوائح المحلية أو تعطّل الشبكات والاتصالات.
> - المؤلفون غير مسؤولين عن أي إساءة استخدام لهذا البرنامج أو العتاد، بما في ذلك العواقب القانونية الناتجة عن الوصول غير المصرح به أو إرسال الإشارات.
> - ابقَ دائماً ضمن حدود قوانين بلدك وسياسات الإفصاح المسؤول.