9.3.1.1. Список поддерживаемых устройств

Файл vendors.conf определяет поддерживаемые системой устройства для конфигурирования. Данные хранятся в многомерном массиве, который представлен в простом текстовом формате YAML. Каждый элемент массива первого уровня описывает одного производителя устройств. Предполагается, что в пределах одной марки все устройства имеют аналогичные принципы конфигурации. Например, все устройства Grandstream требуют расчета контрольной суммы файла конфигурации.

Пример элемента для устройств Grandstream:

Системное название элемента — grandstream, он содержит следующие поля:

• name: Имя производителя или класс устройств. Это имя отображается в интерфейсе пользователя;
• postprocess: Предписывает использовать после формирования файла внешнюю процедуру обработки, которая должна содержаться в файле с именем process.vendor.php, где vendor это имя класса или производителя устройств;
• reboot_func: Предписывает системе использовать нестандартную процедуру перезагрузки устройства. Эта процедура должна быть определена в файле с именем reboot.vendor.php, где vendor это имя класса или производителя устройств;
• sip-notify: Описывает стандартный метод перезагрузки устройства с помощью посылки NOTIFY пакета по протоколу SIP. Содержимое пакета описывается аналогично таковому в файле sip_notify.conf и задается двумя вложенными опциями:
  • event: Описание события;
  • content-length: Длина содержимого.

  Параметры описания события и его длинны различаются для разных устройств, для более полной информации нужно обратиться к документации производителя устройства;

• filename_format: В этом поле задается формат имени, под которым нужно сохранить готовый файл конфигурации устройства. В строке может использоваться ключевые слова #mac# и #MAC#, которые обозначают вывод аппаратного МАС адреса строчными и заглавными буквами соответственно;
• mac: Этот массив определяет аппаратные МАС адреса устройств, которые следует относить к данному производителю. Принадлежность определяется по первым шести цифрам адреса, массив может содержать множество значений, но значения разных производителей не должны совпадать;
• models: Список моделей и их названий, разделенный двоеточием. Первая часть — имена файлов шаблонов, вторая часть — имя, отображаемое в интерфейсе.