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

deviceMetadata

object (DeviceMetadata)

Parámetros de dispositivos que se pueden anular mediante el SAS Portal y las solicitudes de registro de SAS.

currentChannels[]
(deprecated)

object (ChannelWithScore)

Solo salida. Canales actuales con puntuaciones

grantRangeAllowlists[]

object (FrequencyRange)

Solo los rangos que están dentro de las listas de entidades permitidas están disponibles para las subvenciones nuevas.

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.

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

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

supportedSpec

string

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

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
CW
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,
  "cpeCbsdIndication": boolean
}
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 "GLA", 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. true: Interior false: Exteriores

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.

cpeCbsdIndication

boolean

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

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.

Enumeradores
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

State

Estado de la configuración del dispositivo. Solo se pueden usar archivos de configuración con el estado DEVICE_CONFIG_STATE_FINAL durante el registro de la CBSD.

Enumeradores
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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 DGS/MHz. El valor de maxEirp 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.

Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

suspensionReason[]

string

Si se suspende la concesión, el motivo de la suspensión.

grantId

string

ID de la subvención.

lastHeartbeatTransmitExpireTime

string (Timestamp format)

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

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

Metadatos del dispositivo

Datos del dispositivo que el portal de SAS y las solicitudes de registro pueden anular.

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

string

Grupo de Coordinación de Interferencias (ICG). Un grupo de CBSD que administran su propia interferencia con el grupo. Para obtener más información, consulta CBRSA-TS-2001 V3.0.0.

commonChannelGroup

string

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

antennaModel

string

Si se propaga, el patrón 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 Baja Nacional.

nrqzValidation

object (NrqzValidation)

Solo salida. Información de validación de National Radio Zone.

Validación Nrqz

Información sobre la validación de la Zona tranquila de la Radio Nacional

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

enum (State)

Estado de la información de validación de la NRQZ.

caseId

string

ID del caso de validación

latitude

number

Es la latitud del dispositivo asociada con la validación.

longitude

number

Longitud del dispositivo asociada con la validación.

cpiId

string

CPI que firmó la validación.

State

Estado de la información de validación de la NRQZ.

Enumeradores
STATE_UNSPECIFIED Estado sin especificar.
DRAFT Estado del borrador.
FINAL Estado final.

CanalConPuntuación

El canal con puntuación.

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

object (FrequencyRange)

Es el intervalo de frecuencia del canal.

score

number

La puntuación del canal, normalizada para estar en el rango [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 devices en node o customer.