rigctl - Online in de cloud

PROGRAMMA:

NAAM

rigctl - controle radiozendontvangers en ontvangers

KORTE INHOUD

rigctl [OPTIE]... [COMMAND] ...

PRODUCTBESCHRIJVING

Bedien radiozendontvangers en -ontvangers. rigctl accepteert commando's vanaf de opdrachtregel
evenals in de interactieve modus als er geen op de opdrachtregel staat.

Houd in gedachten dat Hamlib is software op BETA-niveau. Hoewel veel backend-bibliotheken ontbreken
volledige rig-ondersteuning, de basisfuncties worden meestal goed ondersteund. De API kan veranderen
zonder gepubliceerde kennisgeving, terwijl een verbetering van de secundaire versie (bijv. 1.1.x naar 1.2.x)
wijst op een dergelijke verandering.

Rapporteer bugs en geef feedback op het e-mailadres vermeld in de RAPPORTAGE BUGS
sectie. Patches en codeverbeteringen zijn ook welkom.

OPTIES

Dit programma volgt de gebruikelijke GNU-opdrachtregelsyntaxis, met lange opties die beginnen met
twee streepjes (`-').

Hier is een overzicht van de ondersteunde opties:

-M, --model=id
Selecteer het modelnummer van de radio. Zie modellenlijst (gebruik 'rigctl -l').

NB: rigctl (of software van derden) gebruikt rig model 1901 bij gebruik rpc.rigd or
rig model 2 voor NET rigctl (rigctld).

-R, --rig-file=apparaat
Te gebruiken apparaat als de bestandsnaam van de poort waarop de radio is aangesloten. Vaak een serie
poort, maar kan een USB-naar-serieel-adapter zijn. Meestal /dev/ttyS0, /dev/ttyS1,
/dev/ttyUSB0, enz. op Linux of COM1, COM2, enz. op Win32.

Wordt ook gebruikt om de host en poort op te geven waarmee verbinding moet worden gemaakt met een luisterende rotctld-daemon
POSIX:

-r lokale host:4532

en op Win32:

-r 127.0.0.1:4532

-P, --ptt-file=apparaat
Te gebruiken apparaat als de bestandsnaam van het Push-To-Talk-apparaat met behulp van een apparaatbestand als
hierboven omschreven.

-NS, --dcd-bestand=apparaat
Te gebruiken apparaat als de bestandsnaam van het Data Carrier Detect-apparaat met behulp van een apparaatbestand
zoals hierboven beschreven.

-P, --ptt-type=type
Te gebruiken type dan: van een Push-To-Talk-apparaat. Ondersteunde typen zijn RIG, DTR, RTS, PARALLEL,
GEEN, overschrijvend PTT-type gedefinieerd in de backend van het platform.

Enkele bijwerkingen van deze opdracht zijn dat wanneer het type is ingesteld op DTR, de PTT-status wordt gelezen
komt van de Hamlib-frontend, niet gelezen van de radio. Indien ingesteld op GEEN, PTT-status
kan niet worden gelezen of ingesteld, zelfs niet als de rig-backend het lezen/instellen van de PTT-status ondersteunt
het tuig.

-NS, --dcd-type=type
Te gebruiken type dan: van het Data Carrier Detec-apparaat. Ondersteunde typen zijn RIG, DSR, CTS, CD,
PARALLEL, GEEN.

-Ja, --seriële snelheid = baud
Zet de seriële snelheid op baud tarief. Gebruikt maximale seriële snelheid van rig-backend
mogelijkheden als standaard.

-C, --civaddr=id
Te gebruiken id als het CI-V-adres om met de rig te communiceren. Alleen nuttig voor Icom-rigs.

NB: de id is in decimale notatie, tenzij voorafgegaan door 0x, in welk geval het is
hexadecimaal.

-T, --send-cmd-term=char
Wijzig de beëindiging verkolen voor tekstprotocol bij gebruik van de stuur_cmd opdracht. De
standaardwaarde is (0x0d). Niet-ASCII-afdrukbare tekens kunnen worden opgegeven als een
ASCII-nummer, in hexadecimaal formaat, voorafgegaan door 0x. Je mag een lege passeren
string voor geen beëindigingskarakter. De string '-1' vertelt rigctl om over te schakelen naar binair
protocol. Zie de stuur_cmd commando voor verdere uitleg.

Als u bijvoorbeeld een opdrachtterminator wilt opgeven voor het doorgeven van tekstopdrachten in Kenwood-stijl
"-t ';'" naar rigctl. Zie VOORBEELDEN hieronder.

-L, --show-conf
Maak een lijst van alle configuratieparameters voor de radio gedefinieerd met -m hierboven.

-C, --set-conf=parm=waarde[,parm=waarde]*
Configuratieparameter instellen. bijv. stop_bits=2

Gebruik de optie -L voor een lijst.

-ik, --lijst
Maak een lijst van alle modelnummers die zijn gedefinieerd in Hamlib en uitgang. Vanaf 1.2.15.1 is de lijst hetzelfde
gesorteerd op modelnummer.

NB In Linux kan de lijst teruggebladerd worden met Shift-PageUp/Shift-PageDown, of
met behulp van de schuifbalken van een virtuele terminal in X of het cmd-venster in Windows. De
uitvoer kan worden doorgesluisd naar 'meer' of 'minder', bijvoorbeeld 'rigctl -l | meer'.

-u, --dump-caps
Dump mogelijkheden voor de radio gedefinieerd met -m hierboven en sluit af.

-O, --vvo
Stel de vfo-modus in, waarbij een extra VFO-argument vereist is vóór elk passend commando.
Anders wordt VFO_CURR aangenomen als deze optie niet is ingesteld.

-in, --uitgebreid
Stel de uitgebreide modus in, cumulatief (zie DIAGNOSTIEK hieronder).

-H, --help
Toon samenvatting van deze opties en sluit af.

-V, --versie
Toon versie van rigctl en verlaat.

NB Sommige opties worden mogelijk niet geïmplementeerd door een bepaalde backend en geven een foutmelding.
Dit komt het meest voor bij de --set-conf en --show-conf opties.

Houd er rekening mee dat de backend voor de radio aangestuurd kan worden, of de radio zelf mogelijk niet
ondersteuning voor sommige commando's. In dat geval mislukt de bewerking met a Hamlib foutcode.

COMMANDO'S

Commando's kunnen worden ingevoerd als een enkel teken, of als een lange commandonaam. In principe,
de commando's staan ​​niet vooraan op de commandoregel, zoals de opties wel doen.
Ze kunnen worden ingetypt in de interactieve modus of worden opgegeven als argument(en) op de opdrachtregel
interface-modus.

Omdat de meeste Hamlib operaties hebben een reeks en krijgen methode, een hoofdletter wel
wordt gebruikt voor reeks methode, terwijl de overeenkomstige kleine letter verwijst naar de krijgen
methode. Elke bewerking heeft ook een lange naam; in de interactieve modus voegt u een backslash toe
voer een lange opdrachtnaam in.

Voorbeeld: Gebruik "\dump_caps" om te zien wat deze radio kan doen.

Houd er rekening mee dat de backend voor de radio aangestuurd kan worden, of de radio zelf mogelijk niet
ondersteuning voor sommige commando's. In dat geval mislukt de bewerking met a Hamlib foutmelding.

Hier is een samenvatting van de ondersteunde commando's (in het geval van "set"-commando's de aangehaalde
string wordt vervangen door de waarde in de beschrijving. In het geval van "get"-opdrachten wordt de
tekenreeks tussen aanhalingstekens is de sleutelnaam van de geretourneerde waarde.):

Q|q, afrit rigctl
Sluit rigctl af in de interactieve modus.

Wanneer rigctl de rig rechtstreeks bestuurt, worden de backend en poort van de rig gesloten.
Wanneer rigctl is verbonden met rigctld (rig model 2), wordt de TCP/IP-verbinding met rigctld
is gesloten en rigctld blijft actief, beschikbaar voor een ander TCP/IP-netwerk
verbinding.

F, set_freq 'Frequentie'
Stel 'Frequentie' in, in Hz.

f, get_freq
Haal 'Frequentie' op, in Hz.

M, set_mode 'Modus' 'Passband'
'Modus' instellen: USB, LSB, CW, CWR, RTTY, RTTYR, AM, FM, WFM, AMS, PKTLSB, PKTUSB,
PKTFM, ECSSUSB, ECSSLSB, FAX, SAM, SAL, SAH, DSB.

Stel 'Passband' in Hz in, of '0' voor de standaard Hamlib-backend.

m, get_mode
Verkrijg 'Modus' 'Passband'.

Retourneert Mode als een tekenreeks uit set_mode hierboven en doorlaatband in Hz.

V, set_vfo 'VFO'
Stel 'VFO' in: VFOA, VFOB, VFOC, currVFO, VFO, MEM, Hoofd, Sub, TX, RX.

In de VFO-modus is slechts één VFO-parameter vereist.

v, krijg_vfo
Krijg huidige 'VFO'.

Retourneert VFO als een tekenreeks uit set_vfo bovenstaand.

J, set_rit 'RIT'
De instelling 'RIT', in Hz, kan + of - zijn.

Een waarde van '0' reset RIT en *moet* RIT uitschakelen. Als dit niet het geval is, dient u een bugrapport in
tegen de Hamlib-backend.

j, krijg_rit
Haal 'RIT' op, in Hz.

Z, set_exit 'XIT'
Stel 'XIT' in, in Hz kan + of - zijn.

Een waarde van '0' reset RIT en *moet* RIT uitschakelen. Als dit niet het geval is, dient u een bugrapport in
tegen de Hamlib-backend.

z, get_exit
Haal 'XIT' op, in Hz.

T, set_ptt 'PTT'
Stel 'PTT', 0 (RX), 1 (TX), 2 (TX microfoon), 3 (TX-gegevens) in.

t, krijg_ptt
Krijg de 'PTT'-status.

0x8b, krijg_dcd
Krijg de status 'DCD' (squelch), 0 (gesloten) of 1 (open)

R, set_rptr_shift 'Rptr Verschuiving'
Stel 'Rptr Shift' in: "+", "-" of iets anders voor niets.

r, get_rptr_shift
Verkrijg 'Rptr Shift'. Retourneert "+", "-" of "Geen".

O, set_rptr_offs 'Rptr Offset'
Stel 'Rptr Offset' in, in Hz.

o, get_rptr_offs
Verkrijg 'Rptr Offset', in Hz.

C, set_ctcss_toon 'CTCSS Toon'
Stel 'CTCSS Tone' in, in tienden van Hz.

c, get_ctcss_toon
Verkrijg 'CTCSS Tone', in tienden van Hz.

D, set_dcs_code 'DCS Code'
Stel 'DCS-code' in.

d, get_dcs_code
Krijg 'DCS-code'.

0x90, set_ctcss_sql 'CTCSS SQL'
Stel de 'CTCSS Sql'-toon in, in tienden van Hz.

0x91, get_ctcss_sql
Krijg de 'CTCSS Sql'-toon, in tienden van Hz.

0x92, set_dcs_sql 'DCS SQL'
Stel 'DCS SQL'-code in.

0x93, get_dcs_sql
Haal 'DCS SQL'-code op.

I, set_split_freq 'Tx Frequentie'
Stel 'TX-frequentie' in, in Hz.

i, get_split_freq
Verkrijg 'TX-frequentie', in Hz.

X, set_split_mode 'TX Modus' 'TX Doorlaatband'
'TX-modus' instellen: AM, FM, CW, CWR, USB, LSB, RTTY, RTTYR, WFM, AMS, PKTLSB, PKTUSB,
PKTFM, ECSSUSB, ECSSLSB, FAX, SAM, SAL, SAH, DSB.

De 'TX Passband' is de exacte doorlaatband in Hz, of '0' voor de Hamlib-backend
standaard.

x, get_split_mode
Verkrijg 'TX Mode' en 'TX Passband'.

Retourneert de TX-modus als een tekenreeks uit set_split_mode hierboven en TX-doorlaatband in Hz.

S, set_split_vfo 'Gesplitst' 'TX VFO'
Stel de 'Split'-modus, '0' of '1', en 'TX VFO' in set_vfo bovenstaand.

s, get_split_vfo
Krijg 'Split'-modus,'0' of '1', en'TX VFO'.

N, set_ts 'Afstemmen Stap'
Stel 'Tuning Step' in, in Hz.

n, krijg_ts
Verkrijg 'Tuning Step', in Hz.

U, set_functie 'Func' 'Func Toestand'
Stel 'Func' 'Func Status' in.

Func is een van: FAGC, NB, COMP, VOX, TONE, TSQL, SBKIN, FBKIN, ANF, NR, AIP, APF,
MON, MN, RF, ARO, LOCK, MUTE, VSC, REV, SQL, ABM, BC, MBC, AFC, SATMODE, SCOPE,
HERVATTEN, TBURST, TUNER.

Het Func Status-argument is een niet-nullwaarde voor "activeren", "deactiveren", anders
net als TRUE/FALSE-definities in C-taal.

u, get_func
Krijg 'Func' 'Func-status'.

Retourneert Func als een tekenreeks uit set_functie hierboven en Func-status als een niet-null-waarde.

L, set_niveau 'Niveau' 'Niveau Waarde'
Stel 'Niveau' en 'Niveauwaarde' in.

Niveau is een van: PREAMP, ATT, VOX, AF, RF, SQL, IF, APF, NR, PBT_IN, PBT_OUT,
CWPITCH, RFPOWER, MICGAIN, KEYSPD, NOTCHF, COMP, AGC (0:UIT, 1:SUPERSNEL, 2:SNEL,
3:LANGZAAM, 4:GEBRUIKER, 5:MEDIUM, 6:AUTO), BKINDL, BAL, METER, VOXGAIN, ANTIVOX, SLOPE_LOW,
SLOPE_HIGH, RAWSTR, SWR, ALC, STERKTE.

De niveauwaarde kan een float of een geheel getal zijn.

l, get_niveau
Haal 'Niveau' 'Niveauwaarde' op.

Retourneert Niveau als een tekenreeks uit set_niveau boven en niveauwaarde als float of
geheel getal.

P, set_parm 'Parm' 'Parm Waarde'
Stel 'Parm' 'Parm-waarde' in

Parm is een van: ANN, APO, BACKLIGHT, BEEP, TIME, BAT, KEYLIGHT.

p, haal_parm
Haal 'Parm' 'Parm-waarde' op.

Retourneert Parm als een tekenreeks uit set_parm hierboven en Parm-waarde als float of geheel getal.

B, set_bank 'Bank'
Stel 'Bank' in. Stelt het huidige geheugenbanknummer in.

E, set_mem 'Geheugen#'
Stel het kanaalnummer 'Memory#' in.

e, get_mem
Haal het kanaalnummer 'Memory#' op.

G, vfo_op 'Mem/VFO op'
Voer 'Mem/VFO Op' uit.

Mem VFO-bewerking is een van: CPY, XCHG, FROM_VFO, TO_VFO, MCL, UP, DOWN, BAND_UP,
BAND_DOWN, LINKS, RECHTS, TUNE, TOGGLE.

g, aftasten 'Scannen Fct' 'Scannen Kanaal'
Voer 'Scan Fct' 'Scan Kanaal' uit.

Scanfunctie/kanaal is een van: STOP, MEM, SLCT, PRIO, PROG, DELTA, VFO, PLT.

H, set_kanaal 'Kanaal'
Geheugen 'Kanaal'-gegevens instellen. Nog niet geïmplementeerd.

h, krijg_kanaal
Haal geheugen-'Kanaal'-gegevens op. Nog niet geïmplementeerd.

A, set_trn 'Transceive'
Stel de 'Transceive'-modus in (rapportagegebeurtenis): OFF, RIG, POLL.

a, get_trn
Verkrijg de 'Transceive'-modus (rapportagegebeurtenis) zoals in set_trn bovenstaand.

Y, set_ant 'Antenne'
Stel het 'Antenne'-nummer in (0, 1, 2, ..).

y, krijg_mier
Krijg het 'Antenne'-nummer (0, 1, 2, ..).

*, opnieuw in te stellen 'Resetten'
Voer rig 'Reset' uit.

0 = Geen, 1 = Softwarereset, 2 = VFO-reset, 4 = Geheugen wissen reset, 8 = Master
opnieuw instellen. Omdat deze waarden in rig.h als bitmasker zijn gedefinieerd, zou dit mogelijk moeten zijn
naar EN deze waarden samen om meerdere resets tegelijk uit te voeren, als de backend dit ondersteunt
het of ondersteunt überhaupt een resetactie via rig control.

b, verzend_morse 'Morse'
Stuur 'Morse'-symbolen.

0x87, set_powerstat 'Stroom Toestand'
Zet de voeding aan/uit/stand-by 'Power Status'.

0 = Uitgeschakeld, 1 = Ingeschakeld, 2 = Stand-by. Gedefinieerd als een bitmasker in rig.h.

0x88, get_powerstat
Schakel de stroom in/uit/stand-by 'Energiestatus' zoals in set_powerstat bovenstaand.

0x89, stuur_dtmf 'Cijfers'
Stel DTMF 'Cijfers' in.

0x8a, recv_dtmf
DTMF 'Cijfers' ophalen.

_, informatie verkrijgen
Ontvang diverse informatie over de rig (geen VFO in 'VFO-modus' of waarde wordt doorgegeven).

1, dump_caps
Het is geen echt extern commando voor een rig, het dumpt alleen de mogelijkheden, dat wil zeggen wat de backend is
kent dit model en wat het kan doen.

TODO: Zorg ervoor dat dit een consistent formaat heeft, zodat het in een hash kan worden gelezen,
woordenboek, enz. Bugrapporten gevraagd.

NB: Deze opdracht produceert veel uitvoerregels, dus wees zeer voorzichtig als u a gebruikt
array met vaste lengte! Voer deze opdracht bijvoorbeeld uit tegen de Dummy-backend
resulteert in meer dan 5 kB aan tekstuitvoer.

VFO-parameter wordt niet gebruikt in 'VFO-modus'.

2, vermogen2mW 'Stroom [0.0..1.0]' 'Frequentie' 'Modus'
Retourneert 'Vermogen mW'

Converteert een Power-waarde binnen een bereik van 0.0 ... 1.0 naar het werkelijke zendvermogen in
milliwatt (geheel getal). De frequentie en mode moet ook als uitvoer worden opgegeven
het vermogen kan variëren afhankelijk van deze waarden.

VFO-parameter wordt niet gebruikt in 'VFO-modus'.

4, mW2vermogen 'Stroom mW' 'Frequentie' 'Modus'
Retourneert 'Vermogen [0.0..1.0]'

Converteert het werkelijke zendvermogen in milliwatt (geheel getal) naar een vermogenswaarde in a
waaier van 0.0 ... 1.0. De frequentie en mode moet ook als uitvoer worden opgegeven
het vermogen kan variëren afhankelijk van deze waarden.

VFO-parameter wordt niet gebruikt in 'VFO-modus'.

w, stuur_cmd 'Cmd'
Stuur een onbewerkte opdrachtreeks naar de rig. Dit is handig voor het testen en oplossen van problemen met de installatie
opdrachten en reacties bij het ontwikkelen van een backend.

Voor binaire protocollen voert u waarden in als \0xAA\0xBB. Verwacht een 'antwoord' van de boorinstallatie
wat waarschijnlijk een binair blok of een ASCII-string zal zijn, afhankelijk van de installatie
protocol (zie de computerbesturingsdocumentatie van uw radio).

De opdrachtterminator, ingesteld door de verzend-cmd-term optie hierboven, zal elk beëindigen
commandoreeks verzonden naar de radio. Dit teken mag geen deel uitmaken van de invoer
string.

Voorbeelden

Start rigctl voor een Yaesu FT-920 met behulp van een USB naar serieel adapter op Linux in interactief
modus:

$ rigctl -m 114 -r /dev/ttyUSB1

Start rigctl voor een Yaesu FT-920 die COM1 op Win32 gebruikt terwijl TRACE-uitvoer wordt gegenereerd naar
stderr:

C:\> rigctl -m 114 -r COM1 -vvvvv

Start rigctl voor een Yaesu FT-920 met behulp van een USB naar serieel adapter tijdens het instellen van de baudrate en
stopbits:

$ rigctl -m 114 -r /dev/ttyUSB1 -s 4800 -C stop_bits=2

Start rigctl voor een Elecraft K3 met behulp van een USB-naar-serieel-adapter terwijl u een opdracht opgeeft
terminator voor het 'w'-commando:

$ rigctl -m 229 -r /dev/ttyUSB0 -t';'

Start rigctl gebruik rpc.rigd en het instellen van de frequentie en modus:

$ rigctl -m 1901 -r localhost F 7253500 M LSB 0

Maak verbinding met een hardloopsessie rigctld met rig model 2 ("NET rigctl") op de lokale host en
specificeren van de TCP-poort op POSIX:

$ rigctl -m 2 -r localhost:4532

en op Win32:

C:\> rigctl -m 2 -r 127.0.0.1:4532

DIAGNOSE

De -v, --uitgebreid optie maakt het mogelijk verschillende diagnoseniveaus uit te voeren naar: stderr en
komen overeen met -v voor BUG, ​​-vv voor ERR, -vvv voor WARN, -vvvv voor VERBOSE, of -vvvvv voor
SPOOR.

Een bepaald uitgebreid niveau is handig om de benodigde foutopsporingsinformatie aan de e-mail te geven
adres hieronder. TRACE-uitvoer toont bijvoorbeeld alle waarden die zijn verzonden naar en ontvangen
van de radio, wat erg handig is voor de ontwikkeling van radio-backendbibliotheken en mogelijk is:
gevraagd door de ontwikkelaars.

EXIT STATUS

rigctl uitgangen met:
0 als alle bewerkingen normaal zijn voltooid;
1 als er een ongeldige opdrachtregeloptie of -argument was;
2 als er een fout is geretourneerd door Hamlib.

Gebruik rigctl online met behulp van onworks.net-services