rdpoor / rigol-grab

Capture Rigol DS1054Z Oscilloscope display as a .png file

rigol_grab

Capture Rigol DS1054Z Oscilloscope Display as a .png file, for MacOS, Linux and Windows

The Rigol DS1054Z Oscilloscope is a powerful multi-channel tool for the hobbyist and professional alike. It includes a USB port, but there's not much in the way of software support for Linux and macOS systems.

rigol_grab is a cross-platform Python-based script that lets you capture the contents of the Rigol Oscilloscope display to a .png file via USB or Ethernet connection, such as this:

Setup

The setup process assumes you already have git, Python and pipenv set up on your machine. In a shell window:

> cd <your chosen directory>
> git clone https://github.com/rdpoor/rigol-grab.git
> cd rigol-grab
> pipenv install

Running rigol_grab

First, plug the Rigol 'scope into your computer via USB cable or connect it to your network and note its IP address. Then, in a shell window use these commands for a USB connection:

> cd <your chosen directory>/rigol-grab
> pipenv shell
> python rigol_grab.py --auto_view

Or use these commands for an Ethernet connection (substitute your Rigol's own IP address):

> cd <your chosen directory>/rigol-grab
> pipenv shell
> python rigol_grab.py --auto_view --port 127.0.0.1

Note that the --auto_view argument will cause the .png file to be opened immediately using the default viewer for your system.

Options

rigol_grab.py accepts command line arguments:

--verbose: print additional information
--filename <filename.png>: specify the pathname of the saved .png file (default: rigol.png)
--auto_view: automatically open the .png using your system viewer
--port: IP address of the oscilloscope if using Ethernet instead of USB

Caveats

There are a few known bugs. Top scientists are investigating these issues and hope to have a fix. Or you can propose a fix with a pull request:

• The program always throws an error upon exiting. This appears to be benign.
• Once every two or three times, the .png data is corrupted. If this happens, just re-run the script.
• There's been zero testing on Linux systems. But it might work.

Support

Feel free to post issues and feature requests in the Issues section.

And if the spirit so moves you, please submit pull requests for enhancements.

rigol-grab's Issues

Simple PowerShell Script

I hope this is an appropriate place to post this. I've created a simple PowerShell script to aid in running the rigol_grab.py script. All it does is prompt for an IP Address and File name which I found quite useful when needing to do lots of repetitive but unique captures. Below is a short video showing the primary usecase, however it has some error handling built in as well! Let me know what people think about this or if I should create a pull request to add this in. (Used ChatGPT for a lot of the script creation FYI)

1. Have all dependencies setup as described here.
2. Place the script into the folder containing "rigol_grab.py" (Likely \rigol-grab-master)
3. Launch the script, it will prompt for an IP Address which will be saved to a .txt file for future use.
4. Enter what the name of the image should be.
5. Profit $

.ps1 Script Download: Grab Rigol Screen V3.zip

(If the script isn't launching properly due to a ExecutionPolicy error then just copying the script into a new file and execute that. PowerShell by default doesn't like you running random scripts from the internet, fair enough lol)

Video.mp4

PS1 Code:

# Define an array of affirmative responses
$affirmativeResponses = @("Y", "y", "Yes", "yes")

# Define a function to run the script
function RunScript {
    # Get the directory path of the script file
    $scriptDirectory = $PSScriptRoot

    # Define the path to the file to store the IP address
    $ipFilePath = Join-Path -Path $scriptDirectory -ChildPath "rigol_ip_address.txt"

    Write-Host "----------------------------------------------------------------------" -ForegroundColor Blue
    Write-Host "--Grab Rigol Screen V3 Script. Will save outputs to \output folder.--" -ForegroundColor Blue
    Write-Host "--By Justin W. (And ChatGPT)--" -ForegroundColor Blue

    # Check if the IP address file exists
    if (Test-Path $ipFilePath) {
        # If the file exists, read the IP address from it
        $ipAddress = Get-Content $ipFilePath
        Write-Host "Found rigol_ip_address.txt file. IP: $ipAddress"
    } else {
        # If the file doesn't exist, prompt for IP address
        Write-Host "Couldn't find rigol_ip_address.txt file..."
        $ipAddress = Read-Host "Enter IP Address"
        # Save the entered IP address to the file
        $ipAddress | Out-File $ipFilePath
        Write-Host "IP Address saved to rigol_ip_address.txt file."
    }

    # Prompt user for filename
    $filename = Read-Host "Enter filename (without extension)"

    # Append .png extension to the filename
    $filename += ".png"

    # Define the subfolder path
    $subfolderPath = Join-Path -Path $scriptDirectory -ChildPath "output"

    # Ensure the subfolder exists, if not, create it
    if (-not (Test-Path $subfolderPath)) {
        New-Item -Path $subfolderPath -ItemType Directory | Out-Null
    }

    # Activate the Pipenv shell and execute the command
    pipenv run python rigol_grab.py --verbose --filename $filename --port $ipAddress

    # Attempt to move the outputted file to the subfolder
    try {
        Move-Item -Path $filename -Destination $subfolderPath -ErrorAction Stop
        Write-Host "Output file moved successfully."
        # Display the path of the moved file
        Write-Host "Output file path: $($subfolderPath)\$filename"
		Write-Host "Finished! Restarting..." -ForegroundColor Green
    } catch {
        Write-Host "Error occurred while moving the output file: $_" -ForegroundColor Red
        # Prompt the user if they want to change the IP address in the .txt file
        $changeIP = Read-Host "Do you want to change the IP address in the rigol_ip_address.txt file? (yes/no)"
        if ($affirmativeResponses -contains $changeIP) {
            $ipAddress = Read-Host "Enter new IP Address"
            $ipAddress | Out-File $ipFilePath
            Write-Host "IP Address updated in rigol_ip_address.txt file."
            # Restart the script
            RunScript
            return
        }
    }
}

# Run the script in a loop
do {
    RunScript
} while ($true)

Write-Host "Script has ended."

DS1102E

Would you help me adopt this for DS1102E

USB0::0x1AB1::0x0588::DS1ET155226316::INSTR

Much appreciated!

Build instructions don't work on Apple M2 / Sonoma 14.3.1

stepan@imhotep rigol-grab % pipenv install
Installing dependencies from Pipfile.lock (0e10d6)...
[pipenv.exceptions.InstallError]: Collecting cycler==0.10.0 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 1))
[pipenv.exceptions.InstallError]:   Using cached cycler-0.10.0-py2.py3-none-any.whl (6.5 kB)
[pipenv.exceptions.InstallError]: Collecting kiwisolver==1.1.0 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 2))
[pipenv.exceptions.InstallError]:   Using cached kiwisolver-1.1.0-cp311-cp311-macosx_14_0_arm64.whl
[pipenv.exceptions.InstallError]: Collecting matplotlib==3.1.1 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 3))
[pipenv.exceptions.InstallError]:   Using cached matplotlib-3.1.1-cp311-cp311-macosx_14_0_arm64.whl
[pipenv.exceptions.InstallError]: Collecting numpy==1.17.2 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 4))
[pipenv.exceptions.InstallError]:   Using cached numpy-1.17.2.zip (6.5 MB)
[pipenv.exceptions.InstallError]:   Preparing metadata (setup.py): started
[pipenv.exceptions.InstallError]:   Preparing metadata (setup.py): finished with status 'done'
[pipenv.exceptions.InstallError]: Collecting pyparsing==2.4.2 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 5))
[pipenv.exceptions.InstallError]:   Using cached pyparsing-2.4.2-py2.py3-none-any.whl (65 kB)
[pipenv.exceptions.InstallError]: Collecting python-dateutil==2.8.0 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 6))
[pipenv.exceptions.InstallError]:   Using cached python_dateutil-2.8.0-py2.py3-none-any.whl (226 kB)
[pipenv.exceptions.InstallError]: Collecting pyusb==1.0.2 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 7))
[pipenv.exceptions.InstallError]:   Using cached pyusb-1.0.2-py3-none-any.whl
[pipenv.exceptions.InstallError]: Collecting pyvisa==1.10.1 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 8))
[pipenv.exceptions.InstallError]:   Using cached PyVISA-1.10.1-py3-none-any.whl
[pipenv.exceptions.InstallError]: Collecting pyvisa-py==0.3.1 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 9))
[pipenv.exceptions.InstallError]:   Using cached PyVISA_py-0.3.1-py3-none-any.whl (45 kB)
[pipenv.exceptions.InstallError]: Collecting six==1.12.0 (from -r /var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pipenv-0m354e34-requirements/pipenv-9gnjujw7-hashed-reqs.txt (line 10))
[pipenv.exceptions.InstallError]:   Using cached six-1.12.0-py2.py3-none-any.whl (10 kB)
[pipenv.exceptions.InstallError]: Building wheels for collected packages: numpy
[pipenv.exceptions.InstallError]:   Building wheel for numpy (setup.py): started
[pipenv.exceptions.InstallError]:   Building wheel for numpy (setup.py): finished with status 'error'
[pipenv.exceptions.InstallError]:   Running setup.py clean for numpy
[pipenv.exceptions.InstallError]: Failed to build numpy
[pipenv.exceptions.InstallError]: error: subprocess-exited-with-error
[pipenv.exceptions.InstallError]:   
[pipenv.exceptions.InstallError]:   × python setup.py bdist_wheel did not run successfully.
[pipenv.exceptions.InstallError]:   │ exit code: 1
[pipenv.exceptions.InstallError]:   ╰─> [246 lines of output]
[pipenv.exceptions.InstallError]:       Running from numpy source directory.
[pipenv.exceptions.InstallError]:       blas_opt_info:
[pipenv.exceptions.InstallError]:       blas_mkl_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries mkl_rt not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       blis_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries blis not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       openblas_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries openblas not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_3_10_blas_threads_info:
[pipenv.exceptions.InstallError]:       Setting PTATLAS=ATLAS
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries tatlas not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_3_10_blas_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries satlas not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_blas_threads_info:
[pipenv.exceptions.InstallError]:       Setting PTATLAS=ATLAS
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries ptf77blas,ptcblas,atlas not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_blas_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries f77blas,cblas,atlas not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       accelerate_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries accelerate not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:       Library accelerate was not found. Ignoring
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries veclib not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:       Library veclib was not found. Ignoring
[pipenv.exceptions.InstallError]:         FOUND:
[pipenv.exceptions.InstallError]:           extra_compile_args = ['-faltivec', '-I/System/Library/Frameworks/vecLib.framework/Headers']
[pipenv.exceptions.InstallError]:           extra_link_args = ['-Wl,-framework', '-Wl,Accelerate']
[pipenv.exceptions.InstallError]:           define_macros = [('NO_ATLAS_INFO', 3), ('HAVE_CBLAS', None)]
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:         FOUND:
[pipenv.exceptions.InstallError]:           extra_compile_args = ['-faltivec', '-I/System/Library/Frameworks/vecLib.framework/Headers']
[pipenv.exceptions.InstallError]:           extra_link_args = ['-Wl,-framework', '-Wl,Accelerate']
[pipenv.exceptions.InstallError]:           define_macros = [('NO_ATLAS_INFO', 3), ('HAVE_CBLAS', None)]
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       /bin/sh: svnversion: command not found
[pipenv.exceptions.InstallError]:       non-existing path in 'numpy/distutils': 'site.cfg'
[pipenv.exceptions.InstallError]:       lapack_opt_info:
[pipenv.exceptions.InstallError]:       lapack_mkl_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries mkl_rt not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       openblas_lapack_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries openblas not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       openblas_clapack_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries openblas,lapack not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       flame_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries flame not found in ['/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib', '/usr/lib']
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_3_10_threads_info:
[pipenv.exceptions.InstallError]:       Setting PTATLAS=ATLAS
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries tatlas,tatlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries tatlas,tatlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       <class 'numpy.distutils.system_info.atlas_3_10_threads_info'>
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_3_10_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries satlas,satlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries satlas,satlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       <class 'numpy.distutils.system_info.atlas_3_10_info'>
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_threads_info:
[pipenv.exceptions.InstallError]:       Setting PTATLAS=ATLAS
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries ptf77blas,ptcblas,atlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries ptf77blas,ptcblas,atlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       <class 'numpy.distutils.system_info.atlas_threads_info'>
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       atlas_info:
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries f77blas,cblas,atlas not found in /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries lapack_atlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       customize UnixCCompiler
[pipenv.exceptions.InstallError]:         libraries f77blas,cblas,atlas not found in /usr/lib
[pipenv.exceptions.InstallError]:       <class 'numpy.distutils.system_info.atlas_info'>
[pipenv.exceptions.InstallError]:         NOT AVAILABLE
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:         FOUND:
[pipenv.exceptions.InstallError]:           extra_compile_args = ['-faltivec', '-I/System/Library/Frameworks/vecLib.framework/Headers']
[pipenv.exceptions.InstallError]:           extra_link_args = ['-Wl,-framework', '-Wl,Accelerate']
[pipenv.exceptions.InstallError]:           define_macros = [('NO_ATLAS_INFO', 3), ('HAVE_CBLAS', None)]
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       non-existing path in 'numpy/random': 'src/splitmix64/splitmix.h'
[pipenv.exceptions.InstallError]:       /Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/dist.py:265: UserWarning: Unknown distribution option: 'define_macros'
[pipenv.exceptions.InstallError]:         warnings.warn(msg)
[pipenv.exceptions.InstallError]:       running bdist_wheel
[pipenv.exceptions.InstallError]:       running build
[pipenv.exceptions.InstallError]:       running config_cc
[pipenv.exceptions.InstallError]:       unifing config_cc, config, build_clib, build_ext, build commands --compiler options
[pipenv.exceptions.InstallError]:       running config_fc
[pipenv.exceptions.InstallError]:       unifing config_fc, config, build_clib, build_ext, build commands --fcompiler options
[pipenv.exceptions.InstallError]:       running build_src
[pipenv.exceptions.InstallError]:       build_src
[pipenv.exceptions.InstallError]:       building py_modules sources
[pipenv.exceptions.InstallError]:       creating build
[pipenv.exceptions.InstallError]:       creating build/src.macosx-14-arm64-3.1
[pipenv.exceptions.InstallError]:       creating build/src.macosx-14-arm64-3.1/numpy
[pipenv.exceptions.InstallError]:       creating build/src.macosx-14-arm64-3.1/numpy/distutils
[pipenv.exceptions.InstallError]:       building library "npymath" sources
[pipenv.exceptions.InstallError]:       get_default_fcompiler: matching types: '['gnu95', 'nag', 'absoft', 'ibm', 'intel', 'gnu', 'g95', 'pg']'
[pipenv.exceptions.InstallError]:       customize Gnu95FCompiler
[pipenv.exceptions.InstallError]:       Found executable /opt/homebrew/bin/gfortran
[pipenv.exceptions.InstallError]:       Traceback (most recent call last):
[pipenv.exceptions.InstallError]:         File "<string>", line 2, in <module>
[pipenv.exceptions.InstallError]:         File "<pip-setuptools-caller>", line 34, in <module>
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/setup.py", line 443, in <module>
[pipenv.exceptions.InstallError]:           setup_package()
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/setup.py", line 435, in setup_package
[pipenv.exceptions.InstallError]:           setup(**metadata)
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/core.py", line 171, in setup
[pipenv.exceptions.InstallError]:           return old_setup(**new_attr)
[pipenv.exceptions.InstallError]:                  ^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/__init__.py", line 103, in setup
[pipenv.exceptions.InstallError]:           return distutils.core.setup(**attrs)
[pipenv.exceptions.InstallError]:                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/core.py", line 185, in setup
[pipenv.exceptions.InstallError]:           return run_commands(dist)
[pipenv.exceptions.InstallError]:                  ^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/core.py", line 201, in run_commands
[pipenv.exceptions.InstallError]:           dist.run_commands()
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/dist.py", line 969, in run_commands
[pipenv.exceptions.InstallError]:           self.run_command(cmd)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/dist.py", line 963, in run_command
[pipenv.exceptions.InstallError]:           super().run_command(command)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/dist.py", line 988, in run_command
[pipenv.exceptions.InstallError]:           cmd_obj.run()
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/wheel/bdist_wheel.py", line 368, in run
[pipenv.exceptions.InstallError]:           self.run_command("build")
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/cmd.py", line 318, in run_command
[pipenv.exceptions.InstallError]:           self.distribution.run_command(command)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/dist.py", line 963, in run_command
[pipenv.exceptions.InstallError]:           super().run_command(command)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/dist.py", line 988, in run_command
[pipenv.exceptions.InstallError]:           cmd_obj.run()
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/command/build.py", line 47, in run
[pipenv.exceptions.InstallError]:           old_build.run(self)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/command/build.py", line 131, in run
[pipenv.exceptions.InstallError]:           self.run_command(cmd_name)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/cmd.py", line 318, in run_command
[pipenv.exceptions.InstallError]:           self.distribution.run_command(command)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/dist.py", line 963, in run_command
[pipenv.exceptions.InstallError]:           super().run_command(command)
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/dist.py", line 988, in run_command
[pipenv.exceptions.InstallError]:           cmd_obj.run()
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/command/build_src.py", line 142, in run
[pipenv.exceptions.InstallError]:           self.build_sources()
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/command/build_src.py", line 153, in build_sources
[pipenv.exceptions.InstallError]:           self.build_library_sources(*libname_info)
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/command/build_src.py", line 286, in build_library_sources
[pipenv.exceptions.InstallError]:           sources = self.generate_sources(sources, (lib_name, build_info))
[pipenv.exceptions.InstallError]:                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/command/build_src.py", line 369, in generate_sources
[pipenv.exceptions.InstallError]:           source = func(extension, build_dir)
[pipenv.exceptions.InstallError]:                    ^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "numpy/core/setup.py", line 667, in get_mathlib_info
[pipenv.exceptions.InstallError]:           st = config_cmd.try_link('int main(void) { return 0;}')
[pipenv.exceptions.InstallError]:                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/Users/stepan/.local/share/virtualenvs/rigol-grab-_-o4_bjo/lib/python3.11/site-packages/setuptools/_distutils/command/config.py", line 247, in try_link
[pipenv.exceptions.InstallError]:           self._check_compiler()
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/command/config.py", line 82, in _check_compiler
[pipenv.exceptions.InstallError]:           self.fcompiler = new_fcompiler(compiler=self.fcompiler,
[pipenv.exceptions.InstallError]:                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/__init__.py", line 884, in new_fcompiler
[pipenv.exceptions.InstallError]:           compiler = get_default_fcompiler(plat, requiref90=requiref90,
[pipenv.exceptions.InstallError]:                      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/__init__.py", line 855, in get_default_fcompiler
[pipenv.exceptions.InstallError]:           compiler_type =  _find_existing_fcompiler(matching_compiler_types,
[pipenv.exceptions.InstallError]:                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/__init__.py", line 806, in _find_existing_fcompiler
[pipenv.exceptions.InstallError]:           c.customize(dist)
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/__init__.py", line 530, in customize
[pipenv.exceptions.InstallError]:           linker_so_flags = self.flag_vars.linker_so
[pipenv.exceptions.InstallError]:                             ^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/environment.py", line 40, in __getattr__
[pipenv.exceptions.InstallError]:           return self._get_var(name, conf_desc)
[pipenv.exceptions.InstallError]:                  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/environment.py", line 56, in _get_var
[pipenv.exceptions.InstallError]:           var = self._hook_handler(name, hook)
[pipenv.exceptions.InstallError]:                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/__init__.py", line 709, in _environment_hook
[pipenv.exceptions.InstallError]:           return hook()
[pipenv.exceptions.InstallError]:                  ^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/gnu.py", line 353, in get_flags_linker_so
[pipenv.exceptions.InstallError]:           flags = GnuFCompiler.get_flags_linker_so(self)
[pipenv.exceptions.InstallError]:                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "/private/var/folders/ng/kbbx860d3m792v60ptd52r2h0000gn/T/pip-install-kcd2prg3/numpy_18682d28925e48ed8e005e4a1f8bbdc7/numpy/distutils/fcompiler/gnu.py", line 144, in get_flags_linker_so
[pipenv.exceptions.InstallError]:           os.environ['MACOSX_DEPLOYMENT_TARGET'] = target
[pipenv.exceptions.InstallError]:           ~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[pipenv.exceptions.InstallError]:         File "<frozen os>", line 684, in __setitem__
[pipenv.exceptions.InstallError]:         File "<frozen os>", line 758, in encode
[pipenv.exceptions.InstallError]:       TypeError: str expected, not int
[pipenv.exceptions.InstallError]:       [end of output]
[pipenv.exceptions.InstallError]:   
[pipenv.exceptions.InstallError]:   note: This error originates from a subprocess, and is likely not a problem with pip.
[pipenv.exceptions.InstallError]:   ERROR: Failed building wheel for numpy
[pipenv.exceptions.InstallError]:   error: subprocess-exited-with-error
[pipenv.exceptions.InstallError]:   
[pipenv.exceptions.InstallError]:   × python setup.py clean did not run successfully.
[pipenv.exceptions.InstallError]:   │ exit code: 1
[pipenv.exceptions.InstallError]:   ╰─> [10 lines of output]
[pipenv.exceptions.InstallError]:       Running from numpy source directory.
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       `setup.py clean` is not supported, use one of the following instead:
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:         - `git clean -xdf` (cleans all files)
[pipenv.exceptions.InstallError]:         - `git clean -Xdf` (cleans all versioned files, doesn't touch
[pipenv.exceptions.InstallError]:                             files that aren't checked into the git repo)
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       Add `--force` to your command to use it anyway if you must (unsupported).
[pipenv.exceptions.InstallError]:       
[pipenv.exceptions.InstallError]:       [end of output]
[pipenv.exceptions.InstallError]:   
[pipenv.exceptions.InstallError]:   note: This error originates from a subprocess, and is likely not a problem with pip.
[pipenv.exceptions.InstallError]:   ERROR: Failed cleaning build dir for numpy
[pipenv.exceptions.InstallError]: ERROR: Could not build wheels for numpy, which is required to install pyproject.toml-based projects
ERROR: Couldn't install package: {}
 Package installation failed...
/Applications/Xcode.app/Contents/Developer/Library/Frameworks/Python3.framework/Versions/3.9/lib/python3.9/subprocess.py:1052: ResourceWarning: subprocess 85469 is still running
  _warn("subprocess %s is still running" % self.pid,
ResourceWarning: Enable tracemalloc to get the object allocation traceback
sys:1: ResourceWarning: unclosed file <_io.TextIOWrapper name=5 encoding='utf-8'>
ResourceWarning: Enable tracemalloc to get the object allocation traceback
sys:1: ResourceWarning: unclosed file <_io.TextIOWrapper name=8 encoding='utf-8'>
ResourceWarning: Enable tracemalloc to get the object allocation traceback

usbtmc AssertionError

I'm getting the following issue running on macOS 10.14.4 with Python 3.7 on a Rigol DS1054Z

  File "rigol_grab.py", line 69, in <module>
    grabber.grab(filename=opts.filename, auto_open=opts.auto_open)
  File "rigol_grab.py", line 24, in grab
    buf = self.rigol().query_binary_values(':DISP:DATA? ON,0,PNG', datatype='B')
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa/resources/messagebased.py", line 663, in query_binary_values
    header_fmt, expect_termination)
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa/resources/messagebased.py", line 472, in read_binary_values
    block = self._read_raw()
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa/resources/messagebased.py", line 386, in _read_raw
    chunk, status = self.visalib.read(self.session, size)
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa-py/highlevel.py", line 345, in read
    ret = self.sessions[session].read(count)
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa-py/usb.py", line 111, in read
    usb.USBError)
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa-py/sessions.py", line 477, in _read
    current = reader()
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa-py/usb.py", line 105, in <lambda>
    return self._read(lambda: self.interface.read(count),
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa-py/protocols/usbtmc.py", line 338, in read
    response = BulkInMessage.from_bytes(resp)
  File "/Users/work/.virtualenv/rigol-grab/lib/python3.7/site-packages/pyvisa-py/protocols/usbtmc.py", line 108, in from_bytes
    assert msgid == MsgID.dev_dep_msg_in
AssertionError

When I inspect this msgid is 65 and the data is:

b'Author\x00RIGOL\xe7\x88\x8c\xc9\x00\x00\x00\x11tEXtSource\x00DSZ series?Z\x1d\x97\x00\x00\x00)tEXtDescription'

Mangled PNG on MacOS

On my Windows 10 system, screen images are captured reliably. But on my Mac PowerBook, most of the time the PNG data is mangled. I'm not sure if this is timing issue or a driver issue. What's very odd is that it used to work better -- I'm not sure what's changed.

pyvisa-info tells me this:

(rigol_grab) [~/Projects/Rigol/rigol_grab]$ pyvisa-info
Machine Details:
   Platform ID:    Darwin-18.7.0-x86_64-i386-64bit
   Processor:      i386

Python:
   Implementation: CPython
   Executable:     /Users/r/.local/share/virtualenvs/rigol_grab-3CvMwpSs/bin/python3.7
   Version:        3.7.1
   Compiler:       Clang 6.0 (clang-600.0.57)
   Bits:           64bit
   Build:          Oct 20 2018 03:13:28 (#v3.7.1:260ec2c36a)
   Unicode:        UCS4

PyVISA Version: 1.9.1

Backends:
   ni:
      Version: 1.9.1 (bundled with PyVISA)
      #1: /Library/Frameworks/visa.framework/visa:
         found by: auto
         bitness: 32, 64
         Vendor: National Instruments
         Impl. Version: 18874368
         Spec. Version: 5244928
   py:
      Version: 0.3.1
      ASRL INSTR:
         Please install PySerial (>=3.0) to use this resource type.
         No module named 'serial'
      USB INSTR: Available via PyUSB (1.0.2). Backend: libusb1
      USB RAW: Available via PyUSB (1.0.2). Backend: libusb1
      TCPIP INSTR: Available 
      TCPIP SOCKET: Available 
      GPIB INSTR:
         Please install linux-gpib to use this resource type.
         No module named 'gpib'

Could not find Rigol. Check USB?...quitting

Hi. I'm new to RIGOL and have a new DS1054Z, full options. I have a Mac running the latest version of Catalina connect via USB, have installed rigol-grab (all seems OK) but when I run it, I get:

Could not find Rigol. Check USB?...quitting

Do I need some drivers or other package?

Script does not seem to work under windows 10

I am using Windows10 and Rigol DS1054Z connected using USB. The scope appeared in device manager with "no driver installed" message.
I installed script by following the setup step by step, then I tried to run the script:

\rigol-grab>python rigol_grab.py --auto_open -v
Traceback (most recent call last):
  File "rigol_grab.py", line 66, in <module>
    grabber.grab(filename=opts.filename, auto_open=opts.auto_open)
  File "rigol_grab.py", line 23, in grab
    buf = self.rigol().query_binary_values(':DISP:DATA? ON,0,PNG', datatype='B')
  File "rigol_grab.py", line 32, in rigol
    self._rigol = self._resource_manager.open_resource(name)
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa\highlevel.py", line 1724, in open_resource
    res.open(access_mode, open_timeout)
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa\resources\resource.py", line 209, in open
    self.session, status = self._resource_manager.open_bare_resource(self._resource_name, access_mode, open_timeout)
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa\highlevel.py", line 1681, in open_bare_resource
    return self.visalib.open(self.session, resource_name, access_mode, open_timeout)
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa-py\highlevel.py", line 194, in open
    sess = cls(session, resource_name, parsed, open_timeout)
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa-py\sessions.py", line 213, in __init__
    self.after_parsing()
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa-py\usb.py", line 201, in after_parsing
    self.parsed.serial_number)
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa-py\protocols\usbtmc.py", line 256, in __init__
    super(USBTMC, self).__init__(vendor, product, serial_number, **kwargs)
  File "C:\SPB_Data\.virtualenvs\rigol-grab-Tom2Ahzx\lib\site-packages\pyvisa-py\protocols\usbtmc.py", line 169, in __init__
    raise ValueError('No device found.')
ValueError: No device found.

Any ideas? I am willing to test under windows further.

Rigol DHO800 and DHO900 series

The command on this scope is :DISP:DATA? PNG. The USB product ID on my DHO924S is 0x044C.

I also used #10 since it seemed reasonable, but I don't know if it is necessary.

Reference: Programming Guide for the DHO800/DHO900 Series (PDF)