REST Resource: customers.deployments.devices

Zasób: urządzenie

Zapis JSON
{
  "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)
    }
  ]
}
Pola
name

string

Tylko dane wyjściowe. Nazwa ścieżki zasobu.

fccId

string

Identyfikator FCC urządzenia.

serialNumber

string

Numer seryjny przypisany do urządzenia przez producenta.

preloadedConfig

object (DeviceConfig)

Konfiguracja urządzenia określona za pomocą interfejsu SAS Portal API.

activeConfig

object (DeviceConfig)

Tylko dane wyjściowe. Obecna konfiguracja urządzenia zarejestrowana w SAS.

state

enum (State)

Tylko dane wyjściowe. Stan urządzenia.

grants[]

object (DeviceGrant)

Tylko dane wyjściowe. Przyznane urządzenia.

displayName

string

Wyświetlana nazwa urządzenia.

deviceMetadata

object (DeviceMetadata)

Parametry urządzenia, które mogą być zastąpione przez żądania rejestracji w portalu SAS i żądania SAS.

currentChannels[]
(deprecated)

object (ChannelWithScore)

Tylko dane wyjściowe. Aktualne kanały z wynikami.

grantRangeAllowlists[]

object (FrequencyRange)

Tylko nowe zakresy na liście dozwolonych są dostępne dla nowych grantów.

Konfiguracja urządzenia

Informacje o konfiguracji urządzenia.

Zapis 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
}
Pola
category

enum (DeviceCategory)

Kategoria FCC na urządzeniu.

model

object (DeviceModel)

Informacje o tym modelu urządzenia.

airInterface

object (DeviceAirInterface)

Informacje o interfejsie powietrza na tym urządzeniu.

installationParams

object (InstallationParams)

Parametry instalacji urządzenia.

measurementCapabilities[]

enum (MeasurementCapability)

Uprawnienia do raportowania pomiarów urządzenia.

userId

string

Identyfikator użytkownika urządzenia.

callSign

string

Znak wywołania operatora urządzenia.

state

enum (State)

Stan konfiguracji.

isSigned

boolean

Tylko dane wyjściowe. Określa, czy konfiguracja została podpisana przez CPI.

updateTime

string (Timestamp format)

Tylko dane wyjściowe. data ostatniej modyfikacji konfiguracji urządzenia,

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Kategoria urządzenia

Kategoria FCC dotycząca urządzenia określona w sekcji 96.

Wartości w polu enum
DEVICE_CATEGORY_UNSPECIFIED Nieokreślona kategoria urządzenia.
DEVICE_CATEGORY_A Kategoria A.
DEVICE_CATEGORY_B Kategoria B.

Model urządzenia

Informacje o modelu urządzenia.

Zapis JSON
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Pola
vendor

string

Nazwa dostawcy urządzenia.

name

string

Nazwa modelu urządzenia.

softwareVersion

string

Wersja oprogramowania urządzenia.

hardwareVersion

string

Wersja sprzętowa urządzenia.

firmwareVersion

string

Wersja oprogramowania układowego urządzenia.

Interfejs urządzenia AirAir

Informacje o interfejsie powietrza w urządzeniu.

Zapis JSON
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Pola
radioTechnology

enum (RadioTechnology)

Tryb warunkowy. To pole określa technologię dostępu radiową używaną w przypadku CBSD.

supportedSpec

string

Opcjonalne. To pole jest związane z dokumentem radioTechnology i zawiera specyfikację interfejsu lotniczego, z którą zgodne jest CBSD w momencie rejestracji.

Technologia radiowa

Zatwierdzone rodzaje technologii dostępu radiowego.

Wartości w polu enum
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
CW
REDLINE
TARANA_WIRELESS

Etapy instalacji

Informacje o parametrach instalacji urządzeń.

Zapis 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,
  "cpeCbsdIndication": boolean
}
Pola
latitude

number

Szerokość geograficzna anteny urządzenia w stopniach względem punktu odniesienia WGS 84. Dozwolony zakres to od -90.000000 do +90.000000. Wartości dodatnie oznaczają szerokość geograficzną na północ od równika, wartości ujemne na południe od równika.

longitude

number

Długość geograficzna anteny urządzenia w stopniach względem punktu odniesienia WGS 84. Dozwolony zakres wynosi od -180 000 000 do +180 000 000. Wartości dodatnie oznaczają długość geograficzną na wschód od południka zerowego; wartości ujemne na zachód od południka zerowego.

height

number

Wysokość anteny urządzenia: m. Gdy wartość parametru heightType to "AGL", wysokość anteny należy podać względem poziomu gruntu. Gdy wartość parametru heightType to "AMSL", jest ona podawana w odniesieniu do punktu odniesienia WGS84.

heightType

enum (HeightType)

Określa sposób pomiaru wysokości.

horizontalAccuracy

number

Wartość dodatnia w metrach, która wskazuje dokładność anteny urządzenia w poziomie. Ten opcjonalny parametr powinien być podany tylko wtedy, gdy jego wartość jest mniejsza niż zgodnie z wymaganiami FCC (50 metrów).

verticalAccuracy

number

Wartość dodatnia (w metrach), która wskazuje dokładną lokalizację anteny urządzenia. Ten opcjonalny parametr powinien być podany tylko wtedy, gdy jego wartość jest mniejsza niż wymagane przez FCC (3 metry).

indoorDeployment

boolean

Czy antena urządzenia jest wewnątrz, czy nie. true: wewnątrz. false: na zewnątrz.

antennaAzimuth

integer

Kierunek obserwacyjny poziomej płazy anteny w stopniach względem prawdziwej północy. Wartość tego parametru jest liczbą całkowitą z zakresu od 0 do 359 włącznie. Wartość 0 stopni oznacza prawdziwą północ, a 90 stopni oznacza wschód. Ten parametr jest opcjonalny w przypadku urządzeń kategorii A i warunkowych w przypadku urządzeń B.

antennaDowntilt

integer

Przechylenie anteny w stopniach to liczba całkowita z zakresem od -90 do +90 włącznie. Wartość ujemna oznacza, że antena jest przechylona do góry (poziomo). Ten parametr jest opcjonalny w przypadku urządzeń kategorii A i warunkowych w przypadku urządzeń B.

antennaGain

integer

Szczytowa wartość anteny w dBi. Ten parametr to liczba całkowita z wartością od -127 do +128 (dBi).

eirpCapability

integer

Ten parametr określa maksymalną wartość EIRP urządzenia w dBm/10 MHz i jest liczbą całkowitą z zakresu od -127 do +47 (dBm/10 MHz) włącznie. Jeśli nie zostanie podany, funkcja SAS interpretuje ją jako maksymalną dozwoloną wartość EIRP w jednostkach dBm/10 MHz dla kategorii urządzenia.

antennaBeamwidth

integer

Antena 3 dB anteny na płaszczyźnie poziomej. Ten parametr to niepodpisana liczba całkowita z wartością od 0 do 360 stopni (włącznie). W przypadku urządzeń z kategorii A jest opcjonalna, a w przypadku urządzeń B – warunkowa.

antennaModel

string

Jeśli korzystasz z anteny zewnętrznej, w tym polu podany jest model anteny. Ciąg może mieć maksymalnie 128 oktetów.

cpeCbsdIndication

boolean

Jeśli ten parametr jest obecny, określa, czy CBSD to CPE-CBSD.

Typ wzrostu

Określa sposób pomiaru wysokości.

Wartości w polu enum
HEIGHT_TYPE_UNSPECIFIED Nieokreślony typ wzrostu.
HEIGHT_TYPE_AGL Wysokość AGL jest mierzona w odniesieniu do poziomu gruntu.
HEIGHT_TYPE_AMSL Wysokość AMSL jest mierzona w stosunku do średniego poziomu morza.

Możliwość pomiaru

Możliwość pomiaru urządzenia. Wartości są zdefiniowane przez WINNF-SSC-0002.

Wartości w polu enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Stan

Stan konfiguracji urządzenia. Podczas rejestracji zarządzania przeglądarką Chrome w chmurze można używać tylko konfiguracji w stanie DEVICE_CONFIG_STATE_FINAL.

Wartości w polu enum
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

Stan

Stan urządzenia.

Wartości w polu enum
DEVICE_STATE_UNSPECIFIED Nieokreślony stan.
RESERVED Urządzenie utworzone w portalu SAS, ale niezarejestrowane jeszcze w SAS.
REGISTERED Urządzenie zarejestrowane w SAS.
DEREGISTERED Urządzenie zostało wyrejestrowane przez SAS.

Przyznanie urządzeń

Przyznanie urządzenia. To autoryzacja zapewniana przez system dostępu do Spectrum do przesyłania na podstawie określonych parametrów operacyjnych po udanym tętnie urządzenia.

Zapis JSON
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": string
}
Pola
maxEirp

number

Maksymalna równoważna siła promieniowania izotropowego (EIRP) dozwolona w przypadku przyznania. Maksymalna EIRP to jednostki dBm/MHz. Wartość maxEirp odpowiada średniemu EIRP (RMS), który można zmierzyć za pomocą procedury określonej w FCC części 96.41(e)(3).

frequencyRange

object (FrequencyRange)

Zakres częstotliwości przesyłania.

state

enum (GrantState)

Stan grantu.

channelType

enum (ChannelType)

Typ użytego kanału.

moveList[]

object (DpaMoveList)

Listy Aneksu o przetwarzaniu danych, w których pojawiają się te granty.

expireTime

string (Timestamp format)

Data ważności grantu.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

suspensionReason[]

string

Przyczyny zawieszenia konta z powodu zawieszenia.

grantId

string

Identyfikator przyznania.

lastHeartbeatTransmitExpireTime

string (Timestamp format)

Czas wygaśnięcia transmisji ostatniego serca.

Sygnatura czasowa w formacie RFC3339 UTC &Zulu" z rozdzielczością nanosekundy i do 9 cyfr po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Zakres częstotliwości

Zakres częstotliwości od low_frequency do high_frequency.

Zapis JSON
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Pola
lowFrequencyMhz

number

Najniższa częstotliwość zakresu częstotliwości w MHz.

highFrequencyMhz

number

Najwyższa częstotliwość zakresu częstotliwości w MHz.

GrantState,

Stan grantu.

Wartości w polu enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Przyznano grant, ale urządzenie nie bije serduszka.
GRANT_STATE_TERMINATED Dotacja została zakończona przez SAS.
GRANT_STATE_SUSPENDED Dotacja została zawieszona przez platformę SAS.
GRANT_STATE_AUTHORIZED Trwa przesyłanie urządzenia.
GRANT_STATE_EXPIRED Grant wygasł.

Typ kanału

Wartości w polu enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

Lista DpaMoves

Wpis na liście Aneksów o przetwarzaniu danych.

Zapis JSON
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Pola
dpaId

string

Identyfikator organu ochrony danych.

frequencyRange

object (FrequencyRange)

Zakres częstotliwości wpływający na listę przeniesienia.

Metadane urządzenia

Dane urządzenia mogą być zastąpione przez portal SAS i żądania rejestracji.

Zapis JSON
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Pola
interferenceCoordinationGroup

string

Grupa koordynowania (ICG). Grupa zarządzania przeglądarką Chrome w chmurze, która zarządza własnymi zakłóceniami w grupie. Więcej informacji znajdziesz w dokumencie CBRSA-TS-2001 V3.0.0.

commonChannelGroup

string

(Common Channel Group) (CCG). Grupa CBSD w tym samym ICG, która prosi o typowe przypisanie głównego kanału. Więcej informacji znajdziesz w dokumencie CBRSA-TS-2001 V3.0.0.

antennaModel

string

Jeśli ta opcja jest wypełniona, podaj wzór dla anteny. Format: RecordCreatorId:PatternId

nrqzValidated
(deprecated)

boolean

Tylko dane wyjściowe. Ustaw na true, jeśli CPI potwierdził, że jest skoordynowany z amerykańskim biurem ds. cichej strefy.

nrqzValidation

object (NrqzValidation)

Tylko dane wyjściowe. Informacje dotyczące walidacji strefy cichej stacji radiowej.

NrqzValidation

Informacje o walidacji cichej strefy radiowej.

Zapis JSON
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Pola
state

enum (State)

Stan weryfikacji NRQZ.

caseId

string

Identyfikator zgłoszenia do weryfikacji.

latitude

number

Szerokość geograficzna urządzenia powiązana z weryfikacją.

longitude

number

Długość geograficzna urządzenia powiązana z weryfikacją.

cpiId

string

CPI, który podpisał weryfikację.

Stan

Stan weryfikacji NRQZ.

Wartości w polu enum
STATE_UNSPECIFIED Nieokreślony stan.
DRAFT Stan wersji roboczej.
FINAL Stan końcowy.

Wynik kanału

Kanał z wynikiem.

Zapis JSON
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Pola
frequencyRange

object (FrequencyRange)

Zakres częstotliwości kanału.

score

number

Wynik kanału został znormalizowany do [0,100].

Metody

create

Tworzy device w node lub customer.

createSigned

Tworzy podpisany device w node lub customer.

list

Wyświetla listę devices pod etykietą node lub customer.