REST Resource: customers.devices

Recurso: Device

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. Es el nombre de la ruta de acceso al recurso.
fccId

string

Es el identificador de la FCC del dispositivo.
serialNumber

string

Es un número de serie que el fabricante del dispositivo le asigna a este.
preloadedConfig

object (DeviceConfig)

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

activeConfig

object (DeviceConfig)

Solo salida. Es la configuración actual del dispositivo tal como se registró en el SAS.

state

enum (State)

Solo salida. Es el estado del dispositivo.

grants[]

object (DeviceGrant)

Solo salida. Son los permisos que tiene el dispositivo.
displayName

string

Nombre visible del dispositivo.

DeviceConfig

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

Es la categoría de la FCC del dispositivo.

model

object (DeviceModel)

Es información sobre este modelo de dispositivo.

airInterface

object (DeviceAirInterface)

Es información sobre la interfaz de aire de este dispositivo.

installationParams

object (InstallationParams)

Son los parámetros de instalación del dispositivo.

measurementCapabilities[]

enum (MeasurementCapability)

Son las capacidades de informes de medición del dispositivo.

userId

string

Es el identificador de un usuario del dispositivo.
callSign

string

Es el distintivo de llamada del operador del dispositivo.
state

enum (State)

Es el estado de la configuración.

isSigned

boolean

Solo salida. Indica si un CPI firmó la configuración.
updateTime

string (Timestamp format)

Solo salida. Es 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

Es la categoría de FCC del dispositivo, según se define en el artículo 96.

Enumeraciones
DEVICE_CATEGORY_UNSPECIFIED Categoría de dispositivo sin especificar.
DEVICE_CATEGORY_A Categoría A.
DEVICE_CATEGORY_B Categoría B

DeviceModel

Es información sobre el modelo del dispositivo.

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

string

Es el nombre del proveedor del dispositivo.
name

string

Es el nombre del modelo del dispositivo.
softwareVersion

string

Es la versión de software del dispositivo.
hardwareVersion

string

Es la versión de hardware del dispositivo.
firmwareVersion

string

Es la versión de firmware del dispositivo.

DeviceAirInterface

Es 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 la CBSD.

Condicional
supportedSpec

string

Este campo se relaciona con el campo radioTechnology y proporciona la especificación de la interfaz de aire con la que cumple la CBSD en el momento del registro.

Opcional

RadioTechnology

Son los tipos aprobados de tecnología de acceso por radio.

Enumeraciones
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

InstallationParams

Es 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 en relación con el datum WGS 84. El rango permitido es de -90.000000 a +90.000000. Los valores positivos representan latitudes al norte del ecuador, y los valores negativos, al sur del ecuador.
longitude

number

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

number

Altura de la antena del dispositivo en metros. Cuando el valor del parámetro heightType es "AGL", la altura de la antena debe indicarse 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

Es 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

Es 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 es para interiores o no. Verdadero: Interior. Falso: Exterior.
antennaAzimuth

integer

Dirección de la línea de visión 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 norte verdadero, y un valor de 90 grados significa este. Este parámetro es opcional para los dispositivos de categoría A y condicional para los dispositivos de categoría B.
antennaDowntilt

integer

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

integer

Es la ganancia máxima de la 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 la PIRE máxima del dispositivo en unidades de dBm/10 MHz y es un número entero con un valor entre -127 y +47 (dBm/10 MHz) inclusive. Si no se incluye, el SAS lo interpreta como la PIRE máxima permitida en unidades de dBm/10 MHz para la categoría del dispositivo.
antennaBeamwidth

integer

Ancho del 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 los dispositivos de categoría A y condicional para los dispositivos de categoría B.
antennaModel

string

Si se usa una antena externa, el modelo de la antena se proporciona de forma opcional en este campo. La cadena tiene una longitud máxima de 128 octetos.

HeightType

Especifica cómo se mide la altura.

Enumeraciones
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 medio del mar.

MeasurementCapability

Es la capacidad de medición del dispositivo. Los valores se definen en [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

Enumeraciones
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Estado

Es el estado del dispositivo.

Enumeraciones
DEVICE_STATE_UNSPECIFIED Estado sin especificar.
RESERVED El dispositivo se creó en el portal de SAS, pero aún no se registró en SAS.
REGISTERED El dispositivo se registró en el SAS.
DEREGISTERED El dispositivo se dio de baja en el SAS.

DeviceGrant

Es el otorgamiento de acceso al dispositivo. Es una autorización que proporciona el Sistema de acceso al espectro a un dispositivo para transmitir con parámetros operativos especificados después de que el dispositivo envía un latido correctamente.

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

number

Potencia isotrópica radiada equivalente (PIRE) máxima permitida por el subsidio. La EIRP máxima se expresa en unidades de dBm/MHz. El valor de maxEirp representa la EIRP promedio (RMS) que se mediría con el procedimiento definido en la sección 96.41(e)(3) de la FCC.
frequencyRange

object (FrequencyRange)

Es el rango de frecuencia de transmisión.

state

enum (GrantState)

Estado del permiso.

channelType

enum (ChannelType)

Es el tipo de canal que se usó.

moveList[]

object (DpaMoveList)

Son las listas de traslado de la DPA en las que aparece esta concesión.

expireTime

string (Timestamp format)

Es la hora de vencimiento del permiso.

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

FrequencyRange

El rango de frecuencia es de low_frequency a high_frequency.

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

number

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

number

Es la frecuencia más alta del rango de frecuencia en MHz.

GrantState

Es el estado del otorgamiento.

Enumeraciones
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Se otorgó el permiso, pero el dispositivo no envía latidos a través de él.
GRANT_STATE_TERMINATED La SAS canceló el otorgamiento.
GRANT_STATE_SUSPENDED La SAS suspendió el otorgamiento.
GRANT_STATE_AUTHORIZED El dispositivo está transmitiendo.
GRANT_STATE_EXPIRED Venció la concesión.

ChannelType

Enumeraciones
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Es una entrada en la lista de movimientos de una DPA.

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

string

Es el ID del DPA.
frequencyRange

object (FrequencyRange)

Es 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 los devices en un node o customer.

move

 Mueve un device debajo de otro node o customer.

patch

 Actualiza un device.

signDevice

 Firma un device.

updateSigned

 Actualiza un device firmado.