REST Resource: customers.deployments.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,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "currentChannels": [
    {
      object (ChannelWithScore)
    }
  ],
  "grantRangeAllowlists": [
    {
      object (FrequencyRange)
    }
  ]
}
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ı.
deviceMetadata

object (DeviceMetadata)

Hem SAS portalı hem de SAS kayıt istekleri tarafından geçersiz kılınabilen cihaz parametreleri.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Yalnızca çıkış. Puanı olan mevcut kanallar.
grantRangeAllowlists[]

object (FrequencyRange)

Yeni izinler için yalnızca izin verilenler listesindeki aralıklar kullanılabilir.

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ı (nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip). Örnekler: "2014-10-02T15:01:23Z" ve "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)

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

string

İsteğe bağlıdır. Bu alan radioTechnology ile ilgilidir ve CBSD'nin kayıt sırasında uyumlu olduğu radyo arayüzü spesifikasyonunu sağlar.

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
CW
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,
  "cpeCbsdIndication": boolean
}
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 WGS 84 datumuna göre derece cinsinden boylamı. İ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ığı. true: kapalı. false: 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.
cpeCbsdIndication

boolean

Bu parametre, mevcutsa CBSD'nin CPE-CBSD olup olmadığını belirtir.

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 tarafından tanımlanır.

Sıralamalar
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Eyalet

Cihaz yapılandırmasının durumu. CBSD kaydı sırasında yalnızca DEVICE_CONFIG_STATE_FINAL durumundaki yapılandırmalar kullanılabilir.

Sıralamalar
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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)'te 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ı (nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip). Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Hibeler askıya alınırsa askıya alınma nedenleri.
grantId

string

Bağış kimliği.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Son sinyalin iletim geçerlilik süresi.

RFC3339 UTC "Zulu" biçiminde bir zaman damgası (nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip). Örnekler: "2014-10-02T15:01:23Z" ve "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ığı.

DeviceMetadata

Cihaz verileri hem SAS Portal hem de kayıt istekleriyle geçersiz kılınabilir.

JSON gösterimi 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Alanlar
interferenceCoordinationGroup

string

Girişim Koordinasyon Grubu (ICG). Grup içindeki kendi girişimlerini yöneten bir CBSD grubu. Daha fazla bilgi için CBRSA-TS-2001 V3.0.0 başlıklı makaleye bakın.
commonChannelGroup

string

Ortak Kanal Grubu (CCG). Aynı ICG'deki bir grup CBSD, ortak bir birincil kanal ataması istiyor. Daha fazla bilgi için CBRSA-TS-2001 V3.0.0 başlıklı makaleye bakın.
antennaModel

string

Doldurulursa kullanılacak anten model deseni. Biçim: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Yalnızca çıkış. Bir CPI, Ulusal Sessiz Bölge Ofisi ile koordineli çalıştığını doğrulamışsa true olarak ayarlayın.
nrqzValidation

object (NrqzValidation)

Yalnızca çıkış. Ulusal Radyo Sessiz Bölgesi doğrulama bilgileri.

NrqzValidation

Ulusal Radyo Sessizliği Bölgesi doğrulaması hakkında bilgi.

JSON gösterimi 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Alanlar
state

enum (State)

NRQZ doğrulama bilgilerinin durumu.
caseId

string

Doğrulama yazışma kimliği.
latitude

number

Doğrulama ile ilişkili cihaz enlemi.
longitude

number

Doğrulama ile ilişkili cihaz boylamı.
cpiId

string

Doğrulamayı imzalayan CPI.

Eyalet

NRQZ doğrulama bilgilerinin durumu.

Sıralamalar
STATE_UNSPECIFIED Durum belirtilmemiş.
DRAFT Taslak durumu.
FINAL Son durum.

ChannelWithScore

Puanı olan kanal.

JSON gösterimi 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Alanlar
frequencyRange

object (FrequencyRange)

Kanalın frekans aralığı.
score

number

[0,100] aralığında olacak şekilde normalleştirilmiş kanal puanı.

Yöntemler

create

 node veya customer altında device oluşturur.

createSigned

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

list

 node veya customer altında devices listeleri