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.

Enums
DEVICE_CATEGORY_UNSPECIFIED קטגוריית מכשיר לא מוגדרת.
DEVICE_CATEGORY_A קטגוריה א.
DEVICE_CATEGORY_B קטגוריה ב.

דגם המכשיר

מידע על דגם המכשיר.

ייצוג JSON 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
שדות
vendor

string

השם של ספק המכשיר.
name

string

השם של דגם המכשיר.
softwareVersion

string

גרסת התוכנה של המכשיר.
hardwareVersion

string

גרסת החומרה של המכשיר.
firmwareVersion

string

גרסת הקושחה של המכשיר.

מכשיר AirAirface

מידע על ממשק האוויר במכשיר.

ייצוג JSON 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
שדות
radioTechnology

enum (RadioTechnology)

השדה הזה מציין את טכנולוגיית הגישה לרדיו המשמשת ל-CBSD.

משפטי תנאי
supportedSpec

string

השדה הזה קשור לשדה הרדיו-טכנולוגיה ומספק את מפרט ממשק האוויר תואם ל-CBSD בזמן הרישום.

אופציונלי

טכנולוגיית רדיו

הסוגים המאושרים של טכנולוגיית גישה לרדיו.

Enums
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

גובה האנטנה במכשיר במטרים. כאשר ערך הפרמטרTypeType הוא "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 מעלות פירושו מזרח. הפרמטר הזה הוא אופציונלי למכשירים בקטגוריה א', והוא מותנה במכשירים מקטגוריה ב'.
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

אנטנה ב-3dB אנטנה עם אנטנה במטוס אופקי במעלות. הפרמטר הזה הוא מספר שלם ללא ערך, שהערך שלו הוא בין 0 ל-360 (מעלות), כולל. אופציונלי: מכשירים בקטגוריה A וכפופים למכשירים בקטגוריה B.
antennaModel

string

אם יש אנטנה חיצונית, מודל האנטנה זמין בשדה הזה. האורך של המחרוזת הוא 128 אוקטטים.

סוג הגובה

מציינת איך הגובה נמדד.

Enums
HEIGHT_TYPE_UNSPECIFIED סוג הגובה לא צוין.
HEIGHT_TYPE_AGL גובה AGL נמדד ביחס לרמת הקרקע.
HEIGHT_TYPE_AMSL גובה ה-AMSL נמדד ביחס לרמת הים הממוצעת.

יכולת מדידה

אפשרות המדידה של המכשיר. הערכים מוגדרים על ידי [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

מדינה

מצב המכשיר.

Enums
DEVICE_STATE_UNSPECIFIED מצב לא מוגדר.
RESERVED המכשיר שנוצר בפורטל SAS, עדיין לא רשום ב-SAS.
REGISTERED המכשיר רשום ב-SAS.
DEREGISTERED רישום המכשיר עם SAS בוטל.

הרשאות מכשיר

הענקת מכשיר. זוהי הרשאה שמסופקת על ידי מערכת הגישה של spectrum למכשיר כדי לשדר באמצעות פרמטרים רשומים של הפעלה לאחר פעימת לב מוצלחת של המכשיר.

ייצוג 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

התדירות הנמוכה ביותר של טווח התדירות ב-MHz.
highFrequencyMhz

number

התדירות הגבוהה ביותר של טווח התדירות ב-MHz.

גרנט סטייט

מצב המענק.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED המענק מוענק אבל המכשיר לא פעימת לב.
GRANT_STATE_TERMINATED המענק הסתיים על ידי SAS.
GRANT_STATE_SUSPENDED המענק הושעה על ידי ה-SAS.
GRANT_STATE_AUTHORIZED המכשיר משודר כרגע.
GRANT_STATE_EXPIRED פג התוקף של המענק.

סוג ערוץ

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

רשימת רשימות

רשומה ברשימת ההעברה של 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 חתום.