REST Resource: customers.devices

Ресурс: Устройство

Представление JSON
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
Поля
name

string

Только вывод. Путь к ресурсу.

fccId

string

Идентификатор FCC устройства.

serialNumber

string

Серийный номер, присвоенный устройству производителем устройства.

preloadedConfig

object ( DeviceConfig )

Конфигурация устройства, как указано через SAS Portal API.

activeConfig

object ( DeviceConfig )

Только вывод. Текущая конфигурация устройства, зарегистрированного в SAS.

state

enum ( State )

Только вывод. Состояние устройства.

grants[]

object ( DeviceGrant )

Только вывод. Гранты, удерживаемые устройством.

displayName

string

Отображаемое имя устройства.

Конфигурация устройства

Информация о конфигурации устройства.

Представление JSON
{
  "category": enum (DeviceCategory),
  "model": {
    object (DeviceModel)
  },
  "airInterface": {
    object (DeviceAirInterface)
  },
  "installationParams": {
    object (InstallationParams)
  },
  "measurementCapabilities": [
    enum (MeasurementCapability)
  ],
  "userId": string,
  "callSign": string,
  "state": enum (State),
  "isSigned": boolean,
  "updateTime": string
}
Поля
category

enum ( DeviceCategory )

Категория FCC устройства.

model

object ( DeviceModel )

Информация об этой модели устройства.

airInterface

object ( DeviceAirInterface )

Информация о радиоинтерфейсе этого устройства.

installationParams

object ( InstallationParams )

Параметры установки устройства.

measurementCapabilities[]

enum ( MeasurementCapability )

Возможности отчета об измерениях устройства.

userId

string

Идентификатор пользователя устройства.

callSign

string

Позывной оператора устройства.

state

enum ( State )

Состояние конфигурации.

isSigned

boolean

Только вывод. Была ли конфигурация подписана CPI.

updateTime

string ( Timestamp format)

Только вывод. Время последнего редактирования конфигурации устройства.

Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: "2014-10-02T15:01:23.045123456Z" .

Категория устройства

Категория FCC устройства, как определено в Части 96.

перечисления
DEVICE_CATEGORY_UNSPECIFIED Неуказанная категория устройства.
DEVICE_CATEGORY_A Категория А.
DEVICE_CATEGORY_B Категория Б.

Модель устройства

Информация о модели устройства.

Представление JSON
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Поля
vendor

string

Имя производителя устройства.

name

string

Название модели устройства.

softwareVersion

string

Версия программного обеспечения устройства.

hardwareVersion

string

Аппаратная версия устройства.

firmwareVersion

string

Версия прошивки устройства.

DeviceAirИнтерфейс

Информация о радиоинтерфейсе устройства.

Представление JSON
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Поля
radioTechnology

enum ( RadioTechnology )

В этом поле указывается технология радиодоступа, используемая для CBSD.

Условный

supportedSpec

string

Это поле связано с полем RadioTechnology и предоставляет спецификацию радиоинтерфейса, которой CBSD соответствует на момент регистрации.

По желанию

Радиотехнологии

Утвержденные типы технологии радиодоступа.

перечисления
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

Параметры установки

Информация о параметрах установки устройства.

Представление JSON
{
  "latitude": number,
  "longitude": number,
  "height": number,
  "heightType": enum (HeightType),
  "horizontalAccuracy": number,
  "verticalAccuracy": number,
  "indoorDeployment": boolean,
  "antennaAzimuth": integer,
  "antennaDowntilt": integer,
  "antennaGain": integer,
  "eirpCapability": integer,
  "antennaBeamwidth": integer,
  "antennaModel": string
}
Поля
latitude

number

Широта расположения антенны устройства в градусах относительно системы отсчета WGS 84. Допустимый диапазон: от -90,000000 до +90,000000. Положительные значения представляют широты к северу от экватора; отрицательные значения к югу от экватора.

longitude

number

Долгота местоположения антенны устройства. в градусах относительно системы отсчета WGS 84. Допустимый диапазон от -180.000000 до +180.000000. Положительные значения представляют долготу к востоку от нулевого меридиана; отрицательные значения к западу от нулевого меридиана.

height

number

Высота антенны устройства в метрах. Когда значением параметра heightType является "AGL", высота антенны должна быть указана относительно уровня земли. Когда значением параметра heightType является «AMSL», оно задается относительно системы отсчета WGS84.

heightType

enum ( HeightType )

Указывает, как измеряется высота.

horizontalAccuracy

number

Положительное число в метрах, указывающее на точность горизонтального положения антенны устройства. Этот необязательный параметр должен присутствовать только в том случае, если его значение меньше требования FCC, равного 50 метрам.

verticalAccuracy

number

Положительное число в метрах, указывающее на точность вертикального положения антенны устройства. Этот необязательный параметр должен присутствовать только в том случае, если его значение меньше, чем требование FCC, равное 3 метрам.

indoorDeployment

boolean

Находится ли антенна устройства в помещении или нет. Правда: в помещении. Ложь: на открытом воздухе.

antennaAzimuth

integer

Направление визирования горизонтальной плоскости антенны в градусах относительно истинного севера. Значение этого параметра — целое число от 0 до 359 включительно. Значение 0 градусов означает истинный север; значение 90 градусов означает восток. Этот параметр является необязательным для устройств категории A и условным для устройств категории B.

antennaDowntilt

integer

Наклон антенны вниз в градусах и представляет собой целое число со значением от -90 до +90 включительно; отрицательное значение означает, что антенна наклонена вверх (выше горизонтали). Этот параметр является необязательным для устройств категории A и условным для устройств категории B.

antennaGain

integer

Пиковое усиление антенны в дБи. Этот параметр представляет собой целое число со значением от -127 до +128 (дБи) включительно.

eirpCapability

integer

Этот параметр представляет собой максимальную э.и.и.м. устройства в дБм/10 МГц и представляет собой целое число со значением от -127 до +47 (дБм/10 МГц) включительно. Если он не указан, SAS интерпретирует его как максимально допустимую э.и.и.м. в единицах дБм/10 МГц для категории устройств.

antennaBeamwidth

integer

Ширина луча антенны по уровню 3 дБ в горизонтальной плоскости в градусах. Этот параметр представляет собой целое число без знака, имеющее значение от 0 до 360 (градусов) включительно; это необязательно для устройств категории A и условно для устройств категории B.

antennaModel

string

Если используется внешняя антенна, в этом поле дополнительно указывается модель антенны. Строка имеет максимальную длину 128 октетов.

Тип высоты

Указывает, как измеряется высота.

перечисления
HEIGHT_TYPE_UNSPECIFIED Неопределенный тип высоты.
HEIGHT_TYPE_AGL Высота AGL измеряется относительно уровня земли.
HEIGHT_TYPE_AMSL Высота над уровнем моря измеряется относительно среднего уровня моря.

Возможности измерения

Возможность измерения устройства. Значения определены [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

перечисления
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Состояние

Состояние устройства.

перечисления
DEVICE_STATE_UNSPECIFIED Неопределенное состояние.
RESERVED Устройство создано на портале SAS, но еще не зарегистрировано в SAS.
REGISTERED Устройство зарегистрировано в SAS.
DEREGISTERED Регистрация устройства отменена в SAS.

ДевайсГрант

Грант устройства. Это разрешение, предоставляемое системой доступа к спектру устройству для передачи с использованием заданных рабочих параметров после успешного подтверждения устройством.

Представление JSON
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
Поля
maxEirp

number

Максимальная эквивалентная изотропно излучаемая мощность (EIRP), разрешенная грантом. Максимальная EIRP выражается в дБм/МГц. Значение maxEirp представляет собой среднеквадратичное значение EIRP, которое можно измерить с помощью процедуры, определенной в части 96.41(e)(3) FCC.

frequencyRange

object ( FrequencyRange )

Диапазон частот передачи.

state

enum ( GrantState )

Состояние гранта.

channelType

enum ( ChannelType )

Тип используемого канала.

moveList[]

object ( DpaMoveList )

Списки перемещений DPA, в которых появляется этот грант.

expireTime

string ( Timestamp format)

Срок действия гранта.

Отметка времени в формате RFC3339 UTC "Zulu" с точностью до наносекунд. Пример: "2014-10-02T15:01:23.045123456Z" .

Диапазон частот

Диапазон частот от low_frequency до high_frequency .

Представление JSON
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Поля
lowFrequencyMhz

number

Самая низкая частота частотного диапазона в МГц.

highFrequencyMhz

number

Самая высокая частота частотного диапазона в МГц.

ГрантСтейт

Состояние гранта.

перечисления
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Грант был предоставлен, но устройство на нем не бьется.
GRANT_STATE_TERMINATED Грант был прекращен SAS.
GRANT_STATE_SUSPENDED Грант был приостановлен SAS.
GRANT_STATE_AUTHORIZED В настоящее время устройство передает.
GRANT_STATE_EXPIRED Грант истек.

Тип канала

перечисления
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

Дпамовелист

Запись в списке перемещений DPA.

Представление JSON
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Поля
dpaId

string

Идентификатор DPA.

frequencyRange

object ( FrequencyRange )

Диапазон частот, на который влияет список перемещений.

Методы

create

 Создает device под node или customer .

createSigned

 Создает подписанное device под node или customer .

delete

 Удаляет device .

get

 Получает сведения об device .

list

 Список devices под node или customer .

move

 Перемещает device под другой node или customer .

patch

 Обновляет device .

signDevice

 Подписывает device .

updateSigned

 Обновляет подписанное device .