☰

Navigation :

3/5: Konfiguraatiotiedoston luominen

Vaihe 3/5: Konfiguraatiotiedoston luominen laitetietojen perusteella

Web Radio Controlin asennuskäyttöliittymän laitelistausnäkymä

  1. Lataa täydennettävä esimerkkikonfiguraatiotiedosto tietokoneellesi täältä: wrc-config-template.yaml

  2. Avaa tiedosto tekstieditorilla paikallisella tietokoneellasi.

  3. Paina List devices-nappia, jolloin asennuskäyttöliittymä hakee sarjaportti- ja audiolaitteiden tiedot ja näyttää ne omissa listauksissaan.

Esimerkkikonfiguraatio

Yllä mainitusta linkistä ladattavan esimerkkikonfiguraatiotiedoston sisältö:

global:
  uniqueSystemDeviceNames: false

server:
  publicHostname: "DOMAIN_NAME"
  ipv6: false
  lanMode: false

devices:
- id: "radio1-id"
  type: "rigctld"
  rigctld:
    localInstance:
      enabled: true
      model: RADIO_MODEL_NUMBER
      rigDevice: "SERIAL_PORT_DEVICE"
      serialSpeed: SERIAL_SPEED
  media:
    stream:
      audioInputDeviceName: "AUDIO_INPUT_DEVICE_NAME"
      audioOutputDeviceName: "AUDIO_OUTPUT_DEVICE_NAME"

Esimerkkikonfiguraatio on ladattavissa täältä: wrc-config-template.yaml

Konfiguraatiotiedoston täydentäminen

Korvaa tekstieditorissa esimerkkikonfiguraatiosta 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ä!

Osa nimiviitteistä riippuu käytössä olevasta radiosta ja lisälaitteista, joten niiden tiedot tulee selvittää asennuskäyttöliittymän List devices-listauksesta.

Konfiguraatiotiedoston asetukset

Korvattavat nimiviitteet ovat:

Yleiset asetukset ja verkkoasetukset

  • uniqueSystemDeviceNames - Tämän asetuksen voi jättää false-arvoon useimmissa tapauksissa, kun jokaista etäohjattavaa laitetyyppiä (kuten radio tai antenninkääntäjä) on vain yksi kappale. Tällä asetuksella on mahdollista käyttää useampia samanmallisia radioita tai muita lisälaitteita. Useamman samanmallisen tai saman valmistajan USB-laitteen kytkeminen voi johtaa päällekkäisyyksiin sarjaporttien tai audiolaitteiden nimissä, jolloin uniqueSystemDeviceNames- asetuksen kytkeminen päälle true-arvolla korjaa nämä päällekkäisyydet. Kun asetus on kytketty päälle, jokaisen etäohjattavan laitteen on oltava aina kytkettynä samaa USB-porttiin.

  • DOMAIN_NAME - Web Radio Control-palvelimen domain-nimi, jonka täytyy olla sama kuin TLS-sertifikaatissa.

  • ipv6 - Web Radio Control käyttää oletuksena IPv4-osoitteita. Jos etäohjausta halutaan käyttää IPv6-osoitteen kautta, kytke ipv6 päälle arvolla true. Tällöin myös DOMAIN_NAME-kohtaan määritellyn domain-nimen tulee osoittaa IPv6-osoitteeseen.

  • lanMode - Web Radio Control toimii oletuksena julkisessa Internetissä (arvo false). Jos etäohjausta halutaan käyttää suljetussa LAN-sisäverkossa, kytke lanMode päälle arvolla true. Tällöin käyttö julkisen Internetin kautta ei toimi.

Radion mallin asetukset

  • radio1-id - Vapaavalintainen ID-tunnus radiolle ohjelmaa varten. Tämän voit keksiä itse, mutta ID kannattaa olla mallin mukainen. HUOM! ID saa sisältää vain merkkejä A-Z, a-z ja 0-9. Esimerkki: ic7300

  • RADIO_MODEL_NUMBER - Radion mallinumero Hamlibin ohjausta varten. Mallinumeron voit etsiä joko asennuskäyttöliittymässä tuettujen radiomallien listasta kohdassa Supported radio device models (ks. alla oleva kuvakaappaus) tai ohjesivulta tuettujen radiomallien listasta. Valmistajat ja mallit on listattu aakkosjärjestyksessä. Esimerkki: 3073 (IC-7300:lle)

Esimerkkikuvakaappaus tuettujen radiomallien listasta asennuskäyttöliittymässä:

Esimerkkikuvakaappaus tuettujen radiomallien listasta asennuskäyttöliittymässä
Radion ohjauksen asetukset

  • SERIAL_PORT_DEVICE - Radion sarjaportin viite URI reference-viitteenä.

    Asennuskäyttöliittymä listaa kaikki sarjaportit kohdassa Serial ports (for device control) (ks. alla oleva kuvakaappaus). Kopioi radioa ohjaavan sarjaportin "URI reference"-tekstikentän sisältö tähän kohtaan. Viitteiden alussa on aina id:-etuliite.

    USB-adapterit tunnistaa listan Subsystem, bus-tietueen merkinnästä tty, usb. USB-liitännällä varustetuille radioille näkyy listauksessa yleensä radion malli ja jokin sarjanumero, mutta yleisesti ottaen USB-laitteilla ei ole välttämättä selkeitä tunnisteita. Useamman samanmallisen radion tai USB — RS-232-adapterin kanssa on vain kokeiltava mikä adapteri on oikea.

    Esimerkki: id:IC-7300_01234567

  • SERIAL_SPEED - Radion sarjaportin tietoliikenteen nopeus (baud rate). Valitse nopeus, jota radiomalli tukee. Esimerkki: 19200

Esimerkkikuvakaappaus kytkettyjen laitteiden sarjaporttien listauksesta asennuskäyttöliittymässä:

Esimerkkikuvakaappaus kytkettyjen laitteiden sarjaporttien listauksesta asennuskäyttöliittymässä
Radion audioasetukset

  • AUDIO_INPUT_DEVICE_NAME - Web Radio Control-palvelimen audiosisääntulo tälle radiolle (eli RX audio, radion kaiuttimista tuleva ääni). Valitse radioon liitetyn audiosisääntulon nimi asennuskäyttöliittymän kohdasta Audio inputs (from radio) (ks. alla oleva kuvakaappaus).

    Nimessä voi olla joitain viitteitä valmistajasta/radiosta tai sitten ei. Nimen alussa tulee olla merkkijono alsa_input.usb (USB-audiolaitteille).

    Esimerkki: alsa_input.usb-Burr-Brown_from_TI_USB_Audio_CODEC-00.analog-stereo

  • AUDIO_OUTPUT_DEVICE_NAME - Web Radio Control-palvelimen audioulostulo tälle radiolle (eli TX audio, radion mikrofonisisääntulo). Valitse radioon liitetyn audioulostulon nimi asennuskäyttöliittymän kohdasta Audio outputs (to radio) (ks. alla oleva kuvakaappaus).

    Nimessä voi olla joitain viitteitä valmistajasta/radiosta tai sitten ei. Nimen alussa tulee olla merkkijono alsa_output.usb (USB-audiolaitteille).

    Esimerkki: alsa_output.usb-Burr-Brown_from_TI_USB_Audio_CODEC-00.analog-stereo

Esimerkkikuvakaappaus kytkettyjen laitteiden audiosisääntuloista ja -ulostuloista:

Esimerkkikuvakaappaus kytkettyjen laitteiden audiosisääntuloista ja -ulostuloista

Tallenna konfiguraatiotiedosto

Tallenna lopuksi tekstieditorissa tekemäsi muutokset.

Esimerkki täydennetystä konfiguraatiotiedostosta

Alla on konfiguraation kirjoittamisen avuksi esimerkkikonfiguraatio IC-7300:lle.

Tätä konfiguraatiota ei voi luonnollisesti käyttää suoraan, koska radion ja audiolaitteiden nimet ovat laite- ja ympäristökohtaisia, mutta se antaa yleiskuvan miltä yhden radion konfiguraatio näyttää.

server:
  publicHostname: "my.domain.net"
  ipv6: false
  lanMode: false

devices:
- id: "ic7300"
  type: "rigctld"
  rigctld:
    localInstance:
      enabled: true
      model: 3073
      rigDevice: "id:IC-7300_01234567"
      serialSpeed: 115200
  media:
    stream:
      audioInputDeviceName: "alsa_input.usb-Burr-Brown_from_TI_USB_Audio_CODEC-00.analog-stereo"
      audioOutputDeviceName: "alsa_output.usb-Burr-Brown_from_TI_USB_Audio_CODEC-00.analog-stereo"

Radion lisäasetukset ja lisälaitteiden konfigurointi

Seuraavissa osioissa täydennetään konfiguraatiotiedostoa asetuksilla, joita voit tarvita riippuen radion mallista ja ohjattavista lisälaitteista.

Lisäasetuksia tarvitaan, jos:

  1. Radion PTT-ohjaus tapahtuu RS-232-sarjaportin RTS/DTR-kontrollilinjoilla.

  2. Haluat käyttää radion sähkötysominaisuuksia tai adapteria sähkötysavaimelle

  3. Käytät Dynamic DNS-palvelua valitsemallesi domain-nimelle ja haluat tehdä IP-päivitykset Web Radio Controlin avulla

  4. Haluat ohjata antenninkäätäjää eli rotaattoria

  5. Haluat ohjata antennikytkintä

  6. Kyseessä on ongelmatilanne, jossa radion CW-avainnus (yleensä erillisen interfacen kautta) jää päälle eikä radion ohjaus onnistu

Lisäasetusten dokumentaatio