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

object (DeviceMetadata)

Parametri dei dispositivi che possono essere sostituiti sia dalle richieste SAS Portal sia dalle richieste di registrazione SAS.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Solo output. Canali attuali con punteggi.
grantRangeAllowlists[]

object (FrequencyRange)

Per le nuove concessioni sono disponibili solo gli intervalli che rientrano nelle liste consentite.

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 RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "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)

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

string

(Facoltativo) Questo campo è correlato al radioTechnology e fornisce la specifica dell'interfaccia aerea a cui è conforme la CBSD al momento della registrazione.

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
CW
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,
  "cpeCbsdIndication": boolean
}
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 heightType è"AGL", l'altezza dell'antenna deve essere indicata in relazione al livello del suolo. Quando il valore del parametro heightType è "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. true: indoor. 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.
cpeCbsdIndication

boolean

Se presente, questo parametro specifica se CBSD è un CPE-CBSD o meno.

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.

Enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Stato

Stato della configurazione del dispositivo. Durante la registrazione a CBSD è possibile usare solo le configurazioni nello stato DEVICE_CONFIG_STATE_FINAL.

Enum
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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 RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Se la concessione è sospesa, i motivi della sospensione.
grantId

string

ID concessione.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

La scadenza della trasmissione dell'ultimo battito cardiaco.

Un timestamp in formato RFC3339 UTC "Zulu", con una risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "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.

Metadati dispositivo

Dati di dispositivi che possono essere sostituiti sia dal portale SAS sia dalle richieste di registrazione.

Rappresentazione JSON 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Campi
interferenceCoordinationGroup

string

ICG (Interference Coordination Group). Un gruppo di CBSD che gestisce le proprie interferenze con il gruppo. Per maggiori dettagli, vedi CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Common Channel Group (CCG). Un gruppo di CBSD nello stesso ICG che richiede l'assegnazione di un canale principale comune. Per maggiori dettagli, vedi CBRSA-TS-2001 V3.0.0.
antennaModel

string

Se completato, il pattern del modello di antenna da utilizzare. Il formato è: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Solo output. Imposta su true se un CPI ha verificato di aver coordinato l'ufficio della Zona silenziosa nazionale.
nrqzValidation

object (NrqzValidation)

Solo output. Informazioni sulla convalida della National Radio Quiet Zone.

Convalida Nrqz

Informazioni sulla convalida della National Radio Quiet Zone.

Rappresentazione JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Campi
state

enum (State)

Stato delle informazioni di convalida NRQZ.
caseId

string

ID richiesta di convalida.
latitude

number

Latitudine del dispositivo associata alla convalida.
longitude

number

Longitudine del dispositivo associata alla convalida.
cpiId

string

CPI che ha firmato la convalida.

Stato

Stato delle informazioni di convalida NRQZ.

Enum
STATE_UNSPECIFIED Stato non specificato.
DRAFT Bozza dello stato.
FINAL Stato finale.

CanaleCon punteggio

Il canale con il punteggio.

Rappresentazione JSON 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Campi
frequencyRange

object (FrequencyRange)

La fascia di frequenza del canale.
score

number

Il punteggio del canale, normalizzato per essere compreso nell'intervallo [0,100].

Metodi

create

 Crea un device in node o customer.

createSigned

 Crea un device firmato sotto un node o customer.

list

 Elenca devices in un node o customer.