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 และคําขอลงทะเบียน SAS

currentChannels[]
(deprecated)

object (ChannelWithScore)

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

grantRangeAllowlists[]

object (FrequencyRange)

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

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

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

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

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

หมวดหมู่ 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
CW
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,
  "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

ทิศทางของระนาบแนวนอนของเสาอากาศในหน่วยองศาตามทิศเหนือจริง ค่าของพารามิเตอร์นี้เป็นจํานวนเต็มที่มีค่าระหว่าง 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 อ็อกเท็ต

cpeCbsdIndication

boolean

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

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

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

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

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

ความสามารถในการวัดอุปกรณ์ ค่านี้กําหนดโดย 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 ยังไม่ได้ลงทะเบียนกับ SAS
REGISTERED อุปกรณ์ลงทะเบียนกับ SAS แล้ว
DEREGISTERED ยกเลิกการลงทะเบียนอุปกรณ์กับ SAS แล้ว

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

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

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

suspensionReason[]

string

หากการให้สิทธิ์ถูกระงับ สาเหตุของการระงับ

grantId

string

รหัส Grant

lastHeartbeatTransmitExpireTime

string (Timestamp format)

เวลาหมดอายุของการส่งหัวใจครั้งล่าสุด

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

ช่วงความถี่ที่รายการย้ายได้รับผลกระทบ

ข้อมูลเมตาของอุปกรณ์

ข้อมูลอุปกรณ์ลบล้างได้โดยทั้งพอร์ทัล SAS และคําขอลงทะเบียน

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

string

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

commonChannelGroup

string

กลุ่มช่องทั่วไป (CCG) กลุ่ม CBSD ใน ICG เดียวกันที่ขอการกําหนดช่องหลักทั่วไป โปรดดูรายละเอียดเพิ่มเติมที่หัวข้อ CBRSA-TS-2001 V3.0.0

antennaModel

string

หากมีการเติมค่า รูปแบบเสาอากาศที่จะใช้ รูปแบบคือ RecordCreatorId:PatternId

nrqzValidated
(deprecated)

boolean

เอาต์พุตเท่านั้น ตั้งค่าเป็น true หาก CPI ที่ยืนยันว่าได้ประสานงานกับสํานักงาน National Quiet Zone แล้ว

nrqzValidation

object (NrqzValidation)

เอาต์พุตเท่านั้น ข้อมูลการตรวจสอบ National Radio Quiet Zone

การตรวจสอบความถูกต้อง Nrqz

ข้อมูลเกี่ยวกับการตรวจสอบ National Radio Quiet Zone

การแสดง 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 สถานะสุดท้าย

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

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

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