wfview/README.md

61 wiersze
3.5 KiB
Markdown
Czysty Zwykły widok Historia

2018-06-21 02:06:15 +00:00
# wfview
2020-03-13 00:49:24 +00:00
[wfview](https://gitlab.com/eliggett/wfview) is an open-source front-end application for the [Icom IC-7300](https://www.icomamerica.com/en/products/amateur/hf/7300/default.aspx) HF SDR Amateur Radio. wfview supports viewing the spectrum display waterfall and most normal radio controls. Using wfview, the radio can be operated using the mouse, or just the keyboard (great for those with visual impairments), or even a touch screen display. The gorgous waterfall spectrum can be displayed on a monitor of any size, and can even projected onto a wall for a presentation. Even a VNC session can make use of wfview for interesting remote rig posibilities. wfview runs on humble hardware, ranging from the $35 Raspberry Pi, to laptops, to desktops. wfview is designed to run on GNU Linux, but can probably be adapted to run on other operating systems.
2018-06-21 02:06:15 +00:00
2020-03-11 23:40:39 +00:00
wfview is unique in the radio control ecosystem in that it is free and open-source software and can take advantage of modern radio features (such as the waterfall). wfview also does not "eat the serial port", and can allow a second program, such as fldigi, access to the radio via a pseudo-terminal device.
2020-03-11 23:42:54 +00:00
**For screenshots, documentation, User FAQ, Programmer FAQ, and more, please [see the project's wiki](https://gitlab.com/eliggett/wfview/-/wikis/home).**
2020-01-03 03:13:13 +00:00
2020-03-13 00:51:38 +00:00
wfview is copyright 2017-2020 Elliott H. Liggett. All rights reserved. wfview source code is licensed via the GNU GPLv3.
2020-01-03 23:08:06 +00:00
2018-06-21 07:12:53 +00:00
### Features:
1. Plot bandscope and bandscope waterfall. Optionally, also plot a "peak hold". A splitter lets the user adjust the space used for the waterfall and bandscope plots.
2020-02-29 02:33:15 +00:00
2. Double-click anywhere on the bandscope or waterfall to tune the radio.
2018-06-21 07:12:53 +00:00
3. Entry of frequency is permitted under the "Frequency" tab. Buttons are provided for touch-screen control
4. Bandscope parameters (span and mode) are adjustable.
2020-03-11 23:47:30 +00:00
5. Full [keyboard](https://gitlab.com/eliggett/wfview/-/wikis/Keystrokes) and mouse control. Operate in whichever way you like. Most radio functions can be operated from a numberic keypad! This also enables those with visual impairments to use the IC-7300.
2018-06-21 07:12:53 +00:00
### Build Requirements:
2018-06-21 07:18:37 +00:00
1. gcc / g++ / make
2018-06-21 02:09:48 +00:00
2. qmake
3. qt5 (proably the package named "qt5-default")
4. libqt5serialport5-dev
5. libqcustomplot-dev
2018-06-21 02:06:15 +00:00
2018-06-21 02:33:27 +00:00
### Recommended:
2019-12-26 08:47:57 +00:00
* Debian-based Linux system (Debian Linux, Linux Mint, Ubuntu, etc). Any recent Linux system will do though!
2018-06-21 07:18:37 +00:00
* QT Creator for building, designing, and debugging w/gdb
2018-06-21 02:33:27 +00:00
2018-06-21 07:12:53 +00:00
### Build directions:
1. clone this repository into a new folder
2. make a directory to build the code in (mkdir build)
3. Run qmake to configure the build:
2018-06-21 07:18:00 +00:00
* cd build
* qmake ../wfview/wfview.pro
2018-06-21 07:12:53 +00:00
4. Compile by running make.
2018-06-21 02:10:18 +00:00
### Rig setting:
2019-12-26 08:47:57 +00:00
1. CI-V Baud rate: Auto
2. CI-V address: 94h (default)
3. CI-V Transceive ON
4. CI-V USB-> REMOTE Transceive Address: 00h
5. CI-V Output (for ANT): OFF
6. CI-V USB Port: Unlink from REMOTE
7. CI-V USB Baud Rate: 15200
8. CI-V USB Echo Back: OFF
9. Turn on the bandscope on the rig screen
2020-02-29 02:33:15 +00:00
* Note: The program currently assumes the radio is on a device like this:
2019-12-26 08:47:57 +00:00
~~~
/dev/serial/by-id/usb-Silicon_Labs_CP2102_USB_to_UART_Bridge_Controller_IC-7300_02010092-if00-port0
~~~
This is symlinked to a device like /dev/ttyUSB0 typically. Make sure the port is writable by your username. You can accomplish this using udev rules, or if you are in a hurry:
~~~
sudo chown `whoami` /dev/ttyUSB*
~~~
2018-06-21 02:06:15 +00:00
2018-06-21 02:10:18 +00:00
### TODO:
2019-12-26 08:47:57 +00:00
1. Re-work pseudo term code into separate thread
2. Consider XML RPC to make flrig/fldigi interface easier
3. Add hide/show for SWR, ALC, Power, S-Meter interface
2018-06-21 02:06:15 +00:00