kopia lustrzana https://github.com/NanoVNA-Saver/nanovna-saver
152 wiersze
5.7 KiB
Markdown
152 wiersze
5.7 KiB
Markdown
|
|
|
|
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 Rune B. Broberg
|
|
|
|
## Introduction
|
|
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
|
|
- Splitting a frequency range into multiple segments to increase resolution (tried up to >10k points)
|
|
- 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 etc. at these locations
|
|
- Exporting and importing 1-port and 2-port Touchstone files
|
|
- TDR function (measurement of cable length)
|
|
- 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
|
|
|
|
0.0.10:
|
|
|
|
|
|
## Running the application
|
|
|
|
### Windows
|
|
|
|
The software was written in Python on Windows, using Pycharm, and the modules PyQT5, numpy and pyserial.
|
|
|
|
#### Binary releases
|
|
You can find binary (.exe) releases for Windows at https://github.com/mihtjel/nanovna-saver/releases
|
|
|
|
#### Installation and Use with pip
|
|
|
|
1. Clone repo and cd into the directory
|
|
|
|
git clone https://github.com/mihtjel/nanovna-saver
|
|
cd nanovna-saver
|
|
|
|
3. Run the pip installation
|
|
|
|
pip3 install .
|
|
|
|
4. Once completed run with the following command
|
|
|
|
NanoVNASaver
|
|
|
|
### Linux
|
|
|
|
In order to run this app in Linux environment, you'll need the following packages:
|
|
|
|
* `python3-serial`
|
|
* `python3-pyqt5`
|
|
* `numpy`
|
|
#### Ubuntu 18.04 & 19.04
|
|
#### Installation and Use with pip
|
|
1. Install python3.7 and pip
|
|
|
|
sudo apt install python3.7 python3-pip
|
|
|
|
3. Clone repo and cd into the directory
|
|
|
|
git clone https://github.com/mihtjel/nanovna-saver
|
|
cd nanovna-saver
|
|
|
|
4. Run the pip installation
|
|
|
|
python3.7 -m pip install .
|
|
|
|
5. Once completed run with the following command
|
|
|
|
python3.7 nanovna-saver.py
|
|
|
|
|
|
### Mac OS:
|
|
#### Homebrew
|
|
1. Install Homebrew
|
|
From : https://brew.sh/
|
|
|
|
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
|
|
|
|
2. Python :
|
|
|
|
brew install python
|
|
|
|
3. NanoVNASaver Installation
|
|
|
|
git clone https://github.com/mihtjel/nanovna-saver && cd nanovna-saver
|
|
|
|
4. Change PyQt restriction in setup.py
|
|
`PyQt5==5.11.2` to `PyQt5`
|
|
|
|
5. Install local pip packages
|
|
|
|
python3 -m pip install .
|
|
NanoVNASaver
|
|
|
|
## 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. Click "Connect to NanoVNA" 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.
|
|
|
|
Marker frequencies are entered in Hz, or suffixed with k or M. Scientific notation (6.5e6 for 6.5MHz) also works.
|
|
The marker readout boxes show the actual frequency where the values are taken. 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
|
|
In-application calibration is available, either assuming ideal standards, or with relevant standard correction. To
|
|
calibrate, sweep each standard in turn, and press the relevant button in the calibration window. After applying the
|
|
calibration, you may save it by entering a file location and name, and pressing "Save calibration". Conversely, a
|
|
saved calibration can be loaded. The file location and name is saved between program starts.
|
|
|
|
|
|
#### TDR
|
|
To get accurate TDR measurements, calibrate the device, and attach the cable to be measured at the calibration plane -
|
|
ie. at the same position where the calibration load would be attached.
|
|
|
|
## 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/]
|
|
|
|
## Credits
|
|
Original application by Rune B. Broberg (5Q5R)
|
|
|
|
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.
|
|
|
|
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¤cy_code=EUR&source=url)
|