Hantek6022API 安装与配置指南

1. 项目基础介绍和主要的编程语言

Hantek6022API 是一个开源项目，基于Robert和Jochen的出色工作，主要关注于在Linux系统（开发系统为Debian稳定版）下对Hantek6022BE/BL示波器的支持和使用。该项目提供了一个Python API，使得用户可以通过简单的Python命令来操作Hantek 6022示波器。

该项目主要使用Python编程语言，依赖于libusb库来实现与示波器的通信。

2. 项目使用的关键技术和框架

• libusb: 用于与示波器硬件进行通信的库。
• sdcc: 小型设备C编译器，用于编译自定义固件。
• udev: 用于配置Linux系统中的设备权限。
• Python: 作为主要的编程语言，用于实现API和示例程序。

3. 项目安装和配置的准备工作和详细的安装步骤

准备工作

在开始安装之前，请确保您的系统满足以下要求：

• 操作系统: Debian stable 版本（stretch, buster, bullseye, bookworm）或Ubuntu 22.04。
• 安装包:
  • sdcc
  • pkgconf
  • python3-setuptools
  • python3-stdeb
  • dh-python
  • python3-libusb1
  • libusb-1.0
  • libusb-1.0-0-dev

安装步骤

1. 克隆仓库:

   使用以下命令克隆项目仓库：

   git clone https://github.com/Ho-Ro/Hantek6022API.git
   

2. 安装依赖:

   在项目根目录下执行以下命令安装编译固件所需的依赖：

   sudo apt install sdcc pkgconf
   

   如果您使用的是sdcc版本从3.9升级到4.0，请注意可能出现的代码质量问题。

3. 初始化子模块:

该项目使用了一个子模块fx2lib，您需要执行以下命令来初始化和更新子模块：

git submodule init
git submodule update --remote

4. 编译自定义固件:

   在项目根目录下执行以下命令编译固件：

   make
   

5. 安装udeb规则:

   将udev/60-hantek6022api.rules文件复制到/etc/udev/rules.d/目录下，以赋予正确的设备权限：

   sudo cp udev/60-hantek6022api.rules /etc/udev/rules.d/
   

6. 编译Debian包:

   安装构建Debian包所需的额外依赖：

   sudo apt install python3-setuptools python3-stdeb dh-python python3-libusb1 sdcc libusb-1.0 libusb-1.0-0-dev
   

   然后执行以下命令创建Debian包：

   make deb
   

   安装Debian包：

   sudo dpkg -i deb_dist/hantek6022api_*.deb
   

7. 使用示例程序:

   在examples目录下，您会找到一些示例程序。您可以直接运行这些程序，例如：

   python3 get_serial_number.py
   

按照以上步骤，您应该能够成功安装和配置Hantek6022API项目，并开始使用它来操作Hantek 6022示波器。