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