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.

activeConfig

object (DeviceConfig)

الناتج فقط. عملية الإعداد الحالية للجهاز كما هو مسجَّل في قوائم التحقّق من الأمان (SAS).

state

enum (State)

الناتج فقط. حالة الجهاز

grants[]

object (DeviceGrant)

الناتج فقط. المِنح التي يحملها الجهاز
displayName

string

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

إعداد الجهاز

معلومات عن إعدادات الجهاز

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

الناتج فقط. ما إذا كان قد تم توقيع الإعداد من خلال تكلفة لكل تثبيت.
updateTime

string (Timestamp format)

الناتج فقط. آخر مرة تمّ فيها تعديل إعدادات الجهاز.

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقّة تصل إلى نانوثانية. مثال: "2014-10-02T15:01:23.045123456Z"

فئة الجهاز

فئة FCC للجهاز، على النحو المحدد في الجزء 96.

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

إصدار الجهاز الثابت.

واجهة الجهاز

معلومات عن واجهة الهواء على الجهاز

تمثيل JSON 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
الحقول
radioTechnology

enum (RadioTechnology)

يحدّد هذا الحقل تقنية الوصول إلى الراديو المستخدمة من أجل CBSD.

الجملة الشرطية
supportedSpec

string

يرتبط هذا الحقل بالحقل اللاسلكي، ويقدّم مواصفات واجهة الهواء التي تلتزم CBSD بها في وقت التسجيل.

اختيارية

التكنولوجيا الإشعاعية

الأنواع المعتمدة من تكنولوجيا الوصول إلى الراديو

عمليات التعداد
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
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
}
الحقول
latitude

number

خط عرض الموقع الجغرافي لهوائي الجهاز بالدرجات بالنسبة إلى مرجع WGS 84. يتراوح النطاق المسموح به من -90.000000 إلى +90.000000. تمثل القيم الموجبة خطوط العرض شمال خط الاستواء، والقيم السالبة جنوب خط الاستواء.
longitude

number

خط الطول لموقع هوائي الجهاز بالدرجات مقارنةً بمعيار WGS 84. يتراوح النطاق المسموح به من -180.000000 إلى +180.000000. تمثّل القيم الموجبة خطوط الطول شرق خط الطول الرئيسي، بينما تمثل القيم الموجبة غرب خط الطول الرئيسي.
height

number

ارتفاع هوائي الجهاز بالمتر عندما تكون قيمة معلّمة heightType هي "AGL"، يجب إعطاء ارتفاع الهوائي مقارنةً بمستوى الأرض. عندما تكون قيمة المعلّمة typeType هي &&;;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

الارتفاع في هوائي الذروة بالديسيبل وهذه المعلّمة عبارة عن عدد صحيح بقيمة بين -127 و128 (dBi) شاملة.
eirpCapability

integer

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

integer

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

string

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

نوع الارتفاع

تحدّد طريقة قياس الارتفاع.

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

قابلية القياس

إمكانية قياس الأجهزة. يتم تحديد القيم من خلال [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 بعد في SAS.
REGISTERED الجهاز مسجّل باستخدام SAS.
DEREGISTERED تم إلغاء تسجيل الجهاز مع SAS.

منح الجهاز

مِنح الجهاز. وهو تفويض يوفّره "نظام الوصول إلى Spectrum Access" على الجهاز لنقله باستخدام معلَمات تشغيل محدّدة بعد الإشارة الناجحة إلى الجهاز.

تمثيل JSON 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
الحقول
maxEirp

number

الحد الأقصى للطاقة المشعاعية المكافئة (EIRP) الذي يسمح به المنح. يبلغ الحد الأقصى لقيم EIRP بوحدات dBm/ميغاهرتز. وتمثّل قيمة maxEirp متوسط ERMP الذي سيتم قياسه من خلال الإجراء المحدّد في الجزء 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"

نطاق التكرار

يتراوح معدل التكرار من low_frequency إلى high_frequency.

تمثيل JSON 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
الحقول
lowFrequencyMhz

number

أدنى تردد لنطاق التردد بالميغاهرتز.
highFrequencyMhz

number

أعلى تردد لنطاق التردد بالميغاهرتز.

غرانت ستيت

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

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

نوع القناة

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

قائمة التشغيل (DpamoveList)

إدخال في قائمة عمليات نقل البيانات (DPA)

تمثيل 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 الموقّعة.