حل المشكلات

المشكلات الشائعة وطرق معالجتها.

التنزيل والرفع (Flashing & Upload)

ظهور «Chip stopped responding» أو انتهاء مهلة الرفع

لم يكن معالج ESP32-S3 في وضع التنزيل عند بدء عملية الرفع.

الحل:

  1. اضغط مطوّلًا على زرّ كرة التتبّع (GPIO0)
  2. أثناء الضغط، وصّل كابل USB
  3. اترك زرّ كرة التتبّع
  4. اضغط Upload في VSCode / PlatformIO

بذلك يصبح الجهاز في وضع التنزيل وسيقبل البرنامج.

تعذّر عثور PlatformIO على المنفذ التسلسلي (Serial Port)

على Windows: افتح Device Manager ← Ports (COM & LPT). فإن لم يظهر أي منفذ COM، فالكابل مخصّص للشحن فقط، أو أن مُشغّل USB مفقود.

على Linux / macOS: نفّذ ls /dev/ttyUSB* أو ls /dev/ttyACM* قبل التوصيل وبعده — والإدخال الجديد هو منفذك.

الحل:

  • جرّب كابل USB آخر (يجب أن يكون كابل بيانات لا كابل شحن فقط)
  • جرّب منفذ USB آخر في حاسوبك
  • ثبّت مُشغّل CP2102 أو CH340 إذا لم يتعرّف نظامك على الجهاز

نجاح الرفع لكن الجهاز لا يُقلع

تحقّق: هل اخترت البيئة الصحيحة؟

البيئة الجهاز
env:T-Deck T-Deck القياسي
env:T-Deck-Plus T-Deck Plus (مع GPS)

تنزيل البيئة الخاطئة لن يُتلف الجهاز — فقط أعد التنزيل بالبيئة الصحيحة.

بطاقة SD

sdinfo لا يعرض شيئًا / «No SD card»

  • يجب إدخال البطاقة قبل تشغيل الجهاز — فالإدخال أثناء التشغيل غير مدعوم
  • يجب أن تكون البطاقة مُهيّأة بنظام FAT32 (أنظمة exFAT وNTFS غير مدعومة)
  • إن لم تكن متأكّدًا، فأعد التهيئة بالأمر sdf init

تعليق sdls أو cat

قد تستجيب البطاقة ببطء أو تحوي أخطاءً في نظام الملفات.

الحل: أخرِج البطاقة، وهيّئها بنظام FAT32 على حاسوب، ثم أعِد إدخالها قبل التشغيل، ثم نفّذ sdf init.

عدم حفظ بيانات اعتماد WiFi أو السجلّات بين عمليات إعادة التشغيل

بطاقة SD ضرورية للحفظ الدائم. صحيحٌ أن ذاكرة NVS (فلاش الجهاز) تخزّن بيانات اعتماد WiFi، غير أن السجلّات وتاريخ المسح وملفات الإعداد (lockscreen.conf وnotif.conf… إلخ) تتطلّب جميعها بطاقة SD.

الحل: أدخِل بطاقة SD ونفّذ sdf init لإنشاء بنية المجلّدات.

WiFi

sw (scanwifi) لا يعرض أي شبكات

  • تأكّد من أنك لست في منطقة خالية من شبكات WiFi
  • كان BLE قيد التشغيل — إذ يتقاسم BLE وWiFi هوائيًّا واحدًا؛ فأوقِف أي عملية BLE أوّلًا
  • أعد المسح: نفّذ sw أو اضغط u داخل شاشة المسح

cw يتّصل لكن عنوان IP هو 0.0.0.0

انتهت مهلة إيجار DHCP، أو رفضت نقطة الوصول الاتصال.

الحل: نفّذ cw مجدّدًا. وإن استمرّت المشكلة، فتحقّق من قوّة الإشارة RSSI في الصفحة الثانية من info — فالإشارة الضعيفة جدًّا (أقل من −85 dBm) قد تُسبّب فشل الاتصال.

wpasniff لا يلتقط M1+M2 أبدًا

  • لا يوجد عملاء متّصلون حاليًّا بنقطة الوصول المستهدَفة — فتُرسَل رسائل إلغاء المصادقة (Deauth) لكن لا أحد يُعيد المصادقة
  • قد تكون نقطة الوصول على قناة غير قياسية — فمرّر القناة صراحةً: ws AA:BB:CC:DD:EE:FF 11
  • الجهاز بعيد جدًّا عن الهدف — فقوّة الإشارة RSSI مهمّة لالتقاط أُطُر EAPOL

الحل: انتظر بالقرب من الهدف، أو استخدم wifimon (wm <ch>) للتأكّد من ظهور حركة المرور قبل تشغيل wpasniff.

كسر تشفير WPA لا ينجح أبدًا

كلمة المرور غير موجودة في قائمة الكلمات (Wordlist).

الحل:

  1. أضِف قائمة كلمات مخصّصة إلى /apps/wpasniff/wordlist.txt في بطاقة SD (كلمة مرور واحدة في كل سطر)
  2. انسخ ملف .cap من /apps/wpasniff/<BSSID>.cap إلى حاسوب باستخدام usbmsc، ثم اكسره دون اتصال باستخدام hashcat أو aircrack-ng — فالكسر عبر كرت الرسوميات (GPU) أسرع بمراتب

wguard لا يعرض أي أحداث

  • قد تكون نقطة الوصول التي اخترتها على قناة مختلفة عن المتوقّع — تحقّق أوّلًا بـ sw
  • استخدم wm <ch> (مراقب WiFi) للتأكّد من رؤية حركة المرور على القناة المستهدَفة قبل بدء wguard
  • ربما لا تكون هناك هجمات أصلًا — وهذه هي النتيجة المتوقّعة (والجيّدة)

Bluetooth

sbl لا يجد أي أجهزة

يتقاسم BLE وWiFi هوائيًّا واحدًا، فلا يمكن تشغيلهما في آنٍ واحد.

الحل: أوقِف أي مسح أو هجوم WiFi نشط قبل تشغيل sbl.

buddy / btkbd لا يظهران في Bluetooth على Windows

  • يُعلن الجهاز عن نفسه باسم Claude-XXXX (لـ buddy) أو AL-ANQA-KBD (لـ btkbd) — فابحث عن هذين الاسمين في إعدادات Bluetooth بنظام Windows
  • إذا أظهر Windows «أخطاء مصادقة» أو قطع الاتصال فورًا: فاحذف الجهاز من إعدادات Bluetooth وأعد الاقتران من جديد

مشكلات الارتباط (Bond) في btkbd / buddy عند التبديل بينهما

يستخدمان عنواني BLE منفصلين (اللاحقة :CB لـ btkbd و:BD لـ buddy)، لذا يُفترض أن يرتبط بهما Windows بشكل مستقلّ. فإن اختلطت الارتباطات، فاحذف كِلا الجهازين من إعدادات Bluetooth واقترِن بكلٍّ منهما من جديد.

GPS (لجهاز T-Deck Plus فقط)

GPS لا يلتقط الموقع أبدًا (يبقى GPS:srch أصفر)

  • يحتاج GPS إلى رؤية واضحة للسماء — فلن يلتقط الموقع داخل المباني أو قرب الأبنية العالية
  • يستغرق البدء البارد نحو 4 دقائق — وهذا طبيعي
  • إذا أظهر GPS:srch عدّادًا متزايدًا من الأحرف، فالوحدة حيّة وتستقبل الإشارات

الحل: اخرج إلى العراء وانتظر 4 دقائق. وبمجرّد التقاط الموقع (تتحوّل الأيقونة إلى الأخضر) يبقى ساخنًا لبقيّة الجلسة.

trackme يقول «GPS: none»

جرى تصريف البرنامج لجهاز T-Deck القياسي (env:T-Deck). أمّا الميزات المعتمِدة على GPS فتتطلّب البيئة env:T-Deck-Plus.

شاشة القفل

نسيت رمز PIN

راجع قسم الاسترجاع (نسيان PIN) في دليل شاشة القفل.

باختصار: أطفئ الجهاز ← أخرِج بطاقة SD ← شغّله. فرمز PIN مخزَّن على البطاقة فقط، وبإزالتها يُقلع الجهاز غير مقفول. ثم أعد إدخال البطاقة واضبط رمزًا جديدًا بالأمر lock new.

تفضّل عدم إخراج البطاقة؟ ضع بطاقة SD في حاسوب، وأضِف سطر reset=1 إلى /config/lockscreen.conf، ثم أعد إدخالها وأعد التشغيل — فيمسح العنقاء رمز PIN مرّة واحدة ويُقلع غير مقفول. (وإن كنت تتذكّر الرمز، فافتح القفل ونفّذ lock clean أو lock wipe.) وكلا الطريقين لراحة المالك لا للأمان — فأيّ شخص يملك البطاقة يستطيع تنفيذهما؛ إذ يحمي القفل الجهازَ العامل لا محتويات البطاقة.

تظهر شاشة القفل بعد كل إقلاع

إمّا أن القفل عند الإقلاع مُفعّل، أو أن مهلة القفل التلقائي مضبوطة على مدّة قصيرة جدًّا.

الحل:

CMD> lock boot off      # تعطيل القفل عند التشغيل
CMD> lock timeout 0     # تعطيل القفل التلقائي عند الخمول
CMD> lock timeout 300   # أو اضبط القفل عند الخمول على 5 دقائق

الشاشة تقفز باستمرار إلى تطبيق الملاحظات عند الكتابة

لديك مفتاح الذعر (Panic Key) للوضع المتخفّي مُسلَّحًا (وهو @ افتراضيًّا). فالضغط عليه في أي مكان — حتى في منتصف أمر — يُدخلك فورًا إلى غطاء الملاحظات، ولذلك لم يعد بالإمكان كتابته عادةً في واجهة الأوامر.

الحل: اكتب عبارة مرور الخروج للعودة إلى الطرفية، ثم إمّا أن تغيّر المفتاح أو توقفه:

CMD> uc panic set       # ربط مفتاح آخر
CMD> uc panic off       # تعطيل مفتاح الإخفاء الفوري
CMD> uc status          # التحقّق ممّا هو مُسلَّح

لا يعمل مفتاح الذعر إلّا حين تُضبَط عبارة مرور خروج (uc set)؛ ومسح العبارة (uc clear) يُبطل تسليحه أيضًا.

الشاشة

الشاشة سوداء / لا شيء ظاهر

أطفأ وضعُ توفير الطاقة الشاشةَ.

الحل: اضغط أي مفتاح أو حرّك كرة التتبّع — فتُستعاد الشاشة فورًا.

الشاشة تعرض بكسلات مشوّشة أو تتجمّد بعد انهيار

أعاد معالج ESP32-S3 التشغيل في منتصف الرسم، فترك الشاشة في حالة تالفة.

الحل: نفّذ clear (clr) لإعادة ضبط الشاشة. وإن كانت الشاشة متجمّدة تمامًا، فاضغط زرّ إعادة الضبط (Reset) الفعلي على الجهاز.

الصوت (T-Deck Plus)

test spk لا يُصدر صوتًا

  • قد يكون مستوى الصوت صفرًا — نفّذ nf vol 80 لضبط مستوى صوت الإشعارات
  • تحقّق من إحكام تثبيت موصّل مكبّر الصوت
  • نفّذ test spk واضغط المفاتيح 1–6 — فهذه تتجاوز إعداد مستوى الصوت كلّيًّا وتعزف بأقصى شدّة؛ فإن ظلّ لا صوت، فالمشكلة في توصيل عتاد مكبّر الصوت

الإشعارات صامتة أثناء الهجمات

قد تكون الإشعارات معطّلة أو مستوى الصوت صفرًا.

الحل:

CMD> nf status          # التحقّق ممّا هو مُفعّل
CMD> nf on              # تفعيل جميع المستويات
CMD> nf vol 70          # ضبط مستوى الصوت