4.5. Qualité GPS (Non disponible en mode legacy) 18
4.6. Compteur UL 18
4.7. Compteur DL 18
4.8. Niveau batterie 18
4.9. RSSI 18
4.10. SNR 18
5. CONFIGURATION DU PRODUIT 19
5.1. Connecter le produit à un ordinateur 19
5.2. Mode commande 20
5.3. Commande AT 21
5.4. Description des registres 22
6. MISE À JOUR PRODUIT 29
7. HISTORIQUE DU DOCUMENT 29
2
Pageof 55
Page 3
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
ENGLISH 30
INFORMATIONS 31
DISCLAIMER 31
TECHNICAL SUPPORT 31
INTRODUCTION 33
ENVIRONMENTAL RECOMMENDATIONS 34
WARNINGS 34
RECOMMENDATIONS REGARDING USE 35
DISPOSAL OF WASTE BY USERS IN PRIVATE HOUSEHOLDS WITHIN THE EUROPEAN UNION 35
1. INTRODUCING THE DEVICE 36
1.1. Description 36
1.2. Mechanical features 36
1.3. Technical specifications 37
1.4. Charging the FTD 37
2. DEVICE DESCRIPTION 38
2.1. User interface 38
2.2. Button description 38
2.3. Sensors description 38
3. SCREEN DESCRIPTION 39
3.1. Start Screen 39
3.2. Join Screen 39
3.3. Uplink/Downlink screen 40
3.4. GPS screen 41
3.5. PER (Packet Error Rate) screen 41
3.6. Downlink screen 42
4. DECODING THE PAYLOAD 42
4.1. Status 42
4.2. Temperature 43
4.3. Latitude 43
4.4. Longitude 43
4.5. GPS quality (Not available in Legacy mode) 44
4.6. UL counter 44
4.7. DL counter 44
4.8. Battery level 44
4.9. RSSI 44
4.10. SNR 44
5. DEVICE CONFIGURATION 45
5.1. Connecting the device to a computer 45
5.2. Command mode 46
5.3. AT command 47
5.4. Register description 48
6. DEVICE UPDATES 55
7. DOCUMENT HISTORY 55
FR
3
Pageof 55
Page 4
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
FR
FRANÇAIS
4
Pageof 55
Page 5
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
INFORMATIONS
Information document
Titre
Sous-titre
Type de document
Version
Ce document s’applique aux produits suivants :
NomRéférenceVersion Firmware
FIELD TEST DEVICE - LoRaWAN Europe
FIELD TEST DEVICE
LoRaWAN Europe
Mode d'emploi
V1.2.3
A partir de : ARF8123AAAPP A partir de : V01.00.07
RTU A partir de : V01.02.00
AVERTISSEMENT
Ce document et l’utilisation de toute information qu’il contient, est soumis à l’acceptation des termes et conditions adeunis. Ils peuvent être
téléchargés à partir www.adeunis.com.
FR
Adeunis ne donne aucune garantie sur l’exactitude ou l’exhaustivité du contenu de ce document et se réserve le droit d’apporter des modifications
aux spécifications et descriptions de produit à tout moment sans préavis.
Adeunis est une marque déposée dans les pays de l’UE et autres.
SUPPORT TECHNIQUE
Site web
Notre site Web contient de nombreuses informations utiles : informations sur les produits et accessoires, guides d’utilisation, logiciel de configuration et de documents techniques qui peuvent être accessibles 24h/24.
Si vous avez des problèmes techniques ou ne pouvez pas trouver les informations requises dans les documents fournis, contactez notre support
technique via notre site Web, rubrique « Support Technique ». Cela permet de s’assurer que votre demande soit traitée le plus rapidement possible.
Informations utiles lorsque vous contactez notre support technique
Lorsque vous contactez le support technique merci de vous munir des informations suivantes :
• Type de produit (par exemple Field Test Device)
• Version du firmware (par exemple V1.0.0)
• Description claire de votre question ou de votre problème
• Vos coordonnées complètes
5
Pageof 55
Page 6
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
Déclaration UE de Conformité
Nous
adeunis
283 rue LOUIS NEEL
FR
38920 Crolles, France
04.76.92.01.62
www.adeunis.com
Déclarons que la DoC est délivrée sous notre seule responsabilité et fait partie du produit suivant :
Modèle produit : FIELD TEST DEVICE LoRaWAN 868
Référence : ARF8123AA
Objet de la déclaration :
L’objet de la déclaration décrit ci-dessus est conforme à la législation d’harmonisation de l’Union
applicable :
Directive 2014/53/UE (RED)
Les normes harmonisées et les spécifications techniques suivantes ont été appliquées :
Titre : Date du standard/spécification
EN 300 220-2 V3.1.1 2017/02
EN 301 489-1 V2.1.1 2016/11
EN 301 489-3 V2.1.0 2016/09
EN 60950-1 2006 +A11:2009 +A1:2010 +A12:2011 +A2:2013
EN 62311 2008
6 décembre 2017 Monnet Emmanuel, Responsable Certification
6
Pageof 55
Page 7
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
INTRODUCTION
Tous les droits de ce manuel sont la propriété exclusive de ADEUNIS. Tous droits réservés. La copie de ce manuel (sans l’autorisation écrite du
propriétaire) par impression, copie, enregistrement ou par tout autre moyen, la traduction de ce manuel (complète ou partielle) pour toute autre
langue, y compris tous les langages de programmation, en utilisant n’importe quel dispositif électrique, mécanique, magnétique, optique, manuel
ou autres méthodes, est interdite.
ADEUNIS se réserve le droit de modifier les spécifications techniques ou des fonctions de ses produits, ou de cesser la fabrication de l’un de ses
produits, ou d’interrompre le support technique de l’un de ses produits, sans aucune notification écrite et demande expresse de ses clients, et de
s’assurer que les informations à leur disposition sont valables.
Les logiciels de configurations et programmes ADEUNIS sont disponibles gratuitement dans une version non modifiable. ADEUNIS ne peut accorder aucune garantie, y compris des garanties sur l’adéquation et l’applicabilité à un certain type d’applications. Dans aucun cas le fabricant, ou
le distributeur d’un programme ADEUNIS, ne peut être tenu pour responsable pour tous les dommages éventuels causés par l’utilisation dû dit
programme. Les noms des programmes ainsi que tous les droits d’auteur relatifs aux programmes sont la propriété exclusive de ADEUNIS. Tout
transfert, octroi de licences à un tiers, crédit-bail, location, transport, copie, édition, traduction, modification dans un autre langage de programmation ou d’ingénierie inversée (retro-ingénierie) est interdit sans l’autorisation écrite et le consentement de ADEUNIS.
Adeunis
283, rue Louis Néel
38920 Crolles
France
FR
7
Pageof 55
Page 8
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RECOMMANDATIONS ENVIRONNEMENTALES
Tous les matériaux d’emballage superflus ont été supprimés. Nous avons fait notre possible afin que l’emballage soit facilement séparable en
trois types de matériaux : carton (boîte), polystyrène expansible (matériel tampon) et polyéthylène (sachets, feuille de protection en mousse).
Votre appareil est composé de matériaux pouvant être recyclés et réutilisés s’il est démonté par une firme spécialisée. Veuillez observer les règlements locaux sur la manière de vous débarrasser des anciens matériaux d’emballage, des piles usagées et de votre ancien appareil.
FR
AVERTISSEMENTS
Valables pour les produits FIELD TEST DEVICE - LoRaWAN Europe : ARF8123AA
Lire les instructions dans le manuel.
La sécurité procurée par ce produit n’est assurée que pour un usage conforme à sa destination.
La maintenance ne peut être effectuée que par du personnel qualifié.
Attention, ne pas installer l’équipement près d’une source de chaleur ou près d’une source d’humidité.
Attention, lorsque l’équipement est ouvert, ne pas réaliser d’opérations autres que celles prévues dans cette notice.
Attention : ne pas ouvrir le produit, risque de choc électrique.
Attention : pour votre sécurité, il est impératif qu’avant toute intervention technique sur l’équipement celui-ci soit mis hors tension.
Attention : pour votre sécurité, le circuit d’alimentation du produit doit être de type TBTS (très basse tension de sécurité) et doit être
des sources à puissance limitée.
Attention : lorsque l’antenne est installée à l’extérieur, il est impératif de connecter l’écran du câble à la terre du bâtiment. Il est recommandé d’utiliser une protection contre la foudre. Le kit de protection choisi doit permettre une mise à la terre du câble coaxial (ex : parafoudre
coaxial avec mise à la terre du câble à différents endroits au niveau de l’antenne en bas du pylône et à l’entrée, ou juste avant de pénétrer dans
le local).
Il faut que le produit soit muni d’un dispositif de sectionnement pour pouvoir couper l’alimentation. Celui-ci doit être proche de l’équipement.
Tout branchement électrique du produit doit être muni d’un dispositif de protection contre les surcharges et les courts-circuits.
8
Pageof 55
Page 9
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RECOMMANDATIONS D’USAGE
• Avant d’utiliser le système, vérifiez si la tension d’alimentation figurant dans son manuel d’utilisation correspond à votre source. Dans la
négative, consultez votre fournisseur.
• Placez l’appareil contre une surface plane, ferme et stable.
• L’appareil doit être installé à un emplacement suffisamment ventilé pour écarter tout risque d’échauffement interne et il ne doit pas être
couvert avec des objets tels que journaux, nappes, rideaux, etc.
• L’antenne de l’appareil doit être dégagée et distante de toute matière conductrice de plus de 10 cm.
• L’appareil ne doit jamais être exposé à des sources de chaleur, telles que des appareils de chauffage.
• Ne pas placer l’appareil à proximité d’objets enflammés telles que des bougies allumées, chalumeaux, etc.
• L’appareil ne doit pas être exposé à des agents chimiques agressifs ou solvants susceptibles d’altérer la matière plastique ou de corroder
les éléments métalliques.
Élimination des déchets par les utilisateurs dans les ménages privés au sein de l’Union Européenne
Ce symbole sur le produit ou sur son emballage indique que ce produit ne doit pas être jeté avec vos autres ordures ménagères. Au lieu
de cela, il est de votre responsabilité de vous débarrasser de vos déchets en les apportant à un point de collecte désigné pour le recyclage des
appareils électriques et électroniques. La collecte et le recyclage séparés de vos déchets au moment de l’élimination contribueront à conserver les
ressources naturelles et à garantir un recyclage respectueux de l’environnement et de la santé humaine. Pour plus d’informations sur le centre de
recyclage le plus proche de votre domicile, contactez la mairie la plus proche, le service d’élimination des ordures ménagères ou le magasin où
vous avez acheté le produit.
FR
Attention : Il y a un risque d’explosion si les batteries sont remplacées par une référence non correcte. Jeter les batteries suivant les
instructions d’usages. Lors du changement des batteries, le produit doit être proprement et correctement remonté.
IMPORTANT pour la Suisse : l’annexe 4.10 du standard SR 814.013 doit être appliquée pour les batteries
9
Pageof 55
Page 10
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
1. PRÉSENTATION DU PRODUIT
1.1. Description
Le Field Test Device (FTD) d’Adeunis est un produit compatible LoRaWAN V1.0 Class A. Ce n’est pas un produit point à point et il ne peut pas
être utilisé dans ce sens. Cela signifie qu’il doit être utilisé sur un réseau opéré privé ou public.
Le produit Field Test Device LoRaWAN d’Adeunis est un produit prêt à l’emploi, qui permet de communiquer avec tous les opérateurs de réseau
FR
utilisant le protocole LoRaWAN V1.0. Le système permet de transmettre, de recevoir une trame radio et de voir instantanément le résultat.
Équipé d’un large écran LCD, vous pouvez visualiser plusieurs informations de fonctionnement du réseau utilisé (Uplink, Downlink, SF, PER ...) et
également des informations de capteurs (coordonnées GPS, température, niveau de batterie ...).
Ce produit est particulièrement adapté pour la validation d’application tel que les capteurs communicants, le tracking, le smart building, la télé
relève de compteur, la sécurité et le M2M.
Grâce à sa batterie rechargeable, le FTD permet plusieurs heures de fonctionnement et peut être rechargé avec un chargeur de téléphone portable micro-usb standard.
Débit série115.2 kbps
ParitéNone
Nombre de données8
Stop bit1
Température de fonctionnement-30°C / +70°C
Par commandes AT
(voir chapitre dédié pour obtenir la liste complète des commandes AT disponible)
1.4. Chargement du FTD
Le produit est équipé d’une batterie rechargeable. Dès que le produit est connecté à un chargeur USB ou à la prise USB d’un ordinateur, il démarre
automatiquement sa charge ; même si le commutateur ON/OFF est positionné sur OFF (ce fonctionnement est identique à celui d’un téléphone
mobile). Le produit peut être utilisé pendant qu’il se recharge.
Pendant le chargement, l’indicateur de charge est rouge. Lorsque la charge est terminée, l’indicateur devient vert.
Figure 1 : Produit en chargeFigure 2 : Produit chargé
Si la batterie est complètement vide, il sera nécessaire de recharger le produit pendant 6 heures pour obtenir une charge complète.
11
Pageof 55
Page 12
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
2. DESCRIPTION PRODUIT
2.1. Interface utilisateur
FR
Ecran LCD
Bouton poussoir 1
2.2. Description des boutons
Interface opération
Bouton poussoir 1
Commutateur ON/OFF
Indicateur de charge
Bouton poussoir 2
Figure 3 : Vue face
Ce bouton permet de réaliser une transmission radio en mode manuel.
Dans le menu PER, un appui long permet une remise à zéro des compteurs.
Connecteur Micro USB
Figure 4 : Vue dessous
Ce bouton permet la gestion de l’écran LCD.
Bouton poussoir 2
Commutateur ON/OFF
Connecteur micro-USB
Indicateur de chargeLa LED de charge donne l’état de charge du produit (voir paragraphe 1.4).
• Lorsque le rétro-éclairage du LCD est éteint, un appui permet d’activer le rétro-éclairage.
• Lorsque le rétro-éclairage du LCD est allumé, chaque appui permet de faire défiler les différents
écrans disponibles sur le produit.
Le commutateur ON/OFF permet de démarrer ou d’éteindre le produit. Le basculement du commutateur vers la droite démarre le produit.
Le connecteur micro-USB permet la charge du produit (voir paragraphe 1.4) ou la configuration du
produit (voir paragraphe 3).
2.3. Description des capteurs
Le produit dispose également de deux capteurs embarqués : un capteur de température et un accéléromètre. Ce dernier envoie une trame lors
de la détection d’une importante vibration (en secouant l’appareil par exemple).
12
Pageof 55
Page 13
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
3. DESCRIPTION DES ECRANS
L’écran LCD du produit est divisé en plusieurs écrans :
• L’écran de DÉMARRAGE (Affichage des versions de firmware) - Uniquement à la mise sous tension
• L’écran de JOIN - Uniquement à la mise sous tension et en sortie du mode commande
• L’écran d’UPLINK/DOWNLINK
• L’écran de GPS
• L’écran de PER (Packet Error Rate).
• L’écran de DOWNLINK
Les icônes suivant sont présent sur tous les écrans du produit.
ItemIcôneDescription
Aucune icôneLe GPS est désactivé
Statut GPS
(Premier à gauche)
Le GPS n’est pas synchronisé
Le GPS est synchronisé
FR
Température
(Troisième à gauche)
Batterie
(Dernière à gauche)
Température en °C
Niveau de batterie
Produit en charge
3.1. Ecran Démarrage
Le démarrage du produit est fait au moyen du commutateur ON/OFF situé sur la partie inférieure du produit. Dès la mise sous tension, l’écran LCD
du produit s’allume et affiche l’écran de démarrage. L’écran de démarrage s’affiche les 2 versions de firmware du produit pendant une période de
quelques secondes.
Version Firmware Applicatif
Version Firmware RTU
Figure 5 : Version Firmware
Note : Si le produit ne démarre pas, il se peut que la batterie ne soit pas suffisamment chargée. Connectez alors le produit sur un chargeur USB.
Lorsque la batterie est totalement vide, il se peut que même connecté le produit ne démarre pas. Veuillez attendre quelques minutes pour que le
produit puisse être utilisé.
3.2. Ecran Join
Lorsque le produit est configuré en mode OTAA (Over The Air Activation) mode par défaut, le produit démarre une phase de Join Request (JRx) et
indique la fréquence, le SF et la puissance à laquelle la requête est réalisée. Lorsque le produit reçoit un Join Accept du réseau, le produit affiche
(JA) et le produit bascule sur l’affiche principal du produit (Uplink/Downlink).
Barre de statuts
Figure 6 : Phase de Join Request
Figure 7 : Phase de Join Accept
13
Pageof 55
Page 14
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
Les requêtes sont identifiées «JR» suivi d’un numéro indiquant le nombre de requête effectuées. Cette information est suivi de la fréquence
d’émission à laquelle la requête est réalisée.
Note : Si aucun réseau n’est disponible, les «Join Request» seront réalisées en continu, et le produit restera sur cet écran.
ItemIcôneDescription
Aucune IcôneLa phase de JOIN est terminée, le produit est fonctionnel sur le réseau
Le produit est en phase JOIN, il envoie des demandes de connexion au réseau
FR
Statut RF
(Deuxième à gauche)
3.3. Ecran Uplink/Downlink
Cet écran est affiché lorsque le produit a terminé sa phase de Join en mode OTAA ou lorsque le produit est configuré en mode ABP (Activation
By Personalisation).
Les informations d’émission d’Uplink et de Downlink sont affichées sur l’écran LCD.
La première ligne indique les informations de la trame d’Uplink «ULx» avec x le numéro et la fréquence de la trame d’émission lors des répétitions. La deuxième ligne indique le SF et la puissance utilisée.
La troisième ligne indique les informations de la trame de Downlink «DLx» avec x le numéro et la fréquence de la fenêtre de réception. La
dernière ligne indique le SF, le niveau de RSSI et le SNR de la trame reçue.
Barre de statuts
Informations
d’émission
Figure 8 : Ecran principale
ItemIcôneDescription
Aucune icôneAucune transmission radio en cours
Statut Transmission
(Deuxième à gauche)
Information d’Uplink
(Ligne Noire)
Information d’Uplink
(Ligne Blanche)
Information de Downlink
(Ligne Noire)
Information de Downlink
(Ligne Blanche)
Les informations de Downlink affichées sur le produit concernent une trame de Downlink envoyée depuis un réseau LoRaWAN. Si aucune information n’est présente dans cette partie, cela ne signifie pas que le produit ne fonctionne pas sur le réseau mais uniquement qu’il n’a pas reçu
d’information en provenance du réseau. Pour valider le lien montant (envoi d’une trame du produit vers le réseau), il est nécessaire d’utiliser une
interface permettant de lire les trames du réseau (exemple : back-end ou application).
Le produit peut être configuré soit en mode CONFIRMED soit en MODE UNCONFIRMED (voir paragraphe 5.4). Dans le mode CONFIRMED, la
trame de confirmation permet d’obtenir les informations de Downlink. Dans le mode UNCONFIRMED, ces informations ne seront pas automatiquement affichées.
Une transmission manuelle a été déclenchée (cycle d’émission en cours)
Une transmission périodique a été déclenchée (cycle d’émission en cours)
Affichage du nombre de répétitions de trame d’Uplink (UL1 à UL8), ainsi que de la
fréquence d’envoi de la trame avec une précision au dixième.
Affichage du SF utilisé ainsi que la puissance d’émission de la trame.
Affichage du numéro de la fenêtre d’écoute du produit (DL1 ou DL2), ainsi que de la
fréquence de réception de la trame avec une précision au dixième.
Affichage du SF, du RSSI et du SNR de la dernière trame reçue.
14
Pageof 55
Page 15
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
3.4. Ecran GPS
Cet écran est accessible par un appui court sur le bouton poussoir 2 après le menu principal. Il permet de visualiser les informations de fonctionnement du module GPS, ainsi que le positionnement GPS du produit.
Barre de statuts
Coordonnées
GPS
Figure 9 : Ecran GPS
ItemIcôneDescription
Nombre de Satellites
(Deuxième à gauche)
Signal GPS
(Troisième à gauche)
SAT xxIndicateur du nombre de satellites reçus par le produit
Indicateur du niveau de qualité du signal GPS
1 barre : réception faible
2 barres : réception moyenne
3 barres : réception bonne
FR
LATITUDEAffichage de la coordonnée de latitude en degrés, minutes, secondes
LONGITUDEAffichage de la coordonnée de longitude en degrés, minutes, secondes
Lorsque le GPS n’a pas encore «réalisé de fixe», aucune information de latitude et de longitude ne s’affiche sur l’écran et l’icône d’information
indique que le GPS n’est pas synchronisé.
Figure 10 : Ecran GPS (Pas de synchro)
Si le produit perd la synchronisation avec le GPS, les informations dans cet écran ne seront plus disponibles. Il n’y a pas de mémorisation de la
dernière position reçue.
3.5. Écran PER (Packet Error Rate)
Ce menu est accessible par un appui court sur le bouton poussoir 2 après le menu GPS. Il permet d’évaluer la qualité du lien radio entre le
produit et le réseau.
Barre de statuts
Compteurs
de trames
Figure 11 : Ecran PER
15
Pageof 55
Page 16
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
L’écran affiche :
• Le nombre de trames envoyées (UL COUNT), y compris les répétitions
• Le nombre de trames reçues (DL COUNT)
• Le Packet Error Rate (PER) en pourcentage
La mesure du PER est réalisée en comparant le nombre de trames émises par rapport au nombre de trames reçues :
• PER (%) = 100 - (( DL_COUNT / UL_COUNT) * 100)
FR
3.6. Écran Downlink
Ce menu est accessible par un appui court sur le bouton poussoir 2 après le menu PER. Il permet de visualiser une trame de downlink envoyée
depuis le réseau vers le produit. Cette trame est affichée en caractère ASCII. Les codes non imprimable sont remplacés par un point.
Barre de statuts
Zone d’affichage
de la trame
Figure 12 : Ecran Downlink
L’écran permet un affichage maximum de 51 caractères (17 caractères par ligne sur 3 lignes). Si la taille des données est supérieur à 51 octets, le
produit n’affichera pas les derniers octets.
4. DÉCRYPTAGE DU PAYLOAD
La taille du payload du Field Test Device peut varier en fonction des informations envoyées. Le premier octet permet d’identifier la présence des
informations contenues dans le payload. Les informations seront toujours présentes dans l’ordre indiqué dans le tableau ci-après.
Exemple de payload reçu : BF1B45159690005534502720200FC95207
Cet exemple sera utilisé pour expliquer le décryptage du payload.
1
06Déclenchement de l’émission par l’accéléromètre0 ou 1
15Déclenchement de l’émission par appui sur le bouton poussoir 10 ou 1
BF
0 : Donnée absente du payload
1 : Donnée présente dans le payload
14Présence de l’information GPS0 ou 1
13Présence du compteur de trame d’Uplink0 ou 1
12Présence du compteur de trame de Downlink0 ou 1
11Présence de l’information du niveau de batterie0 ou 1
10Présence de l’information RSSI et SNR0 ou 1
1
7Présence de l’information de température0 ou 1
16
Pageof 55
Page 17
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
4.2. Température
HexBinaireN°Octet CommentairesValeur
1B
Aide au décodage de la température
• Pour une température positive (bit de signe = 0) : Valeur T°C = 16 + 8 +2 + 1 = +27°C
• Pour une température négative (bit de signe = 1) : Valeur T°C = (64+32+16+4)-128 = -12°C
7..4Codage BCD de la partie entière des degrés (dixième de degré)45°15,9820
3..0Codage BCD de la partie entière des degrés (unité de degré)45°15,9820
7..4Codage BCD de la partie entière des minutes (dixième de minutes)45°15,9820
3..0Codage BCD de la partie entière des minutes (unité de minutes)45°15,9820
7..4Codage BCD de la partie décimale (dixième)45°15,9820
3..0Codage BCD de la partie décimale (centième)45°15,9620
7..4Codage BCD de la partie décimale (millième)45°15,9890
3...1Non utilisé
0Codage de l’hémisphère
0 : Nord
1 : Sud
FR
Note : la valeur exprimée dans le payload est en degrés, minutes, fraction de secondes. Une conversion en degrés, minute, secondes doit être
réalisée pour comparer avec les coordonnées affichées sur l’écran LCD du produit.
4.4. Longitude
HexN°BitCommentairesValeur
00
53
45
00
Note : la valeur exprimée dans le payload est en degrés, minutes, fraction de secondes. Une conversion en degrés, minute, secondes doit être
réalisée pour comparer avec les coordonnées affichées sur l’écran LCD du produit.
4
7..4Codage BCD de la partie entière des degrés (centième de degré)005°34,500
3..0Codage BCD de la partie entière des degrés (dixième de degré)005°34,500
7..4Codage BCD de la partie entière des degrés (unité de degré)005°34,500
3..0Codage BCD de la partie entière des minutes (dixième de minutes)005°34,500
7..4Codage BCD de la partie entière des minutes (unité de minutes)005°34,500
3..0Codage BCD de la partie décimale (dixième)005°34,500
7..4Codage BCD de la partie décimale (centième)005°34,500
3...1Non utilisé
0Codage de l’hémisphère
0 : Est
1 : Ouest
17
Pageof 55
Page 18
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
4.5. Qualité GPS (Non disponible en mode legacy)
HexValeurN°BitCommentairesValeur
27
2
73..0Nombre de satellites1 ... 16
5
7..4Échelle de réception
FR
Le MSB de l’octet permet d’avoir le niveau de qualité du signal GPS
Le LSB de l’octet permet d’avoir le nombre de satellites vus par produit
4.6. Compteur UL
HexDécimalN°OctetCommentairesValeur
203261Compteur de trame d’Uplink0 ... 255
Attention : Ce compteur n’est pas le compteur de trame de la stack LoRaWAN, mais un compteur de trame interne. Il n’y a donc pas de corré-
lation entre ce compteur et celui que vous pouvez visualiser sur le réseau.
1 : Bonne
2 : Moyenne
3 : Mauvaise
4.7. Compteur DL
HexDécimalN°OctetCommentairesValeur
203271Compteur de trame de Downlink0 ... 255
Attention : Ce compteur n’est pas le compteur de trame de la stack LoRaWAN, mais un compteur de trame interne. Il n’y a donc pas de corré-
lation entre ce compteur et celui que vous pouvez visualiser sur le réseau.
4.8. Niveau batterie
HexDécimalN°OctetCommentairesValue
0F
C9
8
1Valeur MSB du niveau de batterie (en mV)4041
2Valeur LSB du niveau de batterie (en mV)
4.9. RSSI
HexDécimalN°OctetCommentairesValeur
528291Niveau de RSSI en valeur absolue0 ... 255
Dans l’exemple la valeur du RSSI est de -82dBm
4.10. SNR
HexDecimalN°OctetCommentairesValeur
0707101Niveau de SNR exprimé en valeur complément à 2-125 ... 125
Dans l’exemple la valeur du SNR est de 7dB
Pageof 55
18
Page 19
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
5. CONFIGURATION DU PRODUIT
La configuration du produit se fait au moyen du connecteur USB. Cette connexion permet de communiquer avec le produit par un port com virtuel
et d’envoyer des commandes AT pour modifier les paramètres du produit.
5.1. Connecter le produit à un ordinateur
Connectez le Field Test Device (FTD) sur une entrée USB d’un ordinateur. Le produit FTD possède un connecteur micro USB Type B.
Lors de la connexion le produit doit être reconnu par l’ordinateur comme un périphérique Virtual Com Port (VCP).
Sous Windows : Une vérification du bon fonctionnement de la reconnaissance du produit par l’ordinateur peut être obtenue en consultant le
gestionnaire de périphérique. Vous devez voir apparaître lors de la connexion un périphérique série USB avec un numéro de port COM associé.
FR
Si vous ne voyez aucun périphérique de ce type, vous devez installer le driver USB pour ce périphérique, disponible sur notre site internet :
https://www.adeunis.com/en/produit/ftd-868-915-2/
Sélectionnez :
• DRIVER - stsw-stm32102_vcpdriver
19
Pageof 55
Page 20
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
5.2. Mode commande
Utiliser un terminal port COM pour communiquer avec le produit. Nous utilisons le soft terminal port COM HERCULES disponible en téléchargement
gratuit à l’adresse suivante : https://www.hw-group.com/products/hercules/index_en.html
• Sous Hercules, sélectionner l’onglet «Serial», puis configurer le port série avec les paramètres série suivant :
ParamètresValeur
FR
Débit 115 200 bps
ParitéAucune
Data8
Stop Bit1
• Sélectionner le port série sur lequel le périphérique s’est créé sous Windows (Name).
• Cliquer sur le bouton «Open» pour ouvrir le port série.
NOTE INFORMATION : Si le port com est correctement ouvert, Hercules vous indique «Serial port COM3 opened».
Sinon vous avez «Serial port com opening error», soit le port com est déjà ouvert sur une autre application, soit il n’existe pas.
Switch ON/OFF
• Mettre le produit sous tension, en basculant l’interrupteur vers la droite.
Vue dessous
Vous devez envoyer une trame spécifique pour passer le produit en mode de configuration.
Trame exprimée en hexadécimal : 0xFF 0xFF 0xFF 0xFF 0xFF 0x2B 0x2B 0x2B
Pour Hercules, cette trame doit être entrée dans l’une des 3 lignes disponibles en bas. Le format hexadécimal doit être exprimé avec un «$» dans
ce logiciel. Ce qui donne la trame suivante : $FF$FF$FF$FF$FF$2B$2B$2B
20
Pageof 55
Page 21
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
• Envoyer la trame de passage en mode commande pour basculer le produit en mode de configuration, en cliquant sur le bouton SEND.
Après quelques secondes, vous devez voir apparaître sur le LCD du produit l’écran COMMAND MODE. Cela peut prendre un peu de temps car
le passage en mode commande ne peut être réalisé pendant un cycle d’émission.
Sur le terminal port com, vous devez également avoir un retour d’information «CM» pour Command Mode.
L’envoi de caractère sur Hercule s’affiche en magenta et la réception en noir. Si vous ne voyez pas les caractères d’envoi, c’est probablement parce
que l’ECHO n’est pas actif sur le logiciel. Activer l’option dans le menu accessible par un clic droit dans la fenêtre de visualisation.
5.3. Commande AT
Une commande débute avec les 2 caractères ASCII : « AT », suivis d’un ou plusieurs caractères et données (voir ci-après la syntaxe des commandes AT disponibles sur le modem).
Chaque commande doit se terminer par un « CR » ou « CR » «LF », les deux possibilités sont acceptées.
(CR signifie : Carriage Return, LF signifie : Line Feed)
À la réception d’une commande, le modem retourne :
• « Les données »<cr><lf>, pour une commande de lecture type ATS<n> ? , AT/S ou AT/V.
• « O » <cr><lf>, pour toutes les autres commandes lorsque celle-ci est acceptée.
• « E » <cr><lf>, s’il refuse la commande car erreur de syntaxe, commande inconnue, registre inconnu, paramètre invalide, ….
• « CM » <cr><lf>, s’il accepte l’entrée en mode commande
FR
Tableau des commandes AT :
CommandeDescriptionRéponse
ATS<n> ?Retourne le contenu du registre nSn=y avec y représentant le contenu du registre n
ATS<n>=<m>Transfert la valeur m au registre n« O » si l’opération est acceptée.
« E » si l’opération est refusée.
« W» si l’opération présente un problème de configuration.
AT/SÉdite sous forme de liste, le contenu de tous les
registres utilisateur.
AT/VRetourne la version du softwareExemple :
ATRRestaure en mémoire volatile la valeur de tous
les registres de la mémoire non volatile.
AT&WSauvegarde de la configuration actuelle en
mémoire non volatile.
AT&RSTRedémarre le produit« O » si l’opération est acceptée.
AT0Sortie du mode commande« O » si l’opération est acceptée.
ATT63 PROVIDERDéblocage registre opérateur« O » si l’opération est acceptée.
« O » si l’opération est acceptée.
« E » si l’opération est refusée.
« O » si l’opération est acceptée.
« E » si l’opération est refusée.
« E » si l’opération est refusée.
« E » si l’opération est refusée.
« E » si l’opération est refusée.
21
Pageof 55
Page 22
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
Exemple d’une suite de commandes et de réponses correspondantes telles qu’on pourrait le voir sur un terminal :
Syntaxe de la CommandeDescriptionSyntaxe de la réponse à la ligne suivante
+++Demande d’entrée en mode commandeCM
ATS221=1Demande de passage en mode d’activation
OTAA
ATS214=0018B200Changement modification APP_EUI MSBE -> Cette commande n’est pas valide (registre non
FR
ATT63 PROVIDERDéblocage registre opérateurO
ATS214=0018B200Changement modification APP_EUI MSBO
ATS215?Retourne la valeur du registre S215S200=44512451
AT&WDemande de mémorisation de l’état des
registres
ATODemande de sortie du mode commandeO
Interprétation de l’exemple ci-avant : l’utilisateur a voulu modifier le début de l’APP_EUI après avoir fait une commande non autorisée (réponse
E), un déblocage des registres a été réalisé pour modifier ce registre. Une vérification de la deuxième partie de l’APP_EUI est effectuée et une
sauvegarde des paramètres avant sortie est réalisée. Dès la sortie du produit du mode commande, le produit effectue une demande de JOIN.
O
débloqués)
O
5.4. Description des registres
A la mise sous tension le Field Test Device fonctionne selon la dernière configuration sauvegardée (configuration usine si c’est la première mise
sous tension, ou si cette configuration n’a pas été changée).
La commande de modification type ATS<n>=<m> permet de modifier le contenu des registres.
Il est impératif de sauvegarder les paramètres par la commande AT&W avant de sortir du mode commande sinon tous les changements seront
perdus.
5.4.1 Registres fonction
Liste des registres accessibles sur le produit (par défaut). Ces registres permettent de modifier le comportement du produit.
Le détail du fonctionnement de chaque registre est expliqué à la suite du tableau.
RegistreContenu
S370Format du payload0
S371Configuration GPS11
Valeur par
défaut
Commentaires
0 : Format Legacy (Démonstrateur)
1 : Format Field Test Device
0 : Aucune émission périodique
1 à 86400 (exprimé en secondes) : Émission périodique
0 : Class A non confirmé
1 : Class A confirmé
Toutes les autres valeurs sont réservées.
22
Pageof 55
Page 23
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RegistreContenu
S385Payload personnalisée0
S386Payload personnalisée - Bloc 10
S387Payload personnalisée - Bloc 20
S388Payload personnalisée - Bloc 30
S389Payload personnalisée - Bloc 40
S370 : Format du payload
Le Field Test Device (FTD) est compatible avec la version précédente du produit (appelé LoRaWAN Demonstrator). Pour modifier le format du
payload et le rendre compatible avec l’ancien produit, il est nécessaire de modifier ce registre.
Valeur par
défaut
Commentaires
0 : Désactivé
1 à 16 : Taille de la payload personnalisé
Chaque bloc permet de définir 4 octets de la payload
FR
S371 : Configuration GPS
Le fonctionnement du module GPS est complètement indépendant du firmware principal. Deux modes de fonctionnement sont disponibles :
• Mode Permanent
• Mode Périodique
En mode permanent, le GPS est toujours actif et au maximum de sa puissance (comme le GPS de votre voiture). C’est le mode le plus performant et nous recommandons de l’utiliser dans le cadre d’une utilisation où le Field Test Device doit être en déplacement (exemple : si vous
positionnez le produit dans une voiture), ou si la visibilité des satellites est mauvaise.
En mode périodique, le GPS démarre pendant une période de 5 mn au maximum de sa puissance, puis entre dans son mode périodique.
Dans ce mode, le GPS se réveille quelques dizaines de secondes toutes les 10 minutes. Le reste du temps, il se met au repos, ce qui permet de
favoriser l’autonomie du produit. Ce mode doit être choisi pour une utilisation statique (position fixe, ou déplacement très lent), ou avec une
très bonne visibilité des satellites.
L’utilisateur peut également choisir de réaliser un reset du GPS au démarrage. Cette opération permet d’effacer la mémoire du GPS et de toutes
les informations acquises précédemment. Cela peut être utile lorsque le GPS n’est pas en mesure de se synchroniser au cours de la phase de
démarrage. Effectivement, le GPS utilisera sa mémoire interne pour prévoir sa position et trouver les satellites, mais lorsque le GPS n’a pas été
utilisé pendant une longue période ou qu’il a été déplacé sur une longue distance (par exemple : voyage en avion vers un autre pays), les informations sont erronées et doivent être supprimées.
Si les coordonnées GPS sont disponibles lors de la transmission d’une trame LoRa, ces coordonnées seront incluses dans le payload. Sinon, les
octets correspondant seront supprimés et le payload sera plus court.
S380 : Période d’émission de trame
Le produit est en mesure de réaliser des émissions périodiques automatiques. La période de transmission est définie en seconde et peut être
comprise en 0 et 86400 (soit 24 heures).
Si la valeur de la période est égale à 0, alors la fonction est désactivée.
23
Pageof 55
Page 24
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
S382 : Mode ACK et Class
Le registre permet de choisir le mode de fonctionnement du produit :
• Mode Unconfirmed
• Mode Confirmed
S383 : Uplink Port
FR
Le port de communication de la trame d’Uplink peut être configuré dans ce registre. On peut choisir une valeur comprise entre 1 et 223.
S385 : Payload personnalisée
Cette option permet au produit d’émettre une trame personnalisé à la place de la payload prédéfinie du produit.
L’utilisateur peut configurer la taille de sa payload et le texte à envoyer.
Lorsque la valeur du registre est à 0, la fonction est inactive et le produit utilise le format de la payload standard.
lorsque la valeur contient une valeur, le produit envoi les caractères contenus dans les registres S386 à S389.
La taille maximale autorisée pour cette payload est de 16 octets
S386 à S389 : Payload personnalisée
Les 4 registres permettent de configurer une payload personnelle :
• Le registre S386 permet de définir les octets 1 à 4 de la trame
• Le registre S387 permet de définir les octets 5 à 8 de la trame
• Le registre S388 permet de définir les octets 9 à 11 de la trame
• Le registre S389 permet de définir les octets 12 à 16 de la trame
Les valeurs doivent être enregistrées en code hexadécimale : exemple pour le mot «TEST» --> ATS386=54455654
ATTENTION : Pour envoyer, un seul octet, vous devez compléter le bloc avec des zéros. Sinon, le produit complète lui même les blocs manquants
et vous n’obtiendrais pas le résultat voulu. Exemple avec ATS385=1 :
• ATS386=AB000000 --> Le systeme comprend la trame AB000000 et envoi le premier octet --> Vous recevrez bien AB
• ATS386=AB --> Le système comprend la trame 000000AB et envoi le premier octet --> Vos recevrez 00
Paramètre codé sur 16 caractères. Chaque registre
contient une partie de la clé.
S215LORA APP_EUI (Deuxième partie)41524632
24
Pageof 55
Page 25
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RegistreContenu
S216LORA APP_KEY (Première partie)(voir note)
S217LORA APP_KEY (Deuxième partie)(voir note)
S218LORA APP_KEY (Troisième partie)(voir note)
S219LORA APP_KEY (Quatrième partie)(voir note)
S220Activation ADR1
S221Mode d’activation1
S222LORA NWK_sKEY (Première partie)0
S223LORA NWK_sKEY (Deuxième partie)0
S224LORA NWK_sKEY (Troisième partie)0
Valeur par
défaut
Commentaires
Paramètre codé sur 16 octets. Chacun des 4 registres
contient 4 octets.
0 : Inactif
1 : Actif
0 : ABP
1 :OTAA
Paramètre codé sur 16 octets. Chacun des 4 registres
contient 4 octets.
FR
S225LORA NWK_sKEY (Quatrième partie)0
S226LORA APP_sKEY (Première partie)0
S227LORA APP_sKEY (Deuxième partie)0
S228LORA APP_sKEY (Troisième partie)0
S229LORA APP_sKEY (Quatrième partie)0
Paramètre sur 16 octets. Chacun des 4 registres
contient 4 octets.
25
Pageof 55
Page 26
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
FR
RegistreContenu
S250Configuration Canal 01
S251Configuration Canal 11
S252Configuration Canal 21
S53Configuration Canal 30
S254Configuration Canal 40
S255Configuration Canal 50
Valeur par
défaut
Commentaires
Canaux de fonctionnement obligatoire
LoRaWAN
Cette valeur ne doit pas être modifiée.
0 : Canal désactivé
Autre : Configuration utilisateur
S256Configuration Canal 60
0 : Canal désactivé
S257Configuration RX21
S260RESERVE2200Lecture Seule
S261RESERVE3600Lecture Seule
S280NETWORK ID0Lecture Seule
S281DEVICE ADDRESS
S201 : Valeur SF
Le registre permet de définir une valeur du «Spreading Factor» (SF) à utiliser lorsque le produit n’est pas configuré en «Adaptative Data
Rate» (ADR). Cette valeur sera alors utilisée pour transmettre la trame sur le réseau LoRaWAN.
Lorsque l’ADR est actif, le SF est automatiquement manager par le réseau.
S214 et S215 : LORA APP_EUI
Les registres S214 et S215 définissent la clé APP_EUI utilisée lors de la phase de JOIN en mode OTAA. La clé est composée de 16 caractères
repartis sur ces 2 registres pouvant contenir chacun 8 caractères. Le registre S214 contient de début de la clé, et le registre S215 la fin de la
clé.
1 : Configuration par défaut LoRaWAN
Autre : Configuration utilisateur
26
Pageof 55
Page 27
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
Exemple : 0018B244 41524632
S214 = 0018B244
S215 = 41524632
S216 à S219 : LORA APP_KEY
Les registres S216 à S219 définissent la clé APP_EKY utilisée lors de la phase de JOIN en mode OTAA. La clé est composée de 32 caractères
repartis sur ces 4 registres pouvant contenir chacun 8 caractères. Le registre S216 contient les 8 premiers, le registre S217 contient les 8 suivants, le registre S218 les 8 suivants et le registre S219 les 8 derniers.
Si le mode ADR est activé, le produit n’a aucun contrôle sur le SF car ce paramètre peut être modifié par le réseau. Si l’ADR est désactivé, la
valeur de SF utilisée est celle contenue dans le registre S201.
FR
S221 : Mode d’activation
Ce registre permet de configurer le mode d’activation du produit :
• Le mode «Over The Air Activation» (OTAA), utilise une phase de JOIN avant de pouvoir émettre sur le réseau. Ce mode utilise le code
APP_EUI (S214 et S215) et le code APP_KEY (S216 à S219) pendant cette phase pour créer les clés de communication réseau. Une fois
cette phase terminée, les codes APP_sKEY, NWK_sKEY et DEVICE ADDRESS seront présents dans les registres correspondants. Une nouvelle
phase de JOIN est démarrée à chaque fois que le produit sort du mode commande, qu’un reset est effectué ou que le produit est mis sous
tension.
CodeDescription
APP_EUIIdentifiant d’application global
APP_KEYClé d’application du device
• Le mode «Activation By Personnalisation» (ABP), n’a pas de phase de JOIN, il émet directement sur le réseau en utilisant directement les
codes NWK_sKEY (S222 à S225), APP_sKEY (S226 à S229) et DEVICE ADDRESS (S281) pour communiquer.
Valeur Data Rate (DR)Description
NWK_sKEYClé de session réseau
APP_sKEYClé de session applicative
DEVICE ADDRESSAdresse du device dans le réseau
S222 à S225 : LORA NWK_sKEY
Les registres S222 à S225 définissent la clé NWK_sKEY utilisée lors des échanges réseaux. La clé est composée de 32 caractères repartis sur
ces 4 registres pouvant contenir chacun 8 caractères. Le registre S222 contient les 8 premiers, le registre S223 contient les 8 suivants, le registre
S224 les 8 suivants et le registre S225 les 8 derniers.
S226 à S229 : LORA APP_sKEY
Les registres S226 à S229 définissent la clé APP_sKEY utilisée lors des échanges réseaux. La clé est composée de 32 caractères repartis sur ces
4 registres pouvant contenir chacun 8 caractères. Le registre S226 contient les 8 premiers, le registre S227 contient les 8 suivants, le registre
S228 les 8 suivants et le registre S229 les 8 derniers.
27
Pageof 55
Page 28
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
S253 à S256 : Configuration Canal
Par défaut, les canaux 0 à 2 utilisent les paramètres par défaut du réseau LoRaWAN, les 4 autres canaux sont inactifs. Une valeur du registre
différente de 0 ou 1 permet de configurer le canal comme suit :
NOTE : l’exemple donné permet de configurer une fréquence de 868.1 Hz et autorise un SF de 7 à 9. La commande à envoyer pour réaliser
cette opération est :
ATS250=86810053<cr>
S281 : DEVICE ADDRESS
Ce registre permet de définir l’adresse du device sur le réseau lorsque l’on utilise le mode ABP. Dans le mode OTAA ce paramètre est automatique renseigné lors de la phase de JOIN.
28
Pageof 55
Page 29
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
6. MISE À JOUR PRODUIT
Les versions firmware du produit peuvent être mises à jour. Le produit possède 2 firmware qui peuvent être mis à jour individuellement :
Firmware RTU
Firmware APPLICATIF
Les références des versions chargées dans le produit peuvent être connues avec la commande AT/S
Exemple :
APP_8123AAB_PRG_1801_V01.01.02:RTU_8134AAE_PRG_1701_V01.04.00
La version firmware APPLICATIF est : V01.01.02 La version firmware RTU est : V01.04.00
Une procédure complète est disponible sur la page produit de notre site internet : www.adeunis.com
7. HISTORIQUE DU DOCUMENT
VersionContenu
V1.0.0Création
Ajout nouvelle fonctionnalité
• Gestion RSSI-SNR dans la payload
• Réglage SF lorsque l’ADR est désactivé
V1.1.0
V1.1.2Suppression DoC
V1.2.0Modification Fréquences d’utilisation
V1.2.1Changement de mise en forme
V1.2.2Modifications mineures
V1.2.3Corrections mineures
• Ecran trame de downlink
• Payload Personnalisée
• Ecran de JOIN
• Affichage version firmware au démarrage
FR
29
Pageof 55
Page 30
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
EN
ENGLISH
30
Pageof 55
Page 31
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
INFORMATIONS
Document Information
Title
Subtitle
Document type
Version
This document applies to the following products:
NomRéférenceVersion Firmware
FIELD TEST DEVICE - LoRaWAN Europe
FIELD TEST DEVICE
LoRaWAN Europe
User Guide
V1.2.3
ARF8123AAAPP : V01.00.07
RTU : V01.02.00
DISCLAIMER
This document and the use of any information contained therein, is subject to the acceptance of the adeunis terms and conditions. They can be
downloaded from www.adeunis.com.
EN
adeunis makes no warranties based on the accuracy or completeness of the contents of this document and reserves the right to make changes
to specifications and product descriptions at any time without notice.
adeunis is a registered trademark in the EU and other countries.
TECHNICAL SUPPORT
Website
Our website contains a lot of useful information: on modules and wireless modems, user guides, and configuration software and technical documents which can be accessed 24 hours a day.
E-mail
If you have technical problems or cannot find the required information in the provided documents, contact our Technical Support on our website,
section « Technical Support ». This ensures that your request will be processed as soon as possible.
Helpful Information when Contacting Technical Support
When contacting Technical Support, please have the following information ready:
• Product type (for example Field Test Device)
• Firmware version (for example V1.0)
• A clear description of your question or the problem
• A short description of the application
31
Pageof 55
Page 32
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
EU Declaration of Conformity
WE
adeunis
283 rue LOUIS NEEL
38920 Crolles, France
04.76.92.01.62
www.adeunis.com
Declare that the DoC is issued under our sole responsibility and belongs to the following product:
EN
Apparatus model/Product: FIELD TEST DEVICE LoRaWAN 868
Type: ARF8123AA
Object of the declaration:
The object of the declaration described above is in conformity with the relevant Union harmonisation
legislation:
Directive 2014/53/UE (RED)
The following harmonised standards and technical specifications have been applied:
Title: Date of standard/specification
EN 300 220-2 V3.1.1 2017/02
EN 301 489-1 V2.1.1 2016/11
EN 301 489-3 V2.1.0 2016/09
EN 60950-1 2006 +A11:2009 +A1:2010 +A12:2011 +A2:2013
EN 62311 2008
December, 6
th
,2017 Monnet Emmanuel, Certification Manager
32
Pageof 55
Page 33
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
INTRODUCTION
All rights to this manual are the exclusive property of adeunis. All rights reserved. Copying this manual (without written permission from the
owner) via printing, copying, recording or by any other means, translating this manual (in full or partially) into any other language, including all
programming languages, using any electrical, mechanical, magnetic or optical devices, manually or any by other methods, is prohibited.
Adeunis reserves the right to change the technical specifications or functions of its products, or to cease manufacturing any of its products,
or to cease technical support for one of its products without notice in writing and urges its customers to make sure that the information they
have is valid.
Adeunis configuration software and programs are available free of charge in a non-modifiable version. Adeunis can make no guarantees,
including guarantees concerning suitability and applicability for a certain type of application. Under no circumstances can the manufacturer, or
the distributor of an Adeunis program, be held liable for any damage caused by the use of the aforesaid program. Program names, as well as
all copyright relating to programs, are the exclusive property of Adeunis. Any transfer, granting of licenses to a third party, leasing, hire, transport, copying, editing, translation, modification into another programming language or reverse engineering are prohibited without Adeunis’s
prior written authorization and consent.
Adeunis
283, rue Louis Néel
38920 Crolles
France
EN
33
Pageof 55
Page 34
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
ENVIRONMENTAL RECOMMENDATIONS
All superfluous packaging materials have been eliminated. We have done everything possible to make it easy to separate the packaging into
three types of materials: cardboard (box), expanded polystyrene (filler material) and polyethylene (packets, foam protective sheets). Your device
is composed of materials that can be recycled and reused if it is dismantled by a specialist company. Please observe local regulations concerning the manner in which waste packaging material, used batteries and your obsolete equipment are disposed of.
WARNINGS
Valid for FTD LoRaWAN products: ARF8123AA
Read the instructions in the manual.
EN
The safety of this product is only guaranteed when it is used in accordance with its purpose. Maintenance should only be carried out
by qualified persons.
Please note: Do not install the equipment close to a heat source or in damp conditions.
Please note: When the equipment is open, do not carry out any operations other than the ones set out in this document.
Please note: Do not open the product as there is a risk of electrical shock.
Please note: For your own safety, you must ensure that the equipment is switched off before carrying out any work on it.
Please note: For your own safety, the power supply circuit must be SELV (Safety Extra Low Voltage) and must be from limited power
sources.
Please note: When the aerial is installed outside, it is essential to connect the cable screen to the building’s earth. We recommend
using lightning protection. The protection kit chosen must permit the coaxial cable to be earthed (eg: coaxial lightning arrester with earthing
of the cable at different places on the aerial at the base of pylons and at the entrance, or just before entering the premises).
The product must be equipped with a switching mechanism so that the power can be cut. This must be close to the equipment. Any electrical
connection of the product must be equipped with a protection device against voltage spikes and short-circuits.
34
Pageof 55
Page 35
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RECOMMENDATIONS REGARDING USE
• Before using the system, check that the power supply voltage shown in the user manual corresponds to your supply. If it doesn’t, please
consult your supplier.
• Place the device against a flat, firm and stable surface.
• The device must be installed in a location that is sufficiently ventilated so that there is no risk of internal heating and it must not be
covered with objects such as newspapers, cloths, curtains, etc.
• The device’s aerial must be free and at least 10 cm away from any conducting material.
• The device must never be exposed to heat sources such as heating equipment.
• Do not place the device close to objects with naked flames such as lit candles, blowtorches, etc.
• The device must not be exposed to harsh chemical agents or solvents likely to damage the plastic or corrode the metal parts.
DISPOSAL OF WASTE BY USERS IN PRIVATE HOUSEHOLDS WITHIN THE EUROPEAN UNION
This symbol on the product or on its packaging indicates that this product must not be disposed of with your other household waste. Instead, it
is your responsibility to dispose of your waste by taking it to a collection point designated for the recycling of electrical and electronic appliances. Separate collection and recycling of your waste at the time of disposal will contribute to conserving natural resources and guarantee
recycling that respects the environment and human health. For further information concerning your nearest recycling centre, please contact
your nearest local authority/town hall offices, your household waste collection company or the shop where you bought the product
Warning: If the charger is used with any other batteries or products whatsoever, there is a risk of an explosion. After use, the batteries
must be disposed of at an appropriate recycling center. They must not be thrown away to degrade in the environment. When batteries are replaced, the device must be correctly implemented.
Warning for Switzerland : the annex 4.10 of SR 814.013 Standard must be applied for batteries.
This symbol on the device or its packaging means the use of a DC voltage.
EN
35
Pageof 55
Page 36
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
1. INTRODUCING THE DEVICE
1.1. Description
The Field Test Device (FTD) from Adeunis is a Class A LoRaWAN compatible device. This is not a point to point device and may not be used in this
manner. This indicates that it must be used on a private or public operated network.
The LoRaWAN Field Test Device from Adeunis is a ready-to-use device, which makes it possible to communicate with all network operators using
the LoRaWAN V1.0 protocol. The system makes it possible to transmit and receive radio frames and to instantly view the results.
Equipped with a large LCD screen, you can view various information relating to how the network being used is functioning (Uplink, Downlink,
SF, PER, etc.) in addition to information from sensors (GPS coordinates, temperature, battery level, etc.). This device is specifically adapted for
application validation, such as communicating sensors, tracking, smart building, metering, security and M2M.
Thanks to its rechargeable battery, the FTD allows several hours of functioning and can be recharged using a standard mobile phone micro-usb.
EN
1.2. Mechanical features
Unit specifications
DimensionsH186.20 x L75.20 x P22.80
Weight140g
Unit: ABS GP22 + Black Colouring (HB à 1.6mm)
Materials
Lexan: Autotex Polycarbonate
Antenna: Thermolast K TC7AA (d) (a) UL#E214855
186.20mm
75.20mm
22.80mm
36
Pageof 55
Page 37
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
1.3. Technical specifications
Radio
CommunicationLoRaWAN protocol & LoRa Modulation
LoRaWan Specification compliantV1.0.1
Radio RateVariable (SF12/125kHz (~183 bps) to FSK (~50kbps)
RF Power14dBm (25mW)
Sensitivitydown to -140 dBm in SF12/CR4
Range (Open)Up to 15km
Standards metEN 300-220, EN 301-489, EN 60950
Network areaEU863-870
FrequencyISM band 865-870MHz
Serial rate115.2 kbps
ParityNone
Amount of data8
Stop bit1
Functioning temperature-30°C / +70°C
Via AT commands
(see relevant chapter to find a full list of available AT commands)
1.4. Charging the FTD
The device is equipped with a rechargeable battery. Once the device has been connected to a USB charger or the USB socket of a computer, it will
start to charge automatically; even if the ON/OFF communicator is set to OFF (this functions in exactly the same way as a mobile phone). The device
can be used while it is charging. During charging, the charge indicator will be red. When the device is fully charged, the indicator will turn green.
If the battery is completely empty, it will be necessary to recharge the device for 6 hours in order for it to be fully charged.
37
Pageof 55
Page 38
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
2. DEVICE DESCRIPTION
2.1. User interface
EN
LCD screen
Pushbutton 1
2.2. Button description
Interface operation
Pushbutton 1
ON/OFF switch
Charge indicator
Push button 2
Figure 3 : Front view
This button allows you to carry out radio transmissions in manual mode. In the PER menu, a long
press will allow you to reset the counters to zero.
Micro USB connector
Figure 4 : rear view
This button allows you to manage the LCD screen.
Pushbutton 2
ON/OFF Switch
Micro-USB connector
Charge indicatorThe charge LED shows you the device’s charge status (see paragraph 1.4).
When the LCD back-light is switched off, pressing this button will switch on the back-light.
When the LCD back-light is switched on, each press will allow you to scroll through the different
screens available on this device.
The ON/OFF switch allows you to switch the device on or off. Moving the switch to the right will turn
the device on.
The micro-USB connector allows you to charge the device (see paragraph 1.4) or configure it (see
paragraph 3).
2.3. Sensors description
The product also has two on-board sensors: a temperature sensor and an accelerometer. This one sends a frame when a large vibration is
detected (by shaking the device for example).
Pageof 55
38
Page 39
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
3. SCREEN DESCRIPTION
The LCD screen of the product is split on few part :
• The START screen (Showing the firmware version) - Only on the powering up
• The JOIN screen - Only on the powering up and after a command mode exit
• The UPLINK/DOWNLINK screen
• The GPS screen
• The PER screen (Packet Error Rate)
• The DOWNLINK FRAME screen
The following icon are present on each screen of the product
ItemIconDescription
GPS status
(First on the left)
Temperature
(Third on the left)
Battery
(Last on the left)
No iconGPS has been deactivated
GPS has not been synchronized
GPS has been synchronized
Temperature in °C
Battery level
Product in charge
3.1. Start Screen
The device is switched on using the ON/OFF switch located on the underside of the device. Once it has been switched on, the device’s LCD screen
will light up and the start menu will be displayed. This screen show the 2 firmware versions during few seconds.
Applicatif Firmware Version
RTU Firmware version
EN
Figure 5 : Firmware version
NOTE : If the device does not switch on, this could mean that there is insufficient battery charge. You would then need to connect the device to
a USB charger. When the battery is completely empty, it is possible that the device will not switch on, even when connected. Please wait a few
minutes before the device can be used.
3.2. Join Screen
When the device is configure in OTAA mode (Over the Air Activation) default mode, the product start a join request session (JRx) and show the
frequency, SF and power used during this session. When the product receive a Join Accept (JA) from the network, the information is displayed on
the screen and the product switch to the main screen (Uplink/Downlink).
Status bar
Figure 6 : Join RequestFigure 7 : Join Accept
39
Pageof 55
Page 40
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
The request are identify «JR» following with a number showing the number of request done. The frequency used for the request is showing
after this information.
Note : If there is no network available, the «Join Request» will be send indefinitely, and the product will stay in this screen.
ItemIconDescription
RF status
(Second on the left)
No iconThe JOIN phase is completed and the device is operational on the network
The device is in JOIN phase, and is trying to connect to the network
3.3. Uplink/Downlink screen
This screen is displayed when the device is operational on a network but also when the device has been configured in ABP (Activation By
EN
Personalization) mode.
Uplink and Downlink transmission information will be displayed on the LCD screen.
The first line show the Uplink information «ULx» with x for the number and frequency of repetition.
The second line show the SF and the power used
The third line show the Downlink information «DLx» with x for the number and frequency of the reception window
The last line show the SF, RSSI and SNR of the frame received
ItemIconDescription
Transmission Status
(Second on the left)
Uplink information
(Black Line)
Uplink Information
(White Line)
Downlink Information
(Black Line)
Downlink Information
(White Line)
Status bar
Transmission
information
Figure 8 : Principal screen
No iconThere is currently no radio transmission
Manual transmission has been triggered (transmission cycle in progress)
Periodic transmission has been triggered (transmission cycle in progress)
Display showing the number of Uplink (UL1 to UL8) frame repetitions as well as the
transmission frequency of the frame, accurate to one decimal place.
Display showing the SF used as well as the transmission power of the frame.
Display showing the listening window of the device (DL1 or DL2) as well as the reception frequency of the frame, accurate to one decimal place.
Display showing the SF, the RSSI and the SNR of the most recent frame received.
The Downlink information displayed on the device relates to a Downlink frame sent from a LoRaWAN network. If no information can be found
in this section, this does not indicate that the device will not function on the network but only that it has not received any information from the
network. To validate the upload link (sending a frame from the device to the network) it is necessary to use an interface that will allow you to read
frames from the network (example: back-end or application).
The device can either be configured in CONFIRMED mode or UNCONFIRMED MODE (see paragraph 5.4) In CONFIRMED mode, the confirmation
frame allows you to obtain Downlink information. In UNCONFIRMED mode, this information will not automatically be displayed.
40
Pageof 55
Page 41
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
3.4. GPS screen
This screen can be accessed by briefly pressing on pushbutton 2 after the home screen. It will allow you to view the functioning information of
the GPS module, as well as the device’s GPS positioning.
Statuts bar
GPS coordinates
Figure 9 : GPS screen
ItemIconDescription
Number of Satellites
(Second on the left)
GPS signal
(Third on the left)
SAT xxIndicates the number of satellites received by the device
Indicator showing the quality of the GPS signal
1 bar: weak reception
2 bars: average reception
3 bars: good reception
EN
LATITUDEDisplay showing latitude coordinates in degrees, minutes and seconds
LONGITUDEDisplay showing longitude coordinates in degrees, minutes and seconds
When GPS has not yet been “fixed”, no information on latitude or longitude will be displayed on the screen and the information icon will indicate that GPS has not been synchronized.
Figure 10 : GPS screen (No synchronisation)
If the device falls out of synchronization with GPS, the information on this screen will no longer be available. There will be no memory of the last
received position.
3.5. PER (Packet Error Rate) screen
This menu can be accessed by briefly pressing on pushbutton 2 after the GPS menu. It will allow you to evaluate the quality of the radio connection between the device and the network.
Status bar
Frame counters
Figure 11 : PER screen
41
Pageof 55
Page 42
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
The screen will display:
• The number of frames sent (UL COUNT), including repetitions
• The number of frames received (DL COUNT)
• The Packet Error Rate (PER) as a percentage
The PER measurement is calculated by comparing the number of frames transmitted to the number of frames received:
• PER (%) = 100 - (( DL_COUNT / UL_COUNT) * 100)
3.6. Downlink screen
This menu can be accessed by briefly pressing on pushbutton 2 after the PER menu. It will allow you to view a downlink frame sending by the
network. This frame is displayed in ASCII characters. The non printable characters are replace by a point.
Barre de statuts
EN
Zone d’affichage
de la trame
Figure 12 : Ecran Downlink
The screen allow a viewing of 51 characters (17 characters per lines). If the size of the payload is upper than 51 bytes, the product will not
display the extra bytes.
4. DECODING THE PAYLOAD
The size of the Field Test Device’s payload can vary depending on the information transmitted. The first byte will enable you to identify the presence of information contained in the payload. Information will always be shown in the order indicated in the following table.
Example of a payload received: BF1B45159690005534502720200FC95207
This example will be used in order to explain how the payload is decoded.
Order12345678910
Number of bytes1144111211
DescriptionStatus TemperatureGPS Latitude GPS Longitude
ExampleBF1B4515 96 90 00 55 34 502720200F C95207
GPS
Quality
UL
Counter
4.1. Status
HexDecimalN°Bit N°CommentValue
BF
1
06Transmission triggered by the accelerometer0 or 1
15Transmission triggered by pressing pushbutton 10 or 1
14Presence of GPS information0 or 1
13Presence of Uplink frame counter0 or 1
12Presence of Downlink frame counter0 or 1
11Presence of battery level information0 or 1
11Presence of RSSI and SNR information0 or 1
1
7Presence of temperature information0 or 1
DL
Count-
er
Battery
level
RSSISNR
0: Data missing from the payload
1: Data present in the payload
42
Pageof 55
Page 43
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
4.2. Temperature
HexBinaryN°Bit N°CommentsVal
1B
Aid for decoding temperature
• For a positive temperature (sign bit = 0 ) : Value T°C = 16 + 8 +2 + 1 = +27°C
• For a negative temperature (sign bit = 1) : Value T°C = (64+32+16+4)-128 = -12°C
21Temperature in °C (two’s complement)-128 ... +127
4.3. Latitude
HexN°Bit N°CommentsValue
45
15
96
90
3
7..4BCD coding of the entire degree section (tenth of a degree)45°15,9820
3..0BCD coding of the entire degree section (whole degrees)45°15,9820
7..4BCD coding of the entire minute section (tenth of a minute)45°15,9820
3..0BCD coding of the entire minute section (whole minutes)45°15,9820
7..4BCD coding of the decimal section (tenth)45°15,9820
3..0BCD coding of the decimal section (one hundredth)45°15,9620
7..4BCD coding of the decimal section (one thousandth)45°15,9890
3...1Not used
0Hemispheric coding
0 : North
1 : South
EN
Note: the value expressed in the payload will be in degrees, minutes and fractions of a second. A conversion to degrees, minutes and seconds
must be carried out in order to make a comparison with the coordinates displayed on the device’s LCD screen.
4.4. Longitude
HexN°Bit N°CommentsValue
00
53
45
00
Note: the value expressed in the payload will be in degrees, minutes and fractions of a second. A conversion to degrees, minutes and seconds
must be carried out in order to make a comparison with the coordinates displayed on the device’s LCD screen.
4
7..4BCD coding of the entire degree section (one hundredth of a degree)005°34,500
3..0BCD coding of the entire degree section (one tenth of a degree)005°34,500
7..4BCD coding of the entire degree section (whole degrees)005°34,500
3..0BCD coding of the entire minute section (one tenth of a minute)005°34,500
7..4BCD coding of the entire minute section (whole minutes)005°34,500
3..0BCD coding of the decimal section (tenth)005°34,500
7..4BCD coding of the decimal section (one hundredth)005°34,500
3...1Not used
0Hemispheric coding
0 : East
1 : West
43
Pageof 55
Page 44
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
4.5. GPS quality (Not available in Legacy mode)
HexValueN°Bit N°CommentsValue
1: Good
27
The byte’s MSB allows you to find out the quality of the GPS signal
The byte’s LSB allows you to find out the number of satellites viewed by the device
2
73..0Number of satellites1 ... 16
5
7..4Reception scale
2: Average
3: Poor
4.6. UL counter
EN
HexDecimalN°Bit N°CommentsValue
203261Uplink frame counter0 ... 255
Please note: This counter is not the LoRaWAN stack frame counter, but an internal frame counter. Therefore, there is no correlation between
this counter and the one that you can view on the network.
4.7. DL counter
HexDecimalN°Bit N°CommentsValue
203271Downlink frame counter0 ... 255
Please note: This counter is not the LoRaWAN stack frame counter, but an internal frame counter. Therefore, there is no correlation between
this counter and the one that you can view on the network.
4.8. Battery level
HexDecimalN°Bit N°CommentsValue
0F
C9
8
1MSB value of the battery level (in mV)4041
2LSB value of the battery level (in mV)
4.9. RSSI
HexDecimalN°BytesCommentsValue
528291RSSI Value in dBm (Absolute value)0 ... 255
In the example the RSSI value is -82dBm
4.10. SNR
HexDecimalN°BytesCommentsValue
0707101SNR Value in dB (Two’s complement)-128 ... +127
In the example the SNR value is 7 dB
Pageof 55
44
Page 45
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
5. DEVICE CONFIGURATION
The device can be configured using the USB connector. This connection allows you to communicate with the device via a virtual com port and to
transmit AT commands in order to modify the parameters of the device.
5.1. Connecting the device to a computer
Connect the Field Test Device (FTD) to the USB input of a computer. The FTD device has a Type B micro USB connector.
During connection, the device must be recognized by the computer as a Virtual Com Port (VCP) device.
Using Windows: Verification that the device has been recognized to be functioning properly can be obtained by consulting the device manager.
You should see the USB series device with a corresponding COM port number appear during connection.
EN
If you are not able to see a device of this type, you must install the USB driver for this device, available to download from our website:
https://www.adeunis.com/en/produit/ftd-868-915-2/
Select:
• DRIVER - stsw-stm32102_vcpdriver
45
Pageof 55
Page 46
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
5.2. Command mode
Use a COM port terminal in order to communicate with the device. We use the HERCULES COM port soft terminal available to download for free
by clicking on the following link: https://www.hw-group.com/products/hercules/index_en.html
• With Hercules, select the “Serial” tab, then configure the serial port with the following serial parameters:
ParametersValue
Rate 115 200 bps
ParityNone
Data8
Stop Bit1
EN
• Select the serial port on which the device has been created with Windows (Name).
• Click on the “Open” button to open the serial port.
PLEASE NOTE: If the com port has been opened correctly, Hercules will display the message “Serial COM3 port opened”.
Alternatively, “Serial port com opening error” will be displayed, meaning either that the com port is already open for another application, or it
does not exist.
• To supply power to the device, move the switch to the right.
You must send a specific frame in order to move the device to configuration mode.
Frame expressed in hexadecimals: 0xFF 0xFF 0xFF 0xFF 0xFF 0x2B 0x2B 0x2B
Switch ON/OFF
Bottom view
46
Pageof 55
Page 47
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
For Hercules, this frame must be entered in one of the 3 lines available at the bottom. The hexadecimal format must be expressed using a “$” in
this program, which gives us the following frame: $FF$FF$FF$FF$FF$2B$2B$2B
• Send the transition frame in command mode in order to switch the device to configuration mode by clicking on the SEND button.
After a few seconds, you should see the COMMAND MODE screen appear on the device’s LCD. This may take some time due to the fact that
transition to command mode can only happen during a transmission cycle.
On the com port terminal, you should also have “CM” feedback for Command Mode.
Sending a character on Hercules is displayed in magenta and receiving a character is displayed in black. If you do not see sending characters, this
is probably because ECHO is not active on this program. To activate the option in the accessible menu, right click in the viewing window.
EN
5.3. AT command
A command starts with 2 ASCII characters: “AT”, followed by one or more characters and data (see the list below for the syntax of AT commands available on the modem).
Each command must finish with a “CR” or “CR” “LF” – both are acceptable.
(CR indicates: Carriage Return, LF indicates: Line Feed)
Once the command has been received, the modem will feedback:
<cr><lf> “Data” for ATS type playback control <n> ?, AT/S or AT/V
“O” <cr><lf>, for any other command when this has been accepted.
“E” <cr><lf>, if it refuses the command due to a syntax error, unknown command, unknown range, invalid parameter, etc.
“CM” <cr><lf>, if it accepts the input in command mode
Table of AT commands:
CommandDescriptionResponse
ATS<n> ?Feeds back the content of the n rangeSn=y where y represents the content of the n range
ATS<n>=<m>Transfers the m value to the n range“O” if the operation has been accepted
“E” if the operation has been refused
“W” if the operation has encountered a problem during configuration
AT/SEdits the content of all of the user ranges in the
form of a list.
AT/VFeeds back the version of the softwareExample:
ATRRestores the value of all non-volatile memory
ranges to volatile memory.
AT&WSaves the current configuration to non-volatile
memory.
AT&RSTRestart the device“O” if the operation has been accepted.
AT0Exit command mode“O” if the operation has been accepted.
ATT63 PROVIDERUnblock the operating range“O” if the operation has been accepted.
“O” if the operation has been accepted.
“E” if the operation has been refused.
“O” if the operation has been accepted.
“E” if the operation has been refused.
“E” if the operation has been refused.
“E” if the operation has been refused.
“E” if the operation has been refused.
Pageof 55
47
Page 48
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
Example of a set of commands and corresponding responses that can be seen on the terminal:
Command syntaxDescriptionResponse syntax
\FF\FF\FF\FF+++Input request in command modeCM
ATS221=1Transition request in OTAA activation modeO
ATS214=0018B200APP_EUI MSB modification changeE -> This command is not validated (register no unlocked)
ATT63 PROVIDERUnblock the operating rangeO
ATS214=0018B200APP_EUI MSB modification changeO
ATS215?Feeds back the value of the S215 rangeS200=44512451
AT&WMemory request for the state rangeO
ATOOutput request in command modeO
Interpreting the previous example: the user wanted to modify the start of the APP_EUI after having made an unauthorized command (answer
EN
E), and the ranges were unblocked in order to modify the range. The second section of the APP_EUI was verified and the parameters were
saved before exiting. When exiting command mode, the device will make a JOIN request.
5.4. Register description
Once supplied with power, the Field Test Device will function according to the last saved configuration (factory settings if this is the first time
the device has been switched on, or if this configuration has not been changed).
ATS<n>=<m> or ATR type modification commands allow you to modify the content of these ranges.
It is essential to save the parameters using the AT&W command before exiting the command mode, otherwise all of your changes will be lost.
5.4.1 Function register
Below is a list of the ranges accessible on the device (by default). These ranges make it possible to modify the device’s behavior.
Details on how each range functions can be found elsewhere in the table.
RangeContentDefault valueComments
S370Payload format0
S371GPS configuration11
S380Frame transmission period600
S382ACK and Class mode1
0 : Format Legacy (Demonstrator)
1 : Format Field Test Device
0: No periodic transmission
1 to 86400 (expressed in seconds) : Periodic transmission
0: Class A Unconfirmed
1: Class A Confirmed
All other values will be retained.
S383Uplink Port11-223
S385Personalized Payload Size0
0 : Deactivated
1 to 16 : Size of the payload
48
Pageof 55
Page 49
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RangeContentDefault valueComments
S386
S387
S388
S389
S370 : Payload format
The Field Test Device (FTD) is compatible with the previous version of the device (the LoRaWAN Demonstrator). In order to modify the format of
the payload and to make it compatible with the previous device, it will be necessary to modify this range.
S371 : GPS configuration
The way in which the GPS module is configured is completely independent from the main firmware. Two functioning modes are available:
• Permanent Mode
• Periodic Mode
Personalize Payload Text - Bloc 1
Personalize Payload Text- Bloc 2
Personalize Payload Text- Bloc 3
Personalize Payload Text - Bloc 4
0
0
Each bloc allow to define 4 bytes of the payload
0
0
EN
In permanent mode, the GPS is always active and will operate at maximum power (like the GPS in a car). This is the most efficient mode and
we would recommend using it when it is necessary to move the Field Test Device (example: if the device will be in a car), or if satellite visibility is
poor.
In periodic mode, the GPS will start for a period of 5 min at maximum power before switching to periodic power. In this mode, the GPS will
become active for 30-40 seconds every 10 minutes. The rest of the time, it will be in rest mode, which will aid the device’s independence. This
mode should be used for static use (fixed position, or very slow movement), or where satellite visibility is very good.
The user can also choose to reset the GPS once it is switched on. This operation will allow you to delete the GPS memory as well as all previously acquired information. This can be useful when the GPS is not able to synchronize itself while it is starting up. Essentially, the GPS will use its
internal memory to set a position and to locate satellites, but when the GPS has not been used for a long period of time or has traveled a great
distance (for example, if it has traveled on-board an aircraft to another country), the information will be inaccurate and must be deleted.
If the GPS coordinates are available during transmission of a LoRa frame, these coordinates will be included in the payload. Otherwise the corresponding bytes will be deleted, rendering the payload shorter.
S380 : Frame transmission period
The device is capable of automatically making periodic transmissions. The transmission period is defined in seconds and can be anywhere
between 0 and 86400 (24 hours).
If the value for the period is equal to 0, the function will then be deactivated.
49
Pageof 55
Page 50
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
S382 : Class and ACK Mode
The range will allow you to select the method of functioning for the device:
• Unconfirmed Mode
• Confirmed Mode
S383 : Uplink Port
The communication port for the Uplink frame can be configured in this frame. You can select a value between 1 and 223
S385 : Personalize Payload Size
This option allow to send a define payload instead of the standard define inside the product
The user can set the size of the payload and the text to send
EN
When the value of the register is set to , the function is deactivated and the product use the standard payload.
When the value get a number, the product send the characters of the registers S386 to S389.
S386 to S389 : Personalize Payload Text
The 4 registers allow to set a specific payload :
• The register S386 allow to define the bytes 1 to 4 of the frame
• The register S386 allow to define the bytes 5 to 8 of the frame
• The register S386 allow to define the bytes 9 to 11 of the frame
• The register S386 allow to define the bytes 12to 16 of the frame
The value must be set in hexadecimal code : example for the «TEST» word --> 54455654
WARNING : The register need to be completed with zero to send a byte, or the product will completed by himself the register and you will not
have the result you would like to have. Example with : ATS385=1.
• ATS386=AB000000 --> The system understand the frame AB000000 and send the first byte --> You will receive AB
• ATS386=AB --> The system understand the frame 000000AB and send the first byte --> You will receive 00
5.4.2 Network register
RangeContentDefault valueComments
7 : SF7
8 : SF8
S201Spreading Factor value12
9 : SF9
10 : SF10
11 : SF11
12 : SF12
S204RESERVE34C194C1Read-only
50
Pageof 55
Page 51
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RangeContentDefault valueComments
S214LORA APP_EUI (First section)0018B244
Parameter coded with 16 characters. Each range
contains a section of the key.
S215LORA APP_EUI (Second section)41524632
S216LORA APP_KEY (First section)(see note)
S217LORA APP_KEY (Second section)(see note)
Parameter coded with 16 bytes. Each of the 4 ranges
will contain 4 bytes.
S218LORA APP_KEY (Third section)(see note)
S219LORA APP_KEY (Fourth section)(see note)
EN
S220Activation ADR1
S221Activation mode1
S222LORA NWK_sKEY (First section)0
S223LORA NWK_sKEY (Second section)0
S224LORA NWK_sKEY (Third section)0
S225LORA NWK_sKEY (Fourth section)0
S226LORA APP_sKEY (First section)0
S227LORA APP_sKEY (Second section)0
S228LORA APP_sKEY (Third section)0
0 : Inactive
1 : Active
0 : ABP
1 :OTAA
Parameter coded with 16 bytes. Each of the 4 ranges
contains 4 bytes.
Parameter with 16 bytes. Each of the 4 ranges contains 4 bytes.
S229LORA APP_sKEY (Fourth section)0
51
Pageof 55
Page 52
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
RangeContentDefault valueComments
S250Configuration Channel 01
EN
S251Configuration Channel 11
S252Configuration Channel 21
S53Configuration Channel 30
S254Configuration Channel 40
S255Configuration Channel 50
S256Configuration Channel 60
S257Configuration RX21
S260RESERVE2200Read-only
Mandatory channels of the LoRaWAN specification.
These values cannot be modified.
0 : Channel deactivated
Other : User configuration
0: Channel deactivated
1: LoRaWAN default configuration
Other: User configuration
S261RESERVE3600Read-only
S280NETWORK ID0Read-only
S281DEVICE ADDRESS
S201: SF value
The range allows you to set a “Spreading Factor” (SF) value to use when the device has not been configured to “Adaptive Data Rate” (ADR).
This value will then be used to transmit the frame on the LoRaWAN network. When the ADR is active, the SF will automatically be managed
by the network.
S214 and S215: LORA APP_EUI
The S214 and S215 ranges determine the APP_EUI key used during the JOIN phase in OTAA mode. The key is made up of 16 characters
spread across these 2 ranges, which can each contain 8 characters. The S214 range contains the start of the key, while the S215 range contains the end of the key.
Example : 0018B244 41524632
S214 = 0018B244
S215 = 41524632
52
Pageof 55
Page 53
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
S216 to S219: LORA APP_KEY
The ranges from S216 to S219 determine the APP_KEY used during the JOIN phase in OTAA mode. The key is made up of 32 characters spread
across these 4 ranges, which can each contain 8 characters. The S216 range contains the first 8, the S217 range contains the next 8, the S218
range contains the next 8 and the S219 range contains the last 8.
If the ADR mode has been activated, the device will have no control over the SF because the parameter can only be modified by the network.
If the ADR has been deactivated, the SF value used is that contained in the S201 register.
S221: Activation mode
This range will allow you to configure the device’s activation mode:
• The “Over The Air Activation” (OTAA) mode uses a JOIN phase before it can transmit on the network. This mode uses the code APP_EUI
(S214 and S215) and the code APP_KEY (S216 to S219) during this phase in order to create the network communication keys. Once this
phase has finished, the APP_sKEY, NWK_sKEY and DEVICE ADDRESS codes will be present in the corresponding ranges. A new JOIN phase
will start each time the device exits command mode, is reset or is supplied with power.
EN
CodeDescription
APP_EUIGlobal application identifier
APP_KEYDevice application key
• The “Activation By Personalization” (ABP) mode does not have a JOIN phase, but transmits directly on the network by directly using the
codes NWK_sKEY (S222 to S225), APP_sKEY (S226 to S229) and DEVICE ADDRESS (S281) in order to communicate.
Data Rate (DR) valueDescription
NWK_sKEYNetwork session key
APP_sKEYApplication session key
DEVICE ADDRESSNetwork device address
S222 à S225: LORA NWK_sKEY
The ranges from S222 to S225 determine the NWK_sKEY used during network exchanges. The key is made up of 32 characters spread across
these 4 ranges, which can each contain 8 characters. The range S222 contains the first 8, the S223 range contains the next 8, the S224 register contains the next 8 and the S225 range contains the last 8.
The ranges from S226 to S229 determine the APP_sKEY used during network exchanges. The key is made up of 32 characters spread across
these 4 ranges, which can each contain 8 characters. The S226 range contains the first 8, the S227 range contains the next 8, the S228 range
contains the next 8 and the S229 range contains the next 8.
53
Pageof 55
Page 54
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
By default, the channels from 0 to 2 use the default parameters of the LoRaWAN network, while the 4 other channels are inactive. A range
value different from 0 or 1 will allow you to configure the channel as follows:
NOTE: the example given will allow you to configure a 868.1 Hz frequency and authorizes a SF from 7 to 9. The command to send in order to
carry out this operation is:
ATS250=86810053<cr>
S281: DEVICE ADDRESS
This range will allow you to determine the address of the device on the network when using the ABP mode. In the OTAA mode, this parameter
is automatically input during the JOIN phase.
54
Pageof 55
Page 55
FIELD TEST DEVICE - LoRaWAN Europe - Guide utilisateur / User guide version V1.2.3
6. DEVICE UPDATES
The firmware versions of the device can be updated. The device has 2 firmwares that can be updated individually:
RTU firmware
APPLICATIVE firmware
It is possible to find out the references for versions loaded onto the device using the command AT/S
Example :
APP_8123AAB_PRG_1801_V01.01.02:RTU_8134AAE_PRG_1701_V01.04.00
The APP firmware version is: V01.01.02 The RTU firmware version is: V01.04.00
The full procedure is available on the device page of our website: www.adeunis.com