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)
    }
  ]
}
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ị.
deviceMetadata

object (DeviceMetadata)

Các thông số thiết bị mà cả Cổng SAS và yêu cầu đăng ký SAS đều có thể ghi đè.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Chỉ có đầu ra. Các kênh hiện tại có điểm số.
grantRangeAllowlists[]

object (FrequencyRange)

Chỉ những dải địa chỉ nằm trong danh sách cho phép mới có thể được cấp mới.

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, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "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)

Có điều kiện. Trường này chỉ định công nghệ truy cập vô tuyến được 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 quy cách giao diện vô tuyến mà CBSD tuân thủ tại thời điểm đăng ký.

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
CW
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,
  "cpeCbsdIndication": boolean
}
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ị theo độ 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 liên quan đến hệ quy chiế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à. false: 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.
cpeCbsdIndication

boolean

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

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.

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 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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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ị của 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, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

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

string

Mã cấp quyền.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Thời gian hết hạn truyền của lần liên hệ cuối cùng.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z" và "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.

DeviceMetadata

Cả SAS Portal và các yêu cầu đăng ký đều có thể ghi đè dữ liệu thiết bị.

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

string

Nhóm điều phối nhiễu (ICG). Một nhóm CBSD tự quản lý nhiễu với nhóm. Để biết thêm thông tin, 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 thông tin, hãy xem CBRSA-TS-2001 V3.0.0.
antennaModel

string

Nếu được điền sẵn, đây là Mẫu mô hình ăng-ten cần sử dụng. Định dạng là: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Chỉ có đầu ra. Đặt thành true nếu một CPI đã xác nhận 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ỉ có đầu ra. Thông tin xác thực Khu vực yên tĩnh dành cho đài phát thanh quốc gia.

NrqzValidation

Thông tin về việc xác thực Khu vực hạn chế sóng vô tuyến quốc gia.

Biểu diễn dưới dạng JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
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ị được liên kết với quá trình xác thực.
longitude

number

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

string

CPI đã ký quy trình 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 xác định.
DRAFT Trạng thái bản nháp.
FINAL Trạng thái cuối cùng.

ChannelWithScore

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

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

object (FrequencyRange)

Phạm vi tần số của kênh.
score

number

Điểm số của kênh, được chuẩn hoá trong phạm vi [0,100].

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.

list

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