REST Resource: customers.deployments.devices

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

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

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

object (DeviceMetadata)

พารามิเตอร์ของอุปกรณ์ที่ทั้ง SAS Portal และคำขอลงทะเบียน SAS สามารถลบล้างได้
currentChannels[]
(deprecated)

object (ChannelWithScore)

เอาต์พุตเท่านั้น ช่องปัจจุบันที่มีคะแนน
grantRangeAllowlists[]

object (FrequencyRange)

เฉพาะช่วงที่อยู่ในรายการที่อนุญาตเท่านั้นที่จะพร้อมใช้งานสำหรับการให้สิทธิ์ใหม่

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" ที่มีความละเอียดเป็นหน่วยนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "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
CW
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,
  "cpeCbsdIndication": boolean
}
ช่อง
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

เสาอากาศของอุปกรณ์อยู่ภายในอาคารหรือไม่ true: ในร่ม false: กลางแจ้ง
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 ตัว
cpeCbsdIndication

boolean

หากมี พารามิเตอร์นี้จะระบุว่า CBSD เป็น CPE-CBSD หรือไม่

HeightType

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

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

MeasurementCapability

ความสามารถในการวัดผลของอุปกรณ์ ค่าเหล่านี้กำหนดโดย WINNF-SSC-0002

Enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

รัฐ

สถานะของการกำหนดค่าอุปกรณ์ ใช้ได้เฉพาะการกำหนดค่าในสถานะ DEVICE_CONFIG_STATE_FINAL ในระหว่างการลงทะเบียน CBSD

Enum
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

รัฐ

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

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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" ที่มีความละเอียดเป็นหน่วยนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
suspensionReason[]

string

หากมีการระงับเงินช่วยเหลือ เหตุผลของการระงับ
grantId

string

รหัสการให้สิทธิ์
lastHeartbeatTransmitExpireTime

string (Timestamp format)

เวลาหมดอายุของการส่งฮาร์ตบีตครั้งล่าสุด

การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดเป็นหน่วยนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่างเช่น "2014-10-02T15:01:23Z" และ "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)

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

DeviceMetadata

ข้อมูลอุปกรณ์ที่ทั้ง SAS Portal และคำขอลงทะเบียนสามารถลบล้างได้

การแสดง JSON 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
ช่อง
interferenceCoordinationGroup

string

กลุ่มประสานงานการรบกวน (ICG) กลุ่ม CBSD ที่จัดการการรบกวนของตนเองกับกลุ่ม ดูรายละเอียดเพิ่มเติมได้ที่ CBRSA-TS-2001 V3.0.0
commonChannelGroup

string

Common Channel Group (CCG) กลุ่ม CBSD ใน ICG เดียวกันที่ขอการมอบหมายแชแนลหลักร่วมกัน ดูรายละเอียดเพิ่มเติมได้ที่ CBRSA-TS-2001 V3.0.0
antennaModel

string

หากระบุไว้ รูปแบบโมเดลเสาอากาศที่จะใช้ รูปแบบคือ RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

เอาต์พุตเท่านั้น ตั้งค่าเป็น true หาก CPI ได้ตรวจสอบแล้วว่าได้ประสานงานกับสำนักงานเขตเงียบแห่งชาติ
nrqzValidation

object (NrqzValidation)

เอาต์พุตเท่านั้น ข้อมูลการตรวจสอบเขตเงียบวิทยุแห่งชาติ

NrqzValidation

ข้อมูลเกี่ยวกับการตรวจสอบความถูกต้องของเขตห้ามใช้คลื่นวิทยุแห่งชาติ

การแสดง JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
ช่อง
state

enum (State)

สถานะของข้อมูลการตรวจสอบ NRQZ
caseId

string

รหัสเคสการตรวจสอบความถูกต้อง
latitude

number

ละติจูดของอุปกรณ์ที่เชื่อมโยงกับการตรวจสอบ
longitude

number

ลองจิจูดของอุปกรณ์ที่เชื่อมโยงกับการตรวจสอบ
cpiId

string

CPI ที่ลงนามในการตรวจสอบ

รัฐ

สถานะของข้อมูลการตรวจสอบ NRQZ

Enum
STATE_UNSPECIFIED สถานะที่ไม่ได้ระบุ
DRAFT สถานะฉบับร่าง
FINAL สถานะสุดท้าย

ChannelWithScore

ช่องที่มีคะแนน

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

object (FrequencyRange)

ช่วงความถี่ของช่อง
score

number

คะแนนช่องที่ปรับให้อยู่ในช่วง [0,100]

เมธอด

create

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

createSigned

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

list

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