This documentation is no longer maintained. For documentation of the current version of emc2, please see http://www.linuxcnc.org/docview/html

Table des matières

1. Configuration, fichier ini
1.1. Fichiers utilisés pour la configuration
1.2. Organisation du fichier INI
1.2.1. Commentaires
1.2.2. Sections
1.2.3. Variables
1.3. Définition des variables du fichier INI
1.3.1. Section [EMC]
1.3.2. Section [DISPLAY]
1.3.3. Section [EMCMOT]
1.3.4. Section [TASK]
1.3.5. Section [HAL]
1.3.6. Section [TRAJ]
1.3.7. Section [AXIS_<num>]
1.3.8. Section [EMCIO]

Liste des tableaux

1 Configuration, fichier ini

1.1 Fichiers utilisés pour la configuration

EMC est entièrement configuré avec des fichiers textes classiques. Tous ces fichiers peuvent être lus et modifiés dans n'importe quel éditeur de texte disponible dans toute distribution Linux¹ . Soyez prudent lorsque vous modifierez ces fichiers, certaines erreurs pourraient empêcher le démarrage d'EMC. Ces fichiers sont lus à chaque fois que le logiciel démarre. Certains d'entre eux sont lus de nombreuses fois pendant l'exécution d'CNC.

Les fichiers de configuration inclus:

INI: Le fichier ini écrase les valeurs par défaut compilées dans le code d'EMC. Il contient également des sections qui sont lues directement par le HAL (Hardware Abstraction Layer, couche d'abstraction matérielle).
HAL: Les fichiers hal installent les modules de process, ils créent les liens entre les signaux d'EMC et les broches spécifiques du matériel.
VAR: Ce fichier contient une suite de numéros de variables. Ces variables contiennent les paramètres qui seront utilisés par l'interpréteur. Ces valeurs sont enregistrées d'une exécution à l'autre.
TBL: Ce fichier contient les informations relatives aux outils.
NML: Ce fichier configure les canaux de communication utilisés par EMC. Il est normalement réglé pour lancer toutes les communications avec un seul ordinateur, peut être modifié pour communiquer entre plusieurs ordinateurs.
.emcrc: Ce fichier enregistre des informations spécifiques à l'utilisateur, il a été créé pour enregistrer le nom du répertoire lorsque l'utilisateur choisit sa première configuration d'EMC.²

Les éléments avec le repère (hal) sont utilisés seulement pour les fichiers de HAL en exemples. C'est une bonne convention. D'autres éléments sont utilisés directement par EMC et doivent toujours avoir la section et le nom donné à l'item.

1.2 Organisation du fichier INI

Un fichier INI typique suit une organisation simple;

commentaires.
sections,
variables.

Chacun de ces éléments est séparé, sur une seule ligne. Chaque fin de ligne ou retour chariot crée un nouvel élément.

1.2.1 Commentaires

Une ligne de commentaires débute avec un ; ou un #. Si le logiciel qui analyse le fichier ini rencontre l'un ou l'autre de ces caractères, le reste de la ligne est ignorée. Les commentaires peuvent être utilisés pour décrire ce que font les éléments du fichier INI.

; Ceci est le fichier de configuration de ma petite fraiseuse.
; Je l'ai ajusté le 12 janvier 2006

Des commentaires peuvent également être utilisés pour choisir entre plusieurs valeurs d'une seule variable.

# DISPLAY = tkemc
DISPLAY = axis
# DISPLAY = mini
# DISPLAY = keystick

Dans cette liste, la variable DISPLAY est positionnée sur axis puisque toutes les autres sont commentées. Si quelqu'un édite une liste comme celle-ci et par erreur, décommente deux lignes, c'est la première rencontrée qui sera utilisée.

Notez que dans une ligne de variables, les caractères ``#” et `` ;” n'indiquent pas un commentaire.

INCORRECT = value     # and a comment

1.2.2 Sections

Les différentes parties d'un fichier .ini sont regroupées dans des sections. Une section commence par son nom en majuscules entre crochets [UNE_SECTION]. L'ordre des sections est sans importance. Les sections suivantes sont utilisées par emc:

[EMC] informations générales ([.])
[DISPLAY] sélection du type d'interface graphique ([.])
[RS274NGC] ajustements utilisés par l'interpréteur de g-code
[EMCMOT] Réglages utilisés par le contrôleur de mouvements temps réel ([.])
[HAL] spécifications des fichiers .hal ([.])
[TASK] Réglages utilisés par le contrôleur de tâche ([.])
[TRAJ] Réglages additionnels utilisés par le contrôleur de mouvements temps réel ([.])
[AXIS_0] ... [AXIS_n] Groupes de variables pour AXIS ([.])
[EMCIO] Réglages utilisés par le contrôleur d'entrées/sorties ([.])

1.2.3 Variables

Une ligne de variables est composée d'un nom de variable, du signe égal (=) et d'une valeur. Tout, du premier caractère non blanc qui suit le signe = jusqu'à la fin de la ligne, est passé comme valeur à la variable. Vous pouvez donc intercaler des espaces entre les symboles si besoin. Un nom de variable est souvent appelé un mot clé.

Les paragraphes suivants détaillent chaque section du fichier de configuration, en utilisant des exemples de variables dans les lignes de configuration.

Certaines de ces variables sont utilisées par EMC. Elles doivent toujours utiliser le nom de section et le nom de variable dans leur appellation. D'autres variables ne sont utilisées que par HAL. Les noms des sections et les noms des variables indiquées sont celles qui sont utilisées dans les exemples de fichiers de configuration.

1.3 Définition des variables du fichier INI

1.3.1 Section [EMC]

VERSION = $Revision: 1.3 $: Le numéro de version du fichier INI. La valeur indiquée ici semble étrange, car elle est automatiquement mise à jour lors de l'utilisation du système de contrôle de révision. C'est une bonne idée de changer ce numéro à chaque fois que vous modifiez votre fichier. Si vous voulez le modifier manuellement, il suffit de changer le numéro sans toucher au reste.
MACHINE = ma machine: C'est le nom du contrôleur, qui est imprimé dans le haut de la plupart des fenêtres. Vous pouvez insérer ce que vous voulez ici tant que ça reste sur une seule ligne.
RS274NGC_STARTUP_CODE = G21 G90: Une chaine de codes NC qui sera utilisée pour initialiser l'interpréteur. Elle ne se substitue pas à la spécification des gcodes modaux du début de chaque fichier ngc. Les codes modaux des machines diffèrent, ils pourraient être modifiés par les gcodes interprétés plus tôt dans la session.

1.3.2 Section [DISPLAY]

Les différentes interfaces du programme utilisent différentes options. Toutes les options ne sont pas supportées par toutes les interfaces.

DISPLAY = tkemc Le nom de l'interface utilisateur à utiliser. Les options disponibles sont les suivantes:

axis
keystick
mini
tkemc
xemc

POSITION_OFFSET = RELATIVE: Le système de coordonnées (RELATIVE ou MACHINE) à utiliser au démarrage de l'interface utilisateur. Le système de coordonnées RELATIVE reflète le G92 et le décalage d'origine G5x actuellement actifs.
POSITION_FEEDBACK = ACTUAL: Valeur de la position (COMMANDED ou ACTUAL) à afficher au démarrage de l'interface utilisateur. La position COMMANDED est la position exacte requise par emc. La position ACTUAL est la position retournée par l'électronique des moteurs.
MAX_FEED_OVERRIDE = 1.2: La correction de vitesse maximum que l'opérateur peut utiliser. 1.2 signifie 120% de la vitesse programmée.
MIN_SPINDLE_OVERRIDE = 0.5: Correction de vitesse minimum de broche que l'opérateur pourra utiliser. 0.5 signifie 50% de la vitesse de broche programmée. (utile si il est dangereux de démarrer un programme avec une vitesse de broche trop basse).
MAX_SPINDLE_OVERRIDE = 1.0: Correction de vitesse maximum de broche que l'opérateur pourra utiliser. 1.0 signifie 100% de la vitesse de broche programmée.
DEFAULT_LINEAR_VELOCITY = .25: Vitesse minimum par défaut pour les jogs linéaires, en unités machine par seconde. Seulement utilisé dans l'interface AXIS.
MAX_LINEAR_VELOCITY = 1.0: Vitesse maximum par défaut pour les jogs linéaires, en unités machine par seconde. Seulement utilisé dans l'interface AXIS.
DEFAULT_ANGULAR_VELOCITY = .25: Vitesse minimum par défaut pour les jogs angulaires, en unités machine par seconde. Seulement utilisé dans l'interface AXIS.
MAX_ANGULAR_VELOCITY = 1.0: Vitesse maximum par défaut pour les jogs angulaires, en unités machine par seconde. Seulement utilisé dans l'interface AXIS.
PROGRAM_PREFIX = ~/emc2/nc_files: Répertoire par défaut des fichiers de g-codes et emplacement des M-codes définis par l'utilisateur.
INCREMENTS = 1 mm, .5 mm, …: Définit les incréments disponibles pour le jog incremental. Voir la section [.] pour plus d'informations. Seulement utilisé dans l'interface AXIS.
INTRO_GRAPHIC = emc2.gif: L'image affichée sur l'écran d'accueil.
INTRO_TIME = 5: Durée d'affichage de l'écran d'accueil.
OPEN_FILE = /full/path/to/file.ngc: Le fichier NC à utiliser au démarrage d'AXIS.

1.3.3 Section [EMCMOT]

BASE_PERIOD = 50000: (hal) “Période de base” des tâches, exprimée en nanosecondes. C'est la plus rapide des horloges de la machine.
Avec un système à servomoteurs, il n'y a généralement pas de raison pour que BASE_PERIOD soit plus petite que SERVO_PERIOD.
Sur une machine de type “step&direction” avec génération logicielle des impulsions de pas, c'est BASE_PERIOD qui détermine le nombre maximum de pas par seconde. Si de longues impulsions de pas ou de longs espaces entre les impulsions ne sont pas requis par l'électronique, la fréquence maximum absolue est de un pas par BASE_PERIOD. Ainsi, la BASE_PERIOD utilisée ici donnera une fréquence de pas maximum absolue de 20000 pas par seconde. 50000ns est une valeur assez large. La plus petite valeur utilisable est liée au résultat du test de latence ([->]), à la longueur des impulsions de pas nécessaire et à la vitesse du µP.
Choisir une BASE_PERIOD trop basse peut amener à des messages “Unexpected realtime delay”, des bloquages ou des reboots spontanés.
SERVO_PERIOD = 1000000: (hal) Période de la tâche “Servo”, exprimée également en nanosecondes. Cette valeur sera arrondie à un multiple entier de BASE_PERIOD. Elle est utilisée aussi sur des systèmes basés sur des moteurs pas à pas
C'est la vitesse avec laquelle la nouvelle position des moteurs est traitée, les erreurs de suivi vérifiées, les valeurs des sorties PID sont rafraichies etc.
Sur la plupart des systèmes cette valeur n'est pas à modifier. Il s'agit du taux de mise à jour du planificateur de mouvement de bas niveau.
TRAJ_PERIOD = 1000000: (hal) Période du planificateur de trajectoire, exprimée en nanosecondes. Cette valeur sera arrondie à un multiple entier de SERVO_PERIOD.
Excepté pour les machines avec une cinématique particulière (ex: hexapodes) Il n'y a aucune raison de rendre cette valeur supérieure à SERVO_PERIOD.

1.3.4 Section [TASK]

CYCLE_TIME = 0.001: Période exprimée en secondes, à laquelle EMCTASK va tourner. Ce paramètre affecte l'intervalle de polling lors de l'attente de la fin d'un mouvement, lors de l'exécution d'une pause d'instruction et quand une commande provenant d'une interface utilisateur est acceptée. Il n'est généralement pas nécessaire de modifier cette valeur.

1.3.5 Section [HAL]

HALFILE = example.hal: Exécute le fichier 'example.hal' au démarrage. Si HALFILE est spécifié plusieurs fois, les fichiers sont exécutés dans l'ordre de leur apparition dans le fichier ini. Presque toutes les configurations auront au moins un HALFILE. Les systèmes à moteurs pas à pas ont généralement deux de ces fichiers, un qui spécifie la configuration générale des moteurs (core_stepper.hal) et un qui spécifie le brochage des sorties (xxx_pinout.hal)
HAL = command: Exécute 'command' comme étant une simple commande hal. Si HAL est spécifié plusieurs fois, les commandes sont exécutées dans l'ordre où elles apparaissent dans le fichier ini. Les lignes HAL sont exécutées après toutes les lignes HALFILE.
SHUTDOWN = shutdown.hal: Exécute le fichier 'shutdown.hal' quand emc s'arrête. Selon les pilotes de matériel utilisés, il est ainsi possible de positionner les sorties sur des valeurs définies quand emc s'arrête normalement. Cependant, parce qu'il n'y a aucune garantie que ce fichier sera exécuté (par exemple, dans le cas d'une panne de l'ordinateur), il ne remplace pas une véritable chaîne physique d'arrêt d'urgence ou d'autres logiciels de protection des défauts de fonctionnement.
POSTGUI_HALFILE = example2.hal: (Seulement avec l'interface AXIS) Exécute 'example2.hal' après que l'interface graphique ait créé ses HAL pins.

1.3.6 Section [TRAJ]

La section [TRAJ] contient les paramètres généraux du module planificateur de trajectoires d' EMCMOT. Vous n'aurez pas à modifier ces valeurs si vous utilisez EMC avec une machine à trois axes en provenance des USA. Si vous êtes dans une zone métrique, utilisant des éléments matériels métriques, vous pourrez utiliser le fichier stepper_mm.ini dans lequel les valeurs sont déjà configurées dans cette unité.

COORDINATES = X Y Z: Les noms des axes à contrôler. X, Y, Z, A, B, C, U, V, et W sont valides. Seuls les axes nommés dans COORDINATES seront acceptés dans le g-code. Cela n'a aucun effet sur l'ordonnancement des noms d'axes depuis le G-code (X- Y- Z-) jusqu'aux numéros d'articulations. Pour une “cinématique triviale”, X est toujours l'articulation 0, A est toujours l'articulation 4, U est toujours l'articulation 7 et ainsi de suite. Il est permis d'écrire les noms d'axe par paire (ex: X Y Y Z pour une machine à portique) mais cela n'a aucun effet.
AXES = 3: Une unité de plus que le plus grand numéro d'articulation du système. Pour une machine XYZ, les articulations sont numérotées 0, 1 et 2. Dans ce cas, les AXES sont 3. Pour un système XYUV utilisant une “cinématique triviale”, l'articulation V est numérotée 7 et donc les AXES devraient être 8. Pour une machine à cinématique non triviale (ex: scarakins) ce sera généralement le nombre d'articulations contrôlées.
HOME = 0 0 0: Coordonnées de l'origine machine de chaque axe. De nouveau, pour une machine 4 axes, vous devrez avoir 0 0 0 0. Cette valeur est utilisée uniquement pour les machines à cinématique non triviale. Sur les machines avec cinématique triviale, cette valeur est ignorée.
LINEAR_UNITS=<units>: Le nom des unités utilisées dans le fichier INI. Les choix possibles sont 'in', 'inch', 'imperial', 'metric', 'mm'.
Cela n'affecte pas les unités linéaires du code NC (pour cela il y a les mots G20 et G21).
ANGULAR_UNITS=<units>: Le nom des unités utilisées dans le fichier INI. Les choix possibles sont 'deg', 'degree' (360 pour un cercle), 'rad', 'radian' (2pi pour un cercle), 'grad', ou 'gon' (400 pour un cercle).
Cela n'affecte pas les unités angulaires du code NC. Dans le code RS274NGC, les mots A-, B- et C- sont toujours exprimés en degrés.
DEFAULT_VELOCITY = 0.0167: La vitesse initiale de jog des axes linéaires, en unités par seconde. La valeur indiquée ici correspond à une unité par minute.
DEFAULT_ACCELERATION = 2.0: Dans les machines à cinématique non triviale, l'accélération utilisée pour “teleop” jog (espace cartésien), en unités machine par seconde par seconde.
MAX_VELOCITY = 5.0: Vitesse maximale de déplacement pour les axes, exprimée en unités machine par seconde. La valeur indiquée est égale à 300 unités par minute.
MAX_ACCELERATION = 20.0: Accélération maximale pour les axes, exprimée en unités machine par seconde par seconde.
POSITION_FILE = position.txt: Si réglée à une valeur non vide, les positions des articulations sont enregistrées dans ce fichier. Cela permet donc de redémarrer avec les mêmes coordonnées que lors de l'arrêt³ . Si vide, les positions ne seront pas enregistrées et commenceront à 0 à chaque fois qu'EMC démarrera.

1.3.7 Section [AXIS_<num>]

Les sections [AXIS_0], [AXIS_1], etc. contiennent les paramètres généraux des composants individuels du module de contrôle. La numérotation des sections axis commencent à 0 et vont jusqu'au nombre d'axes spécifié dans la variable [TRAJ] AXES, moins 1.

TYPE = LINEAR: Type des axes, soit LINEAR, soit ANGULAR.
UNITS = inch: Ce réglage écrase celui des variables [TRAJ] UNITS si il est spécifié. (ex: [TRAJ]LINEAR_UNITS si le TYPE de cet axe est LINEAR, [TRAJ]ANGULAR_UNITS si le TYPE de cet axe est ANGULAR)
MAX_VELOCITY = 1.2: Vitesse maximum pour cet axe en unités machine par seconde.
MAX_ACCELERATION = 20.0: Accélération maximum pour cet axe en unités machine par seconde au carré.
BACKLASH = 0.000: Valeur de compensation du jeu en unités machine. Peut être utilisée pour atténuer de petites déficiences du matériel utilisé pour piloter cet axe.
COMP_FILE = file.extension: Fichier dans lequel est enregistrée une structure de compensation spécifique à cet axe. Les valeurs internes sont des triplets représentant les positions suivantes:

Positions nominales
Positions en marche positive
Positions en marche négative.

La position nominale est celle où devrait être le mobile. La position en marche positive signifie, où se trouve le mobile pendant le déplacement dans le sens positif. La position en marche négative signifie, où se trouve le mobile pendant le déplacement dans le sens négatif. Un triplet par ligne. Actuellement la limite d'EMC2 est de 256 triplets par axe. Si COMP_FILE est spécifié, BACKLASH est ignoré. Les valeurs sont en unités machine.

COMP_FILE_TYPE = 1: En spécifiant une valeur non nulle, le format des triplets du fichier COMP_FILE sera différent. Pour COMP_FILE_TYPE = 0, les valeurs des triplets seront: position nominale, position en marche positive, position en marche négative. Pour COMP_FILE_TYPE différent de 0, les valeurs dans COMP_FILE seront: position nominale, écart sens positif, écart sens négatif. Comparées au valeurs définies au dessus elles correspondent à, nominale, nominale-position en marche positive, nominal-position en marche négative.

Exemple de triplet avec COMP_FILE_TYPE = 0: 1.00 1.01 0.99.

Le même exemple de triplet avec COMP_FILE_TYPE = 1: 1.00 -0.01 0.01

MIN_LIMIT = -1000: Limite minimum des mouvements de cet axe (limite soft), en unités machine. Quand cette limite tend à être dépassée, le contrôleur arrête le mouvement.
MAX_LIMIT = 1000: Limite maximum des mouvements de cet axe (limite soft), en unités machine. Quand cette limite tend à être dépassée, le contrôleur arrête le mouvement.
MIN_FERROR = 0.010: Valeur indiquant, en unités machine, de combien le mobile peut dévier à très petite vitesse de la position commandée. Si MIN_FERROR est plus petit que FERROR, les deux produisent une rampe de points de dérive. Vous pouvez imaginer un graphe sur lequel une dimension représente la vitesse et l'autre, l'erreur tolérée. Quand la vitesse augmente, la quantité d'erreurs de suivi augmente également et tend vers la valeur FERROR.
FERROR = 1.0: FERROR est le maximum d'erreurs de suivi tolérable, en unités machine. Si la différence entre la position commandée et la position retournée excède cette valeur, le contrôleur désactive les calculs des servomoteurs, positionne toutes les sorties à 0.0 et coupe les amplis des moteurs. Si MIN_FERROR est présent dans le fichier .ini, une vitesse proportionnelle aux erreurs de suivi est utilisée. Ici, le maximum d'erreur de suivi est proportionnel à la vitesse, quand FERROR est appliqué à la vitesse rapide définie dans [TRAJ]MAX_VELOCITY et proportionnel aux erreurs de suivi pour les petites vitesses. L'erreur maximale admissible sera toujours supérieure à MIN_FERROR. Cela permet d'éviter que de petites erreurs de suivi sur les axes stationnaires arrêtent les mouvements de manière impromptue. Des petites erreurs de suivi seront toujours présentes à cause des vibrations, etc. La polarité des valeurs de suivi détermine comment les entrées sont interprétées et comment les résultats sont appliqués aux sorties. Elles peuvent généralement être réglées par tâtonnement car il n'y a que deux possibilités. Le programme utilitaire USRMOT peut être utilisé pour les ajuster intéractivement et vérifier les résultats, de sorte que les valeurs puissent être mises dans le fichier INI avec un minimum de difficultés.

1.3.7.1 Variables relatives aux prises d'origine

Les cinq prochains paramètres sont relatifs aux prises d'origine.

HOME_OFFSET = 0.0: Position du contact d'origine machine de l'axe ou impulsion d'index, en unités machine.
HOME_SEARCH_VEL = 0.0: Vitesse du mouvement inital de prise d'origine, en unités machine par seconde. Une valeur de zéro suppose que la position courante est l'origine machine. Si votre machine n'a pas de contact d'origine, laissez cette valeur à zéro.
HOME_LATCH_VEL = 0.0: Vitesse du mouvement final de prise d'origine pour le dégagement du contact d'origine, en unités machine par seconde.
HOME_USE_INDEX = NO: Si l'encodeur utilisé pour cet axe fournit une impulsion d'index et qu'elle est gérée par la carte contrôleur, vous pouvez mettre sur Yes. Quand il est sur yes, il aura une incidence sur le type de séquence de prise d'origine utilisé.
HOME_IGNORE_LIMITS = NO: Certaines machines utilisent une limite d'axe comme contact d'origine machine. Cette variable devra être positionnée sur yes si c'est le cas de votre machine.

1.3.7.2 Variables relatives aux servo

Les entrées suivantes concernent les systèmes à servomoteurs, comme la carte du système univstep de Pico Systems.⁴ Cette description suppose que les unités en sortie du composant PID sont des Volts.

P = 50

(hal) La composante proportionnelle du gain de l'ampli moteur de cet axe. Cette valeur multiplie l'erreur entre la position commandée et la position actuelle en unités machine, elle entre dans le calcul de la tension appliquée à l'ampli moteur. Les unités du gain P sont des Volts sur des unités machine, exemple: