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
}
Trường
name

string

Chỉ có đầ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 do nhà sản xuất thiết bị chỉ định cho thiết bị.
preloadedConfig

object (DeviceConfig)

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

activeConfig

object (DeviceConfig)

Chỉ có đầ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ỉ có đầu ra. Trạng thái thiết bị.

grants[]

object (DeviceGrant)

Chỉ có đầu ra. Các quyền mà thiết bị có.
displayName

string

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

DeviceConfig

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
}
Trường
category

enum (DeviceCategory)

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

model

object (DeviceModel)

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

airInterface

object (DeviceAirInterface)

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

installationParams

object (InstallationParams)

Các 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

Mã nhận dạng của người vận hành thiết bị.
state

enum (State)

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

isSigned

boolean

Chỉ có đầu ra. Liệu cấu hình đã được CPI ký hay chưa.
updateTime

string (Timestamp format)

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

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"

DeviceCategory

Danh mục FCC của thiết bị, theo quy định tại Phần 96.

Enum
DEVICE_CATEGORY_UNSPECIFIED Danh mục thiết bị không xác định.
DEVICE_CATEGORY_A Danh mục A.
DEVICE_CATEGORY_B Danh mục B.

DeviceModel

Thông tin về kiểu máy của thiết bị.

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

string

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

string

Tên của 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 vô tuyến của thiết bị.

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

enum (RadioTechnology)

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

Câu lệnh có điều kiện
supportedSpec

string

Trường này liên quan đến trường radioTechnology và cung cấp quy cách giao diện vô tuyến mà CBSD tuân thủ tại thời điểm đăng ký.

Không bắt buộc

RadioTechnology

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

InstallationParams

Thông tin về các thông số cài đặt 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
}
Trường
latitude

number

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

number

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

number

Chiều cao anten của thiết bị tính bằng mét. Khi giá trị tham số heightType là "AGL", bạn phải cung cấp chiều cao ăng-ten so với mặt đất. Khi giá trị tham số heightType là "AMSL", giá trị này được đưa ra theo số liệu WGS84.
heightType

enum (HeightType)

Chỉ đị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 của ăng-ten thiết bị. Tham số không bắt buộc này chỉ xuất hiện nếu giá trị của tham số này nhỏ hơn yêu cầu của FCC là 50 mét.
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ị. Tham số không bắt buộc này chỉ xuất hiện nếu giá trị của tham số này nhỏ 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à. Sai: ngoài trời.
antennaAzimuth

integer

Hướng trục ngắm của mặt phẳng ngang của ăng ten theo độ so với hướng chính bắc. 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à hướng bắc thực; giá trị 90 độ có nghĩa là hướng đông. Tham số này là 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.
antennaDowntilt

integer

Độ nghiêng xuống của ăng-ten tính bằng độ và là một số nguyên có giá trị từ -90 đến +90 (bao gồm cả 2 giá trị đó); giá trị âm có nghĩa là ăng-ten nghiêng lên (trên phương ngang). Tham số này là 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.
antennaGain

integer

Độ lợi đỉnh của ăng-ten tính bằng dBi. Tham số này là một số nguyên có giá trị từ -127 đến +128 (dBi).
eirpCapability

integer

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

integer

Độ rộng chùm ăng ten 3 dB của ăng ten trong mặt phẳng ngang tính bằng độ. Tham số này là một số nguyên không dấu có giá trị từ 0 đến 360 (độ); đây là tham số không bắt buộc đối với thiết bị Loại A và có điều kiện đối với thiết bị Loại B.
antennaModel

string

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

HeightType

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

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

MeasurementCapability

Khả năng đo lường trên thiết bị. Các giá trị được xác định theo [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 xác định.
RESERVED Thiết bị được tạo trong SAS Portal nhưng chưa được đăng ký với SAS.
REGISTERED Thiết bị đã được đăng ký với SAS.
DEREGISTERED Thiết bị đã huỷ đăng ký với SAS.

DeviceGrant

Cấp quyền cho thiết bị. Đây là một cơ chế uỷ quyền do Hệ thống truy cập phổ tần cung cấp cho một thiết bị để truyền dữ liệu bằng các thông số hoạt động được chỉ định sau khi thiết bị gửi tín hiệu nhịp tim thành công.

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
}
Trường
maxEirp

number

Công suất bức xạ đẳng hướng tương đương (EIRP) tối đa được phép theo giấy phép. EIRP tối đa có đơn vị là dBm/MHz. Giá trị maxEirp biểu thị 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)

Phạm vi tần số truyền.

state

enum (GrantState)

Trạng thái của việc cấp quyền.

channelType

enum (ChannelType)

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

moveList[]

object (DpaMoveList)

Danh sách di chuyển của DPA mà khoản trợ cấp này xuất hiện.

expireTime

string (Timestamp format)

Thời gian hết hạn của quyền truy cập.

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"

FrequencyRange

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

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

number

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

number

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

GrantState

Trạng thái của việc cấp quyền.

Enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED Quyền truy cập đã được cấp nhưng thiết bị không gửi tín hiệu nhịp tim trên quyền truy cập đó.
GRANT_STATE_TERMINATED SAS đã chấm dứt việc cấp quyền.
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 dữ liệu.
GRANT_STATE_EXPIRED Khoản trợ cấp đã hết hạn.

ChannelType

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

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)
  }
}
Trường
dpaId

string

Mã nhận dạng của quảng cáo dựa trên kho hàng tại địa phương.
frequencyRange

object (FrequencyRange)

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

Phương thức

create

 Tạo một device trong node hoặc customer.

createSigned

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

delete

 Xoá một device.

get

 Lấy thông tin chi tiết về một device.

list

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

move

 Di chuyển một device xuống dưới một node hoặc customer khác.

patch

 Cập nhật một device.

signDevice

 Ký một device.

updateSigned

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