Différences entre versions de « ADAFRUIT-FONA-Arduino-Test »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(2 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{ADAFRUIT-FONA-NAV}}
 
{{ADAFRUIT-FONA-NAV}}
  
−
{{traduction}}
 
 
== Préambule ==  
 
== Préambule ==  
 
{{bloc-etroit|text=
 
{{bloc-etroit|text=
Ligne 169 : Ligne 168 :
  
 
== Sous module GPS (FONA 808 uniquement) ==
 
== Sous module GPS (FONA 808 uniquement) ==
−
The FONA 808 has a built in GPS module, you can use it for locating yourself in space! You will need to attach a GPS antenna to the uFL connector and make sure the GPS antenna is outside and pointing up to towards the sky
+
The FONA 808 inclus un module GPS que vous pouvez utiliser pour localiser votre position! Vous aurez besoin de brancher une antenne GPS sur le connecteur µFL et faire en sorte que l'antenne GPS soit positionnée à l'extérieur (et pointant vers le ciel).
  
−
You can start out by turning on the GPS module with '''O''' (capital-o) and query the status of the 'fix' with '''x'''. It will take a minute or two to get a fix.
+
Vous commencez en activant le module GPS avec la commande '''O''' (lettre 'o' en capital) et vous pouvez interroger le le statut de la synchronisation satellite (dit 'fix') avec la commande '''x'''.  
 +
 
 +
Une minute ou deux seront nécessaire pour obtenir cette synchronisation (''fix'').
  
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-63.jpg}}
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-63.jpg}}
  
−
Once you have a fix you can query and get the location/time data with '''L'''
+
Une fois que vous avez obtenu le ''fix'', vous pouvez interroger le module pour obtenir votre position (mais aussi l'heure) à l'aide de la commande '''L'''
  
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-64.jpg}}
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-64.jpg}}
  
−
The data is in a comma-seperated format:
+
Les données sont produites sous le format '''comma-seperated''' (valeurs séparées par une virgule):
 
  <nowiki>0,4043.576433,7400.316980,58.647405,20150601201258.000,64,12,0.548363,100.442406</nowiki>
 
  <nowiki>0,4043.576433,7400.316980,58.647405,20150601201258.000,64,12,0.548363,100.442406</nowiki>
  
−
Can  be parsed out to:
+
Cette ligne de donnée peut être traitée pour obtenir les informations suivantes:
−
* '''0''' - this is the mode (will be 0)
+
* '''0''' - ceci est le mode (qui sera 0)
−
* '''4043.576433''' - this is the longitude
+
* '''4043.576433''' - pour la longitude
−
* '''7400.316980''' - this is the latitude
+
* '''7400.316980''' - pour la latitude
  
−
{{ambox|text=People often get confused because the GPS is working but is "5 miles off" - this is because they are not parsing the lat/long data correctly. Despite appearances, the geolocation data is NOT in decimal degrees. It is in degrees and minutes in the following format: Latitude: DDMM.MMMM (The first two characters are the degrees.) Longitude: DDDMM.MMMM (The first three characters are the degrees.) }}
+
{{ambox|text=Il arrive régulièrement que les utilisateurs soient prit de confusion parce que malgré le bon fonctionnement du GPS, la position semble incorrecte de quelques kilomètres - cela est causé par une mauvaise interpretation/calcul des données lat/long. Contrairement aux apparences, la géolocalisation N'EST PAS EXPRIME avec une valeur décimale (pour les degrés). La valeur est exprimée en degrés et minutes en utilisant le format suivant: Latitude: DDMM.MMMM (Les deux premiers caractères sont les degrés.) Longitude: DDDMM.MMMM (les trois premiers caractères sont des degrés.) }}
  
−
* '''58.647405''' - this is the altitude in meters
+
* '''58.647405''' - est l'altitude en mètre
−
* '''20150601201258.000''' - this is the UTC time in yyymmddHHMMSS.ms format. E.g. this is year 2015, month 06, date 01, 20 hour, 12 minute, 58 seconds. If you are not in UTC timezone you'll have to adjust this for your local time
+
* '''20150601201258.000''' - Le temps untiversel (UTC) au format yyymmddHHMMSS.ms format. Ex: c'est l'année 2015, mois 06, date 01, 20 heures, 12 minutes, 58 secondes. Il vous vaudra calculer (ajuster) cette heure si vous n'êtes pas dans la zone de temps UTC afin de pouvoir déterminer l'heure locale.
−
* '''64''' - is the ttff, time to first fix, in seconds
+
* '''64''' - est le temps pour obtenir le premier fix (en seconde)
−
* '''12''' - is the # of visible satelites
+
* '''12''' - Le nombre de satellites visibles.
−
* '''0.548363''' - is the speed (in knots)
+
* '''0.548363''' - est la vitesse (exprimé en unité "knots")
−
* '''100.442406''' - this is the best guess for 'course', e.g. which way you are heading, with 0 being 'north' and 180 being 'south' (we think)
+
* '''100.442406''' - Estimation ''at the best'' de la direction de déplacement actuel. La valeur 0 étant le 'nord' et 180 étant le 'sud' (par déduction)
  
−
If you want to get the 'raw NMEA' data for some reason, you can do that with '''E''' - you can send a number from 0-255 indicating which sentences you want emittted.
+
Si vous désirez obtenir les données 'NMEA brutes', vous pouvez utiliser la commande '''E''' - vous pouvez envoyer un nomre entre 0 et 255 indiquant quel information (NMEA sentence) vous désirez omettre.
  
−
* 0 for disable output
+
* 0 désactiver la sortie (le flux NMEA.
−
* +2 for $GPGGA
+
* +2 pour $GPGGA
−
* +4 for $GPGLL
+
* +4 pour $GPGLL
−
* +8 for $GPGSA
+
* +8 pour $GPGSA
−
* +16 for $GPGSV
+
* +16 pour $GPGSV
−
* +32 for $GPRMC
+
* +32 pour $GPRMC
−
* +64 for $GPVTG
+
* +64 pour $GPVTG
−
* +128 for GPZDA
+
* +128 pour GPZDA
  
−
e.g. if you want to see GPRMC and GPGGA, add +32 and +2 = 34 and put in that number. Then you'll see the data stream out at 1Hz
+
Ex: si vous désirez voir les informations GPRMC et GPGGA, faites l'addition de +32 et +2 = 34 et saisissez cette valeur. Vous allez ensuite voir le flux de donnée produit avec une fréquence de 1Hz
  
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-70.jpg}}
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-70.jpg}}
  
−
When done, you can type in '''E''' and '''0''' (zéro) instead, which will turn off the output
+
Lorsque vous avez terminé vos traitement, vous pouvez interrompre le flux en saisissant '''E''' et '''0''' (zéro)
  
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-71.jpg}}
 
{{ADFImage|ADAFRUIT-FONA-Arduino-Test-71.jpg}}
  
 
{{ADAFRUIT-FONA-TRAILER}}
 
{{ADAFRUIT-FONA-TRAILER}}

Version actuelle datée du 23 novembre 2015 à 16:23


MCHobby investit du temps et de l'argent dans la réalisation de traduction et/ou documentation. C'est un travail long et fastidieux réalisé dans l'esprit Open-Source... donc gratuit et librement accessible.
SI vous aimez nos traductions et documentations ALORS aidez nous à en produire plus en achetant vos produits chez MCHobby.

Préambule

Stop
 La bibliotèque Fona est toujours en développement! cette page pourrait donc changer prochainement.

Télécharger Adafruit_FONA

Avant de pouvoir lire les données depuis le module Fona, vous aurez besoin de télécharger la bibliothèque Adafruit_FONA depuis le dépôt github. Vous pouvez réaliser cette tâche en visitant le dépôt github et procéder à un téléchargement manuel ou, plus facile, cliquer sur le bouton de téléchargement de l'archive zip

Download-icon.pngTéléchargez la bibliothèque Adafruit_FONA

Renommez et décompressez l'archive dans un répertoire nommé Adafruit_FONA et vérifiez que le répertoire Adafruit_FONA contient bien les fichiers Adafruit_FONA.cpp et Adafruit_FONA.h

Placez la bibliothèque Adafruit_FONA dans votre répertoire répertoire_des_croquis_arduino/libraries/ .

Vous pourriez avoir besoin de créer un sous-répertoire libraries s'il s'agit de votre nouvelle bibliothèque. Redémarrez votre IDE Arduino.

Nous disposons d'un tutoriel pour l'installation de bibliothèque si vous avez besoin d'un petit coup de main.

Charger la démo

Ouvrez le croquis Fichier->Exemples->Adafruit_FONA->FONAtest et téléversez/téléchargez le sur votre Arduino branché au module Fona.

Pour un Arduino Mega, Leonardo ou Micro, vous devez changer la définition de FONA_TX vers la broche utilisée (voyez les broches supportées comme FONA_TX sur ces plateformes, voyez ce tuto)!

ADAFRUIT-FONA-Arduino-Test-10.png
Crédit: AdaFruit Industries www.adafruit.com

Assurez-vous d'avoir chargé votre Accu LiPoly 3.7/4.2V (ou accu LiIon) et d'avoir branché l'accu et l'antenne sur le Fona

ADAFRUIT-FONA-Arduino-Test-11.jpg
Crédit: AdaFruit Industries www.adafruit.com

ADAFRUIT-FONA-Asm-20.jpg
Crédit: AdaFruit Industries www.adafruit.com

Une fois téléchargé/téléversé sur votre Arduino, ouvrez la console série et fixez le débit sur 115200 bauds pour commencer à tester le programme.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Assurez-vous également que vous avez bien utilisé "NL & CR" comme option d'envoi de commande. Cela signifie que lorsque vous envoyez des données vers votre Arduino avec la console, les données envoyées seront terminée par un NL + un CR.

NL & CR signifie "newline/return" que l'on traduira pas "Nouvelle Ligne/Retour Clavier" correspondant au caractère chr(10) / chr(13) dans les programmes.

Utiliser ce Croquis

Le croquis de test dispose d'une interface menu permettant de tester tout ce qu'il est possible de réaliser avec un Fona.

Ce menu pourrait être complété avec de nouvelles fonctionnalités lorsque qu'Adafruit fera des mise-à-jour de sa bibliothèque!

Tension de l'accu

Commençons par lire la tension de l'accu (nous parlons de l'accu Lipoly branché sur le Fona). C'est pratique si nous avons besoin de savoir si le niveau de l'accu est bas!

Tapez b dans la fenêtre de commande et pressez le bouton Send (envoi)

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Vous verrez alors apparaître la tension de l'accu en mV (millivolts). Dans notre cas, il s'agit de 3.726 Volts

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Vérifier le CCID de la carte SIM

Vous pouvez vérifier que la carte SIM est insérée et fonctionne correctement en lisant le CCID, qui est l'identifiant unique de la carte.

Saisissez C dans la zone de commande.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Vérifier le RSSI (force du signal)

Vous pouvez interroger le FONA sur la force du signal avec la commande i. La réponse est un nombre que vous pouvez convertir en dBm. Essayez d'avoir une force de signal supérieur à 5 pour faire des appels, envoyer des SMS, etc.

Dans notre cas, nous avons obtenu 10

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Vérifier l'enregistrement réseau

Si votre FONA dispose d'un bon signal, il va automatiquement essayer de localiser la tour d'émission de la cellule réseau et s'y enregistrer.

Vous pouvez vérifier le statut du réseau avec la commande n

Une fois enregistré sur le réseau cellulaire, votre Fona aura encore besoin de 5-10 secondes suppélementaire pour essayer d'accéder/envoyer des SMS ou faire des appels téléphoniques.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Volume audio

Vous pouvez fixer le volume audio à l'aide de la commande v. Vous pouvez obtenir le volume actuel avec la commande V - il s'agit d'un pourcentage de volume (entre 0 et 100%).

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Casque Audio et Audio externe

Le FONA est équipé de deux voies audio. Une via la prise casque(le connecteur audio jack de 3.5mm) et l'autre via une sortie externe (dite "external" en anglais).

Pour utiliser la sortie externe, vous avez besoin d'utiliser les deux broches "haut-parleur/speaker" et broches "microphone/mic". La radio FM, appel vocaux, tonalités, etc peuvent être routés vers l'une ou l'autre des sorties audio.

  • Utilisez la commande H, pour renvoyer l'audio le sortie casque
  • Utilisez la commande e, pour renvoyer l'audio vers la sortie audio
 Notez que le FONA 808 ne dispose que d'une sortie casque (Headset). Dans ce cas de figure, sélectionner la sortie extérieur ne changera rien.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Jouer des sons (tonalités)

Vous pouvez tester la sortie audio en produisant des sons à l'aide de du "toolkit tones" produisant des tonalités. De nombreux téléphones cellulaires imitent la tonalité des anciennes lignes téléphoniques avec ce type de fonctionnalité. Vous pouvez vérifier la commande AT+STTONE avec la fiche technique des commandes AT. Aux état-unis, la tonalité Américaine correspond à #20.

Vous pouvez passer en mode casque (headset), jouer une tonaliter, puis essayer de passer en mode audio externe. Il est très facile d'essayer les deux voies audio pour faire du débogage.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

PWM/Buzzer

Le FONA dispose d'une seul broche PWM (sortie PWM) que vous pouvez utiliser pour controler un Piezo ou un moteur vibrant. La fiche technique manque un peu de clareté concernant l'utilisation de ce mode 'PWM' sur lequel vous disposez du plein contrôle de fréquence et cycle utile.

Dans le mode utilisé par la bibliothèque, vous pouvez fixer la fréquence entre 1 et 2000 Hz et disposer d'un cycle utile de 50% (duty cycle). La broche PWM est une sortie "directe" du module SIM800, à 2.8Vpp!. Le broche Buzzer est pilotée par PWM via un transistor PNP, ce qui vous permet d'utiliser Buzzer pour piloter un buzzer motorisé alimenté par l'accu lipoly.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Faire un appel

Super... maintenant, nous allons pouvoir commencer les choses vraiment intéressante. Vous pouvez faire des appel à l'aide de FONA vraiment facilement. Assurez vous d'avoir activé la bonne sortie audio (externe ou casque) avant d'aller plus loin

Faite un appel avec c - l'appel se fait en tâche de fond (background task en anglais). Quand vous avez terminé votre appel/conversation, vous pouvez raccorder avec h.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Hang Up - le pragmatisme à l anglaise

"h" correspond à "Hang Up" que l'on traduit littéralement par pendre en haut. Bizarre pour raccrocher un appel. De nos vous, l'on ferme un clapet... ou l'on dépose le cornet sur le téléphone (pour ceux qui connaissent en encore ce modèle de téléphone. Haut début de l'histoire du téléphone, ces derniers étaient fixés aux murs de sorte à pouvoir parler dans ce qui semblait être le microphone et maintenir une sorte de "casque" sur l'oreille. Pour terminer l'appel, il fallait re-prendre le casque sur son berceau'. Ce berceau étant au dessus du microphone (et microphone devant votre bouche), il fallait lever le bras.

ADAFRUIT-FONA-Arduino-Test-56a.jpg
source: Wikimedia common

Voila pourquoi "raccrocher" se dit "prendre en en haut" (Hang Up) chez les anglophones.

En fin de compte, l'anglais ce n'est pas compliqué mais pragmatique (mais si cela date d'un autre temps).

Envoyer et recevoir des SMS

Une autre chose facile à réaliser est l'envoi d'un message SMS (texto). Commençons par envoyez un SMS. Nous utiliserons ici le code court 40404 de twitter, qui effectue une réponse automatique... pratique pour vérifier l'envoi et la réception de SMS.

Note: Chez mchobby nous l'avons testé la fonctionnalité avec un numéro de téléphone standard au format international +32xxxxxxx.

Vous pouvez envoyer des SMS multi-lignes avec l'API de la bibliothèque mais dans cet exemple, il est plus facile de faire un parsing des données si elles sont contenues dans une seule ligne!

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Vous pouvez ensuite demander à la carte SIM combien de SMS elle contient avec N et vous pouvez tous les lires avec R

Note: les SMS sont stockés dans des "slots" mais le nombre n'inclus pas les slots vides. Nous allons présenter cela des les détails dans un petit moment

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Vous pouvez lire un SMS individuel avec r

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Et effacer le SMS contenu dans un numéro de slot avec d

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Notez qu'une fois les SMS #2 effacé, si vous essayez de le relire ensuite, le slot sera indiqué comme "vide" (empty en anglais).

Egalement très important: ce n'est pas parce que le SMS à été effacé dans le slot #2 que le SMS dans le slot #3 est déplacé dans le slot #2. Après avoir effacé le SMS dans le slot #2, le slot #2 reste vide et le SMS dans le slot #3 reste dans le slot #3!

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Radio FM (FONA 800 uniquement)

Si votre FONA dispose d'un récepteur FM, il utilise le casque comme 'antenne' et fonctionne plutôt bien! Le son de la radio est reproduit sur la voie audio sélectionnée (casque ou haut-parleur).

Vous pouvez fixer la fréquence FM sélectionnée par multiple de 100KHz. Par conséquent, si vous désirez obtenir la fréquence de 88.1MHz, saisissez la valeur de 881. Pour la fréquence de 102.3 Mhz, saisissez la valeur 1023.

Utilisez la commande f pour ouvrir et fixer la fréquence, et F pour la clôturer.

La fonction Radio FM est uniquement disponible sur le FONA 800, le FONA 808 ne contient pas de tuner radio.

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Sous module GPS (FONA 808 uniquement)

The FONA 808 inclus un module GPS que vous pouvez utiliser pour localiser votre position! Vous aurez besoin de brancher une antenne GPS sur le connecteur µFL et faire en sorte que l'antenne GPS soit positionnée à l'extérieur (et pointant vers le ciel).

Vous commencez en activant le module GPS avec la commande O (lettre 'o' en capital) et vous pouvez interroger le le statut de la synchronisation satellite (dit 'fix') avec la commande x.

Une minute ou deux seront nécessaire pour obtenir cette synchronisation (fix).

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Une fois que vous avez obtenu le fix, vous pouvez interroger le module pour obtenir votre position (mais aussi l'heure) à l'aide de la commande L

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Les données sont produites sous le format comma-seperated (valeurs séparées par une virgule): 

0,4043.576433,7400.316980,58.647405,20150601201258.000,64,12,0.548363,100.442406

Cette ligne de donnée peut être traitée pour obtenir les informations suivantes:

  • 0 - ceci est le mode (qui sera 0)
  • 4043.576433 - pour la longitude
  • 7400.316980 - pour la latitude
 Il arrive régulièrement que les utilisateurs soient prit de confusion parce que malgré le bon fonctionnement du GPS, la position semble incorrecte de quelques kilomètres - cela est causé par une mauvaise interpretation/calcul des données lat/long. Contrairement aux apparences, la géolocalisation N'EST PAS EXPRIME avec une valeur décimale (pour les degrés). La valeur est exprimée en degrés et minutes en utilisant le format suivant: Latitude: DDMM.MMMM (Les deux premiers caractères sont les degrés.) Longitude: DDDMM.MMMM (les trois premiers caractères sont des degrés.)
  • 58.647405 - est l'altitude en mètre
  • 20150601201258.000 - Le temps untiversel (UTC) au format yyymmddHHMMSS.ms format. Ex: c'est l'année 2015, mois 06, date 01, 20 heures, 12 minutes, 58 secondes. Il vous vaudra calculer (ajuster) cette heure si vous n'êtes pas dans la zone de temps UTC afin de pouvoir déterminer l'heure locale.
  • 64 - est le temps pour obtenir le premier fix (en seconde)
  • 12 - Le nombre de satellites visibles.
  • 0.548363 - est la vitesse (exprimé en unité "knots")
  • 100.442406 - Estimation at the best de la direction de déplacement actuel. La valeur 0 étant le 'nord' et 180 étant le 'sud' (par déduction)

Si vous désirez obtenir les données 'NMEA brutes', vous pouvez utiliser la commande E - vous pouvez envoyer un nomre entre 0 et 255 indiquant quel information (NMEA sentence) vous désirez omettre.

  • 0 désactiver la sortie (le flux NMEA.
  • +2 pour $GPGGA
  • +4 pour $GPGLL
  • +8 pour $GPGSA
  • +16 pour $GPGSV
  • +32 pour $GPRMC
  • +64 pour $GPVTG
  • +128 pour GPZDA

Ex: si vous désirez voir les informations GPRMC et GPGGA, faites l'addition de +32 et +2 = 34 et saisissez cette valeur. Vous allez ensuite voir le flux de donnée produit avec une fréquence de 1Hz

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Lorsque vous avez terminé vos traitement, vous pouvez interrompre le flux en saisissant E et 0 (zéro)

{{{2}}}
Crédit: AdaFruit Industries www.adafruit.com

Source: Adafruit FONA - Call phones, send and receive SMSs, & more! All with FONA. Ecrit par Lady Ada pour AdaFruit. Crédit AdaFruit Industries

Traduit par Meurisse D. pour MCHobby.be

Traduit avec l'autorisation d'AdaFruit Industries - Translated with the permission from Adafruit Industries - www.adafruit.com

Toute référence, mention ou extrait de cette traduction doit être explicitement accompagné du texte suivant : «  Traduction par MCHobby (www.MCHobby.be) - Vente de kit et composants » avec un lien vers la source (donc cette page) et ce quelque soit le média utilisé.

L'utilisation commercial de la traduction (texte) et/ou réalisation, même partielle, pourrait être soumis à redevance. Dans tous les cas de figures, vous devez également obtenir l'accord du(des) détenteur initial des droits. Celui de MC Hobby s'arrêtant au travail de traduction proprement dit.

Récupérée de « https://wiki.mchobby.be/index.php?title=ADAFRUIT-FONA-Arduino-Test&oldid=16539 »