REST Resource: customers.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
}
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.

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", akurat hingga nanodetik. Contoh: "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)

Kolom ini menentukan teknologi akses radio yang digunakan untuk CBSD.

Kondisional

supportedSpec

string

Kolom ini terkait dengan kolom radiotechnology dan memberikan spesifikasi antarmuka udara yang dipatuhi CBSD pada saat pendaftaran.

Opsional

Teknologi Radio

Jenis teknologi akses radio yang disetujui.

Enumerasi
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
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
}
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 sesuai dengan 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. Benar: dalam ruangan. Salah: outdoor.

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.

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] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

Enumerasi
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

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
}
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 dengan prosedur yang ditentukan dalam bagian 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", akurat hingga nanodetik. Contoh: "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.

Metode

create

Membuat device pada node atau customer.

createSigned

Membuat device yang ditandatangani dalam node atau customer.

delete

Menghapus device.

get

Mendapatkan detail tentang device.

list

Mencantumkan devices pada node atau customer.

move

Memindahkan device pada node atau customer lainnya.

patch

Mengupdate device.

signDevice

Menandatangani device.

updateSigned

Memperbarui device yang ditandatangani.