cqrlog/help/adif.html
OH1KH 5f6fab06c8 Fix, cleanup and addition to ADIF remote
- fixed bug with operator-tag
	- cleaned up code and moved parts to dmUtils
	- added support to N1MM+ contactinfo broadcast
	- help fixed

Squashed commit of the following:

commit 486ca7b458
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu Dec 31 10:30:43 2020 +0200

    help fixes

commit 8ff99e336e
Author: OH1KH <oh1kh@sral.fi>
Date:   Wed Dec 30 17:26:24 2020 +0200

    some testing with N1MM+

commit d985498d14
Author: OH1KH <oh1kh@sral.fi>
Date:   Wed Dec 30 12:38:25 2020 +0200

    Now works in basic.
    - N1MM+ XML UDP connectinfo
    - JS8CALL UDP JSON logged value
    - Headerless ADIF that has CALL tag 1st (wsjtx 2nd udp server and old js8call)
    - ADIF with header and one or more qso records.

    Needs testing and still find out how N1MM sends SXT_STRING and SRX_STRING (that does not work yet).

    One previous bug found with OPERATOR tag. Should now work as expeceted.

commit bfec21137d
Author: OH1KH <oh1kh@sral.fi>
Date:   Tue Dec 29 11:29:17 2020 +0200

    Moved N1MMxmlToAdif function to dmutils. it is better as it is an utility.

    Should now work but needs testing and clear out how N1MM sends STX_STRING and
    SRX_STRING. ??? There is only node "exhangel" (exhange list, I suppose).
    Does it conatin both.
    Need true life testing setup for this.

    ToDo:
    Move also JS8CALL json "converter" to dmUtils. There is allready empty function done.

commit 68d68c491b
Author: OH1KH <oh1kh@sral.fi>
Date:   Mon Dec 28 12:40:04 2020 +0200

    N1MM remote for reading 'Contact Info' UDP message. Not working yet
2020-12-31 10:33:20 +02:00

88 lines
4.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>CQRLOG - fldigi XmlRpc</title>
</head>
<body>
<script>
function goForward() {
window.history.forward();
}
function goBack() {
window.history.back();
}
</script>
<table border="0" cellpadding="5" cellspacing="2" width="100%">
<tbody>
<tr>
<td valign="top"><img src="img/exc.png"></td>
<td bgcolor=ffffcc valign="top" align="justify"><strong>
<font color="red">WARNING!</font></strong>
Backup your data often! BACKUP your log directory at the end of EVERY session!
All that you need to backup and store in a safe place is the log database directory
located in the ~/.config/cqrlog/database folder, or you can enable the autobackup function
in Preferences. This autobackup function creates an ADIF file with a backup of your log.
/td>
</tr>
</tbody>
</table>
<table style="text-align: left; width: 100%;" border="0" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td width="33%" align="center">[<a href="index.html" target="_top">Menu</a>]</td>
</tr>
</tbody>
</table>
<br>
<div style="text-align: left;"><strong>CQRLOG for LINUX by OK2CQR &amp; OK1RR</strong></div>
<p align=center><img src=img/line.png></p>
<a name=fl1><h2><strong>ADIF logger remote</strong></h2></a>
<img src="img/adif1.png" name="1" border="0"/>
<p>ADIF remote connection (former "N1MM+ remote logger") is just for copying logged qso infromation from other program like wsjt-x or js8call (or similars that support this kind of logging) to cqrlog.
There is no other finctionality than just transfer the logged data.
<br><br> ADIF remote can read adif tags from UDP datagram as follows:
<ul>
<li> 1) Datagram has full adif export including proper header and one or more qso records.(used by wsjt-x primary UDP datagram)</li>
<li> 2) Datagram has qso record without header starting with tag "&lt;CALL" and ending to &lt;EOR&gt; (used by wsjt-x secondary UDP datagram and older js8call)</li>
<li> 3) Datagram has JSON record including 'LOG.QSO","value":' followed by adif tags starting with tag "&lt;CALL" and ending to '"}' (latest js8call)</li>
<li> 4) Datagram has XML qso record including node <b>contactinfo</b> with subnode <b>IsOriginal:True</b> (N1MM+ qso contact broadcast)
</ul>
</br>Remote mode is activated from NewQSO/File selection list, or pressing Ctrl-K when NewQSO window is focused.
</p><p>
<img src="img/adif3.png" name="3" border="0"/>
</br>Settings must be done at wsjt-x or js8call Settings/reporting. At least checking the checkbox. Port and address values can be defaults.
</br></br>
<img src="img/adif3b.png" name="3" border="0"/>
</br></br>If N1MM is run in virtual machine or second computer the IP address of cqrlog computer must be used. Otherwise, when running under same Linux localhost addtess 127.0.0.1 can be used also with N1MM+
</p><p>
<img src="img/adif2.png" name="2" border="0"/></br></br>
When remote is selected you will see <b>remote ADIF</b> with red font. This will change when UDP frame is received.
</br> Case 1) (see list abowe) it turns to <b>REMOTE ADIF</b>
</br> Case 2) (see list abowe) it turns to <b>rmt ADIF hdless</b>
</br> Case 3) (see list abowe) it turns to <b>rmt ADIF JS8CALL</b>
</br> Case 4) (see list abowe) it turns to <b>rmt ADIF N1MM+</b>
</br></br>
<b>Note:</b> when case 3) frame is received ADIF remote can not receive any other type frames until remote is disabled and again enabled. This is because some versions of js8call send both json and headereless logging frames that would lead to double logging of qsos.
</br></br>
No indication of logging can be seen unless user has set "cqrlog/preferences/NewQSO/Show recent qso records for last X days" active.</br>
If this is set, after pressing "OK" at companion program's logging window logged qso will appear to cqrlog's NewQSO recent qsos list.
If QSO list window is open and "cqrlog/preferences/NewQSQ/Refresh data after save qso" is checked QSO list is also updated after QSO is logged.
</p><p>
ADIF remote can not be used at same time as fldigi or wsjt remotes.</br> How ever if you allow ADIF logger support at wsjt-x and js8call settings and choose remote mode for ADIF from cqrlog you can keep both programs running at same time if your rigctld settings support that.
See: <a href="img/setting_rigctld_for_all_programs.pdf">setting_rigctld_for_all_programs</a>, and log qsos from both programs to cqrlog without problems.
</p><p align=center><img src=img/line.png></p>
<br>
<table width="100%" border="0" cellpadding="2" cellspacing="2">
<tbody>
<tr>
<td width="33%" align="center">[<a href="index.html" target="_top">Menu</a>]</td>
</tr>
</tbody>
</table>
<br>
</body>
</html>