REST Resource: customers.devices

Kaynak: Cihaz

JSON gösterimi
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
Alanlar
name

string

Yalnızca çıkış. Kaynak yolu adı.

fccId

string

Cihazın FCC tanımlayıcısı.

serialNumber

string

Cihaz üreticisi tarafından cihaza atanan seri numarası.

preloadedConfig

object (DeviceConfig)

SAS Portal API ile belirtildiği şekilde cihazın yapılandırması.

activeConfig

object (DeviceConfig)

Yalnızca çıkış. Cihazın SAS'a kayıtlı mevcut yapılandırması.

state

enum (State)

Yalnızca çıkış. Cihaz durumu.

grants[]

object (DeviceGrant)

Yalnızca çıkış. Cihaz tarafından tutulan izinler.

displayName

string

Cihazın görünen adı.

DeviceConfig

Cihaz yapılandırması hakkında bilgiler.

JSON gösterimi
{
  "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
}
Alanlar
category

enum (DeviceCategory)

Cihazın FCC kategorisi.

model

object (DeviceModel)

Bu cihaz modeliyle ilgili bilgiler.

airInterface

object (DeviceAirInterface)

Bu cihazın hava arayüzü hakkında bilgiler.

installationParams

object (InstallationParams)

Cihazın kurulum parametreleri.

measurementCapabilities[]

enum (MeasurementCapability)

Cihazın ölçüm raporlama özellikleri.

userId

string

Cihaz kullanıcısının tanımlayıcısı.

callSign

string

Cihaz operatörünün çağrı işareti.

state

enum (State)

Yapılandırmanın durumu.

isSigned

boolean

Yalnızca çıkış. Yapılandırmanın bir CPI tarafından imzalanıp imzalanmadığı.

updateTime

string (Timestamp format)

Yalnızca çıkış. Cihaz yapılandırmasının en son düzenlendiği zaman.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: "2014-10-02T15:01:23.045123456Z".

DeviceCategory

Bölüm 96'da tanımlandığı şekilde cihazın FCC kategorisi.

Sıralamalar
DEVICE_CATEGORY_UNSPECIFIED Belirtilmemiş cihaz kategorisi.
DEVICE_CATEGORY_A A Kategorisi
DEVICE_CATEGORY_B B kategorisi.

DeviceModel

Cihazın modeliyle ilgili bilgiler.

JSON gösterimi
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Alanlar
vendor

string

Cihaz satıcısının adı.

name

string

Cihaz modelinin adı.

softwareVersion

string

Cihazın yazılım sürümü.

hardwareVersion

string

Cihazın donanım sürümü.

firmwareVersion

string

Cihazın donanım yazılımı sürümü.

DeviceAirInterface

Cihazın hava arayüzü hakkında bilgiler.

JSON gösterimi
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Alanlar
radioTechnology

enum (RadioTechnology)

Bu alan, CBSD için kullanılan radyo erişim teknolojisini belirtir.

Şart Kipi

supportedSpec

string

Bu alan, radioTechnology alanı ile ilgilidir ve CBSD'nin kayıt sırasında uyumlu olduğu radyo arayüzü spesifikasyonunu sağlar.

İsteğe bağlı

RadioTechnology

Onaylanan radyo erişim teknolojisi türleri.

Sıralamalar
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

InstallationParams

Cihaz yükleme parametreleri hakkında bilgiler.

JSON gösterimi
{
  "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
}
Alanlar
latitude

number

Cihaz anten konumunun WGS 84 datumuna göre derece cinsinden enlemi. İzin verilen aralık -90,000000 ile +90,000000 arasındadır. Pozitif değerler ekvatorun kuzeyindeki enlemleri, negatif değerler ise ekvatorun güneyindeki enlemleri gösterir.

longitude

number

Cihaz anten konumunun boylamı. WGS 84 datumuna göre derece cinsinden. İzin verilen aralık -180,000000 ile +180,000000 arasındadır. Pozitif değerler başlangıç meridyeninin doğusundaki boylamları, negatif değerler ise başlangıç meridyeninin batısındaki boylamları gösterir.

height

number

Cihaz anteninin metre cinsinden yüksekliği. heightType parametre değeri "AGL" olduğunda anten yüksekliği, zemin seviyesine göre verilmelidir. heightType parametre değeri "AMSL" olduğunda, WGS84 datumuna göre verilir.

heightType

enum (HeightType)

Yüksekliğin nasıl ölçüleceğini belirtir.

horizontalAccuracy

number

Cihaz anteninin yatay konumunun doğruluğunu gösteren, metre cinsinden pozitif bir sayı. Bu isteğe bağlı parametre yalnızca değeri FCC'nin 50 metrelik şartından küçükse mevcut olmalıdır.

verticalAccuracy

number

Cihaz anteninin dikey konumunun doğruluğunu belirtmek için metre cinsinden pozitif bir sayı. Bu isteğe bağlı parametre yalnızca değeri FCC'nin 3 metrelik şartından düşükse bulunmalıdır.

indoorDeployment

boolean

Cihaz anteninin iç mekanda olup olmadığı. Doğru: Kapalı alan. Yanlış: dış mekan.

antennaAzimuth

integer

Antenin yatay düzleminin gerçek kuzeye göre derece cinsinden boresight yönü. Bu parametrenin değeri, 0 ile 359 arasında (0 ve 359 dahil) bir tam sayıdır. 0 derece değeri gerçek kuzeyi, 90 derece değeri ise doğuyu ifade eder. Bu parametre, A Kategorisi cihazlar için isteğe bağlı, B Kategorisi cihazlar için ise koşulludur.

antennaDowntilt

integer

Derece cinsinden anten eğimi. -90 ile +90 arasında bir tam sayı değeri olmalıdır. Negatif değer, antenin yukarı (yataydan yukarı) eğimli olduğunu gösterir. Bu parametre, A Kategorisi cihazlar için isteğe bağlı, B Kategorisi cihazlar için ise koşulludur.

antennaGain

integer

dBi cinsinden en yüksek anten kazancı. Bu parametre, -127 ile +128 (dBi) arasında bir değere sahip tam sayıdır.

eirpCapability

integer

Bu parametre, dBm/10MHz birimlerinde maksimum cihaz EIRP'sidir ve -127 ile +47 (dBm/10 MHz) arasında (her ikisi de dahil) bir değere sahip bir tam sayıdır. Dahil edilmezse SAS, bunu cihaz kategorisi için dBm/10MHz birimlerinde izin verilen maksimum EIRP olarak yorumlar.

antennaBeamwidth

integer

Antenin yatay düzlemdeki 3 dB anten ışın genişliği (derece cinsinden). Bu parametre, 0 ile 360 (derece) arasında bir değere sahip işaretsiz bir tam sayıdır. A Kategorisi cihazlar için isteğe bağlı, B Kategorisi cihazlar için ise koşulludur.

antennaModel

string

Harici bir anten kullanılıyorsa anten modeli isteğe bağlı olarak bu alanda sağlanır. Dize en fazla 128 sekizli uzunluğunda olabilir.

HeightType

Yüksekliğin nasıl ölçüleceğini belirtir.

Sıralamalar
HEIGHT_TYPE_UNSPECIFIED Belirtilmemiş yükseklik türü.
HEIGHT_TYPE_AGL AGL yüksekliği, zemin seviyesine göre ölçülür.
HEIGHT_TYPE_AMSL AMSL yüksekliği, ortalama deniz seviyesine göre ölçülür.

MeasurementCapability

Cihaz ölçümü özelliği. Değerler [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf] tarafından tanımlanır.

Sıralamalar
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Eyalet

Cihazın durumu.

Sıralamalar
DEVICE_STATE_UNSPECIFIED Durum belirtilmemiş.
RESERVED Cihaz, SAS Portal'da oluşturulmuş ancak henüz SAS'a kaydedilmemiştir.
REGISTERED Cihaz SAS'ye kaydedilmiş olmalıdır.
DEREGISTERED Cihaz, SAS'tan kaydı silinmiş.

DeviceGrant

Cihaz izni. Bu, cihazın başarılı bir sinyal gönderiminden sonra belirtilen çalışma parametrelerini kullanarak iletim yapması için Spectrum Access System tarafından sağlanan bir yetkilendirmedir.

JSON gösterimi
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
Alanlar
maxEirp

number

İzin verilen maksimum eş değer izotropik yayın gücü (EIRP). Maksimum EIRP, dBm/MHz birimindedir. maxEirp değeri, FCC bölüm 96.41 (e)(3) içinde tanımlanan prosedürle ölçülecek ortalama (RMS) EIRP'yi temsil eder.

frequencyRange

object (FrequencyRange)

İletim frekansı aralığı.

state

enum (GrantState)

Hibelerin durumu.

channelType

enum (ChannelType)

Kullanılan kanal türü.

moveList[]

object (DpaMoveList)

Sözleşme, bu hibeyi içeren liste hareketlerini gösterir.

expireTime

string (Timestamp format)

İznin geçerlilik sonu zamanı.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniyeye kadar doğru). Örnek: "2014-10-02T15:01:23.045123456Z".

FrequencyRange

Sıklık aralığı: low_frequency - high_frequency.

JSON gösterimi
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Alanlar
lowFrequencyMhz

number

Frekans aralığının MHz cinsinden en düşük frekansı.

highFrequencyMhz

number

Frekans aralığının en yüksek frekansı (MHz).

GrantState

Hibelerin durumu.

Sıralamalar
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED İzin verilmiş ancak cihazda düzenli olarak sinyal gönderilmiyor.
GRANT_STATE_TERMINATED İzin, SAS tarafından sonlandırıldı.
GRANT_STATE_SUSPENDED Hibeler, SAS tarafından askıya alınmıştır.
GRANT_STATE_AUTHORIZED Cihaz şu anda veri iletiyor.
GRANT_STATE_EXPIRED Hibelerin süresi doldu.

ChannelType

Sıralamalar
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Bir DPA'nın taşıma listesindeki giriş.

JSON gösterimi
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Alanlar
dpaId

string

DPA'nın kimliği.

frequencyRange

object (FrequencyRange)

Taşıma listesinin etkilediği frekans aralığı.

Yöntemler

create

node veya customer altında device oluşturur.

createSigned

node veya customer altında imzalı bir device oluşturur.

delete

device siler.

get

device ile ilgili ayrıntıları alır.

list

node veya customer altında devices listeleri

move

Bir device öğesini başka bir node veya customer öğesinin altına taşır.

patch

device öğesini günceller.

signDevice

device imzalar.

updateSigned

İmzalı bir device dosyasını günceller.