Documentation

Arnodiqa est une application de bureau pour Windows. Cette documentation décrit chaque tâche dans l'application, avec les étapes, des captures d'écran et un court enregistrement. Pour les bancs de test sans écran et pour les pipelines, la ligne de commande est décrite sous Automatisation et CI.

Créer un projet, démarrer la mesure, la Trace avec un filtre, une trame avec ses signaux et un signal dans Graphics.

La fenêtre principale

Les captures d'écran et les enregistrements suivent le thème de ce site. Cliquez sur une image pour l'agrandir.

Ouvrir un projet, créer un projet et ajouter une base de données

Un projet regroupe dans un seul fichier YAML les réseaux, les bases de données, le Measurement Setup, les panneaux (panels) et les nœuds de simulation.

1. Sans projet chargé, Arnodiqa ouvre la page d'accueil (Start). New project présente les modèles, Examples les exemples et Recent projects les derniers projets utilisés.

   

2. Cliquez en haut à gauche sur le menu du projet (le bouton portant le nom du projet ; sans projet, il affiche No project). Choisissez New project… pour créer un projet ou Open project… (Ctrl+O) pour ouvrir un fichier de projet existant (.yaml).

   

3. Dans la boîte de dialogue New project, saisissez le nom du projet sous Name, choisissez le dossier du projet sous Folder (avec Browse…) et un modèle sous Template, par exemple Full demo (CAN FD, CAN, panel, diagnostics). Cliquez sur Create.

   

4. Le projet est chargé et son nom apparaît dans la barre d'outils. Sur le desktop Project, l'explorateur de projet affiche les réseaux, les bases de données, le Measurement Setup, les panneaux et les nœuds de simulation ; le Simulation Setup se trouve à droite.

   

5. Les bases de données du projet figurent sous Databases, ici powertrain.dbc pour PowerTrain et comfort.dbc pour Comfort. Le crayon à côté d'un fichier DBC ou LDF ouvre le Database Editor ; la corbeille retire la base de données du projet, le fichier lui-même est conservé.

   

6. Pour ajouter une base de données, cliquez sur le + à droite de Databases ou sur le + à côté d'un réseau. Dans Add database, choisissez le réseau (ici Comfort), cliquez sur Choose… et sélectionnez un fichier DBC, LDF (pour un réseau LIN), ARXML ou FIBEX.

   

7. Si le fichier se trouve hors du dossier du projet, choisissez Copy it into the project folder (une copie à côté du fichier de projet) ou Reference it where it is (le projet désigne le fichier par un chemin relatif, par exemple ../Shared databases/body_extra.dbc). Cliquez sur Add database.

   

8. Arnodiqa enregistre puis recharge le projet : la base de données apparaît sous Databases pour Comfort, et Trace, Data et Graphics connaissent aussitôt ses messages.

   

Choisir le matériel ou utiliser le bus virtuel

Chaque réseau du projet est affecté à un canal : un canal d'une interface ou du bus virtuel.

1. Sur le desktop Project, l'explorateur de projet indique sous Networks l'affectation de chaque réseau, par exemple → virtual vcan1 · Virtual CAN Bus. Cliquez sur l'icône Hardware configuration à droite de Networks.

   

2. La fenêtre Hardware affiche sous Channel mapping le canal (colonne Hardware) et l'état de chaque réseau, et sous Interfaces, pour chaque pilote, s'il est disponible et quels canaux il a trouvés. Cliquez sur Rescan après avoir branché une interface.

   

3. Pour chaque réseau, choisissez dans la liste sous Hardware un canal d'une interface connectée, un canal du bus virtuel (Virtual CAN 1 …) ou Virtual network (Comfort). L'affectation s'applique immédiatement ; cliquez sur Save project pour mettre à jour le fichier de projet.

   

4. L'explorateur de projet affiche la nouvelle affectation à côté du réseau (→ virtual Comfort). Un canal introuvable au démarrage y apparaît comme not connected.

   

Démarrer et arrêter une mesure

La barre d'outils, la barre d'état et la fenêtre Statistics indiquent l'état de la mesure et la charge de bus.

1. Cliquez sur Start dans la barre d'outils ou appuyez sur F9. La flèche à côté de Start propose Start measurement without logging.

   

2. Pendant la mesure, l'état indique Running avec la durée de mesure, puis la charge de bus par canal. La Trace se remplit. La barre d'état en bas affiche le nombre d'événements, les événements par seconde et le remplissage du tampon.

   

3. La charge de bus apparaît dans la barre d'outils et dans la barre d'état. La fenêtre Statistics du desktop Signals donne plus de détails : par canal Busload [%], Peak load [%], les trames par seconde et les compteurs de trames. Les trois affichages utilisent le même calcul sur une fenêtre d'une seconde.

   

4. Arrêtez la mesure avec Stop ou Échap. La fenêtre Write affiche Measurement 1 stopped (user) after … s.

   

La Trace : modes, filtrage, signaux et export

La Trace affiche chaque trame et chaque événement de bus, décodés avec les bases de données du projet.

1. La Trace se trouve sur le desktop Analysis. En mode Chronological, chaque événement occupe sa propre ligne, le plus récent en bas. Maximize, en haut à droite, agrandit la fenêtre à tout le desktop.

   

2. Cliquez sur Fixed pour obtenir une ligne par message, mise à jour sur place. Abs et Rel sélectionnent le temps absolu ou relatif ; Espace met l'affichage en pause.

   

3. Saisissez un filtre dans le champ de filtre (Ctrl+F), ici name:Engine. Exemples : 1A0 ou id:100-1FF (ID ou plage), ch:CAN2 ou ch:Comfort (canal ou réseau), dir:tx, type:fd, !name:Door (négation). Les termes se combinent ; l'info-bulle du champ donne la syntaxe complète.

   

4. Deuxième exemple : ch:Comfort !name:Door affiche tous les messages du réseau Comfort sauf ceux dont le nom contient Door. La barre du bas indique filtered ; Échap dans le champ efface le filtre.

   

5. Cliquez sur la flèche en début de ligne pour déplier la trame : chaque signal apparaît en dessous avec sa valeur physique, son unité et sa valeur brute.

   

6. Le menu contextuel (clic droit) contient Export selected rows to log file… et Export shown events to log file… (tout ce que la fenêtre affiche avec le filtre en cours). Dans la boîte d'enregistrement, choisissez le nom et le type : BLF, ASC, MF4 ou PCAPNG.

   

7. Après l'export, Arnodiqa indique le nombre d'événements écrits ; la fenêtre Write mentionne chaque fichier, ici trace.blf, trace.asc et trace.mf4.

   

Suivre des signaux dans Data et Graphics

Data affiche les valeurs actuelles des signaux, Graphics leur évolution dans le temps.

1. Ouvrez le desktop Signals. Graphics et Data contiennent déjà des signaux issus des bases de données du projet.

   

2. Dans la fenêtre Data, cliquez sur Add signals. Dans Add signals to Data window, recherchez par nom (ici OilTemp), cochez le signal (Espace) et cliquez sur Add 1 signal (Entrée). Vous pouvez aussi faire glisser un signal de la Trace vers la fenêtre.

   

3. Procédez de même dans Graphics avec Add signals et démarrez la mesure (F9). Data affiche pour chaque signal la valeur actuelle, l'unité, la valeur brute et le min/max ; Graphics affiche l'évolution, avec la dernière valeur dans la liste des signaux.

   

4. Après l'arrêt, la courbe reste affichée. Dans Graphics, la molette zoome et un glisser déplace la vue ; le menu contextuel exporte les trames vers un fichier journal ou les signaux au format CSV.

   

Envoyer des messages avec l'Interactive Generator

L'Interactive Generator envoie des trames une seule fois, périodiquement ou sur appui d'une touche.

1. Le desktop Stimulation contient l'Interactive Generator avec des messages issus de la base de données du projet.

   

2. Cliquez sur + CAN pour une trame CAN personnalisée ; From database ajoute un message de la base de données. Saisissez l'ID (ici 7E0) et les octets de données sous Raw Data ; pour un message de la base de données, modifiez les valeurs sous Signals.

   

3. Démarrez la mesure. Send envoie la trame une fois. Réglez Trigger sur Periodic, saisissez la période en ms et cliquez sur Send : la trame est envoyée de façon cyclique et le bouton devient Stop.

   

4. La Trace du desktop Analysis affiche les trames envoyées avec la direction Tx ; le filtre dir:tx id:7E0 n'affiche que cette trame.

   

Simulation de bus résiduel : nœuds et couche d'interaction

Le Simulation Setup affiche les nœuds simulés et l'état de leur couche d'interaction (Interaction Layer, IL).

1. Le Simulation Setup se trouve sur le desktop Project ; vous pouvez aussi l'ouvrir avec Ctrl+K et New Simulation Setup window. Pour chaque réseau, vous voyez les nœuds avec leur type (IL = couche d'interaction), leur source et l'état de la couche d'interaction.

   

2. Démarrez la mesure : les nœuds IL envoient leurs messages selon la base de données (Sending).

   

3. Stop IL et Start IL, à droite de la ligne, arrêtent ou relancent la couche d'interaction d'un nœud pendant que la mesure continue.

   

4. L'interrupteur de la colonne Active désactive complètement un nœud, par exemple pour laisser un vrai calculateur émettre à sa place. Pendant une mesure, ce réglage ne vaut que pour cette mesure ; lorsque la mesure est arrêtée, l'interrupteur modifie le projet.

   

Enregistrer, relire hors ligne et rejouer sur le bus

Les blocs de journalisation du Measurement Setup écrivent en BLF, ASC, MF4 ou PCAPNG. Un enregistrement peut être relu hors ligne à travers la même analyse qu'une mesure en direct, ou renvoyé sur le bus avec un bloc de rejeu (replay).

1. Dans l'explorateur de projet, cliquez sur le crayon à côté de Measurement Setup. L'éditeur affiche le graphe qui va de Measurement source aux filtres, déclencheurs, blocs de journalisation et fenêtres. Pour un bloc de journalisation, la partie droite affiche File (avec des codes de champ tels que {MeasurementIndex}, bouton {…}), Format, New file after [MB] et le Logging trigger. Add block ajoute un bloc ; Apply et Save to project conservent la modification.

   

2. Démarrez puis arrêtez la mesure. Chaque bloc de journalisation actif écrit son fichier dans le dossier du projet, ici logs/Demo vehicle_1.blf et, pour le bloc déclenché HighRpm, logs/high_rpm_001.asc. Pendant la mesure, la barre d'état affiche Logging avec le nombre d'événements. L'interrupteur à côté d'un bloc dans l'explorateur de projet active ou désactive la journalisation ; Start measurement without logging l'ignore pour une seule mesure.

   

3. Dans le Measurement Setup, cliquez sur le bloc Measurement source. À droite, choisissez le mode de travail : Real bus (le matériel des réseaux), Simulated bus (tous les réseaux simulés, temps virtuel) ou Offline (relecture de fichiers journaux). Les blocs de rejeu figurent en dessous.

   

4. Choisissez Offline, cliquez sur Add log file… et sélectionnez un ou plusieurs fichiers BLF, ASC, MF4 ou PCAPNG, ici l'enregistrement de l'étape 2.

   

5. Le fichier journal apparaît sous Log files ; la case à cocher désactive temporairement une source, la corbeille la retire. Sous Speed, choisissez As fast as possible, Real time (with factor) (2 = deux fois plus lent) ou Animate (un événement par intervalle). Avec plusieurs fichiers, Order détermine leur fusion ; Skip to the first event et Start paused se trouvent sous Start.

   

6. Cliquez sur Save to project (Apply applique la modification sans l'enregistrer). La barre d'outils affiche maintenant Offline et le bloc source offline · 1 file. Le même réglage est accessible via Ctrl+K avec Working mode: Offline (log files).

   

7. Cliquez sur Start (F9) : Arnodiqa relit le fichier journal à travers la même analyse qu'une mesure en direct (Trace, Graphics, Statistics). À la fin du fichier, la mesure s'arrête d'elle-même ; en Real time, cela dure aussi longtemps que l'enregistrement.

   

8. Pour renvoyer un enregistrement sur le bus pendant une mesure en ligne, choisissez Simulated bus ou Real bus et cliquez sur Add replay block… sous Replay blocks. Pour chaque bloc, choisissez le nom, Start at once, Original times ou Delayed, et Loop. Apply place le bloc dans le projet. Au démarrage suivant, le bloc envoie les trames du fichier. En mode hors ligne, les blocs de rejeu sont inactifs.

   

Diagnostic : console UDS et mémoire de défauts

Diagnostic Console et Fault Memory travaillent avec les calculateurs de diagnostic du projet, simulés ou réels.

1. Ouvrez la Diagnostic Console avec Ctrl+K et New Diagnostic Console window, puis démarrez la mesure. Sélectionnez le calculateur sous ECU (ici DoorECU). Choisissez un service et une sous-fonction sous Service et cliquez sur Send, ou saisissez une requête en hexadécimal sous Raw.

   

2. Saisissez par exemple 22 F1 90 (ReadDataByIdentifier, VIN) sous Raw et appuyez sur Entrée ou cliquez sur Send raw. L'historique affiche la requête, la réponse, le résultat et le temps de réponse ; cliquez sur une ligne pour voir les paramètres décodés. Une réponse négative affiche le NRC avec son nom.

   

3. Ouvrez Fault Memory (Ctrl+K, New Fault Memory window) et cliquez sur Read (service 19 02 avec le masque d'état choisi dans la liste, par défaut All status bits (FF)). Pour chaque DTC, vous voyez le code SAE, le code, l'état et les bits d'état en colonnes ; en bas, les huit bits du DTC sélectionné sont détaillés.

   

4. Clear all efface la mémoire de défauts (ClearDiagnosticInformation, 14 FF FF FF) ; confirmez avec Clear.

   

5. Après l'effacement, Read relit les DTC : leur état a été réinitialisé.

   

Flasher un calculateur (ECU)

La fenêtre Flash exécute le programme de flashage d'un calculateur, avec la progression par étape et par bloc.

1. Ouvrez la fenêtre Flash (Ctrl+K, New Flash window) et démarrez la mesure. Choisissez le calculateur, le fichier de firmware (par défaut celui du projet, ou via Browse…) et le format. La fenêtre affiche d'avance les blocs du fichier.

   

2. Cliquez sur Flash (Ctrl+Entrée). La barre de progression, l'étape en cours, le bloc, le débit et le temps restant se mettent à jour. Cancel interrompt l'opération ; les étapes de nettoyage (clean-up) s'exécutent quand même.

   

3. Le rapport final indique le résultat, la durée, le débit et les sommes de contrôle. Copy report copie le rapport ; en cas d'échec, il contient l'étape en échec et le NRC.

   

Ajouter et modifier des nœuds CAPL

Les programmes CAPL existants s'exécutent comme nœuds de simulation, à côté de la simulation de bus résiduel. Le CAPL Editor intégré vérifie le programme pendant la saisie.

1. Sur le desktop Project, les nœuds CAPL figurent sous Simulation nodes, avec leur fichier source (.can) et leurs réseaux. Dans le Simulation Setup, leur type est CAPL ; le crayon ouvre le programme dans le CAPL Editor, la corbeille retire le nœud du projet et Add CAPL node en ajoute un.

   

2. Le CAPL Editor affiche le programme avec coloration syntaxique et numéros de ligne. En haut à droite figurent les nœuds qui exécutent ce fichier (ici CaplGateway) ; No problems provient du même compilateur qu'au démarrage de la mesure et que arnodiqa capl check.

   

3. Survolez un nom avec la souris pour obtenir des détails : pour une fonction CAPL, toutes ses formes avec leurs paramètres ; pour un message, l'ID, la longueur, le temps de cycle et les signaux ; pour un signal, la mise à l'échelle, l'unité et la value table.

   

4. Arnodiqa vérifie le programme pendant la saisie : les erreurs sont soulignées d'une ligne ondulée rouge et signalées dans la marge, et le compteur de la barre d'outils indique le nombre d'erreurs et d'avertissements (cliquez dessus pour afficher la liste, ou Ctrl+Maj+M). Ici, totl est inconnu et il manque un point-virgule.

   

5. Ctrl+Espace, ou simplement la saisie, affiche des propositions : variables, fonctions et fonctions CAPL, messages et signaux des bases de données du projet et, après @, les variables système. Entrée ou Tab valide le choix.

   

6. Ctrl+S (ou Save) enregistre le fichier et recharge le nœud avec le nouveau programme. Pendant une mesure, Arnodiqa demande d'abord une confirmation ; la mesure en cours conserve l'ancien programme jusqu'au démarrage suivant.

   

7. Pour ajouter un nœud, cliquez sur Add CAPL node dans le Simulation Setup ou sur le + à côté de Simulation nodes dans l'explorateur de projet. Saisissez un nom, choisissez les réseaux et un modèle (Empty node, Cyclic sender, Echo / gateway) ; le fichier devient capl/<nom>.can. Existing file utilise un fichier .can existant, dans le dossier du projet ou en dehors (copié ou désigné par un chemin relatif).

   

8. Le nœud apparaît dans le Simulation Setup et son programme s'ouvre dans l'éditeur. Démarrez la mesure : les programmes CAPL s'exécutent et leur sortie write() s'affiche dans la fenêtre Write, onglet Program, précédée du nom du nœud. Enregistrez le projet pour conserver le nouveau nœud.

   

Exécuter des unités de test dans le Test Runner

Le Test Runner exécute les unités de test du projet sur le bus simulé et affiche le rapport dans l'application. Le résultat est identique à celui de arnodiqa test.

1. Ouvrez le Test Runner avec Ctrl+K et New Test Runner window. À gauche figurent les unités de test du projet (les fichiers *.vtestunit.yaml sous tests/) avec leurs cas de test ; un arbre de test (*.vtesttree.yaml) apparaît avec ses groupes. La case à cocher détermine les unités exécutées.

   

2. Cliquez sur une unité pour afficher ses détails : titre et description, fichier et sources CAPL (un clic les ouvre dans le CAPL Editor). Les touches fléchées parcourent l'arbre, Espace coche ou décoche, et Entrée ou Run this unit exécute l'unité sélectionnée.

   

3. Cliquez sur Run (Ctrl+Entrée). Chaque unité s'exécute dans sa propre mesure sur le bus simulé ; le cas de test en cours affiche Running et les verdicts apparaissent dès qu'un cas de test se termine. Cancel interrompt l'exécution : l'unité en cours s'arrête et les suivantes sont ignorées.

   

4. Après l'exécution, chaque cas de test porte son verdict (Pass, Fail, Inconclusive, Error) et sa durée en temps de mesure. En bas figurent le résumé et le code de sortie que arnodiqa test renvoie pour le même résultat, ici 1 : au moins un cas de test a échoué.

   

5. Cliquez sur Report pour afficher le rapport HTML dans l'application, avec les informations de chaque unité et les étapes de chaque cas de test ; les cas de test en échec sont dépliés. Save HTML… enregistre le rapport.

   

6. Export enregistre le rapport en HTML, en JUnit XML pour un serveur CI ou au format JSON canonique.

   

LIN : schedule tables, esclaves et LIN dans la Trace

Un réseau LIN est défini par un fichier LDF ; Arnodiqa simule le maître et les esclaves et affiche les trames LIN et les événements de bus dans la Trace.

1. Projet Body LIN créé à partir du modèle LIN cluster. L'explorateur de projet affiche le réseau LIN avec son débit, son maître, ses esclaves et ses schedule tables ; le Simulation Setup affiche les nœuds LIN avec leur rôle (maître ou esclave).

   

2. Démarrez la mesure et choisissez une autre schedule table pour le réseau LIN dans le Simulation Setup. Le changement a lieu à la fin de la table en cours ; la ligne affiche running: ….

   

3. Chaque esclave du LDF est un nœud simulé. Désactivez un esclave avec l'interrupteur de la colonne Active (ici RLS) pour laisser un vrai calculateur répondre à sa place. Pendant une mesure, ce réglage ne vaut que pour cette mesure ; Write affiche alors Node 'RLS' deactivated for this measurement.

   

4. La Trace affiche les trames LIN sur le canal LIN1. Columns permet d'afficher les colonnes PID et Checksum. Filtres : bus:lin, type:lin, type:linerror (erreurs) et type:linbus (réveil, mise en veille, changement de schedule table).

   

5. En mode Chronological, le filtre type:linbus affiche les événements de bus : ici les changements de schedule table, ainsi que le réveil et la mise en veille. type:linerror affiche les lignes d'erreur telles que No response ou Checksum error.

   

6. Dans l'Interactive Generator du desktop Stimulation, sélectionnez une trame du LDF dans la section LIN. Set response publie la réponse en tant qu'esclave, Send header envoie l'en-tête en tant que maître.

   

J1939 Monitor et DTC

Le J1939 Monitor affiche les nœuds d'un réseau J1939, leurs codes de défaut actifs et la séquence des revendications d'adresse (address claims) et des transferts.

1. Ouvrez le J1939 Monitor (Ctrl+K, New J1939 Monitor window) et démarrez la mesure. L'onglet Nodes affiche pour chaque adresse le NAME avec ses champs, l'instant de l'address claim et un résumé DM1.

   

2. L'onglet DTC monitor affiche les témoins (MIL, RSL, AWL, PL) de chaque nœud et les DTC actifs issus de DM1 : SPN, FMI avec son texte et l'occurrence count.

   

3. L'onglet Events affiche les address claims, les requêtes et réponses, ACK/NACK et les messages du protocole de transport. Request demande un PGN à une destination (hexadécimal) ; Clear active (DM11) et Clear previous (DM3) effacent les DTC.

   

Éditeur de bases de données : ajouter un signal

Le Database Editor modifie les fichiers DBC et LDF du projet, avec annulation et rétablissement, et contrôle pendant l'édition.

1. Dans l'explorateur de projet, cliquez sur le crayon à côté de la base de données (ici powertrain.dbc). Le Database Editor affiche l'arborescence à gauche (nœuds, messages, signaux, value tables), le tableau au centre et les propriétés à droite.

   

2. Cliquez sur un message dans l'arborescence (ici ABS_Status) : le centre affiche la disposition des bits, chaque signal sous forme de barre colorée, et en dessous les signaux dans un tableau.

   

3. Cliquez sur + Signal au-dessus de la disposition des bits : le nouveau signal (1 bit) est placé à la première position libre, ici le bit 27. Nommez-le à droite sous Signal (ici BrakeLampOn) et réglez au besoin la longueur, l'ordre des octets, le facteur, l'unité et les récepteurs. Faites glisser la barre pour déplacer le signal, ou une extrémité pour modifier sa longueur ; les chevauchements sont marqués en rouge.

   

4. Après l'enregistrement, Arnodiqa affiche Database saved et recharge le projet avec la nouvelle base de données ; la Trace décode aussitôt le nouveau signal. Ctrl+Z et Ctrl+Y (ou les flèches en haut à gauche) annulent ou rétablissent les modifications.

   

Autotest du matériel

L'autotest vérifie une interface et son pilote avec une paire de canaux, ou avec un seul canal en bouclage interne.

1. Ouvrez la fenêtre Hardware (Ctrl+K, New Hardware window ou via l'explorateur de projet) et cliquez sur Self-test…. L'icône à côté d'un canal lance le test pour ce seul canal.

   

2. Choisissez la configuration : Channel pair (deux canaux reliés par un câble) ou One channel, les canaux A et B, le débit, CAN FD et les contrôles. Sans matériel, Try on virtual channels exécute le test sur un bus virtuel.

   

3. Cliquez sur Start self-test (Ctrl+Entrée). Chaque contrôle affiche son état et sa durée.

   

4. Le résumé suit, avec les canaux (appareil, numéro de série, firmware, pilote). Dépliez un contrôle pour voir les valeurs mesurées et, en cas d'échec, la cause probable. Save HTML report enregistre le rapport.

   

Archive de support et dossier des journaux

Les journaux et les rapports de plantage restent sur l'ordinateur. Vous créez vous-même une archive de support et la transmettez par votre propre canal à support@arnodiqa.com.

1. Cliquez sur le point d'interrogation (Help) en haut à droite. Le menu contient Open log folder, Create support bundle…, Debug logging until restart et About Arnodiqa. Les mêmes actions figurent dans Ctrl+K sous Help.

   

2. Create support bundle… indique d'avance les fichiers placés dans l'archive zip et ce qui est délibérément omis. Choisissez la période couverte par les journaux et indiquez si le projet, le nom de l'ordinateur ou les numéros de série peuvent être inclus. Cliquez sur Save… et choisissez l'emplacement du fichier zip ; rien n'est envoyé.

   

3. Open log folder ouvre dans l'Explorateur le dossier des fichiers journaux d'Arnodiqa ; une notification indique le chemin.

   

FAQ