Il \u00e9tait une fois un d\u00e9veloppeur (appelons le Martin) qui devait lire un fichier binaire produit par un capteur. Pas de documentation claire, juste une trame brute de quelques dizaines d’octets, et la vague indication que les valeurs \u00e9taient encod\u00e9es en Little Endian.<\/p>\n\n\n\n
Martin soupira, ouvrit son \u00e9diteur, et se demanda par o\u00f9 commencer.<\/p>\n\n\n\n
Si vous vous \u00eates d\u00e9j\u00e0 retrouv\u00e9 dans la peau de Martin, cet article est pour vous. Nous allons explorer ensemble les outils que MOGWAI met \u00e0 votre disposition pour manipuler des donn\u00e9es binaires, sans douleur, et presque avec plaisir.<\/p>\n\n\n\n
En MOGWAI, les donn\u00e9es binaires sont repr\u00e9sent\u00e9es par le type Ici, quatre octets : On peut conna\u00eetre la taille d’un Et acc\u00e9der \u00e0 un octet pr\u00e9cis avec get <\/strong>(index base z\u00e9ro) :<\/p>\n\n\n\n Martin doit envoyer une commande \u00e0 son capteur. La commande est simple : un octet d’en-t\u00eate ( Il peut construire cette trame avec l’op\u00e9rateur +<\/strong> qui concat\u00e8ne deux Ou bien construire un La trame de r\u00e9ponse du capteur fait 8 octets. Martin sait que les octets 2 \u00e0 4 contiennent la valeur qui l’int\u00e9resse. Il utilise sub <\/strong>(d\u00e9but + longueur) :<\/p>\n\n\n\n Ou left <\/strong>et right <\/strong>pour prendre depuis le d\u00e9but ou la fin :<\/p>\n\n\n\n C’est l\u00e0 que Martin a failli abandonner. Son capteur encode les entiers en Little Endian<\/strong>, l’octet de poids faible en premier. Donc la valeur MOGWAI a une famille compl\u00e8te de primitives pour g\u00e9rer \u00e7a proprement.<\/p>\n\n\n\n Pour encoder un entier en Little Endian :<\/p>\n\n\n\n Les variantes couvrent 8, 16, 24, 32, 48 et 64 bits, en Little et Big Endian.<\/p>\n\n\n\n Et dans l’autre sens, pour d\u00e9coder :<\/p>\n\n\n\n La convention de nommage est volontairement sym\u00e9trique : -><\/strong> en pr\u00e9fixe signifie on produit ce type<\/em>, -><\/strong> en suffixe signifie on consomme ce type<\/em>. Une fois ce principe int\u00e9gr\u00e9, les noms deviennent \u00e9vidents.<\/p>\n\n\n\n Si la taille en bits d\u00e9pend d’une variable, les variantes dynamiques ->dataLE<\/strong> et dataLE-><\/strong> acceptent la taille depuis la pile :<\/p>\n\n\n\n Le capteur de Martin envoie aussi des mesures de temp\u00e9rature encod\u00e9es en virgule flottante IEEE 754, sur 32 bits, en Little Endian. Pas de probl\u00e8me :<\/p>\n\n\n\n Le Certaines trames commencent par un marqueur de d\u00e9but ( where <\/strong>retourne la liste de toutes les positions o\u00f9 le pattern appara\u00eet. Ici, le marqueur est pr\u00e9sent \u00e0 l’index 0 et \u00e0 l’index 3.<\/p>\n\n\n\n Parfois, il est plus pratique de travailler avec une liste de valeurs num\u00e9riques plut\u00f4t qu’un bloc binaire. ->list<\/strong> fait la conversion :<\/p>\n\n\n\n Chaque \u00e9l\u00e9ment de la liste est la valeur d\u00e9cimale de l’octet correspondant.<\/p>\n\n\n\n Pour les op\u00e9rations au niveau du bit, MOGWAI dispose du type Les op\u00e9rateurs classiques AND ( Martin finit par d\u00e9coder sa trame en une poign\u00e9e de lignes. Ce qui lui avait sembl\u00e9 rebutant au premier abord \u00e9tait devenu presque agr\u00e9able une fois les bons outils en main.<\/p>\n\n\n\n Les fonctions de manipulation binaire de MOGWAI couvrent l’essentiel des besoins : construction, extraction, endianness, flottants, recherche de patterns, op\u00e9rations bit \u00e0 bit. Le tout avec une convention de nommage coh\u00e9rente qui, une fois apprise, rend le code tr\u00e8s lisible.<\/p>\n\n\n\n Et si vous avez besoin de CRC ou d’autres op\u00e9rations plus sp\u00e9cialis\u00e9es, la r\u00e9ponse viendra sous forme de plugins, mais \u00e7a, c’est une autre histoire.<\/p>\n\n\n\n MOGWAI<\/a> \u2014 open source depuis f\u00e9vrier 2026 \u00b7 GitHub<\/a> \u00b7 coding4phone.com<\/em><\/p>\n","protected":false},"excerpt":{"rendered":" Martin, d\u00e9veloppeur, doit lire un fichier binaire d’un capteur sans documentation. L’article explique comment MOGWAI manipule facilement des donn\u00e9es binaires, incluant construction, extraction et gestion de l’endianness.<\/p>\n","protected":false},"author":1,"featured_media":2249,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"advanced_seo_description":"D\u00e9couvrez comment Martin, un d\u00e9veloppeur, utilise MOGWAI pour manipuler des fichiers binaires et d\u00e9coder des donn\u00e9es sans souci.","jetpack_seo_html_title":"D\u00e9coder des fichiers binaires avec MOGWAI : Guide pratique","jetpack_seo_noindex":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2},"_wpas_customize_per_network":false,"jetpack_post_was_ever_published":false},"categories":[8,6,48,50],"tags":[],"class_list":["post-2239","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","category-mogwai","category-rpn","category-scripting"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"https:\/\/i0.wp.com\/coding4phone.com\/wp-content\/uploads\/2026\/04\/coding-4-phone-69dcc483cac9e.png?fit=1024%2C1024&ssl=1","jetpack_likes_enabled":true,"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/pfoe4s-A7","jetpack-related-posts":[],"_links":{"self":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts\/2239","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2239"}],"version-history":[{"count":11,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts\/2239\/revisions"}],"predecessor-version":[{"id":2260,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/posts\/2239\/revisions\/2260"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=\/wp\/v2\/media\/2249"}],"wp:attachment":[{"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2239"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2239"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/coding4phone.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2239"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}DATA<\/code>, not\u00e9 avec le pr\u00e9fixe D:<\/code>. C’est simplement une s\u00e9quence d’octets.<\/p>\n\n\n\nD:FF45AB23<\/pre>\n\n\n\n
0xFF<\/code>, 0x45<\/code>, 0xAB<\/code> et 0x23<\/code>. Simple, lisible, direct.<\/p>\n\n\n\nDATA<\/code> avec size <\/strong>:<\/p>\n\n\n\nD:FF45AB23 size ?
# \u2192 4<\/pre>\n\n\n\nD:FF45AB23 1 get ?
# \u2192 69 (c'est 0x45 en d\u00e9cimal)<\/pre>\n\n\n\nConstruire une trame octet par octet<\/h2>\n\n\n\n
0xAA<\/code>), suivi d’un identifiant sur deux octets, suivi d’un octet de fin (0xFF<\/code>).<\/p>\n\n\n\nDATA<\/code> :<\/p>\n\n\n\nD:AA D:1234 + D:FF +
# \u2192 D:AA1234FF<\/pre>\n\n\n\nDATA<\/code> depuis des valeurs pr\u00e9sentes sur la pile avec ->data<\/strong> : <\/p>\n\n\n\n0xAA 0x12 0x34 0xFF 4 ->data
# \u2192 D:AA1234FF<\/pre>\n\n\n\nExtraire une partie d’une trame<\/h2>\n\n\n\n
D:FF001234ABCD0055 2 3 sub
# \u2192 D:1234AB<\/pre>\n\n\n\nD:FF001234ABCD0055 3 left
# \u2192 D:FF0012
D:FF001234ABCD0055 2 right
# \u2192 D:0055<\/pre>\n\n\n\nL’endianness, ou l’art de lire dans le bon sens<\/h2>\n\n\n\n
0x00001234<\/code> (soit 4660 en d\u00e9cimal) est stock\u00e9e comme D:34120000<\/code> dans le fichier.<\/p>\n\n\n\nNombre \u2192 DATA<\/h3>\n\n\n\n
4660 ->dataLE32
# \u2192 D:34120000
4660 ->dataBE32
# \u2192 D:00001234<\/pre>\n\n\n\nDATA \u2192 Nombre<\/h3>\n\n\n\n
D:34120000 dataLE32->
# \u2192 4660
D:00001234 dataBE32->
# \u2192 4660<\/pre>\n\n\n\nLa taille n’est pas toujours connue \u00e0 l’avance<\/h3>\n\n\n\n
4660 32 ->dataLE
# \u2192 D:34120000
D:34120000 32 dataLE->
# \u2192 4660<\/pre>\n\n\n\nEt pour les nombres flottants ?<\/h2>\n\n\n\n
23.5 ->dataLE32F
# \u2192 D:0000BC41
D:0000BC41 dataLE32F->
# \u2192 23.5<\/pre>\n\n\n\nF<\/code> dans le nom indique qu’il s’agit d’un flottant. Les variantes 64 bits (->dataLE64F<\/strong>, ->dataBE64F<\/strong>, etc.) fonctionnent exactement de la m\u00eame fa\u00e7on.<\/p>\n\n\n\nChercher un pattern dans une trame<\/h2>\n\n\n\n
SOF<\/code>, Start Of Frame). Martin cherche D:FF56<\/code> dans un buffer de donn\u00e9es :<\/p>\n\n\n\nD:FF5623FF5678AB D:FF56 where
# \u2192 (0 3)<\/pre>\n\n\n\nConvertir un DATA en liste d’entiers<\/h2>\n\n\n\n
D:FF45AB23 ->list
# \u2192 (255 69 171 35)<\/pre>\n\n\n\nEt les bits ?<\/h2>\n\n\n\n
B:<\/code> (binaire) et d’un jeu complet d’op\u00e9rateurs :<\/p>\n\n\n\nB:11001010 2 >> # D\u00e9calage \u00e0 droite \u2192 B:00110010
B:11001010 2 << # D\u00e9calage \u00e0 gauche \u2192 B:00101000
B:11001010 2 up # Met le bit 2 \u00e0 1 \u2192 B:11001110
B:11001010 2 down # Met le bit 2 \u00e0 0 \u2192 B:11001000
B:110011 1 bit? # Le bit 1 est-il \u00e0 1 ? \u2192 true<\/pre>\n\n\n\n&<\/strong><\/code>), OR (|<\/strong><\/code>), XOR (^<\/strong><\/code>) et NOT (~<\/strong><\/code>) sont aussi disponibles sur les nombres.<\/p>\n\n\n\nLe mot de la fin<\/h2>\n\n\n\n
\n\n\n\n