REST Resource: customers.devices

資源：裝置

JSON 表示法 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
欄位
name

string

僅供輸出。資源路徑名稱。
fccId

string

裝置的 FCC ID。
serialNumber

string

裝置製造商為裝置指派的序號。
preloadedConfig

object (DeviceConfig)

裝置設定，透過 SAS 入口網站 API 指定。

activeConfig

object (DeviceConfig)

僅供輸出。裝置目前向 SAS 註冊的設定。

state

enum (State)

僅供輸出。裝置狀態。

grants[]

object (DeviceGrant)

僅供輸出。裝置持有的授權。
displayName

string

裝置顯示名稱。

DeviceConfig

裝置設定資訊。

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
}
欄位
category

enum (DeviceCategory)

裝置的 FCC 類別。

model

object (DeviceModel)

這部裝置型號的相關資訊。

airInterface

object (DeviceAirInterface)

這部裝置的無線介面相關資訊。

installationParams

object (InstallationParams)

裝置的安裝參數。

measurementCapabilities[]

enum (MeasurementCapability)

裝置的評估報告功能。

userId

string

裝置使用者的 ID。
callSign

string

裝置操作人員的呼號。
state

enum (State)

設定狀態。

isSigned

boolean

僅供輸出。設定是否已由 CPI 簽署。
updateTime

string (Timestamp format)

僅供輸出。上次編輯裝置設定的時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位。範例："2014-10-02T15:01:23.045123456Z"。

DeviceCategory

裝置的 FCC 類別 (如第 96 部分所定義)。

列舉
DEVICE_CATEGORY_UNSPECIFIED 未指定裝置類別。
DEVICE_CATEGORY_A A 類。
DEVICE_CATEGORY_B 類型 B。

DeviceModel

裝置型號的相關資訊。

JSON 表示法 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
欄位
vendor

string

裝置供應商名稱。
name

string

裝置型號名稱。
softwareVersion

string

裝置的軟體版本。
hardwareVersion

string

裝置的硬體版本。
firmwareVersion

string

裝置的韌體版本。

DeviceAirInterface

裝置的無線介面相關資訊。

JSON 表示法 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
欄位
radioTechnology

enum (RadioTechnology)

這個欄位指定用於 CBSD 的無線電存取技術。

條件式
supportedSpec

string

這個欄位與 radioTechnology 欄位相關，提供 CBSD 在註冊時符合的無線介面規格。

選用

RadioTechnology

核准的無線電存取技術類型。

列舉
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

InstallationParams

裝置安裝參數的相關資訊。

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
}
欄位
latitude

number

裝置天線位置的緯度，以相對於 WGS 84 基準的度數表示。允許的範圍為 -90.000000 至 +90.000000。正值代表赤道以北的緯度，負值則代表赤道以南的緯度。
longitude

number

裝置天線位置的經度，以相對於 WGS 84 基準的度數表示。允許的範圍為 -180.000000 至 +180.000000。正值代表本初子午線以東的經度，負值則代表本初子午線以西的經度。
height

number

裝置天線高度 (以公尺為單位)。如果 heightType 參數值為「AGL」，則天線高度應以地面高度為基準。如果 heightType 參數值為「AMSL」，則會以 WGS84 基準為準。
heightType

enum (HeightType)

指定高度的測量方式。

horizontalAccuracy

number

正數 (以公尺為單位)，表示裝置天線水平位置的準確度。只有在值小於 FCC 規定的 50 公尺時，才應提供這項選用參數。
verticalAccuracy

number

正數 (以公尺為單位)，表示裝置天線垂直位置的準確度。如果選用參數的值小於 FCC 規定的 3 公尺，才需要提供這項參數。
indoorDeployment

boolean

裝置天線是否位於室內。True：室內。錯誤：戶外。
antennaAzimuth

integer

天線水平面的瞄準方向 (以度為單位，相對於正北)。這個參數的值是介於 0 到 359 之間的整數 (含首尾)。0 度表示正北，90 度表示正東。此參數對 A 類裝置而言為選用，對 B 類裝置而言則為條件式。
antennaDowntilt

integer

天線下傾角度 (以度為單位)，是介於 -90 到 +90 之間的整數 (含頭尾值)。負值表示天線向上傾斜 (高於水平)。此參數對 A 類裝置而言為選用，對 B 類裝置而言則為條件式。
antennaGain

integer

天線增益峰值 (以 dBi 為單位)。這個參數是整數，值介於 -127 和 +128 (dBi) 之間 (含頭尾)。
eirpCapability

integer

這個參數是裝置 EIRP 的上限，單位為 dBm/10MHz，且為介於 -127 和 +47 (dBm/10 MHz) 之間的整數 (含 -127 和 +47)。如果未納入，SAS 會將其解讀為裝置類別允許的最大 EIRP，單位為 dBm/10MHz。
antennaBeamwidth

integer

天線在水平面上的 3 dB 天線波束寬度 (以度為單位)。這個參數是不帶正負號的整數，值介於 0 到 360 (度) 之間 (含首尾)，對於 A 類裝置為選用參數，對於 B 類裝置則為條件參數。
antennaModel

string

如果使用外接天線，這個欄位可選擇性提供天線型號。字串長度上限為 128 個八位元。

HeightType

指定高度的測量方式。

列舉
HEIGHT_TYPE_UNSPECIFIED 未指定高度類型。
HEIGHT_TYPE_AGL AGL 高度是相對於地面高度測量。
HEIGHT_TYPE_AMSL AMSL 高度是以平均海平面為基準測量。

MeasurementCapability

裝置評估功能。這些值是由 [WINNF-SSC-0002] 定義 [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf]。

列舉
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

州

裝置狀態。

列舉
DEVICE_STATE_UNSPECIFIED 未指定狀態。
RESERVED 裝置已在 SAS 入口網站中建立，但尚未向 SAS 註冊。
REGISTERED 裝置已向 SAS 註冊。
DEREGISTERED 裝置已向 SAS 取消註冊。

DeviceGrant

裝置授權。這是由頻譜存取系統提供給裝置的授權，裝置成功發送心跳訊號後，即可使用指定作業參數傳輸資料。

JSON 表示法 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
欄位
maxEirp

number

授權允許的最大等效等向輻射功率 (EIRP)。EIRP 上限的單位為 dBm/MHz。maxEirp 值代表根據 FCC 第 96.41 (e)(3) 部分定義的程序測得的平均 (RMS) EIRP。
frequencyRange

object (FrequencyRange)

傳輸頻率範圍。

state

enum (GrantState)

授權狀態。

channelType

enum (ChannelType)

使用的管道類型。

moveList[]

object (DpaMoveList)

這項授權顯示的 DPA 遷移清單。

expireTime

string (Timestamp format)

授權的到期時間。

RFC3339 世界標準時間「Zulu」格式的時間戳記，精確度達奈秒單位。範例："2014-10-02T15:01:23.045123456Z"。

FrequencyRange

頻率範圍：low_frequency 至 high_frequency。

JSON 表示法 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
欄位
lowFrequencyMhz

number

頻率範圍的最低頻率 (以 MHz 為單位)。
highFrequencyMhz

number

頻率範圍的最高頻率 (以 MHz 為單位)。

GrantState

授權的狀態。

列舉
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED 授權已授予，但裝置未透過授權傳送心跳訊號。
GRANT_STATE_TERMINATED SAS 已終止補助。
GRANT_STATE_SUSPENDED SAS 已暫停授權。
GRANT_STATE_AUTHORIZED 裝置目前正在傳輸資料。
GRANT_STATE_EXPIRED 授予項目已過期。

ChannelType

列舉
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

DPA 搬移清單中的項目。

JSON 表示法 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
欄位
dpaId

string

動態產品廣告的 ID。
frequencyRange

object (FrequencyRange)

移動清單影響的頻率範圍。

方法

create

 在 node 或 customer 下建立 device。

createSigned

 在 node 或 customer 下建立已簽署的 device。

delete

 刪除 device。

get

 取得 device 的詳細資料。

list

 列出 node 或 customer 下的 devices。

move

 將 device 移至其他 node 或 customer 下方。

patch

 更新 device。

signDevice

 簽署 device。

updateSigned

 更新已簽署的 device。