cecio/usbvalveUSB गतिविधि को तुरंत उजागर करें
[!NOTE] USBvalve संस्करण 1.0.0
एप्लिकेशन का पूर्ण पुनर्लेखन किया गया है:
- Arduino IDE वातावरण से हटा दिया गया है, अब कोड Pi Pico SDK के लिए लिखा गया है
- बाहरी लाइब्रेरी पर निर्भरता बहुत कम कर दी गई है
- Low Speed डिवाइसों के लिए USB होस्ट समर्थन अब अधिक मजबूत है (ATTiny85, EvilCrow, आदि)
- हार्डवेयर और कार्यक्षमताएँ लगभग अपरिवर्तित हैं, विवरण के लिए नीचे दिए गए नोट्स देखें
मुझे यकीन है कि मेरी तरह, आपसे भी कभी कहा गया होगा कि अपनी USB ड्राइव किसी अज्ञात डिवाइस में लगाएँ... और फिर संदेह:
मेरे बेचारे डोंगल के साथ पर्दे के पीछे क्या हुआ? मेरी फ़ाइलें चुरा रहा है? उन्हें एन्क्रिप्ट कर रहा है? या बस कोई मैलवेयर इंस्टॉल कर रहा है? USBvalve के साथ आप इसे सेकंडों में पकड़ सकते हैं: अत्यंत सस्ते ऑफ-द-शेल्फ हार्डवेयर पर बना, आप किसी भी USB फ़ाइल सिस्टम गतिविधि का तुरंत परीक्षण कर सकते हैं और यह समझ सकते हैं कि क्या हो रहा है, इससे पहले कि बहुत देर हो जाए!
USBvalve के साथ आप ड्राइव के साथ क्या हो रहा है, इस पर तत्काल प्रतिक्रिया प्राप्त कर सकते हैं; स्क्रीन आपको दिखाएगी कि डिवाइस पर बनाए गए नकली फ़ाइल सिस्टम को एक्सेस, पढ़ा या लिखा जा रहा है या नहीं:
और संस्करण 0.8.0 से आप इसे USB होस्ट के रूप में भी उपयोग कर सकते हैं ताकि BADUSB डिवाइसों का पता लगाया जा सके:
यह सीरियल पोर्ट पर उपलब्ध BADUSB डीबगर का एक उदाहरण है:
यदि आप वीडियो पसंद करते हैं, तो आप मेरी Insomni'hack प्रस्तुति भी देख सकते हैं
संस्करण 0.15.0 से एक नया Pi Pico Watch संस्करण समर्थित है। नया संस्करण संकलित करने के लिए आपको कोड की शुरुआत में #define PIWATCH पंक्ति को अनकमेंट करना होगा। हार्डवेयर एक RP2040-आधारित 1.28-इंच TFT डिस्प्ले और वॉच बोर्ड है। आप कुछ और जानकारी यहाँ पा सकते हैं।
यह Waveshare RP2040-LCD-1.28 के साथ भी पूरी तरह संगत है।
docs: प्रोजेक्ट के बारे में दस्तावेज़ीकरण, एक प्रस्तुति के साथ जिसमें आप सभी सुविधाओं को देख सकते हैं
firmware: Raspberry Pi Pico के लिए पूर्व-निर्मित फर्मवेयर। आप इन्हें सीधे उपयोग कर सकते हैं और बोर्ड पर फ्लैश कर सकते हैं। हमारे पास कई अलग-अलग संस्करण हैं, 32 या 64 लाइनों वाले OLEDs के लिए, Pico 1 या Pico2 के लिए, Pi Pico Watch, आदि
PCB: Gerber फ़ाइल यदि आप कस्टम PCB प्रिंट करना चाहते हैं। यह अनिवार्य नहीं है, आप अपना खुद का उपयोग कर सकते हैं या इसे ब्रेडबोर्ड पर बना सकते हैं
src और data: स्रोत, यदि आप स्वयं फर्मवेयर को संशोधित और निर्मित करना चाहते हैं
utils: कुछ उपयोगिताएँ जिनका उपयोग आप कस्टम FS बनाने के लिए कर सकते हैं
pictures: इस दस्तावेज़ में उपयोग की गई छवियाँ और संसाधन
STL: एन्क्लोज़र के लिए STL फ़ाइलें। 1.1 और 1.2 फ़ोल्डरों में पूर्ण एन्क्लोज़र हैं (WhistleMaster को धन्यवाद)। फ़ोल्डरों 1.2_64 और 1.2_64_simple में 128x64 स्क्रीन के लिए एन्क्लोज़र हैं (rtmq0227 को धन्यवाद)। यदि आप LCD की सुरक्षा के लिए कुछ हल्का चाहते हैं तो आप USBvalve_sliding_cover.stl का उपयोग कर सकते हैं।
यदि आप अपना खुद का बनाना चाहते हैं, तो आपको आवश्यकता होगी:
0.x.x संस्करणों में, BOOTSEL का उपयोग डिवाइस को रीसेट करने या HID इवेंट्स की संख्या प्रिंट करने के लिए किया जाता था (> 2s दबाएँ)।
BOOTSEL की पोलिंग BADUSB डिटेक्शन में कुछ समस्याएँ पैदा कर रही थी, इसलिए इसे संस्करण 1.0.0 से हटा दिया गया और निम्नलिखित दो विकल्पों से बदल दिया गया:
GP0 और GND (पैड 1 और 3, उदाहरण के लिए नीचे दी गई तस्वीर देखें) के बीच एक बटन सोल्डर करेंr (रीसेट) और h (HID इवेंट्स) कमांड का उपयोग करें
PCB में आपको बोर्ड का संस्करण 1.3 भी मिलेगा, जिसमें बटन को लगाने की सुविधा के लिए पैड 1 और 3 पर कुछ छेद हैं। लेकिन जैसा कि आप देख सकते हैं, आप अपने पुराने संस्करण का भी उपयोग कर सकते हैं।
यदि आप BADUSB कार्यों का उपयोग नहीं कर रहे हैं या यदि आप डिटेक्शन पर कम कवरेज रखना पसंद करते हैं लेकिन BOOTSEL उपयोग बनाए रखना चाहते हैं, तो मैं bootsel सक्षम के साथ बनाया गया एक फर्मवेयर भी प्रदान कर रहा हूँ (फ़ोल्डर और रिलीज़ देखें)।
Tz1rf को धन्यवाद, हमारे पास दो शानदार वीडियो भी हैं: एक निर्माण प्रक्रिया को चरण-दर-चरण समझाता है, और दूसरा दिखाता है कि फर्मवेयर कैसे अपलोड करें और टूल का उपयोग कैसे करें।
लगभग सारा काम सॉफ़्टवेयर द्वारा सीधे बोर्ड पर किया जाता है, इसलिए आपको आउटपुट के लिए OLED के साथ कनेक्शन की व्यवस्था करनी होगी।
फर्मवेयर के संस्करण 0.8.0 से, USBvalve HID डिवाइसों का पता लगा सकता है (BADUSB का पता लगाने के लिए उपयोग किया जाता है)। इसके लिए होस्ट के रूप में व्यवहार करने वाले एक अतिरिक्त USB पोर्ट की आवश्यकता होती है। यदि आप इसमें रुचि नहीं रखते हैं, तो आप docs फ़ोल्डर में पुराने निर्देशों का उपयोग कर सकते हैं और PCB संस्करण 1.1 का उपयोग कर सकते हैं। अन्यथा PCB संस्करण 1.2 के साथ आगे बढ़ें (हमारे पास USB-A या USB-B के लिए संस्करण हैं, फ़ोल्डर देखें)।
USBH क्षेत्र में एक USB फीमेल पोर्ट सोल्डर करें। यह संस्करण A के लिए है, लेकिन यदि आप चाहें तो USB Micro-B के लिए भी एक संस्करण हैकुछ OLEDs में GND और VCC PINs की अदला-बदली होती है, इसलिए मैंने PCB को दोनों संस्करणों के अनुकूल बनाया है:
उदाहरण के लिए यदि आपके OLED में PIN1 पर GND और PIN2 पर VCC है जैसे यह:
आपको PCB के पीछे इन दो पैड्स पर सोल्डर की एक बूंद लगानी होगी:
अन्यथा आपको इसके विपरीत करना चाहिए और सोल्डर को अन्य PADs पर लगाना चाहिए:
यदि आप ब्रेडबोर्ड या केवल वायरिंग का उपयोग कर रहे हैं, तो आपको बस यह सुनिश्चित करना है कि OLED स्क्रीन और होस्ट USB पोर्ट पर उचित PINs कनेक्ट हों।
मैपिंग निम्नलिखित है:
यदि आप DEBUG कार्यों का उपयोग करना चाहते हैं, तो आप बोर्ड के नीचे 3 SWD PINs पर एक हेडर भी लगा सकते हैं।
[!CAUTION] यह PCB अनुभवी इलेक्ट्रॉनिक निर्माताओं के लिए है यदि आप सुनिश्चित नहीं हैं कि आप इसे संभाल सकते हैं तो इसका उपयोग न करें!
[!NOTE] R7 और R8 वास्तव में किसी भी चीज़ से जुड़े नहीं हैं। उन्हें सर्किट डीबगिंग उद्देश्यों के लिए जोड़ा गया है। इसलिए वे BOM में नहीं दिखते
USBpipe इस प्रोजेक्ट के लिए एक समर्पित PCB है।
आपको जो कुछ भी चाहिए वह ./PCB/USBpipe/ फ़ोल्डर में मिल जाएगा।
फर्मवेयर फ्लैश करने के लिए, इन चरणों का पालन करें:
RPI-RP2 होगा (Linux वातावरण में आपको इसे मैन्युअल रूप से माउंट करना पड़ सकता है)uf2 एक्सटेंशन के साथ) को फ़ोल्डर में कॉपी करेंहो गया!
मुझे नहीं पता कि क्या ऐसा कभी होगा, लेकिन आप USBvalve-aware मैलवेयर द्वारा किए गए डिटेक्शन से बचने के लिए फर्मवेयर को कस्टमाइज़ करना चाह सकते हैं :-)
मैंने उन अधिकांश वेरिएबल्स को समूहीकृत किया है जिन्हें आप संशोधित करना चाह सकते हैं, usb_config.h के इस अनुभाग में (पुनर्निर्माण के लिए नीचे Dockerfile देखें)
// 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 प्रदान करता हूँ जो एक पूर्ण निर्माण वातावरण बनाता है और फर्मवेयर संकलित करता है।
बनाने के लिए मुख्य 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 पर संपर्क कर सकते हैं
समुदाय ने अन्य बोर्डों के लिए समर्थन या अन्य संशोधनों को लागू करते हुए कुछ फोर्क बनाए हैं। USBvalve के विकास में योगदान देने वाले सभी को धन्यवाद। नीचे एक अनौपचारिक/अपूर्ण/असमर्थित सूची दी गई है:
[!WARNING] मुझे USBvalve और USB killer डिवाइसों के बारे में बहुत सारे प्रश्न प्राप्त हुए हैं। USBvalve इन डिवाइसों का परीक्षण करने के लिए नहीं बनाया गया है, इसमें किसी भी प्रकार का इंसुलेशन या सुरक्षा नहीं है, इसलिए यदि आपको संदेह है कि आप इनमें से किसी डिवाइस से निपट रहे हैं, तो इसे किसी और चीज़ से परीक्षण करें, USBvalve से नहीं, अन्यथा आप डिवाइस, स्वयं को या अपने आस-पास की वस्तुओं को नुकसान पहुँचा सकते हैं।