Antennikytkinten ohjaus
Antennikytkinten ohjauksen konfigurointi
Web Radio Control voi ohjata antennikytkintä GPIO-pinnien kautta, jotka esim. Raspberry Pi-laitteissa löytyvät GPIO-header-liittimestä. Tarkempi kuvaus eri pinnien käyttötarkoituksista löytyy myös sivustolta pinout.xyz.
Voit ohjata GPIO-pinnien tiloja Web Radio Controlilla päälle- tai pois-tilaan. Tiloja vastaavat jännitteet ovat Raspberry Pi-laitteissa 3.3V (päälle) ja 0V (pois).
HUOM! GPIO-pinnit ovat herkkiä vaurioitumaan, koska ne on useimmissa laitteissa kytketty suoraan prosessorin GPIO-linjoihin ilman lisäsuojausta. Prosessorin ja GPIO-pinnien suojaamiseksi pinnit tulee aina kytkeä ulkoisiin laitteisiin etuvastuksella varustetun optoerottimen kautta. GPIO-pinnistä otettu virta tulee rajoittaa Raspberry Pi:ssä 16 mA:n alle ja kokonaisvirta kaikista käytetyistä GPIO-pinneistä 50 mA:n alle.
Kopioi alla oleva esimerkkikonfiguraatio tekstieditoriin, muokkaa sitä käyttöön tulevien GPIO-pinnien mukaisesti ja lisää se muokkauksen jälkeen konfiguraatiotiedoston loppuun. Seuraa esimerkin alla olevia ohjeita konfiguraation täydennystä varten.
antennaSwitches:
- id: "ANTENNA_SWITCH_ID"
name: "ANTENNA_SWITCH_NAME"
description: "ANTENNA_SWITCH_DESCRIPTION"
defaultChoiceId: "DEFAULT_CHOICE_ID"
choices:
- id: "ANTENNA_ID_1"
name: "ANTENNA_NAME_1"
description: "ANTENNA_DESCRIPTION_1"
switch:
name: "ANTENNA_GPIO_PIN_1"
- id: "ANTENNA_ID_2"
name: "ANTENNA_NAME_2"
description: "ANTENNA_DESCRIPTION_2"
switch:
name: "ANTENNA_GPIO_PIN_2"
Antennikytkinten konfiguraation täydentäminen
Korvaa tekstieditorissa edellä esitetystä konfiguraatiosta alla listatut nimiviitteet. Säilytä mahdolliset lainausmerkit nimiviitteiden ympärillä!
Konfiguraatiotiedosto on YAML-formaatissa, jossa välilyöntien määrällä on merkitystä. Jätä siis välilyöntien määrä ennalleen joka rivillä!
Seuraavat kohdat riippuvat antennikytkimessä käytettyjen GPIO-pinnien numeroista sekä niihin kytketyistä laitteista (kuvaustekstiä varten):
-
ANTENNA_SWITCH_ID
- Antennikytkimen ID ohjelmaa varten. Tämän voi keksiä itse, mutta sen kannattaa olla joko laitteen mallin mukainen tai numeroitu. HUOM! ID saa sisältää vain merkkejä A-Z, a-z ja 0-9. Esimerkki:switch1
-
ANTENNA_SWITCH_NAME
- Käyttöliittymässä näytettävä nimi antennikytkimelle -
ANTENNA_SWITCH_DESCRIPTION
- Käyttöliittymässä näytettävä kuvausteksti antennikytkimelle -
DEFAULT_CHOICE_ID
- Oletuksena valittuna olevan antennin ID-tunnus, kun mikään GPIO-pinni ei ole kytkettynä päälle. Tämä asetus tulee jättää tyhjäksi (vain lainausmerkit""
), jos antennikytkimessä voi jättää antennin kokonaan valitsematta esimerkiksi maadoittamista varten. Jos antennia ei voi jättää valitsematta, tämä asetus määrittää antennin, joka on oletuksena valittuna, kun antennikytkimelle ei tule ohjaussignaaleja.
Konfiguraation kohta choices
määrittää antennikytkimen valinnat eli minkä antennin voi valita milläkin GPIO-pinnillä.
Listaan voi lisätä kuinka monta antennia tahansa, mutta jokaisella antennilla on oltava yksilöivä ID-tunnus.
-
ANTENNA_ID_1
/ANTENNA_ID_2
/ … - Antennin yksilöivä ID-tunnus. Voi olla esimerkksi pelkkä numero"1"
,"2"
, jne. -
ANTENNA_NAME_1
/ANTENNA_NAME_2
/ … - Käyttöliittymässä näytettävä nimi kullekin antennille. -
ANTENNA_DESCRIPTION_1
/ANTENNA_DESCRIPTION_2
/ … - Käyttöliittymässä näytettävä kuvausteksti kullekin antennille. -
ANTENNA_GPIO_PIN_1
/ANTENNA_GPIO_PIN_2
/ … - Kyseisen antennin valintaan käytettävän GPIO-pinnin nimi. GPIO-pinnien nimet löytyvät asennuskäyttöliittymän listastaExternal hardware control switches
(ks. alla oleva kuvakaappaus). Esimerkiksi Raspberry Pi:n GPIO-pinnit on nimettyGPIOnn
, jossann
on pinnin numero, esim.GPIO17
.
Myös antennikytkimiä voi määritellä useampia antennaSwitches
listaan.
Esimerkkikuvakaappaus asennuskäyttöliittymän listauksesta, joka sisältää GPIO-pinnit sekä muut konfiguraatiossa määritellyt ohjattavat kytkimet, joita voi käyttää antennikytkimen ohjauksessa:
Esimerkki täydennetystä konfiguraatiotiedostosta
Alla on konfiguraation kirjoittamisen avuksi esimerkkikonfiguraatio kolmen antennin kytkimelle,
jossa on mahdollisuus jättää antenni kytkemättä (defaultChoiceId
jätetään tyhjäksi ""
).
Antennin valitseva GPIO-pinni määritellään switch
→ name
-kohdassa.
Tätä konfiguraatiota ei voi luonnollisesti käyttää suoraan, koska antennien tiedot ovat ympäristökohtaisia, mutta se antaa yleiskuvan miltä antennikytkimen konfiguraatio näyttää.
antennaSwitches:
- id: "switch1"
name: "Antennikytkin 1"
description: "Antennikytkin 1:n tarkempi kuvausteksti"
defaultChoiceId: ""
choices:
- id: "1"
name: "1 - Windom 10-160m"
description: "Lanka-antenni"
switch:
name: "GPIO17"
- id: "2"
name: "2 - TH-7DX"
description: "Beami 10, 15 ja 20 metrille"
switch:
name: "GPIO18"
- id: "3"
name: "3 - Cushcraft 40-2CD"
description: "Beami 40 metrille"
switch:
name: "GPIO27"
Antennikytkimen linkitys radioon
Antennikytkimen konfiguroinnin jälkeen voit ohjata antennin valintaa erillisessä antennikytkimenä ohjausnäkymässä Web Radio Controlin käyttöliittymässä. Vaikka antennin valinta onnistuukin tällä tavalla, voi olla hankalaa ja hidasta vaihtaa ohjausnäkymää radion ja antennikytkimen välillä, kun on tarve keskittyä itse radion etäkäyttöön.
Nopeuttaaksesi antennikytkimen käyttöä voit linkittää antennikytkimiä yhteen tai useampaan radioon Web Radio Controlissa. Kun antennikytkin on linkitetty radioon, radion ohjausnäkymässä näkyy radion mittarien yläpuolella alasvetovalikko antennivalinnalle. Valikko listaa antennikytkimen antennivalinnat ja voit vaihtaa aktiivista antennia valitsemalla yhden valikon antenneista.
Allaolevassa esimerkkikuvakaappauksessa on näkyvissä linkitetyn antenninvaihtajan alasvetovalikko radion ohjausnäkymässä.
Linkityksen konfigurointi radioille, joissa on vain yksi antenniliitin
Linkittääksesi antennikytkimen radioon, lisää konfiguraatiotiedoston devices
-kohtaan seuraavat määrittelyt radiolle,
jonka haluat linkittää antennikytkimeen (huomaa välilyöntien määrä):
linkedAntennaSwitches:
- id: "SWITCH_ID"
-
SWITCH_ID
- ID-nimiviite antennikytkimeen, joka linkitetään tähän radioon. Ylläolevan esimerkin tapauksessa ID olisiswitch1
.
Linkityksen konfigurointi radioille, joissa on useampi antenniliitin
Jos radiomallissasi on useampi antenniliitin, voit määritellä mihin radion antenniliittimeen antennikytkin on liitetty.
Antenniliitin määritellään antenninumeroilla, jotka näkyvät ANT-alasvetovalikossa VFO-taajuuden oikealla puolella.
Ensimmäisen antenniliittimen numero on 1
.
Linkittääksesi antennikytkimen radion tiettyyn antenniliittimeen,
lisää konfiguraatiotiedoston devices
-kohtaan seuraavat määrittelyt radiolle,
jonka haluat linkittää antennikytkimeen (huomaa välilyöntien määrä):
linkedAntennaSwitches:
- id: "SWITCH_ID"
antenna: ANTENNA_CONNECTOR_NUMBER
-
SWITCH_ID
- ID-nimiviite antennikytkimeen, joka linkitetään tähän radioon. Ylläolevan esimerkin tapauksessa ID olisiswitch1
. -
ANTENNA_CONENCTOR_NUMBER
- Numero sille antenniliittimelle, johon linkitettävä antennikytkin on liitetty. Ensimmäisen antenniliittimen numero on1
.
Esimerkki konfiguraatiosta, joka tarvitaan antennikytkimen linkittämiseen
Antennikytkimen linkityksen konfiguraatio voi olla esimerkiksi allaolevan esimerkin mukainen, kun antennikytkin on
liitetty radion antenniliittimeen numero 2
:
... (continued)
devices:
- id: "radio1-id"
type: "rigctld"
rigctld:
localInstance:
enabled: true
model: RADIO_MODEL_NUMBER
rigDevice: "SERIAL_PORT_DEVICE"
serialSpeed: SERIAL_SPEED
linkedAntennaSwitches:
- id: "switch1"
antenna: 2
... (continued)
... (continued)
antennaSwitches:
- id: "switch1"
name: "Antennikytkin 1"
description: "Antennikytkin 1:n tarkempi kuvausteksti"
... (continued)