Лицензия API предназначена только для приборов ARINST SSA R3, R3m, TG R3 и снимает ограничения ДЕМО режима с ограничением по времени использования 5 минут.
Данная лицензия позволяет удаленно получать данные с анализатора спектра через USB кабель. Для получения данных используется протокол команд, указанный в описании.
ВНИМАНИЕ! Лицензия привязывается только к одному прибору и не может быть перенесена и активирована для другого прибора.
После активации лицензии "PRO" и "API" не подлежат обмену. Удостоверьтесь что выбранная вами лицензия соответствует вашим задачам.
После оплаты лицензии на нашем сайте вам необходимо прислать на почту идентификатор вашего прибора (device ID) и номер вашего заказа. Обратите внимание, запрос будет обработан в течении трёх рабочих дней!
Идентификатор прибора находится в меню Устройство (Device). Прислать можно в текстовом формате, фото или скриншот экрана.
После получения ключа вам необходимо ввести его в соответствующее поле на экране прибора.
Командный протокол для взаимодействия с устройствами семейства Arinst SSA-R3
1. Общие сведения.
Все данные передаются в бинарном виде в пакетах структуры:
Поле |
Старт |
Команда |
Длина данных |
Данные |
Контрольная сумма |
Длина, байт |
1 |
1 |
2 |
0-1000 |
2 |
Пример |
0xBB |
0xC3 |
0x0A 0x00 |
-- |
0xAB 0x21 |
Доп. инфо |
|
|
LSB |
Длина пакета и формат данных зависит команды |
LSB, Может быть заменена на нулевые байт |
Пример пакета:
BBC30A0080080892000000000100AB21
Байт 0xBB - стартовый байт, общий для всех команд протокола
Байт 0xC3 - байт-код команды
Байты 0x0A 0x00 - длина последующей полезной нагрузки в байтах (10)
Байты 80080892000000000100 - полезная нагрузка пакета
Байты 0xAB 0x21 - контрольная сумма всего пакета. Может быть заменена на нулевые байт для игнорирования проверки.
Поле uint8(rf_in) позволяет выбрать режим аттенюатора для одно портовых приборов или выбрать порт приема сигнала для 2-х и 4-х портовых приборов. Нумерация начинается с 0.
Пример:
Для одно портового прибора: uint8(rf_in) = 0 - аттенюатор на -15дБ, uint8(rf_in) = 1 - аттенюатор на 0дБ, uint8(rf_in) = 2 - аттенюатор на +15дБ
Для 2-х и 4-х портового прибора: uint8(rf_in) = 0 - порт IN1, uint8(rf_in) = 1 - порт IN2, uint8(rf_in) = 2 - порт IN3, uint8(rf_in) = 3 - порт IN4.
2. Список доступных команд
Название |
Команда |
Полезная нагрузка загрузка |
Полезная нагрузка ответа |
Описание |
ECHO |
0xC0
|
нет |
нет |
Проверка канала и поддержание сессии если сканирование не производится. |
GET_SPECTRUM_U8 |
0xC1 |
uint64(start_Hz) uint64(stop_Hz) uint8(rf_in) uint8(bw) uint8(speed) |
uint8(amp_comp_1)... uint8(amp_comp_N)
|
Проведение сканирования с заданными параметрами. Результирующий спектр передается в виде массива uint8, который преобразуется в амплитуды по формуле amp_dBm = (amp_comp_N / 2) — 120 Частоты полученных точек не передаются. |
GET_SPECTRUM_FLOAT |
0xC2
|
uint64(start_Hz) uint64(stop_Hz) uint8(rf_in) uint8(bw) uint8(speed) |
float(mag_dBm_1)... float(mag_dBm_N) float(freq_MHz_1)... float(freq_MHz_N) |
Проведение сканирования с заданными параметрами. Результирующий спектр передается в виде массива float содержащего значения амплитуд в dBm и массива float, содержащего точные частоты в MHz. |
SET_GENERATOR_POINT |
0xC3 |
uint64(freq_Hz) uint8(state) uint8(pow) |
нет |
Установка частоты и выходной мощности встроенного генератора (для модели TG) |
GET_TRACKING |
0xC4 |
uint64(start_Hz) uint64(stop_Hz) uint8(rf_in) uint8(pow) |
float(mag_dBm_1)... float(mag_dBm_500 float(freq_MHz_1)... float(freq_MHz_500) |
Проведение сканирования с активным трекинг-генератором (для модели TG) Результирующий спектр передается в виде массива float содержащего значения амплитуд в dBm и массива float, содержащего точные частоты в MHz. |
GET_PEAKS_FROM_RANGES |
0xC5 |
uint8(rf_in) uint8(bw) uint8(speed) uint64(start_freq_Hz_range1) uint64(stop_freq_Hz_range1) … uint64(start_freq_Hz_rangeN) uint64(stop_freq_Hz_rangeN)
|
float(range_peak_mag_dBm_1)... float(range_peak_mag_dBm_N)
|
Проведение сканирования N диапазонов. Результат передается в виде массива float длиной N, содержащего максимальные значения амплитуды с каждого из запрошенных дивапазонов. |
Комплектация:
0
|