3. Секция Radio - настройки параметров взаимодействия с радиостанцией.
3.1. Параметр PTT - Push To Talk - параметры выходной линии управления включением радиостанции на передачу. Смотри Формат описания линий управления радиостанцией (3.4). Если вы используете несколько работающих копий AlterFRN-клиента одновременно на одной машине, то для избежания конфликтов используйте разные устройства(порты) для выходной линии PTT для каждой копии AlterFRN-клиента.
3.2. Параметр COS - Carrier On Signal - параметры входной линии управления для приема сигнала несущей с радиостанции. Смотри Формат описания линий управления радиостанцией (3.4). Если вы используете несколько работающих копий AlterFRN-клиента одновременно на одной машине, то для избежания конфликтов используйте разные устройства(порты) для входной линии COS для каждой копии AlterFRN-клиента.
3.3. Параметр LIGHT - параметры выходной линии управления для подключения индикатора, показывающего момент успешной трансляции сигнала с радиостанции на сервер. Смотри Формат описания линий управления радиостанцией (3.4). Если вы используете несколько работающих копий AlterFRN-клиента одновременно на одной машине, то для избежания конфликтов используйте разные устройства(порты) для выходной линии LIGHT для каждой копии AlterFRN-клиента.
3.4. Формат описания линий управления: <тип_интерфейса>:<параметр_1>[:<параметр_2>[:<режим>]], где: 3.4.1. <тип_интерфейса>: 3.4.1.1. -- COM - для последовательного порта RS232 или USB-SERIAL; 3.4.1.2. -- VOX - для голосового управления VOX; допустимо использование только для входной линии COS; 3.4.1.3. -- GPIO - для портов ввода-вывода SYSFS-GPIO на Linux-ARM. 3.4.1.4. -- FILE - для обычного файла, наличие которого будет восприниматься как несущая. 3.4.1.5. -- CM108 - [только UNIX/Linux, ревизия 6452+] - для портов ввода-вывода GPIO на звуковых картах CM108/CM109/CM119/SSS1623. 3.4.2. <параметр_1>: 3.4.2.1. для типа COM: имя устройства последовательного порта в соответствии с операционной системой, например, /dev/cuau0 (FreeBSD) или COM2(Windows); 3.4.2.2. для типа VOX: абсолютный уровень порога срабатывания в положительном поддиапазоне значений signed int16 (0-32767), например, 800; 3.4.2.3. для типа GPIO: номер порта-ввода SYSFS-GPIO, например, 2 для gpio2; 3.4.2.4. для типа FILE: имя файла; для MS Windows двоеточие после имени диска в полном имени файла должно быть заменено на точку с запятой; 3.4.2.5. для типа CM108: имя устройства типа HID в соответствии с операционной системой, например, /dev/hidraw0; 3.4.3. <параметр_2>: 3.4.3.1. для типа COM: имя управляющей линии DTR,DSR,CTS,RTS .... 3.4.3.3. для типа VOX: не имеет значения, может быть быть пустым или любым; 3.4.3.3. для типа GPIO: краткое имя порта ввода-вывода SYSFS-GPIO, например, gpio2 для порта номер 2; может иметь пустое значение, тогда будет использоваться форма gpioN, где N - номер порта, т.е. gpio2 для порта номер 2. 3.4.3.4. для типа CM108: имя управляющей линии CM108, например, VOLUP, VOLDN, GPIO1, GPIO2, GPIO3; 3.4.4. <режим>: 3.4.4.1. N или NORMAL - действующий(активный) сигнал есть логическая единица; по умолчанию; 3.4.4.2. I или INVERTED - действующий(активный) сигнал есть логический ноль.
3.5. Cписок доступных типов интерфейса и их линий(проводов) можно получить по команде radio (0.4.5).
3.7. Параметер CTCSSWakeTime - время (миллисекунды) между включением радиостанции на передачу и подачей реального звукового сигнала корреспондента от сервера; помогает заранее "разбудить" медленные декодеры CTCSS/DSC, чтобы не было совсем уж пропадания начала фразы; по умолчанию 0; 200-400 мс - вполне нормально; однако не следует делать задержку слишком длинной, т.к. этим затрудняется последующий захват канала на передачу, поскольку корреспондент по факту уже перестал говорить, канал уже свободен, но в эфире трансляция еще продолжается.
3.8. Параметр CarrierCatchTime - время (миллисекунды), которое должно пройти после появления активного сигнала на входной линии COS, чтобы несущая считалась именно полезным сигналом, а не кратковременной помехой; при использовании VOX используется как время атаки. Потерю начала полезного сигнала можно компенсировать установкой соответствующего значения в параметре InPreCapturedTime(п.2.5).
3.9. Параметр CarrierLostTime - время (миллисекунды), которое должно пройти после пропадания активного сигнала на входной линии COS, чтобы считать пропадание несущей именно фактическим окончанием полезного сигнала - для избежания реакции на кратковременное исчезание и/или затухание полезного сигнала; при использовании VOX используется как время отпускания
3.10. Примечание. При использовании портов ввода-вывода GPIO на платах вроде Raspberry/Orange/Banana/Cubieboard/..... для входной линии COS рекомендую использовать внешнюю подтяжку на питание (pullup) или на общий провод (pulldown) в зависимости от используемой схемы подключения.
3.11. Параметр STATIC - [ревизия r3342+] - список выходных линий интерфейса(ов), на которые нужно подать постоянные заведомо известные значения сигнала(ов); каждый элемент списка должен соответствовать п.3.4 Формат описания линии управления; разделителем элементов списка является точка с запятой (;); может пригодится для подключения схем согласования с радиостанцией вроде такой от RA1AGY. Если вы используете несколько работающих копий AlterFRN-клиента одновременно на одной машине, то для избежания конфликтов используйте разные устройства(порты) для выходных линий из списка STATIC для каждой копии AlterFRN-клиента.
3.12. Параметр SquelchSettlingTime - [ревизия r3342+] - задержка в миллисекундах перед началом опроса входной линии COS после предыдущих операций приема и/или передачи. Позволяет, например, избежать ложного определения несущей от радиостанции или ложного срабатывания VOX-детектора от возможных паразитных наводок и/или переходных процессов; допустимые значения: 0 - 10000 мс; по умолчанию - 0 мс. Следует также учитывать, что звуковая подсистема включается не мгновенно, и время этого включения также есть дополнительная задержка перед началом опроса входной линии COS. Команда audiospeedconfig (0.4.24) позволяет измерить фактическую задержку на включение вашего звукового оборудования на ввод(захват) звука, при котором и происходит опрос входной линии COS.
3.13. Параметр CourtesyDelay - [ревизия r3342+] - время в миллисекундах между окончанием приема (пропаданием активного сигнала на входной линии COS) и началом последующей передачи (подачей активного сигнала на выходную линию PTT), в т.ч. звука отшлепа (courtesy); полезен в случае, если радиостанция не умеет быстро переходить с приема на передачу; допустимые значения: 0 - 2000 мс; по умолчанию - 0 мс.
3.14. Параметр SquelchSettlingTimeIn - не используется, начиная с r6444; было: [r3342+] - время в миллисекундах между очередным пропаданием сигнала активного сигнала на входящей линии COS и началом опроса сигнала на ней же; позволяет принудительно создавать паузы между передачами сигнала с радиостанции на сервер; допустимые значения: 0 - 10000 мс; по умолчанию - 0 мс.
3.15. Параметр DtmfTimeout - [ревизия r4592+] - максимальное время в секундах, за которое должна быть полностью введена DTMF-команда; по умолчанию - 15 сек.
3.16. Параметр DtmfCommands - [ревизия r4592+] - список DTMF-команд, разделенных точкой с запятой; в секции Audio должен быть включен декодер DTMF - параметр InDtmfEnabled. 3.16.1. Формат DTMF-команд: DTMFTEXT:ACTION[:attr1[:attr2[:attr3]]], где: 3.16.2. - DTMFTEXT - текст команды в DTMF-символах 0123456789ABCD*#; текст команды должен быть уникальным и не являться частью текста других команд; 3.16.3. - ACTION - код действия этой команды, допустимы: 3.16.3.1. -- NET - перейти в другую сеть(комнату) на этом же сервере, attr1 - имя сети(комнаты); например: *01#:NET:roomname; 3.16.3.2. -- CONN - подключиться к сети(комнате) на другом сервере, attr1 - адрес сервера, attr2 - порт сервера, attr3 - имя сети(комнаты); например: #01#:CONN:frn.server.com:10024:roomname; 3.16.3.3. -- EXEC - [только UNIX/Linux] - асинхронно выполнить внешнюю программу (скрипт), attr1 - путь к внешней программе(скрипту), параметрами командной строки которому будут передаются DTMF-текст команды и полное имя конфигурационного файла AlterFRN-клиента; например: #99#:EXEC:/my/super/script;
3.17. Параметр IdNoSoundListFileName - [ревизия r6367+] - имя файла со списком идентификаторов клиентов, входящие звуковые сообщения от которых не воспроизводить; 1 строка = 1 идентификатор.
### USB-RS232 пример FreeBSD (у меня работает именно так на FT232RL)
PTT=COM:/dev/cuaU0:RTS:INVERTED
COS=COM:/dev/cuaU0:SR
STATIC=COM:/dev/cuaU0:DTR:N ; COM:/dev/cuaU1:RTS:N ; COM:/dev/cuaU1:DTR:I
