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

object (DeviceMetadata)

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

object (ChannelWithScore)

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

object (FrequencyRange)

Nur Bereiche, die sich in den Zulassungslisten befinden, sind für neue Erteilungen verfügbar.

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" mit einer Auflösung im Nanosekundenbereich 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äß 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)

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

string

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

RadioTechnology

Die genehmigten Arten von Funkzugangstechnologie.

Enums
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
CW
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,
  "cpeCbsdIndication": boolean
}
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, sollte 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. true: indoor. false: outdoor.
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.
cpeCbsdIndication

boolean

Falls vorhanden, gibt dieser Parameter an, ob es sich bei der CBSD um eine CPE-CBSD handelt.

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 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. Nur Konfigurationen im Status DEVICE_CONFIG_STATE_FINAL können bei der CBSD-Registrierung 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, 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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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 steht für die durchschnittliche (RMS) EIRP, die mit 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" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Wenn die Genehmigung ausgesetzt wird, die Gründe für die Aussetzung.
grantId

string

Erteilungs-ID
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Die Ablaufzeit der Übertragung des letzten Heartbeats.

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

DeviceMetadata

Gerätedaten, die sowohl durch das SAS-Portal als auch durch 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 eigenen Störungen der Gruppe verwalten. Weitere Informationen finden Sie unter CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Gemeinsame Channelgruppe (Common Channel Group, CCG) Eine Gruppe von CBSDs in derselben ICG, die eine gemeinsame Zuweisung des primären Kanals anfordern. Weitere Informationen finden Sie unter CBRSA-TS-2001 V3.0.0.
antennaModel

string

Das zu verwendende Antennenmodellmuster, falls vorhanden. Format ist: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Nur Ausgabe. Auf true setzen, wenn ein CPI bestätigt hat, dass er sich mit dem National Quiet Zone Office abgestimmt hat.
nrqzValidation

object (NrqzValidation)

Nur Ausgabe. Informationen zur Validierung der National Radio Quiet Zone.

NrqzValidation

Informationen zur Validierung der National Radio Quiet 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

Der mit der Validierung verknüpfte Breitengrad des Geräts.
longitude

number

Der Längengrad des Geräts, der mit der Validierung verknüpft ist.
cpiId

string

Der CPI, der die Validierung unterzeichnet hat.

Status

Status der NRQZ-Validierungsinformationen.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand.
DRAFT Entwurfsstatus.
FINAL Endgültiger Status.

ChannelWithScore

Der Channel mit dem Score.

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

object (FrequencyRange)

Der Frequenzbereich des Kanals.
score

number

Der auf den Bereich [0,100] normalisierte Channel-Score.

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.