REST Resource: customers.deployments.devices

Zasób: Device

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. Bieżąca konfiguracja urządzenia zarejestrowanego w SAS.
state

enum (State)

Tylko dane wyjściowe. Stan urządzenia.
grants[]

object (DeviceGrant)

Tylko dane wyjściowe. Uprawnienia przyznane urządzeniu.
displayName

string

Wyświetlana nazwa urządzenia.
deviceMetadata

object (DeviceMetadata)

Parametry urządzenia, które mogą zostać zastąpione zarówno przez portal SAS, jak i przez żądania rejestracji SAS.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Tylko dane wyjściowe. Bieżące kanały z wynikami.
grantRangeAllowlists[]

object (FrequencyRange)

W przypadku nowych zezwoleń dostępne są tylko zakresy znajdujące się na listach dozwolonych.

DeviceConfig

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 urządzenia według FCC.
model

object (DeviceModel)

Informacje o tym modelu urządzenia.
airInterface

object (DeviceAirInterface)

Informacje o interfejsie radiowym tego urządzenia.
installationParams

object (InstallationParams)

Parametry instalacji urządzenia.
measurementCapabilities[]

enum (MeasurementCapability)

Możliwości raportowania pomiarów przez urządzenie.
userId

string

Identyfikator użytkownika urządzenia.
callSign

string

Znak wywoławczy operatora urządzenia.
state

enum (State)

Stan konfiguracji.
isSigned

boolean

Tylko dane wyjściowe. Czy konfiguracja została podpisana przez certyfikowanego instalatora.
updateTime

string (Timestamp format)

Tylko dane wyjściowe. Ostatnia edycja konfiguracji urządzenia.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund i maksymalnie 9 miejscami po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

DeviceCategory

Kategoria urządzenia według FCC, zgodnie z definicją w części 96.

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

DeviceModel

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.

DeviceAirInterface

Informacje o interfejsie radiowym urządzenia.

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

enum (RadioTechnology)

Warunkowe. To pole określa technologię dostępu radiowego używaną w przypadku urządzenia CBSD.
supportedSpec

string

Opcjonalnie. To pole jest powiązane ze specyfikacją radioTechnology i zawiera specyfikację interfejsu radiowego, z którą urządzenie CBSD jest zgodne w momencie rejestracji.

RadioTechnology

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

InstallationParams

Informacje o parametrach instalacji urządzenia.

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 lokalizacji anteny urządzenia w stopniach względem układu WGS 84. Dozwolony zakres to od -90,000000 do +90,000000. Wartości dodatnie oznaczają szerokość geograficzną na północ od równika, a ujemne – na południe od niego.
longitude

number

Długość geograficzna lokalizacji anteny urządzenia w stopniach względem układu odniesienia WGS 84. Dozwolony zakres to od -180,000000 do +180,000000. Wartości dodatnie oznaczają długości geograficzne na wschód od południka zerowego, a ujemne – na zachód od niego.
height

number

Wysokość anteny urządzenia w metrach. Gdy wartość parametru heightType to „AGL”, wysokość anteny powinna być podana względem poziomu gruntu. Gdy wartość parametru heightType to „AMSL”, jest ona podawana w odniesieniu do układu WGS84.
heightType

enum (HeightType)

Określa sposób pomiaru wysokości.
horizontalAccuracy

number

Liczba dodatnia w metrach wskazująca dokładność poziomego położenia anteny urządzenia. Ten opcjonalny parametr powinien być obecny tylko wtedy, gdy jego wartość jest mniejsza niż wymagane przez FCC 50 metrów.
verticalAccuracy

number

Liczba dodatnia w metrach wskazująca dokładność pionowego położenia anteny urządzenia. Ten opcjonalny parametr powinien być obecny tylko wtedy, gdy jego wartość jest mniejsza niż wymagane przez FCC 3 metry.
indoorDeployment

boolean

Określa, czy antena urządzenia jest wewnątrz budynku. true: w pomieszczeniu. false: na zewnątrz.
antennaAzimuth

integer

Kierunek osi głównej anteny w płaszczyźnie poziomej w stopniach względem północy geograficznej. Wartość tego parametru to liczba całkowita z zakresu od 0 do 359 włącznie. Wartość 0 stopni oznacza północ geograficzną, a 90 stopni – wschód. W przypadku urządzeń kategorii A ten parametr jest opcjonalny, a w przypadku urządzeń kategorii B – warunkowy.
antennaDowntilt

integer

Pochylenie anteny w stopniach. Jest to liczba całkowita z zakresu od -90 do +90 włącznie. Wartość ujemna oznacza, że antena jest pochylona w górę (powyżej poziomu). W przypadku urządzeń kategorii A ten parametr jest opcjonalny, a w przypadku urządzeń kategorii B – warunkowy.
antennaGain

integer

Szczytowe wzmocnienie anteny w dBi. Ten parametr to liczba całkowita z zakresu od -127 do +128 dBi włącznie.
eirpCapability

integer

Ten parametr to maksymalna moc EIRP urządzenia w jednostkach dBm/10 MHz. Jest to liczba całkowita z zakresu od –127 do +47 dBm/10 MHz włącznie. Jeśli nie jest uwzględniona, SAS interpretuje ją jako maksymalną dopuszczalną moc EIRP w jednostkach dBm/10 MHz dla kategorii urządzenia.
antennaBeamwidth

integer

Szerokość wiązki anteny 3 dB w płaszczyźnie poziomej w stopniach. Ten parametr to liczba całkowita bez znaku o wartości z zakresu od 0 do 360 (stopni) włącznie. Jest on opcjonalny w przypadku urządzeń kategorii A i warunkowy w przypadku urządzeń kategorii B.
antennaModel

string

Jeśli używana jest antena zewnętrzna, w tym polu można podać jej model. Ciąg znaków może mieć maksymalnie 128 oktetów.
cpeCbsdIndication

boolean

Jeśli ten parametr jest obecny, określa, czy urządzenie CBSD jest urządzeniem CPE-CBSD.

HeightType

Określa sposób pomiaru wysokości.

Wartości w polu enum
HEIGHT_TYPE_UNSPECIFIED Nieokreślony typ wysokości.
HEIGHT_TYPE_AGL Wysokość AGL jest mierzona względem poziomu gruntu.
HEIGHT_TYPE_AMSL Wysokość AMSL jest mierzona względem średniego poziomu morza.

MeasurementCapability

Możliwość pomiaru na urządzeniu. Wartości są zdefiniowane w dokumencie 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 CBSD 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 zostało utworzone w SAS Portal, ale nie zostało jeszcze zarejestrowane w SAS.
REGISTERED Urządzenie zarejestrowane w SAS.
DEREGISTERED Urządzenie zostało wyrejestrowane z SAS.

DeviceGrant

Przyznanie urządzenia. Jest to autoryzacja przyznawana przez system Spectrum Access System urządzeniu, które po wysłaniu sygnału o stanie gotowości może transmitować dane przy użyciu określonych parametrów operacyjnych.

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 efektywna moc wypromieniowana izotropowo (EIRP) dozwolona w ramach grantu. Maksymalna moc EIRP jest podawana w jednostkach dBm/MHz. Wartość maxEirp reprezentuje średnią (RMS) moc EIRP, która zostałaby zmierzona zgodnie z procedurą określoną w części 96.41(e)(3) przepisów FCC.
frequencyRange

object (FrequencyRange)

Zakres częstotliwości transmisji.
state

enum (GrantState)

Stan uwierzytelnienia.
channelType

enum (ChannelType)

Rodzaj użytego kanału.
moveList[]

object (DpaMoveList)

Na liście przeniesień DPA pojawia się ta dotacja.
expireTime

string (Timestamp format)

Okres ważności uwierzytelnienia.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund i maksymalnie 9 miejscami po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Jeśli grant został zawieszony, podaj powody zawieszenia.
grantId

string

Identyfikator zezwolenia.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Czas wygaśnięcia transmisji ostatniego pakietu podtrzymującego.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund i maksymalnie 9 miejscami po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

FrequencyRange

Zakres częstotliwości od low_frequency do high_frequency.

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

number

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

number

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

GrantState

Stan przyznania.

Wartości w polu enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Grant został przyznany, ale urządzenie nie wysyła sygnału o jego stanie.
GRANT_STATE_TERMINATED Zezwolenie zostało anulowane przez SAS.
GRANT_STATE_SUSPENDED Grant został zawieszony przez SAS.
GRANT_STATE_AUTHORIZED Urządzenie obecnie transmituje.
GRANT_STATE_EXPIRED Zezwolenie wygasło.

ChannelType

Wartości w polu enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Wpis na liście przeniesień organu ochrony danych.

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

string

Identyfikator DPA.
frequencyRange

object (FrequencyRange)

Zakres częstotliwości, na który wpływa lista ruchów.

DeviceMetadata

Dane urządzenia, które można zastąpić zarówno w SAS Portal, jak i w żądaniach rejestracji.

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

string

Grupa ds. koordynacji zakłóceń (ICG). Grupa stacji CBSD, które samodzielnie zarządzają zakłóceniami w grupie. Więcej informacji znajdziesz w dokumencie CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Wspólna grupa kanałów (CCG). Grupa urządzeń CBSD w tej samej grupie ICG, która prosi o przypisanie wspólnego kanału podstawowego. Więcej informacji znajdziesz w dokumencie CBRSA-TS-2001 V3.0.0.
antennaModel

string

Jeśli to pole jest wypełnione, używany jest wzorzec modelu anteny. Format: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Tylko dane wyjściowe. Ustaw wartość true, jeśli certyfikowany instalator profesjonalny potwierdził, że skontaktował się z krajowym biurem strefy ciszy.
nrqzValidation

object (NrqzValidation)

Tylko dane wyjściowe. Informacje o weryfikacji Narodowej Strefy Ciszy Radiowej.

NrqzValidation

Informacje o weryfikacji strefy ciszy radiowej.

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

enum (State)

Stan informacji o weryfikacji NRQZ.
caseId

string

Identyfikator zgłoszenia weryfikacyjnego.
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 informacji o weryfikacji NRQZ.

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

ChannelWithScore

Kanał z wynikiem.

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

object (FrequencyRange)

Zakres częstotliwości kanału.
score

number

Ocena kanału znormalizowana do zakresu [0, 100].

Metody

create

 Tworzy device pod node lub customer.

createSigned

 Tworzy podpisany device w ramach node lub customer.

list

 Wyświetla listę devices w sekcji node lub customer.