REST Resource: customers.devices

리소스: Device

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 'Zulu' 형식의 타임스탬프로 정밀도는 나노초 수준입니다. 예: "2014-10-02T15:01:23.045123456Z"

DeviceCategory

파트 96에 정의된 기기의 FCC 카테고리

열거형
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

기기의 펌웨어 버전입니다.

기기 에어 인터페이스

기기의 무선 인터페이스에 관한 정보입니다.

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&quot인 경우 안테나 높이가 지면 수준과 비교하여 지정되어야 합니다. 높이 유형 매개변수 값이 "AMSL&quot인 경우 WGS84 기준점과 관련하여 지정됩니다.
heightType

enum (HeightType)

높이를 측정하는 방법을 지정합니다.

horizontalAccuracy

number

기기 안테나 가로 위치의 정확성을 나타내는 양수(미터)입니다. 이 선택적 매개변수는 값이 FCC 요구사항인 50미터 미만인 경우에만 있어야 합니다.
verticalAccuracy

number

기기 안테나 수직 위치의 정확도를 나타내는 양수(미터)입니다. 이 선택적 매개변수는 값이 3CC FCC 요구사항보다 작은 경우에만 있어야 합니다.
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/10MHz) 사이의 값을 가진 정수입니다. 포함하지 않으면 SAS는 이를 dBm/10MHz 단위 카테고리의 최대 허용 EIRP로 해석합니다.
antennaBeamwidth

integer

수평면에서 안테나의 3dB 안테나 빔폭(도) 이 매개변수는 0 이상 360도 이하의 값을 가진 부호 없는 정수입니다. 카테고리 A 기기에서는 선택사항이며 카테고리 B 기기에서는 조건부입니다.
antennaModel

string

외부 안테나를 사용하는 경우, 이 입력란에 안테나 모델이 선택적으로 제공됩니다. 문자열의 최대 길이는 8진수입니다.

높이 유형

높이를 측정하는 방법을 지정합니다.

열거형
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에서 기기가 등록 해제되었습니다.

기기 지원

기기 지원. 이는 Spectrum Access System이 기기에 제공하는 승인으로, 기기에 의한 하트비트가 성공적으로 이루어진 후 지정된 운영 매개변수를 사용하여 전송합니다.

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"

주파수 범위

게재빈도 범위는 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를 업데이트합니다.