Format de données CSV

Vue d'ensemble

VBatPower utilise un format CSV universel à 6 colonnes conçu pour être assez simple à générer par des microcontrôleurs 8 bits. Chaque ligne représente un seul échantillon de mesure.

id,type,value,unit,nonce,runid

Définitions des colonnes

id

Identifiant hiérarchique en notation pointée correspondant à la structure de votre projet.

  • Profondeur 1 (p. ex. 0 ) — niveau batterie
  • Profondeur 2 (p. ex. 0.1 ) — niveau composant
  • Profondeur 3 (p. ex. 0.1.2 ) — niveau état

type

Caractère unique indiquant le type de mesure :

  • t — minutage de télémétrie (durée d'exécution en unités de temps)
  • v — mesure de valeur (tension, courant, résistance, etc.)
  • n — mesure de temps écoulé (temps depuis le démarrage du MCU, utilisé pour aligner les données sur l'axe temporel). Distincte de la colonne nonce ci-dessous, qui est le compteur de regroupement.

value

Valeur numérique de la mesure. Prend en charge les entiers et les décimaux avec . comme séparateur décimal.

unit

Unité de la mesure. Valeurs courantes : ms, V, mV, mA, A, °C.

nonce

Compteur de séquence croissant de façon monotone. Chaque groupe de mesures à un instant donné partage le même nonce. Le nonce ne se réinitialise jamais au cours d'une exécution et sert à aligner les points de données sur l'axe temporel.

runid

Identifiant numérique d'une exécution de test. Plusieurs exécutions peuvent être stockées dans le même CSV. L'ID d'exécution sert à séparer les expériences indépendantes. Les numéros inférieurs ont été exécutés en premier.

Exemple complet

Un nœud capteur avec une batterie, un composant MCU et deux états (veille + actif) :

id,type,value,unit,nonce,runid
0,v,3.28,V,1,1
0.0.0,t,500,ms,1,1
0.0.0,v,0.01,mA,1,1
0.0.0,n,0,ms,1,1
0.0.1,t,0,ms,1,1
0.0.1,v,0,mA,1,1
0,v,3.27,V,2,1
0.0.0,t,500,ms,2,1
0.0.0,v,0.01,mA,2,1
0.0.0,n,1000,ms,2,1
0.0.1,t,200,ms,2,1
0.0.1,v,80,mA,2,1
0.0.1,n,1000,ms,2,1

Dans cet exemple :

  • Batterie 0 ( 0,v ) la tension chute de 3.28V à 3.27V
  • État 0.0.0 (veille) : t = 500ms d'exécution, v = 0.01mA de courant, n = temps écoulé depuis le démarrage
  • État 0.0.1 (actif) : t = 200ms d'exécution au nonce 2, v = 80mA de courant consommé
  • Toutes les mesures sont dans l'exécution 1

Choix de conception

  • Pas d'horodatage — les systèmes embarqués manquent souvent de RTC. L'approche nonce + temps écoulé permet aux MCU 8 bits d'émettre des données avec un simple compteur et millis().
  • runid numérique — une simple comparaison d'entiers vous indique quelle exécution est venue en premier.
  • CSV plat — pas de JSON, pas de protocole binaire. Facile à générer avec printf sur n'importe quel MCU.
  • ID en notation pointée — correspond directement à la hiérarchie batterie/composant/état de votre projet, sans tables de correspondance supplémentaires.

Importation

Dans la page Données, cliquez sur Importer un CSV et sélectionnez votre fichier. L'analyseur valide toutes les lignes et affiche un aperçu avant l'importation. Les lignes invalides sont ignorées avec des avertissements.

Vous pouvez également téléverser des données par programmation via l' API REST.