Différences entre versions de « Bluefruit-LE-Shield-Hardware »
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 | ||
− | * | + | * Paramètres: Baud rate, which must be one of the following values: |
** 1200 | ** 1200 | ||
** 2400 | ** 2400 | ||
Ligne 24 : | Ligne 24 : | ||
** 921600 | ** 921600 | ||
** 1000000 | ** 1000000 | ||
− | * | + | * 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 | ||
− | * | + | * Paramètres: The ADC channel (0..7) |
− | * | + | * 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 | ||
− | * | + | * Paramètres: None |
− | * | + | * 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 | ||
− | * | + | * 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 | + | 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. | ||
− | * | + | * 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 | ||
− | * | + | * 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 | ||
− | * | + | * 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 | ||
− | * | + | * 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. |
<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 | ||
− | * | + | * Paramètres: None |
− | * | + | * 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 | ||
− | * | + | * Paramètres: None |
− | * | + | * 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 | ||
− | * | + | * 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. | ||
− | * | + | * 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 | ||
− | * | + | * Paramètres: HW flow control state, which can be one of: |
** on | ** on | ||
** off | ** off | ||
** 0 | ** 0 | ||
** 1 | ** 1 | ||
− | * | + | * 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
En cours de traduction/élaboration. |
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
Trying to set the value of a pin that has not been configured as an output will produce an 'ERROR' response. |
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. |
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.
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. |
# 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