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 门户 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 类。

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：室内。False：室外。
antennaAzimuth

integer

天线水平面的瞄准方向（以相对于正北方的角度表示）。此参数的值是一个介于 0 到 359（含 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）。如果未包含，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 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒。示例："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

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。