REST Resource: customers.deployments.devices

Resource: Device

Representasi JSON 
{
  "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)
    }
  ]
}
Kolom
name

string

Hanya output. Nama jalur resource.
fccId

string

ID FCC perangkat.
serialNumber

string

Nomor seri yang ditetapkan untuk perangkat oleh produsen perangkat.
preloadedConfig

object (DeviceConfig)

Konfigurasi perangkat, seperti yang ditentukan melalui SAS Portal API.
activeConfig

object (DeviceConfig)

Hanya output. Konfigurasi perangkat saat ini seperti yang terdaftar di SAS.
state

enum (State)

Hanya output. Status perangkat.
grants[]

object (DeviceGrant)

Hanya output. Pemberian yang dipegang oleh perangkat.
displayName

string

Nama tampilan perangkat.
deviceMetadata

object (DeviceMetadata)

Parameter perangkat yang dapat diganti oleh permintaan pendaftaran SAS dan Portal SAS.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Hanya output. Saluran saat ini dengan skor.
grantRangeAllowlists[]

object (FrequencyRange)

Hanya rentang yang berada dalam daftar yang diizinkan yang tersedia untuk pemberian baru.

DeviceConfig

Informasi tentang konfigurasi perangkat.

Representasi 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
}
Kolom
category

enum (DeviceCategory)

Kategori FCC perangkat.
model

object (DeviceModel)

Informasi tentang model perangkat ini.
airInterface

object (DeviceAirInterface)

Informasi tentang antarmuka radio perangkat ini.
installationParams

object (InstallationParams)

Parameter penginstalan untuk perangkat.
measurementCapabilities[]

enum (MeasurementCapability)

Kemampuan pelaporan pengukuran perangkat.
userId

string

ID pengguna perangkat.
callSign

string

Tanda panggil operator perangkat.
state

enum (State)

Status konfigurasi.
isSigned

boolean

Hanya output. Apakah konfigurasi telah ditandatangani oleh CPI.
updateTime

string (Timestamp format)

Hanya output. Terakhir kali konfigurasi perangkat diedit.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

DeviceCategory

Kategori FCC perangkat, sebagaimana ditentukan oleh Bagian 96.

Enum
DEVICE_CATEGORY_UNSPECIFIED Kategori perangkat tidak ditentukan.
DEVICE_CATEGORY_A Kategori A.
DEVICE_CATEGORY_B Kategori B.

DeviceModel

Informasi tentang model perangkat.

Representasi JSON 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Kolom
vendor

string

Nama vendor perangkat.
name

string

Nama model perangkat.
softwareVersion

string

Versi software perangkat.
hardwareVersion

string

Versi hardware perangkat.
firmwareVersion

string

Versi firmware perangkat.

DeviceAirInterface

Informasi tentang antarmuka radio perangkat.

Representasi JSON 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Kolom
radioTechnology

enum (RadioTechnology)

Kondisional. Kolom ini menentukan teknologi akses radio yang digunakan untuk CBSD.
supportedSpec

string

Opsional. Kolom ini terkait dengan radioTechnology dan memberikan spesifikasi antarmuka radio yang dipatuhi CBSD pada saat pendaftaran.

RadioTechnology

Jenis teknologi akses radio yang disetujui.

Enum
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
CW
REDLINE
TARANA_WIRELESS

InstallationParams

Informasi tentang parameter penginstalan perangkat.

Representasi 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,
  "cpeCbsdIndication": boolean
}
Kolom
latitude

number

Lintang lokasi antena perangkat dalam derajat relatif terhadap datum WGS 84. Rentang yang diizinkan adalah dari -90,000000 hingga +90,000000. Nilai positif mewakili lintang di utara khatulistiwa; nilai negatif di selatan khatulistiwa.
longitude

number

Bujur lokasi antena perangkat dalam derajat relatif terhadap datum WGS 84. Rentang yang diizinkan adalah dari -180,000000 hingga +180,000000. Nilai positif mewakili bujur timur meridian utama; nilai negatif mewakili bujur barat meridian utama.
height

number

Tinggi antena perangkat dalam meter. Jika nilai parameter heightType adalah "AGL", tinggi antena harus diberikan relatif terhadap permukaan tanah. Jika nilai parameter heightType adalah "AMSL", nilai tersebut diberikan sehubungan dengan datum WGS84.
heightType

enum (HeightType)

Menentukan cara mengukur tinggi.
horizontalAccuracy

number

Angka positif dalam meter untuk menunjukkan akurasi lokasi horizontal antena perangkat. Parameter opsional ini hanya boleh ada jika nilainya kurang dari persyaratan FCC sebesar 50 meter.
verticalAccuracy

number

Angka positif dalam meter untuk menunjukkan akurasi lokasi vertikal antena perangkat. Parameter opsional ini hanya boleh ada jika nilainya kurang dari persyaratan FCC sebesar 3 meter.
indoorDeployment

boolean

Apakah antena perangkat berada di dalam ruangan atau tidak. true: dalam ruangan. false: outdoor.
antennaAzimuth

integer

Arah boresight bidang horizontal antena dalam derajat terhadap utara sejati. Nilai parameter ini adalah bilangan bulat dengan nilai antara 0 dan 359 inklusif. Nilai 0 derajat berarti utara sejati; nilai 90 derajat berarti timur. Parameter ini bersifat opsional untuk perangkat Kategori A dan bersyarat untuk perangkat Kategori B.
antennaDowntilt

integer

Kemiringan bawah antena dalam derajat dan merupakan bilangan bulat dengan nilai antara -90 dan +90 inklusif; nilai negatif berarti antena dimiringkan ke atas (di atas horizontal). Parameter ini bersifat opsional untuk perangkat Kategori A dan bersyarat untuk perangkat Kategori B.
antennaGain

integer

Penguatan antena puncak dalam dBi. Parameter ini adalah bilangan bulat dengan nilai antara -127 dan +128 (dBi) inklusif.
eirpCapability

integer

Parameter ini adalah EIRP perangkat maksimum dalam satuan dBm/10MHz dan merupakan bilangan bulat dengan nilai antara -127 dan +47 (dBm/10 MHz) inklusif. Jika tidak disertakan, SAS akan menafsirkannya sebagai EIRP maksimum yang diizinkan dalam satuan dBm/10MHz untuk kategori perangkat.
antennaBeamwidth

integer

Lebar berkas antena 3 dB dari antena di bidang horizontal dalam derajat. Parameter ini adalah bilangan bulat tanpa tanda tangan yang memiliki nilai antara 0 dan 360 (derajat) inklusif; parameter ini bersifat opsional untuk perangkat Kategori A dan bersyarat untuk perangkat Kategori B.
antennaModel

string

Jika antena eksternal digunakan, model antena dapat diberikan secara opsional di kolom ini. String memiliki panjang maksimum 128 oktet.
cpeCbsdIndication

boolean

Jika ada, parameter ini menentukan apakah CBSD adalah CPE-CBSD atau bukan.

HeightType

Menentukan cara mengukur tinggi.

Enum
HEIGHT_TYPE_UNSPECIFIED Jenis tinggi tidak ditentukan.
HEIGHT_TYPE_AGL Ketinggian AGL diukur relatif terhadap permukaan tanah.
HEIGHT_TYPE_AMSL Ketinggian AMSL diukur relatif terhadap permukaan laut rata-rata.

MeasurementCapability

Kemampuan pengukuran perangkat. Nilai ditentukan oleh WINNF-SSC-0002.

Enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Negara Bagian

Status konfigurasi perangkat. Hanya konfigurasi dalam status DEVICE_CONFIG_STATE_FINAL yang dapat digunakan selama Pendaftaran CBSD.

Enum
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

Negara Bagian

Status perangkat.

Enum
DEVICE_STATE_UNSPECIFIED Status tidak ditentukan.
RESERVED Perangkat dibuat di SAS Portal, tetapi belum terdaftar di SAS.
REGISTERED Perangkat terdaftar di SAS.
DEREGISTERED Perangkat tidak terdaftar di SAS.

DeviceGrant

Pemberian perangkat. Otorisasi ini diberikan oleh Sistem Akses Spektrum ke perangkat untuk melakukan transmisi menggunakan parameter operasi tertentu setelah detak jantung yang berhasil oleh perangkat.

Representasi JSON 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": string
}
Kolom
maxEirp

number

Daya Terpancar Isotropik Ekuivalen (EIRP) maksimum yang diizinkan oleh hibah. EIRP maksimum dalam satuan dBm/MHz. Nilai maxEirp mewakili EIRP rata-rata (RMS) yang akan diukur dengan prosedur yang ditentukan dalam bagian 96.41(e)(3) FCC.
frequencyRange

object (FrequencyRange)

Rentang frekuensi transmisi.
state

enum (GrantState)

Status pemberian.
channelType

enum (ChannelType)

Jenis saluran yang digunakan.
moveList[]

object (DpaMoveList)

Daftar pemindahan DPA tempat hibah ini muncul.
expireTime

string (Timestamp format)

Waktu habis masa berlaku pemberian.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Jika pemberian ditangguhkan, alasan penangguhan.
grantId

string

ID Pemberian Izin.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Waktu habis masa berlaku transmisi heartbeat terakhir.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

FrequencyRange

Rentang frekuensi dari low_frequency hingga high_frequency.

Representasi JSON 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Kolom
lowFrequencyMhz

number

Frekuensi terendah rentang frekuensi dalam MHz.
highFrequencyMhz

number

Frekuensi tertinggi rentang frekuensi dalam MHz.

GrantState

Status pemberian.

Enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Pemberian telah diberikan, tetapi perangkat tidak mengirimkan sinyal detak jantung di dalamnya.
GRANT_STATE_TERMINATED Pemberian telah dihentikan oleh SAS.
GRANT_STATE_SUSPENDED Pemberian telah ditangguhkan oleh SAS.
GRANT_STATE_AUTHORIZED Perangkat saat ini sedang mengirimkan data.
GRANT_STATE_EXPIRED Masa berlaku hibah telah berakhir.

ChannelType

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Entri dalam daftar pemindahan DPA.

Representasi JSON 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Kolom
dpaId

string

ID DPA.
frequencyRange

object (FrequencyRange)

Rentang frekuensi yang dipengaruhi daftar pemindahan.

DeviceMetadata

Data perangkat dapat diganti oleh SAS Portal dan permintaan pendaftaran.

Representasi JSON 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Kolom
interferenceCoordinationGroup

string

Grup Koordinasi Interferensi (ICG). Grup CBSD yang mengelola interferensi sendiri dengan grup. Untuk mengetahui detail selengkapnya, lihat CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Grup Saluran Umum (CCG). Grup CBSD dalam ICG yang sama meminta penetapan saluran utama umum. Untuk mengetahui detail selengkapnya, lihat CBRSA-TS-2001 V3.0.0.
antennaModel

string

Jika diisi, Pola Model Antena yang akan digunakan. Formatnya adalah: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Hanya output. Disetel ke true jika CPI telah memvalidasi bahwa mereka telah berkoordinasi dengan kantor National Quiet Zone.
nrqzValidation

object (NrqzValidation)

Hanya output. Info validasi National Radio Quiet Zone.

NrqzValidation

Informasi tentang validasi National Radio Quiet Zone.

Representasi JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Kolom
state

enum (State)

Status info validasi NRQZ.
caseId

string

ID kasus validasi.
latitude

number

Lintang perangkat yang terkait dengan validasi.
longitude

number

Bujur perangkat yang terkait dengan validasi.
cpiId

string

CPI yang menandatangani validasi.

Negara Bagian

Status info validasi NRQZ.

Enum
STATE_UNSPECIFIED Status tidak ditentukan.
DRAFT Status draf.
FINAL Status akhir.

ChannelWithScore

Channel dengan skor.

Representasi JSON 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Kolom
frequencyRange

object (FrequencyRange)

Rentang frekuensi saluran.
score

number

Skor channel, dinormalisasi agar berada dalam rentang [0,100].

Metode

create

 Membuat device di bawah node atau customer.

createSigned

 Membuat device yang ditandatangani di bawah node atau customer.

list

 Mencantumkan devices di bawah node atau customer.