Tekniset lisäasetukset

Web Radio Controlin-palvelinohjelmiston toimintaa voi mukauttaa teknisillä lisäasetuksilla erityistarpeisiin. Tavallisessa käytössä näihin asetuksiin ei yleensä tarvita muutoksia!

Laitetyyppikohtaiset lisäasetukset

Web Radio Controlin konfiguraatiotiedostossa voi määritellä laitetyyppikohtaisia asetuksia. Näitä asetuksia ovat esimerkiksi laitteen tilan päivitystiheys (poll period), joka määrittää kuinka usein kunkin laitetyypin tilatiedot päivittyvät Web Radio Controlin käyttöliittymässä.

Voit muuttaa näitä asetuksia lisäämällä yhden tai useampia alla olevista määrittelyistä konfiguraatiotiedoston loppuun:

radio:
  pollPeriod: 500ms
  meterPollPeriod: 100ms
  pttTimeout: 3m
  pttDisabled: false

rotator:
  pollPeriod: 500ms

antennaSwitch:
  pollPeriod: 1000ms

externalDevice:
  pollPeriod: 1000ms

Yllämainitut asetusten arvot ovat oletusarvoja.

  • pollPeriod - Määrittää aikavälin kyseisen laitetyypin tilan lukemiseen. Web Radio Controlin käyttöliittymä päivittyy tämän aikavälin mukaisesti. Päivittyviä tilatietoja ovat esimerkiksi VFO-taajuus, antenninkääntäjän suunta, antennikytkimen valittu antenni ja etäohjattujen releiden tila.

  • meterPollPeriod - Määrittää aikavälin radion mittaritietojen päivittämiselle radion ohjausnäkymässä. Huomaa myös, että itse mittaritietojen lukeminen kestää jonkin ajan ja tämä asetus määrittelee ainoastaan ajan tietojen lukemisen välillä.

  • pttTimeout - Pisin sallittu lähetysaika radiolle eli maksimiaika, jonka PTT saa olla kytkettynä päälle. Web Radio Control seuraa radion aikaa, jonka radion lähetys on päällä ja jos päälläoloaika ylittää tämän asetuksen rajan, Web Radio Control kytkee lähetyksen automaattisesti pois päältä. Tämä asetus vaikuttaa myös suoraan Hamlib-ohjaukseen wrc-proxy-apuohjelman kautta, joten rajoitus koskee myös digimoodien workkimista.

  • pttDisabled - Arvo true estää lähetyksen (PTT) käyttämisen radion ohjausnäkymässä kaikille radioille. Tämä asetus ei kuitenkaan vaikuta suoraan Hamlib-ohjaukseen wrc-proxy-apuohjelman kautta.

Radiolaitteiden lisäasetukset

Radiolaitteille on myös radiokohtaisia lisäaseutksia.

Voit muuttaa näitä asetuksia lisäämällä alla esitettyjä yksittäisiä määrityksiä haluamasi radion asetuksiin Web Radio Controlin konfiguraatiotiedostossa:

devices:
- id: "radio1-id"
  type: "rigctld"
  pttMode: "DEFAULT"
  pttDisabled: false

Yllämainitut asetusten arvot ovat oletusarvoja.

  • pttMode - Joissakin radiomalleissa, kuten Kenwood TS-480, on mahdollista valita käytettävä audiosisääntulo lähetystä varten jokaisen lähetyskomennon yhteydessä. Jos käytät tällaista radiomallia, voit valita audiosisääntuloksi mikrofonin arvolla MIC ja ulkoisen data-liittimen arvolla DATA. Käytä arvoa DEFAULT muille radiomalleille.

  • pttDisabled - Arvo true estää lähetyksen (PTT) käyttämisen radion ohjausnäkymässä tälle radiolle. Tämä asetus ei kuitenkaan vaikuta suoraan Hamlib-ohjaukseen wrc-proxy-apuohjelman kautta.

Sähkötyksen lisäasetukset

Web Radio Controlin ohjelmistopohjaiselle sähkötykselle on lisäasetuksia, joilla voi tarkemmin säätää avainnuksen ajoitukseen liittyviä yksityiskohtia. Nämä asetukset ohjaavat sähkötyksen tarkkuutta sekä viiveitä ja puskurointia, jota tarvitaan korjaamaan verkonliikenteen latenssin vaihtelusta (eli jitteristä) johtuvaa ajastuksen epätarkkuutta.

Voit muuttaa näitä asetuksia lisäämällä yhden tai useampia alla olevista määrittelyistä konfiguraatiotiedoston loppuun:

... (continued)
morseKeyer:
  tickPeriod: 5ms
  bufferTickCount: 1000
  delayTickCount: 60
  pttTimeoutTickCount: 100
... (continued)

Yllämainitut asetusten arvot ovat oletusarvoja.

  • tickPeriod - Tämä asetus määrittää minimiaikavälin sähkötysavaimen kytkemiselle päälle/pois. Oletusaikaväli on 5 sekuntia, joka tarkoitaa, että lyhyin aika sähkötyksen pisteelle (dit) on 5 millisekuntia. Jos tämän asetuksen arvo on liian pieni, sähkötyksen ajastuksesta voi tulla epätarkkaa.

  • bufferTickCount - Web Radio Control tallettaa sähkötysavaimen painallukset (päälle/pois) puskuriin väliaikaisesti, jotta verkkoliikenteen latenssin vaihtelut (eli jitter) eivät vaikuttaisi radiolla avainnettuun sähkötykseen. Tämä asetus määrittää puskurin koon tick-aikaväleinä. Puskurin koko tulee olla reilusti suurempi kuin delayTickCount- ja pttTimeoutTickCount- asetusten summa.

  • delayTickCount - Tämä asetus määrittelee sähkötysavaimen painallusten (päälle/pois) puskuroinnin ajan ennen kuin Web Radio Control lähettää painallukset avainnettavaksi radiolle. Pienemmällä puskurin koolla sähkötys lähetetään aiemmin, mutta pieni puskurin koko voi johtaa virheisiin sähkötyksessä, jos verkkoliikenteen latenssi vaihtelee liikaa. Oletusaika puskuroinnille on 300 millisekuntia (60 tick-aikaväliä 5 millisekunnin tick-määrityksellä).

  • pttTimeoutTickCount - Tämä asetus määrittelee ajan, jolloin PTT (lähetys) pysyy päällä sähkötyksen lopettamisen jälkeen. Asetusta käytetään ainoastaan, kun PTT-ohjaus on kytketty päälle sähkötyksen käyttöliittymässä. PTT-ohjausta tarvitaan yleensä vain vanhemmille radiomalleille, joissa ei ole tukea automaattiselle full- tai semi-break-in-toiminnoille. Oletusarvo on 500 millisekuntia (100 tick-aikaväliä 5 millisekunnin tick-määrityksellä).

Opus-audiokoodekin pakkauksen lisäasetukset

Web Radio Control käyttää äänen siirtämiseen WebRTC-standardiin sisältyvää Opus-audiokoodekkia.

Seuraavilla lisäasetuksilla voi vaikuttaa radiolta vastaanotettavan äänen laatuun ja latenssiin:

defaults:
  device:
    media:
      stream:
        audioInputEncoding:
          opus:
            bitrateType: "vbr"
            bitrate: 64000
            bandwidth: "wideband"
            complexity: 4
            frameSize: 10
  • bitrateType - Opus-audiokoodekin käyttämä pakkaustapa.

    Sallitut arvot:

    • vbr - Variable Bit Rate (suositeltu, Web Radio Controlin oletusasetus)

    • cbr - Constant Bit Rate

    • constrained-vbr - Constrained Variable Bit Rate

  • bitrate - Opus-audiokoodekin audion laatu ja tietoliikenteen kaistan leveys bitteinä sekunnissa radiolla vastaanotettua audiota varten.

    Sallitut arvot: 4000 - 650000 (Web Radio Controlin oletusarvo on 64000)

    Koodekin kehittäjien antamat ohjearvot bitrate-asetukselle ovat:

    • 6000 -10000 - Kapean kaistanleveyden audio HF/VHF-radioille

    • 10000-24000 - VoIP käyttöön (narrowband audio)

    • 24000-32000 - VoIP käyttöön (fullband audio)

    • 64000-96000 - Musiikin streamaus, riittänee kaikkeen radiokäyttöön, myös digimoodeihin

  • bandwidth - Opus-audiokoodekin käyttämän audiokaistan laajuus.

    Sallitut arvot:

    • auto - Automaattinen

    • fullband - Full band: audiokaista 20 kHz, vastaava näytteenottotaajuus 48 kHz

    • superwideband - Super wide band: audiokaista 12 kHz, vastaava näytteenottotaajuus 24 kHz

    • wideband - Wide band: audiokaista 8 kHz, vastaava näytteenottotaajuus 16 kHz (Web Radio Controlin oletusasetus)

    • mediumband - Medium band: audiokaista 6 kHz, vastaava näytteenottotaajuus 12 kHz

    • narrowband - Narrow band: audiokaista 4 kHz, vastaava näytteenottotaajuus 8 kHz

  • complexity - Opus-audiokoodekin pakkausalgoritmin tehokkuusaste. Tämä asetus vaikuttaa käytettyyn prosessointitehoon ja äänen laatuun. Arvo 10 kuluttaa eniten CPU-aikaa ja tuottaa parhaan äänenlaadun.

    Sallitut arvot: 0-10 (Web Radio Controlin oletusarvo on 4)

  • frameSize - Opus-audiokoodekin audiodatan kehyksen (frame) koko millisekunteina. Tämä asetus vaikuttaa audion latenssiin, mutta toisaalta myös audion vaatimaan kaistanleveyteen tietoliikenteessä.

    Sallitut arvot: 2.5, 5, 10, 20, 40, 60 (Web Radio Controlin oletusarvo on 10)

Lisätietoja Opus-audiokoodekin parametreista: https://wiki.xiph.org/Opus_Recommended_Settings