REST Resource: customers.deployments.devices

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

Представление JSON
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "currentChannels": [
    {
      object (ChannelWithScore)
    }
  ],
  "grantRangeAllowlists": [
    {
      object (FrequencyRange)
    }
  ]
}
Поля
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

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

deviceMetadata

object ( DeviceMetadata )

Параметры устройства, которые могут быть переопределены как порталом SAS, так и запросами на регистрацию SAS.

currentChannels[]
(deprecated)

object ( ChannelWithScore )

Только вывод. Текущие каналы с оценками.

grantRangeAllowlists[]

object ( FrequencyRange )

Для новых грантов доступны только диапазоны из разрешенных списков.

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

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

Представление 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:23Z" и "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
CW
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,
  "cpeCbsdIndication": boolean
}
Поля
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

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

antennaBeamwidth

integer

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

antennaModel

string

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

cpeCbsdIndication

boolean

Если он присутствует, этот параметр указывает, является ли CBSD CPE-CBSD или нет.

Тип высоты

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

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

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

Возможность измерения устройства. Значения определены WINNF-SSC-0002.

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

Состояние

Состояние конфигурации устройства. Во время регистрации CBSD можно использовать только конфиги в состоянии DEVICE_CONFIG_STATE_FINAL .

перечисления
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

Состояние

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

перечисления
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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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:23Z" и "2014-10-02T15:01:23.045123456Z" .

suspensionReason[]

string

Если предоставление гранта приостановлено, укажите причину (причины) приостановления.

grantId

string

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

lastHeartbeatTransmitExpireTime

string ( Timestamp format)

Время истечения передачи последнего такта.

Временная метка в формате RFC3339 UTC "Zulu" с разрешением в наносекунды и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "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 )

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

Метаданные устройства

Данные устройства могут быть переопределены как порталом SAS, так и запросами на регистрацию.

Представление JSON
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Поля
interferenceCoordinationGroup

string

Группа по координации помех (ICG). Группа CBSD, которые управляют собственным вмешательством в группу. Дополнительные сведения см. в CBRSA-TS-2001 V3.0.0 .

commonChannelGroup

string

Группа общих каналов (CCG). Группа CBSD в одной группе ICG, запрашивающая назначение общего основного канала. Дополнительные сведения см. в CBRSA-TS-2001 V3.0.0 .

antennaModel

string

Если заполнено, шаблон модели антенны для использования. Формат: RecordCreatorId:PatternId

nrqzValidated
(deprecated)

boolean

Только вывод. Установите значение true , если CPI подтвердил, что они согласовали свои действия с офисом Национальной тихой зоны.

nrqzValidation

object ( NrqzValidation )

Только вывод. Информация о проверке Национальной зоны радиомолчания.

NrqzValidation

Информация о подтверждении Национальной зоны радиомолчания.

Представление JSON
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Поля
state

enum ( State )

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

caseId

string

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

latitude

number

Широта устройства, связанная с проверкой.

longitude

number

Долгота устройства, связанная с проверкой.

cpiId

string

ИПЦ, подписавший валидацию.

Состояние

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

перечисления
STATE_UNSPECIFIED Неопределенное состояние.
DRAFT Состояние черновика.
FINAL Окончательное состояние.

ChannelWithScore

Канал со счетом.

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

object ( FrequencyRange )

Частотный диапазон канала.

score

number

Оценка канала, нормализованная в диапазоне [0,100].

Методы

create

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

createSigned

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

list

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