Différences entre versions de « Bluefruit-LE-Shield-Hardware »

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
 
(15 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
 
{{Bluefruit-LE-Shield-NAV}}
 
{{Bluefruit-LE-Shield-NAV}}
  
−
== Commande matériel ==
+
== Commandes matériel ==
−
The following commands allow you to interact with the low level HW on the Bluefruit LE module, such as reading or toggling the GPIO pins, performing an ADC conversion ,etc.:
+
Les commandes suivantes vous permettent d'interagir avec la bas niveau matériel du module Bluefruit LE. Vous pourrez lire et modifier l'état des GPIO, effectuer une conversion Analogique-vers-digital (ADC), etc.
  
 
== AT+BAUDRATE ==
 
== AT+BAUDRATE ==
−
Changes the baud rate used by the HW UART peripheral on the nRF51822.
+
Change le débit (''baud rate'' en anglais) utilisé par l'UART matériel du nRF51822.
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
−
* Parameters: Baud rate, which must be one of the following values:  
+
* Paramètres: débit en bauds. Doit être une des valeurs suivantes:  
 
** 1200
 
** 1200
 
** 2400
 
** 2400
Ligne 24 : Ligne 24 :
 
** 921600
 
** 921600
 
** 1000000
 
** 1000000
−
* Output: The current baud rate
+
* Sortie: Le configuration courante du débit
  
−
  <nowiki># Set the baud rate to 115200
+
  <nowiki># Fixe le débit à 115200 bauds
 
AT+BAUDRATE=115200
 
AT+BAUDRATE=115200
 
OK
 
OK
  
−
# Check the current baud rate
+
# Vérifier la configuration du débit
 
AT+BAUDRATE
 
AT+BAUDRATE
 
115200
 
115200
Ligne 36 : Ligne 36 :
  
 
== AT+HWADC ==
 
== AT+HWADC ==
−
Performs an ADC conversion on the specified ADC pin
+
Effectue une conversion ADC (analogique vers digital) pour une broche ADC spécifique
  
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
−
* Parameters: The ADC channel (0..7)
+
* Paramètres: Le canal ADC (0..7)
−
* Output: The results of the ADC conversion
+
* Sortie: Le résultat de la conversion ADC
  
 
  <nowiki>AT+HWADC=0
 
  <nowiki>AT+HWADC=0
 
178
 
178
 +
OK</nowiki>
 +
 +
== AT+HWGETDIETEMP ==
 +
Obtenir la température (en degrés Celcius) du composant BLE. Peut être utilisé pour faire du débogage (un courant plus élevé signifie généralement une consommation de courant plus important). Cette information ne correspond pas à la température ambiante et ne peut donc pas être utilisé pour remplacer un senseur de température normal.
 +
 +
* Codebase Revision: 0.3.0
 +
* Paramètres: Aucun
 +
* Sortie: Le température du composant BLE (en degré Celcuis)
 +
 +
<nowiki>AT+HWGETDIETEMP
 +
32.25
 +
OK</nowiki>
 +
 +
== AT+HWGPIOMODE ==
 +
Cette commande permet de configurer le mode d'une broche GPIO (en entrée/sortie, etc).
 +
 +
* Codebase Revision: 0.3.0
 +
* Paramètres: cette commande accepte une ou deux valeur (séparés par une virgule lorsqu'il y a deux paramètres):
 +
** Le numéro de broche/GPIO
 +
** Le nouveau mode de la broche/GPIO, où:
 +
*** 0 = Entrée/Input
 +
*** 1 = Sortie/Output
 +
*** 2 = Entrée avec activation PullUp (résistance interne qui ramène le potentiel par défaut de la broche à +VCC)
 +
*** 3 = Entrée avec activation PullDown (résistance interne qui ramène le potentiel par défaut de la broche à GND)
 +
* Sortie: Si un seul paramètre est fourni à la commande (le numéro de broche GPIO) alors la commande retourne le mode actuellement configuré pour la broche.
 +
 +
{{ambox-stop|text=Certaines broches sont réservées pour des fonctions spécifiques du module Bluefruit et ne peuvent pas être utilisées comme GPIO. La commande retournera 'ERROR' si vous essayez d'utiliser ces numéros réservés. }}
 +
 +
<nowiki># Configurer la broche 14 en sortie/output
 +
AT+HWGPIOMODE=14,0
 +
OK
 +
 +
# Obtenir le mode en cours d'utilisation pour la broche 14
 +
AT+HWPGIOMODE=14
 +
0
 +
OK</nowiki>
 +
 +
== AT+HWGPIO ==
 +
Lire ou fixer la valeur de la broche GPIO spécifiée (en fonction du mode de la broche).
 +
 +
* Codebase Revision: 0.3.0
 +
* Paramètres: les paramètres de cette commande changent en fonction du mode de la broche.
 +
 +
=== GPIO en sortie ===
 +
MODE DE SORTIE/OUTPUT MODE: Les paramètres suivants (séparés par des virgules) peuvent être utilisés pour modifier l'état d'une broche configurée en sortie:
 +
* Numéro de broche
 +
* Etat de la broche, où:
 +
** 0 = désactive la broche (Niveau logique bas/LOW/GND)
 +
** 1 = active la broche (Niveau logique haut/HIGH/VCC)
 +
 +
=== GPIO en entrée ===
 +
MODE ENTREE/INPUT MODE: Pour lire létat actuel d'une broche en entrée (ou lire l'état d'une broche en sortie). Utiliser le numéro de broche comme le seul paramètre de la commande.
 +
 +
* Sortie: L'état de la broche si vous lisez une entrée (ou vérifiez l'état de sortie d'une broche). La valeur retournée est:
 +
** 0 signifiant que la broche est au niveau logique bas/LOW/GND
 +
** 1 signifiant que la broche est au niveai logique haut/HIGH/VCC
 +
 +
=== Recommendation ===
 +
{{ambox-stop|text=Essayer de fixer l'état d'une broche qui n'a pas encore été configurée produira la réponse 'ERROR'.}}
 +
{{ambox-stop|text=Certaines broches du BlueFruit LE sont réservée pour des fonctions spécifiques. Ces broches ne peuvent pas être utilisées comme GPIO. La commande génèrera une erreur si vous essayez d'utiliser ces numéros réservés. }}
 +
 +
=== Exemples ===
 +
<nowiki># Place la broche 14 au niveau haut/HIGH
 +
AT+HWGPIO=14,1
 +
OK
 +
 
 +
# Place la broche 14 au niveau bas/LOW
 +
AT+HWGPIO=14,0
 +
OK
 +
 
 +
# Lire l'état de la broche 14 14
 +
AT+HWGPIO=14
 +
0
 +
OK
 +
 
 +
# Essayer de modifier une broche qui n'est pas
 +
# configuré en sortie/output
 +
AT+HWGPIOMODE=14,0
 +
OK
 +
AT+HWGPIO=14,1
 +
ERROR</nowiki>
 +
 +
== AT+HWI2CSCAN ==
 +
Fait un scan du bus I2C et essaye de détecter les périphériques I2C qui y sont connectés. Retourne une lise des adresses détectés par le processus de scan.
 +
 +
* Codebase Revision: 0.3.0
 +
* Paramètres: Aucun
 +
* Sortie: Une liste des adresse I2C occupées (séparées par des virgules) durant le processus de scan, ou rien si aucun périphérique n'est détecté.
 +
 +
<nowiki># Scan I2C avec deux périphériques détecté
 +
AT+HWI2CSCAN
 +
0x23,0x35
 +
OK
 +
 +
# Scan I2C sans périphériques détectés
 +
AT+HWI2CSCAN
 +
OK</nowiki>
 +
 +
== AT+HWVBAT ==
 +
Retourne la mesure de la tension d'alimentation en milli-volts
 +
* Codebase Revision: 0.3.0
 +
* Paramètres: Aucun
 +
* Sortie: Le niveau de VBAT en milli-volts
 +
 +
<nowiki>AT+HWVBAT
 +
3248
 +
OK</nowiki>
 +
 +
== AT+HWRANDOM ==
 +
Génère un nombre aléatoire (32-bits) en utilisant le générateur de nombre aléatoire matériel du nRF51822 (basé sur le bruit blanc).
 +
* Codebase Revision: 0.4.7
 +
* Paramètres: Aucun
 +
* Sortie: un nombre aléatoire 32-bits encodé en hexadécimal (ex. '0x12345678')
 +
 +
<nowiki>AT+HWRANDOM
 +
0x769ED823
 +
OK</nowiki>
 +
 +
== AT+HWMODELED ==
 +
Permet d'écraser la fonctionnalité par défaut de la LED "mode" (qui indique, par défaut, indique le mode de fonctionnement).
 +
 +
* Codebase Revision: 0.6.6
 +
* Paramètres: mode de fonctionnement de la LED, qui peut être une des valeurs suivantes:
 +
** '''disable''' ou '''DISABLE''' ou '''0''' - Désactive complètement la Led MODE pour économiser de l'énergie.
 +
** '''mode''' ou '''MODE''' ou '''1''' - Fonctionnement par défaut, indique le MODE actuel.
 +
** '''hwuart''' ou '''HWUART''' ou '''2''' - reconfigure l'activité de la LED sur l'activité de l'UART matériel (bus série matériel, TX ou RX)
 +
** '''bleuart''' ou '''BLEUART''' ou '''3''' - reconfigure l'activité de la LED sur l'activité du service BLE UART (caractéristique TX ou RX)
 +
** '''spi''' ou '''SPI''' ou '''4''' - reconfigure l'activité de la LED sur l'activité SPI
 +
** '''manual''' ou '''MANUAL''' ou '''5''' - permet de configurer l'état de la Led MODE à l'aide d'un second paramètre (séparé par une virgule) qui peut être "on", "off" ou "toggle" (pour inverser l'état).
 +
* Sortie: Si la commande est exécutée sans paramètre, la commande retourne une chaîne de caractère en majuscule représentant le mode de fonctionnement actuel de la LED (tel que présenté ci-dessus).
 +
 +
<nowiki># Obtenir la configuration de la Led
 +
AT+HWMODELED
 +
MODE
 +
OK
 +
 
 +
# Changer le fonctionnement de la Led vers BLEUART
 +
AT+HWMODELED=BLEUART
 +
OK
 +
 +
# Inverser manuellement l'état de la Led MODE
 +
AT+HWMODELED=MANUAL,TOGGLE
 +
OK</nowiki>
 +
 +
== AT+UARTFLOW ==
 +
Active ou désactive le contrôle de flux matériel (CTS + RTS) pour le port série/UART sur le nRF51822.
 +
 +
* Codebase Revision: 0.7.0
 +
* Paramètres: Etat du contrôle de flux matériel. Peut prendre l'une des valeurs suivantes:
 +
** '''on''' ou '''1''' - activer
 +
** '''off''' ou '''0''' - désactiver
 +
* Sortie: Si la commande est exécutée sans paramètre, elle retour un nombre 0 ou 1 indiquant si le contrôle de flux est activé (1) ou désactivé (0).
 +
 +
<nowiki># Vérifie l'état du contrôle de flux
 +
AT+UARTFLOW
 +
1
 +
OK
 +
 +
# Désactive le contrôle de flux matériel
 +
AT+UARTFLOW=off
 
OK</nowiki>
 
OK</nowiki>
  
 
{{Bluefruit-LE-Shield-TRAILER}}
 
{{Bluefruit-LE-Shield-TRAILER}}

Version actuelle datée du 4 juin 2017 à 11:26


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.

Commandes matériel

Les commandes suivantes vous permettent d'interagir avec la bas niveau matériel du module Bluefruit LE. Vous pourrez lire et modifier l'état des GPIO, effectuer une conversion Analogique-vers-digital (ADC), etc.

AT+BAUDRATE

Change le débit (baud rate en anglais) utilisé par l'UART matériel du nRF51822.

  • Codebase Revision: 0.7.0
  • Paramètres: débit en bauds. Doit être une des valeurs suivantes:
    • 1200
    • 2400
    • 4800
    • 9600
    • 14400
    • 19200
    • 28800
    • 38400
    • 57600
    • 76800
    • 115200
    • 230400
    • 250000
    • 460800
    • 921600
    • 1000000
  • Sortie: Le configuration courante du débit
# Fixe le débit à 115200 bauds
AT+BAUDRATE=115200
OK

# Vérifier la configuration du débit
AT+BAUDRATE
115200
OK

AT+HWADC

Effectue une conversion ADC (analogique vers digital) pour une broche ADC spécifique

  • Codebase Revision: 0.3.0
  • Paramètres: Le canal ADC (0..7)
  • Sortie: Le résultat de la conversion ADC
AT+HWADC=0
178
OK

AT+HWGETDIETEMP

Obtenir la température (en degrés Celcius) du composant BLE. Peut être utilisé pour faire du débogage (un courant plus élevé signifie généralement une consommation de courant plus important). Cette information ne correspond pas à la température ambiante et ne peut donc pas être utilisé pour remplacer un senseur de température normal.

  • Codebase Revision: 0.3.0
  • Paramètres: Aucun
  • Sortie: Le température du composant BLE (en degré Celcuis)
AT+HWGETDIETEMP
32.25
OK

AT+HWGPIOMODE

Cette commande permet de configurer le mode d'une broche GPIO (en entrée/sortie, etc).

  • Codebase Revision: 0.3.0
  • Paramètres: cette commande accepte une ou deux valeur (séparés par une virgule lorsqu'il y a deux paramètres):
    • Le numéro de broche/GPIO
    • Le nouveau mode de la broche/GPIO, où:
      • 0 = Entrée/Input
      • 1 = Sortie/Output
      • 2 = Entrée avec activation PullUp (résistance interne qui ramène le potentiel par défaut de la broche à +VCC)
      • 3 = Entrée avec activation PullDown (résistance interne qui ramène le potentiel par défaut de la broche à GND)
  • Sortie: Si un seul paramètre est fourni à la commande (le numéro de broche GPIO) alors la commande retourne le mode actuellement configuré pour la broche.
Stop
 Certaines broches sont réservées pour des fonctions spécifiques du module Bluefruit et ne peuvent pas être utilisées comme GPIO. La commande retournera 'ERROR' si vous essayez d'utiliser ces numéros réservés. 
# Configurer la broche 14 en sortie/output
AT+HWGPIOMODE=14,0
OK

# Obtenir le mode en cours d'utilisation pour la broche 14
AT+HWPGIOMODE=14
0
OK

AT+HWGPIO

Lire ou fixer la valeur de la broche GPIO spécifiée (en fonction du mode de la broche).

  • Codebase Revision: 0.3.0
  • Paramètres: les paramètres de cette commande changent en fonction du mode de la broche.

GPIO en sortie

MODE DE SORTIE/OUTPUT MODE: Les paramètres suivants (séparés par des virgules) peuvent être utilisés pour modifier l'état d'une broche configurée en sortie:

  • Numéro de broche
  • Etat de la broche, où:
    • 0 = désactive la broche (Niveau logique bas/LOW/GND)
    • 1 = active la broche (Niveau logique haut/HIGH/VCC)

GPIO en entrée

MODE ENTREE/INPUT MODE: Pour lire létat actuel d'une broche en entrée (ou lire l'état d'une broche en sortie). Utiliser le numéro de broche comme le seul paramètre de la commande.

  • Sortie: L'état de la broche si vous lisez une entrée (ou vérifiez l'état de sortie d'une broche). La valeur retournée est:
    • 0 signifiant que la broche est au niveau logique bas/LOW/GND
    • 1 signifiant que la broche est au niveai logique haut/HIGH/VCC

Recommendation

Stop
 Essayer de fixer l'état d'une broche qui n'a pas encore été configurée produira la réponse 'ERROR'.
Stop
 Certaines broches du BlueFruit LE sont réservée pour des fonctions spécifiques. Ces broches ne peuvent pas être utilisées comme GPIO. La commande génèrera une erreur si vous essayez d'utiliser ces numéros réservés.

Exemples

# Place la broche 14 au niveau haut/HIGH
AT+HWGPIO=14,1
OK
  
# Place la broche 14 au niveau bas/LOW
AT+HWGPIO=14,0
OK
  
# Lire l'état de la broche 14 14
AT+HWGPIO=14
0
OK
  
# Essayer de modifier une broche qui n'est pas 
# configuré en sortie/output
AT+HWGPIOMODE=14,0
OK
AT+HWGPIO=14,1
ERROR

AT+HWI2CSCAN

Fait un scan du bus I2C et essaye de détecter les périphériques I2C qui y sont connectés. Retourne une lise des adresses détectés par le processus de scan.

  • Codebase Revision: 0.3.0
  • Paramètres: Aucun
  • Sortie: Une liste des adresse I2C occupées (séparées par des virgules) durant le processus de scan, ou rien si aucun périphérique n'est détecté.
# Scan I2C avec deux périphériques détecté
AT+HWI2CSCAN
0x23,0x35
OK

# Scan I2C sans périphériques détectés
AT+HWI2CSCAN
OK

AT+HWVBAT

Retourne la mesure de la tension d'alimentation en milli-volts

  • Codebase Revision: 0.3.0
  • Paramètres: Aucun
  • Sortie: Le niveau de VBAT en milli-volts
AT+HWVBAT
3248
OK

AT+HWRANDOM

Génère un nombre aléatoire (32-bits) en utilisant le générateur de nombre aléatoire matériel du nRF51822 (basé sur le bruit blanc).

  • Codebase Revision: 0.4.7
  • Paramètres: Aucun
  • Sortie: un nombre aléatoire 32-bits encodé en hexadécimal (ex. '0x12345678')
AT+HWRANDOM
0x769ED823
OK

AT+HWMODELED

Permet d'écraser la fonctionnalité par défaut de la LED "mode" (qui indique, par défaut, indique le mode de fonctionnement).

  • Codebase Revision: 0.6.6
  • Paramètres: mode de fonctionnement de la LED, qui peut être une des valeurs suivantes:
    • disable ou DISABLE ou 0 - Désactive complètement la Led MODE pour économiser de l'énergie.
    • mode ou MODE ou 1 - Fonctionnement par défaut, indique le MODE actuel.
    • hwuart ou HWUART ou 2 - reconfigure l'activité de la LED sur l'activité de l'UART matériel (bus série matériel, TX ou RX)
    • bleuart ou BLEUART ou 3 - reconfigure l'activité de la LED sur l'activité du service BLE UART (caractéristique TX ou RX)
    • spi ou SPI ou 4 - reconfigure l'activité de la LED sur l'activité SPI
    • manual ou MANUAL ou 5 - permet de configurer l'état de la Led MODE à l'aide d'un second paramètre (séparé par une virgule) qui peut être "on", "off" ou "toggle" (pour inverser l'état).
  • Sortie: Si la commande est exécutée sans paramètre, la commande retourne une chaîne de caractère en majuscule représentant le mode de fonctionnement actuel de la LED (tel que présenté ci-dessus).
# Obtenir la configuration de la Led
AT+HWMODELED
MODE
OK
  
# Changer le fonctionnement de la Led vers BLEUART
AT+HWMODELED=BLEUART
OK

# Inverser manuellement l'état de la Led MODE
AT+HWMODELED=MANUAL,TOGGLE
OK

AT+UARTFLOW

Active ou désactive le contrôle de flux matériel (CTS + RTS) pour le port série/UART sur le nRF51822.

  • Codebase Revision: 0.7.0
  • Paramètres: Etat du contrôle de flux matériel. Peut prendre l'une des valeurs suivantes:
    • on ou 1 - activer
    • off ou 0 - désactiver
  • Sortie: Si la commande est exécutée sans paramètre, elle retour un nombre 0 ou 1 indiquant si le contrôle de flux est activé (1) ou désactivé (0).
# Vérifie l'état du contrôle de flux
AT+UARTFLOW
1
OK

# Désactive le contrôle de flux matériel
AT+UARTFLOW=off
OK

Basé sur "Bluefruit LE Shield" d'Adafruit Industries, écrit par Kevin Townsend - Traduit en Français par shop.mchobby.be CC-BY-SA pour la traduction
Toute copie doit contenir ce crédit, lien vers cette page et la section "crédit de traduction".

Based on "Bluefruit LE Shield" from Adafruit Industries, written by Kevin Townsend - Translated to French by shop.mchobby.be CC-BY-SA for the translation
Copies must includes this credit, link to this page and the section "crédit de traduction" (translation credit).

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

Récupérée de « https://wiki.mchobby.be/index.php?title=Bluefruit-LE-Shield-Hardware&oldid=23578 »