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

השם המוצג של המכשיר.

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', עם דיוק של ננו-שניות. דוגמה: "2014-10-02T15:01:23.045123456Z"

DeviceCategory

קטגוריית ה-FCC של המכשיר, כפי שמוגדרת בחלק 96.

טיפוסים בני מנייה (enum)
DEVICE_CATEGORY_UNSPECIFIED קטגוריית המכשיר לא צוינה.
DEVICE_CATEGORY_A קטגוריה א'.
DEVICE_CATEGORY_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
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
}
שדות
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 מעלות מציין מזרח. הפרמטר הזה הוא אופציונלי למכשירים מקטגוריה א' ומוגבל למכשירים מקטגוריה ב'.
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 (מעלות), כולל. הוא אופציונלי למכשירים מקטגוריה א' ומוגבל למכשירים מקטגוריה ב'.
antennaModel

string

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

HeightType

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

טיפוסים בני מנייה (enum)
HEIGHT_TYPE_UNSPECIFIED סוג הגובה לא צוין.
HEIGHT_TYPE_AGL גובה AGL נמדד ביחס לגובה פני הקרקע.
HEIGHT_TYPE_AMSL גובה AMSL נמדד ביחס לגובה הממוצע של פני הים.

MeasurementCapability

יכולת המדידה של המכשיר. הערכים מוגדרים במסמך [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/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 Portal, אבל עדיין לא נרשם ב-SAS.
REGISTERED המכשיר רשום ב-SAS.
DEREGISTERED המכשיר בוטל הרישום ב-SAS.

DeviceGrant

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

ייצוג ב-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) שיימדד באמצעות ההליך שמוגדר בחלק 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', עם דיוק של ננו-שניות. דוגמה: "2014-10-02T15:01:23.045123456Z"

FrequencyRange

טווח התדירות מ-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 המענק פג.

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)

טווח התדירות שרשימת ההעברה משפיעה עליו.

Methods

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 חתום.