REST Resource: customers.devices

Ressource: Gerät

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

string

Nur Ausgabe. Der Name des Ressourcenpfads.

fccId

string

Die FCC-ID des Geräts.

serialNumber

string

Eine Seriennummer, die dem Gerät vom Gerätehersteller zugewiesen wurde.

preloadedConfig

object (DeviceConfig)

Konfiguration des Geräts, wie über die SAS Portal API angegeben.

activeConfig

object (DeviceConfig)

Nur Ausgabe. Aktuelle Konfiguration des Geräts, wie es bei der SAS registriert ist.

state

enum (State)

Nur Ausgabe. Gerätestatus.

grants[]

object (DeviceGrant)

Nur Ausgabe. Vom Gerät gehaltene Berechtigungen.

displayName

string

Anzeigename des Geräts.

DeviceConfig

Informationen zur Gerätekonfiguration.

JSON-Darstellung
{
  "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
}
Felder
category

enum (DeviceCategory)

FCC-Kategorie des Geräts.

model

object (DeviceModel)

Informationen zu diesem Gerätemodell.

airInterface

object (DeviceAirInterface)

Informationen zur Luftschnittstelle dieses Geräts.

installationParams

object (InstallationParams)

Installationsparameter für das Gerät.

measurementCapabilities[]

enum (MeasurementCapability)

Funktionen des Geräts für die Analyseberichterstellung.

userId

string

Die Kennung eines Gerätenutzers.

callSign

string

Das Rufzeichen des Gerätebedieners.

state

enum (State)

Status der Konfiguration.

isSigned

boolean

Nur Ausgabe. Gibt an, ob die Konfiguration von einem CPI signiert wurde.

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt der letzten Bearbeitung der Gerätekonfiguration.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

DeviceCategory

FCC-Kategorie des Geräts gemäß Part 96.

Enums
DEVICE_CATEGORY_UNSPECIFIED Nicht angegebene Gerätekategorie.
DEVICE_CATEGORY_A Kategorie A
DEVICE_CATEGORY_B Kategorie B:

DeviceModel

Informationen zum Modell des Geräts.

JSON-Darstellung
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Felder
vendor

string

Der Name des Geräteanbieters.

name

string

Der Name des Gerätemodells.

softwareVersion

string

Die Softwareversion des Geräts.

hardwareVersion

string

Die Hardwareversion des Geräts.

firmwareVersion

string

Die Firmwareversion des Geräts.

DeviceAirInterface

Informationen zur Luftschnittstelle des Geräts.

JSON-Darstellung
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Felder
radioTechnology

enum (RadioTechnology)

In diesem Feld wird die Funkzugangstechnologie angegeben, die für das CBSD verwendet wird.

Bedingt

supportedSpec

string

Dieses Feld bezieht sich auf das Feld „radioTechnology“ und enthält die Spezifikation der Luftschnittstelle, die das CBSD zum Zeitpunkt der Registrierung erfüllt.

Optional

RadioTechnology

Die genehmigten Arten von Funkzugangstechnologie.

Enums
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

InstallationParams

Informationen zu den Geräteinstallationsparametern.

JSON-Darstellung
{
  "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
}
Felder
latitude

number

Breitengrad des Antennenstandorts des Geräts in Grad relativ zum WGS84-Datum. Der zulässige Bereich liegt zwischen -90,000000 und +90,000000. Positive Werte stehen für Breitengrade nördlich des Äquators, negative Werte für Breitengrade südlich des Äquators.

longitude

number

Längengrad des Antennenstandorts des Geräts in Grad relativ zum WGS84-Datum. Der zulässige Bereich liegt zwischen -180,000000 und +180,000000. Positive Werte stellen Längengrade östlich des Nullmeridians dar, negative Werte westlich des Nullmeridians.

height

number

Höhe der Geräteantenne in Metern. Wenn der Parameterwert „heightType“ „AGL“ ist, muss die Antennenhöhe relativ zum Boden angegeben werden. Wenn der Parameterwert „heightType“ „AMSL“ ist, wird er in Bezug auf das WGS84-Datum angegeben.

heightType

enum (HeightType)

Gibt an, wie die Höhe gemessen wird.

horizontalAccuracy

number

Eine positive Zahl in Metern, die die Genauigkeit der horizontalen Position der Geräteantenne angibt. Dieser optionale Parameter sollte nur vorhanden sein, wenn sein Wert unter der FCC-Anforderung von 50 Metern liegt.

verticalAccuracy

number

Eine positive Zahl in Metern, die die Genauigkeit der vertikalen Position der Geräteantenne angibt. Dieser optionale Parameter sollte nur vorhanden sein, wenn sein Wert unter der FCC-Anforderung von 3 Metern liegt.

indoorDeployment

boolean

Gibt an, ob sich die Geräteantenne in Innenräumen befindet. Wahr: Innenbereich. Falsch: im Freien.

antennaAzimuth

integer

Die Ausrichtung der horizontalen Ebene der Antenne in Grad in Bezug auf den geografischen Norden. Der Wert dieses Parameters ist eine Ganzzahl zwischen 0 und 359 (einschließlich). Ein Wert von 0 Grad bedeutet geografischer Norden, ein Wert von 90 Grad Osten. Dieser Parameter ist für Geräte der Kategorie A optional und für Geräte der Kategorie B bedingt.

antennaDowntilt

integer

Antennenneigung in Grad. Es handelt sich um eine Ganzzahl mit einem Wert zwischen -90 und +90 (jeweils einschließlich). Ein negativer Wert bedeutet, dass die Antenne nach oben geneigt ist (über der Horizontalen). Dieser Parameter ist für Geräte der Kategorie A optional und für Geräte der Kategorie B bedingt.

antennaGain

integer

Maximale Antennenverstärkung in dBi. Dieser Parameter ist eine Ganzzahl mit einem Wert zwischen -127 und +128 dBi (einschließlich).

eirpCapability

integer

Dieser Parameter ist die maximale EIRP des Geräts in dBm/10 MHz und eine Ganzzahl mit einem Wert zwischen -127 und +47 dBm/10 MHz (einschließlich). Wenn nicht angegeben, interpretiert SAS dies als maximal zulässige EIRP in Einheiten von dBm/10 MHz für die Geräteklasse.

antennaBeamwidth

integer

Die 3‑dB-Antennenstrahlbreite der Antenne in der horizontalen Ebene in Grad. Dieser Parameter ist eine vorzeichenlose Ganzzahl mit einem Wert zwischen 0 und 360 Grad (einschließlich). Er ist für Geräte der Kategorie A optional und für Geräte der Kategorie B bedingt.

antennaModel

string

Wenn eine externe Antenne verwendet wird, kann das Antennenmodell optional in diesem Feld angegeben werden. Der String darf maximal 128 Oktette lang sein.

HeightType

Gibt an, wie die Höhe gemessen wird.

Enums
HEIGHT_TYPE_UNSPECIFIED Nicht angegebener Höhentyp.
HEIGHT_TYPE_AGL Die Höhe über dem Boden wird relativ zum Boden gemessen.
HEIGHT_TYPE_AMSL Die Höhe über dem mittleren Meeresspiegel wird relativ zum mittleren Meeresspiegel gemessen.

MeasurementCapability

Analysefähigkeit des Geräts. Die Werte sind in [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf] definiert.

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Status

Status des Geräts.

Enums
DEVICE_STATE_UNSPECIFIED Nicht angegebener Zustand.
RESERVED Das Gerät wurde im SAS-Portal erstellt, ist aber noch nicht bei SAS registriert.
REGISTERED Das Gerät ist bei SAS registriert.
DEREGISTERED Die Registrierung des Geräts bei SAS wurde aufgehoben.

DeviceGrant

Geräteberechtigung. Es handelt sich um eine Autorisierung, die vom Spectrum Access System für ein Gerät bereitgestellt wird, um nach einem erfolgreichen Heartbeat des Geräts mit den angegebenen Betriebsparametern zu senden.

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

number

Die maximal zulässige äquivalente isotrope Strahlungsleistung (EIRP) gemäß der Genehmigung. Die maximale EIRP wird in dBm/MHz angegeben. Der Wert von maxEirp entspricht der durchschnittlichen (RMS) EIRP, die gemäß dem in FCC-Teil 96.41(e)(3) definierten Verfahren gemessen würde.

frequencyRange

object (FrequencyRange)

Der Übertragungsfrequenzbereich.

state

enum (GrantState)

Status der Gewährung.

channelType

enum (ChannelType)

Verwendeter Channneltyp.

moveList[]

object (DpaMoveList)

Die DPA-Umzugslisten, auf denen diese Einwilligung erscheint.

expireTime

string (Timestamp format)

Die Ablaufzeit der Erteilung.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ in Nanosekunden. Beispiel: "2014-10-02T15:01:23.045123456Z".

FrequencyRange

Frequenzbereich von low_frequency bis high_frequency.

JSON-Darstellung
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Felder
lowFrequencyMhz

number

Die niedrigste Frequenz des Frequenzbereichs in MHz.

highFrequencyMhz

number

Die höchste Frequenz des Frequenzbereichs in MHz.

GrantState

Der Status der Genehmigung.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Die Berechtigung wurde erteilt, aber das Gerät sendet keine Heartbeats.
GRANT_STATE_TERMINATED Die Gewährung wurde von der SAS beendet.
GRANT_STATE_SUSPENDED Die Gewährung wurde vom SAS ausgesetzt.
GRANT_STATE_AUTHORIZED Das Gerät überträgt gerade Daten.
GRANT_STATE_EXPIRED Die Erteilung ist abgelaufen.

ChannelType

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Ein Eintrag in der Verschiebungsliste einer DPA.

JSON-Darstellung
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Felder
dpaId

string

Die ID der DPA.

frequencyRange

object (FrequencyRange)

Der Frequenzbereich, auf den sich die Bewegungsliste bezieht.

Methoden

create

Erstellt ein device unter einem node oder customer.

createSigned

Erstellt eine signierte device unter einem node oder customer.

delete

Löscht einen device.

get

Ruft Details zu einem device ab.

list

Listet devices unter einem node oder customer auf.

move

Verschiebt ein device unter ein anderes node oder customer.

patch

Aktualisiert ein device.

signDevice

Signiert einen device.

updateSigned

Aktualisiert eine signierte device.