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

De MCHobby - Wiki
Sauter à la navigation Sauter à la recherche
Ligne 1 : Ligne 1 :
 
{{Bluefruit-LE-Shield-NAV}}
 
{{Bluefruit-LE-Shield-NAV}}
 
+
{{traduction}}
 
== Commande matériel ==
 
== Commande 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.:
 
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.:
Ligne 7 : Ligne 7 :
 
Changes the baud rate used by the HW UART peripheral on the nRF51822.
 
Changes the baud rate used by the HW UART peripheral on the nRF51822.
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
* Parameters: Baud rate, which must be one of the following values:  
+
* Paramètres: Baud rate, which must be one of the following values:  
 
** 1200
 
** 1200
 
** 2400
 
** 2400
Ligne 24 : Ligne 24 :
 
** 921600
 
** 921600
 
** 1000000
 
** 1000000
* Output: The current baud rate
+
* Sortie: The current baud rate
  
 
  <nowiki># Set the baud rate to 115200
 
  <nowiki># Set the baud rate to 115200
Ligne 39 : Ligne 39 :
  
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
* Parameters: The ADC channel (0..7)
+
* Paramètres: The ADC channel (0..7)
* Output: The results of the ADC conversion
+
* Sortie: The results of the ADC conversion
  
 
  <nowiki>AT+HWADC=0
 
  <nowiki>AT+HWADC=0
Ligne 50 : Ligne 50 :
  
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
* Parameters: None
+
* Paramètres: None
* Output: The die temperature in degrees celcius
+
* Sortie: The die temperature in degrees celcius
  
 
  <nowiki>AT+HWGETDIETEMP
 
  <nowiki>AT+HWGETDIETEMP
Ligne 61 : Ligne 61 :
  
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
* Parameters: The parameters for this command change depending on the pin mode.
+
* Paramètres: The Paramètres for this command change depending on the pin mode.
  
 
=== GPIO en sortie ===
 
=== GPIO en sortie ===
OUTPUT MODE: The following comma-separated parameters can be used when updating a pin that is set as an output:
+
OUTPUT MODE: The following comma-separated Paramètres can be used when updating a pin that is set as an output:
  
 
* Pin numbers
 
* Pin numbers
Ligne 74 : Ligne 74 :
 
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.
 
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.
  
* Output: 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: 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:
 
** 0 means the pin is logic low/GND
 
** 0 means the pin is logic low/GND
 
** 1 means the pin is logic high/VCC
 
** 1 means the pin is logic high/VCC
Ligne 106 : Ligne 106 :
  
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
* Parameters: This command one or two values (comma-separated in the case of two parameters being used):
+
* Paramètres: This command one or two values (comma-separated in the case of two Paramètres being used):
 
** The pin number
 
** The pin number
 
** The new GPIO mode, where:
 
** The new GPIO mode, where:
Ligne 113 : Ligne 113 :
 
*** 2 = Input with pullup enabled
 
*** 2 = Input with pullup enabled
 
*** 3 = Input with pulldown enabled
 
*** 3 = Input with pulldown enabled
* Output: If a single parameters is passed (the GPIO pin number) the current pin mode will be returned.
+
* 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. }}
 
{{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. }}
Ligne 130 : Ligne 130 :
  
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
* Parameters: None
+
* Paramètres: None
* Output: 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: 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.
  
 
  <nowiki># I2C scan with two devices detected
 
  <nowiki># I2C scan with two devices detected
Ligne 145 : Ligne 145 :
 
Returns the main power supply voltage level in millivolts
 
Returns the main power supply voltage level in millivolts
 
* Codebase Revision: 0.3.0
 
* Codebase Revision: 0.3.0
* Parameters: None
+
* Paramètres: None
* Output: The VBAT level in millivolts
+
* Sortie: The VBAT level in millivolts
  
 
  <nowiki>AT+HWVBAT
 
  <nowiki>AT+HWVBAT
Ligne 155 : Ligne 155 :
 
Generates a random 32-bit number using the HW random number generator on the nRF51822 (based on white noise).
 
Generates a random 32-bit number using the HW random number generator on the nRF51822 (based on white noise).
 
* Codebase Revision: 0.4.7
 
* Codebase Revision: 0.4.7
* Parameters: None
+
* Paramètres: None
* Output: A random 32-bit hexadecimal value (ex. '0x12345678')
+
* Sortie: A random 32-bit hexadecimal value (ex. '0x12345678')
  
 
  <nowiki>AT+HWRANDOM
 
  <nowiki>AT+HWRANDOM
Ligne 166 : Ligne 166 :
  
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
* Parameters: LED operating mode, which can be one of the following values:
+
* Paramètres: LED operating mode, which can be one of the following values:
 
** '''disable''' or '''DISABLE''' or '''0''' - Disable the MODE LED entirely to save power
 
** '''disable''' or '''DISABLE''' or '''0''' - Disable the MODE LED entirely to save power
 
** '''mode''' or '''MODE''' or '''1''' - Default behaviour, indicates the current operating mode
 
** '''mode''' or '''MODE''' or '''1''' - Default behaviour, indicates the current operating mode
Ligne 173 : Ligne 173 :
 
** '''spi''' or '''SPI''' or '''4''' - Toggles the LED on any SPI activity
 
** '''spi''' or '''SPI''' or '''4''' - Toggles the LED on any SPI activity
 
** '''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''' 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.
* Output: If run with no parameters, returns an upper-case string representing the current MODE LED operating mode from the fields above
+
* Sortie: If run with no Paramètres, returns an upper-case string representing the current MODE LED operating mode from the fields above
  
 
  <nowiki># Get the curent MODE LED setting
 
  <nowiki># Get the curent MODE LED setting
Ligne 192 : Ligne 192 :
  
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
* Parameters: HW flow control state, which can be one of:
+
* Paramètres: HW flow control state, which can be one of:
 
** on
 
** on
 
** off
 
** off
 
** 0
 
** 0
 
** 1
 
** 1
* Output: If run with no parameters, returns a number representing whether flow control is enabled (1) or disabled (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># Check the current flow control state
Ligne 207 : Ligne 207 :
 
AT+UARTFLOW=off
 
AT+UARTFLOW=off
 
OK</nowiki>
 
OK</nowiki>
 +
 
{{Bluefruit-LE-Shield-TRAILER}}
 
{{Bluefruit-LE-Shield-TRAILER}}

Version du 3 juin 2017 à 15:01


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.

Commande 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.:

AT+BAUDRATE

Changes the baud rate used by the HW UART peripheral on the nRF51822.

  • Codebase Revision: 0.7.0
  • Paramètres: Baud rate, which must be one of the following values:
    • 1200
    • 2400
    • 4800
    • 9600
    • 14400
    • 19200
    • 28800
    • 38400
    • 57600
    • 76800
    • 115200
    • 230400
    • 250000
    • 460800
    • 921600
    • 1000000
  • Sortie: The current baud rate
# Set the baud rate to 115200
AT+BAUDRATE=115200
OK

# Check the current baud rate
AT+BAUDRATE
115200
OK

AT+HWADC

Performs an ADC conversion on the specified ADC pin

  • Codebase Revision: 0.3.0
  • Paramètres: The ADC channel (0..7)
  • Sortie: The results of the ADC conversion
AT+HWADC=0
178
OK

AT+HWGETDIETEMP

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.

  • Codebase Revision: 0.3.0
  • Paramètres: None
  • Sortie: The die temperature in degrees celcius
AT+HWGETDIETEMP
32.25
OK

AT+HWGPIO

Gets or sets the value of the specified GPIO pin (depending on the pin's mode).

  • Codebase Revision: 0.3.0
  • Paramètres: The Paramètres for this command change depending on the pin mode.

GPIO en sortie

OUTPUT MODE: The following comma-separated Paramètres can be used when updating a pin that is set as an output:

  • Pin numbers
  • Pin state, where:
    • 0 = clear the pin (logic low/GND)
    • 1 = set the pin (logic high/VCC)

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.

  • 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:
    • 0 means the pin is logic low/GND
    • 1 means the pin is logic high/VCC

Recommendation

Exemples

# Set pin 14 HIGH
AT+HWGPIO=14,1
OK
  
# Set pin 14 LOW
AT+HWGPIO=14,0
OK
  
# Read the current state of pin 14
AT+HWGPIO=14
0
OK
  
# Try to update a pin that is not set as an output
AT+HWGPIOMODE=14,0
OK
AT+HWGPIO=14,1
ERROR

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.
# Configure pin 14 as an output
AT+HWGPIOMODE=14,0
OK

# Get the current mode for pin 14
AT+HWPGIOMODE=14
0
OK

AT+HWI2CSCAN

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.

  • Codebase Revision: 0.3.0
  • Paramètres: None
  • 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.
# I2C scan with two devices detected
AT+HWI2CSCAN
0x23,0x35
OK

# I2C scan with no devices detected
AT+HWI2CSCAN
OK

AT+HWVBAT

Returns the main power supply voltage level in millivolts

  • Codebase Revision: 0.3.0
  • Paramètres: None
  • Sortie: The VBAT level in millivolts
AT+HWVBAT
3248
OK

AT+HWRANDOM

Generates a random 32-bit number using the HW random number generator on the nRF51822 (based on white noise).

  • Codebase Revision: 0.4.7
  • Paramètres: None
  • Sortie: A random 32-bit hexadecimal value (ex. '0x12345678')
AT+HWRANDOM
0x769ED823
OK

AT+HWMODELED

Allows you to override the default behaviour of the MODE led (which indicates the operating mode by default).

  • Codebase Revision: 0.6.6
  • Paramètres: LED operating mode, which can be one of the following values:
    • disable or DISABLE or 0 - Disable the MODE LED entirely to save power
    • mode or MODE or 1 - Default behaviour, indicates the current operating mode
    • hwuart or HWUART or 2 - Toggles the LED on any activity on the HW UART bus (TX or RX)
    • bleuart or BLEUART or 3 - Toggles the LED on any activity on the BLE UART Service (TX or RX characteristic)
    • spi or SPI or 4 - Toggles the LED on any SPI activity
    • 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.
  • Sortie: If run with no Paramètres, returns an upper-case string representing the current MODE LED operating mode from the fields above
# Get the curent MODE LED setting
AT+HWMODELED
MODE
OK
  
# Change the MODE LED to indicate BLE UART activity
AT+HWMODELED=BLEUART
OK

# Manually toggle the MODE LED
AT+HWMODELED=MANUAL,TOGGLE
OK

AT+UARTFLOW

Enables or disable hardware flow control (CTS + RTS) on the UART peripheral block of the nRF51822.

  • Codebase Revision: 0.7.0
  • Paramètres: HW flow control state, which can be one of:
    • on
    • off
    • 0
    • 1
  • Sortie: If run with no Paramètres, returns a number representing whether flow control is enabled (1) or disabled (0).
# Check the current flow control state
AT+UARTFLOW
1
OK

# Disable HW flow control
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