REST Resource: customers.deployments.devices

资源：设备

JSON 表示法 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "currentChannels": [
    {
      object (ChannelWithScore)
    }
  ],
  "grantRangeAllowlists": [
    {
      object (FrequencyRange)
    }
  ]
}
字段
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

设备的显示名称。
deviceMetadata

object (DeviceMetadata)

可由 SAS 门户和 SAS 注册请求替换的设备参数。
currentChannels[]
(deprecated)

object (ChannelWithScore)

仅供输出。当前有得分的频道。
grantRangeAllowlists[]

object (FrequencyRange)

只有列入许可名单范围内的范围才可用于新授权。

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:23Z" 和 "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

（可选）此字段与 radioTechnology 相关，可提供 CBSD 在注册时遵循的空中接口规范。

无线电技术

已获批准的无线接入技术类型。

枚举
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
CW
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,
  "cpeCbsdIndication": boolean
}
字段
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 度表示正北；值 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 个八位字节。
cpeCbsdIndication

boolean

如果存在，则此参数指定 CBSD 是否为 CPE-CBSD。

身高类型

指定高度的测量方式。

枚举
HEIGHT_TYPE_UNSPECIFIED 未指定的高度类型。
HEIGHT_TYPE_AGL AGL 高度是相对于地平面测量的。
HEIGHT_TYPE_AMSL AMSL 高度是相对于平均海平面测量的。

效果衡量

设备衡量功能。这些值由 WINNF-SSC-0002 定义。

枚举
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

状态

设备配置的状态。在 CBSD 注册期间，只能使用状态为 DEVICE_CONFIG_STATE_FINAL 的配置。

枚举
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

状态

设备的状态。

枚举
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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
suspensionReason[]

string

如果补助金被暂停，请说明暂停原因。
grantId

string

授权 ID。
lastHeartbeatTransmitExpireTime

string (Timestamp format)

上次检测信号的传输到期时间。

时间戳采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式，分辨率为纳秒级，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "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)

移动列表影响的频率范围。

设备元数据

可通过 SAS 门户和注册请求替换的设备数据。

JSON 表示法 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
字段
interferenceCoordinationGroup

string

干扰协调组 (ICG)。一组自己的 CBSD，自行管理自身的干扰。如需了解详情，请参阅 CBRSA-TS-2001 V3.0.0。
commonChannelGroup

string

公共渠道分组 (CCG)。同一 ICG 中的一组 CBSD 请求通用主信道分配。如需了解详情，请参阅 CBRSA-TS-2001 V3.0.0。
antennaModel

string

填充后，要使用的天线模型模式。格式为：RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

仅供输出。如果 CPI 经验证已与国家安静区办公室协调，则设为 true。
nrqzValidation

object (NrqzValidation)

仅供输出。国家无线电安静区验证信息。

NrqzValidation

有关国家无线电安静区验证的信息。

JSON 表示法 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
字段
state

enum (State)

NRQZ 验证信息的状态。
caseId

string

验证支持请求 ID。
latitude

number

与验证相关的设备纬度。
longitude

number

与验证相关联的设备经度。
cpiId

string

完成验证的每次安装费用。

状态

NRQZ 验证信息的状态。

枚举
STATE_UNSPECIFIED 未指定状态。
DRAFT 草稿状态。
FINAL 最终状态。

渠道评分

带有得分的频道。

JSON 表示法 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
字段
frequencyRange

object (FrequencyRange)

信道的频率范围。
score

number

频道得分，标准化为 [0,100] 范围内的值。

方法

create

 在 node 或 customer 下创建 device。

createSigned

 在 node 或 customer 下创建已签名的 device。

list

 列出 node 或 customer 下的 devices。