प्लेस्टेशन 2 के लिए प्रोग्रामिंग: नियंत्रक पुस्तकालय - भाग एक

जब मैंने इस लेख को लिखना शुरू किया, तो मुझे महसूस हुआ कि अध्याय नियंत्रक पर अधिक जारी किए जाएंगे:
यह जॉयस्टिक स्वयं है, दूसरा जॉयस्टिक, कंपन और मल्टी-टैप (4 ​​जॉयस्टिक को एक पोर्ट से जोड़ने के लिए एक उपकरण) - मेरे पास यह है।
जॉयस्टिक के लिए स्वयं दो पुस्तकालय हैं, जिनमें से प्रत्येक अपनी जानकारी देता है।

मैं 2 मूल दोहरी शॉक 2 जॉयस्टिक्स का उपयोग करता हूं, हालांकि, मेरे पास दो गैर-मूल जॉयस्टिक्स हैं (कंप्यूटर को एक विशेष डिवाइस के माध्यम से या चार-प्लेयर मल्टी-टैप के माध्यम से कनेक्ट करने के लिए उपयोग किया जाता है), जिसका मैं अलग से उल्लेख करूंगा।



प्रत्येक नियंत्रक में एक तथाकथित टर्मिनल नियंत्रक है - यह वास्तविक बंदरगाह है जिसके माध्यम से आप नियंत्रक का उपयोग करते हैं।

नियंत्रकों को नियंत्रित करने के लिए, एक विशेष पुस्तकालय परिवाद है, जो बटन से डेटा प्रदान करता है, नियंत्रक मोड और कंपन को बदलता है।
वहाँ भी एक "नियमित" libmtap पुस्तकालय है। दोनों पुस्तकालय मल्टीटैप के साथ काम कर सकते हैं।

पुस्तकालय PS1 और PS2 से निम्नलिखित नियंत्रकों का समर्थन करता है:
साधारण डिजिटल नियंत्रक (एनालॉग्स के बिना): आईडी = 4 ;
दोहरी शॉक 1 और दोहरी शॉक 2: आईडी = 7 ;
NeGcon नियंत्रक: ID = 2 ;
सामान्य एनालॉग स्टिक: आईडी = 5 ;
नामको बंदूक : आईडी = 6 ;
जॉग कंट्रोलर और फिशिंग कंट्रोलर (गिटार को भी इसमें शामिल किया गया लगता है): विशेष। विस्तारित आईडी

बाकी के बारे में मैं रास्ते में जानकारी फिर से भर दूंगा।

पोर्ट और स्लॉट

पोर्ट और स्लॉट की अवधारणा PS2 में दो अलग-अलग चीजें हैं।
पोर्ट मुख्य नियंत्रकों को इंगित करता है - PS2 पर ही पहले और दूसरे जॉयस्टिक के लिए।
स्लॉट का उपयोग किया जाता है, अधिकांश समय, जब आपके पास मल्टीटैप होता है। मल्टी-जॉयस्टिक्स को एक पोर्ट (अधिकतम - 4) से जोड़ने के लिए मल्टी-टैप की आवश्यकता होती है। आमतौर पर, खेलों में इसे जॉयस्टिक 1 ए, जॉयस्टिक 1 बी आदि के रूप में प्रदर्शित किया जाता है।
यदि आपके पास एक मल्टीटैप नहीं है, तो, सिद्धांत रूप में, आपको परेशान नहीं करना चाहिए: पोर्ट 0, स्लॉट 0 - पहला जॉयस्टिक, पोर्ट 1, स्लॉट 0 - दूसरा जॉयस्टिक।
मल्टीटैप के साथ यह अलग होगा: यदि आप कहते हैं, दूसरे पोर्ट में एक मल्टीटैप डाला गया है और स्लॉट ए में इसे जॉयस्टिक से जोड़ा गया है, तो आपको पोर्ट 1, स्लॉट 0 का उपयोग करके इसे एक्सेस करने की आवश्यकता है।
यह छवि में पर्याप्त विवरण में देखा जा सकता है:



भविष्य के लिए मैं कहूंगा कि मेमोरी कार्ड के साथ भी काम होता है।

जॉयस्टिक के साथ कार्य करना

Libpad का उपयोग करने के लिए, आपको लाइब्रेरी “libpad.a” और हेडर फ़ाइल “libpad.h” से कनेक्ट करना होगा।
शुरू करने के लिए, आपको एप्लिकेशन स्टार्टअप पर "sceSifLoadModule ()" फ़ंक्शन का उपयोग करना चाहिए।
"-लपैड" पैरामीटर को मेकफाइल में जोड़ा जाना चाहिए।

नियंत्रकों का उपयोग करने के लिए बुनियादी प्रक्रियाएं:

scePadInit () - पुस्तकालय का आरंभ। पैरामीटर 0 है।

scePadPortOpen () - नियंत्रक पोर्ट को खोलना। रिटर्न इसके पैरामीटर हैं: पोर्ट, स्लॉट, बफर का उपयोग किया जाना। आकार में 64 बाइट होनी चाहिए। एक दृश्य घोषित करता है:
static u_long128 pad_dma_buf[scePadDmaBufferMax] __attribute__((aligned (64)));
जहां scePadDmaBufferMax एक स्थिर है जिसे आपको घोषित करने की आवश्यकता नहीं है।
इंट फ़ंक्शन लौटता है, जिसके द्वारा आप जांच सकते हैं कि जॉयस्टिक डाला गया है - यदि यह नहीं है, तो पैरामीटर 0 होगा;

इसके अलावा, पुस्तकालय नियंत्रक के साथ स्वचालित रूप से संवाद करना शुरू कर देता है जब नियंत्रक चालू होता है और खुला होता है। इसके अलावा दो कार्य हैं:

scePadRead () - बटन पढ़ने के लिए उपयोग किया जाता है।
फ़ंक्शन के 3 पैरामीटर हैं: परिणाम को बचाने के लिए पोर्ट और स्लॉट और बफर।
बफर एक अहस्ताक्षरित चार बफर [32] है;
फ़ंक्शन भी परिणाम देता है। और अगर यह शून्य के बराबर है, तो पढ़ना फ्लॉपी है।
अगला, हमें बस बफर को पढ़ने की आवश्यकता है, हालांकि वास्तव में यह आसान नहीं है।

scePadGetState () - इसका उपयोग करके, आप जांच सकते हैं कि नियंत्रक शांत स्थिति में है या नहीं। पोर्ट और स्लॉट मापदंडों को स्वीकार करता है।
नियंत्रक की स्थिति देता है। यदि स्थिति शून्य से अधिक और समान है, और 7 से भी कम या बराबर है, तो कुछ हुआ।

नियंत्रकों को बंद करने के लिए, scePadPortClose () फ़ंक्शन का उपयोग करें, जहां पोर्ट और स्लॉट पैरामीटर, और scePadEnd () के बाद लाइब्रेरी बंद हो जाती है। आमतौर पर इन दो कार्यों का उपयोग नहीं किया जाता है।

मैं जोड़ूंगा कि इन सभी कार्यों का उपयोग केवल एनालॉग्स पढ़ने के लिए किया जाता है यदि मोड चालू है।

सबसे आम उदाहरण इस तरह दिखेगा:

main(){<br> unsigned char rdata[32];<br> u_long128 pad_dma_buff[scePadDmaBufferMax] __attribute__((aligned(64)));<br> scePadInit();<br> scePadPortOpen(0, 0, pad_dma_buff);<br> while (1) {<br> scePadRead(0,0,rdata);<br> // <br> }<br> scePadPortClose(0,0);<br> scePadEnd();<br>} <br> * This source code was highlighted with Source Code Highlighter .

दोहरी शॉक और स्पर्श संवेदनशीलता

पहले आपको scePadSetMainMode () फ़ंक्शन के साथ एनालॉग मोड को सक्षम करना होगा। पैरामीटर पोर्ट, स्लॉट, 1 और 0. को परिणाम 0 या 1 के रूप में देता है, जिसका अर्थ है कि यह क्रमशः चालू या चालू नहीं है।

यह सत्यापित करने के लिए कि नियंत्रक वास्तव में ड्यूलशॉक है, आपको scePadInfoPressMode () फ़ंक्शन को कॉल करने की आवश्यकता है। पोर्ट और स्लॉट पैरामीटर लेता है, परिणाम को 0 या 1 के रूप में लौटाता है।

मोड को सक्षम करना स्वयं scePadEnterPressMode () फ़ंक्शन द्वारा किया जाता है। यह पिछले फ़ंक्शन की तरह ही पैरामीटर और रिटर्न लेता है।

इसके अलावा, बफर में scePadRead () फ़ंक्शन के माध्यम से, हम अतिरिक्त रूप से एक और बाइट प्राप्त करते हैं, जिसमें बटन दबाने की डिग्री 0 से 255 तक के मानों के साथ प्रदर्शित होती है। जहां 0 इस तथ्य के बराबर है कि बटन दबाया नहीं गया है।

मैं कहता हूं, एक नोट के लिए, कि मेरी पहली जॉयस्टिक कभी-कभी 3 तक दबाने का बल दिखाती है।
विनिर्देश के अनुसार, एनालॉग की गति में पूरी तरह से सामान्य त्रुटि प्लस या माइनस 25 है।

ScePadExitPressMode () फ़ंक्शन का उपयोग करके, आप कुंजी संवेदनशीलता मोड से बाहर निकल सकते हैं। यह एक पोर्ट और स्लॉट को स्वीकार करता है। आपको मेनू पर स्विच करने की आवश्यकता हो सकती है।

यदि उपयोगकर्ता संवेदनशील मोड के दौरान एनालॉग बटन दबाता है, तो वह संवेदनशीलता के बिना सामान्य डिजिटल मोड पर स्विच करेगा। एनालॉग बटन को फिर से दबाने से जॉयस्टिक को संवेदनशीलता मोड में वापस स्विच नहीं किया जाएगा ।

कंपन

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

मैं अगली बार आपको एक अन्य कंपन लाइब्रेरी के बारे में बताऊंगा, अभी मैं दो सरल पर्याप्त कार्यों के बारे में बात करूंगा, ये हैं scePadSetActAlign () और scePadSetActDirect (), जो एक पोर्ट, एक स्लॉट और 6 बाइट्स को घुमा के स्वीकार करते हैं।
पहले बाइट में आप एक मजबूत मोटर या कमजोर मोटर का संकेत देते हैं।
दूसरी बाइट में, कमजोर मोटर 0 या 1 मान पर ले जाती है, जिसका अर्थ है रुकना या मरोड़। एक मजबूत मोटर दूसरे बाइट में 1 से 255 या 0 तक मान लेती है, जिसका अर्थ है कि टॉर्सन बल या स्टॉप।
ScePadSetActDirect () फ़ंक्शन सही या गलत देता है, जो कंपन ऑपरेशन के पूरा होने का संकेत देता है। शेष बाइट्स को अधिमानतः 0xff से भरा होना चाहिए यदि आप उनका उपयोग नहीं कर रहे हैं।
उसके बाद, उपयोगकर्ता के जॉयस्टिक को कंपन संचालन के लिए 10 वर्तमान इकाइयाँ मिलेंगी।
वर्तमान इकाइयों की संख्या को 20 तक बढ़ाने के लिए, बस शेष मान 0x00 भरें।

महत्वपूर्ण!
आपको यह जानना होगा कि प्रत्येक पोर्ट 60 के बराबर वर्तमान इकाइयों की अधिकतम संख्या द्वारा सीमित है। यदि आप 60 से अधिक देने की कोशिश करते हैं, तो पोर्ट को तब तक अवरुद्ध किया जा सकता है जब तक कंसोल रिबूट (आंतरिक सीमक चालू नहीं हो जाता)।
इस प्रकार, अगर मेरे पास मल्टीटाप है, और मैं वर्तमान की 20 इकाइयों को 1 ए, 1 बी और 1 सी जॉयस्टिक में भेजूंगा, तो मैं 1 डी जॉयस्टिक के लिए ऐसा नहीं कर सकता, अन्यथा मैं बंदरगाह को अवरुद्ध कर सकता हूं। इसलिए, मैं आपको बढ़ी हुई वर्तमान आपूर्ति का उपयोग करने की सलाह नहीं देता।

यह भी जोड़ें कि इन कार्यों का उपयोग लंबे कंपन के लिए नहीं किया जा सकता है।

अतुल्यकालिक कार्य

निम्नलिखित कार्य एसिंक्रोनस हैं। हो सकता है कि वे उसी समय आपको परिणाम न लौटाएँ। इस स्थिति में, आप scePadGetState () या scePadGetReqState () फ़ंक्शन के माध्यम से उनके निष्पादन का परिणाम प्राप्त कर सकते हैं।

scePadSetMainMode - इनपुट मोड स्विच करना;
scePadSetActAlign - कंपन फ़ंक्शन;
scePadEnterPressMode - बटन संवेदनशीलता मोड में प्रवेश;
scePadExitPressMode - निकास बटन संवेदनशीलता मोड।

अंत के करीब

सामान्य तौर पर, सिद्धांत रूप में, एप्लिकेशन पोर्ट और स्लॉट के साथ काम करना जारी रखेगा, भले ही जॉयस्टिक को हटा दिया गया हो (बंद हो गया)। प्रोग्रामेटिक रूप से सत्यापित करें कि जॉयस्टिक scePadGetState () का उपयोग करके हटा दिया गया है, जो scePadStateDisconnect लौटाएगा।
प्रत्येक फ्रेम से पहले, नियंत्रक की स्थिति की जांच करने की सलाह दी जाती है, ताकि जॉयस्टिक गलती से बंद होने पर कोई स्थिति न हो।

इसके अलावा, DualShock या DualShock 2 नियंत्रकों के संस्करण के आधार पर, एनालॉग्स के विनिर्देश बदल सकते हैं और आपको जॉयस्टिक के स्वचालित अंशांकन पर भरोसा नहीं करना चाहिए। इसलिए, सबसे अधिक बार इस तथ्य को सुधार करना आवश्यक है कि एनालॉग 127x127 पर बंद नहीं हुआ।

वह सब है। अगले में मिलते हैं, जॉयस्टिक पर अधिक विस्तृत लेख।

पुनश्च : विषय की प्रासंगिकता को देखते हुए, मैंने यह लेख आधी रात और सुबह लिखा। यदि एसडीके अगले लेख के लिए तैयार है, तो जॉयस्टिक्स के बजाय स्थापना का वर्णन होगा।

अद्यतन : scePadInit () फ़ंक्शन को केवल EE का उपयोग करने की आवश्यकता है, जिसके बारे में मैं बात कर रहा हूं। IOP लाइब्रेरी को ही इनिशियलाइज़ करता है।