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

EMC

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
HISTORY
BUGS
AUTHOR
REPORTING BUGS
COPYRIGHT

NAME

emc − EMC (The Enhanced Machine Controller)

SYNOPSIS

emc [-v] [-d] [INIFILE]

DESCRIPTION

emc is used to start EMC (The Enhanced Machine Controller). It starts the realtime system and then initializes a number of EMC components (IO, Motion, GUI, HAL, etc). The most important parameter is INIFILE, which specifies the configuration name you would like to run. If INIFILE is not specified, the emc script presents a graphical wizard to let you choose one.

OPTIONS

−v

Be a little bit verbose. This causes the script to print information as it works.

−d

Print lots of debug information. All executed commands are echoed to the screen. This mode is useful when something is not working as it should.

INIFILE

The ini file is the main piece of an EMC configuration. It is not the entire configuration; there are various other files that go with it (NML files, HAL files, TBL files, VAR files). It is, however, the most important one, because it is the file that holds the configuration together. It can adjust a lot of parameters itself, but it also tells emc which other files to load and use.

There are several ways to specify which config to use:

Specify the absolute path to an ini, e.g.
emc
/usr/local/emc2/configs/sim/sim.ini

Specify a relative path from the current directory, e.g.
emc
configs/sim/sim.ini

Otherwise, in the case where the INIFILE is not specified, the behavior will depend on whether you configured emc with --enable-run-in-place. If so, the emc config chooser will search only the configs directory in your source tree. If not (or if you are using a packaged version of emc), it may search several directories. The config chooser is currently set to search the path:

~/emc2/configs:/usr/local/etc/emc2/configs:/usr/local/share/doc/emc2/examples/sample-configs

EXAMPLES

emc

emc configs/sim/sim.ini

emc /etc/emc2/sample-configs/stepper/stepper_mm.ini

SEE ALSO

halcmd(1)

Much more information about EMC2 and HAL is available in the EMC2 and HAL User Manuals, found at /usr/share/doc/emc2/.

HISTORY

BUGS

None known at this time.

AUTHOR

This man page written by Alex Joni, as part of the Enhanced Machine Controller (EMC) project.

REPORTING BUGS

Report bugs to alex_joni AT users DOT sourceforge DOT net

COPYRIGHT

Copyright © 2006 Alex Joni.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.