Interfaçage OpenFlyers et Teltonika: Difference between revisions

From Documentation de la solution web de gestion OpenFlyers
Jump to navigation Jump to search
imported>Joel
No edit summary
 
(28 intermediate revisions by 5 users not shown)
Line 2: Line 2:
L'objet de cette page est de présenter l'interfaçage d'OpenFlyers avec les boitiers [https://teltonika-networks.com/ Teltonika].
L'objet de cette page est de présenter l'interfaçage d'OpenFlyers avec les boitiers [https://teltonika-networks.com/ Teltonika].


OpenFlyers a testé les trackers suivants :
;Trackers testés par OpenFlyers
*[https://wiki.teltonika-gps.com/view/FMC125 Teltonika FMC 125]
*[https://wiki.teltonika-gps.com/view/FMC125 Teltonika FMC 125]
*[https://wiki.teltonika-gps.com/view/FMC130 Teltonika FMC 130] comporte des entrées supplémentaires
*[https://wiki.teltonika-gps.com/view/FMC130 Teltonika FMC 130] comporte des entrées supplémentaires
Line 8: Line 8:
Ce sont des modèles 4G multi-systèmes satellitaires (GPS, GLONASS et Galileo).
Ce sont des modèles 4G multi-systèmes satellitaires (GPS, GLONASS et Galileo).


Certificats :
;Certificats
*https://wiki.teltonika-gps.com/view/FMC125_Certification_%26_Approvals
*https://wiki.teltonika-gps.com/view/FMC125_Certification_%26_Approvals
*https://wiki.teltonika-gps.com/view/FMC130_Certification_%26_Approvals
*https://wiki.teltonika-gps.com/view/FMC130_Certification_%26_Approvals


Pour fonctionner il faut :
;Compatibilité avec l'aéronautique
*Pour les ULMs, il n'y a pas de réglementation particulière
*Pour les aéronefs certifiés ELA2 (aéronef léger européen dont la masse maximale au décollage ne dépasse pas 2 tonnes), la réglementation EASA [https://www.easa.europa.eu/en/document-library/certification-specifications/cs-stan-issue-4 CS-STAN version 4], chapitre "Standard Change CS-SC106b" (installation of flight-time recorders), impose que les appareils installés à demeure sur l'aéronef ne dépassent pas une puissance d'émission de 100mW dès lors que l'aéronef est en mouvement. La documentation de certification Teltonika indique une puissance d'émission de 26,05dBm soit 402mW.
 
Il existe à l'heure actuelle 2 solutions :
*Rajouter au boitier Teltonika un boitier d'alimentation autonome disposant de sa propre batterie (solution testée par OpenFlyers)
*Rajouter au boitier Teltonika un boitier d'interfaçage à une alimentation standardisée et installer sur l'aéronef ce type d'alimentation permettant au boitier de ne pas être considéré comme fixé sur l'appareil (solution non testée par OpenFlyers)
 
OpenFlyers est ouvert à toute solution alternative qui n'émettrait pas durant le déplacement de l'aéronef et a sollicité Teltonika dans ce sens.
 
;Paramétrage et installation
*Paramétrer le boitier pour qu'il envoie les données sur le serveur de réception des données OpenFlyers prévu à cet effet
*Paramétrer le boitier pour qu'il envoie les données sur le serveur de réception des données OpenFlyers prévu à cet effet
*Équiper le boitier avec une carte SIM pour l'envoi des données
*Équiper le boitier avec une carte SIM pour l'envoi des données
*Brancher le boitier sur la batterie de l'aéronef
*Brancher le boitier sur la batterie via une connectique amovible de l'aéronef ou de façon autonome
 
Pour la carte SIM, il existe une multitude de solutions. Ces prestataires fournissent une carte SIM avec un abonnement de type "Internet des Objets" (IoT "Internet of Things") en anglais) permettant de ne faire que du transfert de données et qui est multi-opérateurs. A noter, que le tracker prend le meilleur des réseaux disponibles.
 
;Exemples de fournisseurs de cartes SIM
*[https://www.korewireless.com/super-sim-card Kore Super SIM] a un cout de $2 par mois et le coût des data est de $0,10 par Mo
*[https://www.thingsmobile.com/fr/private/solutions/carte-sim-gps-tracker Things Mobile "Carte SIM pour GPS Tracker"] a un coût de 0,12 €/Mo


Pour la carte SIM, il existe la solution [https://www.korewireless.com/super-sim-card Kore] qui permet de commander une carte SIM avec un abonnement de type "Internet des Objets" permettant de ne faire que du transfert de données et qui est multi-opérateurs. A noter, que le tracker prend le meilleur des réseaux disponibles.
=Variables pour les formules de calcul=
Les variables suivantes sont utilisables dans les formules :


Exemple : Kore Super SIM a un cout de $2 par mois et le coût des data est de $0,10 par Mo.
*TELTONIKA_ENGINE_START : Datetime de décollage
*TELTONIKA_OFFBLOCK_DATE : Datetime de départ bloc
*TELTONIKA_ONBLOCK_DATE : Datetime de bloc arrivée
*TELTONIKA_ENGINE_STOP : Datetime d'atterrissage
Ces variables sont directement transmises par Teltonika.


==Initialisation du tracker==
Les fonctions suivantes peuvent être utilisées dans les formules pour le [[Configuration#Gestion-de-Teltonika|paramétrage de Teltonika]] :
*[[Formules-de-calcul#formatDate('patron',-'date')|formatDate]] : Permet de formater une date
*[[Formules-de-calcul#roundCeil(X,Y)|roundCeil]] : Arrondi à la minute supérieure la date transmise en paramètre
*[[Formules-de-calcul#roundFloor(X,Y)|roundFloor]] : Arrondi à la minute inférieure la date transmise en paramètre
*[[Formules-de-calcul#strtotime(string)|strtotime]] : Transforme une date en timestamp


Voir la [https://wiki.teltonika-gps.com/images/0/05/QM-FMC125.pdf documentation officielle] et [https://wiki.teltonika-gps.com/view/FMC125_First_Start Premier démarrage],
=Procédure=
==Configurer le tracker==
;Prérequis
*Avoir [[#Initialiser-le-tracker|initialisé le tracker]]


===Mise en œuvre===
;Procédure
Pour paramétrer le tracker il faut le connecter avec un PC.
*Il faut ouvrir le boitier du tracker et connecter un câble micro USB
 
[[File:Connexion_pour_configuration.jpg|File:Connexion_pour_configuration.jpg]]
 
*Aller sur le site de Teltonika pour télécharger la dernière version du [https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions programme de configuration]
*Reconnecter le tracker sur son bloc d’alimentation et le mettre sous tension
*Lancer le programme Teltonika Configurator, la page d’accueil doit détecter automatiquement le tracker connecté.
*Double-cliquer sur le device détecté
 
[[File:Menu_Teltonika.JPG|File:Menu_Teltonika.JPG]]
 
*Cliquer sur '''Load from file''' et charger le fichier de configuration fourni par OpenFlyers
*Beaucoup de paramètres sont disponibles, ne pas les modifier sans avertir OpenFlyers
*Cliquer sur '''Save to device'''
*Débrancher le câble et refermer le tracker
 
Voir la documentation Teltonika pour la description des [https://wiki.teltonika-gps.com/view/FMC125_Configuration paramètres]
 
==Initialiser le tracker==
;Références
*[https://wiki.teltonika-gps.com/images/0/05/QM-FMC125.pdf documentation officielle]
*[https://wiki.teltonika-gps.com/view/FMC125_First_Start Premier démarrage]
 
;Procédure
*Ouvrir le tracker en écartant les clips latéraux
*Ouvrir le tracker en écartant les clips latéraux
*Insérer une carte SIM au format mini (2FF : 25mm x 15mm) dans le slot inférieur. Coin coupé vers l’avant et contact vers le bas
*Insérer une carte SIM au format mini (2FF : 25mm x 15mm) dans le slot inférieur. Coin coupé vers l’avant et contact vers le bas
Line 35: Line 88:
Voici par exemple la description de mise en œuvre d'un boitier (Conception hors OpenFlyers)
Voici par exemple la description de mise en œuvre d'un boitier (Conception hors OpenFlyers)


[[Fichier:Alimentation.JPG]]
[[File:Alimentation.JPG|File:Alimentation.JPG]]
   
   
*Basculer l’interrupteur de mise sous tension vers la gauche : la diode d’état doit s’allumer en rouge. L’alimentation est sous tension mais pas le tracker
*Basculer l’interrupteur de mise sous tension vers la gauche : la diode d’état doit s’allumer en rouge. L’alimentation est sous tension mais pas le tracker
*Appuyé sur le bouton blanc : la diode d’état doit passer au vert. Le tracker est sous tension
*Appuyé sur le bouton blanc : la diode d’état doit passer au vert. Le tracker est sous tension
*Sur la face arrière du tracker les diodes d’état doivent s’allumer. La diode de droite indique la connexion au réseau cellulaire, celle de gauche la connexion au système satellitaire. Diode fixe pas de connexion, clignotant connexion établie
*Sur la face arrière du tracker les diodes d’état doivent s’allumer. La diode de droite indique la connexion au réseau cellulaire, celle de gauche la connexion au système satellitaire. Diode fixe pas de connexion, clignotant connexion établie
*En cas de chute de tension sous le seuil de décharge, le boitier se mets en sécurité, la diode d'état repasse au rouge. Il faut recharger le boitier sinon il y a risque de destruction des batteries
*En cas de chute de tension sous le seuil de décharge, le boitier se met en sécurité, la diode d'état repasse au rouge. Il faut recharger le boitier sinon il y a risque de destruction des batteries


==Configuration du tracker==
==Interfacer OpenFlyers avec Teltonika==
*Aller dans '''Admin > Structure > Paramétrage > Activités'''
**Activer l'interrupteur '''Teltonika''' situé dans la 4ème colonne
**Renseigner les champs '''Nom d'utilisateur''' et '''Mot de passe'''.
**Cliquer sur le bouton '''Enregistrer'''
*[[Gestion-des-ressources#Saisir-le-numéro-de-ressource-pour-l'API-de-geolocalisation|Configurer le numéro de l'API de géolocalisation pour les ressources]].


Pour paramétrer le tracker il faut le connecter avec un PC.  
=Récupération des vols Teltonika=
*Il faut ouvrir le boitier du tracker et connecter un câble micro USB
Chaque minute, le robot OpenFlyers interroge le serveur Teltonika pour vérifier s'il y a de nouveaux vols enregistrés. S'il y en a, ces vols sont sauvegardés dans OpenFlyers et les vols récupérés du côté de Teltonika sont marqués comme '''collected''' via la demande '''/confirmTrack'''.
 
Teltonika utilise un système d'identifiant pour retrouver les pilotes et les aéronefs il est donc nécessaire de créer les champs métiers nécessaires et de les renseigner dans l'interface d'OpenFlyers.
*Si l'identifiant d'un aéronef chez Teltonika ne peut être retrouvé dans OpenFlyers alors le robot n'enregistrera pas le vol.
 
Afin de retrouver un maximum d'informations le robot tente de retrouver une réservation avec la même ressource correspondant au vol communiqué par Teltonika:
*Il vérifie l'existence d'une réservation avec des horaires incluant l'heure médiane du vol Teltonika. En cas de présence, il se réfère aux informations de cette réservation.
*En l'absence de toute réservation, il recherche une réservation avec la même ressource dont les horaires se situent entre le début et la fin du vol remonté par Teltonika.
**S'il y a plusieurs réservations, alors il n'en prend aucune.
**Dès qu'une réservation correspondant au vol remonté par Teltonika est identifiée, les informations de cette réservation sont prises en compte par le robot.


[[Fichier:Connexion_pour_configuration.jpg]]
;Exemple
Pour un vol qui commence à 16h05 et se termine à 17h00, l'heure médiane est 16h32. La réservation correspondante pour ce vol sera celle qui inclut cette heure médiane.


*Aller sur le site de Teltonika pour télécharger la dernière version du [https://wiki.teltonika-gps.com/view/Teltonika_Configurator_versions programme de configuration]
==Statut des pilotes==
*Reconnecter le tracker sur son bloc d’alimentation et le mettre sous tension
Pour chaque pilote :
*Lancer le programme Teltonika Configurator, la page d’accueil doit détecter automatiquement le tracker connecté.
*Si un vol récupéré dans Teltonika peut être associé à une réservation => Les statuts des pilotes sont celles définies dans la réservation.
*Double-cliquer sur le device détecté
*Si le vol ne peut être associé :
**S'il n'y a qu'un statut autorisé pour la place du pilote et pour l'avion => Le statut du pilote est ce statut.
**Si le pilote est sur la première place => Le statut du pilote est le statut "pilote" si il n'existe pas le premier statut.
**Si le pilote est sur la seconde place => Le statut du pilote est le statut "Instructeur" si il n'existe pas le second statut.


[[Fichier:Menu_Teltonika.JPG]]
==Place des pilotes==
*Si un vol récupéré dans Teltonika peut être associé à une réservation => Les places des pilotes sont celles définies dans la réservation.
*Si le vol ne peut être associé :  
**S'il y a un seul pilote => Sa place est celle par défaut (0, Gauche).
**S'il y a deux pilotes et que un seul à l'autorisation pour être sur la place de droite => Le pilote ayant l'autorisation est à la place de droite et l'autre à la place de gauche.
**Si les deux pilotes ont les autorisations pour être sur la place de droite => Le pilote 1 est sur la place de gauche le pilote 2 est sur la place de droite.


*Cliquer sur '''Load from file''' et charger le fichier de configuration fourni par OpenFlyers
=FAQ=
*Beaucoup de paramètres sont disponibles, ne pas les modifier sans avertir OpenFlyers
==Le boitier se connecte au serveur OpenFlyers Teltonika mais n'envoie pas de données==
*Cliquer sur '''Save to device'''
Vérifier la configuration de la box Teltonika dans cette documentation : [[#Configurer-le-tracker|Configurer le tracker]].
*Débrancher le câble et refermer le tracker
==Page ressource: le numéro de ressource à renseigner est-il bien l'IMEI du boîtier ?==
Oui, il faut saisir l'IMEI dans le champ "numéro de ressource"


Voir la documentation Teltonika pour la description des [https://wiki.teltonika-gps.com/view/FMC125_Configuration paramètres]
==Page Structure > Activités: il y a un "nom utilisateur" et "Mot de passe" à renseigner. Que doit mettre à ce niveau ?==
Après avoir demandé à l'équipe d'Openflyers de créer un compte pour la plateforme sur le serveur Teltonika, insérer les identifiants fournis par Openflyers dans les champs nom d'utilisateur et mot de passe.

Latest revision as of 18:27, 2 October 2024

Présentation

L'objet de cette page est de présenter l'interfaçage d'OpenFlyers avec les boitiers Teltonika.

Trackers testés par OpenFlyers

Ce sont des modèles 4G multi-systèmes satellitaires (GPS, GLONASS et Galileo).

Certificats
Compatibilité avec l'aéronautique
  • Pour les ULMs, il n'y a pas de réglementation particulière
  • Pour les aéronefs certifiés ELA2 (aéronef léger européen dont la masse maximale au décollage ne dépasse pas 2 tonnes), la réglementation EASA CS-STAN version 4, chapitre "Standard Change CS-SC106b" (installation of flight-time recorders), impose que les appareils installés à demeure sur l'aéronef ne dépassent pas une puissance d'émission de 100mW dès lors que l'aéronef est en mouvement. La documentation de certification Teltonika indique une puissance d'émission de 26,05dBm soit 402mW.

Il existe à l'heure actuelle 2 solutions :

  • Rajouter au boitier Teltonika un boitier d'alimentation autonome disposant de sa propre batterie (solution testée par OpenFlyers)
  • Rajouter au boitier Teltonika un boitier d'interfaçage à une alimentation standardisée et installer sur l'aéronef ce type d'alimentation permettant au boitier de ne pas être considéré comme fixé sur l'appareil (solution non testée par OpenFlyers)

OpenFlyers est ouvert à toute solution alternative qui n'émettrait pas durant le déplacement de l'aéronef et a sollicité Teltonika dans ce sens.

Paramétrage et installation
  • Paramétrer le boitier pour qu'il envoie les données sur le serveur de réception des données OpenFlyers prévu à cet effet
  • Équiper le boitier avec une carte SIM pour l'envoi des données
  • Brancher le boitier sur la batterie via une connectique amovible de l'aéronef ou de façon autonome

Pour la carte SIM, il existe une multitude de solutions. Ces prestataires fournissent une carte SIM avec un abonnement de type "Internet des Objets" (IoT "Internet of Things") en anglais) permettant de ne faire que du transfert de données et qui est multi-opérateurs. A noter, que le tracker prend le meilleur des réseaux disponibles.

Exemples de fournisseurs de cartes SIM

Variables pour les formules de calcul

Les variables suivantes sont utilisables dans les formules :

  • TELTONIKA_ENGINE_START : Datetime de décollage
  • TELTONIKA_OFFBLOCK_DATE : Datetime de départ bloc
  • TELTONIKA_ONBLOCK_DATE : Datetime de bloc arrivée
  • TELTONIKA_ENGINE_STOP : Datetime d'atterrissage

Ces variables sont directement transmises par Teltonika.

Les fonctions suivantes peuvent être utilisées dans les formules pour le paramétrage de Teltonika :

  • formatDate : Permet de formater une date
  • roundCeil : Arrondi à la minute supérieure la date transmise en paramètre
  • roundFloor : Arrondi à la minute inférieure la date transmise en paramètre
  • strtotime : Transforme une date en timestamp

Procédure

Configurer le tracker

Prérequis
Procédure

Pour paramétrer le tracker il faut le connecter avec un PC.

  • Il faut ouvrir le boitier du tracker et connecter un câble micro USB

File:Connexion_pour_configuration.jpg

  • Aller sur le site de Teltonika pour télécharger la dernière version du programme de configuration
  • Reconnecter le tracker sur son bloc d’alimentation et le mettre sous tension
  • Lancer le programme Teltonika Configurator, la page d’accueil doit détecter automatiquement le tracker connecté.
  • Double-cliquer sur le device détecté

File:Menu_Teltonika.JPG

  • Cliquer sur Load from file et charger le fichier de configuration fourni par OpenFlyers
  • Beaucoup de paramètres sont disponibles, ne pas les modifier sans avertir OpenFlyers
  • Cliquer sur Save to device
  • Débrancher le câble et refermer le tracker

Voir la documentation Teltonika pour la description des paramètres

Initialiser le tracker

Références
Procédure
  • Ouvrir le tracker en écartant les clips latéraux
  • Insérer une carte SIM au format mini (2FF : 25mm x 15mm) dans le slot inférieur. Coin coupé vers l’avant et contact vers le bas
  • Ne pas connecter la batterie de secours située sous le circuit imprimé
  • Refermer le tracker
  • Brocher le tracker sur le bloc d’alimentation

L'alimentation du tracker Teltonika FMC 125 peut être faite par une alimentation autonome sur batterie. Voici par exemple la description de mise en œuvre d'un boitier (Conception hors OpenFlyers)

File:Alimentation.JPG

  • Basculer l’interrupteur de mise sous tension vers la gauche : la diode d’état doit s’allumer en rouge. L’alimentation est sous tension mais pas le tracker
  • Appuyé sur le bouton blanc : la diode d’état doit passer au vert. Le tracker est sous tension
  • Sur la face arrière du tracker les diodes d’état doivent s’allumer. La diode de droite indique la connexion au réseau cellulaire, celle de gauche la connexion au système satellitaire. Diode fixe pas de connexion, clignotant connexion établie
  • En cas de chute de tension sous le seuil de décharge, le boitier se met en sécurité, la diode d'état repasse au rouge. Il faut recharger le boitier sinon il y a risque de destruction des batteries

Interfacer OpenFlyers avec Teltonika

Récupération des vols Teltonika

Chaque minute, le robot OpenFlyers interroge le serveur Teltonika pour vérifier s'il y a de nouveaux vols enregistrés. S'il y en a, ces vols sont sauvegardés dans OpenFlyers et les vols récupérés du côté de Teltonika sont marqués comme collected via la demande /confirmTrack.

Teltonika utilise un système d'identifiant pour retrouver les pilotes et les aéronefs il est donc nécessaire de créer les champs métiers nécessaires et de les renseigner dans l'interface d'OpenFlyers.

  • Si l'identifiant d'un aéronef chez Teltonika ne peut être retrouvé dans OpenFlyers alors le robot n'enregistrera pas le vol.

Afin de retrouver un maximum d'informations le robot tente de retrouver une réservation avec la même ressource correspondant au vol communiqué par Teltonika:

  • Il vérifie l'existence d'une réservation avec des horaires incluant l'heure médiane du vol Teltonika. En cas de présence, il se réfère aux informations de cette réservation.
  • En l'absence de toute réservation, il recherche une réservation avec la même ressource dont les horaires se situent entre le début et la fin du vol remonté par Teltonika.
    • S'il y a plusieurs réservations, alors il n'en prend aucune.
    • Dès qu'une réservation correspondant au vol remonté par Teltonika est identifiée, les informations de cette réservation sont prises en compte par le robot.
Exemple

Pour un vol qui commence à 16h05 et se termine à 17h00, l'heure médiane est 16h32. La réservation correspondante pour ce vol sera celle qui inclut cette heure médiane.

Statut des pilotes

Pour chaque pilote :

  • Si un vol récupéré dans Teltonika peut être associé à une réservation => Les statuts des pilotes sont celles définies dans la réservation.
  • Si le vol ne peut être associé :
    • S'il n'y a qu'un statut autorisé pour la place du pilote et pour l'avion => Le statut du pilote est ce statut.
    • Si le pilote est sur la première place => Le statut du pilote est le statut "pilote" si il n'existe pas le premier statut.
    • Si le pilote est sur la seconde place => Le statut du pilote est le statut "Instructeur" si il n'existe pas le second statut.

Place des pilotes

  • Si un vol récupéré dans Teltonika peut être associé à une réservation => Les places des pilotes sont celles définies dans la réservation.
  • Si le vol ne peut être associé :
    • S'il y a un seul pilote => Sa place est celle par défaut (0, Gauche).
    • S'il y a deux pilotes et que un seul à l'autorisation pour être sur la place de droite => Le pilote ayant l'autorisation est à la place de droite et l'autre à la place de gauche.
    • Si les deux pilotes ont les autorisations pour être sur la place de droite => Le pilote 1 est sur la place de gauche le pilote 2 est sur la place de droite.

FAQ

Le boitier se connecte au serveur OpenFlyers Teltonika mais n'envoie pas de données

Vérifier la configuration de la box Teltonika dans cette documentation : Configurer le tracker.

Page ressource: le numéro de ressource à renseigner est-il bien l'IMEI du boîtier ?

Oui, il faut saisir l'IMEI dans le champ "numéro de ressource"

Page Structure > Activités: il y a un "nom utilisateur" et "Mot de passe" à renseigner. Que doit mettre à ce niveau ?

Après avoir demandé à l'équipe d'Openflyers de créer un compte pour la plateforme sur le serveur Teltonika, insérer les identifiants fournis par Openflyers dans les champs nom d'utilisateur et mot de passe.