2019-10-14 09:14:04 +00:00
[](https://github.com/mihtjel/nanovna-saver/releases/latest)
[](https://github.com/mihtjel/nanovna-saver/blob/master/LICENSE)
[](https://github.com/mihtjel/nanovna-saver/releases/)
2019-10-24 10:17:36 +00:00
[](https://github.com/mihtjel/nanovna-saver/releases/latest)
2019-11-03 17:38:36 +00:00
[](https://www.paypal.com/cgi-bin/webscr?cmd=_donations& business=T8KTGVDQF5K6E& item_name=NanoVNASaver+Development& currency_code=EUR& source=url)
2019-10-14 09:14:04 +00:00
2019-08-30 07:55:32 +00:00
NanoVNASaver
============
2019-09-18 11:45:53 +00:00
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.
2019-08-30 07:55:32 +00:00
2020-02-29 08:13:09 +00:00
Copyright 2019, 2020 Rune B. Broberg
2019-08-29 11:42:02 +00:00
2020-06-09 00:01:58 +00:00
## Changes in this fork
This fork adds support for the saa2, a vna loosely based on the original nanovna with frequency range up to 3Ghz.
2019-09-18 11:45:53 +00:00
## Introduction
2019-08-30 07:55:32 +00:00
This software connects to a NanoVNA and extracts the data for display on a computer, and for saving to Touchstone files.
Current features:
- Reading data from a NanoVNA
2020-02-29 08:13:09 +00:00
-- Compatible devices: NanoVNA, NanoVNA-H, NanoVNA-H4, NanoVNA-F, AVNA via Teensy
2019-08-30 07:55:32 +00:00
- Splitting a frequency range into multiple segments to increase resolution (tried up to >10k points)
2019-10-02 07:54:24 +00:00
- Averaging data for better results particularly at higher frequencies
2019-09-18 11:45:53 +00:00
- Displaying data on multiple chart types, such as Smith, LogMag, Phase and VSWR-charts, for both S11 and S21
2019-10-02 07:54:24 +00:00
- 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
2019-09-18 11:45:53 +00:00
- Exporting and importing 1-port and 2-port Touchstone files
2019-11-03 17:38:36 +00:00
- TDR function (measurement of cable length) - including impedance display
2019-10-23 07:49:59 +00:00
- Filter analysis functions for low-pass, high-pass, band-pass and band-stop filters
2019-09-18 11:45:53 +00:00
- 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
2019-10-02 07:54:24 +00:00
- Customizable display options, including "dark mode"
- Exporting images of plotted values
2019-08-30 07:55:32 +00:00
2019-10-23 07:49:59 +00:00
0.1.4:
2019-08-30 07:55:32 +00:00
2019-09-18 11:45:53 +00:00
## Running the application
2019-08-30 07:55:32 +00:00
### Windows
2019-11-03 17:38:36 +00:00
The software was written in Python on Windows, using Pycharm, and the modules PyQT5, numpy, scipy and pyserial.
2019-08-30 07:55:32 +00:00
2019-09-18 19:45:27 +00:00
#### Binary releases
2019-10-02 07:54:24 +00:00
You can find the latest binary (.exe) release for Windows at https://github.com/mihtjel/nanovna-saver/releases/latest
The downloadable executable runs directly, and requires no installation. For Windows 7, it does require 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 is already installed.
2019-09-18 19:45:27 +00:00
2020-02-29 08:13:09 +00:00
Windows versions older than Windows 7 are not known to work.
It may be possible to run on those directly from the python code:
2019-09-18 11:45:53 +00:00
#### Installation and Use with pip
1. Clone repo and cd into the directory
2019-09-27 13:29:57 +00:00
git clone https://github.com/mihtjel/nanovna-saver
cd nanovna-saver
2019-09-18 12:43:21 +00:00
3. Run the pip installation
2019-09-18 11:45:53 +00:00
2019-09-27 13:29:57 +00:00
pip3 install .
2019-09-18 11:45:53 +00:00
2019-09-18 12:43:21 +00:00
4. Once completed run with the following command
2019-09-18 11:45:53 +00:00
2019-09-27 13:29:57 +00:00
NanoVNASaver
2019-09-18 11:45:53 +00:00
2019-08-29 11:42:02 +00:00
### Linux
2019-09-18 11:45:53 +00:00
#### Ubuntu 18.04 & 19.04
2019-10-02 07:54:24 +00:00
##### Installation and Use with pip
2019-09-06 16:23:44 +00:00
1. Install python3.7 and pip
2019-08-30 07:55:32 +00:00
2019-09-27 13:29:57 +00:00
sudo apt install python3.7 python3-pip
2019-09-06 16:23:44 +00:00
2019-09-18 12:43:21 +00:00
3. Clone repo and cd into the directory
2019-09-27 13:29:57 +00:00
git clone https://github.com/mihtjel/nanovna-saver
cd nanovna-saver
2019-09-18 12:43:21 +00:00
4. Run the pip installation
2019-09-06 16:23:44 +00:00
2019-09-27 13:29:57 +00:00
python3.7 -m pip install .
2019-09-06 16:23:44 +00:00
2019-10-26 20:26:31 +00:00
(You may need to install the additional packages python3-distutils, python3-setuptools and python3-wheel for this command to work on some distributions.)
2019-10-26 20:16:50 +00:00
2019-09-18 12:43:21 +00:00
5. Once completed run with the following command
2019-09-27 13:29:57 +00:00
python3.7 nanovna-saver.py
2019-09-18 12:43:21 +00:00
### Mac OS:
#### Homebrew
1. Install Homebrew
From : https://brew.sh/
2019-09-27 13:29:57 +00:00
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
2019-09-18 12:43:21 +00:00
2. Python :
2019-09-27 13:29:57 +00:00
brew install python
2019-09-18 12:43:21 +00:00
3. NanoVNASaver Installation
2019-09-06 16:23:44 +00:00
2019-10-02 07:54:24 +00:00
git clone https://github.com/mihtjel/nanovna-saver
cd nanovna-saver
2019-09-27 13:29:57 +00:00
2019-11-24 13:35:04 +00:00
4. Install local pip packages
2019-09-27 13:29:57 +00:00
python3 -m pip install .
NanoVNASaver
2019-09-04 16:12:38 +00:00
2019-09-18 11:45:53 +00:00
## Using the software
2019-09-04 16:12:38 +00:00
2019-09-18 11:45:53 +00:00
Connect your NanoVNA to a serial port, and enter this serial port in the serial port box. If the NanoVNA is
2019-10-02 07:54:24 +00:00
connected before the application starts, it should be automatically detected. Otherwise, click "Rescan". Click
2020-02-29 08:32:13 +00:00
"Connect to device" to connect.
2019-09-04 16:12:38 +00:00
2019-09-18 11:45:53 +00:00
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.
2019-09-04 16:12:38 +00:00
2019-10-02 07:54:24 +00:00
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.
2019-09-01 15:32:45 +00:00
2019-09-18 11:45:53 +00:00
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.
2019-09-01 15:32:45 +00:00
2019-10-02 07:54:24 +00:00
### 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.
2019-09-18 11:45:53 +00:00
In-application calibration is available, either assuming ideal standards, or with relevant standard correction. To
2019-10-02 07:54:24 +00:00
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.
2019-10-02 07:57:25 +00:00
2019-10-23 07:49:59 +00:00
2019-09-01 15:32:45 +00:00
2019-10-23 07:49:59 +00:00
Users of known characterized calibration standard sets can enter the data for these, and save the sets.
2019-10-02 07:54:24 +00:00
2019-10-23 07:49:59 +00:00
After pressing _Apply_ , the calibration is immediately applied to the latest sweep data.
_Currently, load capacitance is unsupported_
2019-10-02 07:54:24 +00:00
### TDR
2019-09-01 15:32:45 +00:00
To get accurate TDR measurements, calibrate the device, and attach the cable to be measured at the calibration plane -
2019-10-02 07:54:24 +00:00
ie. 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.
2019-09-01 15:32:45 +00:00
2019-09-18 11:45:53 +00:00
## License
2019-08-30 07:55:32 +00:00
This software is licensed under version 3 of the GNU General Public License. It comes with NO WARRANTY.
2019-09-18 11:45:53 +00:00
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/]
2019-09-01 15:13:09 +00:00
2019-09-18 11:45:53 +00:00
## Credits
2019-09-01 15:13:09 +00:00
Original application by Rune B. Broberg (5Q5R)
2019-11-24 13:35:04 +00:00
Contributions and changes by Holger Müller, David Hunt and others.
2019-09-01 15:13:09 +00:00
TDR inspiration shamelessly stolen from the work of Salil (VU2CWA) at https://nuclearrambo.com/wordpress/accurately-measuring-cable-length-with-nanovna/
2019-10-02 07:57:25 +00:00
2019-09-18 11:45:53 +00:00
TDR cable types by Larry Goga.
2019-10-02 07:57:25 +00:00
Bugfixes and Python installation work by Ohan Smit.
2019-09-01 15:13:09 +00:00
2019-10-02 07:54:24 +00:00
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.
2019-09-27 12:15:21 +00:00
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:
[](https://www.paypal.com/cgi-bin/webscr?cmd=_donations& business=T8KTGVDQF5K6E& item_name=NanoVNASaver+Development& currency_code=EUR& source=url)
