Bluefruit-LE-Shield-SDEP - Historique des versions

Admin le 25 août 2025 à 12:41

2025-08-25T12:41:10Z

Admin : /* Sample Transaction */

2017-08-03T20:55:56Z

Sample Transaction

Admin : /* SDEP - protocole d'échange de donnée simplifié */

2017-07-29T20:02:52Z

SDEP - protocole d'échange de donnée simplifié

Admin : /* Sample Transaction */

2017-07-29T19:33:13Z

Sample Transaction

Admin : /* Transactions de données SDEP */

2017-07-29T19:15:29Z

Transactions de données SDEP

Admin : /* Paquets SDEP et identification des erreurs SPI */

2017-07-29T19:09:12Z

Paquets SDEP et identification des erreurs SPI

Admin : /* Configurer SPI */

2017-07-29T17:09:43Z

Configurer SPI

Admin : /* Présentation de SDEP */

2017-07-29T16:35:21Z

Présentation de SDEP

Admin : /* Configurer SPI */

2017-07-29T16:34:35Z

Configurer SPI

Admin : /* Présentation de SDEP */

2017-07-25T11:22:45Z

Présentation de SDEP

← Version précédente		Version du 25 août 2025 à 12:41
Ligne 1 :		Ligne 1 :
	{{Bluefruit-LE-Shield-NAV}}		{{Bluefruit-LE-Shield-NAV}}
−
−	~~{{traduction}}~~

	== SDEP (SPI Data Transport) ==		== SDEP (SPI Data Transport) ==

@@ Ligne 49 : / Ligne 49 : @@
 * 0xFE, 0xFF qui indiquent une condition d'erreur
-=== Sample Transaction ===
+=== Exemple de Transaction ===
 L'image suivante présente un exemple de réponse SDEP qui est réparti sur deux paquets (étant donné que la taille de la réponse est > 20 octets). Notez comme la ligne IRQ reste active entre les deux paquets puisque plus d'un paquet était disponible dans la mémoire tampon FIFO sur le Bluefruit LE (côté esclave du bus SPI):

@@ Ligne 55 : / Ligne 55 : @@
 == SDEP - protocole d'échange de donnée simplifié ==
-SDEP est l'acronyme de "Simple Data Exchange Protocol".
+SDEP est l'acronyme de "Simple Data Exchange Protocol" qui signifie "Protocole simple d'échange de donnée".
-The Simple Data Exchange Protocol (SDEP) can be used to send and receive binary messages between two connected devices using any binary serial bus (USB HID, USB Bulk, SPI, I2C, Wireless, etc.), exchanging data using one of four distinct message types (Command, Response, Alert and Error messages).
+SDEP peut être utilisé pour envoyer et recevoir des messages binaires entre deux périphériques connectés ensembles par l'intermédiaire d'un bus série (USB HID, USB Bulk, SPI, I2C, Wireless, etc.), échangeant des données en utilisant l'un des 4 types de messages disponibles (message de Commande, Réponse, Alerte et Erreur).
-The protocol is designed to be flexible and extensible, with the only requirement being that '''individual messages are 20 bytes or smaller''', and that the first byte of every message is a one byte (U8) identifier that indicates the message type, which defines the format for the remainder of the payload.
+Le protocole est conçu pour pour être flexible et extensible, avec le seule exigence d'avoir '''des messages individuel de maximum 20 octets''', et que le premier octet de chaque message est un octet/byte (U8) qui indique le type de message. Le type de message définit également le format du restant du paquet (''payload'').
 === Endianness ===
-[https://fr.wikipedia.org/wiki/Endianness#Big_endian Endianness] (''wikipedia'') est l'ordre dans lequel sont organiser les octets en mémoire et dans les communications lorsqu'ils transportent une informations qui doit être stocké une taille supérieure à 1 octet. C'est le cas des entiers qui se codent sur 16 ou 32 bits.
+[https://fr.wikipedia.org/wiki/Endianness#Big_endian Endianness] (''wikipedia'') est l'ordre dans lequel sont organiser les octets en mémoire et dans les communications lorsqu'ils transportent une informations d'une taille supérieure à 1 octet. C'est le cas des entiers qui se codent sur 16 ou 32 bits.
-All values larger than 8-bits are encoded in little endian format. Any deviation from this rule should be clearly documented.
+Dans le protocole SDEP, toutes les valeurs supérieures à 8-bits sont encodées avec le format ''little endian''. Toute déviance à cette règle doit être clairement documenté.
 === Indicateur du type de message ===
-The first byte of every message is an 8-bit identifier called the '''Message Type Indicator''' en anglais. This value indicates the type of message being sent, and allows us to determine the format for the remainder of the message.
+Le tout premier octet de chaque message est un identifiant 8 bits appelé '''Message Type Indicator''' en anglais. Cette valeur indique le type message envoyé et permet de déterminer le format du restant du message.
 {| class="wikitable" border="1"
 |-
-| align="center" | Message Type
+| align="center" | Type de message
 | align="center" | ID (U8)
 |- style="font-size: 90%"
-| align="left" | Command
+| align="left" | Commande
 | align="left" | 0x10
 |- style="font-size: 90%"
-| align="left" | Response
+| align="left" | Réponse
 | align="left" | 0x20
 |- style="font-size: 90%"
-| align="left" | Alert
+| align="left" | Alerte
 | align="left" | 0x40
 |- style="font-size: 90%"
-| align="left" | Error
+| align="left" | Erreur
 | align="left" | 0x80
 |}

@@ Ligne 50 : / Ligne 50 : @@
 === Sample Transaction ===
-The following image shows a sample SDEP response that is spread over two packets (since the response is > 20 bytes in size). Notice that the IRQ line stays asserted between the packets since more than one packet was available in the FIFO on the Bluefruit LE SPI side:
+L'image suivante présente un exemple de réponse SDEP qui est réparti sur deux paquets (étant donné que la taille de la réponse est > 20 octets). Notez comme la ligne IRQ reste active entre les deux paquets puisque plus d'un paquet était disponible dans la mémoire tampon FIFO sur le Bluefruit LE (côté esclave du bus SPI):
 {{ADFImage|Bluefruit-LE-Shield-SDEP-sample.png}}

@@ Ligne 88 : / Ligne 88 : @@
 === Transactions de données SDEP ===
-Either connected device can initiate SDEP transactions, though certain transport protocols imposes restrictions on who can initiate a transfer. The master device, for example, always initiates transactions with Bluetooth Low Energy or USB, meaning that slave devices can only reply to incoming commands.
+L'un ou l'autre des périphériques connectés peu initier un transaction SDEP. Néanmoins, certains protocoles de transport impose des restrictions concernant lequel "des périphériques" peut initier un transfert.
-Every device that receives a '''Command Message''' must reply with a '''Response Message''', Error Message or Alert message.
+Par exemple, le périphérique maître initie TOUJOURS les transactions avec le Bluetooth Low Energy ou USB, ce qui signifie que le périphérique esclave peut uniquement répondre au commandes entrantes.
 {{ambox|text=Cette partie du tutoriel est très technique et ne concernera, a priori, que quelques utilisateurs avancés. Vous pouvez poursuivre votre lecture directement sur tutoriel d'Adafruit}}
-Poursuivre votre lecture sur [https://learn.adafruit.com/adafruit-bluefruit-le-shield/sdep-spi-data-transport#sdep-data-transactions https://learn.adafruit.com/adafruit-bluefruit-le-shield/sdep-spi-data-transport#sdep-data-transactions]
+Si cette partie du tutoriel vous intéresse, vous pouvez '''poursuivre votre lecture''' sur [https://learn.adafruit.com/adafruit-bluefruit-le-shield/sdep-spi-data-transport#sdep-data-transactions https://learn.adafruit.com/adafruit-bluefruit-le-shield/sdep-spi-data-transport#sdep-data-transactions]
 {{Bluefruit-LE-Shield-TRAILER}}

@@ Ligne 39 : / Ligne 39 : @@
 Si nous nous trouvons face à un "''Message Type Indicator''" SDEP standard (0x10, 0x20, 0x40 or 0x80) alors nous pouvons poursuivrez normalement la lecture
-{{traduction}}
+Il existe deux autre "''Message Type Indicator''" dont il faut tenir compte. Ces derniers indique un problème du côté esclave de la communication SPI (le nRF51822):
-There are two other indicators that should be taken into account, though, which indicate a problem on the nRF51822 SPI slave side:
+* '''0xFE''' : Le périphérique esclave n'est pas prêt (attendre un peu et réessayer)
-* '''0xFE''' : Slave device not ready (wait a bit and try again)
+* '''0xFF''' : Indicateur de dépassement de lecture (''read overflow indicator'') sur le périphérique esclave (il y a eu une tentative de lire plus de donnée que de donnée vraiment  disponible sur l'esclave)
-This means there are six possible response bytes reading the message type indicator (the first byte read after an SDEP command is sent): 0x10, 0x20, 0x40, 0x80, which indicate a valid message type, or 0xFE, 0xFF which indicate an error condition.
+Cela signifie qu'il y a 6 réponses possible dansle premier octet lu (donc la valeur du "message type indicator" renvoyée par le périphérique esclave).
 === Sample Transaction ===

@@ Ligne 18 : / Ligne 18 : @@
 == Configurer SPI ==
-Bien que SDEP soit neutre is bus neutral, in the case of the Bluefruit LE SPI Friend or Shield, an SPI transport is used with the following constraints and assumptions, largely to take into account the HW limitations of the nRF51822 system on chip:
+Bien que SDEP soit prévu pour être un protocole neutre vis-à-vis du bus, dans le cas du Bluefruit LE SPI Friend ou du shield BlueFruit LE, le transport SPI est utilisé avec les contraintes et suppositions suivantes, principalement guidés par les limitations matérielles du nRF51822:
 === Conditions requises du SPI matérielles ===
-* The SPI clock should run <=4MHz
+* Le signal d'horloge SPI doit être <= 4MHz
-* A 100us delay should be added between the moment that the CS line is asserted, and before any data is transmitted on the SPI bus
+* Un délais de 100µs doit être ajouté entre le moment où la ligne CS est activée et la transmission des premières données sur le bus SPI
-* The CS line must remain activée (''asserted'') for the entire packet, rather than toggling CS every byte
+* La ligne CS doit rester activée (''asserted'') pour tout le paquet de donnée (et non activé pour chaque octet transmit)
-* The CS line can however be deasserted and then reasserted between individual SDEP packets (of up to 20 bytes each).* The SPI commands must be setup to transmit MSB ([https://en.wikipedia.org/wiki/Most_significant_bit most significant bit]) first (not LSB first)
+* La ligne CS peut cependant être activée ou désactivée entre l'envoi de différents paquets SDEP (chaque paquet ayant jusqu'à 20 octets max).
 === Broche IRQ ===
-The IRQ line is asserted by the Bluefruit LE SPI Friend/Shield as long as an entire SDEP packet is available in the buffer on the nRF51822, at which point you should read the packet, keeping the CS line asserted for the entire transaction (as detailed above).
+La ligne IRQ est activée par le par le Bluefruit LE Shield (ou Friend) SPI dès que (et aussi longtemps que) un paquet SDEP complet est disponible dans la mémoire tampon (''buffer'') du nRF51822. Vous devriez lire le paquet lorsque l'IRQ (interruption) est activée, garder la ligne CS activée durant la transaction entière (comme détaillé ci-dessous).
-The IRQ line will remain asserted as long as one or more packets are available, so the line may stay high after reading a packet, meaning that more packets are still available in the FIFO on the SPI slave side.
+La ligne IRQ reste activée aussi longtemps qu'un ou plusieurs paquets sont disponibles. Par conséquent, la ligne pourrait rester active après la lecture d'un paquet, cela signifie qu'il reste encore des paquets à lire dans la mémoire tampon FIFO du module SPI esclave.
-=== Paquets SDEP et identifaction des erreurs SPI ===
+FIFO est l'acronyme de ''First In First Out'' qui signifie "Premier Rentré Premier Sorti".
-If a standard SDEP message type indicator (0x10, 0x20, 0x40 or 0x80) is encountered, keep reading as normal. There are two other indicators that should be taken into account, though, which indicate a problem on the nRF51822 SPI slave side:
+=== Paquets SDEP et identification des erreurs SPI ===
 * '''0xFE''' : Slave device not ready (wait a bit and try again)
 * '''0xFF''' : Slave device read overflow indicator (you've read more data than is available)

@@ Ligne 11 : / Ligne 11 : @@
 == Présentation de SDEP ==
-SDEP à été conçu comme un protocole bus neutre pour gérer la transmission de commandes et réponses binaires -- incluant les messages d'erreur --. Le protocole est conçu pour être facile à étendre. Un protocole bus neutre (''Bus neutral'') signifie que nous pouvons utiliser SDEP quelque soit le mécanisme de transport (USB HID, SPI, I2C, Donnée via une connexion sans fil, etc.).
+SDEP à été conçu comme un protocole bus neutre pour gérer la transmission de commandes et réponses binaires -- incluant les messages d'erreur --. Le protocole est conçu pour être facile à étendre. Un protocole neutre pour bus (''Bus neutral'') signifie que nous pouvons utiliser SDEP quelque soit le mécanisme de transport (USB HID, SPI, I2C, Donnée via une connexion sans fil, etc.).
 Tous les messages SDEP ont '''une entête de 4 octets''' et dans le cas des modules Bluefruit LE '''jusqu'à 16 octets de payload'''. Les grands messages sont coupé en plusieurs messages de 4+16 octets (appelés ''message chunks''), ce qui permet de reconstruire le message de l'autre côté du bus.