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 )

فقط محدوده هایی که در لیست های مجاز هستند برای کمک های مالی جدید در دسترس هستند.

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" .

دسته دستگاه

دسته FCC دستگاه، همانطور که در قسمت 96 تعریف شده است.

Enums
DEVICE_CATEGORY_UNSPECIFIED دسته دستگاه نامشخص
DEVICE_CATEGORY_A دسته A.
DEVICE_CATEGORY_B دسته B.

مدل دستگاه

اطلاعاتی در مورد مدل دستگاه

نمایندگی 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 در زمان ثبت با آن مطابقت دارد.

رادیوتکنولوژی

انواع تایید شده فناوری دسترسی رادیویی

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

عدد مثبت بر حسب متر برای نشان دادن دقت موقعیت افقی آنتن دستگاه. این پارامتر اختیاری تنها در صورتی باید وجود داشته باشد که مقدار آن کمتر از 50 متر مورد نیاز FCC باشد.

verticalAccuracy

number

عدد مثبت بر حسب متر برای نشان دادن دقت موقعیت عمودی آنتن دستگاه. این پارامتر اختیاری فقط در صورتی باید وجود داشته باشد که مقدار آن کمتر از FCC مورد نیاز 3 متر باشد.

indoorDeployment

boolean

آیا آنتن دستگاه در محیط داخلی است یا نه. true : سرپوشیده false : در فضای باز.

antennaAzimuth

integer

جهت دید باریکه صفحه افقی آنتن بر حسب درجه شمال واقعی. مقدار این پارامتر یک عدد صحیح با مقداری بین 0 تا 359 می باشد. مقدار 0 درجه به معنای شمال واقعی است. مقدار 90 درجه به معنای شرق است. این پارامتر برای دستگاه های رده A اختیاری و برای دستگاه های رده B مشروط است.

antennaDowntilt

integer

رو به پایین آنتن بر حسب درجه و یک عدد صحیح با مقدار بین 90- و 90+ است. یک مقدار منفی به این معنی است که آنتن به سمت بالا متمایل شده است (بالای افقی). این پارامتر برای دستگاه های رده A اختیاری و برای دستگاه های رده B مشروط است.

antennaGain

integer

حداکثر افزایش آنتن در dBi. این پارامتر یک عدد صحیح با مقداری بین -127 و +128 (dBi) است.

eirpCapability

integer

این پارامتر حداکثر EIRP دستگاه در واحدهای dBm/10MHz است و یک عدد صحیح با مقدار بین -127 و +47 (dBm/10 MHz) شامل می باشد. اگر شامل نباشد، SAS آن را به عنوان حداکثر مجاز EIRP در واحدهای dBm/10MHz برای دسته دستگاه تفسیر می کند.

antennaBeamwidth

integer

3-dB عرض پرتو آنتن آنتن در صفحه افقی بر حسب درجه. این پارامتر یک عدد صحیح بدون علامت است که دارای مقداری بین 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 لغو ثبت شد.

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 بر حسب واحد dBm/MHz است. مقدار maxEirp نشان دهنده میانگین (RMS) EIRP است که با روش تعریف شده در 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

کمترین فرکانس محدوده فرکانس بر حسب مگاهرتز.

highFrequencyMhz

number

بالاترین فرکانس محدوده فرکانس بر حسب مگاهرتز.

Grant State

وضعیت کمک هزینه.

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

DpaMoveList

یک ورودی در لیست حرکت DPA.

نمایندگی JSON
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
زمینه های
dpaId

string

شناسه DPA

frequencyRange

object ( FrequencyRange )

محدوده فرکانسی که لیست حرکت بر آن تأثیر می گذارد.

Metadata دستگاه

داده های دستگاه قابل رد شدن توسط 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

فقط خروجی اگر یک CPI تأیید کرده باشد که با دفتر منطقه ساکت ملی هماهنگ شده است، روی true تنظیم کنید.

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

CPI که اعتبار سنجی را امضا کرد.

دولت

وضعیت اطلاعات اعتبار سنجی NRQZ.

Enums
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 فهرست می کند.