logitech-ipc-protocol

Logi Options+ एजेंट IPC प्रोटोकॉल का रिवर्स-इंजीनियर्ड दस्तावेज़ीकरण। यह मैकओएस और विंडोज दोनों पर बिना रॉ HID एक्सेस के लॉजिटेक मल्टी-होस्ट उपकरणों (होस्ट स्विचिंग, डिवाइस क्वेरी) के प्रोग्रामेटिक नियंत्रण को सक्षम बनाता है।

इस परियोजना से पहले इस प्रोटोकॉल को सार्वजनिक रूप से प्रलेखित नहीं किया गया था।

समस्या

macOS कर्नेल स्तर पर ब्लूटूथ इनपुट उपकरणों तक रॉ HID एक्सेस को ब्लॉक करता है। कोई अनुमति, एंटाइटलमेंट या हैक इसे बायपास नहीं करते। Logi Options+ एजेंट के पास Apple-हस्ताक्षरित एंटाइटलमेंट (com.apple.security.device.bluetooth) हैं जो इसे ब्लूटूथ HID एक्सेस प्रदान करते हैं। यह परियोजना इसके बजाय एजेंट के IPC चैनल के माध्यम से संचार करती है।

फ़ाइलें

उपयोग

Mac

python3 switch_to_windows.py 0        # होस्ट 0 पर स्विच करें (DisplayPort)
python3 switch_to_windows.py 1        # होस्ट 1 पर स्विच करें (HDMI)
python3 switch_to_windows.py --dry-run 0  # दिखाएँ कि क्या होगा

Logi Options+ चल रहा होना चाहिए और m1ddc इंस्टॉल होना चाहिए (brew install m1ddc)।

Windows

# AHK हॉटकी लिसनर प्रारंभ करें (सिस्टम ट्रे में चलता है, कोई कंसोल नहीं)
# AutoHotkey v2 आवश्यक: winget install AutoHotkey.AutoHotkey
start kvm.ahk

# या सीधे कमांड लाइन से स्विच करें
python kvm_daemon_windows.py --switch 1

# बिना स्विच किए खोजे गए उपकरण और कॉन्फ़िगर हॉटकी दिखाएँ
python kvm_daemon_windows.py --dry-run

Logi Options+ चल रहा होना चाहिए। निर्भरताएँ इंस्टॉल करें: pip install pywin32.

AHK स्क्रिप्ट Win+1/2/3 को सुनती है और प्रत्येक के लिए kvm_daemon_windows.py --switch N को कॉल करती है। Python स्क्रिप्ट एजेंट से स्वचालित रूप से उपकरण खोजती है (कोई हार्डकोडेड डिवाइस ID या HID पथ नहीं)। हॉटकी और मॉनिटर DDC/CI इनपुट मान कॉन्फ़िगर करने के लिए kvm_config.ini संपादित करें।

प्रोटोकॉल

एजेंट सुनता है:

• macOS: यूनिक्स डोमेन सॉकेट /tmp/logitech_kiros_agent-<hash> पर
• Windows: नामित पाइप \\.\pipe\logitech_kiros_agent-<hash> पर

दोनों प्लेटफार्मों पर समान वायर प्रोटोकॉल। बाइनरी फ्रेम प्रारूप:

LE32(total_len) + BE32(proto_name_len) + "json" + BE32(msg_len) + JSON_message

एक डिवाइस को दूसरे होस्ट पर स्विच करें:

{
  "msg_id": "1",
  "verb": "SET",
  "path": "/change_host/<device_id>/host",
  "payload": {
    "@type": "type.googleapis.com/logi.protocol.devices.ChangeHost",
    "host": 0
  }
}

पेलोड एक google.protobuf.Any फ़ील्ड है जो @type एनोटेशन के साथ इनलाइन JSON के रूप में क्रमबद्ध है। एजेंट एक सख्त प्रोटोबफ़ JSON पार्सर का उपयोग करता है; अज्ञात फ़ील्ड INVALID_MESSAGE_RECEIVED का कारण बनते हैं।

अनुरोध msg_id (snake_case) का उपयोग करते हैं। प्रतिक्रियाएँ msgId (camelCase) का उपयोग करती हैं। क्रियाएँ स्ट्रिंग हैं: "GET", "SET", "SUBSCRIBE", "BROADCAST"।

पूर्ण प्रोटोकॉल दस्तावेज़ीकरण के लिए logi-options-ipc-reverse-engineering.md देखें।

IPC त्रुटि प्रबंधन

लंबे समय तक चलने वाले ऑटोमेशन के लिए, BrokenPipeError पर पुनः कनेक्ट करें और सॉकेट/पाइप पथ को फिर से खोजें।

Windows HID++ गॉचा

ये तब लागू होते हैं जब HID++ कमांड सीधे भेजे जाते हैं, एजेंट के माध्यम से नहीं। kvm_daemon_windows.py एजेंट के नामित पाइप के माध्यम से जाकर इन सभी से बचता है।

Get-PnpDeviceProperty -InstanceId "<instance_id>" -KeyName DEVPKEY_Device_HardwareIds
# UP:FF43_U:0202 देखें

भेजें: {0x11, 0x00, 0x00, 0x0D, 0x18, 0x14, ...}  (20 बाइट्स)
पढ़ें: प्रतिक्रिया बाइट 4 = फीचर इंडेक्स

परीक्षण किए गए संस्करण

वायर प्रोटोकॉल और कोर API पथ (/devices/list, /change_host/<id>/host) स्थिर रहे हैं। डिवाइस पुनः-युग्मन ने HID पथ और संग्रह संख्याओं को तोड़ा लेकिन IPC प्रोटोकॉल स्वयं प्रभावित नहीं हुआ।

अस्वीकरण

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

यह परियोजना Logitech से संबद्ध या समर्थित नहीं है।

लाइसेंस

MIT