
كشف نشاط USB أثناء التشغيل
<h1><img width="300" alt="logo, landscape, dark text, transparent background" src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USBvalve_logo_scaled.png"></a></h1> > [!NOTE] > **USBvalve الإصدار 1.0.0** > > تمت إعادة كتابة التطبيق بالكامل: > - تم الابتعاد عن بيئة Arduino IDE، والآن الكود مكتوب لـ [Pi Pico SDK](https://github.com/raspberrypi/pico-sdk) > - تم تقليل الاعتماد على المكتبات الخارجية بشكل كبير > - أصبح دعم مضيف USB لأجهزة السرعة المنخفضة أكثر قوة (ATTiny85، EvilCrow، إلخ) > - العتاد والوظائف لم تتغير تقريبًا، راجع [الملاحظات](https://github.com/cecio/USBvalve#notes-about-bootsel-and-version--100) أدناه للحصول على التفاصيل ### *اكشف نشاط USB على الفور* <p float="left"> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/versions.png" alt="The two models" width="30%" height="30%" /> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USBvalve_PIWATCH.png" alt="The Watch" width="26%" height="26%" /> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/version1_2.png" alt="1.2" width="26%" height="26%" /> </p> أنا متأكد من أنه، مثلي، طُلب منك وضع محرك USB الخاص بك في جهاز *غير معروف*... ثم يأتي الشك: ماذا حدث لمحرك USB المسكين الخاص بي، خلف الكواليس؟ هل يسرق ملفاتي؟ هل يشفرها؟ أم *فقط* يثبّت برمجية خبيثة؟ مع **USBvalve** يمكنك اكتشاف ذلك في ثوانٍ: مبني على عتاد رخيص جدًا متوفر تجاريًا، يمكنك بسرعة اختبار أي نشاط لنظام ملفات USB وفهم ما يحدث قبل فوات الأوان! مع **USBvalve** يمكنك الحصول على تغذية راجعة فورية حول ما يحدث للمحرك؛ ستعرض لك الشاشة ما إذا كان نظام الملفات *المزيف* المبني على الجهاز يتم الوصول إليه أو قراءته أو الكتابة عليه: <p float="left"> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/selftest.png" alt="Selftest" width="15%" height="15%" /> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/readme.png" alt="Readme" width="15%" height="15%" /> </p> وابتداءً من الإصدار `0.8.0` يمكنك أيضًا استخدامه كمضيف USB لاكتشاف أجهزة *BADUSB*: <p float="left"> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/hid.png" alt="HID" width="15%" height="15%" /> </p> هذا مثال على مصحح *BADUSB* المتاح على المنفذ التسلسلي: <p float="left"> <a href="https://asciinema.org/a/NWfC9Mvzzpj3eZfsC7s5Dz1sJ" target="_blank"><img src="https://asciinema.org/a/NWfC9Mvzzpj3eZfsC7s5Dz1sJ.svg" width="65%" height="65%" /></a> </p> إذا كنت تفضل الفيديوهات، يمكنك أيضًا إلقاء نظرة على [عرضي في Insomni'hack](https://www.youtube.com/watch?v=jy1filtQY4w) ## USBvalve Watch ابتداءً من الإصدار `0.15.0` يتم دعم إصدار *Pi Pico Watch* الجديد. لتجميع الإصدار الجديد يجب عليك إلغاء التعليق عن السطر `#define PIWATCH` في بداية الكود. العتاد عبارة عن شاشة TFT مقاس 1.28 بوصة ولوحة ساعة مبنية على RP2040. يمكنك العثور على مزيد من المعلومات [هنا](https://www.raspberrypi.com/news/how-to-build-your-own-raspberry-pi-watch/). هذا متوافق أيضًا بشكل كامل مع [Waveshare RP2040-LCD-1.28](https://www.waveshare.com/wiki/RP2040-LCD-1.28). ## هيكل المستودع `docs`: توثيق حول المشروع، مع عرض تقديمي يمكنك من خلاله الاطلاع على جميع الميزات `firmware`: برامج ثابتة مبنية مسبقًا لـ Raspberry Pi Pico. يمكنك فقط استخدامها وحرقها على اللوحة. لدينا عدة إصدارات مختلفة، لشاشات OLED بـ 32 أو 64 سطرًا، لـ Pico 1 أو Pico2، Pi Pico Watch، إلخ `PCB`: ملف Gerber إذا كنت تريد طباعة لوحة PCB المخصصة. ليس إلزاميًا، يمكنك استخدام لوحتك الخاصة أو بنائها على لوحة تجارب `src` و `data`: المصادر، إذا كنت تريد تعديل وبناء البرنامج الثابت بنفسك `utils`: بعض الأدوات التي قد تستخدمها لبناء نظام ملفات مخصص `pictures`: الصور والموارد المستخدمة في هذا التوثيق `STL`: ملفات STL للغلاف. في مجلدات `1.1` و `1.2` توجد أغلفة كاملة (شكرًا لـ [WhistleMaster](https://github.com/WhistleMaster)). في مجلدات `1.2_64` و `1.2_64_simple` توجد أغلفة لشاشة 128x64 (شكرًا لـ [rtmq0227](https://github.com/rtmq0227)). إذا كنت تريد شيئًا أخف لحماية شاشة LCD يمكنك استخدام `USBvalve_sliding_cover.stl`. ## بناء USBvalve ### قائمة الأجزاء إذا كنت تريد بناء نسختك الخاصة، فأنت بحاجة إلى: - Raspberry Pi Pico 1 أو 2 (أو لوحة أخرى مبنية على RP2040) - شاشة I2C OLED 128x64 أو 128x32 (**SSD1306**) - (اختياري) لوحة **USBvalve** PCB أو لوحة تجارب - (اختياري) فاصل مطبوع ثلاثي الأبعاد لعزل الشاشة عن اللوحة (https://www.thingiverse.com/thing:4748043)، لكن يمكنك استخدام قطعة من الشريط اللاصق الكهربائي بدلاً من ذلك ### ملاحظات حول BOOTSEL والإصدار >= 1.0.0 في إصدارات `0.x.x`، كان BOOTSEL يُستخدم لإعادة تعيين الجهاز أو طباعة عدد أحداث HID (اضغط > ثانيتين). كان استقصاء BOOTSEL يسبب بعض المشاكل في اكتشاف *BADUSB* لذلك تمت إزالته من الإصدار `1.0.0` واستبداله بالخيارين التاليين: - لحام زر بين `GP0` و `GND` (الوسادات 1 و 3، انظر الصورة أدناه لمشاهدة مثال) للحصول على نفس الوظائف - استخدام الأوامر `r` (إعادة تعيين) و `h` (أحداث HID) من مراقب المنفذ التسلسلي <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/reset_button.jpg" width="35%" height="35%" /> في `PCB` ستجد أيضًا إصدار `1.3` من اللوحة، مع بعض الثقوب على الوسادات 1 و 3 لتسهيل تركيب الزر. لكن كما ترى، يمكنك أيضًا استخدام نسختك القديمة. إذا كنت لا تستخدم وظائف *BADUSB* أو إذا كنت تفضل الحصول على تغطية أقل في الاكتشاف مع الحفاظ على استخدام BOOTSEL، فأنا أوفر أيضًا برنامجًا ثابتًا تم إنشاؤه مع تمكين *bootsel* (انظر المجلد والإصدارات). ### تعليمات البناء > شكرًا لـ [Tz1rf](https://github.com/Tz1rf) لدينا أيضًا فيديوهان رائعان: أحدهما يشرح عملية [البناء](https://youtu.be/7ymk8hD7-Hc) خطوة بخطوة، والآخر يوضح كيفية [رفع البرنامج الثابت](https://youtu.be/Tp8xvrlqxUY) واستخدام الأداة. تقريبًا كل العمل يتم مباشرة على اللوحة بواسطة البرنامج، لذلك تحتاج فقط إلى ترتيب الاتصال مع شاشة OLED للإخراج. ابتداءً من الإصدار 0.8.0 من البرنامج الثابت، يمكن لـ **USBvalve** اكتشاف أجهزة HID (المستخدمة لاكتشاف *BADUSB*). هذا يتطلب منفذ USB إضافي يعمل كمضيف. إذا لم تكن مهتمًا بهذا، يمكنك استخدام التعليمات القديمة [في مجلد docs](https://github.com/cecio/USBvalve/blob/main/docs/BUILDING-1.1.md) واستخدام إصدار PCB `1.1`. وإلا فتابع مع إصدار PCB `1.2` (لدينا إصدار لـ USB-A أو USB-B، انظر المجلد). #### مع USBvalve PCB <p float="left"> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USB_valve_1-2_front.png" width="25%" height="25%" /> <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/USB_valve_1-2_back.png" width="24%" height="24%" /> </p> - لحام منفذ USB أنثى في منطقة `USBH`. هذا للإصدار `A`، لكن هناك إصدار لـ USB `Micro-B` أيضًا إذا كنت تفضل ذلك - ضع Raspberry Pi Pico على الطباعة الحريرية في المقدمة - لا تحتاج إلى لحام جميع الأطراف. فقط ما يلي: - D4 و D5 (الجانب الأيسر) - D14 و D15 (الجانب الأيسر) - GND (الجانب الأيمن، الطرف الثالث من الأعلى) - GND (الجانب الأيمن، الطرف الثالث من الأسفل) - 3v3_OUT (الجانب الأيمن) - VBUS (الجانب الأيمن) - أطراف DEBUG الثلاثة في الأسفل: SWCLK و GND و SWDIO - ضع الفاصل المطبوع ثلاثي الأبعاد أو قطعة شريط لاصق على أجزاء شاشة OLED التي قد تلامس Raspberry - لحام شاشة OLED (مع موصل) على مساحة الأطراف الأربعة بعض شاشات OLED لديها أطراف GND و VCC متبادلة، لذلك بنيت لوحة PCB لتكون متوافقة مع كلا الإصدارين: على سبيل المثال إذا كانت شاشتك OLED لديها GND على الطرف PIN1 و VCC على الطرف PIN2 مثل هذا: <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_oled.png" width="35%" height="35%" /> يجب عليك وضع قطعة من اللحام على هاتين الوسادتين على الجزء الخلفي من لوحة PCB: <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_pads.png" width="15%" height="15%" /> وإلا فيجب عليك العكس ووضع اللحام على الوسادات الأخرى: <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/usb_valve_pads_2.png" width="15%" height="15%" /> #### بدون USBvalve PCB <img src="https://raw.githubusercontent.com/cecio/USBvalve/main/pictures/pico-pinout.svg" alt="Pico Pi" width="85%" height="85%" /> إذا كنت تستخدم لوحة تجارب أو مجرد توصيلات، كل ما عليك فعله هو التأكد من توصيل الأطراف الصحيحة بشاشة OLED ومنفذ USB المضيف. التخطيط كالتالي: - PIN6 من Pi --> OLED SDA - PIN7 من Pi --> OLED SCL - PIN19 من Pi --> D+ من USB Host - PIN20 من Pi --> D- من USB Host - PIN23 (GND) من Pi --> GND من USB Host - PIN38 (GND) من Pi --> OLED GND - PIN36 (3V3OUT) من Pi --> OLED VCC - PIN40 (VBUS) من Pi --> VCC من USB Host إذا كنت تريد استخدام وظائف DEBUG، يمكنك أيضًا وضع موصل على أطراف SWD الثلاثة في أسفل اللوحة. #### مع USBpipe PCB > [!CAUTION] > لوحة PCB هذه للمصنّعين الإلكترونيين ذوي الخبرة > **لا تستخدمها إذا لم تكن متأكدًا من قدرتك على التعامل معها!** > [!NOTE] > R7 و R8 غير متصلين فعليًا بأي شيء. تمت إضافتهما لأغراض تصحيح الدوائر. > لذلك لا يظهران في قائمة المواد BOM <img src="https://assets.kitploit.com/production/public/readmes/48341/248d33e236b13cc7c59905288ca1e06ae7a0ff36a3b7e99d2f66c4b27e5ab2bf.jpg" alt="USBpipe PCB" width="15%" height="15%"/> <img src="https://assets.kitploit.com/production/public/readmes/48341/0159e8d6a4d68b6edcad459a6ebfcdce0f5787f2bca0ea5f06c6b3538baf75a2.jpg" alt="USBpipe" width="15%" height="15%"/> [USBpipe](https://github.com/LiPolymer/smartUSBPipe) هي لوحة PCB مخصصة لهذا المشروع. يمكنك العثور على كل ما تحتاجه في مجلد `./PCB/USBpipe/`. <img src="https://assets.kitploit.com/production/public/readmes/48341/39c4a838734e4710cfe68529931961f387b1723654d5a4d3b1243d05925aa765.png" alt="Front" width="20%" height="20%"/> <img src="https://assets.kitploit.com/production/public/readmes/48341/b34c6e01b06808aa0c21f17086d864b4b02fe4b4b453374d2840ae914aa524d6.png" alt="Back" width="20%" height="20%"/> ### حرق البرنامج الثابت لحرق البرنامج الثابت، اتبع هذه الخطوات: - وصّل Raspberry Pi Pico بكابل USB، مع الاستمرار في الضغط على زر *BOOTSEL* (الزر الأبيض الكبير على اللوحة) - حرّر الزر - سترى محركًا جديدًا على النظام، باسم `RPI-RP2` (في بيئات Linux قد تحتاج إلى تركيبه يدويًا) - انسخ ملف البرنامج الثابت المناسب (بامتداد `uf2`) إلى المجلد، حسب شاشة OLED التي استخدمتها - انتظر بضع ثوانٍ حتى يختفي المجلد المركّب انتهى! ### مكافحة الاكتشاف لا أعرف إذا كان هذا سيحدث يومًا ما، لكن قد ترغب في تخصيص البرنامج الثابت لتجنب الاكتشاف الذي تقوم به البرمجيات الخبيثة *المدركة لـ USBvalve* :-) لقد جمعت معظم المتغيرات التي قد ترغب في تعديلها في هذا القسم من `usb_config.h` ([انظر Dockerfile أدناه لإعادة البناء](https://github.com/cecio/USBvalve#dockerfile)) ```C // USB anti-detection settings // // Set USB IDs strings and numbers, to avoid possible detections. // Remember that you can cusotmize FAKE_DISK_BLOCK_NUM as well // for the same reason. Also DISK_LABEL in ramdisk.h can be changed. // // You can see here for inspiration: https://the-sz.com/products/usbid/ // #define USB_VENDORID 0xCAFE #define USB_PRODUCTID 0x1337 #define USB_DESCRIPTOR "DataStore" #define USB_MANUF "USB Acme" #define USB_SERIAL "123456789A" #define USB_VENDORID_STR "Acme" // Up to 8 chars #define USB_PRODUCTID_STR "DataStore" // Up to 16 chars #define USB_VERSION_STR "1.0" // Up to 4 chars ``` ### بناء البرنامج الثابت الخاص بك من الواضح أنه يمكنك أيضًا بناء البرنامج الثابت الخاص بك. للبناء تحتاج إلى *Raspberry Pi Pico SDK* وهذا المستودع. تعليمات إعادة التجميع الأساسية: ``` export PICO_SDK_PATH=</path/to/pico-sdk> git clone --recursive https://github.com/cecio/USBvalve.git cd USBvalve mkdir build && cd build cmake -DPICO_BOARD=pico .. # or pico2 for standard build make -j$(nproc) # Output: build/src/USBvalve.uf2 ``` إذا كنت تريد إعادة إنشاء نظام ملفات مزيف جديد، قد ترغب في إلقاء نظرة على مجلد `utils`، حيث وضعت بعض الأدوات لبناء نظام جديد. #### Dockerfile إذا كنت تريد بناء البرنامج الثابت الخاص بك، بعد تخصيصه، أوفر `Dockerfile` يبني بيئة بناء كاملة ويجمّع البرنامج الثابت. أدخل الأوامر التالية في مجلد `USBvalve` الرئيسي للبناء: ``` # To Build: # docker build -t usbvalve-sdk -f Dockerfile.sdk . # # To Run (default: pico, SSD1306 OLED 128x32): # docker run --rm -v $PWD:/mnt usbvalve-sdk # # Options (via environment variables): # BOARD=pico|pico2 Board target (default: pico) # OLED_HEIGHT=32|64 OLED display height (default: 32) # PIWATCH=1 Use GC9A01 round TFT instead of SSD1306 # USE_BOOTSEL=1 Enable BOOTSEL button (disrupts Low Speed USB) # # Examples: # docker run --rm -e BOARD=pico2 -v $PWD:/mnt usbvalve-sdk # docker run --rm -e PIWATCH=1 -v $PWD:/mnt usbvalve-sdk # docker run --rm -e BOARD=pico2 -e OLED_HEIGHT=64 -v $PWD:/mnt usbvalve-sdk ``` سيتم وضع البرنامج الثابت بامتداد `uf2` في مجلد `USBvalve_out`. ### المساهمة إذا كانت لديك أفكار أو تحسينات في ذهنك، أشجعك على فتح issue حتى نتمكن من تحسين المشروع معًا! شكرًا! ### الدعم إذا كان لديك سؤال أو تحتاج إلى دعم يمكنك فتح `Issue` هنا أو التواصل معي على Twitter/X [@red5heep](https://twitter.com/red5heep) ### إصدارات المجتمع أنشأ المجتمع بعض الفروع (forks) التي تنفذ دعمًا للوحات أخرى، أو تعديلات أخرى. **شكرًا لكل من** ساهم في تطوير **USBvalve**. فيما يلي قائمة غير رسمية/غير كاملة/غير مدعومة: - [USBvalve-tbfa-Mod](https://github.com/TryBreakFixAgain/USBvalve-tbfa-Mod) ## تحذير السلامة > [!WARNING] > لقد تلقيت الكثير من الأسئلة حول **USBvalve** و*أجهزة USB killer*. لم يتم بناء **USBvalve** لاختبار هذه الأجهزة، وليس لديه أي نوع من العزل أو الحماية، لذلك إذا كنت تشك في أنك تتعامل مع أحد هذه الأجهزة، فاختبرها بشيء آخر، وليس مع **USBvalve** وإلا قد تتلف الجهاز أو نفسك أو الأشياء القريبة منك.