वूजी हैंड सेटअप गाइड

वुजी हाथ को पैकेजिंग से हटा दें और किसी भी शिपिंग क्षति के लिए उंगलियों के जोड़ों, केबल कनेक्शन और यूएसबी कनेक्टर का निरीक्षण करें। सभी 5 अंगुलियों के जोड़ों को स्वतंत्र रूप से घूमना चाहिए।

वूजी हैंड को यूएसबी के माध्यम से अपने कंप्यूटर में प्लग करें। पुष्टि करें कि डिवाइस प्रकट होता है:

# Linux — confirm USB device at VID 0x0483
lsusb | grep 0483

यदि डिवाइस दिखाई देता है lsusb लेकिन आप इसे खोल नहीं सकते, स्वयं को इसमें जोड़ें dialout समूह (या VID/PID के लिए एक udev नियम जोड़ें):

sudo usermod -aG dialout $USER
# Log out and back in for the group change to take effect

वूजी एसडीके पायथन पैकेज स्थापित करें और सुन्न करें। wujihandpy पैकेज यूएसबी पर हार्डवेयर के साथ सीधे संचार करता है और संयुक्त स्थिति और सेंसर रीडिंग एपीआई प्रदान करता है।

pip install wujihandpy numpy

इंस्टॉल सत्यापित करें:

python3 -c "import wujihandpy; print(wujihandpy.__version__)"

प्लेटफ़ॉर्म पाइपलाइन के बिना संयुक्त स्थिति और दबाव मानचित्रों के जीयूआई विज़ुअलाइज़ेशन के लिए वैकल्पिक रूप से वूजी स्टूडियो स्थापित करें - हार्डवेयर लाने और अंशांकन के लिए उपयोगी:

# Linux amd64
wget https://studio.wuji.ai/releases/wuji-studio_0.7.0_amd64.deb
sudo dpkg -i wuji-studio_0.7.0_amd64.deb

JSONL ब्रिज स्क्रिप्ट प्रारंभ करें। यह से पढ़ता है wujihandpy और 30 हर्ट्ज़ पर स्टडआउट करने के लिए प्रति पंक्ति एक JSON ऑब्जेक्ट उत्सर्जित करता है। आपको फ़्रेम युक्त देखना चाहिए bends, joint_actual_position_5x4, pressure_map_24x32, imu, और emf खेत.

python3 wuji_hand_sdk_stream.py --hand-side right --hz 30

लॉन्च करें wuji_glove_agent. यह स्ट्रीम स्क्रिप्ट को एक सबप्रोसेस के रूप में लपेटता है, JSONL आउटपुट को पार्स करता है, और वेबसॉकेट के माध्यम से डिकोडेड सेंसर डेटा को फियरलेस प्लेटफ़ॉर्म पर अग्रेषित करता है। आपको प्लेटफ़ॉर्म से एक सत्र आईडी की आवश्यकता होगी.

python3 wuji_glove_agent.py \
  --session YOUR_SESSION_ID \
  --node-id wuji-right \
  --glove right

द्विपक्षीय (बाएँ + दाएँ) रिकॉर्डिंग के लिए, एक ही सत्र से जुड़ी दो एजेंट प्रक्रियाएँ चलाएँ:

# Terminal 1 — right hand
python3 wuji_glove_agent.py \
  --session RC-XXXX-XXXX --node-id wuji-right --glove right \
  --wuji-cmd "python3 wuji_hand_sdk_stream.py --hand-side right --serial-number SN001"

# Terminal 2 — left hand
python3 wuji_glove_agent.py \
  --session RC-XXXX-XXXX --node-id wuji-left --glove left \
  --wuji-cmd "python3 wuji_hand_sdk_stream.py --hand-side left --serial-number SN002"

एजेंट कनेक्ट होने के बाद, प्लेटफ़ॉर्म ग्लोववर्कबेंच पैनल सभी 5 उंगलियों और 24×32 स्पर्श हीटमैप के लिए वास्तविक समय बेंड बार प्रस्तुत करता है। सत्यापित करें कि जब आप प्रत्येक उंगली को मोड़ते हैं तो उंगली मोड़ मान सही ढंग से चलते हैं।

एजेंट के चलने और प्लेटफ़ॉर्म पैनल पर लाइव डेटा दिखाने के साथ, एक प्रदर्शन एपिसोड रिकॉर्ड करना शुरू करें:

• पर नेविगेट करें एपिसोड फियरलेस प्लेटफ़ॉर्म में पैनल और क्लिक करें अभिलेख.
• वुजी हाथ पहनकर अपना हेरफेर कार्य करें।
• क्लिक रुकना जब एपिसोड पूरा हो जाए. एपिसोड तुरंत अपलोड हो जाता है और एपिसोड ब्राउज़र में दिखाई देता है।

एपिसोड को पूर्ण के साथ JSONL (प्रति पंक्ति एक फ्रेम) के रूप में संग्रहीत किया जाता है joints, pressure_map_24x32, imu, और emf पेलोड प्लस सत्र आईडी और मिलीसेकंड टाइमस्टैम्प। उन्हें प्लेटफ़ॉर्म एपीआई के माध्यम से डाउनलोड किया जा सकता है, दोबारा चलाया जा सकता है या सीधे प्रशिक्षण पाइपलाइन में डाला जा सकता है।

पूर्ण एजेंट फ़्लैग संदर्भ, JSONL फ़्रेम प्रारूप और प्लेटफ़ॉर्म एकीकरण विवरण के लिए, देखें वूजी हैंड विकी पेज.