REST Resource: customers.deployments.devices

Tài nguyên: Thiết bị

Biểu diễn dưới dạng 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)
    }
  ]
}
Các trường
name

string

Chỉ đầu ra. Tên đường dẫn tài nguyên.

fccId

string

Mã nhận dạng FCC của thiết bị.

serialNumber

string

Số sê-ri được nhà sản xuất thiết bị gán cho thiết bị.

preloadedConfig

object (DeviceConfig)

Cấu hình của thiết bị, theo chỉ định thông qua API SAS Portal.

activeConfig

object (DeviceConfig)

Chỉ đầu ra. Cấu hình hiện tại của thiết bị khi được đăng ký với SAS.

state

enum (State)

Chỉ đầu ra. Trạng thái thiết bị.

grants[]

object (DeviceGrant)

Chỉ đầu ra. Số tiền mà thiết bị giữ lại.

displayName

string

Tên hiển thị của thiết bị.

deviceMetadata

object (DeviceMetadata)

Các thông số thiết bị mà cả Yêu cầu đăng ký SAS và yêu cầu đăng ký SAS có thể ghi đè.

currentChannels[]
(deprecated)

object (ChannelWithScore)

Chỉ đầu ra. Những kênh hiện tại có tỷ số.

grantRangeAllowlists[]

object (FrequencyRange)

Chỉ những phạm vi thuộc danh sách cho phép mới có thể cấp cho các khoản tài trợ mới.

Cấu hình thiết bị

Thông tin về cấu hình thiết bị.

Biểu diễn dưới dạng 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
}
Các trường
category

enum (DeviceCategory)

Danh mục FCC của thiết bị.

model

object (DeviceModel)

Thông tin về mẫu thiết bị này.

airInterface

object (DeviceAirInterface)

Thông tin về giao diện không khí của thiết bị này.

installationParams

object (InstallationParams)

Thông số cài đặt cho thiết bị.

measurementCapabilities[]

enum (MeasurementCapability)

Khả năng báo cáo đo lường của thiết bị.

userId

string

Giá trị nhận dạng của người dùng thiết bị.

callSign

string

Dấu hiệu gọi của toán tử thiết bị.

state

enum (State)

Trạng thái cấu hình.

isSigned

boolean

Chỉ đầu ra. Liệu cấu hình có được ký bằng CPI hay không.

updateTime

string (Timestamp format)

Chỉ đầu ra. Lần chỉnh sửa cấu hình thiết bị gần đây nhất.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

Danh mục thiết bị

Danh mục FCC của thiết bị, theo định nghĩa trong Phần 96.

Enum
DEVICE_CATEGORY_UNSPECIFIED Danh mục thiết bị chưa được chỉ định.
DEVICE_CATEGORY_A Danh mục A.
DEVICE_CATEGORY_B Loại B.

Mẫu thiết bị

Thông tin về kiểu thiết bị.

Biểu diễn dưới dạng JSON
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Các trường
vendor

string

Tên nhà cung cấp thiết bị.

name

string

Tên mẫu thiết bị.

softwareVersion

string

Phiên bản phần mềm của thiết bị.

hardwareVersion

string

Phiên bản phần cứng của thiết bị.

firmwareVersion

string

Phiên bản chương trình cơ sở của thiết bị.

DeviceAirInterface

Thông tin về giao diện không khí của thiết bị.

Biểu diễn dưới dạng JSON
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Các trường
radioTechnology

enum (RadioTechnology)

Điều kiện. Trường này chỉ định công nghệ truy cập sóng vô tuyến dùng cho CBSD.

supportedSpec

string

Không bắt buộc. Trường này liên quan đến radioTechnology và cung cấp thông số kỹ thuật của giao diện hàng không mà CBSD tuân thủ tại thời điểm đăng ký.

Công nghệ bức xạ

Các loại công nghệ truy cập vô tuyến được phê duyệt.

Enum
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
CW
REDLINE
TARANA_WIRELESS

Thông số cài đặt

Thông tin về các thông số cài đặt trên thiết bị.

Biểu diễn dưới dạng 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
}
Các trường
latitude

number

Vĩ độ của vị trí ăng-ten thiết bị theo độ so với dữ liệu WGS 84. Phạm vi được phép là từ -90.000000 đến +90.000000. Giá trị dương biểu thị cho các vĩ độ ở phía bắc của đường xích đạo; các giá trị âm ở phía Nam đường xích đạo.

longitude

number

Kinh độ của vị trí ăng-ten thiết bị theo độ so với dữ liệu WGS 84. Phạm vi được phép là từ -180.000000 đến +180.000000. Giá trị dương biểu thị kinh độ phía đông của kinh tuyến gốc; giá trị âm ở phía tây của kinh tuyến gốc.

height

number

Chiều cao ăng ten thiết bị tính theo mét. Khi giá trị thông số heightType là "AGL", chiều cao của ăng ten phải được cung cấp tương ứng với mặt đất. Khi giá trị tham số heightType là "AMSL", thì giá trị đó được cung cấp tương ứng với dữ liệu WGS84.

heightType

enum (HeightType)

Xác định cách đo chiều cao.

horizontalAccuracy

number

Một số dương tính bằng mét để cho biết độ chính xác của vị trí ngang trên ăng-ten của thiết bị. Bạn chỉ được hiển thị thông số không bắt buộc này nếu giá trị của thông số này thấp hơn yêu cầu về 50 mét của FCC.

verticalAccuracy

number

Một số dương tính bằng mét để cho biết độ chính xác của vị trí dọc của ăng-ten thiết bị. Thông số tùy chọn này chỉ nên hiển thị nếu giá trị của thông số này thấp hơn yêu cầu của FCC là 3 mét.

indoorDeployment

boolean

Ăng-ten của thiết bị có ở trong nhà hay không. true: trong nhà. false: ngoài trời.

antennaAzimuth

integer

Hướng nhìn ra mặt phẳng của ăng-ten ngang theo độ theo hướng Bắc thực tế. Giá trị của tham số này là một số nguyên có giá trị từ 0 đến 359. Giá trị 0 độ có nghĩa là đúng về phía Bắc; giá trị 90 độ có nghĩa là phía đông. Bạn không bắt buộc phải sử dụng thông số này cho thiết bị Danh mục A và điều kiện cho các thiết bị Danh mục B.

antennaDowntilt

integer

Ăng-ten quay sang độ theo độ và là một số nguyên có giá trị từ -90 đến +90; giá trị âm có nghĩa là ăng-ten bị nghiêng (lên trên chiều ngang). Bạn không bắt buộc phải sử dụng thông số này cho thiết bị Danh mục A và điều kiện cho các thiết bị Danh mục B.

antennaGain

integer

Mức tăng của ăng-ten đỉnh cao tính bằng dBi. Thông số này là một số nguyên có giá trị từ -127 đến +128 (dBi).

eirpCapability

integer

Thông số này là EIRP thiết bị tối đa theo đơn vị dBm/10MHz và là một số nguyên có giá trị từ -127 đến +47 (dBm/10 MHz). Nếu không được đưa vào, SAS sẽ hiểu là EIRP tối đa được phép theo đơn vị dBm/10MHz cho danh mục thiết bị.

antennaBeamwidth

integer

Chiều rộng ăng-ten 3 dB của ăng-ten theo mặt phẳng ngang theo độ. Tham số này là một số nguyên không dấu có giá trị từ 0 đến 360 (độ). Thông số này không bắt buộc đối với thiết bị Danh mục A và có điều kiện đối với thiết bị Danh mục B.

antennaModel

string

Nếu bạn sử dụng ăng-ten bên ngoài, thì tùy chọn trường ăng-ten này được cung cấp trong trường này. Chuỗi này có độ dài tối đa là 128 octet.

cpeCbsdIndication

boolean

Nếu có, thông số này sẽ chỉ định CBSD có phải là CPE-CBSD hay không.

Loại chiều cao

Xác định cách đo chiều cao.

Enum
HEIGHT_TYPE_UNSPECIFIED Loại chiều cao chưa chỉ định.
HEIGHT_TYPE_AGL Chiều cao AGL được đo so với mặt đất.
HEIGHT_TYPE_AMSL Chiều cao của AMSL được đo lường so với mực nước biển trung bình.

Khả năng đo lường

Khả năng đo lường thiết bị. Các giá trị được xác định bởi WINNF-SSC-0002.

Enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

Tiểu bang

Trạng thái của cấu hình thiết bị. Bạn chỉ có thể sử dụng các cấu hình ở trạng thái DEVICE_CONFIG_STATE_FINAL trong quá trình Đăng ký CBSD.

Enum
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

Tiểu bang

Trạng thái của thiết bị.

Enum
DEVICE_STATE_UNSPECIFIED Trạng thái chưa chỉ định.
RESERVED Tuy nhiên, thiết bị được tạo trong Cổng SAS nhưng chưa đăng ký với SAS.
REGISTERED Thiết bị đã đăng ký với SAS.
DEREGISTERED Đã hủy đăng ký thiết bị bằng SAS.

DeviceGrant

Cấp quyền cho thiết bị. Đây là sự uỷ quyền do Hệ thống truy cập phổ tần cấp cho thiết bị truyền bằng cách sử dụng các tham số hoạt động được chỉ định sau khi thiết bị đã nhận được nhịp tim.

Biểu diễn dưới dạng JSON
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": string
}
Các trường
maxEirp

number

Công suất bức xạ tương đương tối đa (EIRP) tương đương được phép theo phạm vi cấp. EIRP tối đa tính bằng đơn vị dBm/MHz. Giá trị của maxEirp thể hiện EIRP trung bình (RMS) sẽ được đo bằng quy trình được xác định trong phần 96.41(e)(3) của FCC.

frequencyRange

object (FrequencyRange)

Dải tần số truyền.

state

enum (GrantState)

Trạng thái của khoản tài trợ.

channelType

enum (ChannelType)

Loại kênh được sử dụng.

moveList[]

object (DpaMoveList)

Di chuyển DPA sẽ liệt kê danh sách cấp này.

expireTime

string (Timestamp format)

Thời gian hết hạn của khoản tài trợ.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

suspensionReason[]

string

Nếu tài khoản bị tạm ngưng, (các) lý do khiến tài khoản bị tạm ngưng.

grantId

string

Mã tài trợ.

lastHeartbeatTransmitExpireTime

string (Timestamp format)

Thời gian hết hạn truyền của nhịp tim cuối cùng.

Dấu thời gian ở định dạng RFC3339 UTC "Zulu" với độ phân giải nano giây và tối đa chín chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

Tần số

Dải tần số từ low_frequency đến high_frequency.

Biểu diễn dưới dạng JSON
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Các trường
lowFrequencyMhz

number

Tần suất thấp nhất của dải tần tính bằng MHz.

highFrequencyMhz

number

Tần suất cao nhất của dải tần tính bằng MHz.

Trạng thái Grant

Trạng thái của khoản tài trợ.

Enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Đã cấp quyền nhưng thiết bị không tạo nhịp.
GRANT_STATE_TERMINATED SAS đã chấm dứt khoản tài trợ này.
GRANT_STATE_SUSPENDED SAS đã tạm ngưng khoản tài trợ này.
GRANT_STATE_AUTHORIZED Thiết bị hiện đang truyền.
GRANT_STATE_EXPIRED Ưu đãi này đã hết hạn.

Loại kênh

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

Danh sách DpaMove

Một mục trong danh sách di chuyển của DPA.

Biểu diễn dưới dạng JSON
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Các trường
dpaId

string

Mã của Cơ quan bảo vệ dữ liệu.

frequencyRange

object (FrequencyRange)

Dải tần suất mà danh sách di chuyển ảnh hưởng.

Siêu dữ liệu của thiết bị

Dữ liệu thiết bị có thể ghi đè bằng cả Cổng thông tin SAS và yêu cầu đăng ký.

Biểu diễn dưới dạng JSON
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Các trường
interferenceCoordinationGroup

string

Nhóm điều phối can thiệp (ICG). Một nhóm CBSD quản lý sự can thiệp của chính họ với nhóm. Để biết thêm chi tiết, hãy xem CBRSA-TS-2001 V3.0.0.

commonChannelGroup

string

Nhóm kênh chung (CCG). Một nhóm CBSD trong cùng một ICG yêu cầu chỉ định kênh chính chung. Để biết thêm chi tiết, hãy xem CBRSA-TS-2001 V3.0.0.

antennaModel

string

Nếu được điền, mẫu Mô hình ăng-ten sẽ sử dụng. Định dạng là: RecordCreatorId:PatternId

nrqzValidated
(deprecated)

boolean

Chỉ đầu ra. Đặt thành true nếu CPI đã xác thực rằng họ đã phối hợp với văn phòng Khu vực yên tĩnh quốc gia.

nrqzValidation

object (NrqzValidation)

Chỉ đầu ra. Thông tin xác thực Khu vực yên tĩnh của đài phát thanh quốc gia.

Xác thực Nrqz

Thông tin về xác thực Khu vực yên tĩnh của đài phát thanh quốc gia.

Biểu diễn dưới dạng JSON
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Các trường
state

enum (State)

Trạng thái của thông tin xác thực NRQZ.

caseId

string

Mã yêu cầu xác thực.

latitude

number

Vĩ độ của thiết bị liên kết với quy trình xác thực.

longitude

number

Kinh độ của thiết bị được liên kết với quy trình xác thực.

cpiId

string

CPI đã xác thực.

Tiểu bang

Trạng thái của thông tin xác thực NRQZ.

Enum
STATE_UNSPECIFIED Trạng thái chưa chỉ định.
DRAFT Trạng thái bản nháp.
FINAL Trạng thái cuối cùng.

Kênh có điểm số

Kênh có điểm số.

Biểu diễn dưới dạng JSON
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Các trường
frequencyRange

object (FrequencyRange)

Dải tần số của kênh.

score

number

Điểm số của kênh được chuẩn hóa để nằm trong khoảng [0,100].

Phương pháp

create

Tạo device trong node hoặc customer.

createSigned

Tạo một device đã ký trong node hoặc customer.

list

Liệt kê devices trong node hoặc customer.