2.0. Внимание: перед настройкой звуковой подсистемы AlterFRN клиента вам следует убедиться в общей работоспособности звуковой подсистемы вашего компьютера. Особенно это касается микрокомпьютеров и плат типа RaspberryPi/OrangePi/..., для которых некоторые сборки Linux могут не поддерживать звук. Воспользуйтесь штатными для вашей операционной системы программами(утилитами) для предварительной проверки работоспособности записи и воспроизведения звука. LINUX/UNIX-пользователь исполняющий AlterFRN-клиент, должен иметь права на чтение/запись в звуковые устройства вида /dev/dsp0 или /dev/snd/*.
2.1. Параметр InDevice - имя устройства ввода звука из радиостанции; смотри также примечания 2.17 и 2.18. Если вы используете несколько работающих копий AlterFRN-клиента одновременно на одной машине, то для избежания возможных конфликтов используйте разные входные звуковые устройства для каждой копии AlterFRN-клиента.
2.2. Параметр InSampleRate - частота дискретизации при вводе звука с радиостанции (Гц): 8000 (не требуется преобразование, наименьшая загрузка процессора), 11025, 12000, 16000, 22050, 24000, 32000, 44100 (по умолчанию, поддерживается почти всеми звуковыми картами), 48000. Смотри также примечание 2.21.
2.3. Параметр InQuality - управление качеством преобразования входной частоты дискретизации из параметра InSampleRate (2.2) в 8000Гц, используемыми в сжатом звуке FRN: 2.3.1. 0/NONE/NO/N - совсем без качества; 2.3.2. 1/LOW/LO/L - низкое качество; 2.3.3. 2/MEDIUM/MED/ME/M - среднее качество; 2.3.4. 3/HIGH/HI/H - высокое качество; самая высокая нагрузка процессора. 2.3.5. 4/SUPER/SU/S - [ревизия 6378+] высокое качество; не очень высокая нагрузка процессора; по умолчанию.
2.4. Параметр InFactor - показатель размера входного блока звуковой карты в 40-миллисекундных интервалах; допустимые значения: 1-5 (40-200 миллисекунд); рекомендуемое мной значение 1-2 (40-80 миллисекунд); по умолчанию - 2 (80 миллисекунд).
2.5. Параметр InPreCapturedTime - [ревизия r1783+] - время предварительно записанного звука в миллисекундах для компенсации возможной потери начала фразы из-за действия параметра CarrierCatchTime (3.8) в секции Radio (3); допустимые значения: 0 - 2000 мс; по умолчанию: 300 мс до ревизии r5000, 0 мс начиная с ревизии r5000.
2.6. Параметр InAgcEnabled - [ревизия r2241+] - разрешение на работу автоматической регулировки уровня АРУ(Automatic Gain Control - AGC) на передачу сигнала от радиостанции на сервер; допустимые значения: No (запрещен), Yes (разрешен); по умолчанию: No (запрещен). При включенном АРУ/AGC также бывает полезен ФВЧ (HPF), смотри также параметр InHpfEnabled (2.22). Не используйте АРУ/AGC при настройке уровней: АРУ/AGC предназначено только для работы на уже настроенной системе в качестве вспомогательного инструмента.
2.7. Параметр InAgcLevel - [ревизия r2241+] - максимальный уровень сигнала от радиостанции на сервер после АРУ/AGC в процентах; допустимые значения: 50 - 100; по умолчанию: 90; рекомендуемое по опыту значение: 99 - для наиболее полного использования динамического диапазона звуковой карты.
2.8. Параметр InAgcMaxGain - [ревизия r2241+] - максимальный коэффициент усиления АРУ/AGC для сигнала от радиостанции на сервер в децибеллах; допустимые значения: 0 - 60; по умолчанию: 30; рекомендуемое по опыту значение около 20 для компенсации возможной "мелкой" модуляции на радиостанциях.
2.9. Параметр OutDevice - имя устройства вывода звука на радиостанцию; смотри также примечания п.2.17 и п.2.18. Если вы используете несколько работающих копий AlterFRN-клиента одновременно на одной машине, то для избежания возможных конфликтов используйте разные выходные звуковые устройства для каждой копии AlterFRN-клиента.
2.10. Параметр OutSampleRate - частота дискретизации при выводе звука на радиостанцию (Гц): 8000 (не требуется преобразование, наименьшая загрузка процессора), 11025, 12000, 16000, 22050, 24000, 32000, 44100(по умолчанию, поддерживается почти всеми звуковыми картами), 48000. Смотри также примечание 2.21.
2.11. Параметр OutQuality - управление качеством преобразования частоты дискретизации из 8000Гц в выходную частоту (п.2.10 OutSampleRate): 2.11.1. 0/NONE/NO/N - совсем без качества; 2.11.2. 1/LOW/LO/L - низкое качество; 2.11.3. 2/MEDIUM/MED/ME/M - среднее качество; 2.11.4. 3/HIGH/HI/H - высокое качество; самая высокая нагрузка процессора. 2.11.5. 4/SUPER/SU/S - высокое качество; не очень высокая нагрузка процессора; по умолчанию.
2.12. Параметр OutFactor - показатель размера выходного блока звуковой карты в 40-миллисекундных интервалах; допустимые значения: 1-5 (40-200мс); рекомендуемое мной значение 1-2 (40-80мс); по умолчанию - 2(80мс).
2.13. Параметр OutAgcEnabled - [ревизия r2241+] - разрешение на работу автоматической регулировки уровня АРУ(AGC) на передачу сигнала с сервера на радиостанцию; допустимые значения: No - запрещен, Yes - разрешен; по умолчанию: No - запрещен. При включенном АРУ/AGC также бывает полезен фильтр высоких частот (ФВЧ/HPF): смотри параметр OutHpfEnabled. Не используйте АРУ/AGC при настройке уровней: АРУ/AGC предназначено только для работы на уже настроенной системе в качестве вспомогательного инструмента. Внимание: выходное АРУ/AGC никак не влияет на воспроизведение служебных и всех других заранее записанных звуков -- ваши звуковые файлы должны быть заранее подготовлены для воспроизведения в эфире с корректным или желаемым уровнем.
2.14. Параметр OutAgcLevel - [ревизия r2241+] - максимальный уровень сигнала с сервера на радиостанцию после АРУ/AGC в процентах; допустимые значения: 50-100; по умолчанию: 90;
2.15. Параметр OutAgcMaxGain - [ревизия r2241+] - максимальный коэффициент усиления АРУ/AGC для сигнала с сервера на радиостанцию в децибеллах; допустимые значения: 0 .. 60; по умолчанию: 30; рекомендуемое по опыту значение около 40 для компенсации возможной "мелкой" модуляции от корреспондентов с компьютеров и телефонов.
2.16. Установить конкретный разъем ввода и/или вывода звука и уровни на них помогут программы mixer(FreeBSD), amixer/alsamixer(Linux), или другое ваше любимое средство; см. также Качественная настройка звука от радиостанции.
2.17. Список доступных звуковых устройств можно получить командой audio (0.4.2);
2.18. Список доступных звуковых устройств в формате конфигурационного файла можно получить командой audioconfig (0.4.3);
2.20. Работоспособность входного (input, capture) звукового устройства напрямую влияет на упешное функционирование других подсистем, а именно: 2.20.1. - опроса сигнала несущей от радиостанции; смотри также параметр COS (3.2) в секции [Radio] (3); 2.20.2. - срабатывания часов; смотри также секцию [Hours] (10); 2.20.3. - срабатывания речевого информатора; смотри также секцию [Informer] (11);
2.21. Примечание: при использовании USB звуковых карт следует учитывать, что многие из них поддерживают весьма ограниченное количество частот дискретизации; проверить допустимые частоты дискретизации на конкретно вашей звуковой карте можно с помощью команд checkrate (0.4.6) и/или checkrateconfig (0.4.7);
2.22. Параметр InHpfEnabled - [ревизия r2781+] включение входного фильтра высоких частот (ФВЧ/HPF) с частотой среза 300Гц, который вырезает из звукового сигнала от радиостанции бесполезные и/или вредные низкочастотные составляющие; также увеличивает эффективность входного АРУ; допустимые значения: No, Yes; по умолчанию: No - отключен;
2.25. Параметр OutHpfEnabled - [ревизия r2781+] включение выходного фильтра высоких частот (ФВЧ/HPF) с частотой среза 300Гц, который вырезает из звукового сигнала от других корреспондентов с сервера на радиостанцию бесполезные и/или вредные низкочастотные составляющие; также увеличивает эффективность выходного АРУ; допустимые значения: No, Yes; по умолчанию: No (отключен); Внимание: выходной ФВЧ/HPF никак не влияет на воспроизведение служебных и всех других заранее записанных звуков -- ваши звуковые файлы должны быть заранее подготовлены для воспроизведения в эфире с корректной или желаемой амплитудно-частотной характеристикой (frequency response).
2.26. Параметр OutHpfOrder - [ревизия r2781+] порядок выходного фильтра высоких частот (ФВЧ/HPF); допустимые значения: 5-10; по умолчанию: 10;
2.28. Параметр InDtmfEnabled - [ревизия r3638+] включение DTMF-декодера на входном звуковом сигнале от радиостанции; нужен для последующего исполнения DTMF-команд; допустимые значения: No, Yes; по умолчанию: No - отключен. Смотри также параметры InDtmfQualityThreshold (2.31) и InDtmfSilenceThreshold (2.32).
Примечание: некоторые радиостанции могут иметь включенный на прием режекторный фильтр на частоту 1750 Гц, что сильно затрудняет распознавание частоты 1633Гц, поэтому не рекомендуется пользоваться DTMF-символами ABCD;
2.29. Параметр OutDelayConst - [ревизия r4967+] задержка в миллисекундах для компенсации запаздывания (latency) звуковой карты в случае, если программе не удалось корректно рассчитать такую компенсацию автоматически по данным от драйвера конкретной звуковой карты; может понадобится, если звук обрезается слишком ранним отключением PTT, например, слишком короткие служебные звуки; допустимые значения: 0 - 600 миллисекунд; по умолчанию 0;
2.30. Параметр GsmPassMode - [ревизия r4967+] позволяет передавать и принимать сжатые звуковые пакеты напрямую в звуковой тракт; предназначен для организации шлюза из двух клиентов AlterFRN через виртуальные звуковые карты AudioLoopback(UNIX/Linux), Virtual Audio Cable и аналогичных без лишнего перекодирования сжатого звука; допустимые значения: No, Yes; по умолчанию: No - отключен. Для корректной передачи сжатых пакетов требуется установка частоты дискретизации в 8000 Гц во всех элементах звукового тракта, включая параметры InSampleRate (2.2) и OutSampleRate (2.10) обоих AlterFRN-клиентов.
2.31. Параметр InDtmfQualityThreshold - [ревизия r5138+] порог качества входного DTMF-сигнала в условных процентах, необходимого для принятия сигнала как корректно распознанного. Допустимые значения от 5 до 100, по умолчанию 25. Если DTMF-декодер начинает ошибочно выдавать якобы декодированные DTMF-сигналы, то можно увеличить порог качества до значений 30-40-50; но увлекаться не стоит - вы можете сделать DTMF-декодер слишком придирчивым к качеству; Смотри также параметр InDtmfSilenceThreshold (2.32);
2.32. Параметр InDtmfSilenceThreshold - [ревизия r5138+] порог уровня входного сигнала, ниже которого DTMF-декодер считает входной сигнал тишиной и не пытается декодировать DTMF-сигналы. Допустимые значения от 0 до 32767 в динамическом диапазоне 16-битового ИКМ(PCM) кодирования звука, по умолчанию 800. Если DTMF-декодер начинает ошибочно декодировать шум радиосигнала, то можно увеличить порог до значений 1000-1200-1500, но увлекаться не стоит - вы можете сделать DTMF-декодер слишком глухим. Учитывает значение параметра InGainK (2.33). Смотри также параметр InDtmfQualityThreshold (2.31) и команду audiolevelgain (0.4.25);
2.33. Параметр InGainK - [ревизия r6378+] - коэффициент цифрового усиления входного звукового сигнала от радиостанции; обычный математический коэффициент; по умолчанию 1. Десятичный разделитель всегда точка. Использовать параметр следует с ясным пониманием того, что вы пытаетесь сделать. Параметр влияет на работу всего входного звукового тракта от радиостанции, включая VOX; Если вы вынуждены менять значение этого параметра, то у вас реальные проблемы с вашим входным звуковым оборудованием. На корректно работающем оборудовании вам такого делать не потребуется. Параметер не влияет на показания команды audiolevel (0.4.4); используйте вместо нее команду audiolevelgain (0.4.25)
