Skip to content

Commit 6bb2222

Browse files
authored
Merge pull request #47 from rrobinett/3.3.2
3.3.2
2 parents e1478ad + e6e5b2f commit 6bb2222

File tree

151 files changed

+6362
-2466
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

151 files changed

+6362
-2466
lines changed

.vimrc

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,3 +17,29 @@ set term=xterm-256color
1717
filetype plugin indent on
1818
syntax on
1919

20+
if exists('$TERM_PROGRAM') && $TERM_PROGRAM == 'iTerm2'
21+
" Change cursor to a vertical bar in Insert mode
22+
let &t_SI = "\e[6 q"
23+
" Change cursor to a block in Normal mode
24+
let &t_EI = "\e[2 q"
25+
endif
26+
if exists('$TMUX')
27+
" tmux-specific cursor changes for Insert/Normal mode
28+
" Insert mode: vertical bar cursor
29+
let &t_SI = "\e[6 q"
30+
" Normal mode: block cursor
31+
let &t_EI = "\e[2 q"
32+
endif
33+
" F2: Horizontal split
34+
nnoremap <F2> :split<CR>
35+
36+
" F3: Vertical split
37+
nnoremap <F3> :vsplit<CR>
38+
39+
" F4: Increase current split size
40+
nnoremap <F4> :resize +5<CR>
41+
nnoremap <S-F4> :vertical resize +5<CR> " Shift+F4 for vertical resizing
42+
43+
" F5: Move between splits
44+
nnoremap <F5> <C-w>w
45+

README.md

Lines changed: 3 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -1,77 +1,7 @@
11
# WsprDaemon (WD) 3.2.3 is the current master version
22

3-
Wsprdaemon (WD) is Linux service which decodes WSPR and FST4W spots from one or more [Kiwis](http://kiwisdr.com) and/or RX888 SDRs and *reliably* posts them to [wsprnet.org](http://wsprnet.org). It includes many features not found in WSJT-x, including multiple band and/or multiple receiver support. WD also records additional information about spots like doppler shift and background noise level which permit much deeper understanding of propagation conditions. For systems like the KiwiSDR which have a limited number of receive channels, schedules can be configured to switch between bands at different hours of the day or at sunrise/sunset-relative times. Spots obtained from multiple receivers on the same band ( e.g a 40M vertical and 500' Beverage ) can be merged together with only the best SNR posted to [wsprnet.org](http://wsprnet.org). WD can be configured to create graphs of the background noise level for display locally and/or at [graphs.wsprdaemon.org](http://graphs.wsprnet.org).
3+
Wsprdaemon (WD) runs as a Linux service to decode WSPR and FST4W spots from one or more [Kiwis](http://kiwisdr.com) and/or RX888 SDRs and *reliably* post them to [wsprnet.org](http://wsprnet.org). It includes many features not found in WSJT-x, including multiple band and/or multiple receiver support. WD also records additional information about spots like doppler shift and background noise level which permit much deeper understanding of propagation conditions. For systems like the KiwiSDR which have a limited number of receive channels, schedules can be configured to switch between bands at different hours of the day or at sunrise/sunset-relative times. It can "merge" spots obtained from multiple receivers on the same band (e.g a 40M vertical and 500' Beverage) and report only the one with the best SNR to [wsprnet.org](http://wsprnet.org). WD can create graphs of the background noise level for display locally and/or at [graphs.wsprdaemon.org](http://graphs.wsprdaemon.org) or [wspr.live](http://wspr.live/gui/).
44

5-
After configuration, WD is designed to run like a home appliance: it recovers on its own from power and Internet outages and caches all spots and other data it gathers until it is confirmed delivered by wsprnet.org and/or wsprdaemon.net. Most of the 20+ 'top spotting' sites at http://wspr.rocks/topspotters/ are running WD, and in aggregate they report about 33% of the 7+M spots recorded each day at wsprnet.org.
5+
After configuration, WD runs like a home appliance: it recovers on its own from power and Internet outages and caches all spots and other data it gathers until it confirms delivered to wsprnet.org and/or wsprdaemon.net. Most of the 20+ 'top spotting' sites at http://wspr.rocks/topspotters/ run WD, and in aggregate they report about 33% of the 7+M spots recorded each day at wsprnet.org.
66

7-
WD runs on almost any Debian Linux system running Ubuntu 22.04 LTS on x86 Although WD on a Pi 4 can decode 10+ bands, most sites run WD on a x86 CPU.
8-
9-
## Greenfield Installation
10-
11-
On other Debian/Ubuntu servers, create a `wsprdaemon` user to install and run WD on your system. That user will need `sudo` access for installation, and auto sudo permissions is needed if WD is configured to display graphics on the server's own web page. On a Raspberry Pi running the Buster OS, install as the default user 'pi'.
12-
13-
To configure user 'wsprdaemon' to sudo:
14-
```bash
15-
su -
16-
sudo adduser wsprdaemon
17-
sudo usermod -aG sudo wsprdaemon
18-
exit
19-
```
20-
21-
While logged on as user 'pi' or 'wsprdaemon':
22-
23-
Download `wsprdaemon.sh` from this site by executing:
24-
25-
```bash
26-
cd ~
27-
git clone https://github.com/rrobinett/wsprdaemon.git
28-
cd wsprdaemon
29-
./wsprdaemon.sh -V
30-
```
31-
32-
This first run of WD will prompt the user to edit the prototype configuration file '~/wsprdaemon/wsprdaemon.conf' which includes extensive comments about the many configuration options. A basic installation will require that the IP address of at least one Kiwi receiver be defined in the RECEIVER_LIST section, and one listening schedule line be defined in the WSPR_SCHEDULE_simple section.
33-
34-
Once those edits are made, run '~/wsprdaemon/wsprdaemon.sh -a' which will install many, many utilities and libraries, for some of which you will be prompted to agree to the installation. Some/all of them will require `sudo` permission. I configure `wsprdaemon` as a member of the `sudoers` group and thus am never prompted for a password, but your experience may vary.
35-
36-
There are a number of commands to more easily control and monitor WD that can be permanently installed by executing:
37-
38-
``` bash
39-
pi@KPH-Pi4b-85:~ $ source ~/wsprdaemon/.wd_bash_aliases
40-
pi@KPH-Pi4b-85:~ $ wd-rci
41-
A reference to '~/wsprdaemon/.wd_bash_aliases' has been added to ' ~/.bash_aliases'
42-
pi@KPH-Pi4b-85:~ $
43-
```
44-
Once installed you can:
45-
46-
wda => start WD
47-
48-
wdz => stop WD
49-
50-
wds => print the status of WD
51-
52-
wdln => watch the log of WD uploading spots to wsprnet.org
53-
54-
wd-help => list all the added commands
55-
56-
Beware : newer versions, since 3.1.5 will need to use
57-
58-
```
59-
source ~/wsprdaemon/bash-aliases
60-
```
61-
62-
## Upgrading WD in a cloned directory to the latest master version
63-
64-
Execute 'git pull'
65-
66-
## Usage
67-
68-
After installation and configuration is completed, run:
69-
70-
| Command | Description |
71-
| ------- | ----------- |
72-
| `~/wsprdaemon/wsprdaemon.sh -A` | Starts WD running as a background linux service which will automatically start after any reboot or power cycle of your server |
73-
| `~/wsprdaemon/wsprdaemon.sh -z` | Stop any running WD, but it will start again after a reboot/power cycle |
74-
| `~/wsprdaemon/wsprdaemon.sh -s` | Display the status of the WD service |
75-
| `~/wsprdaemon/wsprdaemon.sh -h` | Help menu |
76-
77-
Since I have no QA department, installations, especially on non-Pi systems, may encounter problems which I have not seen. However WD has been running for months at many top spotting sites and I hope you find it useful, not frustrating.
7+
For further documentation on prerequisites, installation, configuration, and running WD, please refer to the [documentation](https://wsprdaemon.readthedocs.io/en/3.3.1/).

0 commit comments

Comments
 (0)