cqrlog/help/h26.html
OH1KH e6b1503cc8 This update planned to allow HamLib usage with radio2 selected (with it's port and address).
As usual the work grows ...
Thanks Martin, DL1MTG, for testing and comments!

CW keyer:
    -Preferences CW interface: both radios can now have own type of keyer.

    -HamlibKeyer address/port is taken from selected radio

    -Keyer is reloaded with every change of radios, but if user sets both
     keyers to same type (and it is not HamLib) he can use checkbox to
     prevent reloading when radio is switched. Meaning he uses same physical
     keyer for both radios and does not want that radio switch (keyer reloading)
     sets CW speed always back to default.

    -K3NG keyer serial speed was stored to Word variable. That can carry only
     value up to 65535. Changed to dWord and now speed 115200 should be passed
     to serial port setup (no device to test that, but 115200 comes now ok up
     to ser.config()-line that it did not before).

Help:
    -Preferences have now 2 help buttons. One gives help for currently selected
     tab, other opens help index.
     I think Lazarus help system has bug (or I can not use it!) but tab help keyword
     definitions in .lfm can never be used as ShowHelp checks parent and if found  uses
     Parent.showhelp that seems to lead to upper level help keyword.

    -There is another problem because help system uses system default browser and
     Lazarus finds it using xdg-open (Linux system script to find registered viewer)
     xdg-open has property that drops away hashtag links pointing to website chapters
     if url "file:///" is in question.
     That is why user must define "real browser" at preferences/program to see hashtag
     linked help pages properly. (sad but seems to be true)

    -preferences/program Web browser setting has improved. Checks that browser name
     entered can be found. Reports if not found. If left empty, uses
     dmUtils.MyDefaultBrowser function that usually places xdg-open as browser.
     Click of browser name edit box offers file navigator to find browser binary
     (but direct typing is also possible, see help page)

    -when webbrowser is read from ini, default hardcoded 'firefox' is removed
     (all systems do not have it!) instead there is call to dmUtils.MyDefaultBrowser

    -some help pages are fixed and added.

Other:
    -while doing debug with Lazrus IDE I found out that when cqrlog does get response
     Not Found for DXCC and qslmgr version number from http://ok2cqr it causes an error
     in version number StrToInt conversion.
     User does not see this as it is done inside try/finally/end, but while debugging
     it was so annoying last Sunday that I changed code so that if received data
     from web site includes "not found" it does not even try StrToInt conversion.

    -It seems to be freepascal(linux) property that when external child program is run from parent
     and it ends it leaves zombie PID hanging on until parent closes that cleans up all
     child zombies.
     These appears when external vievers, fldigi, wsjtx, scripts (voice, start, stop) etc.
     are run from cqrlog. Might not do any harm normally. Perhaps if cqrlog is running
     extreamly long time without closing.

Squashed commit of the following:

commit 6350ac2b6a6dae507320c08a5ee5f7a374398654
Author: OH1KH <oh1kh@sral.fi>
Date:   Tue May 12 09:13:05 2020 +0300

    Added own ports for radio2 winkey/cwdaemon and K3NG

commit 23af6145c5d7aa4b7e3fd928e3853bc9a3ae0a40
Author: OH1KH <oh1kh@sral.fi>
Date:   Mon May 11 07:16:44 2020 +0300

    Preferences: buttons: Help(tab), Help(idx)

commit 71108698a53347feb8423febf075c739fb16877f
Author: OH1KH <oh1kh@sral.fi>
Date:   Mon May 11 07:01:15 2020 +0300

    some changes to user browser selection

commit de3e0f326bf2dda3a5ea6531824dc12c9821d97a
Author: OH1KH <oh1kh@sral.fi>
Date:   Sun May 10 18:59:29 2020 +0300

    part external viewers update

commit 80581a58633c26479bf98d6a71914214713585f8
Author: OH1KH <oh1kh@sral.fi>
Date:   Sun May 10 17:46:29 2020 +0300

    propagation help added

commit cf11bfcd97d399645946287506cca2945aaff85c
Author: OH1KH <oh1kh@sral.fi>
Date:   Sun May 10 13:04:16 2020 +0300

    Finally working tab based help for preferences. Fixed bug 'invalid date format' if dxcc and qslmgr check fails because of ok2cqr web page fail 404

commit 53f5ceb41d365f955a9c270967f2554c61916626
Author: OH1KH <oh1kh@sral.fi>
Date:   Sun May 10 10:10:22 2020 +0300

    User select keyer reset if same keryer for both rigs + help update

commit c97761e14e2694a44f9a91515a54365c7c18bba7
Author: OH1KH <oh1kh@sral.fi>
Date:   Sat May 9 17:49:31 2020 +0300

    Some help fixes still

commit f46e771f7e8a9de6e3acac16614e1817a0af9485
Author: OH1KH <oh1kh@sral.fi>
Date:   Sat May 9 10:02:27 2020 +0300

    removed unused variables

commit ed90d7d660a5cfe7243abc7099fcae1f30075f60
Author: OH1KH <oh1kh@sral.fi>
Date:   Sat May 9 09:46:50 2020 +0300

    Fixed K3NG keyer serial speed setting. Changed speed :word to :dword now accepts over 65535 speeds

commit 0d89b6b4e9b3126564ca61247b2577db4a6f3bce
Author: OH1KH <oh1kh@sral.fi>
Date:   Sat May 9 09:28:15 2020 +0300

    Default browser selection fixes. Affects how help hashtags works in different systems.

commit 3ad50cf0babc1ee888ef665fdb7bf67f6e9a8497
Author: OH1KH <oh1kh@sral.fi>
Date:   Fri May 8 12:32:45 2020 +0300

    help typo fix

commit a4cd6ff58c01773329f0ae8173bf84602ead1ddf
Author: OH1KH <oh1kh@sral.fi>
Date:   Fri May 8 12:31:39 2020 +0300

    some help fixes

commit 6111f3be6afa8ee8b81918758ddeb75d277683c4
Author: OH1KH <oh1kh@sral.fi>
Date:   Fri May 8 10:50:25 2020 +0300

    Some bug fixes

commit 36344f3748b1efef878f8ad6b0778e619527eb6c
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu May 7 17:41:53 2020 +0300

    Removed pnlMain caption text/TRXCntrol

commit e16dab0fe1e80779d90a04640bb3a077f7c40b1d
Author: OH1KH <oh1kh@sral.fi>
Date:   Thu May 7 17:38:21 2020 +0300

    help fixed now

commit bdc08e74394a1ef77ecdbbffa70af890f7d7cbc4
Author: OH1KH <oh1kh@sral.fi>
Date:   Wed May 6 12:11:14 2020 +0300

    Changed idea: both rigs have keyer selection at prefrences/CWinterface. Help fix

commit d3ae6f3e56328894a8260f344b4346f546711a18
Author: OH1KH <oh1kh@sral.fi>
Date:   Tue May 5 10:39:08 2020 +0300

    Hamlib CW follows rig if set in preferences. Rig switch resets cw interface if hamlib
2020-05-13 05:44:42 +03:00

123 lines
7.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>CQRLOG - CW messages</title>
</head>
<body>
<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 OK7AN &amp; OK1RR</strong></div>
<p align=center><img src=img/line.png></p>
<h2><strong>CW messages</strong></h2>
<p>Assuming that your CW interface is properly set up and working,
you can add and/or edit your CW messages.<br><br>
Set up your CW messages via Preferences/CW inteface/CW messages button.
<br> You can also access CW messages from the upper menu bar of the New QSO window.
Click on the 'File' item and select CW Messages.<br><br>
<img src=img/h96b.png>&nbsp;&nbsp;<img src=img/h96.png><br><br>
Choose the <strong>CW Messages</strong> option. By using the form opened you can edit your CW messages that
will be sent when you press the corresponding <strong>F</strong>-key(s).
You can set up to 10 predefined messages:<br><br>
<img src=img/h97.png><br><br>
There are some predefined macros which you can use in your messages:<br><br>
<table border="0" cellpadding="5" cellspacing="2" width="50%">
<tbody>
<tr>
<td bgcolor=#ffffcc valign="top">
<ul>
<li>%mc - my callsign</li>
<li>%mn - my name</li>
<li>%mq - my qth</li>
<li>%ml - my locator</li>
<li>%r - rst send</li>
<li>%rs - rst send sends N instead of 9<br>(sends also 0 as T, but that does not exist in normal report)</li>
<br>
<li>%n - name</li>
<li>%c - callsign</li>
<li>%h - greeting GM/GA/GE calculated from the %c station location time</li>
<br>
<li>%xn - contest exchange serial number</li>
<li>%xm - contest exchange message</li>
<li>%xns - contest exchenge serial number sends 9->N and 0->T</li>
<li>%xrs - full contest exchange RST+SerialNR+Message sends 9->N and 0->T.<br>
(May be used always instead of %rs as if serNR and Message are empty just sends plain report.)</li>
</ul>
</td>
</tr>
</tbody>
</table>
</p><a name=mk1><br></a> <img src="img/misc8.png" name="8" width="500" height="85">
</img>
<p><strong>Memory keys</strong> form has buttons PgUp and PgDn that are not configurable. They alter CW speed in same way as keyboard keys PgUp and PgDn that some, specially laptop computers, may not even have.
<br>When using <strong>Memory keys</strong>-form with mouse, or keyboard, you are able to lauch memories by mouse click or by <strong>F</strong>-key press from keyboard keys. Same with PgUp and PgDn, both are working, keys and mouse click.
<br>You can select what happens when <strong>Memory keys</strong>-form is active and <strong>ENTER</strong> (also called Return) key is pressed, <strong>repeat last clicked memory</strong> (send focused button text)
, <strong>ignore it</strong> (do nothing) or <strong>save qso</strong>, by selecting that with ENTER section radio buttons in <strong> CW Messages</strong> definition form.</p>
<a name=mk2><img src=img/h98.png></a><br>
Another form <strong>CW type</strong> is a powerful keyboard keyer with 3 operation modes:<br></p>
<ul>
<li><strong>letter mode</strong> - the character of the corresponding keyboard key is
sent immediately on pressing the key
<li><strong>word mode</strong> - a whole word is typed, sending starts after pressing
of the spacebar
<li><strong>word mode, first word in letter mode</strong> - a combination of above.
The keyer begins in letter mode to avoid unneccessary delays, if you type fast enough
it switches to word mode
</li>
</ul>
These modes are common on professional keyboard keyers.<br><br>
CWTyping area allows paste (copy in editor/paste to CWType) and drop (select in editor and drag with mouse left button pressed and drop on CWType area).<br><br>
<strong>NOTE!</strong> CW sending has limited buffer space depending keyer type and rig model. Be aware that pasting a very long text to CWType area may lead to CW keyer buffer overflow. When Hamlib keying is in use it will send words under 10 characters as one command, but if text to be sent is longer it will send all letter by letter (1 chr per one command).
This is tested to work with IC7300. Same should happen with Kenwoodother rigs and HamLib keying, but this is not tested and may not work in same way.
<br><br> <strong>Same warning </strong>with manual typing in word mode: If your typing speed is faster than cw sending you may hit send buffer limit sooner or later.
<br><br> <strong>Switching radios </strong>while CW sending is going on can cause unexpected results !
<br><strong>Always wait</strong> that CW message has finshed before switching radios as it will also switch CW keyers.
<br><strong>Always wait</strong> that selected radio shows frequency in TRXControl before sending a CW message or start using CW Type.
<br><br>
The <strong>keying speed</strong> can be changed with PgUp (QRQ) and PgDn (QRS) keys
in 2 WPM steps when <strong>NewQSO</strong>-form is active. In the <strong>CW type</strong>-form when cursor is in text typing area same PgUP/PgDN keys work. Speed can also be changed with the small arrow
buttons to the right of the speed display. The actual speed is always displayed in the status line of the <strong>New QSO</strong>-form and in <strong>CWType</strong>-forms speed selector.<br><br>
The<strong> ESC </strong>key stops running transmit. This may not be supported in all keyers and rigs and is mainly usefull when using word mode or pasted/dropped text.
<br>
With HamLib keyer ESC sends hex byte 0xFF as message. Icom rigs halt CW with this. An empty message with Kenwood rigs should use this to stop sending.
<br>Be aware that this has tested very little.
<br><br>
<strong>NOTE!</strong> Some special characters like Ä (A with dots) etc. May not be supported in CWType direct from keypress. For example Hamlib keying with Icom rig sends A with dots when typing 3 characters ^AA and you have to find out the way suitable for your setup.<br><br>
<img src=img/h99.png><br><br>
Setup howtos for both <a href=cwd.html><strong>cwdaemon</strong></a> and
<a href=wkusb.html><strong>Winkey USB</strong></a> are available.<br><br>
</div>
<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>