Введение

Приложение предоставляет возможность при подключенном через USB-кабель шумомере передавать показания на удаленный сервер, на интерфейс PushGateway. В данной разделе даются ссылки на вспомогательные библиотеки, которые понадобятся для работы приложения, а также описан алгоритм работы. Приложение запускается из командной строки с указанием параметров подключения.

Пререквизиты

Компания Октава-Электрондизайн предоставляет бесплатную библиотеку для работы с телеметрией данных - OctavaSignal.dll. А также вспомогательная библиотека FTD2XX.dll. Данные библиотеки должны быть размещены в директории приложения для обеспечения его работы. Скачать архив библиотек можно по ссылке OctavaSignal.zip.

USB-драйвер шумомеров Октава-Электрондизайн входит в комплект приложения Signal+3G Light. Архив c USB-драйвером шумомера можно скачать по ссылке USB-Device-Driver.zip.

Также на компьютере под управлением Windows Vista может понадобиться установка библиотек Microsoft Visual C++ 2015-2019 Redistributable. Для 32-битной версии Windows скачать можно по ссылке VC_redist.x86.exe.

Также вам должен быть известен URL сервиса Prometheus PushGateway.

Подготовка директории с приложением

Создайте директорию приложения, например, c:\OctavaPusher\ .

Из архива OctavaSignal.zip распакуйте файлы FTD2XX.dll, OctavaSignal.dll, OctavaSignal.lib и TeleDescFile.bin в директорию c:\OctavaPusher\ .

Скачайте и разместите в директории приложения файлы MidOctava.dll и OctavaPusher.exe, которые являются частью поставки OctavaPusher.

Приложение готово к работе.

Параметры командной строки

При запуске файла OctavaPusher.exe на экране выводится версия приложения, а также подсказка о параметрах командной строки.

c:\OctavaPusher>OctavaPusher.exe
v1.7R x86 Usage: OctavaPusher.exe -url=http://<gateway-host>:<gateway-port> [-user=<username>] [-pass=<password>] [-delay=<time in seconds>] [-reset=<time in seconds>] [-zone=<zone>] [-csvout=<file>] [-debug]
Usage of OctavaPusher.exe:
  -csv string
  -debug
  -delay int
         (default 10)
  -pass string
  -reset int
         (default 10)
  -url string
  -user string
  -zone string

Пример командной строки для работы приложения, и вывод на экран во время работы

c:\OctavaPusher>OctavaPusher.exe -url=http://pushnoise.alpol.su:80 -delay=2 -reset=600 -zone=kv83
2021/04/25 22:57:29 Octava Push Prometheus start
2021/04/25 22:57:29 Debug mode:  false
2021/04/25 22:57:29 Use gateway: http://pushnoise.alpol.su:80 with delay:  2  reset:  600
2021/04/25 22:57:29 Zone:  kv83
2021/04/25 22:57:29 Found devices: 1
2021/04/25 22:57:29 VIN: 00123456
2021/04/25 22:57:29 Device DateTime: 2021-04-25T22:57:28 MSK

При запуске приложения выводится информация о введенных параметрах, выводится VIN-номер устройства, дата на устройстве и начинается процесс передачи метрик.

Принцип работы

С периодичностью в количество секунд, которые указаны в параметре delay, на PushGateway передаются следующие метрики, которые снимаются с показаний шумомера через библиотеку телеметрии.

Возвращаемые метрики

Согласно описанию библиотеки OctavaSignal.dll вызывается процедура GetData, которой передаются параметры для получения значений согласно таблицам "Таблица 1. Возвращаемые функцией O110_GetAverName названия типов усреднения" и "Таблица 2. Возвращаемые функцией O110_GetBandName названия полос".

Для прибора "Экофизика" значения, которые берутся из этих таблиц, будут следующие.

Второй параметр, передаваемый в функцию GetData, определяет тип данных:

• 0 - октавы
• 1 - третьоктавы (полосы для HMeter и EMeter и т.п.)
• 2 - корректированные уровни

Третий параметр, передаваемый в функцию GetData. Приведен список для прибора Экофизика (БФ).

Четвертый параметр, передаваемый в функцию GetData.

Тип усреднения Fast. Тип усреднения Fast работает только для диапазона шума. Для октав.

Тип усреднения Slow для всего частотного диапазона для октав.

Тип усреднения Slow Min для всего частотного диапазона для октав.

Тип усреднения Slow Max для всего частотного диапазона для октав.

Тип усреднения Slow для всего частотного диапазона для третьоктав.

L эквивалентные по частотам октав

L эквивалентные по частотам третьоктав

Корректированные уровни дбА

Корректированные уровни дбAU

Корректированные уровни дбC

Корректированные уровни дбFi

Корректированные уровни дбG