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)

सिर्फ़ आउटपुट के लिए. एसएएस के साथ रजिस्टर किए गए डिवाइस का मौजूदा कॉन्फ़िगरेशन.

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)

डिवाइस की एफ़सीसी कैटगरी.

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)

सिर्फ़ आउटपुट के लिए. डिवाइस कॉन्फ़िगरेशन में पिछली बार बदलाव कब किया गया था.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड तक सटीक होता है. उदाहरण: "2014-10-02T15:01:23.045123456Z".

DeviceCategory

डिवाइस की एफ़सीसी कैटगरी, जिसे पार्ट 96 के तहत तय किया गया है.

Enums
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

रेडियो ऐक्सेस टेक्नोलॉजी के स्वीकृत टाइप.

Enums
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 की ज़रूरी शर्त के मुताबिक तीन मीटर से कम हो.
indoorDeployment

boolean

डिवाइस का ऐंटीना घर के अंदर है या नहीं. सही है: घर के अंदर. गलत: आउटडोर.
antennaAzimuth

integer

ऐंटीना के हॉरिज़ॉन्टल प्लेन की बोरसाइट दिशा, उत्तर के हिसाब से डिग्री में. इस पैरामीटर की वैल्यू, 0 से 359 के बीच की कोई पूर्णांक संख्या होती है. 0 डिग्री का मतलब उत्तर दिशा और 90 डिग्री का मतलब पूर्व दिशा होता है. यह पैरामीटर, कैटगरी A वाले डिवाइसों के लिए ज़रूरी नहीं है. हालांकि, कैटगरी B वाले डिवाइसों के लिए यह पैरामीटर कुछ शर्तों के साथ ज़रूरी है.
antennaDowntilt

integer

डिग्री में ऐंटना डाउनटिल्ट. यह एक पूर्णांक होता है, जिसकी वैल्यू -90 से +90 के बीच होती है. नेगेटिव वैल्यू का मतलब है कि ऐंटना ऊपर की ओर झुका हुआ है. यह पैरामीटर, कैटगरी A वाले डिवाइसों के लिए ज़रूरी नहीं है. हालांकि, कैटगरी B वाले डिवाइसों के लिए यह पैरामीटर कुछ शर्तों के साथ ज़रूरी है.
antennaGain

integer

dBi में ऐंटीना गेन की पीक वैल्यू. यह पैरामीटर एक पूर्णांक है. इसकी वैल्यू -127 और +128 (dBi) के बीच होती है. इसमें ये दोनों वैल्यू भी शामिल हैं.
eirpCapability

integer

यह पैरामीटर, dBm/10MHz की इकाइयों में डिवाइस का ज़्यादा से ज़्यादा ईआईआरपी है. यह एक पूर्णांक है, जिसकी वैल्यू -127 से +47 (dBm/10 MHz) के बीच होती है. अगर इसे शामिल नहीं किया जाता है, तो एसएएस इसे डिवाइस कैटगरी के लिए, dBm/10MHz की इकाइयों में ईआईआरपी की ज़्यादा से ज़्यादा अनुमत वैल्यू के तौर पर इंटरप्रेट करता है.
antennaBeamwidth

integer

डिग्री में, हॉरिज़ॉन्टल-प्लेन में ऐंटीना की 3-dB ऐंटीना बीमविड्थ. यह पैरामीटर, बिना हस्ताक्षर वाला पूर्णांक है. इसकी वैल्यू 0 से 360 (डिग्री) के बीच होती है. यह कैटगरी A वाले डिवाइसों के लिए ज़रूरी नहीं है और कैटगरी B वाले डिवाइसों के लिए कुछ शर्तों के साथ ज़रूरी है.
antennaModel

string

अगर किसी बाहरी ऐन्टेना का इस्तेमाल किया जाता है, तो इस फ़ील्ड में ऐन्टेना मॉडल की जानकारी दी जा सकती है. स्ट्रिंग की लंबाई ज़्यादा से ज़्यादा 128 ऑक्टेट होती है.

HeightType

इससे पता चलता है कि ऊंचाई को कैसे मेज़र किया जाता है.

Enums
HEIGHT_TYPE_UNSPECIFIED ऊंचाई के टाइप की जानकारी नहीं दी गई है.
HEIGHT_TYPE_AGL AGL की ऊंचाई, ज़मीन के लेवल के हिसाब से मापी जाती है.
HEIGHT_TYPE_AMSL AMSL की ऊंचाई, समुद्र तल से मापी जाती है.

MeasurementCapability

डिवाइस की मेज़रमेंट क्षमता. इन वैल्यू को [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 Portal में डिवाइस बनाया गया है. हालांकि, इसे अब तक SAS के साथ रजिस्टर नहीं किया गया है.
REGISTERED डिवाइस को SAS के साथ रजिस्टर किया गया है.
DEREGISTERED डिवाइस को एसएएस से डी-रजिस्टर कर दिया गया है.

DeviceGrant

डिवाइस का ऐक्सेस देना. यह स्पेक्ट्रम ऐक्सेस सिस्टम की ओर से किसी डिवाइस को दिया गया अनुमति पत्र है. इससे डिवाइस को तय किए गए ऑपरेटिंग पैरामीटर का इस्तेमाल करके डेटा ट्रांसमिट करने की अनुमति मिलती है. हालांकि, इसके लिए डिवाइस को हार्टबीट सिग्नल भेजना ज़रूरी है.

JSON के काेड में दिखाना 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
फ़ील्ड
maxEirp

number

अनुदान के तहत, ज़्यादा से ज़्यादा इक्विवैलेंट आइसोट्रॉपिक रेडिएटेड पावर (ईआईआरपी) की अनुमति है. ईआईआरपी की ज़्यादा से ज़्यादा वैल्यू, dBm/MHz में होती है. maxEirp की वैल्यू, औसत (आरएमएस) ईआईआरपी को दिखाती है. इसे एफ़सीसी के पार्ट 96.41(e)(3) में बताई गई प्रोसेस के हिसाब से मेज़र किया जाता है.
frequencyRange

object (FrequencyRange)

ट्रांसमिशन की फ़्रीक्वेंसी रेंज.

state

enum (GrantState)

अनुमति देने की स्थिति.

channelType

enum (ChannelType)

इस्तेमाल किए गए चैनल का टाइप.

moveList[]

object (DpaMoveList)

डीपीए की उन सूचियों को दिखाता है जिनमें यह अनुमति दिखती है.

expireTime

string (Timestamp format)

अनुमति खत्म होने का समय.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, नैनोसेकंड तक सटीक होता है. उदाहरण: "2014-10-02T15:01:23.045123456Z".

FrequencyRange

फ़्रीक्वेंसी की रेंज, low_frequency से high_frequency तक है.

JSON के काेड में दिखाना 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
फ़ील्ड
lowFrequencyMhz

number

मेगाहर्ट्ज़ में फ़्रीक्वेंसी रेंज की सबसे कम फ़्रीक्वेंसी.
highFrequencyMhz

number

फ़्रीक्वेंसी रेंज की सबसे ज़्यादा फ़्रीक्वेंसी, मेगाहर्ट्ज़ में.

GrantState

अनुमति की स्थिति.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED अनुमति दे दी गई है, लेकिन डिवाइस पर हार्टबीट नहीं हो रहा है.
GRANT_STATE_TERMINATED एसएएस ने यह अनुदान बंद कर दिया है.
GRANT_STATE_SUSPENDED SAS ने इस ग्रांट को निलंबित कर दिया है.
GRANT_STATE_AUTHORIZED फ़िलहाल, डिवाइस डेटा ट्रांसमिट कर रहा है.
GRANT_STATE_EXPIRED अनुदान की समयसीमा खत्म हो गई है.

ChannelType

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

डेटा प्रोसेसिंग समझौते (डीपीए) की सूची में मौजूद कोई एंट्री.

JSON के काेड में दिखाना 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
फ़ील्ड
dpaId

string

डीपीए का आईडी.
frequencyRange

object (FrequencyRange)

फ़्रीक्वेंसी की वह सीमा जिस पर सूची को दूसरी जगह ले जाने का असर पड़ता है.

तरीके

create

 यह node या customer के नीचे device बनाता है.

createSigned

 यह node या customer के तहत, हस्ताक्षर किया गया device बनाता है.

delete

 यह कुकी, device को मिटाती है.

get

 किसी device के बारे में जानकारी मिलती है.

list

 node या customer के तहत devices की सूची.

move

 इस सुविधा की मदद से, किसी device को दूसरे node या customer के नीचे ले जाया जा सकता है.

patch

 device को अपडेट करता है.

signDevice

 यह कुकी, device पर हस्ताक्षर करती है.

updateSigned

 इस कुकी का इस्तेमाल, साइन किए गए device को अपडेट करने के लिए किया जाता है.