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', עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה העשרונית. דוגמאות: "2014-10-02T15:01:23Z" ו-"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
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: indoor. 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 אוקטטים.
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

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

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

string

אם המענק מושעה, הסיבות להשעיה.
grantId

string

מזהה הרשאה.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

תאריך התפוגה של השידור של פעימת הלב האחרונה.

חותמת זמן בפורמט RFC3339 UTC ‏'Zulu', עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה העשרונית. דוגמאות: "2014-10-02T15:01:23Z" ו-"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)

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

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

קבוצת ערוצים משותפת (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].

Methods

create

 יוצר device מתחת לnode או לcustomer.

createSigned

 יוצר חתימה device מתחת ל-node או ל-customer.

list

 רשימות devices מתחת לnode או לcustomer.