README
sigrok परियोजना का लक्ष्य एक पोर्टेबल, क्रॉस-प्लेटफ़ॉर्म, मुक्त/लिब्रे/ओपन-सोर्स सिग्नल विश्लेषण सॉफ़्टवेयर सूट बनाना है जो विभिन्न डिवाइस प्रकारों (जैसे लॉजिक विश्लेषक, ऑसिलोस्कोप, मल्टीमीटर, और अधिक) का समर्थन करता है।
libsigrok C में लिखी गई एक साझा लाइब्रेरी है जो हार्डवेयर से संवाद करने और अधिग्रहीत डेटा को विभिन्न इनपुट/आउटपुट फ़ाइल प्रारूपों में पढ़ने/लिखने के लिए मूल API प्रदान करती है।
Status
libsigrok उपयोग योग्य स्थिति में है और इसके आधिकारिक tarball रिलीज़ हो चुके हैं।
हालाँकि API एक रिलीज़ से दूसरे रिलीज़ में बदल सकता है, यह हमेशा उचित रूप से प्रलेखित किया जाएगा और पैकेज संस्करण संख्या तथा साझा लाइब्रेरी / libtool / .so-फ़ाइल संस्करण संख्याओं में परिलक्षित होगा।
हालाँकि, git स्नैपशॉट में स्थिर API की कोई गारंटी नहीं है! डिस्ट्रो पैकेजर्स को केवल रिलीज़ किए गए tarball का उपयोग करना चाहिए (git स्नैपशॉट नहीं)।
Requirements
C लाइब्रेरी के लिए आवश्यकताएँ:
- git (केवल git से निर्माण करते समय आवश्यक)
- gcc (>= 4.0) या clang
- make
- autoconf >= 2.63 (केवल git से निर्माण करते समय आवश्यक)
- automake >= 1.11 (केवल git से निर्माण करते समय आवश्यक)
- libtool (केवल git से निर्माण करते समय आवश्यक)
- pkg-config >= 0.22
- libglib >= 2.32.0
- zlib (वैकल्पिक, STF इनपुट में CRC32 गणना के लिए उपयोग किया जाता है)
- libzip >= 0.11
- libtirpc (वैकल्पिक, VXI द्वारा उपयोग किया जाता है, glibc >= 2.26 होने पर फ़ॉलबैक)
- libserialport >= 0.1.1 (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- librevisa >= 0.0.20130412 (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- libusb-1.0 >= 1.0.16 (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- hidapi >= 0.8.0 (वैकल्पिक, कुछ HID-आधारित "सीरियल केबल" के लिए उपयोग किया जाता है)
- bluez/libbluetooth >= 4.0 (वैकल्पिक, Bluetooth/BLE संचार के लिए उपयोग किया जाता है)
- libftdi1 >= 1.0 (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- libgpib (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- libieee1284 (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- libgio >= 2.32.0 (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- nettle (वैकल्पिक, कुछ ड्राइवरों द्वारा उपयोग किया जाता है)
- check >= 0.9.4 (वैकल्पिक, केवल यूनिट परीक्षण चलाने के लिए आवश्यक)
- doxygen (वैकल्पिक, केवल C API दस्तावेज़ों के लिए आवश्यक)
- graphviz (वैकल्पिक, केवल C API दस्तावेज़ों के लिए आवश्यक)
C++ बाइंडिंग्स के लिए आवश्यकताएँ:
- libsigrok >= 0.4.0 (libsigrok C लाइब्रेरी, ऊपर देखें)
- C++11 समर्थन वाला एक C++ कंपाइलर (-std=c++11 विकल्प), जैसे
- g++ (>= 4.8.1)
- clang++ (>= 3.3)
- autoconf-archive (केवल git से निर्माण करते समय आवश्यक)
- doxygen (बाइंडिंग्स के निर्माण के लिए आवश्यक है, न कि केवल C++ API दस्तावेज़ों के लिए!)
- graphviz (वैकल्पिक, केवल C++ API दस्तावेज़ों के लिए आवश्यक)
- Python 3 एक्ज़ीक्यूटेबल (डेवलपमेंट फ़ाइलों की आवश्यकता नहीं है)
- glibmm-2.4 (>= 2.32.0) या glibmm-2.68 (>= 2.68.0)
Python बाइंडिंग्स के लिए आवश्यकताएँ:
- libsigrokcxx >= 0.4.0 (libsigrok C++ बाइंडिंग्स, ऊपर देखें)
- SWIG >= 2.0.0
- Python >= 3 (डेवलपमेंट फ़ाइलों सहित!)
- Python setuptools
- pygobject >= 3.0.0, उर्फ python-gi
- numpy
- doxygen (वैकल्पिक, केवल Python API दस्तावेज़ों के लिए आवश्यक)
- graphviz (वैकल्पिक, केवल Python API दस्तावेज़ों के लिए आवश्यक)
- doxypy (वैकल्पिक, केवल Python API दस्तावेज़ों के लिए आवश्यक)
Ruby बाइंडिंग्स के लिए आवश्यकताएँ:
- libsigrokcxx >= 0.4.0 (libsigrok C++ बाइंडिंग्स, ऊपर देखें)
- Ruby >= 2.5.0 (डेवलपमेंट फ़ाइलों सहित!)
- SWIG >= 3.0.8
- YARD (वैकल्पिक, केवल Ruby API दस्तावेज़ों के लिए आवश्यक)
Java बाइंडिंग्स के लिए आवश्यकताएँ:
- libsigrokcxx >= 0.4.0 (libsigrok C++ बाइंडिंग्स, ऊपर देखें)
- SWIG >= 2.0.0
- Java JDK (JNI इन्क्लूड्स और javac/jar बाइनरी के लिए)
- doxygen (वैकल्पिक, केवल Java API दस्तावेज़ों के लिए आवश्यक)
- graphviz (वैकल्पिक, केवल Java API दस्तावेज़ों के लिए आवश्यक)
Building and installing
libsigrok सोर्स कोड प्राप्त करने और इसे बनाने के लिए, चलाएँ:
$ git clone git://sigrok.org/libsigrok
$ cd libsigrok
$ ./autogen.sh
$ ./configure
$ make
libsigrok स्थापित करने के लिए:
$ make install
अधिक (OS-विशिष्ट) निर्देशों के लिए INSTALL या निम्न विकी पृष्ठ देखें:
http://sigrok.org/wiki/Building
यदि आपको कोई समस्या आती है तो कृपया निम्न विकी पृष्ठ भी देखें:
http://sigrok.org/wiki/Building#FAQ
Device-specific issues
कृपया डिवाइस- या ड्राइवर-विशिष्ट मुद्दों के बारे में कुछ नोट्स और संकेतों के लिए README.devices देखें जिनके बारे में जागरूक रहना चाहिए।
Firmware
libsigrok द्वारा समर्थित कुछ डिवाइसों को डिवाइस का उपयोग करने से पहले फ़र्मवेयर अपलोड करने की आवश्यकता होती है। विवरण के लिए README.devices देखें।
Copyright and license
libsigrok GNU जनरल पब्लिक लाइसेंस (GPL), संस्करण 3 या उसके बाद की शर्तों के तहत लाइसेंस प्राप्त है।
जबकि कुछ व्यक्तिगत सोर्स कोड फ़ाइलें GPLv2+ के तहत लाइसेंस प्राप्त हैं, और कुछ फ़ाइलें GPLv3+ के तहत लाइसेंस प्राप्त हैं, यह इस तथ्य को नहीं बदलता कि पूरी लाइब्रेरी GPLv3+ की शर्तों के तहत लाइसेंस प्राप्त है।
कॉपीराइट धारकों की पूरी सूची के लिए कृपया व्यक्तिगत सोर्स फ़ाइलें देखें।
Mailing list
https://lists.sourceforge.net/lists/listinfo/sigrok-devel
IRC
आप sigrok डेवलपर्स को Libera.Chat पर #sigrok IRC चैनल में पा सकते हैं।
Website
http://sigrok.org/wiki/Libsigrok