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 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.

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, preciso al nanosecondo. Esempio: "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)

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

Condizionale

supportedSpec

string

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

Facoltativo

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
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
}
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 datum 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. Vero: interno. Falso: 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.

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] [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, 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
}
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, preciso al nanosecondo. Esempio: "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.

Metodi

create

Crea un device in un node o in un customer.

createSigned

Crea un device firmato in un node o un customer.

delete

Elimina un device.

get

Recupera i dettagli di un device.

list

Elenchi devices in node o customer.

move

Sposta un device sotto un altro node o customer.

patch

Aggiorna un device.

signDevice

Firma un device.

updateSigned

Aggiorna un device firmato.