ADAFRUIT-FONA-Arduino-Test

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche


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.
En cours de traduction/élaboration.

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

Another easy thing you can do is send and receive SMS messages. Lets start by sending an SMS. We'll use twitter's 40404 short code, which will auto respond, making it easy to verify both sending and receiving

You can send multi-line SMS's using the library API but for this example, its easier to parse the data if its a single line!

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

You can then ask the SIM how many SMS's it has with N and read all of them with R

Note that SMS's are referred to by slots but the number does not include empty slots. We'll show this in detail in a bit

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

You can read individual SMS's with r

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

And delete SMS's by slot # with d

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

Note that before I deleted SMS #2, so if I read them again, that SMS # will be an empty slot. SMS number #3 doesn't "move slots"!

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

Radio FM (FONA 800 uniquement)

The FONA has an FM receive in it. It uses the headset as the 'antenna' but it works pretty well considering! The FM radio goes thru whatever audio path you have set up

You can open and tune to an FM frequency in units of 100KHz. So if you want to tune to 88.1MHz, type in 881. For 102.3, type in 1023.

Use the f command to open and tune, and F to close it

FM radio tuning/listening is only for FONA 800, the 808 does not contain a tuner

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

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

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.

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

Once you have a fix you can query and get the location/time data with L

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

The data is in a comma-seperated format: 

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

Can be parsed out to:

  • 0 - this is the mode (will be 0)
  • 4043.576433 - this is the longitude
  • 7400.316980 - this is the latitude
 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.)
  • 58.647405 - this is the altitude in meters
  • 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
  • 64 - is the ttff, time to first fix, in seconds
  • 12 - is the # of visible satelites
  • 0.548363 - is the speed (in 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)

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.

  • 0 for disable output
  • +2 for $GPGGA
  • +4 for $GPGLL
  • +8 for $GPGSA
  • +16 for $GPGSV
  • +32 for $GPRMC
  • +64 for $GPVTG
  • +128 for 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

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

When done, you can type in E and 0 (zéro) instead, which will turn off the output

{{{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=16483 »