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

object (DeviceMetadata)

Geräteparameter, die sowohl von SAS Portal- als auch SAS-Registrierungsanfragen überschrieben werden können.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Nur Ausgabe. Aktuelle Kanäle mit Bewertungen.
grantRangeAllowlists[]

object (FrequencyRange)

Für neue Zuschüsse sind nur Bereiche verfügbar, die auf der Zulassungsliste stehen.

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 mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "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)

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

string

Optional. Dieses Feld bezieht sich auf radioTechnology und enthält die Spezifikation der Benutzeroberfläche, die der CBSD zum Zeitpunkt der Registrierung entspricht.

Radiotechnologie

Die genehmigten Arten des Radiozugriffs.

Enums
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
CW
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,
  "cpeCbsdIndication": boolean
}
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 Geräteantenne in Grad, bezogen auf das WGS 84-Bezugssystem. 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 Parameters heightType "AGL" ist, sollte die Antennenhöhe relativ zum Bodenniveau angegeben werden. Wenn der Wert des Parameters 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 die Antenne im Gerät ist oder nicht. true: drinnen. false: 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.
cpeCbsdIndication

boolean

Falls vorhanden, gibt dieser Parameter an, ob die CBSD eine CPE-CBSD ist oder nicht.

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

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Status

Status der Gerätekonfiguration. Während der CBSD-Registrierung können nur Konfigurationen mit dem Status DEVICE_CONFIG_STATE_FINAL verwendet werden.

Enums
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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 steht für den durchschnittlichen (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 mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Wenn die Förderung ausgesetzt wurde, sind die Gründe für die Sperrung angegeben.
grantId

string

Berechtigungs-ID
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Die Ablaufzeit des letzten Herzschlags bei der Übertragung.

Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "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.

Gerätemetadaten

Gerätedaten, die sowohl vom SAS-Portal als auch von Registrierungsanfragen überschrieben werden können.

JSON-Darstellung 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Felder
interferenceCoordinationGroup

string

Interference Coordination Group (ICG). Eine Gruppe von CBSDs, die ihre eigene Störung der Gruppe verwalten. Weitere Informationen finden Sie unter CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Common Channel Group (CCG): Eine Gruppe von CBSDs in derselben ICG, die eine gemeinsame primäre Kanalzuweisung anfordern. Weitere Informationen finden Sie unter CBRSA-TS-2001 V3.0.0.
antennaModel

string

Wenn Sie dieses Feld ausfüllen, wird das zu verwendende Antennenmodellmuster verwendet. Format ist: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Nur Ausgabe. Legen Sie diesen Wert auf true fest, wenn ein CPI bestätigt hat, dass er sich mit dem Büro der National Serene Zone koordiniert hat.
nrqzValidation

object (NrqzValidation)

Nur Ausgabe. Informationen zur Überprüfung von National Radio Still Zone.

NrqzValidation

Informationen zur Überprüfung von National Radio Still Zone.

JSON-Darstellung 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Felder
state

enum (State)

Status der NRQZ-Validierungsinformationen.
caseId

string

Validierungsfall-ID.
latitude

number

Breitengrad des Geräts, das der Validierung zugeordnet ist.
longitude

number

Längengrad des Geräts, das der Validierung zugeordnet ist
cpiId

string

CPI, der die Validierung unterzeichnet hat.

Status

Status der NRQZ-Validierungsinformationen.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
DRAFT Entwurfsstatus.
FINAL Endzustand.

ChannelWithScore

Der Kanal mit der Bewertung.

JSON-Darstellung 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Felder
frequencyRange

object (FrequencyRange)

Der Frequenzbereich des Kanals.
score

number

Die Kanalpunktzahl, normalisiert im Bereich [0,100].

Methoden

create

 Erstellt ein device unter einem node oder customer.

createSigned

 Erstellt eine signierte device unter einem node oder customer.

list

 Listet devices unter einem node oder customer auf.