REST Resource: customers.devices

แหล่งข้อมูล: อุปกรณ์

การแสดง JSON 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
ช่อง
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

ชื่อที่แสดงของอุปกรณ์

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" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "2014-10-02T15:01:23.045123456Z"

DeviceCategory

หมวดหมู่ FCC ของอุปกรณ์ตามที่กำหนดไว้ในส่วนที่ 96

Enum
DEVICE_CATEGORY_UNSPECIFIED หมวดหมู่อุปกรณ์ที่ไม่ได้ระบุ
DEVICE_CATEGORY_A หมวดหมู่ ก.
DEVICE_CATEGORY_B หมวดหมู่ B

DeviceModel

ข้อมูลเกี่ยวกับรุ่นของอุปกรณ์

การแสดง JSON 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
ช่อง
vendor

string

ชื่อของผู้จำหน่ายอุปกรณ์
name

string

ชื่อรุ่นของอุปกรณ์
softwareVersion

string

เวอร์ชันซอฟต์แวร์ของอุปกรณ์
hardwareVersion

string

เวอร์ชันฮาร์ดแวร์ของอุปกรณ์
firmwareVersion

string

เวอร์ชันเฟิร์มแวร์ของอุปกรณ์

DeviceAirInterface

ข้อมูลเกี่ยวกับอินเทอร์เฟซทางอากาศของอุปกรณ์

การแสดง JSON 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
ช่อง
radioTechnology

enum (RadioTechnology)

ฟิลด์นี้ระบุเทคโนโลยีการเข้าถึงวิทยุที่ใช้สำหรับ CBSD

มีเงื่อนไข
supportedSpec

string

ฟิลด์นี้เกี่ยวข้องกับฟิลด์ radioTechnology และระบุข้อกำหนดของอินเทอร์เฟซทางอากาศที่ CBSD ปฏิบัติตามในขณะที่ลงทะเบียน

ไม่บังคับ

RadioTechnology

เทคโนโลยีการเข้าถึงวิทยุประเภทที่ได้รับอนุมัติ

Enum
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

InstallationParams

ข้อมูลเกี่ยวกับพารามิเตอร์การติดตั้งอุปกรณ์

การแสดง 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
}
ช่อง
latitude

number

ละติจูดของตำแหน่งเสาอากาศของอุปกรณ์เป็นองศาเทียบกับข้อมูลอ้างอิง WGS 84 ช่วงที่อนุญาตคือ -90.000000 ถึง +90.000000 ค่าบวกแสดงถึงละติจูดทางเหนือของเส้นศูนย์สูตร ส่วนค่าลบแสดงถึงละติจูดทางใต้ของเส้นศูนย์สูตร
longitude

number

ลองจิจูดของตำแหน่งเสาอากาศของอุปกรณ์เป็นองศาเทียบกับข้อมูลอ้างอิง WGS 84 ช่วงที่อนุญาตคือ -180.000000 ถึง +180.000000 ค่าบวกแสดงถึงลองจิจูดทางตะวันออกของเส้นเมริเดียนแรก ส่วนค่าลบแสดงถึงลองจิจูดทางตะวันตกของเส้นเมริเดียนแรก
height

number

ความสูงของเสาอากาศอุปกรณ์ในหน่วยเมตร เมื่อค่าพารามิเตอร์ heightType เป็น "AGL" คุณควรระบุความสูงของเสาอากาศเทียบกับระดับพื้นดิน เมื่อค่าพารามิเตอร์ heightType เป็น "AMSL" ค่านี้จะอ้างอิงถึงข้อมูล WGS84
heightType

enum (HeightType)

ระบุวิธีวัดความสูง

horizontalAccuracy

number

ตัวเลขบวกในหน่วยเมตรเพื่อระบุความแม่นยำของตำแหน่งแนวนอนของเสาอากาศของอุปกรณ์ พารามิเตอร์ที่ไม่บังคับนี้ควรมีอยู่เฉพาะในกรณีที่ค่าของพารามิเตอร์น้อยกว่าข้อกำหนดของ FCC ที่ 50 เมตร
verticalAccuracy

number

ตัวเลขบวกในหน่วยเมตรเพื่อระบุความแม่นยำของตำแหน่งแนวตั้งของเสาอากาศของอุปกรณ์ พารามิเตอร์ที่ไม่บังคับนี้ควรมีอยู่เฉพาะในกรณีที่ค่าของพารามิเตอร์น้อยกว่าข้อกำหนดของ FCC ที่ 3 เมตร
indoorDeployment

boolean

เสาอากาศของอุปกรณ์อยู่ภายในอาคารหรือไม่ จริง: ในร่ม เท็จ: กลางแจ้ง
antennaAzimuth

integer

ทิศทาง Boresight ของระนาบแนวนอนของเสาอากาศเป็นองศาเมื่อเทียบกับทิศเหนือจริง ค่าของพารามิเตอร์นี้เป็นจำนวนเต็มที่มีค่าระหว่าง 0 ถึง 359 ค่า 0 องศาหมายถึงทิศเหนือจริง ส่วนค่า 90 องศาหมายถึงทิศตะวันออก พารามิเตอร์นี้จะใส่หรือไม่ใส่ก็ได้สำหรับอุปกรณ์หมวดหมู่ ก. และต้องใส่สำหรับอุปกรณ์หมวดหมู่ ข.
antennaDowntilt

integer

การก้มเสาอากาศเป็นองศาและเป็นจำนวนเต็มที่มีค่าระหว่าง -90 ถึง +90 รวมอยู่ด้วย ค่าลบหมายความว่าเสาอากาศเอียงขึ้น (เหนือแนวนอน) พารามิเตอร์นี้จะใส่หรือไม่ใส่ก็ได้สำหรับอุปกรณ์หมวดหมู่ ก. และต้องใส่สำหรับอุปกรณ์หมวดหมู่ ข.
antennaGain

integer

อัตราขยายสูงสุดของเสาอากาศในหน่วย dBi พารามิเตอร์นี้เป็นจำนวนเต็มที่มีค่าระหว่าง -127 ถึง +128 (dBi)
eirpCapability

integer

พารามิเตอร์นี้คือ EIRP สูงสุดของอุปกรณ์ในหน่วย dBm/10MHz และเป็นจำนวนเต็มที่มีค่าระหว่าง -127 ถึง +47 (dBm/10 MHz) หากไม่ได้ระบุ SAS จะตีความว่าเป็น EIRP สูงสุดที่อนุญาตในหน่วย dBm/10MHz สำหรับหมวดหมู่อุปกรณ์
antennaBeamwidth

integer

ความกว้างของลำแสงเสาอากาศ 3 dB ของเสาอากาศในระนาบแนวนอน หน่วยเป็นองศา พารามิเตอร์นี้เป็นจำนวนเต็มที่ไม่มีเครื่องหมายซึ่งมีค่าระหว่าง 0 ถึง 360 (องศา) รวมอยู่ด้วย โดยเป็นพารามิเตอร์ที่ไม่บังคับสำหรับอุปกรณ์หมวดหมู่ ก. และเป็นพารามิเตอร์แบบมีเงื่อนไขสำหรับอุปกรณ์หมวดหมู่ ข.
antennaModel

string

หากใช้เสาอากาศภายนอก คุณจะระบุรุ่นเสาอากาศในช่องนี้หรือไม่ก็ได้ สตริงมีความยาวของอักขระได้สูงสุด 128 ตัว

HeightType

ระบุวิธีวัดความสูง

Enum
HEIGHT_TYPE_UNSPECIFIED ประเภทความสูงที่ไม่ได้ระบุ
HEIGHT_TYPE_AGL ความสูง AGL จะวัดเทียบกับระดับพื้นดิน
HEIGHT_TYPE_AMSL ความสูง AMSL จะวัดเทียบกับระดับน้ำทะเลเฉลี่ย

MeasurementCapability

ความสามารถในการวัดผลของอุปกรณ์ ค่าเหล่านี้กำหนดโดย [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

รัฐ

สถานะของอุปกรณ์

Enum
DEVICE_STATE_UNSPECIFIED สถานะที่ไม่ได้ระบุ
RESERVED อุปกรณ์ที่สร้างใน SAS Portal แต่ยังไม่ได้ลงทะเบียนกับ SAS
REGISTERED อุปกรณ์ลงทะเบียนกับ SAS แล้ว
DEREGISTERED ยกเลิกการลงทะเบียนอุปกรณ์กับ SAS แล้ว

DeviceGrant

การให้สิทธิ์เข้าถึงอุปกรณ์ โดยเป็นสิทธิ์ที่ระบบการเข้าถึงคลื่นความถี่ (Spectrum Access System) มอบให้แก่อุปกรณ์เพื่อส่งสัญญาณโดยใช้พารามิเตอร์การทำงานที่ระบุหลังจากที่อุปกรณ์ส่งสัญญาณ Heartbeat สำเร็จ

การแสดง JSON 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
ช่อง
maxEirp

number

กำลังส่งออกอากาศสมมูลแบบไอโซทรอปิก (EIRP) สูงสุดที่ได้รับอนุญาตจากใบอนุญาต EIRP สูงสุดอยู่ในหน่วย dBm/MHz ค่าของ maxEirp แสดงถึง EIRP เฉลี่ย (RMS) ที่จะวัดได้ตามขั้นตอนที่กำหนดไว้ในส่วน 96.41(e)(3) ของ FCC
frequencyRange

object (FrequencyRange)

ช่วงความถี่ในการส่ง

state

enum (GrantState)

สถานะของการให้สิทธิ์

channelType

enum (ChannelType)

ประเภทของช่องที่ใช้

moveList[]

object (DpaMoveList)

รายการ DPA ที่มีการย้ายซึ่งมีการให้สิทธิ์นี้

expireTime

string (Timestamp format)

เวลาหมดอายุของการให้สิทธิ์

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่แม่นยำเป็นหน่วยนาโนวินาที ตัวอย่าง: "2014-10-02T15:01:23.045123456Z"

FrequencyRange

ช่วงความถี่ตั้งแต่ low_frequency ถึง high_frequency

การแสดง JSON 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
ช่อง
lowFrequencyMhz

number

ความถี่ต่ำสุดของช่วงความถี่ในหน่วย MHz
highFrequencyMhz

number

ความถี่สูงสุดของช่วงความถี่ในหน่วย MHz

GrantState

สถานะของการให้สิทธิ์

Enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED ได้รับสิทธิ์แล้ว แต่อุปกรณ์ไม่ได้ส่งสัญญาณชีพจรในสิทธิ์นั้น
GRANT_STATE_TERMINATED SAS ได้สิ้นสุดการให้สิทธิ์แล้ว
GRANT_STATE_SUSPENDED SAS ได้ระงับการให้เงินช่วยเหลือ
GRANT_STATE_AUTHORIZED ขณะนี้อุปกรณ์กำลังส่งข้อมูล
GRANT_STATE_EXPIRED สิทธิ์หมดอายุแล้ว

ChannelType

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

รายการในรายการย้ายของ DPA

การแสดง JSON 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
ช่อง
dpaId

string

รหัสของ DPA
frequencyRange

object (FrequencyRange)

ช่วงความถี่ที่รายการย้ายมีผล

เมธอด

create

 สร้าง device ภายใต้ node หรือ customer

createSigned

 สร้าง device ที่ลงนามแล้วภายใต้ node หรือ customer

delete

 ลบ device

get

 ดูรายละเอียดเกี่ยวกับ device

list

 รายการ devices ภายใต้ node หรือ customer

move

 ย้าย device ไปไว้ใต้ node หรือ customer อื่น

patch

 อัปเดต device

signDevice

 ลงนามใน device

updateSigned

 อัปเดต device ที่ลงนามแล้ว