Сервис спектрометра
Сервис спектрометра service_spectrometer является стандартным приложением для сбора данных в МР-консоли. Данный сервис реализован через REST API, используя библиотеку Django. Сервис проводит последовательный запуск компонентов и выгрузку данных в соответствии с указанными в http-запросе параметрами. Запрос можно сформировать вручную через командную строку либо через браузер, пользуясь API VIEW по URL localhost:8000/api. Перед началом работы необходимо авторизироваться в админ-панели по URL localhost:8000/admin. Если работаете через curl в запросе надо передавать данные для авторизации.

API предусматривает post/get-методы списка используемых устройств, post-метод запуска сбора с заданными параметрами, get-методы состояния сбора, параметров сбора и собранных данных.

Вызов последних трех методов реализован двумя спусабами:

Отдельные URLPATH в каталоге api (mstate, mparams, mdata)

Вызов через URLPATH api/measurement/<id>/<state/info/data>

Через URLPATH measurement также реализован post-запрос запуска консоли. Для начала сбора пользователь должен передать сервису следующие параметры:

Параметры осциллографа (device model, sample rate, points=[...], channels, ranges=[...], ntriggers, averaging, trigger channel, threshold, direction, automeasure time, enabled)
Значения ranges и direction указаны в ps4000aApi.h. Threshold и automeasure time ограничены 2 байтами.

Параметры синхронизатора (device model, file, port)

Параметры SDR (device model, sample rate, freq, ampl, gain, file)

Параметры ГРУ (device model, ip, file, enabled)|

Другие параметры (engine, infostr)

Шаблон json-тела запроса приведен в директории сервиса.

Сбор и анализ данных
Сбор данных начинается после отправки get-запроса по URL api/measurement. Состояние измерения сохраняется в state-объекте. Получить доступ к состоянию можно по URL api/measurement/<id>/state. В состоянии описан статус и retcode для каждого компонента. Если все компоненты отработали правильно в состоянии выставляется флаг data_ready, после чего разрешается читать записанные данные.

Данные запрашиваются get-запросом по URL api/measurement/<id>/data. По умолочанию присылаются все записи (все каналы по каждому триггеру и повторению для усреднения), закодированные в строку Base64. Можно запросить конкретную запись через inline-параметры запроса: data_num и averaging_num. К примеру: api/measurement/<id>/data/?data_num=1&averaging_num=5.

Первичная обработка данных
В директории сервиса приложен Python-скрипт с классом декодера данных из json-ответа от сервера. Пользователь должен выгрузить ответ сервера в файл после чего загрузить его в объект класса декодера. Класс декодера реализует следующие методы:

Запрос сырых данных getRawData(channel_num, data_num, averaging_num)
Запрос декодированных данных getDataDecoded(channel_num, data_num, averaging_num, points)
Запрос отмасштабированных данных в соответсвии с максимальной амплитудой канала getDataScaled(channel_num, data_num, averaging_num, points, channel_range)
Запрос спектра getDataSpectrum(channel_num, data_num, averaging_num, points, channel_range, zero_fill). Возвращает dictionary вида ():

{
"spectrum": np.array(float) # амплитуды y-ось
"freqs": np.array(float) # частоты x-ось
"phases": np.array(float) # фазы
}
Инструкция по запуску
Запуск производится через bat-файлы приложенные к сервису:

autorun_default_venv - создать виртуальное окружение Python, установить зависимости и запустить сервис
autorun_default - установить зависимости и запустить сервис
autorun_defult_simple - запустить сервер, без установки зависимостей
Остановка сервиса выполняется через autokill.bat.