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, die beim SAS registriert ist.

state

enum (State)

Nur Ausgabe. Gerätestatus

grants[]

object (DeviceGrant)

Nur Ausgabe. Zuschüsse des Geräts.
displayName

string

Angezeigter Name 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 Benutzeroberfläche dieses Geräts.

installationParams

object (InstallationParams)

Installationsparameter für das Gerät.

measurementCapabilities[]

enum (MeasurementCapability)

Die Funktionen für Messungsberichte des Geräts.

userId

string

Die ID eines Gerätenutzers.
callSign

string

Das Rufzeichen des Geräteoperators.
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, zu dem die Gerätekonfiguration zuletzt bearbeitet wurde.

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

DeviceCategory

FCC-Kategorie des Geräts gemäß Definition in Teil 96.

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

Gerätemodell

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

AirAir-Schnittstelle

Informationen zur Benutzeroberfläche des Geräts.

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

enum (RadioTechnology)

Dieses Feld gibt die Funkzugriffstechnologie an, die für die CBSD verwendet wird.

Bedingt
supportedSpec

string

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

Optional

Radiotechnologie

Die genehmigten Arten des Radiozugriffs.

Enums
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

Installationsparameter

Informationen zu den Installationsparametern des Geräts.

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 der Position der Geräteantenne in Grad bezogen auf das WGS 84-Bezugssystem. Der zulässige Bereich liegt zwischen -90,000000 und +90,000000. Positive Werte repräsentieren die Breitengrade nördlich des Äquators, negative Werte südlich des Äquators.
longitude

number

Längengrad der Position der Geräteantenne in Grad bezogen auf das WGS 84-Datum. Der zulässige Bereich liegt zwischen -180.000000 und +180.000000. Positive Werte stellen die Längengrade östlich des Nullmeridians dar, negative Werte westlich des Nullmeridians.
height

number

Höhe der Geräteantenne in Metern. Wenn der Wert des Höhentyps "AGL" ist, sollte die Antennenhöhe relativ zum Boden angegeben werden. Wenn der Höhentyp-Parameterwert "AMSL" ist, wird er in Bezug auf das WGS84-Bezugssystem 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 die Antenne im Gerät ist oder nicht. Richtig: drinnen. Falsch: draußen.
antennaAzimuth

integer

Richtung der horizontalen Horizontalen der Antenne in Grad bezogen auf den geografischen Norden Der Wert dieses Parameters ist eine Ganzzahl mit einem Wert zwischen 0 und 359. Ein Wert von 0 Grad bedeutet Norden. 90 Grad bedeutet Osten. Dieser Parameter ist für Geräte der Kategorie A optional und für Geräte der Kategorie B bedingt.
antennaDowntilt

integer

Die Neigung der Antenne in Grad und eine Ganzzahl zwischen -90 und +90 ist. Ein negativer Wert bedeutet, dass die Antenne nach oben geneigt ist (über horizontal). Dieser Parameter ist für Geräte der Kategorie A optional und für Geräte der Kategorie B bedingt.
antennaGain

integer

Spitzen Antennengewinn in dBi Dieser Parameter ist eine Ganzzahl mit einem Wert zwischen -127 und +128 (dBi).
eirpCapability

integer

Dieser Parameter ist das maximale Geräte-EIRP in Einheiten von dB/10 MHz und ist eine Ganzzahl mit einem Wert zwischen -127 und +47 (dBm/10 MHz). Falls nicht enthalten, interpretiert SAS sie als den maximal zulässigen EIRP-Wert in Einheiten von DBM/10 MHz für die Gerätekategorie.
antennaBeamwidth

integer

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 (jeweils 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, ist das Antennenmodell optional in diesem Feld enthalten. Der String hat eine maximale Länge von 128 Oktetten.

Höhentyp

Gibt an, wie die Höhe gemessen wird.

Enums
HEIGHT_TYPE_UNSPECIFIED Unbekannter Höhentyp.
HEIGHT_TYPE_AGL Die AGL-Höhe wird relativ zur Bodenhöhe gemessen.
HEIGHT_TYPE_AMSL Die AMSL-Höhe wird relativ zum mittleren Meeresspiegel gemessen.

Messfunktion

Geräteanalysefunktion. Die Werte werden durch [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, aber noch nicht bei SAS registriert.
REGISTERED Gerät ist bei SAS registriert.
DEREGISTERED Registrierung des Geräts bei SAS aufgehoben.

Geräteerteilung

Geräteerteilung. Es handelt sich dabei um eine vom Spectrum Access System erteilte Autorisierung, dass ein Gerät nach einem erfolgreichen Herzschlag an bestimmte Geräte übertragen werden darf.

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

number

Maximale äquivalente isotrope Strahlungsleistung (EIRP), die durch die Förderung zugelassen wird. Der maximale EIRP-Wert wird in Einheiten von DBM/MHz angegeben. Der Wert von maxEirp ist der durchschnittliche (RMS) EIRP-Wert, der gemäß dem Verfahren in FCC-Teil 96.41(e)(3) gemessen wird.
frequencyRange

object (FrequencyRange)

Der Bereich der Übertragungshäufigkeit.

state

enum (GrantState)

Status der Gewährung.

channelType

enum (ChannelType)

Typ des verwendeten Kanals.

moveList[]

object (DpaMoveList)

Die DPA-Verschiebungslisten, in denen diese Förderung erscheint

expireTime

string (Timestamp format)

Die Ablaufzeit der Gewährung.

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

Frequenzbereich

Häufigkeitsbereich 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.

Ad Grants-Status

Der Status der Gewährung.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Die Gewährung wurde gewährt, aber das Gerät läuft nicht mit einem Herzschlag darauf.
GRANT_STATE_TERMINATED Die Gewährung wurde vom SAS beendet.
GRANT_STATE_SUSPENDED Die Gewährung wurde vom SAS ausgesetzt.
GRANT_STATE_AUTHORIZED Das Gerät überträgt gerade.
GRANT_STATE_EXPIRED Die Förderung ist abgelaufen.

Kanaltyp

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DPA-Verschiebungsliste

Ein Eintrag in einer Verschiebeliste einer Datenschutzaufsichtsbehörde

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

string

Die ID des Zusatzes zur Datenverarbeitung.
frequencyRange

object (FrequencyRange)

Der Häufigkeitsbereich, auf den sich die Liste zum Verschieben auswirkt.

Methoden

create

 Erstellt ein device unter einem node oder customer.

createSigned

 Erstellt eine signierte device unter einem node oder customer.

delete

 device wird gelöscht.

get

 Ruft Details zu einem device ab.

list

 Listet devices unter einem node oder customer auf.

move

 Verschiebt eine device unter eine andere node oder customer.

patch

 Aktualisiert ein device.

signDevice

 Signiert ein device.

updateSigned

 Aktualisiert ein signiertes device.