xCATcmd

met review door Jan PH3J

1 Algemeen

2 Eerste opstart

2.1 Connection

Opdrachten

2.2 Editor mogelijkheden

3 Voorbeeld xCATcmd files

4 Autostart profiel DWS

5 Transceiver CAT manuals

1 Algemeen

Moderne toestellen zijn voorzien van CAT interfaces, waardoor nagenoeg alle settings en bediening van het toestel ook vanop afstand kan gebeuren.
De tools ontwikkeld binnen DWS door Jan PH3J, zoals de YsuCat, YsuDXcat, ICOMcat en het nieuwe tool xCATCmd laten je toe om de verdere automatisering van je station door te voeren.
Het gebruik van batch files (.BAT) in windows maakt het mogelijk om je transceiver in een bepaalde mode in te stellen en daarna DWS of een ander programme op te starten.
Koppel je dit aan de Macrobuttons van Voicmeter, dan worden deze reeks van handelingen letterlijk een toetsdruk (zie DX Commander).

Echter tot op heden was het aanmaken van de batch files een "trail and error".
Het tool xCATCmd laat je nu toe om op een vlotte manier command reeksen aan te maken, te delen met anderen en te hergebruiken voor het aanmaken van je eigen set van knoppen.

Toepassingen zoals: autotune van een externe antennetuner op meerdere banden, instellingen op operatormaat van je toestel, settings voor FT8 of andere modi en koppelingen met andere softwares dan DWS zijn maar een greep uit de mogelijkheden.
Enkel jouw inspiratie zal de beperkende factor zijn.

Gecombineerd gebruik met de YsuDXcat en xCATCmd

xcatcmd1.mp4

"Enkel toets druk" demo

2 Eerste opstart

Wanneer je xCATCmd de eerste maal opstart, bekom je een leeg scherm.
Je eerste taak is de verbinding met je toestel in orde stellen.

2.1 Connection

Maak je gebruik van één van de tools van Jan PH3J (YsuDXCat, YsuCat, ICOMcat) en wordt het programma vanuit dezelfde folder opgestart, dan kan je hiermee direct contact maken.

Is dit niet zo, dan kan je dmv een com poort en bijbehorende settings, verbinding maken met een virtuele compoort, die je hebt aangemaakt bij de installatie van de xCat softwares of rechtstreeks met je transceiver.

Eend druk op Connect maakt de verbinding met de ingestelde parameters en claimt de Com poort voor communicatie. Hierdoor zal deze bezet zijn voor andere toepassingen.
Doordat je binnen de Cat tools meerdere virtuele compoorten kan aanmaken is een specifieke poort aanmaken voor het xCATCmd tool zeker geen overbodige luxe en kan je je transceiver ook bedienen, zelfst al heeft een andere software eveneens toegang (vb N1MM, VARAC, DWS...).
Zie ICOM/YAESU setup Tcp

xcatcmd2.mp4

Connectie opzetten met je transceiver

xcatcmd3.mp4

Eerste opstart en gebruik xCATcmd

Opdrachten

In het opdrachten scherm kan je verschillende CAT Commands opgeven, samen met de nodige commentaar (Description).
Het formaat van de CAT commando's is afhankelijk van je toestel en kan verschillen per type binnen één en hetzelfde merk.
Het gebruik van de velden achteraan heeft de volgende betekenis:

BAT: dit geeft aan dat het commando op deze lijn zal overgenomen worden in de batch file
Multi: dit geeft aan dat het commando op deze lijn zal uitgevoerd worden wanneer de knop Run Multi wordt gedrukt, waarbij alle commando's die aangeduid zijn van bovenaan naar beneden in volgorde worden uitgevoerd.
Run: een druk op Run pijltje voert ogenblikkelijk dit commando uit.
Het Run pijltje wordt gebruikt om een commando te testen of manueel één enkel commando uit te voeren.

2.2 Editor mogelijkheden

Klembord copy/paste

Wanneer het Description en/of Commands veld geselecteerd is, kan je tekst vanuit je windows klembord hier naar toe kopiëren of manueel ingeven.
De waarde in dit veld wordt bewaard als je op ENTER drukt.

Druk je op de laatste lijn in het Commands veld op enter, dan zal er automatische een lege lijn worden toegevoegd.

Context menu

Wanneer je je rechter muistoets gebruikt op de kolommen BAT of Multi of als er een volledige lijn geselecteerd is (blauw), dan krijg je het context menu met heel wat meer mogelijkheden.

Je kan een volledige lijn kopiëren en plakken.
Je kan lijnen toevoegen onderaan (Add) of tussenin (insert)
Je kan een lijn wissen(Clear Line) of de ganse sheet wissen (New Sheet)
Je kan lijnen verschijven, als blijkt dat je volgorde niet correct werkt
Heb je wat fout gedaan, dan is Undo een laatste redmiddel, waarbij de laatst bewaarde stand wordt terug gehaald (niet de laatste correctie!)
Met Load en Save kan je je lijst bewaren, delen met collega's en terug ophalen voor hergebruik of om een variante te maken.

2.3 Make BAT

Met Make BAT maak je een windows batch file aan, die je nadien kan uitvoeren.

De commando's die niet zijn aangeduid in de Bat kolom, worden niet over genomen in de gegenereerde bat file.

Het gebruik van een bat file laat je toe om deze nadien te koppelen aan knoppen en zo je automatisering van je station verder te vervolmaken. (Zie VoiceMeter Macro buttons)

BAT commando's

Binnen de BAT file, maar ook voor de Multi run zijn er een aantal specifieke commando's die nuttig kunnen zijn. Al deze commando's beginnen met het @ teken

@REM
Dit commando laat je toe om commentaar in je bat file te schrijven
@SET
Laat je toe om een variabele te definiëren, vb @SET PTT=5, wat bijvoorbeeld op 5 seconden slaat in het volgende commando
@TIMEOUT /T %PTT%
Dit zorgt ervoor dat de uitvoering voor een bepaalde tijd gestopt wordt.
In dit voorbeeld is de tijd gedefinieerd in de variabele PTT, zodat je deze centraal kan aanpassen.
Ook de Multi run maakt hiervan gebruik en kan op deze wijze dienst doen als eindproef alvorens de bat file gemaakt wordt.

3 Voorbeeld xCATcmd files

Voor specifieke settings van andere transceivers, zie Andere transceivers

In onderstaande folder kan je voorbeelden vinden, die je zelf kan downloaden en aanpassen naar je eigen situatie.
In veel gevallen kan je een sequentie hergebruiken op nagenoeg alle toestellen omdat de volgorde van instellen zowat overal hetzelfde is, maar dien je per commando, specifiek te kijken welk CAT command met jou specifiek toestel en firmware overeen stemt.

4 Autostart profiel DWS

Het is mogelijk om de batch file aan te vullen met het automatisch opstarten van een programma.

Ook DWS heeft deze voorziening, waardoor je de batch file kan gebruiken voor het instellen van je transceiver en het opstarten van DWS in een specifiek profiel.

Onderaan de FT991A-VHF-ONLY batch file worden volgende lijnen toegevoegd.

rem Start DWC op met het correcte profiel.

timeout /t 5 /nobreak >nul

start "" "C:\Program Files (x86)\PA7RHM\DWC\dwc.exe" autorun profile=FT991A-VHF-ONLY mode=winlinkexpress

Deze toevoeging zorgt ervoor dat DWS wordt gestart na een vertraging van 5 seconden met het profiel FT991A-VHF-ONLY als gebruiker (winlinkespress mode)

Door deze batchfile te koppelen aan Voice Meter macrobutton kan je zo met een enkele toetsdruk, de mode van je transceiver omzetten en DWS opstarten in het juiste profiel. (voorbeeld VHF-144850.BAT)

Zie ..../tipstrics/dx-commander#Voicemeter maro buttons

xcatcmd4.mp4