p1sec/qcsuperQCSuper एक उपकरण है जो Qualcomm-आधारित फोन और मॉडेम के साथ संचार करता है, जिससे अन्य चीजों के अलावा कच्चे 2G/3G/4G रेडियो फ्रेम कैप्चर करना संभव होता है।
QCSuper Qualcomm-आधारित फोन और मॉडेम के साथ संचार करने वाला एक टूल है, जो अन्य चीज़ों के अलावा कच्चे 2G/3G/4G (और कुछ मॉडलों के लिए 5G) रेडियो फ्रेम कैप्चर करने की सुविधा देता है।
यह आपको रूटेड Android फोन, USB डोंगल या किसी अन्य प्रारूप में मौजूदा कैप्चर का उपयोग करके इसका PCAP कैप्चर उत्पन्न करने की अनुमति देगा।
इंस्टॉल करने के बाद, आप अपने रूटेड फोन को USB में प्लग कर सकते हैं और एक संगत डिवाइस के साथ इसका उपयोग करना उतना ही सरल है जितना:```bash qcsuper --adb --wireshark-live
या, यदि आपने अपने फ़ोन पर मैन्युअल रूप से Diag पोर्ट एक्सपोज़ करना सक्षम किया है (संबंधित प्रक्रिया आपके फ़ोन मॉडेम और निर्माता के आधार पर भिन्न हो सकती है, अधिक स्पष्टीकरण के लिए नीचे देखें), या यदि आपने मोबाइल ब्रॉडबैंड डोंगल लगाया है:```bash
qcsuper --usb-modem auto --wireshark-live
यह Qualcomm Diag प्रोटोकॉल का उपयोग करता है, जिसे QCDM या DM (Diagnostic Monitor) भी कहा जाता है, ताकि आपके फोन के बेसबैंड से संचार किया जा सके।
क्या आप रिपोर्ट करना चाहते हैं कि आपका डिवाइस काम करता है या नहीं? आप एक Github issue खोल सकते हैं।
परिशिष्ट (Annexes):
ब्लॉग पोस्ट/डेमो: Presenting QCSuper: a tool for capturing your 2G/3G/4G air traffic on Qualcomm-based phones
अधिक दस्तावेज़:
QCSuper का हाल ही में Ubuntu LTS 22.04+ पर परीक्षण और विकास किया गया है और यह Windows 11 पर भी उपयोग किया गया है। यह कुछ Python मॉड्यूल पर निर्भर करता है। बेहतर संगतता के लिए Linux का उपयोग करने की सलाह दी जाती है।
इसे उपयोग करने के लिए, आपका फोन रूट होना चाहिए या USB पर diag सेवा पोर्ट उजागर करना चाहिए। अपने फोन के साथ संगतता की जाँच करने के लिए, GSMArena जैसी साइट पर फोन का मॉडल देखें और जाँचें कि उसमें Qualcomm प्रोसेसर है या नहीं।
QCSuper द्वारा उत्पादित PCAP फ़ाइलों को खोलने के लिए, आप 2G/3G फ्रेम के लिए किसी भी Wireshark 2.x - 4.x का उपयोग कर सकते हैं, लेकिन 4G फ्रेम के लिए आपको कम से कम Wireshark 2.5.x की आवश्यकता है (और 4G फ्रेम से डिक्रिप्ट किए गए व्यक्तिगत NAS संदेशों के लिए 2.6.x)। Ubuntu वर्तमान में सभी संस्करणों के लिए पर्याप्त नया बिल्ड प्रदान करता है।
5G फ्रेम को डिकोड करना Wireshark 3.6.x और उससे ऊपर के तहत परीक्षण किया गया था और यह स्वचालित रूप से Wireshark Lua प्लग-इन स्थापित करके किया जाएगा (Windows पर %APPDATA%\Wireshark\plugins में या Linux और macOS पर ~/.local/lib/wireshark/plugins में), जिसे DONT_INSTALL_WIRESHARK_PLUGIN=1 पर्यावरण चर सेट करके टाला जा सकता है, यदि आप इसे टालना चाहते हैं।
PyPI से QCSuper के स्थिर संस्करण को सिस्टम-व्यापी रूप से स्थापित करने के लिए, आप ये कमांड चला सकते हैं:```bash
sudo apt install python3-pip wireshark
sudo pip3 install --upgrade qcsuper --break-system-packages
फिर, आप अपने टर्मिनल में `qcsuper` टाइप करके QCSuper चला सकते हैं।
किसी विशिष्ट फ़ोल्डर में डेवलपमेंट संस्करण स्थापित करने के लिए, एक टर्मिनल खोलें और निम्नलिखित टाइप करें:```bash
# Download QCSuper
git clone https://github.com/P1sec/qcsuper
cd qcsuper
# Install dependencies
sudo apt install python3-pip wireshark
sudo pip3 install --upgrade . --break-system-packages
फिर, टर्मिनल में ./qcsuper.py कमांड का उपयोग करके, qcsuper/ निर्देशिका से QCSuper चलाएँ।
Linux पर, आप uv पैकेज मैनेजर का उपयोग करके QCSuper इंस्टॉल कर सकते हैं, जो PIP का एक आधुनिक विकल्प है।
सबसे पहले, uv इंस्टॉल करने के लिए अपने टर्मिनल में इनमें से एक कमांड चलाएँ:```bash
sudo snap install --classic astral-uv # On Ubuntu
sudo dnf install -y uv # On Fedora
sudo pacman -S uv # On Archlinux, Manjaro
curl -LsSf https://astral.sh/uv/install.sh | sh # On Debian and others
फिर, नवीनतम स्थिर संस्करण स्थापित करने के लिए यह चलाएँ:```bash
uv tool install qcsuper
वैकल्पिक रूप से, आप इस कमांड का उपयोग करके नवीनतम विकास संस्करण स्थापित कर सकते हैं:```bash uv tool install git+https://github.com/P1sec/qcsuper
आप फिर इसे अपने टर्मिनल में टाइप कर सकते हैं:```bash
qcsuper
हालाँकि, यदि आपको qcsuper को root के रूप में चलाने की आवश्यकता है, उदाहरण के लिए क्योंकि आप मॉडेम डिवाइस से डेटा पढ़ रहे हैं, तो sudo के साथ uv का उपयोग करते समय qcsuper $PATH में नहीं हो सकता है, इसलिए इसके लिए कुछ ऐसा करने की आवश्यकता हो सकती है:```bash
sudo env "PATH=$PATH" qcsuper
यदि आप उपकरण के विकास में भाग लेना चाहते हैं, तो आप स्रोत को डाउनलोड करने के लिए इन कमांडों का उपयोग कर सकते हैं, फिर `~/.local/bin` में QCSuper के लिए स्रोत निर्देशिका की ओर सिम्बोलिक लिंक बना सकते हैं:```bash
git clone https://github.com/P1sec/qcsuper
cd qcsuper
uv sync # Create .venv in the current directory
uv tool install -e . # Create symlinks into ~/.local/bin
QCSuper विंडोज़ पर चल सकता है, लेकिन आपको पहले से यह सुनिश्चित कर लेना चाहिए कि Google का ADB प्रॉम्प्ट आपकी मशीन पर आपके डिवाइस के साथ सही ढंग से चलता है, और आपको उस स्थिति में मैन्युअल रूप से libusb-win32 फ़िल्टर भी बनाने चाहिए (इसे स्थापित करने के बाद स्टार्ट मेनू में उपलब्ध उपयोगिता के माध्यम से), जहाँ आपके डिवाइस को स्यूडो-सीरियल USB पर Diag पोर्ट से सीधे कनेक्ट करने की आवश्यकता होती है।
(कृपया ध्यान दें कि यदि आप अपने डिवाइस का मोड-स्विच करते हैं, तो संबद्ध USB PID/VID बदल सकता है और इसके लिए libusb-win32 फ़िल्टर निर्माण उपयोगिता में ड्राइवर संबद्धता दोबारा करने की आवश्यकता हो सकती है - और/या स्थिति के आधार पर विंडोज़ परिधीय उपकरण प्रबंधक में)
विंडोज़ पर, आपको (Google के ADB कर्नेल ड्राइवरों के अतिरिक्त) अपने फ़ोन मॉडल के लिए अपने फ़ोन के USB ड्राइवर डाउनलोड और इंस्टॉल करने की आवश्यकता हो सकती है (इसमें सामान्य Qualcomm USB ड्राइवर शामिल हो सकते हैं)। कृपया निर्देशों के लिए Google पर अपने फ़ोन का मॉडल + "USB ड्राइवर" या "ADB ड्राइवर" खोजें।
फिर, आपको यह सुनिश्चित करना होगा कि आप adb का उपयोग करके अपने डिवाइस तक पहुँच सकते हैं। आप adb को डाउनलोड और सेटअप करने के तरीके पर एक ट्यूटोरियल यहाँ पा सकते हैं। आगे बढ़ने के लिए adb.exe shell (या आप जिस भी निष्पादन योग्य पथ का उपयोग करते हैं, QCSuper के qcsuper/inputs/external/adb फ़ोल्डर में ADB निष्पादन योग्य की एक प्रति मौजूद है) कमांड को एक प्रॉम्प्ट प्रदर्शित करना चाहिए।
फिर, इन लिंक्स का अनुसरण करें (इस टूल का हाल ही में विंडोज़ 11 पर परीक्षण किया गया है - यह विंडोज़ 7 पर काम करेगा इसकी गारंटी नहीं है) इस क्रम में: