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

دسته دستگاه

دسته 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

این رشته مربوط به حوزه رادیوتکنولوژی است و مشخصات رابط هوایی را ارائه می دهد که CBSD در زمان ثبت با آن مطابقت دارد.

اختیاری

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

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

Enums
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" است، ارتفاع آنتن باید نسبت به سطح زمین داده شود. هنگامی که مقدار پارامتر heightType "AMSL" است، با توجه به داده WGS84 داده می شود.

heightType

enum ( HeightType )

نحوه اندازه گیری ارتفاع را مشخص می کند.

horizontalAccuracy

number

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

verticalAccuracy

number

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

indoorDeployment

boolean

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

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 اکتت است.

نوع ارتفاع

نحوه اندازه گیری ارتفاع را مشخص می کند.

Enums
HEIGHT_TYPE_UNSPECIFIED نوع ارتفاع نامشخص
HEIGHT_TYPE_AGL ارتفاع AGL نسبت به سطح زمین اندازه گیری می شود.
HEIGHT_TYPE_AMSL ارتفاع AMSL نسبت به سطح متوسط ​​دریا اندازه گیری می شود.

قابلیت اندازه گیری

قابلیت اندازه گیری دستگاه مقادیر با [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf] تعریف می شوند.

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

دولت

وضعیت دستگاه

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
}
زمینه های
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: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 )

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

مواد و روش ها

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 امضا شده را به روز می کند.