CallLink

Лицензия 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, содержащего максимальные значения амплитуды с каждого из запрошенных дивапазонов.