REST Resource: customers.devices

資源：Device

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 Portal 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：

裝置型號

裝置型號的相關資訊。

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

string

裝置供應商的名稱。
name

string

裝置型號名稱。
softwareVersion

string

裝置的軟體版本。
hardwareVersion

string

裝置的硬體版本。
firmwareVersion

string

裝置的韌體版本。

裝置空氣介面

裝置空氣介面的相關資訊。

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

enum (RadioTechnology)

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

須符合條件
supportedSpec

string

這個欄位與無線電技術技術欄位相關，並提供註冊時符合 CBSD 規定的空氣介面規格。

選用

無線電技術

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

列舉
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

裝置天線高度 (單位為公尺)。當高度類型參數值為「AGL」時，天線高度應以地面高度為基準。如果高度類型參數值為「AMSL」，表示它與 WGS84 資料基準有關。
heightType

enum (HeightType)

指定高度的測量方式。

horizontalAccuracy

number

以公尺為單位的數值，代表裝置天線水平位置的準確度。只有在選用值小於 FCC 50 公尺的情況下，才需要顯示這個選用參數。
verticalAccuracy

number

以公尺為單位表示裝置天線垂直位置的準確度。只有在選用值小於 3 公尺的 FCC 規定時，才需要顯示這個選用參數。
indoorDeployment

boolean

裝置天線是否為室內裝置。是：室內。否：戶外。
antennaAzimuth

integer

天線水平平面的垂直方向，以正北為基準。這個參數的值是介於 0 到 359 (含) 之間的整數。0 度代表正北，90 度代表東方。對於 A 類裝置，這個參數為選用，而 B 類別裝置則是選擇性使用。
antennaDowntilt

integer

天線向下傾斜度，是介於 -90 到 +90 (含) 之間的整數；負數則代表天線向上傾斜 (水平以上)。對於 A 類裝置，這個參數為選用，而 B 類別裝置則是選擇性使用。
antennaGain

integer

最高天線增益 (dBi)這個參數是介於 -127 和 +128 (dBi) 之間的整數。
eirpCapability

integer

這項參數是 dBm/10MHz 的單位裝置最高 IIRP，其值為介於 -127 和 +47 (dBm/10 MHz) 之間的整數。如果沒有納入，SAS 會將該裝置視為裝置類別允許的上限 EdRP (dBm/10MHz)。
antennaBeamwidth

integer

水平面上天線的天線 3 dB 光度，單位為度。這個參數是介於 0 和 360 (包含) 之間的不帶正負號整數，適用 A 類裝置和類別 B 裝置條件。
antennaModel

string

如果使用外部天線，這個欄位中會提供天線模型。字串長度上限為 128 個八位元組。

高度類型

指定高度的測量方式。

列舉
HEIGHT_TYPE_UNSPECIFIED 未指定高度類型。
HEIGHT_TYPE_AGL AGL 高度是根據地面測量的測量值。
HEIGHT_TYPE_AMSL AMSL 高度是根據平均海拔測量而得。

評估功能

裝置測量功能。這些值是由 [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 取消註冊。

裝置授權

裝置授權。可讓「頻譜存取系統」為裝置提供的授權，在裝置成功產生心跳後，透過指定的作業參數進行傳輸。

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"。

頻率範圍

頻率範圍從 low_frequency 到 high_frequency。

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

number

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

number

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

授權州

授權狀態。

列舉
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED 已授予權限，但裝置目前沒有跳動。
GRANT_STATE_TERMINATED SAS 已終止授權。
GRANT_STATE_SUSPENDED SAS 已遭停權。
GRANT_STATE_AUTHORIZED 裝置目前正在傳輸中。
GRANT_STATE_EXPIRED 授權已過期。

頻道類型

列舉
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

DPA' 移動清單中的項目。

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

string

DPA 的 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。