REST Resource: customers.deployments.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,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "currentChannels": [
    {
      object (ChannelWithScore)
    }
  ],
  "grantRangeAllowlists": [
    {
      object (FrequencyRange)
    }
  ]
}
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.
deviceMetadata

object (DeviceMetadata)

Paramètres d'appareil pouvant être remplacés par des demandes d'enregistrement SAS Portal et SAS.
currentChannels[]
(deprecated)

object (ChannelWithScore)

Uniquement en sortie. Chaînes actuelles avec des scores
grantRangeAllowlists[]

object (FrequencyRange)

Seules les plages figurant dans les listes d'autorisation sont disponibles pour les nouvelles autorisations.

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" avec une résolution de nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples : "2014-10-02T15:01:23Z" et "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)

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

string

Facultatif. Ce champ est lié à radioTechnology et fournit la spécification d'interface aérienne que la CBSD respecte au moment de l'enregistrement.

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
CW
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,
  "cpeCbsdIndication": boolean
}
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 en degrés par rapport au plan de référence du 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. true: intérieur. false : 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.
cpeCbsdIndication

boolean

S'il est présent, ce paramètre indique si la CBSD est un CPE-CBSD.

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.

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

State

État de la configuration de l'appareil. Seules les configurations dont l'état est DEVICE_CONFIG_STATE_FINAL peuvent être utilisées lors de l'enregistrement CBSD.

Enums
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": 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" avec une résolution de nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

Si la subvention est suspendue, le ou les motifs de la suspension.
grantId

string

ID de l'attribution.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

Délai d'expiration de la transmission de la dernière pulsation.

Horodatage au format RFC3339 UTC "Zulu" avec une résolution de nanoseconde et jusqu'à neuf chiffres après la virgule. Exemples: "2014-10-02T15:01:23Z" et "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étadonnées de l'appareil

Données de l'appareil pouvant être remplacées par le portail SAS et les demandes d'enregistrement.

Représentation JSON 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
Champs
interferenceCoordinationGroup

string

Interference Coordination Group (ICG). Groupe de CBSD qui gère ses propres interférences avec le groupe. Pour en savoir plus, consultez CBRSA-TS-2001 V3.0.0.
commonChannelGroup

string

Groupe de canaux commun (CCG). Groupe de CBSD appartenant au même ICG demandant l'attribution d'un canal principal commun. Pour en savoir plus, consultez CBRSA-TS-2001 V3.0.0.
antennaModel

string

S'il est renseigné, le modèle de modèle d'antenne à utiliser. Format : RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

Uniquement en sortie. Défini sur true si un CPI a confirmé qu'il s'est coordonné avec le bureau national de zone calme.
nrqzValidation

object (NrqzValidation)

Uniquement en sortie. Infos de validation de National Radio Quiet Zone.

Validation NQQ

Informations sur la validation de la National Radio Quiet Zone

Représentation JSON 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
Champs
state

enum (State)

État des informations de validation NRQZ.
caseId

string

Numéro de demande de validation.
latitude

number

Latitude de l'appareil associée à la validation.
longitude

number

Longitude de l'appareil associée à la validation.
cpiId

string

CPI ayant signé la validation.

State

État des informations de validation NRQZ.

Enums
STATE_UNSPECIFIED État non spécifié.
DRAFT État du brouillon.
FINAL État final.

Chaîne avec score

Chaîne avec un score.

Représentation JSON 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
Champs
frequencyRange

object (FrequencyRange)

Plage de fréquences du canal.
score

number

Score du canal, normalisé pour se situer dans la fourchette [0,100].

Méthodes

create

 Crée un device sous node ou customer.

createSigned

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

list

 Répertorie devices sous node ou customer.