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

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,

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund. Przykład: "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)

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

Warunkowy
supportedSpec

string

To pole jest związane z polem radioTechnology i podało specyfikację interfejsu powietrznego, z którą zgodny jest CBSD w momencie rejestracji.

Opcjonalny

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
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
}
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 ma wartość "AGL" wysokość anteny należy podać względem poziomu gruntu. Gdy wartość parametru heightType ma wartość "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. Prawda: wewnątrz. Fałsz: 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.

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] [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 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
}
Pola
maxEirp

number

Maksymalna równoważna siła promieniowania izotropowego (EIRP) dozwolona w przypadku przyznania. Maksymalny EIRP to jednostki dBm/MHz. Wartość maxEirp reprezentuje średni EIRP (RMS), który można zmierzyć zgodnie z procedurą zdefiniowaną w 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.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund. Przykład: "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.

Metody

create

 Tworzy device w node lub customer.

createSigned

 Tworzy podpisany device w node lub customer.

delete

 Usuwa device.

get

 Otrzymuje szczegółowe informacje o tagu device.

list

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

move

 Przenoszę element device pod inny node lub customer.

patch

 Aktualizuje device.

signDevice

 Podpis: device.

updateSigned

 Aktualizuje podpisane device.