| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051 |
- Сервис спектрометра
- Сервис спектрометра 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.
|
