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 qu'elle est spécifiée via l'API du portail SAS.

activeConfig

object (DeviceConfig)

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

state

enum (State)

Uniquement en sortie. État de l'appareil.

grants[]

object (DeviceGrant)

Uniquement en sortie. Autorisations 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 radio de cet appareil.

installationParams

object (InstallationParams)

Paramètres d'installation de l'appareil.

measurementCapabilities[]

enum (MeasurementCapability)

Capacités de l'appareil en termes de création de rapports sur les mesures.

userId

string

Identifiant d'un utilisateur de l'appareil.
callSign

string

Indicatif 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. Date et heure de la dernière modification de la configuration de l'appareil.

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 par la section 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.

DeviceModel

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.

DeviceAirInterface

Informations sur l'interface radio 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 le CBSD.

Conditionnel
supportedSpec

string

Ce champ est lié au champ "radioTechnology" et fournit la spécification de l'interface radio à laquelle la CBSD est conforme au moment de l'enregistrement.

Facultatif

RadioTechnology

Types de technologies 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

InstallationParams

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'emplacement de l'antenne de l'appareil en degrés par rapport au datum 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, et les valeurs négatives celles au sud de l'équateur.
longitude

number

Longitude de l'emplacement de l'antenne de l'appareil, en degrés par rapport au datum WGS 84. La plage autorisée est comprise entre -180,000000 et +180,000000. Les valeurs positives représentent les longitudes à l'est du premier méridien, et les valeurs négatives celles à l'ouest.
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 donnée par rapport au datum WGS84.
heightType

enum (HeightType)

Spécifie comment la hauteur est mesurée.

horizontalAccuracy

number

Nombre positif en mètres indiquant la précision de l'emplacement horizontal de l'antenne de l'appareil. Ce paramètre facultatif ne doit être présent que si sa valeur est inférieure à la distance de 50 mètres requise par la FCC.
verticalAccuracy

number

Nombre positif en mètres indiquant la précision de l'emplacement vertical de l'antenne de l'appareil. Ce paramètre facultatif ne doit être présent que si sa valeur est inférieure à la distance de 3 mètres requise par la FCC.
indoorDeployment

boolean

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

integer

Direction de visée du plan horizontal 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é signifie le nord géographique, tandis qu'une valeur de 90 degrés signifie 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

Inclinaison de l'antenne en degrés. Il s'agit d'un nombre entier compris entre -90 et +90 inclus. Une valeur négative signifie que l'antenne est inclinée vers le haut (au-dessus de l'horizontale). Ce paramètre est facultatif pour les appareils de catégorie A et conditionnel pour les appareils de catégorie B.
antennaGain

integer

Gain maximal de l'antenne 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 PIRE maximale de l'appareil en dBm/10 MHz. Il s'agit d'un nombre entier compris entre -127 et +47 (dBm/10 MHz) inclus. Si elle n'est pas incluse, le SAS l'interprète comme la puissance isotrope rayonnée équivalente maximale autorisée en dBm/10 MHz pour la catégorie d'appareil.
antennaBeamwidth

integer

Largeur du faisceau d'antenne à 3 dB dans le plan horizontal, en degrés. 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 conditionnel pour les appareils de catégorie B.
antennaModel

string

Si une antenne externe est utilisée, le modèle d'antenne peut être indiqué dans ce champ. La chaîne ne doit pas comporter plus de 128 octets.

HeightType

Spécifie comment la hauteur est mesurée.

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

MeasurementCapability

Capacité de mesure de l'appareil. 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

État

État de l'appareil.

Enums
DEVICE_STATE_UNSPECIFIED État non spécifié.
RESERVED L'appareil a été créé dans le portail SAS, mais n'a pas encore été enregistré auprès de SAS.
REGISTERED L'appareil est enregistré auprès du SAS.
DEREGISTERED L'appareil a été désenregistré auprès du SAS.

DeviceGrant

Autorisation d'appareil. Il s'agit d'une autorisation fournie par le système d'accès au spectre à un appareil pour qu'il puisse transmettre des données à l'aide de paramètres de fonctionnement spécifiques après un signal de présence réussi de l'appareil.

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

number

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

object (FrequencyRange)

Plage de fréquences de transmission.

state

enum (GrantState)

État de l'octroi.

channelType

enum (ChannelType)

Type de canal utilisé.

moveList[]

object (DpaMoveList)

Liste des DPA sur lesquelles cette subvention apparaît.

expireTime

string (Timestamp format)

Heure d'expiration de l'autorisation.

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

FrequencyRange

Plage de fréquence de low_frequency à 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 l'autorisation.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED L'accès a été accordé, mais l'appareil n'envoie pas de signal de présence.
GRANT_STATE_TERMINATED L'autorisation a été résiliée par le SAS.
GRANT_STATE_SUSPENDED La subvention a été suspendue par le SAS.
GRANT_STATE_AUTHORIZED L'appareil transmet actuellement des données.
GRANT_STATE_EXPIRED L'autorisation a expiré.

ChannelType

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

Entrée dans la liste des mouvements d'un DPA.

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

string

ID du DPA.
frequencyRange

object (FrequencyRange)

Plage de fréquence affectée par la liste des mouvements.

Méthodes

create

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

createSigned

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

delete

 Supprime un device.

get

 Obtient des informations sur un device.

list

 Liste les devices sous un node ou un customer.

move

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

patch

 Met à jour un device.

signDevice

 Signe un device.

updateSigned

 Met à jour un device signé.