REST Resource: customers.deployments.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,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "currentChannels": [
    {
      object (ChannelWithScore)
    }
  ],
  "grantRangeAllowlists": [
    {
      object (FrequencyRange)
    }
  ]
}
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.
deviceMetadata

object (DeviceMetadata)

Parâmetros do dispositivo que podem ser substituídos pelo portal do SAS e pelas solicitações de registro do SAS.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Apenas saída. Canais atuais com pontuações.
grantRangeAllowlists[]

object (FrequencyRange)

Somente os intervalos que estão nas listas de permissões estão disponíveis para novos benefícios.

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 RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "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)

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

string

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

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
CW
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,
  "cpeCbsdIndication": boolean
}
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 do local 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 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. true: indoor. false: outdoor.
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.
cpeCbsdIndication

boolean

Se presente, esse parâmetro especifica se o CBSD é um CPE-CBSD ou não.

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.

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Estado

Estado da configuração do dispositivo. Somente as configurações no estado DEVICE_CONFIG_STATE_FINAL podem ser usadas durante o registro do CBSD.

Enums
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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 RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Se a concessão for suspensa, os motivos da suspensão.
grantId

string

ID da concessão.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

O prazo de validade da transmissão do último sinal de funcionamento.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "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.

DeviceMetadata

Dados do dispositivo substituíveis pelo Portal do SAS e por solicitações de registro.

Representação JSON 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Campos
interferenceCoordinationGroup

string

Grupo de coordenação de interferência (ICG, na sigla em inglês). Um grupo de CBSDs que gerenciam a própria interferência com o grupo. Para mais detalhes, consulte CBRSA-TS-2001 V3.0.0 (em inglês).
commonChannelGroup

string

Grupo de canais comum (CCG, na sigla em inglês). Um grupo de CBSDs no mesmo ICG solicitando uma atribuição de canal principal comum. Para mais detalhes, consulte CBRSA-TS-2001 V3.0.0 (em inglês).
antennaModel

string

Se preenchido, o padrão de modelo de antena a ser usado. O formato é: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Apenas saída. Defina como true se um CPI tiver validado que coordenou com o escritório da National Quiet Zone.
nrqzValidation

object (NrqzValidation)

Apenas saída. Informações de validação da National Radio Quiet Zone.

NrqzValidation

Informações sobre a validação da Zona Nacional de Silêncio de Rádio.

Representação JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Campos
state

enum (State)

Estado das informações de validação da NRQZ.
caseId

string

ID do caso de validação.
latitude

number

Latitude do dispositivo associada à validação.
longitude

number

Longitude do dispositivo associada à validação.
cpiId

string

CPI que assinou a validação.

Estado

Estado das informações de validação da NRQZ.

Enums
STATE_UNSPECIFIED Estado não especificado.
DRAFT Estado do rascunho.
FINAL Estado final.

ChannelWithScore

O canal com pontuação.

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

object (FrequencyRange)

O intervalo de frequência do canal.
score

number

A pontuação do canal, normalizada para estar no intervalo [0,100].

Métodos

create

 Cria um device em um node ou customer.

createSigned

 Cria um device assinado em um node ou customer.

list

 Lista devices em um node ou customer.