Name: Hardware Dog
Author: Sebastien Germain

02 // PRINCIPES

THE CORE MANIFESTO

Des limites d’architecture, pas des promesses marketing. Les lois vérifiables sont testées dans le dépôt.

01

LOCAL FIRST

Aucun compte, aucun abonnement, aucune télémétrie. Fonctionne 100 % hors ligne : le cloud n’est jamais requis.

ACCOUNT: NONE
SUBSCRIPTION: NONE
TELEMETRY: OFF
CLOUD: NEVER REQUIRED

02

NO FAKE CERTAINTY

Observation, corrélation et hypothèse restent séparées. Un diagnostic dit sa confiance et ses limites.

OBSERVED: USB disconnected 12:42:02.088
OBSERVED: 4.61 V at 12:42:02.011
CORRELATION: 4 of 5 disconnects after a drop
POSSIBLE: power instability

03

TOOL FIRST

Ressemble à un instrument avant de ressembler à un logiciel. Clavier d’abord, états toujours visibles.

F1HELP
F2TRACE
F3PROBE
F4REPORT
1-7SCREENS
CTRL KCOMMAND

04

DENSE, NOT NOISY

Le maximum d’information utile, le minimum de confusion. Huit mesures, un coup d’œil.

VBUS: 5.038 V
IBUS: 0.289 A
USB: ATTACHED
LINK: 1000 FULL
DHCP: PASS
DNS: PASS
RTT: 10 ms
LOSS: 0 %

HD-C017 · t+9.100 s · SIMULATED

03 // COMPANION TV

ONE TIMELINE. ONE INCIDENT.

Specialized tools investigate a layer.
Hardware Dog investigates the incident.

Il ne remplace pas un profileur d’alimentation, un analyseur logique ou un analyseur USB : eux vont plus profond, Hardware Dog va plus large. Un seul chien suit chaque couche, avec de vrais événements. Choisissez une chaîne.

ONE EVENT MODEL. ONE CLOCK.

Un vrai fichier du dépôt, rejoué : la tension chute, l’USB décroche 84 ms plus tard, le réseau tombe à 335 ms. Trois couches, une seule horloge.

CASE HD-C017 ↗ROUTER LOSES POWERORIGIN: SIMULATED

POWERtension, courant, pics, chutes, négociation d’alimentation USB

▼ 4.603 V · 0.726 A 4.75 V

USBénumération, descripteurs, VID/PID, vitesse, branchement / débranchement

DETACH +84 ms ATTACH

SERIALmoniteur UART, détection du débit, compteurs RX/TX

rst:0x1 (POWERON)

BUSscan I2C (SPI / CAN plus tard)

aucun événement

NETlien, DHCP, passerelle, DNS, internet, latence, pertes

LINK DOWN +335 ms

TRACEchaque événement de chaque source sur une seule horloge

POWER → USB → NET · 335 ms POWER_INSTABILITY · NETWORK_POWER_LOSS

OBSERVED: voltage 4.603 V at t+9.120 s, under the 4.75 V threshold #474
OBSERVED: USB detached at t+9.204 s, network link down at t+9.455 s #479 #492
CORRELATION: 4 of 4 USB disconnects followed a voltage drop.
POSSIBLE CAUSE: power instability: the router loses power. CONFIDENCE HIGH

04 // THE .HDLOG STANDARD

DON'T SEND A SCREENSHOT. SEND THE .HDLOG.

Chaque session est enregistrée dans votre navigateur pendant qu’elle se produit, scellée par SHA-256, et rejouée à l’identique, sans le matériel. Un atelier peut envoyer la panne d’un client à quelqu’un qui connaît la carte.

01
RECORD
Enregistré en local, pendant que ça se passe : chaque trame, chaque rejet, chaque commande, sur l’horloge de la sonde.
IndexedDB · ce navigateur
02
SEAL
Haché par SHA-256. Hardware Dog dit si c’est la session telle qu’enregistrée, ou si des octets ont changé depuis.
VERIFIEDMODIFIEDSIMULATED
03
REPLAY
Rejoué à l’identique, dans le même décodeur et avec les mêmes règles. Une panne intéressante devient un cas : un test de régression que le moteur doit continuer d’expliquer.
cases/ · 18 CASEShwdog test ../cases

HD-C017.hdlog 185 KB · 2343 FRAMES · 44.9 s ✓ VERIFIEDSIMULATED

{"hdlog":2,"proto":1,"id":"HD-20260930-1421","origin":"SIMULATED","scenario":"HD-T016",…}
{"frame":{"type":"hello","device":"HD-001","fw":"0.1.0","caps":["power","usb","uart","i2c","net","probe"]}}
⋮
{"frame":{"type":"power","t":9120,"v":4.603,"i":0.7261}}
{"frame":{"type":"usb.detach","t":9204}}
{"frame":{"type":"net.status","t":9455,"link":{"up":false,…}}}
⋮
{"seal":{"n":1,"lines":2343,"sha256":"ffdbf897bc415985b0c440a7dfa7dff9ef30c7b971214d77c9a902e58bccd3b4"}}
{"end":{"closed":"NORMAL","frames":2343,"rejects":0,"lost":0,"seals":1,…}}

SHA-256 (FILE)75a2ae64a065c15269914c58ecb368b59a25a5dedb935fd7650ecc383c3af059

[ OUVRIR UN .HDLOG ] PARCOURIR LES CAS ↗

05 // LES OUTILS / DANS LE NAVIGATEUR

Diagnostic matériel local-first. Dans votre navigateur.

Camera Sniffer, Bluetooth Lab, Flipper Lab, USB, réseau et série : ce que chaque outil fait vraiment, et ses limites. Une démo fonctionne dans tous les navigateurs.

CAMERA SNIFFER

Caméras cachées : des indices, sans app cloud.

Repère des indices de caméras sur un réseau que vous choisissez (avec dogd), en Bluetooth et en USB, et guide une inspection physique objet par objet. Il dit ce qu’il observe : un scan sans indice ne prouve pas qu’il n’y a aucune caméra.

OBSERVED ≠ CONFIRMED

BLUETOOTH LAB

Un scanner Bluetooth LE dans le navigateur.

Les appareils Bluetooth LE autour de vous, par Web Bluetooth quand le navigateur le permet, ou par dogd sous Linux.

BLE / GATT

FLIPPER LAB

Flipper Zero par Web Serial, sans app à installer.

Lire le stockage et les captures d’un Flipper Zero depuis un navigateur Chromium sur ordinateur (Web Serial).

READ, COMPARE, ARCHIVE

USB · RÉSEAU · SÉRIE

La console d’une carte, le réseau de cet ordinateur.

La console série de n’importe quelle carte dans le navigateur ; le réseau et les périphériques USB de cet ordinateur par dogd, le daemon local optionnel. La sonde Hardware Dog est encore en développement.

WEB SERIAL / DOGD

06 // WHO / BEHIND THE DOG

THE HARDWARE KID.

Seub · Sebastien Germain

Seub à son bureau avec son chien — BUILD. FIX. REPEAT.

HARDWARE DOG / BY SEUB

Du code. Des circuits. Du concret.

Créateur de Hardware Dog. Une idée simple : comprendre les machines avec des outils qui restent entre vos mains.

Offrir un café à Seub ↗ Découvrir seub.net ↗ Hardware Dog sur GitHub ↗

Seub dans son atelier, devant un projet mécanique — JUST ONE MORE UPGRADE.

Hardware Dog // SNIFF THE PROBLEM.