REST Resource: customers.devices

Recurso: dispositivo

Representación JSON 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
Campos
name

string

Solo salida. El nombre de la ruta de acceso al recurso.
fccId

string

El identificador de la FCC del dispositivo.
serialNumber

string

Es un número de serie asignado al dispositivo por el fabricante.
preloadedConfig

object (DeviceConfig)

Configuración del dispositivo, como se especifica a través de la API del portal de SAS.

activeConfig

object (DeviceConfig)

Solo salida. Configuración actual del dispositivo registrado en la SAS.

state

enum (State)

Solo salida. Estado del dispositivo.

grants[]

object (DeviceGrant)

Solo salida. Subvenciones en posesión del dispositivo.
displayName

string

Nombre visible del dispositivo.

DeviceConfig

Información sobre la configuración del dispositivo.

Representación 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)

FCC del dispositivo.

model

object (DeviceModel)

Información sobre este modelo de dispositivo.

airInterface

object (DeviceAirInterface)

Información sobre la interfaz de aire de este dispositivo.

installationParams

object (InstallationParams)

Parámetros de instalación para el dispositivo.

measurementCapabilities[]

enum (MeasurementCapability)

Capacidades de informes de medición del dispositivo.

userId

string

El identificador de un usuario del dispositivo.
callSign

string

Indicador de llamada del operador del dispositivo.
state

enum (State)

Es el estado de la configuración.

isSigned

boolean

Solo salida. Si la configuración cuenta con la firma de un CPI
updateTime

string (Timestamp format)

Solo salida. La última vez que se editó la configuración del dispositivo.

Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

DeviceCategory

FCC, según se define en la parte 96.

Enumeradores
DEVICE_CATEGORY_UNSPECIFIED Categoría de dispositivo no especificada
DEVICE_CATEGORY_A Categoría A.
DEVICE_CATEGORY_B Categoría B.

Modelodeldispositivo

Información sobre el modelo del dispositivo.

Representación JSON 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Campos
vendor

string

El nombre del proveedor del dispositivo.
name

string

El nombre del modelo del dispositivo.
softwareVersion

string

Es la versión de software del dispositivo.
hardwareVersion

string

Indica la versión de hardware del dispositivo.
firmwareVersion

string

La versión de firmware del dispositivo.

Interfaz de dispositivo

Información sobre la interfaz de aire del dispositivo

Representación JSON 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Campos
radioTechnology

enum (RadioTechnology)

Este campo especifica la tecnología de acceso por radio que se usa para el CBSD.

Condicional
supportedSpec

string

Este campo está relacionado con el campo de radiotecnología y proporciona la especificación de interfaz de aire que el CBSD cumple en el momento del registro.

Opcional

Radiotecnología

Los tipos aprobados de tecnología de acceso a la radio.

Enumeradores
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

Parámetros de instalación

Información sobre los parámetros de instalación del dispositivo.

Representación 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

Latitud de la ubicación de la antena del dispositivo en grados con respecto al datum WGS84. El rango permitido es de -90.000000 a +90.000000. Los valores positivos representan latitudes al norte del ecuador; valores negativos al sur del ecuador.
longitude

number

Longitud de la ubicación de la antena del dispositivo, en grados respecto del datum WGS84. El rango permitido es de -180.000000 a +180.000000. Los valores positivos representan las longitudes al este del primer meridiano; los valores negativos al oeste del primer meridiano.
height

number

Altura de la antena del dispositivo en metros. Cuando el valor del parámetro heightType es “AGL”, la altura de la antena se debe establecer en relación con el nivel del suelo. Cuando el valor del parámetro heightType es "AMSL", se proporciona con respecto al datum WGS84.
heightType

enum (HeightType)

Especifica cómo se mide la altura.

horizontalAccuracy

number

Un número positivo en metros que indica la precisión de la ubicación horizontal de la antena del dispositivo. Este parámetro opcional solo debe estar presente si su valor es inferior al requisito de la FCC de 50 metros.
verticalAccuracy

number

Un número positivo en metros que indica la precisión de la ubicación vertical de la antena del dispositivo. Este parámetro opcional solo debe estar presente si su valor es inferior al requisito de la FCC de 3 metros.
indoorDeployment

boolean

Indica si la antena del dispositivo está en interiores o no. Verdadero: en interiores. Falso: al aire libre.
antennaAzimuth

integer

Es la dirección de la vista del plano horizontal de la antena en grados con respecto al norte verdadero. El valor de este parámetro es un número entero con un valor entre 0 y 359 inclusive. Un valor de 0 grados significa el norte verdadero; un valor de 90 grados significa este. Este parámetro es opcional para dispositivos de categoría A y condicional para dispositivos de categoría B.
antennaDowntilt

integer

Antena inclinada en grados y un número entero con un valor entre -90 y +90 inclusive; un valor negativo significa que la antena está inclinada hacia arriba (arriba horizontal). Este parámetro es opcional para dispositivos de categoría A y condicional para dispositivos de categoría B.
antennaGain

integer

Aumento máximo de antena en dBi Este parámetro es un número entero con un valor entre -127 y +128 (dBi) inclusive.
eirpCapability

integer

Este parámetro es el PIRE máximo del dispositivo en unidades de DGS/10 MHz y es un número entero con un valor entre -127 y +47 (dBm/10 MHz), inclusive. Si no se incluye, SAS lo interpreta como un PIRE máximo permitido en unidades de DGS/10 MHz para la categoría del dispositivo.
antennaBeamwidth

integer

Ancho de haz de la antena de 3 dB en el plano horizontal en grados. Este parámetro es un número entero sin signo que tiene un valor entre 0 y 360 (grados), inclusive; es opcional para dispositivos de categoría A y condicionales para dispositivos de categoría B.
antennaModel

string

Si se utiliza una antena externa, se puede proporcionar el modelo de antena en este campo. La string tiene una longitud máxima de 128 octetos.

Tipo de estatura

Especifica cómo se mide la altura.

Enumeradores
HEIGHT_TYPE_UNSPECIFIED Tipo de altura no especificado.
HEIGHT_TYPE_AGL La altura AGL se mide en relación con el nivel del suelo.
HEIGHT_TYPE_AMSL La altura AMSL se mide en relación con el nivel del mar promedio.

Capacidad de medición

Capacidad de medición del dispositivo. Los valores se definen según [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

Enumeradores
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

State

Estado del dispositivo.

Enumeradores
DEVICE_STATE_UNSPECIFIED Estado sin especificar.
RESERVED Sin embargo, el dispositivo creado en el portal de SAS aún no está registrado en SAS.
REGISTERED Dispositivo registrado en SAS
DEREGISTERED Se anuló el registro del dispositivo con SAS.

Dispositivo Grants

Concesión de dispositivo. Es una autorización que proporciona el Sistema de acceso a Spectrum a un dispositivo para transmitir usando parámetros operativos especificados después de que el dispositivo ejecuta el ritmo cardíaco correctamente.

Representación JSON 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
Campos
maxEirp

number

Potencia radiada isotrópica máxima equivalente (EIRP) permitida por la subvención. El PIRE máximo se indica en unidades de terabytes/MHz. El valor de PIRE promedio representa el PIRE promedio (RMS) que se mediría mediante el procedimiento definido en la parte 96.41(e)(3) de la FCC.
frequencyRange

object (FrequencyRange)

El rango de frecuencia de transmisión.

state

enum (GrantState)

Estado de la subvención.

channelType

enum (ChannelType)

Tipo de canal utilizado

moveList[]

object (DpaMoveList)

Las listas de movimiento de APD en las que aparece esta subvención.

expireTime

string (Timestamp format)

La fecha de vencimiento de la concesión.

Es una marca de tiempo en el formato RFC3339 UTC "Zulu", con precisión de nanosegundos. Ejemplo: "2014-10-02T15:01:23.045123456Z".

Rango de frecuencia

Rango de frecuencia de low_frequency a high_frequency.

Representación JSON 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Campos
lowFrequencyMhz

number

La frecuencia más baja del rango de frecuencia en MHz.
highFrequencyMhz

number

La frecuencia más alta del rango de frecuencia en MHz.

Estado de otorgamiento

El estado de la subvención.

Enumeradores
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Se otorgó la concesión, pero el dispositivo no hace latir el corazón.
GRANT_STATE_TERMINATED El SAS rescindió la concesión.
GRANT_STATE_SUSPENDED SAS suspendió la subvención.
GRANT_STATE_AUTHORIZED El dispositivo está transmitiendo contenido.
GRANT_STATE_EXPIRED El subsidio venció.

Tipo de canal

Enumeradores
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

Lista de DPAMove

Una entrada en una lista de movimiento de APD

Representación JSON 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Campos
dpaId

string

Es el ID de la APD.
frequencyRange

object (FrequencyRange)

El rango de frecuencia que afecta la lista de movimientos.

Métodos

create

 Crea un device en un node o customer.

createSigned

 Crea un device firmado en un node o customer.

delete

 Borra un device.

get

 Obtiene detalles sobre un device.

list

 Enumera devices en node o customer.

move

 Mueve un device dentro de otro node o customer.

patch

 Actualiza un device.

signDevice

 Firma un device.

updateSigned

 Actualiza un device firmado.