README
sigrok 项目旨在创建一个可移植、跨平台的自由/开源信号分析软件套件,支持多种设备类型(例如逻辑分析仪、示波器、万用表等)。
libsigrok 是一个用 C 编写的共享库,提供了与硬件通信以及将采集到的数据读写为各种输入/输出文件格式的基本 API。
状态
libsigrok 已可正常使用,并已发布官方 tarball 版本。
虽然 API 在不同版本之间可能会发生变化,但这一点始终会在包版本号以及共享库 / libtool / .so 文件版本号中得到适当的记录和体现。
但是,对于 git 快照中的稳定 API,_完全没有_任何保证!发行版打包人员应仅使用已发布的 tarball(不要使用 git 快照)。
依赖要求
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(可选,用于蓝牙/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 文档)
构建与安装
为了获取 libsigrok 源代码并构建它,请运行:
$ git clone git://sigrok.org/libsigrok
$ cd libsigrok
$ ./autogen.sh
$ ./configure
$ make
安装 libsigrok:
$ make install
更多(与操作系统相关的)说明,请参阅 INSTALL 或以下 wiki 页面:
http://sigrok.org/wiki/Building
如果遇到任何问题,也请查看以下 wiki 页面:
http://sigrok.org/wiki/Building#FAQ
设备相关问题
有关需要注意的特定设备或驱动程序问题,请查阅 README.devices 中的说明和提示。
固件
libsigrok 支持的某些设备需要先上传固件才能使用。详细信息请参阅 README.devices。
版权与许可证
libsigrok 根据 GNU 通用公共许可证(GPL)第 3 版或更高版本的条款进行许可。
虽然某些单独的源代码文件采用 GPLv2+ 许可,一些文件采用 GPLv3+ 许可,但这不会改变整个库采用 GPLv3+ 许可的事实。
请查看各个源文件以获取完整的版权持有人列表。
邮件列表
https://lists.sourceforge.net/lists/listinfo/sigrok-devel
IRC
你可以在 Libera.Chat 上的 #sigrok IRC 频道中找到 sigrok 开发者。
网站
http://sigrok.org/wiki/Libsigrok