kopia lustrzana https://github.com/NanoVNA-Saver/nanovna-saver
304 wiersze
10 KiB
Markdown
304 wiersze
10 KiB
Markdown
[![Latest Release](https://img.shields.io/github/v/release/NanoVNA-Saver/nanovna-saver.svg)](https://github.com/NanoVNA-Saver/nanovna-saver/releases/latest)
|
|
[![License](https://img.shields.io/github/license/NanoVNA-Saver/nanovna-saver.svg)](https://github.com/NanoVNA-Saver/nanovna-saver/blob/master/LICENSE)
|
|
[![Downloads](https://img.shields.io/github/downloads/NanoVNA-Saver/nanovna-saver/total.svg)](https://github.com/NanoVNA-Saver/nanovna-saver/releases/)
|
|
[![GitHub Releases](https://img.shields.io/github/downloads/NanoVNA-Saver/nanovna-saver/latest/total)](https://github.com/NanoVNA-Saver/nanovna-saver/releases/latest)
|
|
[![Donate](https://img.shields.io/badge/paypal-donate-yellow.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=T8KTGVDQF5K6E&item_name=NanoVNASaver+Development¤cy_code=EUR&source=url)
|
|
|
|
NanoVNASaver
|
|
============
|
|
|
|
A multiplatform tool to save Touchstone files from the NanoVNA,
|
|
sweep frequency spans in segments to gain more than 101 data
|
|
points, and generally display and analyze the resulting data.
|
|
|
|
- Copyright 2019, 2020 Rune B. Broberg
|
|
- Copyright 2020ff NanoVNA-Saver Authors
|
|
|
|
Latest Changes
|
|
--------------
|
|
|
|
### Changes in 0.4.0
|
|
|
|
- PA0JOZ Enhanced Response Correction
|
|
This is the reason vor minor version increase as older callibration data shouldn't
|
|
be use.
|
|
- Fix linux binary build
|
|
- Many bugfixes
|
|
|
|
### Changes in v0.3.10
|
|
|
|
- Default Band ranges for 5 and 9cm
|
|
- Layout should fit on smaller screens
|
|
- Fixed fixed axis settings
|
|
- Show VNA type in port selector
|
|
- Recognise tinySA (screenshot only)
|
|
- Some more cables in TDR
|
|
- Reference plane applied after calibration
|
|
- Calibration fixes by DiSlord
|
|
|
|
### Changes in v0.3.9
|
|
|
|
- TX Power on V2
|
|
- New analysis
|
|
- Magnitude Z Chart
|
|
- VSWR Chart improvements
|
|
|
|
Introduction
|
|
------------
|
|
|
|
This software connects to a NanoVNA and extracts the data for
|
|
display on a computer and allows saving the sweep data to Touchstone files.
|
|
|
|
Current features:
|
|
|
|
- Reading data from a NanoVNA -- Compatible devices: NanoVNA, NanoVNA-H,
|
|
NanoVNA-H4, NanoVNA-F, AVNA via Teensy
|
|
- Splitting a frequency range into multiple segments to increase resolution
|
|
(tried up to >10k points)
|
|
- Averaging data for better results particularly at higher frequencies
|
|
- Displaying data on multiple chart types, such as Smith, LogMag, Phase and
|
|
VSWR-charts, for both S11 and S21
|
|
- Displaying markers, and the impedance, VSWR, Q, equivalent
|
|
capacitance/inductance etc. at these locations
|
|
- Displaying customizable frequency bands as reference, for example amateur
|
|
radio bands
|
|
- Exporting and importing 1-port and 2-port Touchstone files
|
|
- TDR function (measurement of cable length) - including impedance display
|
|
- Filter analysis functions for low-pass, high-pass, band-pass and band-stop
|
|
filters
|
|
- Display of both an active and a reference trace
|
|
- Live updates of data from the NanoVNA, including for multi-segment sweeps
|
|
- In-application calibration, including compensation for non-ideal calibration
|
|
standards
|
|
- Customizable display options, including "dark mode"
|
|
- Exporting images of plotted values
|
|
|
|
0.1.4:
|
|
![Screenshot of version 0.1.4](https://i.imgur.com/ZoFsV2V.png)
|
|
|
|
Running the application
|
|
-----------------------
|
|
|
|
The software was written in Python on Windows, using Pycharm, and the modules
|
|
PyQT5, numpy, scipy and pyserial.
|
|
Main development is currently done on Linux (Mint 20.3 Cinnamon)
|
|
|
|
### Binary releases
|
|
|
|
You can find 64bit binary releases for Windows, Linux and MacOS under
|
|
<https://github.com/NanoVNA-Saver/nanovna-saver/releases/>
|
|
|
|
Versions older than Windows 7 are not known to work.
|
|
|
|
#### Windows 7
|
|
|
|
It requires Service Pack 1 and [Microsoft VC++ Redistributable](
|
|
https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads).
|
|
For most users, this would already be installed.
|
|
|
|
#### Windows 10
|
|
|
|
The downloadable executable runs directly, and requires no installation.
|
|
|
|
### Installation and Use with pip
|
|
|
|
1. Clone repo and cd into the directory
|
|
|
|
git clone https://github.com/NanoVNA-Saver/nanovna-saver
|
|
cd nanovna-saver
|
|
|
|
2. Run the pip installation
|
|
|
|
pip3 install .
|
|
|
|
3. Once completed run with the following command
|
|
|
|
NanoVNASaver
|
|
|
|
#### Ubuntu 20.04
|
|
|
|
1. Install python3.8 and pip
|
|
|
|
sudo apt install python3.8 python3-pip
|
|
python3 -m venv ~/.venv_nano
|
|
. ~/.venv_nano/bin/activate
|
|
pip install -U pip
|
|
|
|
2. Clone repo and cd into the directory
|
|
|
|
git clone https://github.com/NanoVNA-Saver/nanovna-saver
|
|
cd nanovna-saver
|
|
|
|
3. Update pip and run the pip installation
|
|
|
|
python3 -m pip install .
|
|
|
|
(You may need to install the additional packages python3-distutils,
|
|
python3-setuptools and python3-wheel for this command to work on some
|
|
distributions.)
|
|
|
|
4. Once completed run with the following command
|
|
|
|
. ~/.venv_nano/bin/activate
|
|
python3 nanovna-saver.py
|
|
|
|
|
|
#### MacPorts
|
|
|
|
Via a MacPorts distribution maintained by @ra1nb0w.
|
|
|
|
1. Install MacPorts following the [install guide](https://www.macports.org/install.php)
|
|
|
|
2. Install NanoVNASaver :
|
|
|
|
sudo port install NanoVNASaver
|
|
|
|
3. Now you can run the software from shell `NanoVNASaver` or run as app
|
|
`/Applications/MacPorts/NanoVNASaver.app`
|
|
|
|
#### Homebrew
|
|
|
|
1. Install Homebrew from <https://brew.sh/> (This will ask for your password)
|
|
|
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
|
|
|
|
|
|
2. Python :
|
|
|
|
brew install python
|
|
|
|
3. Pip :<br/>
|
|
Download the get-pip.py file and run it to install pip
|
|
|
|
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
|
|
python3 get-pip.py
|
|
|
|
4. NanoVNASaver Installation : <br/>
|
|
clone the source code to the nanovna-saver folder
|
|
|
|
git clone https://github.com/NanoVNA-Saver/nanovna-saver
|
|
cd nanovna-saver
|
|
|
|
5. Install local pip packages
|
|
|
|
python3 -m pip install .
|
|
|
|
6. Run nanovna-saver in the nanovna-saver folder by:
|
|
|
|
python3 nanovna-saver.py
|
|
|
|
Using the software
|
|
------------------
|
|
|
|
Connect your NanoVNA to a serial port, and enter this serial port in the serial
|
|
port box. If the NanoVNA is connected before the application starts, it should
|
|
be automatically detected. Otherwise, click "Rescan". Click "Connect to device"
|
|
to connect.
|
|
|
|
The app can collect multiple segments to get more accurate measurements. Enter
|
|
the number of segments to be done in the "Segments" box. Each segment is 101
|
|
data points, and takes about 1.5 seconds to complete.
|
|
|
|
Frequencies are entered in Hz, or suffixed with k or M. Scientific notation
|
|
(6.5e6 for 6.5MHz) also works.
|
|
|
|
Markers can be manually entered, or controlled using the mouse. For mouse
|
|
control, select the active marker using the radio buttons, or hold "shift"
|
|
while clicking to drag the nearest marker. The marker readout boxes show the
|
|
actual frequency where values are measured. Marker readouts can be hidden
|
|
using the "hide data" button when not needed.
|
|
|
|
Display settings are available under "Display setup". These allow changing the
|
|
chart colours, the application font size and which graphs are displayed. The
|
|
settings are saved between program starts.
|
|
|
|
### Calibration
|
|
|
|
_Before using NanoVNA-Saver, please ensure that the device itself is in a
|
|
reasonable calibration state._
|
|
|
|
A calibration of both ports across the entire frequency span, saved to save
|
|
slot 0, is sufficient. If the NanoVNA is completely uncalibrated, its readings
|
|
may be outside the range accepted by the application.
|
|
|
|
In-application calibration is available, either assuming ideal standards or
|
|
with relevant standard correction. To manually calibrate, sweep each standard
|
|
in turn and press the relevant button in the calibration window.
|
|
For assisted calibration, press the "Calibration Assistant" button. If desired,
|
|
enter a note in the provided field describing the conditions under which the
|
|
calibration was performed.
|
|
|
|
Calibration results may be saved and loaded using the provided buttons at the
|
|
bottom of the window. Notes are saved and loaded along with the calibration
|
|
data.
|
|
|
|
![Screenshot of Calibration Window](https://i.imgur.com/p94cxOX.png)
|
|
|
|
Users of known characterized calibration standard sets can enter the data for
|
|
these, and save the sets.
|
|
|
|
After pressing _Apply_, the calibration is immediately applied to the latest
|
|
sweep data.
|
|
|
|
\! _Currently, load capacitance is unsupported_ \!
|
|
|
|
### TDR
|
|
|
|
To get accurate TDR measurements, calibrate the device, and attach the cable to
|
|
be measured at the calibration plane - i.e. at the same position where the
|
|
calibration load would be attached. Open the "Time Domain Reflectometry"
|
|
window, and select the correct cable type, or manually enter a propagation
|
|
factor.
|
|
|
|
### Frequency bands
|
|
|
|
Open the "Display setup" window to configure the display of frequency bands. By
|
|
clicking "show bands", predefined frequency bands will be shown on the
|
|
frequency-based charts. Click manage bands to change which bands are shown,
|
|
and the frequency limits of each. Bands default and reset to European amateur
|
|
radio band frequencies.
|
|
|
|
License
|
|
-------
|
|
|
|
This software is licensed under version 3 of the GNU General Public License. It
|
|
comes with NO WARRANTY.
|
|
|
|
You can use it, commercially as well. You may make changes to the code, but I
|
|
(and the license) ask that you give these changes back to the community.
|
|
|
|
Links
|
|
-----
|
|
|
|
- Ohan Smit wrote an introduction to using the application:
|
|
[https://zs1sci.com/blog/nanovnasaver/]
|
|
- HexAndFlex wrote a 3-part (thus far) series on Getting Started with the NanoVNA:
|
|
[https://hexandflex.com/2019/08/31/getting-started-with-the-nanovna-part-1/] - Part 3 is dedicated to NanoVNASaver:
|
|
[https://hexandflex.com/2019/09/15/getting-started-with-the-nanovna-part-3-pc-software/]
|
|
- Gunthard Kraus did documentation in English and German:
|
|
[http://www.gunthard-kraus.de/fertig_NanoVNA/English/]
|
|
[http://www.gunthard-kraus.de/fertig_NanoVNA/Deutsch/]
|
|
|
|
Credits
|
|
-------
|
|
|
|
Original application by Rune B. Broberg (5Q5R)
|
|
|
|
Contributions and changes by Holger Müller, David Hunt and others.
|
|
|
|
TDR inspiration shamelessly stolen from the work of Salil (VU2CWA) at
|
|
<https://nuclearrambo.com/wordpress/accurately-measuring-cable-length-with-nanovna/>
|
|
|
|
TDR cable types by Larry Goga.
|
|
|
|
Bugfixes and Python installation work by Ohan Smit.
|
|
|
|
Thanks to everyone who have tested, commented and inspired. Particular thanks
|
|
go to the alpha testing crew who suffer the early instability of new versions.
|
|
|
|
This software is available free of charge. If you read all this way, and you
|
|
*still* want to support it, you may donate to the developer using the button
|
|
below:
|
|
|
|
[![Paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=T8KTGVDQF5K6E&item_name=NanoVNASaver+Development¤cy_code=EUR&source=url)
|