REST Resource: customers.devices

Ressource: Device

Représentation JSON 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
Champs
name

string

Uniquement en sortie. Nom du chemin d'accès à la ressource.
fccId

string

Identifiant FCC de l'appareil.
serialNumber

string

Numéro de série attribué à l'appareil par le fabricant.
preloadedConfig

object (DeviceConfig)

Configuration de l'appareil, telle que spécifiée via l'API SAS Portal.

activeConfig

object (DeviceConfig)

Uniquement en sortie. Configuration actuelle de l'appareil tel qu'enregistré auprès de SAS.

state

enum (State)

Uniquement en sortie. État de l'appareil.

grants[]

object (DeviceGrant)

Uniquement en sortie. Licences détenues par l'appareil.
displayName

string

Nom à afficher de l'appareil.

DeviceConfig

Informations sur la configuration de l'appareil.

Représentation 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
}
Champs
category

enum (DeviceCategory)

Catégorie FCC de l'appareil.

model

object (DeviceModel)

Informations sur ce modèle d'appareil.

airInterface

object (DeviceAirInterface)

Informations sur l'interface aérienne de cet appareil.

installationParams

object (InstallationParams)

Paramètres d'installation de l'appareil.

measurementCapabilities[]

enum (MeasurementCapability)

Fonctionnalités de création de rapports de l'appareil.

userId

string

Identifiant de l'utilisateur d'un appareil.
callSign

string

Indicatif téléphonique de l'opérateur de l'appareil.
state

enum (State)

État de la configuration.

isSigned

boolean

Uniquement en sortie. Indique si la configuration a été signée par un CPI.
updateTime

string (Timestamp format)

Uniquement en sortie. Dernière fois que la configuration de l'appareil a été modifiée.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

DeviceCategory

Catégorie FCC de l'appareil, telle que définie dans la partie 96.

Enums
DEVICE_CATEGORY_UNSPECIFIED Catégorie d'appareil non spécifiée.
DEVICE_CATEGORY_A Catégorie A.
DEVICE_CATEGORY_B Catégorie B.

Modèle de l'appareil

Informations sur le modèle de l'appareil.

Représentation JSON 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
Champs
vendor

string

Nom du fournisseur de l'appareil.
name

string

Nom du modèle de l'appareil.
softwareVersion

string

Version logicielle de l'appareil.
hardwareVersion

string

Version matérielle de l'appareil.
firmwareVersion

string

Version du micrologiciel de l'appareil.

Interface Appareil

Informations sur l'interface atmosphérique de l'appareil.

Représentation JSON 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
Champs
radioTechnology

enum (RadioTechnology)

Ce champ spécifie la technologie d'accès radio utilisée pour la carte CBSD.

Conditionnel
supportedSpec

string

Ce champ est lié au domaine radiotechnologique et fournit les spécifications de l'interface aérienne que la CBSD respecte au moment de l'enregistrement.

Facultative

Radiotechnologie

Types de technologie d'accès radio approuvés.

Enums
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
REDLINE
TARANA_WIRELESS

Paramètres d'installation

Informations sur les paramètres d'installation de l'appareil.

Représentation 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
}
Champs
latitude

number

Latitude de l'antenne de l'appareil en degrés par rapport au plan de référence du WGS 84. La plage autorisée est comprise entre -90,000000 et +90,000000. Les valeurs positives représentent les latitudes au nord de l'équateur ; les valeurs négatives au sud de l'équateur.
longitude

number

Longitude de l'antenne de l'appareil, exprimée en degrés par rapport au plan de référence WGS 84. La plage autorisée est comprise entre -180,000000 et +180,000000. Les valeurs positives représentent les longitudes à l'est du méridien d'origine et les valeurs négatives à l'ouest du méridien d'origine.
height

number

Hauteur de l'antenne de l'appareil en mètres. Lorsque la valeur du paramètre "heightType" est "AGL", la hauteur de l'antenne doit être indiquée par rapport au niveau du sol. Lorsque la valeur du paramètre "heightType" est "AMSL", elle est indiquée par rapport au plan de référence WGS84.
heightType

enum (HeightType)

Indique comment la hauteur est mesurée.

horizontalAccuracy

number

Nombre positif en mètres pour indiquer la précision de l'antenne horizontale de l'appareil. Ce paramètre facultatif ne doit être présent que si sa valeur est inférieure à l'exigence de la FCC de 50 mètres.
verticalAccuracy

number

Nombre positif en mètres pour indiquer la précision de la position verticale de l'antenne de l'appareil. Ce paramètre facultatif ne doit être présent que si sa valeur est inférieure à l'exigence de la FCC de 3 mètres.
indoorDeployment

boolean

Si l'antenne de l'appareil est à l'intérieur ou non. Vrai: intérieur. Faux: en extérieur.
antennaAzimuth

integer

Direction de l'orientation horizontale de l'antenne en degrés par rapport au nord géographique. La valeur de ce paramètre est un entier compris entre 0 et 359 inclus. Une valeur de 0 degré correspond au nord géographique et une valeur de 90 degrés à l'est. Ce paramètre est facultatif pour les appareils de catégorie A et conditionnel pour les appareils de catégorie B.
antennaDowntilt

integer

L'antenne est inclinée en degrés et est un entier dont la valeur est comprise entre -90 et +90 inclus. Une valeur négative signifie que l'antenne est inclinée vers le haut (au-dessus de l'axe horizontal). Ce paramètre est facultatif pour les appareils de catégorie A et conditionnel pour les appareils de catégorie B.
antennaGain

integer

Gain d'antenne maximal en dBi. Ce paramètre est un entier dont la valeur est comprise entre -127 et +128 (dBi) inclus.
eirpCapability

integer

Ce paramètre correspond à la valeur PIRE maximale de l'appareil, exprimée en unités de dBm/10 MHz. Il s'agit d'un nombre entier compris entre -127 et +47 (dBm/10 MHz) inclus. S'il n'est pas inclus, SAS l'interprète comme la PIRE maximale autorisée en unités de dBm/10 MHz pour la catégorie d'appareils.
antennaBeamwidth

integer

Largeur de faisceau d'antenne de 3 dB en degrés dans l'horizontale. Ce paramètre est un entier non signé dont la valeur est comprise entre 0 et 360 (degrés) inclus. Il est facultatif pour les appareils de catégorie A et facultatif pour les appareils de catégorie B.
antennaModel

string

Si une antenne externe est utilisée, le modèle d'antenne est éventuellement fourni dans ce champ. La chaîne ne doit pas dépasser 128 octets.

Type de hauteur

Indique comment la hauteur est mesurée.

Enums
HEIGHT_TYPE_UNSPECIFIED Type de hauteur non spécifié.
HEIGHT_TYPE_AGL La hauteur de l'AGL est mesurée par rapport au niveau du sol.
HEIGHT_TYPE_AMSL La hauteur de l'AMSL est mesurée par rapport au niveau moyen de la mer.

Capacité de mesure

Capacité de mesure des appareils. Les valeurs sont définies par [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

State

État de l'appareil.

Enums
DEVICE_STATE_UNSPECIFIED État non spécifié.
RESERVED Appareil créé dans le portail SAS, mais pas encore enregistré auprès de SAS.
REGISTERED Appareil enregistré auprès de SAS.
DEREGISTERED Appareil désinscrit auprès de SAS.

DeviceGrant

Octroi de l'appareil. Il s'agit d'une autorisation accordée par le système d'accès au spectre à un appareil de communiquer à l'aide des paramètres de fonctionnement spécifiés après une pulsation réussie.

Représentation JSON 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
Champs
maxEirp

number

Puissance maximale équivalente en isolement par rayonnement isotrope rayonné (EIRP) autorisée par la subvention. La valeur EIRP maximale est exprimée en unités de dBm/MHz. La valeur de maxEirp représente la PIRE moyenne (RMS) qui serait mesurée selon la procédure définie dans la partie 96,41(e)(3) de la FCC.
frequencyRange

object (FrequencyRange)

Plage de fréquence de transmission.

state

enum (GrantState)

État de la subvention.

channelType

enum (ChannelType)

Type de canal utilisé.

moveList[]

object (DpaMoveList)

Listes de déplacements du DPA sur lesquelles cette subvention apparaît.

expireTime

string (Timestamp format)

Date d'expiration de la subvention.

Horodatage au format RFC3339 UTC "Zulu", précis à la nanoseconde près. Exemple : "2014-10-02T15:01:23.045123456Z".

Plage de fréquences

Plage de fréquence comprise entre low_frequency et high_frequency.

Représentation JSON 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
Champs
lowFrequencyMhz

number

Fréquence la plus basse de la plage de fréquences en MHz.
highFrequencyMhz

number

Fréquence la plus élevée de la plage de fréquences en MHz.

GrantState

État de la subvention.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED L'octroi a été accordé, mais l'appareil n'est pas assez rapide.
GRANT_STATE_TERMINATED L'octroi a été résilié par la SAS.
GRANT_STATE_SUSPENDED La subvention a été suspendue par la SAS.
GRANT_STATE_AUTHORIZED L'appareil est en train d'émettre un message.
GRANT_STATE_EXPIRED L'attribution a expiré.

Type de canal

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

Liste DPaMove

Entrée de la liste de déplacement d'un APD.

Représentation JSON 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
Champs
dpaId

string

ID du DPA.
frequencyRange

object (FrequencyRange)

Plage de fréquences concernée par la liste des déplacements.

Méthodes

create

 Crée un device sous node ou customer.

createSigned

 Crée un device signé sous un node ou un customer.

delete

 Supprime un device.

get

 Récupère les détails d'une device.

list

 Répertorie devices sous node ou customer.

move

 Déplace un device vers un autre node ou customer.

patch

 Met à jour device.

signDevice

 Signe device.

updateSigned

 Met à jour un device signé.