REST Resource: customers.deployments.devices

리소스: Device

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 "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z""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

선택사항. 이 필드는 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&quot인 경우 안테나 높이가 지면 수준을 기준으로 제공되어야 합니다. heightType 매개변수 값이 'AMSL&quot이면 WGS84 기준점과 관련하여 지정됩니다.

heightType

enum (HeightType)

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

horizontalAccuracy

number

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

verticalAccuracy

number

기기 안테나 수직 위치의 정확도를 나타내는 양수(미터)입니다. 이 선택적 매개변수는 값이 3CC FCC 요구사항보다 작은 경우에만 있어야 합니다.

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/10MHz) 사이의 값을 가진 정수입니다. 포함하지 않으면 SAS는 이를 dBm/10MHz 단위 카테고리의 최대 허용 EIRP로 해석합니다.

antennaBeamwidth

integer

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

antennaModel

string

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

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

기기 지원

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

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 "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

suspensionReason[]

string

지원금이 정지된 경우 정지 사유입니다.

grantId

string

부여 ID

lastHeartbeatTransmitExpireTime

string (Timestamp format)

마지막 하트비트의 전송 만료 시간입니다.

RFC3339 UTC "Zulu' 형식의 타임스탬프로, 나노초 해상도와 최대 9자리 소수를 나타냅니다. 예: "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 Portal 및 등록 요청 모두에서 기기 데이터를 재정의할 수 있습니다.

JSON 표현
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
필드
interferenceCoordinationGroup

string

간섭 조정 그룹 (ICG) 해당 그룹에 대한 간섭을 관리하는 CBSD 그룹. 자세한 내용은 CBRSA-TS-2001 V3.0.0을 참고하세요.

commonChannelGroup

string

Common Channel Group (CCG) 동일한 ICG의 공통 기본 채널 할당을 요청하는 CBSD 그룹 자세한 내용은 CBRSA-TS-2001 V3.0.0을 참고하세요.

antennaModel

string

채워지면 사용할 안테나 모델 패턴입니다. 형식은 RecordCreatorId:PatternId입니다.

nrqzValidated
(deprecated)

boolean

출력 전용. CPI가 National 무음 영역 사무소와 협의했음을 확인한 경우 true로 설정합니다.

nrqzValidation

object (NrqzValidation)

출력 전용. National Radio 무음 영역 유효성 검사 정보

NrqzValidation

National Radio 무음 영역 확인에 관한 정보입니다.

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

검증에 서명한 CPI입니다.

상태

NRQZ 유효성 검사 정보의 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태.
DRAFT 초안 상태
FINAL 최종 상태입니다.

ChannelWithScore

점수가 있는 채널.

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를 나열합니다.