Caractéristique BLE : lire, écrire et notifier sur iPhone

Services, caractéristiques et propriétés BLE en une minute

Un appareil BLE regroupe ses données en services, et chaque service contient des caractéristiques. Une caractéristique est une seule valeur, comme un niveau de batterie ou un canal de données, et ses propriétés indiquent ce que vous pouvez en faire : la lire, l'écrire, ou être notifié quand elle change. Periphery affiche ces propriétés comme de petites étiquettes sur chaque ligne : R pour lecture, W pour écriture et N pour notification ou indication.

Comment lire une caractéristique

Touchez Numériser, puis touchez votre appareil. Periphery se connecte et liste ses services.
Trouvez une caractéristique avec une étiquette R et touchez Lire.
La valeur apparaît sous la caractéristique. Utilisez le sélecteur Format pour basculer entre Hex, Décimal, ASCII et Binaire.

Comment écrire des octets sur une caractéristique

Touchez Écrire sur une caractéristique avec une étiquette W. La feuille Écrire en hexadécimal s'ouvre.
Tapez les octets en paires hexadécimales, par exemple 01 FF. Les espaces sont facultatifs.
Vérifiez la ligne sous le champ : elle indique combien d'octets seront envoyés, ou avertit que le texte n'est pas de l'hexadécimal valide.
Touchez Envoyer, ou Annuler pour fermer sans écrire.

Si la caractéristique prend en charge l'écriture avec réponse, Periphery l'utilise et attend la confirmation de l'appareil. Si elle ne prend en charge que l'écriture sans réponse, les octets sont envoyés sans confirmation, alors relisez la valeur ou surveillez une notification pour vérifier qu'elle est bien arrivée.

Comment s'abonner aux notifications

Touchez Notifier sur une caractéristique avec une étiquette N.
Chaque fois que l'appareil envoie une nouvelle valeur, elle remplace celle affichée sous la caractéristique.
Touchez Arrêter de notifier pour vous désabonner. Quitter l'inspecteur déconnecte et met fin à tous les abonnements.

Exemple concret : une valeur, quatre formats

Supposons qu'une caractéristique renvoie les trois octets que vous pourriez envoyer à une carte de test. Voici comment chaque format les affiche :

Les mêmes trois octets dans chaque format
Format	Affiché comme
Hex	01 41 42
Décimal	1 65 66
Binaire	00000001 01000001 01000010
ASCII	Seul le premier octet ne s'imprime pas ; les deux autres s'affichent comme des lettres, AB

Une caractéristique Battery Level (2A19) qui renvoie 5A en hex se lit 90 en décimal, ce qui signifie 90 %. Les champs texte comme Manufacturer Name se lisent plus facilement en ASCII.

Enregistrer une session de test avec Pro

Avec Periphery Pro, chaque lecture, écriture et notification pendant une connexion est sauvegardée automatiquement avec un horodatage, un sens, l'UUID de la caractéristique et les octets bruts. Ouvrez l'onglet Journaux pour voir chaque session et son nombre de paquets, balayez une session et touchez Exporter pour la partager en texte brut, ou Supprimer pour la retirer. Une session sans paquet est écartée en quittant l'inspecteur. Sans Pro, rien n'est enregistré.

Astuces et erreurs courantes

Les boutons n'apparaissent que pour ce que la caractéristique autorise. L'absence de bouton Lire signifie que la propriété n'est pas définie, pas que l'app le cache.
Les nombres sur plusieurs octets sont généralement en little-endian en BLE. 34 12 en hex vaut 0x1234, pas 0x3412.
Une lecture ou une écriture peut échouer si la caractéristique nécessite un appairage ou un chiffrement. iOS gère l'appairage ; acceptez son invite et réessayez.
En général, une seule app ou un seul téléphone peut détenir une connexion. Déconnectez votre propre app de test ou un autre téléphone d'abord.

Questions fréquentes

Quelle est la différence entre notifier et indiquer ?

Les deux permettent à l'appareil de pousser de nouvelles valeurs sans que vous les lisiez. Indiquer demande en plus un accusé de réception. Periphery affiche les deux avec l'étiquette N et s'abonne aux deux avec le même bouton Notifier.

Puis-je écrire du texte au lieu de l'hexadécimal ?

Pas directement. La feuille d'écriture n'accepte que des octets hexadécimaux. Pour envoyer le texte AB, tapez ses codes ASCII, 41 42.

Pourquoi vois-je Connexion en cours… puis une erreur ?

L'appareil n'a pas accepté la connexion dans les 10 secondes. Il est peut-être hors de portée, déjà connecté à un autre téléphone, ou n'accepte aucune connexion.

Puis-je lire les descripteurs ?

L'inspecteur de Periphery fonctionne au niveau de la caractéristique : lire, écrire et notifier. Les valeurs de descripteur ne sont pas affichées comme des lignes séparées.

Comment lire, écrire et s'abonner à une caractéristique BLE depuis son iPhone