# Configurez les capacités de balisage et de filtrage de vos passerelles LoRaWAN
Lorsque vous travaillez avec des appareils LoRaWAN, vous pouvez configurer certains paramètres facultatifs pour vos passerelles LoRaWAN. Les paramètres comprennent :
+
**Le balisage**
Vous pouvez configurer les paramètres de balisage pour vos passerelles LoRaWAN qui agissent comme un pont pour vos appareils LoRaWAN de classe B. Ces appareils reçoivent un message en liaison descendante à des plages horaires planifiées. Vous devez donc configurer les paramètres de balisage pour que vos passerelles transmettent ces balises synchronisées dans le temps.
+
**Le filtrage**
Vous pouvez configurer les paramètres `NetID` et `JoinEUI` de vos passerelles LoRaWAN afin de filtrer le trafic de données de l’appareil. Le filtrage du trafic permet de préserver l’utilisation de la bande passante et de réduire le flux de trafic entre les passerelles et le réseau LNS.
+
**Les sous-bandes**
Vous pouvez configurer les sous-bandes de votre passerelle afin de spécifier la sous-bande particulière que vous souhaitez utiliser. Pour les appareils sans fil qui ne peuvent pas passer d’une sous-bande à l’autre, vous pouvez utiliser cette fonctionnalité pour communiquer avec les appareils en utilisant uniquement les canaux de fréquence de cette sous-bande particulière.
Les rubriques suivantes contiennent des informations supplémentaires sur ces paramètres et sur la manière de les configurer. Les paramètres de balisage ne sont pas disponibles dans le AWS Management Console et ne peuvent être spécifiés qu’à l’aide de l’AWS IoT WirelessAPI ou du AWS CLI.
**Topics**
+ [Configuration de vos passerelles pour envoyer des balises aux appareils de classe B](lorawan-gateway-beaconing.md)
+ [Configuration des sous-bandes et des capacités de filtrage de votre passerelle](lorawan-subband-filter-configuration.md)
# Configuration de vos passerelles pour envoyer des balises aux appareils de classe B
Si vous embarquez des appareils sans fil de classe B pour AWS IoT Core for LoRaWAN, les appareils reçoivent des messages en liaison descendante dans des créneaux hora ires planifiés. Les appareils ouvrent ces créneaux en fonction de balises synchronisées dans le temps transmises par la passerelle. Pour que vos passerelles transmettent ces balises synchrones dans le temps, vous pouvez utiliser AWS IoT Core for LoRaWAN pour configurer certains paramètres liés aux balises pour les passerelles.
Pour configurer ces paramètres de balisage, votre passerelle doit exécuter le logiciel LoRa Basics Station, version 2.0.6. Consultez [Utilisation de passerelles qualifiées issues du catalogue d’appareils partenaires AWS](lorawan-manage-gateways.md#lorawan-qualified-gateways).
## Comment configurer les paramètres de balisage
**Note**
Vous devez uniquement configurer les paramètres de balisage de votre passerelle si elle communique avec un périphérique sans fil de classe B.
Vous configurez les paramètres de balisage lorsque vous ajoutez votre passerelle à AWS IoT Core for LoRaWAN l’aide de l’opération d’API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html). Lorsque vous invoquez l’opération d’API, spécifiez les paramètres suivants à l’aide de l’objet `Beaconing` pour vos passerelles. Après avoir configuré les paramètres, les passerelles enverront les balises à vos appareils à un intervalle de 128 secondes.
+ `DataRate` : débit de données pour les passerelles qui transmettent les balises.
+ `Frequencies` : liste des fréquences utilisées par les passerelles pour transmettre les balises.
L’exemple suivant montre comment configurer les paramètres et pour la passerelle. Le fichier `input.json` contiendra des informations supplémentaires, telles que le certificat de passerelle et les informations d’identification de mise en service. Pour plus d’informations sur l’ajout de votre passerelle à AWS IoT Core for LoRaWAN en utilisant l’opération d’API `CreateWirelessGateway`, veuillez consulter [Ajout d’une passerelle à l’aide de l’API](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-api).
**Note**
Les paramètres de balisage ne sont pas disponibles lorsque vous ajoutez votre passerelle à AWS IoT Core for LoRaWAN en utilisant la console AWS IoT.
```
aws iotwireless create-wireless-gateway \
--name "myLoRaWANGateway" \
--cli-input-json file://input.json
```
L’exemple suivant affiche le contenu du fichier `input.json`.
**Contenu de input.json**
```
{
"Description": "My LoRaWAN gateway",
"LoRaWAN": {
"Beaconing": {
"DataRate": 8,
"Frequencies": ["923300000","923900000"]
},
"GatewayEui": "a1b2c3d4567890ab",
"RfRegion": US915,
"JoinEuiFilters": [
["0000000000000001", "00000000000000ff"],
["000000000000ff00", "000000000000ffff"]
],
"NetIdFilters": ["000000", "000001"],
"RfRegion": "US915",
"SubBands": [2]
}
}
```
L’exemple suivant illustre une partie des exemples de sortie pour cette commande :
```
{
"Arn": "arn:aws:iotwireless:us-east-1:400232685877aa:WirelessGateway/a01b2c34-d44e-567f-abcd-0123e445663a",
"Id": a01b2c34-d44e-567f-abcd-0123e445663a"
}
```
## Obtenir des informations sur les paramètres de balisage
Vous pouvez obtenir des informations sur les paramètres de balisage de votre passerelle à l’aide de l’opération API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html).
**Note**
Si une passerelle a déjà été intégrée, vous ne pouvez pas utiliser l’opération d’API `UpdateWirelessGateway` pour configurer les paramètres de balisage. Pour configurer les paramètres, vous devez supprimer la passerelle, puis spécifier les paramètres lors de l’ajout de votre passerelle à l’aide de l’opération API `CreateWirelessGateway`.
```
aws iotwireless get-wireless-gateway \
--identifier "12345678-a1b2-3c45-67d8-e90fa1b2c34d" \
--identifier-type WirelessGatewayId
```
L’exécution de cette commande renvoie des informations sur votre passerelle et les paramètres de balisage.
# Configuration des sous-bandes et des capacités de filtrage de votre passerelle
Les passerelles LoRaWAN exécutent un logiciel [LoRa Basics Station](https://doc.sm.tc/station) qui permet aux passerelles de se connecter à AWS IoT Core for LoRaWAN Pour se connecter à AWS IoT Core for LoRaWAN, votre passerelle LoRa interroge d’abord le serveur CUPS pour le point de terminaison LNS, puis établit une connexion de données WebSockets avec ce point de terminaison. Une fois la connexion établie, les trames de liaison montante et descendante peuvent être échangées via cette connexion.
## Filtrage des trames de données LoRa reçues par la passerelle
Une fois que votre passerelle LoRaWAN a établi une connexion avec le point de terminaison, AWS IoT Core for LoRaWAN répond par un message `router_config` spécifiant un ensemble de paramètres pour la configuration de la passerelle LoRa, y compris les paramètres de filtrage `NetID` et `JoinEui`. Pour plus d’informations sur le `router_config` et sur la manière dont une connexion est établie avec le serveur de réseau LoRaWAN (LNS), veuillez consulter la section [Protocole LNS](https://doc.sm.tc/station/tcproto.html).
```
{
"msgtype" : "router_config"
"NetID" : [ INT, .. ]
"JoinEui" : [ [INT,INT], .. ] // ranges: beg,end inclusive
"region" : STRING // e.g. "EU863", "US902", ..
"hwspec" : STRING
"freq_range" : [ INT, INT ] // min, max (hz)
"DRs" : [ [INT,INT,INT], .. ] // sf,bw,dnonly
"sx1301_conf": [ SX1301CONF, .. ]
"nocca" : BOOL
"nodc" : BOOL
"nodwell" : BOOL
}
```
Les passerelles transportent les données des appareils LoRaWAN vers et depuis le LNS, généralement via des réseaux à large bande passante tels que Wi-Fi, Ethernet ou cellulaire. Les passerelles captent généralement tous les messages et transmettent le trafic qui leur parvient à AWS IoT Core for LoRaWAN. Toutefois, vous pouvez configurer les passerelles pour filtrer une partie du trafic de données de l’appareil, ce qui permet de préserver l’utilisation de la bande passante et de réduire le flux de trafic entre la passerelle et le réseau LNS.
Pour configurer votre passerelle LoRa afin de filtrer les trames de données, vous pouvez utiliser les paramètres `NetID` et `JoinEui` dans le message `router_config`. `NetID` est une liste de valeurs NetID acceptées. Toute trame de données LoRa contenant une trame de données autre que celles répertoriées sera supprimée. `JoinEui` est une liste de paires de valeurs entières codant des plages de valeurs JoineUI. Les trames de demande d’adhésion seront supprimées par la passerelle sauf si le champ `JoinEui` du message se situe dans la plage [BegeUI, EndeUI].
## Canaux de fréquence et sous-bandes
Pour les régions RF US915 et AU915, les appareils sans fil ont le choix entre 64 canaux de 125 kHz et 8 canaux de liaison montante de 500 kHz pour accéder aux réseaux LoRaWAN via les passerelles LoRa. Les canaux de fréquence de liaison montante sont divisés en 8 sous-bandes, chacune avec 8 canaux de 125 kHz et un canal de 500 kHz. Pour chaque passerelle normale de la région AU915, une ou plusieurs sous-bandes seront prises en charge.
Certains appareils sans fil ne peuvent pas passer d’une sous-bande à l’autre et utiliser les canaux de fréquence d’une seule sous-bande lorsqu’ils sont connectés à AWS IoT Core for LoRaWAN. Pour que les paquets de liaison montante provenant de ces appareils soient transmis, configurez les passerelles LoRa pour utiliser cette sous-bande particulière. Pour les passerelles situées dans d’autres régions RF, telles que l’EU868, cette configuration n’est pas requise.
## Configurez votre passerelle pour utiliser le filtrage et les sous-bandes à l’aide de la console
Vous pouvez configurer votre passerelle pour utiliser une sous-bande particulière et également activer la capacité de filtrer les trames de données LoRa. Pour spécifier ces paramètres à l’aide de la console :
1. Accédez à la page [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/gateways)**Passerelles** de la AWS IoT console et choisissez **Ajouter une passerelle**.
1. Spécifiez les détails de la passerelle, tels que l’**interface utilisateur de la passerelle**, la **bande de fréquence (RFRegion)** et un **nom** et une **description** facultatifs, et choisissez d’associer ou non un AWS IoT élément à votre passerelle. Pour plus d’informations sur l’ajout d’une passerelle, veuillez consulter [Ajouter une passerelle à l’aide de la console](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console).
1. Dans la section de **configuration LoRaWAN**, vous pouvez spécifier les sous-bandes et les informations de filtrage.
+ `SubBands` : pour ajouter une sous-bande, choisissez **Ajouter une sous-bande et spécifiez** une liste de valeurs entières indiquant quelles sous-bandes sont prises en charge par la passerelle. Le paramètre `SubBands` ne peut être configuré que dans les modèles `RfRegion` US915 et AU915 et doit avoir des valeurs dans la plage `[1,8]` de l’une de ces régions prises en charge.
+ `NetIdFilters` : pour filtrer les trames de liaison montante, choisissez **Ajouter NetID** et spécifiez une liste de valeurs de chaîne utilisées par la passerelle. Le NetID de la trame de liaison montante entrante provenant du périphérique sans fil doit correspondre à au moins l’une des valeurs répertoriées, sinon la trame est supprimée.
+ `JoinEuiFilters` : choisissez **Ajouter une plage JoinEui** et spécifiez une liste de paires de valeurs de chaîne qu’une passerelle utilise pour filtrer les trames LoRa. La valeur JoinEUI spécifiée dans la trame de la demande d’adhésion depuis le périphérique sans fil doit être comprise dans la plage d’au moins une des valeurs JoinEuiRange, chacune répertoriée sous la forme d’une paire de [BegEui, EndEui], sinon la trame est supprimée.
1. Vous pouvez ensuite continuer à configurer votre passerelle en suivant les instructions décrites dans [Ajouter une passerelle à l’aide de la console](lorawan-onboard-gateway-add.md#lorawan-onboard-gateway-console).
Après avoir ajouté une passerelle, sur la page [AWS IoT Core for LoRaWAN](https://console.aws.amazon.com/iot/home#/wireless/gateways)**Passerelles** de la console AWS IoT, si vous sélectionnez la passerelle que vous avez ajoutée, vous pouvez voir les filtres `SubBands` et `NetIdFilters`, ainsi que `JoinEuiFilters` dans la section **Détails spécifiques au LoRaWAN** de la page des détails de la passerelle.
## Configurez votre passerelle pour utiliser le filtrage et les sous-bandes à l’aide de l’API
Vous pouvez utiliser l’API [CreateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateWirelessGateway.html) que vous utilisez pour créer une passerelle afin de configurer les sous-bandes que vous souhaitez utiliser et d’activer la fonctionnalité de filtrage. À l’aide de l’API `CreateWirelessGateway`, vous pouvez spécifier les sous-bandes et les filtres dans le cadre des informations de configuration de la passerelle que vous fournissez à l’aide du champ `LoRaWAN`. Ce qui suit montre le jeton de demande qui inclut ces informations.
```
POST /wireless-gateways HTTP/1.1
Content-type: application/json
{
"Arn": "arn:aws:iotwireless:us-east-1:400232685877aa:WirelessGateway/
a11e3d21-e44c-471c-afca-6716c228336a",
"Description": "Using my first LoRaWAN gateway",
"LoRaWAN": {
"GatewayEui": "a1b2c3d4567890ab",
"JoinEuiFilters": [
["0000000000000001", "00000000000000ff"],
["000000000000ff00", "000000000000ffff"]
],
"NetIdFilters": ["000000", "000001"],
"RfRegion": "US915",
"SubBands": [2]
},
"Name": "myFirstLoRaWANGateway"
"ThingArn": null,
"ThingName": null
}
```
Vous pouvez également utiliser l’API [UpdateWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessGateway.html) pour mettre à jour les filtres, mais pas les sous-bandes. Si les valeurs `JoinEuiFilters` et `NetIdfilters` sont nulles, cela signifie qu’il n’y a pas de mise à jour pour les champs. Si les valeurs ne sont pas nulles et que des listes vides sont incluses, la mise à jour est appliquée. Pour obtenir les valeurs des champs que vous avez spécifiés, utilisez l’API [GetWirelessGateway](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessGateway.html).