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

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

Kolom ini menentukan teknologi akses radio yang digunakan untuk CBSD.

Kondisional

supportedSpec

string

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

Opsional

RadioTechnology

Jenis teknologi akses radio yang disetujui.

Enum
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 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. Benar: dalam ruangan. Salah: luar ruangan.

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.

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

Enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

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
}
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 FCC bagian 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)

Daftar pemindahan DPA tempat hibah ini muncul.

expireTime

string (Timestamp format)

Waktu habis masa berlaku pemberian.

Stempel waktu dalam format RFC3339 UTC "Zulu", akurat hingga nanodetik. Contoh: "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.

Metode

create

Membuat device di bawah node atau customer.

createSigned

Membuat device yang ditandatangani di bawah node atau customer.

delete

Menghapus device.

get

Mendapatkan detail tentang device.

list

Mencantumkan devices di bawah node atau customer.

move

Memindahkan device di bawah node atau customer lain.

patch

Memperbarui device.

signDevice

Menandatangani device.

updateSigned

Memperbarui device yang ditandatangani.