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

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

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

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

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

boolean

אם הפרמטר קיים, ה-CBSD הוא CPE-CBSD או לא.

סוג הגובה

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

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

יכולת מדידה

אפשרות המדידה של המכשיר. הערכים מוגדרים על ידי WINNF-SSC-0002.

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

מדינה

המצב של תצורת המכשיר. ניתן להשתמש רק בהגדרות במצב DEVICE_CONFIG_STATE_FINAL במהלך רישום CBSD.

Enums
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

מדינה

מצב המכשיר.

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,
  "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" עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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".

טווח תדרים

טווח התדירות הוא 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)

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

מטא נתונים של מכשיר

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

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

פלט בלבד. פרטי אימות של אזור רדיו מקומי.

אימות Nrqz

מידע על אימות של אזור הרדיו הלאומי באזור שקט.

ייצוג JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
שדות
state

enum (State)

מצב פרטי האימות של NRQZ.
caseId

string

מספר הפנייה לאימות.
latitude

number

קו הרוחב של המכשיר המשויך לאימות.
longitude

number

קו האורך של המכשיר שמשויך לאימות.
cpiId

string

עלות להתקנה שחתמה על האימות.

מדינה

מצב פרטי האימות של NRQZ.

Enums
STATE_UNSPECIFIED מצב לא מוגדר.
DRAFT מצב טיוטה.
FINAL מצב סופי.

ערוץWithScore

הערוץ עם דירוג.

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