Modifications

Sauter à la navigation Sauter à la recherche

Bluefruit-LE-Shield-BLE-Services (voir la source)

Version du 18 juin 2017 à 20:20

4 265 octets ajoutés ,  18 juin 2017 à 20:20
→‎Services BLE
Ligne 2 : Ligne 2 :     
== Services BLE ==
 
== Services BLE ==
−
{{traduction}}
   
Les commandes suivantes vous permettent d'interagir avec les différents services GATT présent sur les modules Bluefruit LE lorsque celui-ci fonctionne en mode commande.
 
Les commandes suivantes vous permettent d'interagir avec les différents services GATT présent sur les modules Bluefruit LE lorsque celui-ci fonctionne en mode commande.
   Ligne 131 : Ligne 130 :     
== AT+BLEKEYBOARD ==
 
== AT+BLEKEYBOARD ==
−
{{traduction}}
+
Envoi des données textes via l'interface clavier BLE (si elle a précédemment été activée avec AT+BLEKEYBOARDEN).
−
Sends text data over the BLE keyboard interface (if it has previously been enabled via AT+BLEKEYBOARDEN).
   
* Codebase Revision: 0.5.0
 
* Codebase Revision: 0.5.0
−
* Parameters: The text string (optionally including escape characters) to transmit
+
* Paramètre: la chaîne de caractère (incluant éventuellement des caractères d'échappement) à transmettre
−
* Output: None
+
* Sortie: Aucune
   −
Any valid alpha-numeric character can be sent, and the following escape sequences are also supported:
+
Il est possible d'envoyer tout caractère Alpha-Numérique valide. Les séquences d'échappement suivantes sont supportées:
−
* \r - Carriage Return
+
* \r - Retour à la ligne (''Carriage Return'')
−
* \n - Line Feed
+
* \n - Passer à la ligne suivante (''Line Feed'')
−
* \b - Backspace
+
* \b - Un caractère en arrière (''Backspace'')
−
* \t - Tab
+
* \t - Une tabulation (''Tab'')
−
* \\ - Backslash
+
* \\ - Un anti-slash (''Backslash'')
   −
As of version 0.6.7 you can also use the following escape code when sending a single character ('AT+BLEKEYBOARD=?' has another meaning for the AT parser):
+
Depuis la version 0.6.7, vous pouvez également utiliser la séquence suivante pour envoyer un simple caractère ? seul). Car la commande 'AT+BLEKEYBOARD=?' à une autre interprétation pour l'interpréteur de commande:
−
* \? - Question mark
+
* \? - point d'interrogation
   −
  <nowiki># Send a URI with a new line ending to execute in Chrome, etc.
+
  <nowiki># Envoi une URI avec retour à la ligne (pour être exécuté dans Chrome, etc).
 
AT+BLEKEYBOARD=http://www.adafruit.com\r\n
 
AT+BLEKEYBOARD=http://www.adafruit.com\r\n
 
OK
 
OK
 
    
 
    
−
# Send a single question mark (special use case, 0.6.7+)
+
# Envoi un simple point d'interrogation (cas particulier du firmware 0.6.7+)
 
AT+BLEKEYBOARD=\?
 
AT+BLEKEYBOARD=\?
 
OK</nowiki>
 
OK</nowiki>
    
== AT+BLEKEYBOARDCODE ==
 
== AT+BLEKEYBOARDCODE ==
−
Sends a raw hex sequence of USB HID keycodes to the BLE keyboard interface including key modifiers and up to six alpha-numeric characters.
+
Envoi une séquence brute (en hexadécimale) de codes de touche HID USB (des ''keycodes'' en anglais) vers l'interface clavier BLE incluant les codes de modification (Shift, Alt, Control,...). Accepte jusqu'à 6 caractères alpha-numériques.
 
* Codebase Revision: 0.5.0
 
* Codebase Revision: 0.5.0
−
* Parameters: A set of hexadecimal values separated by a hyphen ('-'). Note that these are HID scan code values, not standard ASCII values!
+
* Paramètre: un ensemble de valeurs hexadécimales séparés par un tiret ('-'). Notez qu'il s'agit des valeurs des scancode HID, non des valeurs standards ASCII!
−
* Output: None
+
* Sortie: Aucune
   −
{{ambox|text=HID key code values don't correspond to ASCII key codes! For example, 'a' has an HID keycode value of '04', and there is no keycode for an upper case 'A' since you use the modifier to set upper case values. For details, google 'usb hid keyboard scan codes', and see the example below. }}
+
{{ambox|text=Le valeur des codes touches HID (scancode HID) ne correspondent pas aux codes ASCII! Par exemple, 'a' dispose d'un code touche HID de '04' et il n'y a pas de code touche pour le 'A' puisqu'elle s'obtient avec le code de modification majuscule. Une recherche Google sur les termes 'usb hid keyboard scan codes' (et voyez l'exemple ci-dessous). }}
   −
This command accepts the following ascii-encoded HEX payload, matching the way HID over GATT sends keyboard data:
+
Cette commande accepte les valeurs ASCII encodées comme suit dans le ''payload'' hexadécimal, cela correspond à la façon dont "HID via GATT" envoi les données claviers:
−
* '''Byte 0''': Modifier
+
* '''octet 0''': Code de modification (appelé ''modifier'' en anglais).
−
* '''Byte 1''': Reserved (should always be 00)
+
* '''octet 1''': Reservé (devrait toujours être 00)
−
* '''Bytes 2..7''': Hexadecimal values for ASCII-encoded characters (if no character is used you can enter '00' or leave trailing characters empty)
+
* '''octets 2..7''': les valeurs hexadécimales pour les caractères encodés en ASCII (Vous pouvez saisir '00' s'il n'y a pas de caractères utilisés ou laisser vide les caractères en fin de commande)
   −
After a keycode sequence is sent with the AT+BLEKEYBOARDCODE command, you must send a second AT+BLEKEYBOARDCODE command with at least two 00 characters to indicate the keys were released!
+
Après avoir envoyé une séquence de code touche avec la commande AT+BLEKEYBOARDCODE, vous devez envoyer une seconde commande avec AT+BLEKEYBOARDCODE avec au moins deux caractères 00 pour indiquer que les touches sont relâchées!
   −
  <nowiki># send 'abc' with shift key --> 'ABC'
+
  <nowiki># Envoyer 'abc' avec la touche majuscule/shift enfoncée
 +
# permet d'obtenir 'ABC'
 
AT+BLEKEYBOARDCODE=02-00-04-05-06-00-00
 
AT+BLEKEYBOARDCODE=02-00-04-05-06-00-00
 
OK
 
OK
−
# Indicate that the keys were released (mandatory!)
+
# Indiquer que les touches sont relâchées (obligatoire!)
 
AT+BLEKEYBOARDCODE=00-00
 
AT+BLEKEYBOARDCODE=00-00
 
OK</nowiki>
 
OK</nowiki>
   −
A list of HID keyboard codes can be found [http://www.freebsddiary.org/APC/usb_hid_usages.php here] (see section 7).
+
Une liste des code touche HID peut être trouvé [http://www.freebsddiary.org/APC/usb_hid_usages.php ici] (voir la section 7).
   −
=== Modifier Values ===
+
=== Valeurs de modification ===
−
The modifier byte can have one or more of the following bits set:
+
Ces valeurs de modification (dite ''modifier'' en anglais) permettent d'indiquer si plusieurs autres touches particulières sont également enfoncées (Shift, Alt, Ctrl, ...).
−
* Bit 0 (0x01): Left Control
+
 
−
* Bit 1 (0x02): Left Shift
+
L'octet de modification peut avoir un ou plusieurs des bits suivants activés:
−
* Bit 2 (0x04): Left Alt
+
* Bit 0 (0x01): Contrôle Gauche (''Left Control'')
−
* Bit 3 (0x08): Left Window
+
* Bit 1 (0x02): Majuscule Gauche (''Left Shift'')
−
* Bit 4 (0x10): Right Control
+
* Bit 2 (0x04): Alternatif Gauche (''Left Alt'')
−
* Bit 5 (0x20): Right Shift
+
* Bit 3 (0x08): Window Gauche (''Left Window'')
−
* Bit 6 (0x40): Right Alt
+
* Bit 4 (0x10): Contrôle Droit (''Right Control'')
−
* Bit 7 (0x80): Right Window
+
* Bit 5 (0x20): Majuscule Droite (''Right Shift'')
 +
* Bit 6 (0x40): Alternatif Droit (''Right Alt'')
 +
* Bit 7 (0x80): Window Droit (''Right Window'')
    
== AT+BLEHIDEN ==
 
== AT+BLEHIDEN ==
−
This command will enable GATT over HID (GoH) support, which allows you to emulate a keyboard, mouse or media controll on supported iOS, Android, OSX and Windows 10 devices. By default HID support is disabled, so you need to set BLEHIDEN to 1 and then perform a system reset before the HID devices will be enumerated and appear in on your central device.
+
Cette commande active le support GoH (''GATT over HID'') permettant d'emuler un clavier, souris ou contrôle de média tels qu'ils sont supportés sur les périphériques iOS, Android, OSX et Windows 10. Le support HID est désactivé par défaut. Il est donc nécessaire de l'activer en fixant la valeur à 1 dans BLEHIDEN puis de faire une réinitialisation système avant que le périphérique HID soit énuméré et apparaisse sur votre périphérique centrale (votre smartphone).
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
−
* Parameters: 1 or 0 (1 = enable, 0 = disable)
+
* Paramètres: 1 = activer ou 0 = désactivé
−
* Output: None
+
* Sortie: Aucune
   −
{{ambox|text=You normally need to 'bond' the Bluefruit LE peripheral to use the HID commands, and the exact bonding process will change from one operating system to another.}}
+
{{ambox|text=Il sera normalement nécessaire de ''lier/appairer'' le périphérique Bluefruit LE pour pouvoir utiliser les commandes HID. Le processus d'appairage varie d'un système d'exploitation à l'autre.}}
−
{{ambox|text=If you have previously bonded to a device and need to clear the bond, you can run the AT+FACTORYRESET command which will erase all stored bond data on the Bluefruit LE module.}}
+
{{ambox|text=Si vous avez déjà appairé le module avec un périhérique et que vous ayez besoin d'effacer cet appairage alors vous pouvez exécuter la commande AT+FACTORYRESET qui effacera toutes les données du module Bluefruit LE (y compris celle d'appairage).}}
   −
  <nowiki># Enable GATT over HID support on the Bluefruit LE module
+
  <nowiki># Activer le support "GATT over HID" du module Bluefruit LE
 
AT+BLEHIDEN=1
 
AT+BLEHIDEN=1
 
OK
 
OK
 
    
 
    
−
# Reset so that the changes take effect
+
# Réinitialiser le module pour activer la fonctionnalité
 
ATZ
 
ATZ
 
OK</nowiki>
 
OK</nowiki>
    
== AT+BLEHIDMOUSEMOVE ==
 
== AT+BLEHIDMOUSEMOVE ==
−
Moves the HID mouse or scroll wheen position the specified number of ticks.
+
Déplace la souris HID (ou fait un défilement si un nombre d'impulsion est précisé).
   −
All parameters are signed 8-bit values (-128 to +127). Positive values move to the right or down, and origin is the top left corner.
+
Toutes les valeurs sont des entiers 8 bits signées (-128 à +127). Les valeurs positives provoque un déplacement vers la droite / vers le bas. L'origine des coordonnées se trouvent dans le coin supérieur gauche.
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
−
* Parameters: X Ticks (+/-), Y Ticks (+/-), Scroll Wheel (+/-), Pan Wheel (+/-)
+
* Paramètres: impulsions X (+/-), impulsions Y (+/-), rouge de défilement (+/-), défilement horizontal (+/-)
−
* Output: None
+
* Sortie: Aucun
−
  <nowiki># Move the mouse 100 ticks right and 100 ticks down
+
  <nowiki># Déplace la souris de 100 impulsions à droite et 100 impulsions vers le bas
 
AT+BLEHIDMOUSEMOVE=100,100
 
AT+BLEHIDMOUSEMOVE=100,100
 
OK
 
OK
 
    
 
    
−
# Scroll down 20 pixels or lines (depending on context)
+
# Faire un défilement de 20 pixels ou lignes (en fonction du contexte) vers le bas
 
AT+BLEHIDMOUSEMOVE=,,20,
 
AT+BLEHIDMOUSEMOVE=,,20,
 
OK
 
OK
 
    
 
    
−
# Pan (horizontal scroll) to the right (exact behaviour depends on OS)
+
# Défilement horizontal vers la droite (la fonctionnalité dépend de l'OS)
 
AT+BLEHIDMOUSEMOVE=0,0,0,100</nowiki>
 
AT+BLEHIDMOUSEMOVE=0,0,0,100</nowiki>
    
== AT+BLEHIDMOUSEBUTTON ==
 
== AT+BLEHIDMOUSEBUTTON ==
−
Manipulates the HID mouse buttons via the specific string(s).
+
Permet de manipuler les boutons de la souris HID à l'aide de textes spécifiques.
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
−
* Parameters: Button Mask String [L][R][M][B][F], Action [PRESS][CLICK][DOUBLECLICK][HOLD]
+
* Paramètres: '''Bouton''' à l'aide [L][R][M][B][F], '''Action''' à l'aide de [PRESS][CLICK][DOUBLECLICK][HOLD]
−
** L = Left Button
+
** Bouton:
−
** R = Right Button
+
*** L = Bouton gauche, ''Left Button''
−
** M = Middle Button
+
*** R = Bouton droit, ''Right Button''
−
** B = Back Button
+
*** M = Bouton du milieu, ''Middle Button''
−
** F = Forward Button
+
*** B = Bouton "en Arrière", ''Back Button''
−
** If the second parameter (Action) is "HOLD", an optional third parameter can be passed specifying how long the button should be held in milliseconds.
+
*** F = Bouton "en avant", ''Forward Button''
−
* Output: None
+
** Action:
 +
*** PRESS = presser le bouton
 +
*** CLICK = cliquer le bouton
 +
*** DOUBLECLICK = double cliquer le bouton
 +
*** HOLD = maintenir le bouton
 +
** 3ieme paramètre:
 +
*** Si le second paramètre (Action) est "HOLD", un 3ième paramètre optionnel permet de spécifier combien de temps le bouton doit être maintenu pressé (en millisecondes).
 +
* Aucune: Aucune
   −
  <nowiki># Double click the left mouse button
+
  <nowiki># Double cliquer le bouton gauche
 
AT+BLEHIDMOUSEBUTTON=L,doubleclick
 
AT+BLEHIDMOUSEBUTTON=L,doubleclick
 
OK
 
OK
   −
# Press the left mouse button down, move the mouse, then release L
+
# Presser le bouton gauche, bouger la souris, puis relâcher le bouton
−
# This is required to perform 'drag' then stop type operations
+
# Cela permet de réaliser une opération 'glisser-déposer'
 
AT+BLEHIDMOUSEBUTTON=L
 
AT+BLEHIDMOUSEBUTTON=L
 
OK
 
OK
Ligne 250 : Ligne 258 :  
OK
 
OK
 
    
 
    
−
# Hold the backward mouse button for 200 milliseconds (OS dependent)
+
# Maintient le bouton "en arrière" de la souris pendant 200 milli-secondes (Dépendant de l'OS)
 
AT+BLEHIDMOUSEBUTTON=B,hold,200
 
AT+BLEHIDMOUSEBUTTON=B,hold,200
 
OK</nowiki>
 
OK</nowiki>
    
== AT+BLEHIDCONTROLKEY ==
 
== AT+BLEHIDCONTROLKEY ==
−
Sends HID media control commands for the bonded device (adjust volume, screen brightness, song selection, etc.).
+
Envoi une commande HID de contrôle Media vers le périphérique lié (modification du volume, luminosité de l'écran, sélection de la piste musicale, etc.).
 
* Codebase Revision: 0.6.6
 
* Codebase Revision: 0.6.6
−
* Parameters: The HID control key to send, followed by an optional delay in ms to hold the button. Voir les valeurs ci-dessous.
+
* Paramètre: Le code de la touche HID (de contrôle multimédia) à envoyer, suivi du délai pendant lequel il faut maintenir le bouton enfoncé (ms). Voir les valeurs ci-dessous.
−
* Output: Normally none.
+
* Sortie: Aucune.
   −
The control key string can be one of the following values:
+
Le code de la touche multimédia à envoyer:
−
* System Controls (works on most systems)
+
* Contrôle système (fonctionne avec la plupart des systèmes)
−
** BRIGHTNESS+
+
** BRIGHTNESS+ : augmentation de la luminosité
−
** BRIGHTNESS-
+
** BRIGHTNESS- : diminution de la luminosité
−
* Media Controls (works on most systems)
+
* Contôle des médias (fonctionne avec la plupart des systèmes)
−
** PLAYPAUSE
+
** PLAYPAUSE : jouer - pause
−
** MEDIANEXT
+
** MEDIANEXT : média/piste suivante
−
** MEDIAPREVIOUS
+
** MEDIAPREVIOUS : média/piste précédente
−
** MEDIASTOP
+
** MEDIASTOP : média arrêt
−
* Sound Controls (works on most systems)
+
* Contrôle du volume (fonctionne avec la plupart des systèmes)
−
** VOLUME
+
** VOLUME  
−
** MUTE
+
** MUTE : muet
−
** BASS
+
** BASS : sons graves
−
** TREBLE
+
** TREBLE : sons aigus
−
** BASS_BOOST
+
** BASS_BOOST : Booster les bass
−
** VOLUME+
+
** VOLUME+ : augmenter le volume
−
** VOLUME-
+
** VOLUME- : diminuer le volume
−
** BASS+
+
** BASS+ : augmenter les basses
−
** BASS-
+
** BASS- : diminuer les basses
−
** TREBLE+
+
** TREBLE+ : augmenter les aigus
−
** TREBLE-
+
** TREBLE- : diminuer les aigus
−
* Application Launchers (Windows 10 only so far)
+
* Démarrage d'application (Windows 10 uniquement)
−
** EMAILREADER
+
** EMAILREADER : lecture des e-mails
−
** CALCULATOR
+
** CALCULATOR : calculatrice
−
** FILEBROWSER
+
** FILEBROWSER : navigateur de fichier
−
* Browser/File Explorer Controls (Firefox on Windows/Android only)
+
* Contrôle de navigateur/explorateur de fichier (Firefox sous Windows/Android uniquement)
−
** SEARCH
+
** SEARCH : Rechercher
−
** HOME
+
** HOME : Page d'accueil / répertoire racine
−
** BACK
+
** BACK : en arrière
−
** FORWARD
+
** FORWARD : en avant
−
** STOP
+
** STOP : arrêt
−
** REFRESH
+
** REFRESH : rafraîchir
−
** BOOKMARKS
+
** BOOKMARKS : marque-pages
   −
You can also send a raw 16-bit hexadecimal value in the '0xABCD' format as parameter. A full list of 16-bit 'HID Consumer Control Key Codes' can be found here (see section 12).
+
Vous pouvez également envoyer une valeur hexadécimale brute (16 bits) au format '0xABCD'. Une liste complète des code HID 16 bit (''HID Consumer Control Key Codes'') peut être trouvé [http://www.freebsddiary.org/APC/usb_hid_usages.php ici] (section 12).
   −
{{ambox-stop|text=If you are not bonded and connected to a central device, this command will return ERROR. Make sure you are connected and HID support is enabled before running these commands.}}
+
{{ambox-stop|text=Si vous n'êtes pas appairé et connecté sur un périphérique centrale alors la commande retournera ERROR. Assurez vous d'être appairé et d'avoir activé le support HID avant d'avoir exécuté ces commandes.}}
   −
  <nowiki># Toggle the sound on the bonded central device
+
  <nowiki># Mettre le volume du périphérique appairé en muet
 
AT+BLEHIDCONTROLKEY=MUTE
 
AT+BLEHIDCONTROLKEY=MUTE
 
OK
 
OK
   −
# Hold the VOLUME+ key for 500ms
+
# Maintenir la touche VOLUME+ enfoncée pendant 500ms
 
AT+BLEHIDCONTROLKEY=VOLUME+,500
 
AT+BLEHIDCONTROLKEY=VOLUME+,500
 
OK
 
OK
   −
# Send a raw 16-bit Consumer Key Code (0x006F = Brightness+)
+
# Envoyer un code touche HID (valeur 16-bit brute). 0x006F = Brightness+
 
AT+BLEHIDCONTROLKEY=0x006F
 
AT+BLEHIDCONTROLKEY=0x006F
 
OK</nowiki>
 
OK</nowiki>
    
== AT+BLEHIDGAMEPADEN ==
 
== AT+BLEHIDGAMEPADEN ==
−
 
+
Active le support du service HID pour le joystick/gamepad. Le gamepad HID est désactivé par défaut (depuis la version 0.7.6 du firmware) parce qu'il cause des problème sur iOS et OS X et devrait uniquement être utilisé avec les périphériques Android et Windows.
−
Enables HID gamepad support in the HID service. By default the gamepad is disabled as of version 0.7.6 of the firmware since it causes problems on iOS and OS X and should only be used on Android and Windows based devices.
      
* Codebase Revision: 0.7.6
 
* Codebase Revision: 0.7.6
−
* Parameters: Whether the gamepad service should be enabled via one of the following values:
+
* Paramètres: indique si le service gamepad devrait être activé ou désactivé.
 
** '''1''' ou '''on'''
 
** '''1''' ou '''on'''
 
** '''0''' ou '''off'''
 
** '''0''' ou '''off'''
−
* Output: If executed with no parameters, a numeric value will be returned indicating whether the battery service is enabled (1) or disabled (0).
+
* Sortie: Lorsque la commande est exécutée sans paramètre, l'interpréteur de commande retourne une valeur numérique indiquant l'état d'activation du service. 1 = activé ou 0 = désactivé.
−
{{ambox|text=This command requires a system reset to take effect.}}
+
{{ambox|text=Cette commande nécessite une réinitialisation système (ATZ) pour que la modification soit effective.}}
    
== AT+BLEHIDGAMEPAD ==
 
== AT+BLEHIDGAMEPAD ==
−
Sends a specific HID gamepad payload out over BLE
+
Envoi une commande HID gamepad via BLE
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
−
* Parameters: The following comma-separated parameters are available:
+
* Paramètres: Les paramètres suivants (séparés par une virgule) sont disponibles:
−
** '''Axe x''':  LEFT, RIGHT: If X=-1 then 'LEFT' is pressed, if X=1 then 'RIGHT' is pressed, if X=0 then neither left nor right are pressed
+
** '''Axe x''':  GAUCHE ou DROITE. Si X=-1 alors c'est le bouton 'GAUCHE' qui est pressé. Si X=1 alors c'est le bouton de 'DROITE' qui est pressé. Si X=0 alors aucun des deux boutons (gauche ou droite) est pressé
−
** '''Axe y''': UP, DOWN: If Y=-1 then 'UP' is pressed, if Y=1 then 'DOWN' is pressed, if Y=0 then neither up nor down are pressed
+
** '''Axe y''': HAUT ou BAS. Si Y=-1 alors c'est le bouton 'HAUT' qui est pressé. Si Y=1 ALORS KES LE BOUTON 'BAs' qui est pressé. Si Y=0 alors aucun des deux boutons (haut ou bas) est pressé
−
** '''Boutons''': 0x00-0xFF, which is a bit mask for 8 button 0-7
+
** '''Boutons''': de 0x00 à 0xFF, qui est un octet dont les différents bits indiquent lequels des 8 boutons sont pressés (boutons de 0-7)
−
* Output: Nothing
+
* Output: aucune
−
{{ambox|text=HID gamepad is disabled by default as of version 0.7.6, and must first be enabled via AT+BLEHIDGAMEPADEN=1 before it can be used.}}
+
{{ambox|text=Le gamepad HID est désactivé par défaut depuis la version version 0.7.6 du firmware. Le service HID Gamepad doit être préalablement activé à laide de la commande AT+BLEHIDGAMEPADEN=1 avant de pouvoir l'utiliser.}}
−
{{ambox|text=Note: You need to send both 'press' and 'release' events for each button, otherwise the system will think that the button is still pressed until a release state is received.}}
+
{{ambox|text=Note: Il est nécessaire d'envoyer les deux événements 'pressé' et 'relâché' pour chaque bouton utilisé. A défaut, le bouton restera "pressé" jusqu'à la réception de la commande de "relâchement" du bouton.}}
   −
  <nowiki># Press 'RIGHT' and 'Button0' at the same time
+
  <nowiki># Presser 'DROITE' et le 'Bouton0' en même temps
 +
# Boutons = 0b00000001 en binaire -> 1 en décimal -> 0x01 en hexadécimal
 
AT+BLEHIDGAMEPAD=1,0,0x01
 
AT+BLEHIDGAMEPAD=1,0,0x01
   −
# Press 'UP' and 'Button1' + 'Button0' at the same time
+
# Presser 'HAUT' et 'Bouton1' + 'Bouton0' en même temps
 +
# Boutons = 0b00000011 en binaire -> 3 en décimal -> 0x03 en hexadécimal
 
AT+BLEHIDGAMEPAD=0,-1,0x03</nowiki>
 
AT+BLEHIDGAMEPAD=0,-1,0x03</nowiki>
    
== AT+BLEMIDIEN ==
 
== AT+BLEMIDIEN ==
−
Enables or disables the BLE MIDI service.
+
Active ou désactive le service MIDI ble.
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
−
* Parameters: State, which can be one of:
+
* Paramètre: Activer / Désactiver le service MIDI BLE avec les valeurs suivante:
−
** '''1''' ou '''on'''
+
** '''1''' ou '''on''' - pour activer
−
** '''0''' ou '''off'''
+
** '''0''' ou '''off''' - pour désactiver
−
* Output: If executed with no parameters, it will return the current state of the MIDI service as an integer indicating if it is enabled (1) or disabled (0).
+
* Sortie: Lorsqu'elle est exécutée sans paramètre, l'interpréteur de commande retourne une valeur numérique correspondant à l'état d'activation du service MIDI BLE. 1 = activé ou 0 = désactivé.
−
{{ambox|text=Note: This command will require a reset to take effect.}}
+
{{ambox|text=Note: cette commande nécessitera une réinitialisation (ATZ) pour que la modification soit prise en compte.}}
   −
  <nowiki># Check the current state of the MIDI service
+
  <nowiki># Vérifier l'état actuel du service MIDI
 
AT+BLEMIDIEN
 
AT+BLEMIDIEN
 
1
 
1
 
OK
 
OK
   −
# Enable the MIDI Service
+
# Activer le service MIDI
 
AT+BLEMIDIEN=1
 
AT+BLEMIDIEN=1
 
OK</nowiki>
 
OK</nowiki>
    
== AT+BLEMIDIRX ==
 
== AT+BLEMIDIRX ==
−
Reads an incoming MIDI character array from the buffer.
+
Lit la mémoire tampon et retourne le tableau de caractère MIDI entrant.
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
−
* Parameters: None
+
* Paramètre: Aucun
−
* Output: The midi event in byte array format
+
* Sortie: l'événement midi retourné sous forme de tableau d'octet
    
  <nowiki>AT+BLEMIDIRX
 
  <nowiki>AT+BLEMIDIRX
Ligne 367 : Ligne 376 :     
== AT+BLEMIDITX ==
 
== AT+BLEMIDITX ==
−
Sends a MIDI event to host.
+
Envoyer un événement MIDI vers l'hôte.
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
−
* Parameters: The MIDI event in hex array format, which can be either:
+
* Paramètre: l'événement MIDI sous forme d'un tableau hexadécimal, qui peut être soit:
−
** A series of full MIDI events (up to 4 events)
+
** Une série d'événement MIDI complet (jusqu'à 4 événements)
−
** Exactly 1 full MIDI event + several running events without status (up to 7)
+
** 1 événement MIDI complet (exactement) + plusieurs événements '''running events''' sans statut (''several running events without status'') (jusqu'à 7)
−
* Output: None
+
* Sortie: Aucune
   −
  <nowiki># Send 1 event (middle C with max velocity)
+
  <nowiki># Envoi de un événement (middle C/DO grave avec la vélocité maximale)
 
AT+BLEMIDITX=90-3C-7F
 
AT+BLEMIDITX=90-3C-7F
 
OK
 
OK
   −
# Send 2 events
+
# Envoi de 2 événements
 
AT+BLEMIDITX=90-3C-7F-A0-3C-7F
 
AT+BLEMIDITX=90-3C-7F-A0-3C-7F
 
OK
 
OK
   −
# Send 1 full event + running event
+
# Envoi d'un événement complet + "running event"
 
AT+BLEMIDITX=90-3C-7F-3C-7F
 
AT+BLEMIDITX=90-3C-7F-3C-7F
 
OK</nowiki>
 
OK</nowiki>
    
== AT+BLEBATTEN ==
 
== AT+BLEBATTEN ==
−
Enables the Battery Service following the definition from the Bluetooth SIG.
+
Active le service Battery en suivant la définition de "Bluetooth SIG".
 +
 
 +
Le [https://www.bluetooth.com/specifications/gatt/viewer?attributeXmlFile=org.bluetooth.service.battery_service.xml Service Battery] permet d'exposer l'état de la batterie au périphérique appairé.
    
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
−
* Parameters: Whether the battery service should be enabled, via on of the following values:
+
* Paramètre: Indique si le service Battery doit être activé ou désactivé:
−
** '''1''' ou '''on'''
+
** '''1''' ou '''on''' - activer le service
−
** '''0''' ou '''off'''
+
** '''0''' ou '''off''' - désactiver le service
−
* Output: If executed with no parameters, a numeric value will be returned indicating whether the battery service is enabled (1) or disabled (0).
+
* Sortie: Si la commande est exécutée sans paramètre alors l'interpréteur de commande retourne une valeur numérique indiquant l'état d'activation du service. Activer = 1, Désactiver = 0.
−
{{ambox|text=This command requires a system reset to take effect.}}
+
 
 +
{{ambox|text=Nécessite une réinitialisation système (ATZ) pour que la modification soit prise en compte.}}
    
== AT+BLEBATTVAL ==
 
== AT+BLEBATTVAL ==
−
Sets the current battery level in percentage (0..100) for the Battery Service (if enabled).
+
Permet au module d'envoyer le niveau de sa batterie au périphérique central (votre smartphone).
 +
 
 
* Codebase Revision: 0.7.0
 
* Codebase Revision: 0.7.0
−
* Parameters: The percentage for the battery in the range of 0..100.
+
* Paramètre: Le pourcentage (0..100) de la batterie à communiquer.
−
* Output: If executed with no parameters, the current battery level stored in the characteristic.
+
* Sortie: Si la commande est exécutée sans paramètre, l'interpréteur de commande retourne le niveau de batterie actuel tel qu'il à été stocké dans les caractéristiques.
   −
  <nowiki># Set the battery level to 72%
+
  <nowiki># Fixer le niveau de la batterie à 72%
 
AT+BLEBATTVAL=72
 
AT+BLEBATTVAL=72
 
OK</nowiki>
 
OK</nowiki>
    
{{Bluefruit-LE-Shield-TRAILER}}
 
{{Bluefruit-LE-Shield-TRAILER}}
Admin
Bureaucrates, Administrateurs
29 917

modifications

Récupérée de « https://wiki.mchobby.be/index.php?title=Spécial:MobileDiff/23626...23648 »

Menu de navigation