AutoProber

AutoProber हार्डवेयर हैकर का फ्लाइंग प्रोब ऑटोमेशन स्टैक है जो आपके एजेंट को "प्लेट पर एक नया लक्ष्य है" से लेकर सुरक्षित तरीके से व्यक्तिगत पिन की जांच करने तक की हर चीज़ प्रदान करता है।

डेमो वीडियो: https://gainsec.com/autoprober-demo-mp4/

प्रवाह

1. एजेंट को प्रोजेक्ट को शामिल करने के लिए कहें।
2. सभी हार्डवेयर कनेक्ट करें।
3. एजेंट से पुष्टि करने के लिए कहें कि सभी भाग कार्य कर रहे हैं।

4. इसे होमिंग और फिर कैलिब्रेशन चलाने दें।
5. कस्टम प्रोब और माइक्रोस्कोप हेडर अटैच करें।
6. एजेंट को बताएं कि प्लेट पर एक नया लक्ष्य है।
7. यह प्लेट पर लक्ष्य का पता लगाएगा, फिर अलग-अलग फ्रेम लेगा, XYZ का रिकॉर्ड रखते हुए पैड, पिन, चिप्स और अन्य दिलचस्प विशेषताओं को नोट करेगा।

8. यह फ्रेम को एक साथ जोड़ेगा और मैप को एनोटेट करेगा, जिसमें पिन और उसके द्वारा पहचाने गए दिलचस्प घटक शामिल होंगे।

9. यह आपके अनुमोदन या अस्वीकार के लिए वेब डैशबोर्ड में प्रोब लक्ष्य जोड़ेगा।

10. यह अनुमोदित लक्ष्यों की जांच करेगा और रिपोर्ट करेगा।

सभी हार्डवेयर को वेब डैशबोर्ड, पायथन स्क्रिप्ट या एजेंट के माध्यम से ही नियंत्रित किया जा सकता है।

यह रिपॉजिटरी एक स्व-निहित स्रोत-उपलब्ध रिलीज़ उम्मीदवार है। इसमें आपका अपना AutoProber बनाने के लिए आवश्यक पायथन नियंत्रण कोड, डैशबोर्ड, CAD फ़ाइलें और दस्तावेज़ शामिल हैं।

सुरक्षा मॉडल

यह प्रोजेक्ट भौतिक हार्डवेयर को हिला सकता है। इसे सामान्य वेब ऐप के बजाय मशीन-नियंत्रण प्रणाली के रूप में मानें।

आवश्यक सुरक्षा डिज़ाइन है:

• GRBL Pn:P को अनदेखा किया जाता है। CNC प्रोब पिन एक विश्वसनीय एंडस्टॉप नहीं है।
• स्वतंत्र सुरक्षा एंडस्टॉप ऑसिलोस्कोप चैनल 4 से पढ़ा जाता है।
• किसी भी गति के दौरान चैनल 4 की लगातार निगरानी की जानी चाहिए।
• कोई भी चैनल 4 ट्रिगर, अस्पष्ट वोल्टेज, CNC अलार्म, या वास्तविक X/Y/Z लिमिट पिन एक रोक की स्थिति है।
• एजेंट/ऑपरेटर को रुकना और रिपोर्ट करना होगा। पुनर्प्राप्ति गति स्वचालित नहीं है।

हार्डवेयर चलाने से पहले docs/safety.md और docs/operations.md पढ़ें।

रिपॉजिटरी लेआउट

apps/                 ऑपरेटर-सामने वाली स्क्रिप्ट और Flask डैशबोर्ड प्रवेश बिंदु
autoprober/           CNC, स्कोप, माइक्रोस्कोप, लॉगिंग, सुरक्षा के लिए पुन: प्रयोज्य पायथन पैकेज
dashboard/            एकल-पृष्ठ वेब डैशबोर्ड
docs/                 आर्किटेक्चर, डिवाइस संदर्भ, संचालन और सुरक्षा मार्गदर्शन
cad/                  वर्तमान कस्टम टूलहेड के लिए मुद्रण योग्य STL फ़ाइलें
config/               उदाहरण पर्यावरण/कॉन्फ़िगरेशन फ़ाइलें
AGENTS.md             एजेंट/ऑपरेटर सुरक्षा नियम
LICENSE               PolyForm Noncommercial 1.0.0 लाइसेंस और वाणिज्यिक संपर्क
pyproject.toml        पायथन प्रोजेक्ट मेटाडेटा
uv.lock               लॉक की गई पायथन निर्भरता रिज़ॉल्यूशन

हार्डवेयर स्टैक

परीक्षित प्रोजेक्ट आर्किटेक्चर उपयोग करता है:

• USB सीरियल पर GRBL-संगत 3018-शैली CNC नियंत्रक
• mjpg_streamer द्वारा परोसा गया USB माइक्रोस्कोप
• चैनल 4 सुरक्षा निगरानी और चैनल 1 माप के लिए LAN/SCPI पर Siglent ऑसिलोस्कोप
• बाहरी 5V आपूर्ति और ऑसिलोस्कोप चैनल 4 से जुड़ा ऑप्टिकल एंडस्टॉप
• लैब पावर नियंत्रण के लिए वैकल्पिक नेटवर्क-नियंत्रित आउटलेट
• cad/ में वर्तमान मुद्रण योग्य कस्टम टूलहेड भाग

डिफ़ॉल्ट रनटाइम धारणाएं डिवाइस दस्तावेज़ों में प्रलेखित हैं। उपयोग से पहले उन्हें अपनी स्वयं की लैब सेटिंग्स से बदलें।

हार्डवेयर की खरीदारी-उन्मुख सूची के लिए, docs/BOM.md देखें।

संदर्भ भाग

प्रोटोटाइप रिलीज़ के लिए उपयोग किए जाने वाले विशिष्ट भाग या भाग वर्ग हैं। खरीदने से पहले वर्तमान लिस्टिंग, आयाम, वोल्टेज और कनेक्टर संगतता सत्यापित करें।

मेरा बिल्ड:

• ऑप्टिकल एंड स्टॉप
• USB माइक्रोस्कोप
• SainSmart Genmitsu 3018-PROVer V2
• Matter स्मार्ट पावर स्ट्रिप, 2 USB-A और 2 USB-C पोर्ट के साथ व्यक्तिगत रूप से नियंत्रित AC आउटलेट
• Siglent SDS1104X-E ऑसिलोस्कोप
• Dupont तार
• पेन स्प्रिंग या इसी तरह का हल्का संपीड़न स्प्रिंग
• cad/ में मुद्रण योग्य टूलहेड भागों के लिए 3D प्रिंटर

वैकल्पिक / विनिमेय:

• यूनिवर्सल ऑसिलोस्कोप प्रोब
• USB पावर ब्रिक, 5V
• USB 2.0 पिगटेल केबल

हार्डवेयर आर्किटेक्चर

flowchart LR
    Operator[Operator] --> Dashboard[Web Dashboard]
    Dashboard --> Apps[Python Apps]
    Apps --> CNC[GRBL CNC over USB serial]
    Apps --> Microscope[USB Microscope via mjpg-streamer]
    Apps --> Scope[Oscilloscope over LAN / SCPI]
    Apps --> Outlet[Optional LAN Power Outlet]

    Endstop[Optical Endstop] --> ScopeC4[Scope C4 Safety Voltage]
    Pogo[Pogo Measurement] --> ScopeC1[Scope C1 Measurement]
    ScopeC4 --> Apps
    ScopeC1 --> Apps

रनटाइम आर्किटेक्चर

flowchart TD
    Preflight[Preflight] --> SafetyCheck{Channel 4 clear?}
    SafetyCheck -- no --> Stop[STOP State]
    SafetyCheck -- yes --> Motion[Monitored Motion]
    Motion --> Monitor[EndstopMonitor thread >= 10 Hz]
    Monitor --> C4{C4 clear?}
    C4 -- yes --> Capture[Microscope Capture]
    C4 -- no --> FeedHold[Immediate feed hold]
    FeedHold --> Stop
    Capture --> Stitch[Stitch / Map]
    Stitch --> Review[Manual Probe Review]
    Review --> Approved{Approved target and measured probe offset?}
    Approved -- no --> Stop
    Approved -- yes --> Probe[Bounded probe motion]

STOP स्थिति

stateDiagram-v2
    [*] --> Running
    Running --> STOP: C4 triggered / C4 fault / CNC alarm / real limit pin
    STOP --> Report: log voltage, status, action
    Report --> WaitForOperator: no automatic recovery motion
    WaitForOperator --> Running: operator explicitly clears condition

त्वरित प्रारंभ

निर्भरताएं स्थापित करें:

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 एंडपॉइंट
• डैशबोर्ड: पोर्ट 5000 पर Flask

लैब-विशिष्ट होस्ट, पथ या लक्ष्य डेटा वाली स्थानीय पर्यावरण फ़ाइलें कमिट न करें।

मुख्य कार्यप्रवाह