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

object (DeviceMetadata)

Son los parámetros del dispositivo que pueden anularse con las solicitudes de registro del SAS y del portal del SAS.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Solo salida. Son los canales actuales con puntuaciones.
grantRangeAllowlists[]

object (FrequencyRange)

Solo los rangos que se encuentran dentro de las listas de entidades permitidas están disponibles para los permisos nuevos.

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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "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)

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

string

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

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
CW
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,
  "cpeCbsdIndication": boolean
}
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

Es la longitud de la ubicación de la antena del dispositivo en grados en relación con el 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. true: indoor. false: 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.
cpeCbsdIndication

boolean

Si está presente, este parámetro especifica si la CBSD es una CPE-CBSD o no.

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.

Enumeraciones
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Estado

Es el estado de la configuración del dispositivo. Solo se pueden usar los parámetros de configuración en el estado DEVICE_CONFIG_STATE_FINAL durante el registro de CBSD.

Enumeraciones
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Si el subsidio se suspendió, se indican los motivos de la suspensión.
grantId

string

Es el ID del subsidio.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Es la hora de vencimiento de transmisión de la última señal de monitoreo de funcionamiento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "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.

DeviceMetadata

Datos del dispositivo que pueden anularse tanto con el SAS Portal como con las solicitudes de registro.

Representación JSON 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Campos
interferenceCoordinationGroup

string

Grupo de Coordinación de Interferencias (ICG). Es un grupo de CBSD que administra su propia interferencia con el grupo. Para obtener más detalles, consulta CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Grupo de canales común (CCG). Es un grupo de CBSD en el mismo ICG que solicita una asignación de canal principal común. Para obtener más detalles, consulta CBRSA-TS-2001 V3.0.0.
antennaModel

string

Si se completa, es el patrón del modelo de antena que se usará. Formato: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Solo salida. Se establece en true si un CPI validó que se coordinó con la oficina de la Zona Nacional de Tranquilidad.
nrqzValidation

object (NrqzValidation)

Solo salida. Es información de validación de la Zona Nacional de Silencio Radioeléctrico.

NrqzValidation

Es información sobre la validación de la Zona Nacional de Silencio Radioeléctrico.

Representación JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Campos
state

enum (State)

Es el estado de la información de validación de la NRQZ.
caseId

string

Es el ID del caso de validación.
latitude

number

Latitud del dispositivo asociada a la validación.
longitude

number

Es la longitud del dispositivo asociada a la validación.
cpiId

string

Es el CPI que firmó la validación.

Estado

Es el estado de la información de validación de la NRQZ.

Enumeraciones
STATE_UNSPECIFIED Estado sin especificar.
DRAFT Es el estado de borrador.
FINAL Es el estado final.

ChannelWithScore

Es el canal con la puntuación.

Representación JSON 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Campos
frequencyRange

object (FrequencyRange)

Es el rango de frecuencia del canal.
score

number

Es la puntuación del canal, normalizada para que se encuentre en el rango de [0,100].

Métodos

create

 Crea un device en un node o customer.

createSigned

 Crea un device firmado en un node o customer.

list

 Enumera los devices en un node o customer.