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 )

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

activeConfig

object ( DeviceConfig )

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

state

enum ( State )

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

grants[]

object ( DeviceGrant )

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

displayName

string

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

DeviceConfig

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

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 «Зулу» с точностью до наносекунд. Пример: "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

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

DeviceAirInterface

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

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

enum ( RadioTechnology )

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

Условный

supportedSpec

string

Это поле связано с полем «Радиотехнология» и предоставляет спецификацию радиоинтерфейса, которой соответствует 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

Внутренняя антенна устройства или нет. True: внутренняя. False: наружная.

antennaAzimuth

integer

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

antennaDowntilt

integer

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

antennaGain

integer

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

eirpCapability

integer

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

antennaBeamwidth

integer

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

antennaModel

string

Если используется внешняя антенна, в этом поле можно указать её модель (необязательно). Максимальная длина строки — 128 октетов.

HeightType

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

Перечисления
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.

DeviceGrant

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

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

number

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

frequencyRange

object ( FrequencyRange )

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

state

enum ( GrantState )

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

channelType

enum ( ChannelType )

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

moveList[]

object ( DpaMoveList )

В списке DPA фигурирует этот грант.

expireTime

string ( Timestamp format)

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

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

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

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

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

number

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

highFrequencyMhz

number

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

GrantState

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

Перечисления
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

DpaMoveList

Запись в списке действий 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 .