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

يشير إلى معرّف الجهاز الصادر عن لجنة الاتصالات الفيدرالية.
serialNumber

string

رقم تسلسلي خصّصته جهة تصنيع الجهاز له.
preloadedConfig

object (DeviceConfig)

إعداد الجهاز، كما هو محدّد من خلال SAS Portal API
activeConfig

object (DeviceConfig)

النتائج فقط. الإعدادات الحالية للجهاز كما تم تسجيلها في نظام SAS
state

enum (State)

النتائج فقط. حالة الجهاز
grants[]

object (DeviceGrant)

النتائج فقط. الأذونات التي يملكها الجهاز
displayName

string

الاسم المعروض للجهاز
deviceMetadata

object (DeviceMetadata)

معلَمات الجهاز التي يمكن تجاوزها من خلال كلّ من "بوابة نظام مشاركة الطيف الترددي" وطلبات تسجيل نظام مشاركة الطيف الترددي
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

عمليات التعداد
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)

Conditional. يحدّد هذا الحقل تكنولوجيا الوصول اللاسلكي المستخدَمة في جهاز CBSD.
supportedSpec

string

اختيارية: يرتبط هذا الحقل بالنوع radioTechnology ويوفّر مواصفات واجهة البث التي يتوافق معها جهاز CBSD عند التسجيل.

RadioTechnology

أنواع تكنولوجيا الوصول اللاسلكي المعتمدة

عمليات التعداد
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: في الأماكن المغلقة ‫false: في الخارج
antennaAzimuth

integer

اتجاه محور الهوائي في المستوى الأفقي بالدرجات بالنسبة إلى الشمال الحقيقي قيمة هذه المَعلمة هي عدد صحيح يتراوح بين 0 و359 (بما في ذلك هذان الرقمان). تعني القيمة 0 درجة الشمال الحقيقي، وتعني القيمة 90 درجة الشرق. هذه المَعلمة اختيارية لأجهزة الفئة (أ) وشرطية لأجهزة الفئة (ب).
antennaDowntilt

integer

ميل الهوائي إلى الأسفل بالدرجات وهو عدد صحيح تتراوح قيمته بين -90 و+90، وتشير القيمة السالبة إلى أنّ الهوائي مائل إلى الأعلى (فوق المستوى الأفقي). هذه المَعلمة اختيارية لأجهزة الفئة (أ) وشرطية لأجهزة الفئة (ب).
antennaGain

integer

الحد الأقصى لكسب الهوائي بوحدة dBi هذه المَعلمة هي عدد صحيح تتراوح قيمته بين -127 و+128 (ديسيبل بالنسبة إلى مصدر قدرة متساوي الاتجاهات) ضِمنًا.
eirpCapability

integer

هذه المَعلمة هي الحد الأقصى لقوة الإشعاع الفعّالة المتناحية (EIRP) للجهاز بوحدات dBm/10MHz، وهي عدد صحيح تتراوح قيمته بين -127 و+47 (dBm/10 MHz) ضِمنًا. في حال عدم تضمينها، تفسّرها SAS على أنّها الحد الأقصى المسموح به للطاقة المشعّة المكافئة المتناحية (EIRP) بوحدات ديسيبل/10 ميغاهرتز لفئة الجهاز.
antennaBeamwidth

integer

عرض حزمة الهوائي عند مستوى 3 ديسيبل في المستوى الأفقي بالدرجات هذه المَعلمة هي عدد صحيح غير موقّع تتراوح قيمته بين 0 و360 (درجة) شاملةً الحدّين. وهي اختيارية لأجهزة الفئة (أ) وشرطية لأجهزة الفئة (ب).
antennaModel

string

في حال استخدام هوائي خارجي، يتم توفير طراز الهوائي اختياريًا في هذا الحقل. يبلغ الحد الأقصى لطول السلسلة 128 ثمانية بتات.
cpeCbsdIndication

boolean

تحدّد هذه المَعلمة، في حال توفّرها، ما إذا كان جهاز CBSD هو جهاز CPE-CBSD أم لا.

HeightType

تحدّد هذه السمة كيفية قياس الارتفاع.

عمليات التعداد
HEIGHT_TYPE_UNSPECIFIED نوع الارتفاع غير محدَّد.
HEIGHT_TYPE_AGL يتم قياس الارتفاع عن سطح الأرض بالنسبة إلى مستوى سطح الأرض.
HEIGHT_TYPE_AMSL يتم قياس الارتفاع عن مستوى سطح البحر بالنسبة إلى متوسط مستوى سطح البحر.

MeasurementCapability

إمكانية قياس الجهاز يتم تحديد القيم من خلال WINNF-SSC-0002.

عمليات التعداد
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

الحالة

حالة إعداد الجهاز. يمكن استخدام الإعدادات في الحالة DEVICE_CONFIG_STATE_FINAL فقط أثناء تسجيل أجهزة CBSD.

عمليات التعداد
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

الحالة

حالة الجهاز

عمليات التعداد
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) بوحدة ديسيبل ميلي واط لكل ميغاهرتز، وتمثّل قيمة maxEirp متوسط قوة الإشعاع الفعّالة المتناحية (RMS) التي يمكن قياسها باستخدام الإجراء المحدّد في الجزء 96.41(e)(3) من لوائح هيئة الاتصالات الفيدرالية.
frequencyRange

object (FrequencyRange)

نطاق تردد الإرسال
state

enum (GrantState)

حالة المنحة
channelType

enum (ChannelType)

نوع القناة المستخدَمة
moveList[]

object (DpaMoveList)

تعرِض هذه السمة قوائم نقل البيانات التي يظهر فيها هذا الإذن.
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

تمثّل هذه السمة حالة الإذن.

عمليات التعداد
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED تم منح الإذن ولكن الجهاز لا يرسل إشارات نبضات القلب.
GRANT_STATE_TERMINATED تم إنهاء المنحة من قِبل SAS.
GRANT_STATE_SUSPENDED تم تعليق المنحة من قِبل SAS.
GRANT_STATE_AUTHORIZED الجهاز يرسل البيانات حاليًا.
GRANT_STATE_EXPIRED انتهت صلاحية الإذن.

ChannelType

عمليات التعداد
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

إدخال في قائمة نقل "اتفاقية معالجة البيانات"

تمثيل JSON 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
الحقول
dpaId

string

معرّف اتفاقية معالجة البيانات.
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)

النتائج فقط. معلومات التحقّق من صحة منطقة National Radio Quiet Zone

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

مؤشر أسعار المستهلك الذي وقّع على عملية التحقّق

الحالة

حالة معلومات التحقّق من صحة NRQZ

عمليات التعداد
STATE_UNSPECIFIED حالة غير محدَّدة
DRAFT حالة المسودة
FINAL الحالة النهائية

ChannelWithScore

القناة التي تتضمّن النتيجة

تمثيل 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