REST Resource: customers.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
}
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.

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. Przykład: "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)

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

Warunkowy
supportedSpec

string

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

Opcjonalny

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
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
}
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 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 należy podać 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. Prawda: w pomieszczeniu. Fałsz: 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.

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] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

Wartości w polu enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

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
}
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. Przykład: "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.

Metody

create

 Tworzy device pod node lub customer.

createSigned

 Tworzy podpisany device w ramach node lub customer.

delete

 Usuwa device.

get

 Pobiera szczegóły device.

list

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

move

 Przenosi device pod inny symbol node lub customer.

patch

 Aktualizuje device.

signDevice

 Podpisuje device.

updateSigned

 Aktualizuje podpisany plik device.