REST Resource: customers.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
}
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ị.

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 "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: "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)

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

Điều kiện
supportedSpec

string

Trường này liên quan đến trường RadioTech 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ý.

Không bắt buộc

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
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
}
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ị thông số heightType là "AMSL", 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. Đúng: trong nhà. Sai: 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.

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] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

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 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
}
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 FCC 96.41(e)(3).
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 "Zulu" RFC3339 UTC, chính xác đến nano giây. Ví dụ: "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.

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.

delete

 Xoá device.

get

 Nhận thông tin chi tiết về device.

list

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

move

 Di chuyển device dưới node hoặc customer khác.

patch

 Cập nhật device.

signDevice

 Ký device.

updateSigned

 Cập nhật device đã ký.