PRM3 SCPI Control

Introduction au SCPI

SCPI (prononcé « skippy ») signifie « Standard Commands for Programmable Instruments » et utilise des chaînes de caractères encodées en ASCII. Les commandes sont saisies ligne par ligne. Chaque ligne doit se terminer par un retour chariot (code ASCII 13) et/ou un saut de ligne (code ASCII 10). La longueur des lignes (sauts de ligne inclus) est limitée à 64 caractères. Les commandes ne sont pas sensibles à la casse ; ainsi, RELAY et relay ont la même signification.

La plupart des commandes SCPI peuvent être abrégées à leurs quatre premiers caractères. Les caractères obligatoires sont en majuscules, les facultatifs en minuscules. Par exemple, MODBus indique que la commande peut être abrégée en MODB .

Chaque commande SCPI renvoie une seule ligne de réponse, terminée par un retour chariot suivi d'un saut de ligne. La réponse est INVALID COMMAND en cas d'erreur lors du traitement de la commande. Si la commande a été traitée avec succès, la réponse est OK ou une réponse spécifique à la commande.

Information

Alors que la convention SCPI permettrait normalement de spécifier plusieurs commandes sur une seule ligne en les séparant par un point-virgule, le module de relais de puissance ne prend pas en charge cette convention et attend toujours une seule commande par ligne.

Connexion et alimentation

L'unité eGauge PRM3 communique via SCPI et est alimentée par la connexion USB-A. Cette connexion USB fournit un port série virtuel CDC ACM permettant à l'hôte de communiquer avec elle via une interface série.

Paramètres série

L'interface SCPI utilise les paramètres série suivants :

  • 19200 baud
  • 1 bit de démarrage
  • 8 bits de données, bit de poids faible en premier
  • pas de parité
  • 1 butée

Commandes SCPI

Les commandes SCPI prises en charge par le module relais de puissance sont présentées ci-dessous. La première colonne indique la syntaxe de la commande, la deuxième le type de réponse et la troisième une description de la commande.

Pour le type de réponse devid, la valeur de retour consiste en une chaîne de caractères contenant le nom du fabricant, le nom du modèle, le numéro de série du produit et la version du produit, séparés par des virgules. Par exemple, le devid renvoyé pourrait être : eGauge,PRM3,3N013453,1.00 .

Pour une réponse de type statut, la valeur de retour est soit OK , soit INVALID COMMAND . Pour une réponse de type décimal, la valeur de retour est soit INVALID COMMAND , soit une chaîne de caractères représentant un nombre décimal. Pour une réponse de type parité, la valeur de retour est soit INVALID COMMAND , soit un caractère unique : n indique une absence de parité, e une parité paire et o une parité impaire.

  • Lors de la commande de charges polyphasées, les commandes de masque doivent être utilisées pour l'ouverture et la fermeture simultanées des entrées de relais multiples.

Commande Réponse Description
*IDN? devid Identifiant du dispositif de retour
EPRom? décimal Retourne le nombre de fois où l'EPROM a été écrite.
RELAy: n ? décimal Interroge l'état du relais n , où n est l'un des 1, 2 ou 3. Renvoie la chaîne 0 si le relais est ouvert, 1 s'il est fermé.
RELAy: n cv statut Ouvrir ou fermer le relais n , où n est l'un des 1, 2 ou 3. Si cv est 0 ou OFF , le relais est ouvert, si 1 ou ON , le relais est fermé.
RELAy: n :COUNt? décimal Renvoie le nombre de commutations (ouverture ou fermeture) du relais n . La valeur de n doit être 1, 2 ou 3.
REALy:MASK? décimal Interroge l'état de tous les relais. Le nombre renvoyé indique que le bit ( n -1) est activé si le relais n est fermé, et désactivé sinon. Par exemple, la valeur de retour 6 indique que le relais 1 est ouvert (bit 0 désactivé) et que les relais 2 et 3 sont fermés (bits 1 et 2 activés).
RELAy:MASK m statut Ouvrez ou fermez les relais comme indiqué par le masque m. Si le bit ( n -1 ) est défini, le relais n est fermé, sinon il sera ouvert.
RELAy:MASK:SET m statut Fermez les relais comme indiqué par le masque m . Si le bit ( n -1 ) est défini, le relais n est fermé, sinon le relais n restera dans son état actuel.
RELAy:MASK:CLR m statut Ouvrez les relais comme indiqué par le masque m . Si le bit ( n -1 ) est défini, le relais n est ouvert, sinon le relais n restera dans son état actuel.
RELAy:MIN:OFF? décimal Demandez la durée minimale pendant laquelle un relais reste ouvert. La valeur renvoyée correspond à la durée en secondes.
RELAy:MIN:OFF? d statut Définissez la durée minimale d'ouverture d'un relais à d secondes. Cette durée doit être un entier compris entre 0 et 255.
RELAy:MIN:ON? décimal Demandez la durée minimale pendant laquelle un relais reste fermé. Le nombre renvoyé correspond à la durée en secondes.
RELAy:MIN:ON? d statut Définissez la durée minimale d'ouverture d'un relais à d secondes. Cette durée doit être un entier compris entre 0 et 255.
MODBus:BAUD? décimal Renvoie le débit en bauds du port RS-485.
MODBus:BAUD n statut Définit le débit de transmission RS-485 à n bauds. La valeur de n peut être l'une des suivantes : 9 600, 19 200, 38 400, 57 600 ou 115 200.
MODBus:PARIty? décimal Renvoie la parité utilisée pour le port RS-485.
MODBus:PARIty p statut Définit la parité RS-485. Si p = n , aucune parité n'est sélectionnée ; si e , la parité paire est sélectionnée ; et si o , la parité impaire est sélectionnée.
MODBus:UNIT? décimal Renvoie le numéro d'unité MODBUS du périphérique.
MODBus:UNIT n statut Définit le numéro d'unité MODBUS du périphérique sur n . La valeur de n peut être comprise entre 1 et 247.

Accéder au PRM3 depuis un PC Windows

  • eGauge Systems ne teste ni ne garantit la sécurité ou l'exactitude des logiciels tiers.

Repérez le port COM du PRM3

  1. Ouvrez le Gestionnaire de périphériques, ce qui peut se faire en ouvrant le menu Démarrer, en tapant « Gestionnaire de périphériques » et en cliquant sur « Ouvrir » :

2. Développez la section « Ports (COM et LPT) » :

Si vous avez plusieurs entrées « Périphérique série USB », vous pouvez débrancher l’eGauge PRM3, puis le rebrancher pour voir quel port COM apparaît lorsqu’il est connecté.

Connectez-vous au port COM à l'aide de PuTTY.

  1. Installez et ouvrez l'émulateur de terminal PuTTY .
  2. Modifiez « Ligne série » pour correspondre au port COM indiqué dans le gestionnaire de périphériques, la « Vitesse » à 19200 et le « Type de connexion » à « Série », puis appuyez sur Ouvrir :

3. Vous pouvez maintenant saisir des commandes SCPI suivies de la touche « Entrée ».

Information

  • La touche Retour arrière peut ne pas fonctionner correctement et entraîner une erreur de commande invalide. Les commandes saisies par copier-coller peuvent également ne pas fonctionner correctement et entraîner une erreur de commande invalide.