-
-
Notifications
You must be signed in to change notification settings - Fork 7
Expand file tree
/
Copy pathqso-logbook.html
More file actions
204 lines (190 loc) · 11.7 KB
/
Copy pathqso-logbook.html
File metadata and controls
204 lines (190 loc) · 11.7 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
<!DOCTYPE html>
<html lang="en-GB">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>QSO logbook — OscarWatch Help</title>
<link rel="stylesheet" href="styles.css" />
</head>
<body>
<div class="wrap">
<header>
<div class="brand">
<a href="index.html" class="brand-home" title="Home"><img src="oscarwatch-icon.png" alt="" class="brand-icon" width="56" height="56" /></a>
<div class="brand-text">
<h1>QSO logbook</h1>
<p class="tagline">Fast satellite logging during a pass, with ADIF export</p>
</div>
</div>
<nav aria-label="Help topics">
<ul>
<li><a href="quick-start.html">Quick start</a></li>
<li><a href="map-and-sidebar.html">Map & sidebar</a></li>
<li><a href="frequencies.html">Frequencies</a></li>
<li><a href="satellites.html">Satellites & TLEs</a></li>
<li><a href="passes.html">Pass planning</a></li>
<li><a href="radio-rotator.html">Radio & rotator</a></li>
<li><a href="settings.html">Settings</a></li>
<li><a href="keyboard-shortcuts.html">Shortcuts</a></li>
<li><a href="troubleshooting.html">Problems?</a></li>
</ul>
</nav>
</header>
<main>
<p class="lead">
OscarWatch includes a lightweight <strong>local QSO logbook</strong> for satellite contacts.
It is separate from <a href="settings.html">Cloudlog integration</a> (under Settings → Integrations;
frequencies and checks rove grids online). Use the logbook when you want quick field logging
tied to the satellite you are tracking, then export ADIF for your main logging program.
</p>
<h2>Opening the logbook</h2>
<p>
Go to <strong>Tools → QSO Logbook</strong>. Only one logbook window is open at a time — choosing the menu
again brings the existing window to the front. The window opens with the callsign field ready
for fast entry. Keep it open beside the main map during a pass.
</p>
<h2>Before you log</h2>
<ul>
<li>
<strong>My callsign and grid</strong> — each logbook stores its own station identity for ADIF export
(<strong>STATION_CALLSIGN</strong> and <strong>MY_GRIDSQUARE</strong>). Set these when you create a logbook
or edit them by creating a new logbook for a different activation. They are not taken from
<strong>Settings → Station</strong> (that tab is for pass prediction position and display labels only).
</li>
<li>
<strong>Focus a satellite</strong> — click the spacecraft on the map or in the pass list.
The logbook’s <strong>Station control</strong> panel shows satellite name, mode, and uplink/downlink
frequencies from OscarWatch tracking. These are stored automatically when you add a QSO.
</li>
</ul>
<h2>Logbooks</h2>
<p>
Contacts are grouped into named logbooks (for example “Portable activation” or a contest name).
Use the <strong>Logbook</strong> menu to switch between them — the current logbook name is shown
at the top of the menu, with a radio list of all logbooks below.
</p>
<ul>
<li><strong>New logbook</strong> — opens a dialogue where you enter a name, your callsign, and your grid for that activation. If a logbook is already selected, its callsign and grid are offered as a starting point.</li>
<li><strong>Edit logbook</strong> — opens the same dialogue to change the name, callsign, or grid for the selected logbook. Existing QSO records keep their original data; only ADIF station fields for future exports change.</li>
<li><strong>Delete logbook</strong> — asks for confirmation, then removes the selected logbook and all QSOs in it (there is no undo).</li>
</ul>
<p>
The first time you open the logbook, OscarWatch creates a default <strong>Main logbook</strong>
using your Maidenhead grid from <strong>Settings → Station</strong>. Use
<strong>Logbook → Edit logbook</strong> to set your callsign and correct the name or grid.
</p>
<h2>UTC logging</h2>
<p>
Every QSO is timestamped in <strong>UTC</strong> when you press <strong>Add</strong>.
The live <strong>QSO time (UTC)</strong> clock shows the time that will be recorded, formatted
using your regional date order and your 12- or 24-hour clock preference from Settings.
History columns and ADIF export use UTC (<code>QSO_DATE</code> / <code>TIME_ON</code>).
The date/time format in the grid follows the same display preferences.
</p>
<h2>Fast entry</h2>
<ul>
<li>Type the worked callsign, RST sent/received, grid, optional name and comment. Callsign and gridsquare entries are uppercased as you type.</li>
<li>Press <strong>Add</strong>, or press <strong>Enter</strong> in any entry field — the QSO is saved and focus returns to the callsign box for the next contact. <strong>Add</strong> is disabled until the callsign is filled in and any gridsquare entry is valid (empty grid is allowed).</li>
<li>RST defaults to <strong>59</strong> on FM/packet-style modes and <strong>599</strong> on SSB/CW, based on the tracked mode.</li>
<li>When you type a callsign you have worked before in this logbook, a red <strong>Worked</strong> badge appears under the entry row (green <strong>Not worked</strong> for a new call). The callsign box border uses the same colours. A hint may also show the previous grid.</li>
<li>Typing three or more characters in the callsign box filters the recent QSO list to matching calls (cleared when you finish logging or clear the field).</li>
<li><strong>Alt+W</strong> clears the entry fields (and cancels an edit in progress), then returns focus to the callsign box — similar to contest loggers such as N1MM.</li>
</ul>
<p>
Keyboard shortcuts are listed in <a href="keyboard-shortcuts.html">Keyboard shortcuts</a>
(<strong>Alt+W</strong> to clear fields, <strong>Enter</strong> to add or save).
</p>
<h2>Grid squares on a line</h2>
<p>
For a station on a Maidenhead grid boundary, enter multiple squares separated by commas
(for example <code>IO77,IO87</code>). This applies to the worked <strong>Gridsquare</strong> field
and to <strong>My grid</strong> when you create a logbook. Values are normalised to uppercase.
The gridsquare border turns green when the entry is valid and red while it is incomplete or invalid.
</p>
<h2>Recent QSOs</h2>
<p>
The history grid lists contacts for the selected logbook (newest first). Columns include date/time,
call, grid, satellite, mode, RST sent, RST received, Cloudlog upload status (when automatic upload is enabled),
and comment. Click a row to select it,
or right-click a row for <strong>Edit QSO</strong> and <strong>Delete QSO</strong>.
Drag column borders to change widths, and resize or move the window — OscarWatch remembers your layout when you close the logbook.
</p>
<ul>
<li><strong>Edit → Edit QSO</strong> — loads the selected contact into the entry fields so you can correct it and press <strong>Save</strong>.</li>
<li><strong>Edit → Delete QSO</strong> — asks for confirmation, then removes the selected contact.</li>
</ul>
<p>
The status bar shows the current logbook name and total QSO count (for example <strong>Main logbook — 12 QSOs</strong>),
then action messages and station tracking status. The Cloudlog column shows <strong>Pending</strong>,
<strong>Sent</strong>, or <strong>Failed</strong> when automatic upload is enabled for that logbook; it updates
when uploads complete.
</p>
<h2>Logbook settings — Cloudlog upload</h2>
<p>
Choose <strong>Settings</strong> from the logbook menu to open per-logbook options.
The first tab is <strong>Cloudlog</strong>:
</p>
<ul>
<li><strong>Enable automatic QSO upload</strong> — posts each new contact to Cloudlog after you add it.</li>
<li><strong>Station location</strong> — pick a Cloudlog station profile (loaded from the
<code>station_info</code> API). Press <strong>Refresh</strong> to reload the list.</li>
<li><strong>Retry failed uploads</strong> — re-queues contacts that could not be uploaded.</li>
</ul>
<p>
Cloudlog URL and API key come from the main application
<a href="settings.html">Settings → Integrations</a>; you do not enter them again in the logbook.
If an upload fails (network error, API rejection, etc.), the QSO stays in the local database with
a failed status and OscarWatch retries later when the logbook opens or when you press
<strong>Retry failed uploads</strong>.
</p>
<h2>Export ADIF</h2>
<p>
Choose <strong>Export → Export ADIF</strong> to save QSOs as a <code>.adi</code> file.
The export dialogue lets you include <strong>all QSOs in the logbook</strong> or restrict to a
<strong>UTC date range</strong> (for example one pass or one field day). A preview shows how
many records will be written before you save.
</p>
<p>
You can also choose whether the file is for <strong>Logbook of the World (LoTW)</strong>. When enabled,
satellite names are remapped to the identifiers LoTW expects (for example <code>ISS</code> → <code>ARISS</code>).
Leave the option unchecked for Cloudlog, Log4OM, and other loggers that use common satellite names.
</p>
<p>
Records include satellite name, ADIF mode and submode (for example LSB as <code>MODE=SSB</code> with <code>SUBMODE=LSB</code>),
bands, frequencies, propagation mode <strong>SAT</strong>,
your station callsign and grid from the logbook, and comma-separated grids when used.
When uplink and downlink modes differ, the downlink mode is noted in <code>COMMENT</code>
(for example <code>RX mode USB</code>) rather than a non-standard field.
Special characters in comments are escaped for safe ADIF import.
Import the file into Cloudlog, Log4OM, or any ADIF-capable logger.
</p>
<h2>Where data is stored</h2>
<p>
Logbooks and QSOs are kept locally in:
</p>
<p><code>%AppData%\OscarWatch\qso_logbook.db</code></p>
<p>
Window size, position, and history column widths are saved in
<code>%AppData%\OscarWatch\settings.json</code> when you close the logbook window.
</p>
<p>
Back up the database file if you rely on OscarWatch as your only copy of a field log.
ADIF export is the recommended way to merge contacts into your main logging program.
</p>
<h2>Satellite link</h2>
<p>
If <a href="satellite-link.html">Satellite link</a> is enabled, each QSO you add, edit, or delete
is broadcast to connected WebSocket clients as a <code>qsoLogged</code>, <code>qsoUpdated</code>, or
<code>qsoDeleted</code> message. External logging tools can mirror your OscarWatch log in real time.
See the <a href="satellite-link.html#api">developer API</a> for the full JSON schema.
</p>
<div class="tip">
<strong>Tip:</strong> Cloudlog’s <strong>Logbook</strong> dropdown under Settings → Integrations
is for online grid checks on hams.at roves. Automatic QSO upload uses a separate
<strong>station location</strong> picker in the logbook’s own Settings dialogue.
</div>
</main>
<footer>OscarWatch — help for satellite operators</footer>
</div>
</body>
</html>