Comment journaliser les données des instruments de laboratoire vers une base de données MySQL

Un guide complet pour interroger les instruments de laboratoire avec connecteur RS232 et exporter les données extraites directement dans une base de données MySQL.

1. Configuration du protocole : Instruments de laboratoire

Type de communication : Écoute passive / Bidirectionnelle (RS232 ou USB Virtual COM)

Les spectrophotomètres, titrateurs et analyseurs de sang utilisent souvent des formats ASCII propriétaires ou les protocoles ASTM E1381/E1394. Si l’instrument produit de l’ASCII brut, utilisez l’« ASCII Data Parser ». S’il utilise ASTM, vous devez utiliser le plugin dédié « ASTM Data Parser » pour dépaqueter correctement les enregistrements d’en-tête (H), de patient (P), de commande (O) et de résultat (R).

Appliquez cette configuration de base pour la connexion série :

{
  "port": "COM4",
  "baud_rate": 9600,
  "data_bits": 8,
  "stop_bits": 1,
  "parity": "none",
  "parser_type": "astm_e1381",
  "ack_nak_handshake": true
}

2. Configuration de la base de données : MySQL

Vous aurez besoin de MySQL Connector/ODBC installé sur la machine exécutant le Data Logger. Créez un DSN système pointant vers votre instance de serveur MySQL.

Utilisez le script SQL suivant pour créer votre table cible. Nous recommandons d'utiliser le moteur InnoDB pour gérer les insertions simultanées à haute fréquence sans verrouillage de table.

CREATE TABLE sensor_data (
  id INT AUTO_INCREMENT PRIMARY KEY,
  log_timestamp DATETIME DEFAULT CURRENT_TIMESTAMP,
  device_id VARCHAR(50),
  register_value FLOAT
) ENGINE=InnoDB;

3. Dépannage spécifique au protocole

• L’instrument n’envoie aucune donnée: Certains instruments n’envoient des données que lorsque vous appuyez sur le bouton « Print » ou nécessitent une commande spéciale de l’ordinateur hôte.
• L’instrument envoie un enregistrement puis cesse de transmettre: De nombreux instruments de laboratoire nécessitent un caractère ACK (accusé de réception) après réception d’un bloc de données. Activez la fonction « ACK/NAK handshake » dans l’enregistreur de données pour qu’il réponde et invite l’instrument à envoyer le bloc suivant.
• Le programme n’extrait pas toutes les données. Certains champs sont manquants: Par défaut, l’enregistreur extrait uniquement les données significatives. Vous pouvez créer votre propre analyseur en utilisant le plugin ASCII Data Parser ou contacter notre équipe d’assistance.

4. Dépannage spécifique à la base de données

• Le serveur MySQL a disparu: Si votre périphérique série est inactif pendant la nuit, MySQL fermera la connexion. Activez le paramètre « Maintenir la connexion active » dans le module d'exportation ODBC du Data Logger.
• Comment puis-je insérer ou mettre à jour une ligne de données pour mon appareil ?: Vous pouvez utiliser n'importe quelle requête SQL dans notre plugin « SQL Database Pro ». Dans MySQL, vous pouvez facilement exécuter le SQL suivant : « INSERT INTO ....... ON DUPLICATE KEY .... UPDATE .... ».
• Je souhaite écrire les données de chacun de mes appareils dans une table différente. Comment puis-je le faire ?: Dans le plugin « SQL Database Pro », vous pouvez utiliser un espace réservé dans votre SQL. Par exemple, « INSERT INTO SerialData%DEVICE_ID% (....) ». Avant d'exécuter le SQL, le logger remplace %DEVICE_ID% par la valeur correspondante des données analysées, et la table de destination réelle variera (SerialData1, SerialData2, etc.).