README
sigrok 프로젝트는 다양한 장치 유형(로직 분석기, 오실로스코프, 멀티미터 등)을 지원하는 이식성 높은 크로스 플랫폼 자유/오픈소스 신호 분석 소프트웨어 제품군을 만드는 것을 목표로 합니다.
libsigrok은 하드웨어와 통신하고 획득한 데이터를 다양한 입력/출력 파일 형식으로 읽고 쓰기 위한 기본 API를 제공하는 C로 작성된 공유 라이브러리입니다.
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 지원(-std=c++11 옵션)이 있는 C++ 컴파일러, 예:
- 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 include와 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
Libera.Chat의 #sigrok IRC 채널에서 sigrok 개발자를 찾을 수 있습니다.
Website
http://sigrok.org/wiki/Libsigrok