REST Resource: customers.devices

Risorsa: dispositivo

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

string

Solo output. Il nome del percorso della risorsa.

fccId

string

L'identificatore FCC del dispositivo.

serialNumber

string

Un numero di serie assegnato al dispositivo dal produttore.

preloadedConfig

object (DeviceConfig)

Configurazione del dispositivo, come specificato tramite l'API SAS Portal.

activeConfig

object (DeviceConfig)

Solo output. Configurazione attuale del dispositivo come registrata presso la SAS.

state

enum (State)

Solo output. Stato del dispositivo.

grants[]

object (DeviceGrant)

Solo output. Concessioni detenute dal dispositivo.

displayName

string

Nome visualizzato del dispositivo.

DeviceConfig

Informazioni sulla configurazione del dispositivo.

Rappresentazione 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
}
Campi
category

enum (DeviceCategory)

Categoria FCC del dispositivo.

model

object (DeviceModel)

Informazioni su questo modello di dispositivo.

airInterface

object (DeviceAirInterface)

Informazioni sull'interfaccia relativa al dispositivo.

installationParams

object (InstallationParams)

Parametri di installazione per il dispositivo.

measurementCapabilities[]

enum (MeasurementCapability)

Funzionalità di generazione di report di misurazione del dispositivo.

userId

string

L'identificatore di un utente del dispositivo.

callSign

string

Il nominativo dell'operatore del dispositivo.

state

enum (State)

Stato della configurazione.

isSigned

boolean

Solo output. Indica se la configurazione è stata firmata da un CPI.

updateTime

string (Timestamp format)

Solo output. L'ultima volta che la configurazione del dispositivo è stata modificata.

Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".

Categoria

Categoria FCC del dispositivo, come definito dalla Parte 96.

Enum
DEVICE_CATEGORY_UNSPECIFIED Categoria dispositivo non specificata.
DEVICE_CATEGORY_A Categoria A.
DEVICE_CATEGORY_B Categoria B.

Modello dispositivo

Informazioni sul modello del dispositivo.

Rappresentazione JSON
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Campi
vendor

string

Il nome del fornitore del dispositivo.

name

string

Il nome del modello del dispositivo.

softwareVersion

string

La versione software del dispositivo.

hardwareVersion

string

La versione hardware del dispositivo.

firmwareVersion

string

La versione del firmware del dispositivo.

DeviceAirInterface

Informazioni sull'interfaccia relativa al dispositivo.

Rappresentazione JSON
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Campi
radioTechnology

enum (RadioTechnology)

Questo campo specifica la tecnologia di accesso radio utilizzata per il CBSD.

Condizionale

supportedSpec

string

Questo campo è correlato al campo della radiotecnologia e fornisce le specifiche dell'interfaccia aerea a cui è conforme la CBSD al momento della registrazione.

Facoltativo

Radiotecnologia

I tipi approvati di tecnologia di accesso radio.

Enum
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

Parametri di installazione

Informazioni sui parametri di installazione del dispositivo.

Rappresentazione 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
}
Campi
latitude

number

Latitudine della posizione dell'antenna del dispositivo in gradi rispetto all'origine WGS 84. L'intervallo consentito va da -90.000000 a +90.000000. I valori positivi rappresentano le latitudini a nord dell'equatore, mentre i valori negativi a sud dell'equatore.

longitude

number

Longitudine della posizione dell'antenna del dispositivo, in gradi rispetto all'origine WGS 84. L'intervallo consentito va da -180.000000 a +180.000000. I valori positivi rappresentano le longitudini a est del meridiano zero; i valori negativi a ovest del meridiano zero.

height

number

Altezza dell'antenna del dispositivo in metri. Quando il valore del parametro altezzaType è "AGL", l'altezza dell'antenna deve essere specificata in relazione al livello del suolo. Quando il valore del parametro altezzaType è "AMSL", viene dato in relazione alla data WGS84.

heightType

enum (HeightType)

Specifica come viene misurata l'altezza.

horizontalAccuracy

number

Un numero positivo in metri che indica la precisione della posizione orizzontale dell'antenna del dispositivo. Questo parametro facoltativo deve essere presente solo se il valore è inferiore al requisito FCC (50 metri).

verticalAccuracy

number

Un numero positivo in metri che indica la precisione della posizione verticale dell'antenna del dispositivo. Questo parametro facoltativo deve essere presente solo se il valore è inferiore al requisito FCC di 3 metri.

indoorDeployment

boolean

Indica se l'antenna del dispositivo è al chiuso o meno. Vero: dentro. False: all'aperto.

antennaAzimuth

integer

Direzione del campo visivo del piano orizzontale dell'antenna in gradi rispetto al nord effettivo. Il valore di questo parametro è un numero intero con un valore compreso tra 0 e 359 inclusi. Un valore di 0 gradi significa vero nord; un valore di 90 gradi significa est. Questo parametro è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B.

antennaDowntilt

integer

L'antenna si inclina verso il basso ed è un numero intero con un valore compreso tra -90 e +90 inclusi; un valore negativo indica che l'antenna è inclinata (sopra l'orizzontale). Questo parametro è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B.

antennaGain

integer

Guadagno massimo dell'antenna in dBi. Questo parametro è un numero intero con un valore compreso tra -127 e +128 (dBi) inclusi.

eirpCapability

integer

Questo parametro è l'EIRP massimo del dispositivo in unità di dBm/10 MHz ed è un numero intero con un valore compreso tra -127 e +47 (dBm/10 MHz) inclusi. Se non incluso, SAS lo interpreta come massimo EIRP consentito in unità di dBm/10 MHz per la categoria del dispositivo.

antennaBeamwidth

integer

Larghezza del fascio dell'antenna di 3 dB sul piano orizzontale in gradi. Questo parametro è un numero intero senza segno con un valore compreso tra 0 e 360 (gradi) facoltativo. È facoltativo per i dispositivi di Categoria A e condizionato per i dispositivi di Categoria B.

antennaModel

string

Se si utilizza un'antenna esterna, in questo campo viene facoltativamente fornito il modello dell'antenna. La stringa ha una lunghezza massima di 128 ottetti.

TipoAltezza

Specifica come viene misurata l'altezza.

Enum
HEIGHT_TYPE_UNSPECIFIED Tipo di altezza non specificato.
HEIGHT_TYPE_AGL L'altezza dell'AGL viene misurata rispetto al livello del suolo.
HEIGHT_TYPE_AMSL L'altezza del sistema AMSL viene misurata rispetto al livello medio del mare.

Funzionalità di misurazione

Funzionalità di misurazione dei dispositivi. I valori sono definiti da [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

Enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Stato

Stato del dispositivo.

Enum
DEVICE_STATE_UNSPECIFIED Stato non specificato.
RESERVED Dispositivo creato nel portale SAS, tuttavia non ancora registrato con SAS.
REGISTERED Dispositivo registrato con SAS.
DEREGISTERED Dispositivo registrato con SAS.

Concedi dispositivo

Concessione dispositivo. È un'autorizzazione fornita dal Sistema di accesso allo spettro a un dispositivo per la trasmissione tramite parametri operativi specificati dopo un successo del battito cardiaco dal dispositivo.

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

number

Potenza massima radiata isotropica equivalente (EIRP) consentita dalla concessione. L'EIRP massimo è in unità di dBm/MHz. Il valore di maxEirp rappresenta l'EIRP medio (RMS) che verrebbe misurato dalla procedura definita nella parte FCC 96.41(e)(3).

frequencyRange

object (FrequencyRange)

La gamma di frequenze di trasmissione.

state

enum (GrantState)

Stato della concessione.

channelType

enum (ChannelType)

Tipo di canale utilizzato.

moveList[]

object (DpaMoveList)

L'ETD trasferisce gli elenchi in cui compare la concessione.

expireTime

string (Timestamp format)

La scadenza della concessione.

Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: "2014-10-02T15:01:23.045123456Z".

Intervallofrequenza

Gamma di frequenza da low_frequency a high_frequency.

Rappresentazione JSON
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Campi
lowFrequencyMhz

number

La frequenza più bassa della gamma di frequenze in MHz.

highFrequencyMhz

number

La frequenza più alta della gamma di frequenze in MHz.

GrantState

Lo stato della concessione.

Enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED La concessione è stata concessa, ma il dispositivo non sta smettendo di affaticarsi.
GRANT_STATE_TERMINATED La concessione è stata revocata dalla SAS.
GRANT_STATE_SUSPENDED La concessione è stata sospesa dalla SAS.
GRANT_STATE_AUTHORIZED Il dispositivo sta trasmettendo.
GRANT_STATE_EXPIRED La concessione è scaduta.

TipoCanale

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Una voce nell'elenco degli spostamenti di un DPA.

Rappresentazione JSON
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Campi
dpaId

string

L'ID della DPA.

frequencyRange

object (FrequencyRange)

L'intervallo di frequenze interessato dall'elenco degli spostamenti.

Metodi

create

Crea un device in node o customer.

createSigned

Crea un device firmato sotto un node o customer.

delete

Elimina una device.

get

Visualizza i dettagli di un device.

list

Elenca devices in un node o customer.

move

Sposta un device in un altro node o customer.

patch

Consente di aggiornare un device.

signDevice

Firma un device.

updateSigned

Consente di aggiornare un elemento device firmato.