Configuration de la position des appareils LoRaWAN - AWS IoT Wireless
Ports de trame et format des messages de liaison montanteConfiguration de la position de vos appareils à l'aide de la consoleConfigurer la position de l'appareil à l'aide de l'API

Configuration de la position des appareils LoRaWAN

Lorsque vous ajoutez votre appareil à AWS IoT Core for LoRaWAN, vous pouvez spécifier les informations de position statiques, éventuellement activer le positionnement et spécifier une destination. La destination décrit la règle IoT qui traite les informations de position de l'appareil et achemine la position mise à jour vers Amazon Location Service. Une fois que vous avez configuré la position de votre appareil, les données de position sont affichées sur une carte de localisation Amazon avec les informations de précision et la destination que vous avez spécifiée.

Vous pouvez configurer la position de votre appareil à l’aide de la AWS Management Console, de l’API AWS IoT Wireless ou d’AWS CLI.

Si vous activez le positionnement, vous devez spécifier le port du cadre de géolocalisation pour communiquer les données de numérisation Wi-Fi et GNSS de l’appareil vers AWS IoT Core for LoRaWAN. Les informations de position sont communiquées à AWS IoT Core for LoRaWAN via ce port de cadre.

La spécification LoRaWAN fournit un champ de livraison de données (FrmPayload) et un champ Port (fPort) pour distinguer les différents types de messages. Pour communiquer les informations de position, vous pouvez spécifier une valeur comprise entre 1 et 223 pour le port de trame. Le port 0 est réservé aux messages MAC, le port 224 est réservé aux tests de conformité MAC et les ports 225 à 255 sont réservés aux futures extensions d'applications standardisées.

Lorsque vous ajoutez une destination, une règle AWS IoT est créée pour acheminer les données vers Amazon Location Service à l'aide du moteur de règles. Les informations de position mises à jour sont ensuite affichées sur une carte de localisation Amazon. Si vous n'avez pas activé le positionnement, la destination achemine les données de position lorsque vous mettez à jour les coordonnées de position statiques de votre appareil.

Le code suivant indique le format du message de liaison ascendante envoyé par AWS IoT Core for LoRaWAN avec les informations de position, la précision, la configuration du solveur et les métadonnées sans fil. Les champs surlignés ci-dessous sont facultatifs. S'il n'existe aucune information de précision verticale, la valeur est null.

{
    // Position configuration parameters for given wireless device
    "WirelessDeviceId": "5b58245e-146c-4c30-9703-0ca942e3ff35",     

    // Position information for a device in GeoJSON format. Altitude
    // is optional. If no vertical accuracy information is available
    // or positioning isn't activated, the value is set to null.
    // The position information coordinates are listed in the order 
    // [longitude, latitude, altitude].
    "coordinates": [33.33000183105469, -22.219999313354492, 99.0],
    "type": "Point",
    "properties": { 
         "horizontalAccuracy": number,
         "verticalAccuracy": number",
         "timestamp": "2022-08-19T03:08:35.061Z"
    },

    //Parameters controlled by AWS IoT Core for LoRaWAN
    "WirelessMetadata": 
    {
        "LoRaWAN":
        {
            "ADR": false,
            "Bandwidth": 125,
            "ClassB": false,
            "CodeRate": "4/5",
            "DataRate": "0",
            "DevAddr": "00b96cd4",
            "DevEui": "58a0cb000202c99",            
            "FOptLen": 2,
            "FCnt": 1,
            "Fport": 136,   
            "Frequency": "868100000",     
            "Gateways": [
             {
                    "GatewayEui": "80029cfffe5cf1cc",      
                    "Snr": -29,
                    "Rssi": 9.75
             }
             ],  
            "MIC": "7255cb07",  
            "MType": "UnconfirmedDataUp",
            "Major": "LoRaWANR1",
            "Modulation": "LORA", 
            "PolarizationInversion": false,    
            "SpreadingFactor": 12,                         
            "Timestamp": "2021-05-03T03:24:29Z"
            
        }
    }
}

Configuration de la position de vos appareils à l'aide de la console

Pour configurer et gérer la position de vos appareils à l'aide de AWS Management Console, connectez-vous d'abord à la console, puis accédez à la page du hub Appareils de la AWS IoT console.

Ajouter les informations sur la position

Pour ajouter des informations de position pour votre appareil :

  1. Sur la page hub des Appareils, choisissez Ajouter un appareil sans fil.

  2. Entrez les spécifications de l'appareil sans fil, les profils de l'appareil et du service, ainsi que la destination qui définit la règle IoT pour le routage des données vers d'autres Service AWS. Pour en savoir plus, consultez Intégrez vos appareils à AWS IoT Core for LoRaWAN.

  3. Entrez les informations de position, activez éventuellement la géolocalisation et spécifiez la destination des données de position que vous souhaitez utiliser pour acheminer les messages.

    • Informations sur le poste

      Spécifiez les données de position de votre appareil à l'aide des coordonnées de latitude et de longitude et d'une coordonnée d'altitude facultative. Les informations de position sont basées sur le système de coordonnées WGS84.

    • Géolocalisation

      Activez le positionnement si vous souhaitez qu’AWS IoT Core for LoRaWAN utilise la géolocalisation pour calculer la position de l’appareil. Il utilise des solveurs GNSS et Wi-Fi tiers pour identifier la position de votre appareil en temps réel.

      Pour entrer les informations de géolocalisation, choisissez Activer le positionnement et entrez le port du cadre de géolocalisation pour communiquer les données de numérisation GNSS et Wi-Fi à AWS IoT Core for LoRaWAN. Vous verrez les FPorts par défaut renseignés à titre de référence. Toutefois, vous pouvez choisir une valeur différente comprise entre 1 et 223.

    • Destination des données de position

      Choisissez une destination pour décrire la règle AWS IoT qui traite les données de position de l’appareil et les transmet à AWS IoT Core for LoRaWAN. Utilisez cette destination uniquement pour acheminer les données de position. Elle doit être différente de la destination que vous utilisez pour acheminer les données de l'appareil vers d'autres Service AWS.

Afficher la configuration de position de l'appareil

Une fois que vous avez configuré la position de votre appareil, AWS IoT Core for LoRaWAN crée une carte de localisation Amazon appelée iotwireless.map. Vous pouvez voir cette carte sur la page de détails de votre appareil dans l'onglet Position. Sur la base des coordonnées de position que vous avez spécifiées ou de la position calculée par les solveurs tiers, la position de votre appareil sera affichée sous forme de marqueur sur la carte. Vous pouvez zoomer ou dézoomer pour visualiser clairement la position de votre appareil sur la carte. Sur la page de détails de l'appareil, sous l'onglet Position, vous verrez également les informations de précision, l'horodatage auquel la position de votre appareil a été déterminée et la destination des données de position que vous avez spécifiée.

Note

Si vous n'avez pas activé les cartes Amazon Location Service, vous verrez un message indiquant que vous devrez utiliser Amazon Location Service pour accéder à la carte et afficher la position. L'utilisation des cartes Amazon Location Service peut entraîner des frais supplémentaires pour votre compte Compte AWS. Pour en savoir plus, consultez AWS IoT Core Tarification.

La carte, iotwireless.map, agit comme une source de données cartographiques accessibles à l'aide d'opérations d'API Get, telles que GetMapTile. Pour plus d'informations sur les API Get utilisées avec les cartes, consultez le manuel de référence des API Amazon Location Service.

Pour obtenir des informations supplémentaires sur cette carte, accédez à la console Amazon Location Service, choisissez Cartes, puis iotwireless.map. Pour plus d'informations, consultez Cartes dans le guide du développeur Amazon Location Service.

Mettre à jour la configuration de position de l'appareil

Pour modifier la configuration de la position de l'appareil, dans la page des détails de l'appareil, choisissez Modifier, puis mettez à jour les informations de position, les paramètres de géolocalisation et la destination.

Note

Les informations relatives aux données de position historiques ne sont pas disponibles. Lorsque vous mettez à jour les coordonnées de position de l'appareil, celui-ci remplace les données de position précédemment signalées. Après avoir mis à jour la position, dans l'onglet Position des détails de l’appareil, vous verrez les nouvelles informations de position. Le changement d'horodatage indique qu'il correspond à la dernière position connue de l’appareil.

Configurer la position de l'appareil à l'aide de l'API

Vous pouvez spécifier les informations de position, configurer la position de l’appareil et éventuellement activer la géolocalisation à l’aide de l’API AWS IoT Wireless ou d’AWS CLI.

Important

Les actions d'API UpdatePosition, GetPosition, PutPositionConfiguration, GetPositionConfiguration, et ListPositionConfigurations ne sont plus prises en charge. Les appels pour mettre à jour et récupérer les informations de position doivent plutôt utiliser les opérations d'API GetResourcePosition et UpdateResourcePosition.

Ajouter des informations de position et de configuration

Pour ajouter les informations de position pour un périphérique sans fil donné, spécifiez les coordonnées à l'aide de l'opération API UpdateResourcePosition ou de la commande CLI update-resource-position. Spécifiez WirelessDevice comme ResourceType, l'ID du périphérique sans fil à mettre à jour comme ResourceIdentifier, ainsi que les informations de position.

aws iotwireless update-resource-position \ 
    --resource-type WirelessDevice \ 
    --resource-id "1ffd32c8-8130-4194-96df-622f072a315f" \ 
    --position [33.33, -33.33, 10.0]

L’exemple suivant affiche le contenu du fichier deviceposition.json. Pour spécifier les valeurs FPort pour l'envoi des données de géolocalisation, utilisez l'objet Positionnement avec les opérations d'API CreateWirelessDevice et UpdateWirelessDevice.

Contenu de deviceposition.json

{ 
     "type": "Point",
     "coordinates": [33.3318, -22.2155, 13.123],
     "properties": {
          "verticalAccuracy": 707,
          "horizontalAccuracy": 
          "timestamp": "2018-11-30T18:35:24Z"
      }
}

Exécuter cette commande ne fournit aucune sortie. Pour voir les informations de position que vous avez spécifiées, utilisez l'opération API GetResourcePosition.

Obtenir des informations de position et de configuration

Pour obtenir les informations de position d'un appareil sans fil donné, utilisez l'API GetResourcePosition ou la commande CLI get-resource-position. Spécifiez WirelessDevice en tant que resourceType et fournissez l'ID de l’appareil sans fil en tant que resourceIdentifier.

aws iotwireless get-resource-position \ 
    --resource-type WirelessDevice \ 
    --resource-id "1ffd32c8-8130-4194-96df-622f072a315f"

L'exécution de cette commande affiche les informations de position de votre appareil sans fil sous forme de charge utile GeoJSON. Vous verrez des informations sur les coordonnées de position, le type d'emplacement et les propriétés qui peuvent inclure des informations de précision et l'horodatage qui correspond à la dernière position connue de l'appareil.

{ 
     "type": "Point",
     "coordinates": [33.3318, -22.2155, 13.123],
     "properties": {
          "verticalAccuracy": 707,
          "horizontalAccuracy": 389,
          "horizontalConfidenceLevel": 0.68,
          "verticalConfidenceLevel": 0.68,
          "timestamp": "2018-11-30T18:35:24Z"
      }
}