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 registrata nel 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 del dispositivo che possono essere sostituiti sia dal portale SAS che dalle richieste di registrazione SAS.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Solo output. Canali attuali con punteggi.
grantRangeAllowlists[]

object (FrequencyRange)

Solo gli intervalli inclusi nelle liste consentite sono disponibili per le nuove concessioni.

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 aerea di questo dispositivo.
installationParams

object (InstallationParams)

Parametri di installazione per il dispositivo.
measurementCapabilities[]

enum (MeasurementCapability)

Funzionalità di generazione di report sulla 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 è stata modificata la configurazione del dispositivo.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

DeviceCategory

Categoria FCC del dispositivo, come definita dalla Parte 96.

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

DeviceModel

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 firmware del dispositivo.

DeviceAirInterface

Informazioni sull'interfaccia aerea del dispositivo.

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

enum (RadioTechnology)

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

string

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

RadioTechnology

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

InstallationParams

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 al datum WGS 84. L'intervallo consentito è compreso tra -90.000000 e +90.000000. I valori positivi rappresentano le latitudini a nord dell'equatore, i valori negativi quelle a sud.
longitude

number

Longitudine della posizione dell'antenna del dispositivo in gradi rispetto al sistema di riferimento WGS 84. L'intervallo consentito è compreso tra -180.000000 e +180.000000. I valori positivi rappresentano le longitudini a est del meridiano zero, i valori negativi quelle a ovest.
height

number

Altezza dell'antenna del dispositivo in metri. Quando il valore del parametro heightType è "AGL", l'altezza dell'antenna deve essere indicata rispetto al livello del suolo. Quando il valore del parametro heightType è "AMSL", viene fornito rispetto al datum 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 suo valore è inferiore al requisito della FCC di 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 suo valore è inferiore al requisito FCC di 3 metri.
indoorDeployment

boolean

Indica se l'antenna del dispositivo è interna o meno. true: interno. false: esterno.
antennaAzimuth

integer

Direzione di puntamento del piano orizzontale dell'antenna in gradi rispetto al nord geografico. Il valore di questo parametro è un numero intero compreso tra 0 e 359 inclusi. Un valore di 0 gradi indica il nord geografico, mentre un valore di 90 gradi indica l'est. Questo parametro è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B.
antennaDowntilt

integer

L'inclinazione verso il basso dell'antenna in gradi è un numero intero con un valore compreso tra -90 e +90 inclusi; un valore negativo indica che l'antenna è inclinata verso l'alto (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 EIRP massimo consentito in unità di dBm/10 MHz per la categoria di dispositivo.
antennaBeamwidth

integer

Larghezza del fascio dell'antenna a 3 dB nel piano orizzontale in gradi. Questo parametro è un numero intero senza segno con un valore compreso tra 0 e 360 (gradi) inclusi; è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B.
antennaModel

string

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

boolean

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

HeightType

Specifica come viene misurata l'altezza.

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

MeasurementCapability

Funzionalità di misurazione del dispositivo. 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 CBSD possono essere utilizzate solo le configurazioni con 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, ma non ancora registrato con SAS.
REGISTERED Dispositivo registrato con SAS.
DEREGISTERED Il dispositivo è stato deregistrato da SAS.

DeviceGrant

Concessione del dispositivo. Si tratta di un'autorizzazione fornita dal sistema di accesso allo spettro a un dispositivo per trasmettere utilizzando parametri operativi specificati dopo un heartbeat riuscito del 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 isotropica irradiata equivalente (EIRP) massima consentita dalla concessione. L'EIRP massimo è espresso in unità di dBm/MHz. Il valore di maxEirp rappresenta l'EIRP medio (RMS) che verrebbe misurato dalla procedura definita nella parte 96.41(e)(3) della FCC.
frequencyRange

object (FrequencyRange)

L'intervallo di frequenza di trasmissione.
state

enum (GrantState)

Stato della concessione.
channelType

enum (ChannelType)

Tipo di canale utilizzato.
moveList[]

object (DpaMoveList)

Gli elenchi di spostamento del DPA in cui viene visualizzata questa concessione.
expireTime

string (Timestamp format)

Il tempo per la scadenza della concessione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Se la sovvenzione è sospesa, il motivo o i motivi della sospensione.
grantId

string

ID concessione.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

L'ora di scadenza della trasmissione dell'ultimo heartbeat.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione al nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

FrequencyRange

Intervallo di frequenza da low_frequency a high_frequency.

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

number

La frequenza più bassa dell'intervallo di frequenza in MHz.
highFrequencyMhz

number

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

GrantState

Lo stato della concessione.

Enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED La concessione è stata concessa, ma il dispositivo non invia heartbeat.
GRANT_STATE_TERMINATED La concessione è stata interrotta dal SAS.
GRANT_STATE_SUSPENDED La sovvenzione è stata sospesa dal SAS.
GRANT_STATE_AUTHORIZED Il dispositivo sta trasmettendo.
GRANT_STATE_EXPIRED La concessione è scaduta.

ChannelType

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Una voce nell'elenco di trasferimento di un DPA.

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

string

L'ID del DPA.
frequencyRange

object (FrequencyRange)

L'intervallo di frequenza interessato dall'elenco di spostamento.

DeviceMetadata

Dati del dispositivo sostituibili 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

Interference Coordination Group (ICG). Un gruppo di CBSD che gestiscono la propria interferenza con il gruppo. Per maggiori dettagli, consulta CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Gruppo di canali comune (CCG). Un gruppo di CBSD nello stesso ICG che richiede un'assegnazione del canale primario comune. Per maggiori dettagli, consulta CBRSA-TS-2001 V3.0.0.
antennaModel

string

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

boolean

Solo output. Imposta su true se un CPI ha convalidato di aver coordinato con l'ufficio della National Quiet Zone.
nrqzValidation

object (NrqzValidation)

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

NrqzValidation

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

La latitudine del dispositivo associata alla convalida.
longitude

number

La 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 Stato bozza.
FINAL Stato finale.

ChannelWithScore

Il canale con il punteggio.

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

object (FrequencyRange)

La gamma di frequenze del canale.
score

number

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

Metodi

create

 Crea un device in un node o in un customer.

createSigned

 Crea un device firmato in un node o un customer.

list

 Elenchi devices in node o customer.