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)

Cihazın SAS Portal API'sı aracılığıyla belirtilen yapılandırması.
activeConfig

object (DeviceConfig)

Yalnızca çıkış. Cihazın SAS'da kayıtlı olduğu geçerli yapılandırması.
state

enum (State)

Yalnızca çıkış. Cihaz durumu.
grants[]

object (DeviceGrant)

Yalnızca çıkış. Cihaz tarafından verilen hibeler.
displayName

string

Görünen cihaz 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ış. Skoru olan mevcut kanallar.
grantRangeAllowlists[]

object (FrequencyRange)

Yalnızca izin verilenler listelerindeki aralıklar yeni hibeler için kullanılabilir.

Cihaz Yapılandırması

Cihaz yapılandırmasıyla ilgili 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 modeli hakkında bilgi.
airInterface

object (DeviceAirInterface)

Bu cihazın hava arayüzü hakkında bilgi.
installationParams

object (InstallationParams)

Cihaz için 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 YBM tarafından imzalanıp imzalanmadığı.
updateTime

string (Timestamp format)

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

RFC3339 UTC "Zulu&quot" biçiminde nanosaniye çözünürlüğe ve dokuz adede kadar kesir basamağına sahip zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Cihaz Kategorisi

96. Bölüm'de 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.

Cihaz Modeli

Cihazın modeli hakkında 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ü.

Cihaz Hava Arayüzü

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

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

enum (RadioTechnology)

Koşula bağlı. Bu alan, CBSD için kullanılan radyo erişim teknolojisini belirtir.
supportedSpec

string

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

RadyoTeknolojisi

Onaylı 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

Yükleme Paramları

Cihaz kurulum parametreleri hakkında bilgi.

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 anteninin, WGS 84 verisine göre derece cinsinden enlemi. İzin verilen aralık -90,000000 ile +90,000000 arasındadır. Pozitif değerler, ekvatorun kuzeyindeki enlemleri, ekvatorun güneyindeki negatif değerleri temsil eder.
longitude

number

Cihaz anteninin, WGS 84 verisine göre derece derecesi. İzin verilen aralık -180,000000 ile +180.000000 arasındadır. Pozitif değerler primer meridyenin doğu boylamını, meridyenin batısındaki negatif değerleri temsil eder.
height

number

Metre cinsinden metre anten yüksekliği. heightType parametre değeri "AGL" olduğunda anten yüksekliği yer seviyesine göre verilmelidir. heightType parametre değeri "AMSL" olduğunda WGS84 verisi ile ilgili olarak verilir.
heightType

enum (HeightType)

Yüksekliğin nasıl ölçüldüğünü belirtir.
horizontalAccuracy

number

Cihaz anteni yatay konumunun doğruluğunu belirtmek için metre cinsinden pozitif bir sayı. İsteğe bağlı bu parametre, yalnızca değeri 50 metre olan FCC gereksiniminin altındaysa mevcut olmalıdır.
verticalAccuracy

number

Cihaz anteni dikey konumunun doğruluğunu belirtmek için metre cinsinden pozitif bir sayı. İsteğe bağlı bu parametre yalnızca değeri 3 metrenin FCC gereksiniminden az olduğunda mevcut olmalıdır.
indoorDeployment

boolean

Cihaz anteninin kapalı olup olmadığı. true: iç mekan false: Dış mekan.
antennaAzimuth

integer

Antenin yatay düzleminin doğru kuzeye göre derecesinin görüş açısı. Bu parametrenin değeri, 0 ile 359 arasında bir değere sahip bir tam sayıdır. 0 derece değeri kuzey, 90 derece ise doğu anlamına gelir. Bu parametre A kategorisi cihazlar için isteğe bağlıdır ve B kategorisi cihazlar için koşulludur.
antennaDowntilt

integer

Anten yelken derecesi ve -90 ile +90 arasında bir değere sahip bir tam sayıdır. Negatif değer, antenin yukarı doğru (yatay olarak) eğildiği anlamına gelir. Bu parametre A kategorisi cihazlar için isteğe bağlıdır ve B kategorisi cihazlar için koşulludur.
antennaGain

integer

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

integer

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

integer

Yatay düzlemde antenin derece cinsinden 3 dB anten kiriş genişliği. Bu parametre, 0 ile 360 (derece) arasında bir değere sahip olan imzalanmamış bir tam sayıdır. A Kategorisi cihazları için isteğe bağlıdır ve B Kategorisi cihazları için 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

Mevcut olması durumunda bu parametre, CBSD'nin CPE-CBSD olup olmadığını belirtir.

YükseklikTürü

Yüksekliğin nasıl ölçüldüğünü belirtir.

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

Ölçüm Özelliği

Cihaz ölçüm özelliği. Değerler WINNF-SSC-0002 ile 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 Belirtilmemiş durum.
RESERVED Cihaz, SAS Portal'da oluşturuldu ancak henüz SAS'a kayıtlı değil.
REGISTERED Cihaz SAS'a kayıtlı.
DEREGISTERED Cihazın SAS kaydı iptal edildi.

Cihaz Hibesi

Cihaz izni. Spectrum Access System tarafından cihaz tarafından başarılı bir sinyal geçtikten sonra belirtilen çalışma parametreleri kullanılarak aktarım için bir cihaza verilen 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

Hibe tarafından izin verilen maksimum eşdeğer izotropik radyasyon gücü (EIRP). Maksimum EIRP, dBm/MHz birimlerindedir. maxEirp değeri, FCC bölümünde 96.41 (e)(3)'te tanımlanan prosedürle ölçülecek olan ortalama (RMS) EIRP'yi temsil eder.
frequencyRange

object (FrequencyRange)

İletim sıklığı aralığı.
state

enum (GrantState)

Bağış durumu.
channelType

enum (ChannelType)

Kullanılan kanal türü.
moveList[]

object (DpaMoveList)

Bu bağışın gösterildiği DPA taşıma listeleri.
expireTime

string (Timestamp format)

Hibenin geçerlilik süresi.

RFC3339 UTC "Zulu&quot" biçiminde nanosaniye çözünürlüğe ve dokuz adede kadar kesir basamağına sahip zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Hibe askıya alındıysa askıya alma nedenleri.
grantId

string

Hibe Kimliği
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Son sinyalin aktarım geçerlilik süresi.

RFC3339 UTC "Zulu&quot" biçiminde nanosaniye çözünürlüğe ve dokuz adede kadar kesir basamağına sahip zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

Frekans Aralığı

Sıklık aralığı low_frequency ile high_frequency arasında.

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

number

MHz'deki en düşük sıklık aralığı.
highFrequencyMhz

number

MHz'deki en yüksek sıklık aralığı.

GrantState

Bağış durumu.

Sıralamalar
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Hibe verildi ancak cihaz fazla nabız atmıyor.
GRANT_STATE_TERMINATED Hibe SAS tarafından sonlandırıldı.
GRANT_STATE_SUSPENDED Bağış, SAS tarafından askıya alındı.
GRANT_STATE_AUTHORIZED Cihaz şu anda aktarım yapıyor.
GRANT_STATE_EXPIRED Hibenin süresi doldu.

Kanal Türü

Sıralamalar
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaTaşıma Listesi

DPA'lar taşıma listesinde bir 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 sıklık aralığı.

Cihaz Meta Verileri

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

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

string

Müdahale Koordinasyon Grubu (ICG). Kendi grup etkileşimini etkileyen CBSD'ler grubu. Daha ayrıntılı bilgi için CBRSA-TS-2001 V3.0.0 başlıklı makaleyi inceleyin.
commonChannelGroup

string

Ortak Kanal Grubu (CCG). Aynı ICG'de ortak bir birincil kanal ataması isteyen bir CBSD grubu. Daha ayrıntılı bilgi için CBRSA-TS-2001 V3.0.0 başlıklı makaleyi inceleyin.
antennaModel

string

Doldurulursa Kullanılacak Anten Modeli Modeli. Biçim: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Yalnızca çıkış. Bir YBM, National sessiz bölge ofisiyle koordine şekilde çalıştığını doğrularsa true olarak ayarlayın.
nrqzValidation

object (NrqzValidation)

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

NrqzDoğrulama

Ulusal Radyo Sessiz Bölge doğrulama 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şkilendirilen cihaz enlemi.
longitude

number

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

string

Doğrulamayı imzalayan YBM.

Eyalet

NRQZ doğrulama bilgilerinin durumu.

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

Kanal

Puan alan kanal.

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

object (FrequencyRange)

Kanalın sıklık aralığı.
score

number

Kanal puanı [0,100] aralığında olacak şekilde normalleştirilir.

Yöntemler

create

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

createSigned

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

list

 node veya customer altında devices listeleri.