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

يشير إلى معرّف الجهاز الصادر عن لجنة الاتصالات الفيدرالية.
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

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

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

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

تحديد ما إذا كانت هوائي الجهاز في مكان مغلق أم لا صحيح: في الأماكن المغلقة. خطأ: في الخارج
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 ثمانية بتات.

HeightType

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

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

MeasurementCapability

إمكانية قياس الجهاز يتم تحديد القيم من خلال [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf].

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

الحالة

حالة الجهاز

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

object (FrequencyRange)

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

state

enum (GrantState)

حالة المنحة

channelType

enum (ChannelType)

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

moveList[]

object (DpaMoveList)

تعرِض هذه السمة قوائم نقل البيانات التي يظهر فيها هذا الإذن.

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

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

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

نطاق التردد الذي تؤثر فيه قائمة النقل

الطُرق

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 موقَّعًا.