29 918
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 1 :
Ligne 1 : − {{traduction}}+ Ligne 36 :
Ligne 36 : − Performs an ADC conversion on the specified ADC pin+ − + − + Ligne 47 :
Ligne 47 : − Gets the temperature in degree celcius of the BLE module's die. This can be used for debug purposes (higher die temperature generally means higher current consumption), but does not corresponds to ambient temperature and can nto be used as a replacement for a normal temperature sensor.+ − + − + + + + + + + + + + + + + + + + + + + + + + + + + − Gets or sets the value of the specified GPIO pin (depending on the pin's mode).+ − + − + − + − + − + − + − − + − + − + − + − + − + − + − + − + − + + − − == AT+HWGPIOMODE == − This will set the mode for the specified GPIO pin (input, output, etc.). − − * Codebase Revision: 0.3.0 − * Paramètres: This command one or two values (comma-separated in the case of two Paramètres being used): − ** The pin number − ** The new GPIO mode, where: − *** 0 = Input − *** 1 = Output − *** 2 = Input with pullup enabled − *** 3 = Input with pulldown enabled − * Sortie: If a single Paramètres is passed (the GPIO pin number) the current pin mode will be returned. − − {{ambox-stop|text=Some pins are reserved for specific functions on Bluefruit modules and can not be used as GPIO. If you try to make use of a reserved pin number an 'ERROR' response will be generated. }} − − <nowiki># Configure pin 14 as an output − AT+HWGPIOMODE=14,0 − OK − − # Get the current mode for pin 14 − AT+HWPGIOMODE=14 − 0 − OK</nowiki> − Scans the I2C bus to try to detect any connected I2C devices, and returns the address of devices that were found during the scan process.+ − + − + − + − + − Returns the main power supply voltage level in millivolts+ − + − + Ligne 153 :
Ligne 153 : − Generates a random 32-bit number using the HW random number generator on the nRF51822 (based on white noise).+ − + − + Ligne 163 :
Ligne 163 : − Allows you to override the default behaviour of the MODE led (which indicates the operating mode by default).+ − + − + − + − + − + − + − + − + − + − + − + − Enables or disable hardware flow control (CTS + RTS) on the UART peripheral block of the nRF51822.+ − + − + − + − ** 0+ − ** 1 − − + − +
aucun résumé de modification
{{Bluefruit-LE-Shield-NAV}}
{{Bluefruit-LE-Shield-NAV}}
== Commandes matériel ==
== 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.
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+HWADC ==
== AT+HWADC ==
Effectue une conversion ADC (analogique vers digital) pour une broche ADC spécifique
* Codebase Revision: 0.3.0
* Codebase Revision: 0.3.0
* Paramètres: The ADC channel (0..7)
* Paramètres: Le canal ADC (0..7)
* Sortie: The results of the ADC conversion
* Sortie: Le résultat de la conversion ADC
<nowiki>AT+HWADC=0
<nowiki>AT+HWADC=0
== AT+HWGETDIETEMP ==
== 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
* Codebase Revision: 0.3.0
* Paramètres: None
* Paramètres: Aucun
* Sortie: The die temperature in degrees celcius
* Sortie: Le température du composant BLE (en degré Celcuis)
<nowiki>AT+HWGETDIETEMP
<nowiki>AT+HWGETDIETEMP
32.25
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>
OK</nowiki>
== AT+HWGPIO ==
== 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
* Codebase Revision: 0.3.0
* Paramètres: The Paramètres for this command change depending on the pin mode.
* Paramètres: les paramètres de cette commande changent en fonction du mode de la broche.
=== GPIO en sortie ===
=== GPIO en sortie ===
OUTPUT MODE: The following comma-separated Paramètres can be used when updating a pin that is set as an output:
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
* Pin numbers
* Etat de la broche, où:
* Pin state, where:
** 0 = désactive la broche (Niveau logique bas/LOW/GND)
** 0 = clear the pin (logic low/GND)
** 1 = active la broche (Niveau logique haut/HIGH/VCC)
** 1 = set the pin (logic high/VCC)
=== GPIO en entrée ===
=== GPIO en entrée ===
INPUT MODE: To read the current state of an input pin or a pin that has been configured as an output, enter the pin number as a single parameter.
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: The pin state if you are reading an input or checking the state of an input pin (meaning only 1 parameter is supplied, the pin number), where:
* 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 means the pin is logic low/GND
** 0 signifiant que la broche est au niveau logique bas/LOW/GND
** 1 means the pin is logic high/VCC
** 1 signifiant que la broche est au niveai logique haut/HIGH/VCC
=== Recommendation ===
=== Recommendation ===
{{ambox-stop|text=Trying to set the value of a pin that has not been configured as an output will produce an 'ERROR' response.}}
{{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=Some pins are reserved for specific functions on Bluefruit modules and can not be used as GPIO. If you try to make use of a reserved pin number an 'ERROR' response will be generated. }}
{{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 ===
=== Exemples ===
<nowiki># Set pin 14 HIGH
<nowiki># Place la broche 14 au niveau haut/HIGH
AT+HWGPIO=14,1
AT+HWGPIO=14,1
OK
OK
# Set pin 14 LOW
# Place la broche 14 au niveau bas/LOW
AT+HWGPIO=14,0
AT+HWGPIO=14,0
OK
OK
# Read the current state of pin 14
# Lire l'état de la broche 14 14
AT+HWGPIO=14
AT+HWGPIO=14
0
0
OK
OK
# Try to update a pin that is not set as an output
# Essayer de modifier une broche qui n'est pas
# configuré en sortie/output
AT+HWGPIOMODE=14,0
AT+HWGPIOMODE=14,0
OK
OK
AT+HWGPIO=14,1
AT+HWGPIO=14,1
ERROR</nowiki>
ERROR</nowiki>
== AT+HWI2CSCAN ==
== 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
* Codebase Revision: 0.3.0
* Paramètres: None
* Paramètres: Aucun
* Sortie: A comma-separated list of any I2C address that were found while scanning the valid address range on the I2C bus, or nothing is no devices were found.
* 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># I2C scan with two devices detected
<nowiki># Scan I2C avec deux périphériques détecté
AT+HWI2CSCAN
AT+HWI2CSCAN
0x23,0x35
0x23,0x35
OK
OK
# I2C scan with no devices detected
# Scan I2C sans périphériques détectés
AT+HWI2CSCAN
AT+HWI2CSCAN
OK</nowiki>
OK</nowiki>
== AT+HWVBAT ==
== AT+HWVBAT ==
Retourne la mesure de la tension d'alimentation en milli-volts
* Codebase Revision: 0.3.0
* Codebase Revision: 0.3.0
* Paramètres: None
* Paramètres: Aucun
* Sortie: The VBAT level in millivolts
* Sortie: Le niveau de VBAT en milli-volts
<nowiki>AT+HWVBAT
<nowiki>AT+HWVBAT
== AT+HWRANDOM ==
== 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
* Codebase Revision: 0.4.7
* Paramètres: None
* Paramètres: Aucun
* Sortie: A random 32-bit hexadecimal value (ex. '0x12345678')
* Sortie: un nombre aléatoire 32-bits encodé en hexadécimal (ex. '0x12345678')
<nowiki>AT+HWRANDOM
<nowiki>AT+HWRANDOM
== AT+HWMODELED ==
== 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
* Codebase Revision: 0.6.6
* Paramètres: LED operating mode, which can be one of the following values:
* Paramètres: mode de fonctionnement de la LED, qui peut être une des valeurs suivantes:
** '''disable''' or '''DISABLE''' or '''0''' - Disable the MODE LED entirely to save power
** '''disable''' ou '''DISABLE''' ou '''0''' - Désactive complètement la Led MODE pour économiser de l'énergie.
** '''mode''' or '''MODE''' or '''1''' - Default behaviour, indicates the current operating mode
** '''mode''' ou '''MODE''' ou '''1''' - Fonctionnement par défaut, indique le MODE actuel.
** '''hwuart''' or '''HWUART''' or '''2''' - Toggles the LED on any activity on the HW UART bus (TX or RX)
** '''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''' or '''BLEUART''' or '''3''' - Toggles the LED on any activity on the BLE UART Service (TX or RX characteristic)
** '''bleuart''' ou '''BLEUART''' ou '''3''' - reconfigure l'activité de la LED sur l'activité du service BLE UART (caractéristique TX ou RX)
** '''spi''' or '''SPI''' or '''4''' - Toggles the LED on any SPI activity
** '''spi''' ou '''SPI''' ou '''4''' - reconfigure l'activité de la LED sur l'activité SPI
** '''manual''' or '''MANUAL''' or '''5''' - Manually sets the state of the MODE LED via a second comma-separated parameter, which can be on, off, or toggle.
** '''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: If run with no Paramètres, returns an upper-case string representing the current MODE LED operating mode from the fields above
* 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># Get the curent MODE LED setting
<nowiki># Obtenir la configuration de la Led
AT+HWMODELED
AT+HWMODELED
MODE
MODE
OK
OK
# Change the MODE LED to indicate BLE UART activity
# Changer le fonctionnement de la Led vers BLEUART
AT+HWMODELED=BLEUART
AT+HWMODELED=BLEUART
OK
OK
# Manually toggle the MODE LED
# Inverser manuellement l'état de la Led MODE
AT+HWMODELED=MANUAL,TOGGLE
AT+HWMODELED=MANUAL,TOGGLE
OK</nowiki>
OK</nowiki>
== AT+UARTFLOW ==
== 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
* Codebase Revision: 0.7.0
* Paramètres: HW flow control state, which can be one of:
* Paramètres: Etat du contrôle de flux matériel. Peut prendre l'une des valeurs suivantes:
** on
** '''on''' ou '''1''' - activer
** off
** '''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).
* Sortie: If run with no Paramètres, returns a number representing whether flow control is enabled (1) or disabled (0).
<nowiki># Check the current flow control state
<nowiki># Vérifie l'état du contrôle de flux
AT+UARTFLOW
AT+UARTFLOW
1
1
OK
OK
# Disable HW flow control
# Désactive le contrôle de flux matériel
AT+UARTFLOW=off
AT+UARTFLOW=off
OK</nowiki>
OK</nowiki>
{{Bluefruit-LE-Shield-TRAILER}}
{{Bluefruit-LE-Shield-TRAILER}}