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

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

การกําหนดค่าอุปกรณ์

ข้อมูลเกี่ยวกับการกําหนดค่าอุปกรณ์

การแสดง 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"

หมวดหมู่อุปกรณ์

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

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

รุ่นอุปกรณ์

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

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

string

ชื่อผู้ให้บริการอุปกรณ์

name

string

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

softwareVersion

string

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

hardwareVersion

string

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

firmwareVersion

string

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

อินเทอร์เฟซ AirAir

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

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

enum (RadioTechnology)

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

มีเงื่อนไข

supportedSpec

string

ช่องนี้เกี่ยวข้องกับช่องRadioTechnology และระบุข้อมูลจําเพาะของอินเทอร์เฟซอากาศที่ CBSD ปฏิบัติตามเมื่อลงทะเบียน

ไม่บังคับ

เทคโนโลยีวิทยุ

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

Enum
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

พารามิเตอร์การติดตั้ง

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

การแสดง 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

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

antennaDowntilt

integer

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

antennaGain

integer

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

eirpCapability

integer

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

antennaBeamwidth

integer

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

antennaModel

string

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

ประเภทความสูง

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

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

ความสามารถในการวัด

ความสามารถในการวัดอุปกรณ์ ค่านี้กําหนดโดย [WINNF-SSC-0002] [https://winnf.memberclicks.net/asset/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 ยังไม่ได้ลงทะเบียนกับ SAS
REGISTERED อุปกรณ์ลงทะเบียนกับ SAS แล้ว
DEREGISTERED ยกเลิกการลงทะเบียนอุปกรณ์กับ SAS แล้ว

ให้สิทธิ์อุปกรณ์

การให้สิทธิ์อุปกรณ์ โดยเป็นการให้สิทธิ์จากระบบการเข้าถึงสเปกตรัมสําหรับอุปกรณ์เพื่อส่งโดยใช้พารามิเตอร์การทํางานที่ระบุหลังจากที่อุปกรณ์ฮาร์ตบีตสําเร็จ

การแสดง 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) ที่จะวัดโดยขั้นตอนที่กําหนดไว้ในส่วน FCC ส่วนที่ 96.41(e)(3)

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"

ช่วงความถี่

ช่วงความถี่จาก low_frequency ถึง high_frequency

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

number

ความถี่ต่ําสุดของช่วงความถี่ในหน่วยมิลลิวินาที

highFrequencyMhz

number

ความถี่สูงสุดของช่วงความถี่ในหน่วยเมกะเฮิร์ตซ์

GrantState

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

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

ประเภทช่อง

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

รายการ DpaMove

ข้อมูลในรายการการย้ายของ DPA&#39

การแสดง 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 ที่ลงนามแล้ว