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 )

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

activeConfig

object ( DeviceConfig )

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

state

enum ( State )

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

grants[]

object ( DeviceGrant )

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

displayName

string

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

deviceMetadata

object ( DeviceMetadata )

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

currentChannels[]
(deprecated)

object ( ChannelWithScore )

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

grantRangeAllowlists[]

object ( FrequencyRange )

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

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: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

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

DeviceAirInterface

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

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

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

antennaBeamwidth

integer

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

antennaModel

string

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

cpeCbsdIndication

boolean

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

HeightType

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

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

DeviceGrant

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

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

Максимальная эквивалентная изотропно излучаемая мощность (ЭИИМ), разрешенная грантом. Максимальная ЭИИМ измеряется в дБм/МГц. Значение 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:23Z" и "2014-10-02T15:01:23.045123456Z" .

suspensionReason[]

string

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

grantId

string

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

lastHeartbeatTransmitExpireTime

string ( Timestamp format)

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

Метка времени в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти знаков после запятой. Примеры: "2014-10-02T15:01:23Z" и "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 )

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

DeviceMetadata

Данные устройства могут быть переопределены как порталом 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

CPI, подписавший подтверждение.

Состояние

Состояние информации о проверке 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 .