REST Resource: customers.deployments.devices

Resource: Perangkat

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. Hibah yang ditahan oleh perangkat.

displayName

string

Nama tampilan perangkat.

deviceMetadata

object (DeviceMetadata)

Parameter perangkat yang dapat diganti oleh Portal SAS dan permintaan pendaftaran 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 hibah baru.

KonfigurasiPerangkat

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 perangkat: FCC.

model

object (DeviceModel)

Informasi tentang model perangkat ini.

airInterface

object (DeviceAirInterface)

Informasi tentang antarmuka udara perangkat ini.

installationParams

object (InstallationParams)

Parameter penginstalan untuk perangkat.

measurementCapabilities[]

enum (MeasurementCapability)

Kemampuan pelaporan pengukuran perangkat.

userId

string

ID pengguna perangkat.

callSign

string

Tanda panggilan 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".

KategoriPerangkat

Kategori perangkat FCC, seperti yang ditetapkan oleh Bagian 96.

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

ModelPerangkat

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 udara 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 udara yang sesuai dengan CBSD pada saat pendaftaran.

Teknologi Radio

Jenis teknologi akses radio yang disetujui.

Enumerasi
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 yang sesuai dengan data WGS 84. Rentang yang diizinkan adalah dari -90.000000 hingga +90.000000. Nilai positif menunjukkan lintang utara dari khatulistiwa; nilai negatif selatan khatulistiwa.

longitude

number

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

height

number

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

heightType

enum (HeightType)

Menentukan cara tinggi diukur.

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 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 3 meter.

indoorDeployment

boolean

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

antennaAzimuth

integer

Arah Boreer dari 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 opsional untuk perangkat Kategori A dan bersyarat untuk perangkat Kategori B.

antennaDowntilt

integer

Antena miring ke bawah 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 opsional untuk perangkat Kategori A dan bersyarat untuk perangkat Kategori B.

antennaGain

integer

Puncak antena yang diperoleh di dBi. Parameter ini adalah bilangan bulat dengan nilai antara -127 dan +128 (dBi) inklusif.

eirpCapability

integer

Parameter ini adalah EIRP perangkat maksimum dalam unit 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 unit dBm/10MHz untuk kategori perangkat.

antennaBeamwidth

integer

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

antennaModel

string

Jika antena eksternal digunakan, model antena secara opsional disediakan di kolom ini. Panjang string maksimum adalah 128 oktet.

cpeCbsdIndication

boolean

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

JenisTinggi

Menentukan cara tinggi diukur.

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

KemampuanPengukuran

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

Enumerasi
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.

Enumerasi
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

Negara bagian

Status perangkat.

Enumerasi
DEVICE_STATE_UNSPECIFIED Status tidak ditentukan.
RESERVED Namun, perangkat yang dibuat di Portal SAS belum didaftarkan ke SAS.
REGISTERED Perangkat terdaftar dengan SAS.
DEREGISTERED Pendaftaran perangkat dengan SAS dibatalkan.

Hibah Perangkat

Pemberian perangkat. Ini adalah otorisasi yang diberikan oleh Sistem Akses Spektrum untuk perangkat guna melakukan transmisi menggunakan parameter operasi yang ditentukan setelah detak jantung 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

Setara Maksimum Radiasi Isotropik (EIRP) yang diizinkan oleh hibah. EIRP maksimum adalah dalam satuan dBm/MHz. Nilai maxEirp mewakili EIRP rata-rata (RMS) yang akan diukur oleh prosedur yang ditentukan dalam FCC 96.41(e)(3).

frequencyRange

object (FrequencyRange)

Rentang frekuensi transmisi.

state

enum (GrantState)

Status pemberian.

channelType

enum (ChannelType)

Jenis saluran yang digunakan.

moveList[]

object (DpaMoveList)

Pemindahan DPA mencantumkan daftar hibah ini.

expireTime

string (Timestamp format)

Waktu habis masa berlaku hibah.

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 penangguhan ditangguhkan, alasan penangguhan.

grantId

string

Id yang Diberikan.

lastHeartbeatTransmitExpireTime

string (Timestamp format)

Waktu habis masa berlaku transmisi detak jantung 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".

RentangFrekuensi

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.

Status Hibah

Status pemberian.

Enumerasi
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Pemberian telah diizinkan namun perangkat tidak mendukung detak jantung.
GRANT_STATE_TERMINATED Hibah telah dihentikan oleh SAS.
GRANT_STATE_SUSPENDED Hibah telah ditangguhkan oleh SAS.
GRANT_STATE_AUTHORIZED Perangkat saat ini sedang mentransmisi.
GRANT_STATE_EXPIRED Masa berlaku hibah telah berakhir.

Jenis Saluran

Enumerasi
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Entri dalam daftar pindah DPA.

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

string

ID DPA.

frequencyRange

object (FrequencyRange)

Rentang frekuensi yang dipengaruhi oleh daftar pemindahan.

Metadata Perangkat

Data perangkat dapat diganti oleh Portal SAS dan permintaan pendaftaran.

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

string

Grup Koordinasi Gangguan (ICG). Sekelompok CBSD yang mengelola gangguan mereka sendiri dengan grup. Untuk detail selengkapnya, lihat CBRSA-TS-2001 V3.0.0.

commonChannelGroup

string

Grup Saluran Umum (CCG). Sekelompok CBSD dalam ICG yang sama meminta penetapan channel utama yang umum. Untuk 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. Tetapkan ke true jika CPI telah memvalidasi bahwa mereka telah berkoordinasi dengan kantor National tenang Zone.

nrqzValidation

object (NrqzValidation)

Hanya output. Info validasi Zona Senyap Radio Nasional.

NrqzValid

Informasi tentang validasi Zona Tenang Radio Nasional.

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.

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

SaluranDenganSkor

Saluran dengan skor.

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

object (FrequencyRange)

Rentang frekuensi saluran.

score

number

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

Metode

create

Membuat device pada node atau customer.

createSigned

Membuat device yang ditandatangani dalam node atau customer.

list

Mencantumkan devices pada node atau customer.