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.

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)

لا تتوفّر سوى النطاقات ضمن القوائم المسموح بها للمِنح الجديدة.

إعداد الجهاز

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

تمثيل 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:23Z" و"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

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

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

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

عمليات التعداد
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&quot؛ يتم تقديمها في ما يتعلق بمرجع 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

الارتفاع في هوائي الذروة بالديسيبل وهذه المعلّمة عبارة عن عدد صحيح بقيمة بين -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 ثُمانية.

cpeCbsdIndication

boolean

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

نوع الارتفاع

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

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

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

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

منح الجهاز

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

تمثيل 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 متوسط EIRP الذي سيتم قياسه من خلال الإجراء المحدّد في الجزء 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: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

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

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)

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

البيانات الوصفية للجهاز

يمكن إلغاء بيانات الجهاز من خلال كل من بوابة 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

Common Channel Group (CCG). مجموعة من وحدات CBSD في مستوى ICG نفسه والتي تطلب تخصيصًا مشتركًا للقناة. لمزيد من التفاصيل، يُرجى الاطّلاع على CBRSA-TS-2001 V3.0.0.

antennaModel

string

إذا تمت تعبئة هذا الحقل، يجب استخدام نقش نموذج الهوائي لاستخدامه. التنسيق هو: RecordCreatorId:PatternId

nrqzValidated
(deprecated)

boolean

الناتج فقط. يتم الضبط على true إذا تحقّقت التكلفة لكل تثبيت من تنسيقها مع مكتب المنطقة الهادئة الوطنية.

nrqzValidation

object (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.