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

デバイス ユーザーの ID。

callSign

string

デバイス事業者のコールサイン。

state

enum (State)

構成の状態。

isSigned

boolean

出力のみ。構成が CPI で署名されているかどうか。

updateTime

string (Timestamp format)

出力のみ。デバイス設定の最終更新日時。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒(例: "2014-10-02T15:01:23.045123456Z")。

DeviceCategory

パート 96 で定義されているデバイスの FCC カテゴリ。

列挙型
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

このフィールドは無線技術フィールドに関連するフィールドで、登録時に 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

デバイスのアンテナの高さ(メートル単位)。heightType パラメータ値が &At&; AGL" の場合、アンテナの高さは地面の相対値で指定します。heightType パラメータ値が &amt; AMSL" の場合、WGS84 データに対して指定されます。

heightType

enum (HeightType)

高さの測定方法を指定します。

horizontalAccuracy

number

デバイス アンテナの水平方向の精度を示す、メートル単位の正の数値です。このオプションのパラメータは、その値が FCC 要件の 50 m を下回った場合にのみ指定します。

verticalAccuracy

number

デバイス アンテナの垂直位置の精度を示す正数(メートル単位)。このオプションのパラメータは、その値が FCC 要件の 3 m より小さい場合にのみ指定する必要があります。

indoorDeployment

boolean

デバイスのアンテナが屋内かどうかを示します。正しい: 屋内。False: 屋外。

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)の範囲の整数です。指定しない場合、SAS はデバイス カテゴリで最大許容 EIRP(dBm/10MHz 単位)と解釈します。

antennaBeamwidth

integer

水平面におけるアンテナの 3 dB アンテナ ビーム幅(度単位)。このパラメータは、0 ~ 360(度)の値を持つ符号なし整数です。カテゴリ A のデバイスの場合、省略可能で、カテゴリ B のデバイスの場合は条件付きになります。

antennaModel

string

外部アンテナを使用する場合は、必要に応じてアンテナモデルを指定します。文字列の最大長は 128 オクテットです。

高さのタイプ

高さの測定方法を指定します。

列挙型
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

State

デバイスの状態。

列挙型
DEVICE_STATE_UNSPECIFIED 未指定の状態
RESERVED SAS Portal で作成されたデバイスがまだ SAS に登録されていない。
REGISTERED SAS に登録されているデバイス。
DEREGISTERED SAS から登録解除されたデバイス。

デバイス付与

デバイスの許可これは、デバイスがハートビートに成功した後に、指定動作パラメータを使用して送信するために Spectrum Access システムによってデバイスに付与される認可です。

JSON 表現
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
フィールド
maxEirp

number

アクセス許可によって許容される最大等価放射電力(EIRP)最大 EIRP は、dBm/MHz の単位です。maxEirp の値は、平均(RMS)EIRP を表し、FCC パート 96.41(e)(3)で定義される手順によって測定されます。

frequencyRange

object (FrequencyRange)

送信周波数範囲。

state

enum (GrantState)

付与の状態。

channelType

enum (ChannelType)

使用されたチャンネルの種類。

moveList[]

object (DpaMoveList)

この付与が表示されている DPA Move リスト。

expireTime

string (Timestamp format)

付与の有効期限。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒(例: "2014-10-02T15:01:23.045123456Z")。

周波数範囲

頻度: low_frequencyhigh_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)

移動リストが影響を与える頻度の範囲。

Methods

create

node または customer の下に device を作成します。

createSigned

node または customer の下に署名付き device を作成します。

delete

device を削除します。

get

device に関する詳細を取得します。

list

node または customerdevices を一覧表示します。

move

device を別の node または customer の下に移動します。

patch

device を更新します。

signDevice

device に署名します。

updateSigned

署名付きの device を更新します。