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 标识符。
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

设备用户的标识符。
callSign

string

设备运营商的呼号。
state

enum (State)

配置的状态。

isSigned

boolean

仅供输出。配置是否由 CPI 签名。
updateTime

string (Timestamp format)

仅供输出。上次修改设备配置的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒。示例："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

设备的固件版本。

DeviceAirInterface 接口

设备的空中接口的相关信息。

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

安装参数

设备安装参数的相关信息。

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

设备天线是否位于室内。正确：室内。错误：户外。
antennaAzimuth

integer

天线水平面的朝向（以正北为单位）。此参数的值是一个 0 到 359（含）之间的整数。值 0 度表示正北；值 90 度表示东方。对于 A 类设备，此参数是可选的；对于 B 类设备，此参数是有条件的。
antennaDowntilt

integer

天线倾斜度（以度为单位，是一个介于 -90 到 +90 之间的整数；含负值表示天线向上倾斜）（水平上方）。对于 A 类设备，此参数是可选的；对于 B 类设备，此参数是有条件的。
antennaGain

integer

天线峰值增益（以 dBi 为单位）。此参数是一个整数，其值介于 -127（含）和 +128（dBi）之间（含首尾数字）。
eirpCapability

integer

此参数是以 dBm/10MHz 为单位的最大设备 EIRP，是一个介于 -127 和 +47（dBm/10 MHz，含）之间的整数。如未加入，SAS 会将其解释为设备类别所允许的最大 EIRP（单位为 dBm/10MHz）。
antennaBeamwidth

integer

天线水平水平天线的 3-dB 天线带宽（以度为单位）。此参数是一个无符号整数，其值介于 0 和 360（度）之间（包括 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 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒。示例："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。