Table of Contents
marmux- is a X11/Motif based graphical user interface for operating
the Xenocs/Genix micro-focus generator.
marmux [ -h ] [ --help ] [
-s ] [ --simulate ] [ +s ] [ -x ] [ --gui ] [ -v ] [ --verbose ] [ -host HOST ]
[ -port PORT ] [ -type TYPE ] [ HOST ]
marmux is a graphical
user interface (GUI) to operate the Xenocs "GeniX" generator. The generator
can be controlled by a PC via a TCP/IP-socket interface. See section NETWORK
SETUP and REMOTE MODE for more details.
To use the generator in "remote mode", pins 5 and
7 on connector X03 on the back of the generator have to be bridged. When
operating the generator in "remote mode", the local control on the instrument
itself is disabled. When using the override key on the back of the generator,
the "remote mode" is disabled and "local mode" is enabled. To switch between
"remote mode" and "local mode", the X-rays have to be switched off.
- -h, --help
- Provides a summary
of the options.
- --host HOSTNAME
- Hostname (or IP-address) to use for the the
Default: --host 192.0.2.100
- --l LOGFILE
- Use LOGFILE as log file
Default: -log $MARLOGDIR/marmux.log
- -i, --interval MS
- Update generator status
every MS milliseconds.
Default: -i 1000
- -p, --port PORT-NO
- Socket port number to use for the Xenocs
Default: -p 502
- -s, --simulate
- Start program without hardware connected.
Default: try to connect to hardware.
- +s, +server PORT-NO
- Run program in
TCP/IP-server mode, i.e. accept input from other applications on port PORT-NO.
Default: do not offer a TCP/IP-socket.
- -v, --verbose
- Writes more information
The controller of the GeniX generator makes use of the industry standard
MODBUS/TCP-protocol for communication with a host computer. By default, the
GeniX generator IP-address is set to 22.214.171.124 with netmask 255.255.0.0, but
for use with the mar345dtb system the IP-address 192.0.2.100 with netmask
255.255.255.0 is used. The generator listens on port 502 for incoming connections.
It is possible to change the IP-address, via telnet. To do so, connect
to the generator via telnet. You may then select to change the IP/Ethernet
settings. Usually, it is sufficient to change the IP-address and netmask
to fit your local network. The gateway address may be left as is. To save
the changes, return to the main menu (R) and select "S" to save. You will
be asked for a password. The default password is "USERUSER".
there are only 3 useful states of operation of the GeniX generator. Either
the X-rays are OFF, or they are in low power STANDBY mode or they are in
NORMAL OPERATION mode. Hence, from the user interface you select one of
the 3 states. Setting the high voltage or current to other than the default
values (50 kV, 1.0 mA) is possible, but discouraged. The GUI allows for closing
the "FAST" and the "SAFETY" shutter and provides a visual feedback of the
current status, together with indications of possible hardware faults.
Instead of operating the GUI with the mouse, the
program may receive instructions via the keyboard (i.e. on the same command
line where the program has been started) or - when operated in TCP/IP-server
mode - also via a TCP/IP-socket (e.g. via telnet). See section KEYWORDS for
Lines starting with # or ! will be treated as comment
lines and will not be processed. In Currently the following keywords are
implemented. The mandatory part of the keyword is given in uppercase letters.
Keywords or part of keywords in square brackets [ ... ] are optional.
Keywords split up in 3 sections:
- program control
- detector commands
The keywords for program control