REST Resource: customers.deployments.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,
  "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 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.
deviceMetadata

object (DeviceMetadata)

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

object (ChannelWithScore)

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

object (FrequencyRange)

Somente intervalos dentro das listas de permissões estão disponíveis para novas concessões.

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.

Timestamp 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

É 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)

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

string

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

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
CW
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,
  "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 as latitudes ao norte do equador; valores negativos, ao sul do equador.
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 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 é "AGL" a altura da antena deve ser determinada 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. true: interno. false: 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.
cpeCbsdIndication

boolean

Se estiver presente, esse parâmetro especificará se o CBSD é um CPE-CBSD.

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.

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Estado

Estado da configuração do dispositivo. Somente 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 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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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.

Timestamp 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 o subsídio for suspenso, os motivos para a suspensão.
grantId

string

ID do subsídio.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

O horário de expiração da transmissão do último batimento cardíaco.

Timestamp 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".

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.

Metadados do dispositivo

Dados do dispositivo substituíveis pelo Portal SAS e pelas 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). Um grupo de CBSDs que gerenciam a própria interferência no grupo. Para saber mais detalhes, consulte CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Grupo de canais comum (CCG). Um grupo de CBSDs no mesmo ICG solicitando a atribuição de um canal principal comum. Para saber mais detalhes, consulte CBRSA-TS-2001 V3.0.0.
antennaModel

string

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

boolean

Apenas saída. Defina como true se um CPI validou que ele coordenou as atividades com o escritório nacional tranquilo da zona zona.
nrqzValidation

object (NrqzValidation)

Apenas saída. Informações de validação da Zona silenciosa do rádio nacional.

NrqzValidation

Informações sobre a validação da Zona silenciosa do National Radio.

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

Código 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 de rascunho.
FINAL Estado final.

Pontuação do canal

O canal com a 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

 Crie um device em node ou customer.

createSigned

 Crie um device assinado em um node ou customer.

list

 Lista devices em uma node ou customer.