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 '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

이 필드는 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: 실내 거짓: 실외
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/10MHz) 사이의 정수입니다. 포함되지 않은 경우 SAS는 기기 카테고리에 허용되는 최대 EIRP를 dBm/10MHz 단위로 해석합니다.
antennaBeamwidth

integer

안테나의 3dB 안테나 빔폭(수평면, 도)입니다. 이 매개변수는 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 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "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를 업데이트합니다.