29 917
modifications
Modifications
Sauter à la navigation
Sauter à la recherche
Ligne 2 :
Ligne 2 : − {{traduction}} Ligne 264 :
Ligne 263 : − {{traduction}}+ − Sends HID media control commands for the bonded device (adjust volume, screen brightness, song selection, etc.). − + − + − The control key string can be one of the following values:+ − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − + − 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).+ − + − + − + − + − + − 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. − + − + − + − Sends a specific HID gamepad payload out over BLE+ − + − + − + − + − + − + − + − + + − + + − Enables or disables the BLE MIDI service.+ − + − + − + − + − + − + − + − Reads an incoming MIDI character array from the buffer.+ − + − + Ligne 377 :
Ligne 376 : − Sends a MIDI event to host.+ − + − + − + − + − + − + − + − Enables the Battery Service following the definition from the Bluetooth SIG.+ + + − + − + − + − + − + + − Sets the current battery level in percentage (0..100) for the Battery Service (if enabled).+ + − + − + − +
Bluefruit-LE-Shield-BLE-Services (voir la source)
Version du 18 juin 2017 à 20:20
, 18 juin 2017 à 20:20→Services BLE
== Services BLE ==
== Services BLE ==
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.
== AT+BLEHIDCONTROLKEY ==
== AT+BLEHIDCONTROLKEY ==
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.
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
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.
* 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 ==
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 ==
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 ==
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
== AT+BLEMIDITX ==
== AT+BLEMIDITX ==
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 ==
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 ==
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}}