REST Resource: customers.devices

Recurso: dispositivo

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 SAS Portal.

activeConfig

object (DeviceConfig)

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

state

enum (State)

Apenas saída. Estado do dispositivo.

grants[]

object (DeviceGrant)

Apenas saída. Substituições de propriedade do 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 da FCC do dispositivo.

model

object (DeviceModel)

Informações sobre o modelo do 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

Identificador de um usuário do dispositivo.
callSign

string

O sinal 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

É a categoria da FCC do dispositivo, conforme definido pela parte 96.

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

Modelo do dispositivo

São 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.

InterfaceAardoDispositivo

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 à rádio usada para o CBSD.

Condicional
supportedSpec

string

Esse campo está relacionado ao campo radioRadio e fornece a especificação da interface do ar que o CBSD está em conformidade no momento do registro.

Opcional

Radiotecnologia

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

Enums
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

Parâmetros de instalação

São 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 as latitudes ao norte do equador; valores negativos, ao sul do equador.
longitude

number

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

number

Altura da antena do dispositivo em metros. Quando o valor do parâmetro heightType for "AGL" a altura da antena deve ser fornecida 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ó precisa estar presente se o valor dele for menor que o requisito 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ó precisa estar presente se o valor dele for menor que o requisito da FCC de três metros.
indoorDeployment

boolean

Indica se a antena do dispositivo está interna ou não. Verdadeiro: interno. Falso: ao ar livre.
antennaAzimuth

integer

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

integer

A inclinação da antena em graus e é 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). Este parâmetro é opcional para dispositivos de Categoria A e condicional para dispositivos de Categoria B.
antennaGain

integer

Ganho de pico da antena em dBi. Este parâmetro é um número inteiro com um valor entre -127 e +128 (dBi).
eirpCapability

integer

Esse parâmetro é o EIRP máximo do dispositivo em unidades de dBm/10 MHz e é um número inteiro com um valor entre -127 e +47 (dBm/10 MHz) inclusivo. Se não for incluído, o SAS o interpretará como EIRP máximo permitido em unidades de dBm/10 MHz para a categoria de 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 assinatura com valor entre 0 e 360 (graus). Ele é opcional para dispositivos da categoria A e condicional para dispositivos da categoria B.
antennaModel

string

Se uma antena externa é usada, o modelo da antena pode ser fornecido nesse campo. A string tem um comprimento máximo de 128 octetos.

Tipo de altura

Especifica como a altura é medida.

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

Capacidade de medição

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 No entanto, o dispositivo criado no Portal SAS ainda não está registrado no SAS.
REGISTERED Dispositivo registrado no SAS.
DEREGISTERED Dispositivo com o registro SAS cancelado.

Concessão de dispositivo

Concessão de dispositivo. É uma autorização fornecida pelo sistema de acesso ao espectro para um dispositivo transmitir usando parâmetros operacionais especificados após um batimento cardíaco bem-sucedido feito pelo 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 equivalente isotrópica radiada (EIRP) 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 FCC 96.41(e)(3).
frequencyRange

object (FrequencyRange)

É o intervalo de frequência da transmissão.

state

enum (GrantState)

Estado do subsídio.

channelType

enum (ChannelType)

Tipo de canal usado.

moveList[]

object (DpaMoveList)

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

expireTime

string (Timestamp format)

O prazo de vencimento do subsídio.

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

Intervalo de frequência

O intervalo de frequência é de low_frequency a high_frequency.

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

number

A frequência mais baixa do intervalo de frequência em MHz.
highFrequencyMhz

number

A frequência mais alta do intervalo de frequência em MHz.

Estado de concessão

O estado do subsídio.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED A concessão foi concedida, mas o dispositivo não está batendo nela.
GRANT_STATE_TERMINATED O subsídio foi encerrado pelo SAS.
GRANT_STATE_SUSPENDED O subsídio foi suspenso pelo SAS.
GRANT_STATE_AUTHORIZED O dispositivo está transmitindo.
GRANT_STATE_EXPIRED O benefício expirou.

Tipo de canal

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Uma entrada em uma lista de movimento da DPA.

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

string

É o ID da DPA.
frequencyRange

object (FrequencyRange)

O intervalo de frequência que a lista de movimento afeta.

Métodos

create

 Crie um device em node ou customer.

createSigned

 Crie um device assinado em um node ou customer.

delete

 Exclui um device.

get

 Recebe detalhes sobre um device.

list

 Lista devices em uma 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.