AutoProber

AutoProber هو مكدس أتمتة المسبار الطائر لمخترقي الأجهزة، يمنح عميلك كل ما يحتاجه للانتقال من "هناك هدف جديد على الطبق" إلى فحص دبابيس فردية بطريقة آمنة.

فيديو تجريبي: https://gainsec.com/autoprober-demo-mp4/

سير العمل

1. أخبر العميل باستيراد المشروع.
2. قم بتوصيل جميع الأجهزة.
3. أخبر العميل بتأكيد أن جميع الأجزاء تعمل.

4. اجعله ينفذ التمركز إلى الصفر ثم المعايرة.
5. قم بتوصيل المسبار المخصص ورأس الميكروسكوب.
6. أخبر العميل أن هناك هدفًا جديدًا على الطبق.
7. سيجد مكان الهدف على الطبق، ثم يلتقط إطارات فردية، مع الاحتفاظ بسجل للإحداثيات XYZ مع ملاحظة اللوحات والوسادات والدبابيس والرقائق وغيرها من الميزات المهمة.

8. سيقوم بدمج الإطارات معًا وتعليق الخريطة، بما في ذلك الدبابيس والمكونات المهمة التي حددها.

9. سيضيف أهداف الفحص إلى لوحة التحكم على الويب لموافقتك أو رفضها.

10. سيقوم بفحص الأهداف المعتمدة وتقديم تقرير.

يمكن التحكم في جميع الأجهزة عبر لوحة التحكم على الويب أو نصوص Python أو بواسطة العميل نفسه.

هذا المستودع هو مرشح إصدار مكتمل المصدر متاح للجميع. يحتوي على كود التحكم بلغة Python ولوحة التحكم وملفات CAD والوثائق اللازمة لإنشاء AutoProber الخاص بك.

نموذج السلامة

يمكن لهذا المشروع تحريك الأجهزة المادية. تعامل معه كنظام تحكم في الآلات، وليس تطبيق ويب عادي.

تصميم السلامة المطلوب هو:

• يتم تجاهل GRBL Pn:P. دبوس الفحص CNC ليس محطة نهاية موثوقة.
• تتم قراءة محطة النهاية المستقلة للسلامة من القناة 4 من راسم الاهتزاز.
• يجب مراقبة القناة 4 باستمرار أثناء أي حركة.
• أي إشارة من القناة 4، أو جهد غامض، أو إنذار CNC، أو دبوس حد حقيقي X/Y/Z هو شرط إيقاف.
• يجب على العميل/المشغل التوقف والإبلاغ. لا يتم استئناف الحركة تلقائيًا.

اقرأ docs/safety.md و docs/operations.md قبل تشغيل الأجهزة.

هيكل المستودع

apps/                 نصوص للمشغل ونقطة دخول لوحة تحكم Flask
autoprober/           حزمة Python قابلة لإعادة الاستخدام لـ CNC والراسم والميكروسكوب والتسجيل والسلامة
dashboard/            لوحة تحكم ويب بصفحة واحدة
docs/                 الهندسة ومراجع الأجهزة والتعليمات التشغيلية والسلامة
cad/                  ملفات STL قابلة للطباعة لرأس الأداة المخصص الحالي
config/               ملفات البيئة/التكوين المثالية
AGENTS.md             قواعد السلامة للعميل/المشغل
LICENSE               ترخيص PolyForm Noncommercial 1.0.0 ومعلومات الاتصال التجاري
pyproject.toml        بيانات تعريف مشروع Python
uv.lock               قفل تبعيات Python

حزمة الأجهزة

هندسة المشروع المُختبرة تستخدم:

• متحكم CNC من نوع 3018 متوافق مع GRBL عبر USB تسلسلي
• ميكروسكوب USB يُخدم بواسطة mjpg_streamer
• راسم اهتزاز Siglent عبر LAN/SCPI لمراقبة القناة 4 وقياس القناة 1
• محطة نهاية بصرية موصلة بمصدر طاقة خارجي 5V وبالقناة 4 من راسم الاهتزاز
• منفذ طاقة اختياري متحكم به عبر الشبكة للتحكم في طاقة المختبر
• أجزاء رأس الأداة المخصص الحالي القابلة للطباعة في cad/

الافتراضات التشغيلية الافتراضية موثقة في وثائق الجهاز. استبدلها بإعدادات مختبرك قبل الاستخدام.

للحصول على قائمة أجهزة موجهة للشراء، انظر docs/BOM.md.

الأجزاء المرجعية

هذه هي الأجزاء المحددة أو فئات الأجزاء المستخدمة في الإصدار النموذجي. تأكد من القوائم الحالية والأبعاد والجهد وتوافق الموصلات قبل الشراء.

بنيتي:

• محطة نهاية بصرية
• ميكروسكوب USB
• SainSmart Genmitsu 3018-PROVer V2
• Matter Smart Power Strip - مقابس تيار متردد فردية مع منفذي USB-A ومنفذي USB-C
• راسم اهتزاز Siglent SDS1104X-E
• أسلاك Dupont
• زنبرك قلم أو زنبرك ضغط خفيف مشابه
• طابعة ثلاثية الأبعاد لأجزاء رأس الأداة القابلة للطباعة في cad/

اختياري / قابل للتبديل:

• مسبار راسم اهتزاز عالمي
• كتلة طاقة USB، 5V
• كابل USB 2.0 ذيل

هندسة الأجهزة

flowchart LR
    Operator[المشغل] --> Dashboard[لوحة التحكم على الويب]
    Dashboard --> Apps[تطبيقات Python]
    Apps --> CNC[CNC GRBL عبر USB تسلسلي]
    Apps --> Microscope[ميكروسكوب USB عبر mjpg-streamer]
    Apps --> Scope[راسم الاهتزاز عبر LAN / SCPI]
    Apps --> Outlet[منفذ طاقة LAN اختياري]

    Endstop[محطة نهاية بصرية] --> ScopeC4[جهد السلامة على القناة 4 لراسم الاهتزاز]
    Pogo[قياس المسبار] --> ScopeC1[القياس على القناة 1 لراسم الاهتزاز]
    ScopeC4 --> Apps
    ScopeC1 --> Apps

هندسة وقت التشغيل

flowchart TD
    Preflight[فحص أولي] --> SafetyCheck{هل القناة 4 واضحة؟}
    SafetyCheck -- لا --> Stop[حالة الإيقاف]
    SafetyCheck -- نعم --> Motion[حركة مراقبة]
    Motion --> Monitor[مؤشر مراقبة EndstopMonitor بمعدل >= 10 هرتز]
    Monitor --> C4{هل القناة 4 واضحة؟}
    C4 -- نعم --> Capture[التقاط من الميكروسكوب]
    C4 -- لا --> FeedHold[تعليق التغذية فوريًا]
    FeedHold --> Stop
    Capture --> Stitch[دمج / خريطة]
    Stitch --> Review[مراجعة الفحص اليدوية]
    Review --> Approved{الهدف معتمد وإزاحة الفحص المقاسة؟}
    Approved -- لا --> Stop
    Approved -- نعم --> Probe[حركة فحص محددة]

حالة الإيقاف

stateDiagram-v2
    [*] --> Running[تشغيل]
    Running --> STOP: إشارة من القناة 4 / خطأ في القناة 4 / إنذار CNC / دبوس حد حقيقي
    STOP --> Report: تسجيل الجهد والحالة والإجراء
    Report --> WaitForOperator[انتظار المشغل]: لا حركة تلقائية لاستئناف العمل
    WaitForOperator --> Running: المشغل يمسح الحالة صراحةً

بدء سريع

تثبيت التبعيات:

uv sync

بدء لوحة التحكم على مضيف مزود بالأجهزة:

PYTHONPATH=. python3 apps/dashboard.py

المنفذ الافتراضي للوحة التحكم هو 5000.

التكوين

ابدأ من config/autoprober.example.env. لا تنشر عناوين IP الخاصة بالمختبر أو أسماء المضيفين أو بيانات الاعتماد أو ملفات المعايرة أو الصور الملتقطة للأهداف إلا إذا كنت تنوي إصدارها.

القيم التشغيلية المهمة قابلة للتكوين:

• AUTOPROBER_LOG_PATH: مسار سجل وقت التشغيل
• AUTOPROBER_RUNTIME_ROOT: دليل حالة المعايرة والتصحيح المسطح وحالة وقت التشغيل
• AUTOPROBER_MICROSCOPE_SNAPSHOT_URL: نقطة نهاية لقطة الميكروسكوب
• AUTOPROBER_SCOPE_HOST / AUTOPROBER_SCOPE_PORT: نقطة نهاية SCPI لراسم الاهتزاز
• لوحة التحكم: Flask على المنفذ 5000

لا تقم بإرسال ملفات البيئة المحلية التي تحتوي على مضيفين أو مسارات أو بيانات هدف خاصة بالمختبر.

سير العمل الرئيسي

1. قم بتشغيل الفحوصات الأولية.
2. تأكد من أن القناة 4 واضحة.
3. قم بالتمرك لإلى الصفر والمعايرة فقط عندما يكون الإعداد المادي جاهزًا.
4. التقط إطارات الميكروسكوب مع حركة مراقبة.
5. استورد أو أنتج قطع أثرية لخريطة الهدف للمراجعة.
6. وافق على مرشحي الفحص يدويًا.
7. نفذ أي حركة فحص فقط بعد قياس إزاحة الميكروسكوب إلى المسبار وتخزينها.

ما هو مستبعد

يستبعد هذا المرشح عمدًا:

• لقطات ميكروسكوب تجريبية وصور الأهداف المدمجة
• صور مرجعية مرفوعة
• النسخ الاحتياطية والمحفوظات المحلية
• .venv و __pycache__ ونتائج Playwright
• سجلات وقت التشغيل وذاكرة التخزين المؤقت للمعايرة وصور التصحيح المسطح
• حالة SSH/النشر الخاصة بالجهاز

انظر RELEASE_MANIFEST.md للتفاصيل.

الترخيص

هذا المشروع متاح المصدر بموجب ترخيص PolyForm Noncommercial 1.0.0.

يمكنك استخدام هذا المشروع وتعديله ومشاركته للأغراض غير التجارية.

الاستخدام التجاري يتطلب ترخيصًا تجاريًا مدفوعًا منفصلاً.

للترخيص التجاري، اتصل: [email protected]

القيود الحالية

• يجب قياس إزاحة الميكروسكوب إلى المسبار (pogo) قبل الفحص الفعلي.
• لا يجب تزوير المعايرة؛ يجب إنشاء ملف المعايرة وقت التشغيل على الجهاز الذي سيتحرك.
• لوحة التحكم هي أداة تحكم في المختبر ويجب ألا تتعرض للشبكات غير الموثوقة.

الاستخدام المسؤول

هذا المشروع مخصص للعمل المخبري الخاضع للرقابة على المعدات والأهداف التي لديك الإذن باختبارها. لا تستخدمه لفحص أو إتلاف أو تحليل الأنظمة دون إذن.

المؤلفون

Jon 'GainSec' Gaines