REST Resource: customers.devices

Recurso: Device

Representação JSON 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
Campos
name

string

Apenas saída. O nome do caminho do recurso.
fccId

string

O identificador da FCC do dispositivo.
serialNumber

string

Um número de série atribuído ao dispositivo pelo fabricante.
preloadedConfig

object (DeviceConfig)

Configuração do dispositivo, conforme especificado pela API do portal do SAS.

activeConfig

object (DeviceConfig)

Apenas saída. Configuração atual do dispositivo conforme registrado no SAS.

state

enum (State)

Apenas saída. Estado do dispositivo.

grants[]

object (DeviceGrant)

Apenas saída. Concessões mantidas pelo dispositivo.
displayName

string

Nome de exibição do dispositivo.

DeviceConfig

Informações sobre a configuração do dispositivo.

Representação 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
}
Campos
category

enum (DeviceCategory)

Categoria do dispositivo de acordo com a FCC.

model

object (DeviceModel)

Informações sobre este modelo de dispositivo.

airInterface

object (DeviceAirInterface)

Informações sobre a interface aérea deste dispositivo.

installationParams

object (InstallationParams)

Parâmetros de instalação do dispositivo.

measurementCapabilities[]

enum (MeasurementCapability)

Recursos de relatórios de medição do dispositivo.

userId

string

O identificador de um usuário do dispositivo.
callSign

string

O indicativo de chamada do operador do dispositivo.
state

enum (State)

Estado da configuração.

isSigned

boolean

Apenas saída. Indica se a configuração foi assinada por um CPI.
updateTime

string (Timestamp format)

Apenas saída. A última vez que a configuração do dispositivo foi editada.

É um carimbo de data/hora no formato UTC "Zulu" RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

DeviceCategory

Categoria da FCC do dispositivo, conforme definido na Parte 96.

Enums
DEVICE_CATEGORY_UNSPECIFIED Categoria de dispositivo não especificada.
DEVICE_CATEGORY_A Categoria A.
DEVICE_CATEGORY_B Categoria B.

DeviceModel

Informações sobre o modelo do dispositivo.

Representação JSON 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Campos
vendor

string

O nome do fornecedor do dispositivo.
name

string

O nome do modelo do dispositivo.
softwareVersion

string

A versão do software do dispositivo.
hardwareVersion

string

A versão do hardware do dispositivo.
firmwareVersion

string

A versão do firmware do dispositivo.

DeviceAirInterface

Informações sobre a interface aérea do dispositivo.

Representação JSON 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Campos
radioTechnology

enum (RadioTechnology)

Este campo especifica a tecnologia de acesso de rádio usada para o CBSD.

Condicional
supportedSpec

string

Esse campo está relacionado ao campo "radioTechnology" e fornece a especificação da interface aérea com que o CBSD está em conformidade no momento do registro.

Opcional

RadioTechnology

Os tipos aprovados de tecnologia de acesso por rádio.

Enums
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

InstallationParams

Informações sobre os parâmetros de instalação do dispositivo.

Representação 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
}
Campos
latitude

number

Latitude do local da antena do dispositivo em graus em relação ao datum WGS 84. O intervalo permitido é de -90.000000 a +90.000000. Valores positivos representam latitudes ao norte do equador, e valores negativos representam latitudes ao sul.
longitude

number

Longitude da localização da antena do dispositivo, em graus relativos ao datum WGS 84. O intervalo permitido é de -180.000000 a +180.000000. Valores positivos representam longitudes a leste do meridiano principal, e valores negativos a oeste.
height

number

Altura da antena do dispositivo em metros. Quando o valor do parâmetro "heightType" é "AGL", a altura da antena precisa ser informada em relação ao nível do solo. Quando o valor do parâmetro heightType é "AMSL", ele é fornecido em relação ao datum WGS84.
heightType

enum (HeightType)

Especifica como a altura é medida.

horizontalAccuracy

number

Um número positivo em metros para indicar a precisão da localização horizontal da antena do dispositivo. Esse parâmetro opcional só deve estar presente se o valor dele for menor que a exigência da FCC de 50 metros.
verticalAccuracy

number

Um número positivo em metros para indicar a precisão da localização vertical da antena do dispositivo. Esse parâmetro opcional só deve estar presente se o valor dele for menor que o requisito da FCC de 3 metros.
indoorDeployment

boolean

Se a antena do dispositivo está em um ambiente interno ou não. Verdadeiro: ambiente interno. Falso: ao ar livre.
antennaAzimuth

integer

Direção de mira do plano horizontal da antena em graus em relação ao norte verdadeiro. O valor desse parâmetro é um número inteiro entre 0 e 359, inclusive. Um valor de 0 grau significa norte verdadeiro, e um valor de 90 graus significa leste. Esse parâmetro é opcional para dispositivos da categoria A e condicional para dispositivos da categoria B.
antennaDowntilt

integer

Inclinação vertical da antena em graus, um número inteiro com um valor entre -90 e +90, inclusive. Um valor negativo significa que a antena está inclinada para cima (acima da horizontal). Esse parâmetro é opcional para dispositivos da categoria A e condicional para dispositivos da categoria B.
antennaGain

integer

Ganho máximo da antena em dBi. Esse parâmetro é um número inteiro com um valor entre -127 e +128 (dBi), inclusive.
eirpCapability

integer

Esse parâmetro é o EIRP máximo do dispositivo em unidades de dBm/10MHz e é um número inteiro com um valor entre -127 e +47 (dBm/10 MHz), inclusive. Se não for incluído, o SAS vai interpretar como a potência isotrópica radiada equivalente máxima permitida em unidades de dBm/10MHz para a categoria do dispositivo.
antennaBeamwidth

integer

Largura do feixe de antena de 3 dB da antena no plano horizontal em graus. Esse parâmetro é um número inteiro sem sinal com um valor entre 0 e 360 (graus), inclusive. Ele é opcional para dispositivos da categoria A e condicional para dispositivos da categoria B.
antennaModel

string

Se uma antena externa for usada, o modelo dela poderá ser informado neste campo. A string tem um comprimento máximo de 128 octetos.

HeightType

Especifica como a altura é medida.

Enums
HEIGHT_TYPE_UNSPECIFIED Tipo de altura não especificado.
HEIGHT_TYPE_AGL A altura AGL é medida em relação ao nível do solo.
HEIGHT_TYPE_AMSL A altura AMSL é medida em relação ao nível médio do mar.

MeasurementCapability

Capacidade de medição do dispositivo. Os valores são definidos por [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Estado

Estado do dispositivo.

Enums
DEVICE_STATE_UNSPECIFIED Estado não especificado.
RESERVED O dispositivo foi criado no portal da SAS, mas ainda não foi registrado na SAS.
REGISTERED O dispositivo foi registrado com o SAS.
DEREGISTERED O dispositivo foi cancelado do registro com o SAS.

DeviceGrant

Concessão de dispositivo. É uma autorização fornecida pelo Sistema de acesso ao espectro a um dispositivo para transmitir usando parâmetros operacionais especificados após um sinal de pulso bem-sucedido do dispositivo.

Representação JSON 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
Campos
maxEirp

number

Potência isotrópica irradiada equivalente (EIRP) máxima permitida pela concessão. O EIRP máximo está em unidades de dBm/MHz. O valor de maxEirp representa o EIRP médio (RMS) que seria medido pelo procedimento definido na parte 96.41(e)(3) da FCC.
frequencyRange

object (FrequencyRange)

O intervalo de frequência de transmissão.

state

enum (GrantState)

Estado da concessão.

channelType

enum (ChannelType)

Tipo de canal usado.

moveList[]

object (DpaMoveList)

As listas de movimentação de DPA em que essa concessão aparece.

expireTime

string (Timestamp format)

O prazo de validade da concessão.

É um carimbo de data/hora no formato UTC "Zulu" RFC3339, medido com precisão de nanossegundos. Exemplo: "2014-10-02T15:01:23.045123456Z".

FrequencyRange

Intervalo de frequência de low_frequency a high_frequency.

Representação JSON 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Campos
lowFrequencyMhz

number

A menor frequência do intervalo em MHz.
highFrequencyMhz

number

A maior frequência do intervalo de frequência em MHz.

GrantState

O estado da concessão.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED A concessão foi feita, mas o dispositivo não está enviando pulsações nela.
GRANT_STATE_TERMINATED A concessão foi encerrada pelo SAS.
GRANT_STATE_SUSPENDED A concessão foi suspensa pelo SAS.
GRANT_STATE_AUTHORIZED O dispositivo está transmitindo no momento.
GRANT_STATE_EXPIRED A concessão expirou.

ChannelType

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Uma entrada na lista de movimentação de um DPA.

Representação JSON 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Campos
dpaId

string

O ID da DPA.
frequencyRange

object (FrequencyRange)

O intervalo de frequência afetado pela lista de movimentos.

Métodos

create

 Cria um device em um node ou customer.

createSigned

 Cria um device assinado em um node ou customer.

delete

 Exclui um device.

get

 Recebe detalhes sobre um device.

list

 Lista devices em um node ou customer.

move

 Move um device para outro node ou customer.

patch

 Atualiza um device.

signDevice

 Assina um device.

updateSigned

 Atualiza um device assinado.