BaudBuddy

Un terminal BLE UART pour macOS

Utiliser Nordic UART Service et HM-10 depuis un Mac : pourquoi aucun débit en bauds n'est à régler et comment la limite de 20 octets par paquet peut faire croire qu'une liaison fonctionnelle est défectueuse.

La série sans fil est un mensonge confortable. Votre carte possède un UART, un module BLE se trouve à l’autre extrémité et, depuis votre Mac, cela ressemble à un port série. Ce n’en est pas un, et les endroits où l’illusion fuit sont suffisamment prévisibles pour être répertoriés.

Deux profils BLE courants

Il n’existe pas de profil Bluetooth standard pour la série sur BLE. Le Bluetooth classique avait SPP ; BLE l’a abandonné et l’industrie a plutôt opté pour deux conventions.

Service UART nordique. Service UUID 6E400001-B5A3-F393-E0A9-E50E24DCCA9E, avec une caractéristique dans laquelle vous écrivez et une autre qui vous avertit en retour. Si votre carte est basée sur nRF, ou si vous utilisez un Adafruit Bluefruit, ou si vous avez suivi presque tous les exemples ESP32 BLE UART, voici ce que vous avez.

HM-10. Service FFE0, caractéristique FFE1, des modules CC2541 vendus sous les noms HM-10, HM-19, AT-09 et JDY-08 selon qui a imprimé l’étiquette. Une caractéristique qui fait les deux sens.

N’importe quoi d’autre et vous écrivez une caractéristique à la main.

La liaison BLE n’a pas de débit en bauds

Le module a un UART sur son côté câblé, et ce côté a un débit en bauds, généralement 9600 ou 115200. Se tromper signifie que le module et votre carte ne sont pas d’accord, et vous voyez des bêtises.

Le lien BLE n’a aucun débit en bauds. Pas de parité, pas de bits d’arrêt, pas de contrôle de flux, pas de Break. Ces concepts n’existent pas au-dessus de la radio.

Ainsi, un terminal qui vous propose un débit en bauds pour une connexion Bluetooth vous montre une commande qui ne fait rien. C’est une petite malhonnêteté et cela finit par coûter une heure à quelqu’un, quand il le change, ne voit aucune différence et commence à chercher le défaut quelque part réel.

La liste des appareils Bluetooth dans BaudBuddy, montrant les périphériques BLE découverts avec la force du signal

Pendant la recherche, la puissance du signal permet de voir rapidement si un module est joignable ou probablement en veille.

La limite des 20 octets

C’est celui qui donne l’impression qu’un lien fonctionnel est rompu.

Une notification BLE contient 20 octets par défaut, car le MTU ATT par défaut est de 23 et trois vont à l’en-tête. Envoyez 100 octets depuis votre tableau et ils arrivent sous forme de cinq notifications distinctes.

Si votre code d’un côté ou de l’autre suppose qu’une écriture équivaut à un message, il s’interrompt ici, et il s’interrompt par intermittence, ce qui est pire. Un court message fonctionne. Un long se fend. Un message divisé sur une fin de ligne est traité sur deux lignes.

Les piles modernes négocient une MTU plus grande, souvent jusqu’à 244 octets de charge utile, mais les deux extrémités doivent être d’accord et de nombreux micrologiciels ne le demandent jamais. Supposons que vous puissiez être encadré sur 20 octets et faites en sorte que le protocole le tolère : terminez les lignes correctement, ne vous fiez pas aux limites des paquets et réassemblez avant l’analyse.

Le débit découle du même endroit. BLE UART vous donne de manière réaliste quelques kilo-octets par seconde. C’est bien pour une console et médiocre pour une image de firmware.

Connexion depuis un Mac

Le macOS gère le BLE via Core Bluetooth, et il y a deux conséquences à connaître.

Ces appareils n’apparaissent généralement pas dans le volet Bluetooth des Réglages Système. Ils ne sont pas jumelés de la manière habituelle : l’app les découvre et s’y connecte directement. Il est donc normal de ne pas y voir le module.

Et l’application a besoin de l’autorisation Bluetooth, que macOS demande une fois. Si une analyse ne trouve rien du tout, vérifiez-le avant de vérifier le module.

Si aucun appareil n’apparaît

Dans l’ordre qui résout réellement le problème :

  • Le module fait-il de la publicité ? La plupart arrêtent la publicité lorsqu’ils sont connectés à autre chose. Votre téléphone, depuis le dernier test. Déconnectez-le là.

  • Est-il alimenté et hors réinitialisation ? Une carte maintenant le module en réinitialisation n’annonce rien.

  • Est-ce BLE ? Un HC-05 ou HC-06 est du Bluetooth classique, pas du BLE. Il n’apparaîtra jamais dans une analyse BLE et nécessitera plutôt un couplage dans les paramètres système, après quoi il apparaîtra comme un port série normal.

  • Autorisation. Vérifiez les paramètres système, la confidentialité et la sécurité, Bluetooth.

  • Portée. BLE revendique plus de portée qu’il n’en offre à l’intérieur. Rapprochez-vous avant de conclure quoi que ce soit.

Si la connexion réussit, mais qu’aucune donnée n’arrive

  • Mauvaise caractéristique. Avec le HM-10, vous écrivez et recevez sur le même. Avec Nordic UART, ils sont séparés et l’écriture dans la caractéristique de notification échoue silencieusement.

  • Notifications non activées. La centrale doit s’abonner. Un client qui se connecte mais ne s’abonne jamais reste là à ne rien recevoir pour toujours.

  • Le débit UART du côté câblé est incorrect. La liaison BLE fonctionne, mais le module reçoit des données illisibles de la carte. Vérifiez la vitesse UART du module.

  • Votre carte n’envoie pas réellement. Confirmez d’abord via une connexion filaire. La moitié des problèmes BLE que les gens apportent sont des problèmes de câblage en portant un costume.

Enregistrer la connexion

La dernière petite chose. Un périphérique BLE est identifié par un UUID attribué par macOS, et non par une adresse MAC, et il est stable sur Mac. Ainsi, une connexion enregistrée retrouve le même module sans autre analyse, ce qui est important lorsque vous flashez et testez la même carte cinquante fois dans un après-midi.

BaudBuddy enregistre les connexions BLE de la même manière qu’il enregistre les connexions série, et il ne vous propose pas de débit en bauds pour celles-ci, car il n’y en a pas.