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.
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 85.16.44.113 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".
In principle,
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
details.
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:
@file | DEBUG | QUIT | VERBose | UNIX | CONNect | DISConnect | HELP | HOST
| PORT
@filename | INCLude filename
Load instructions from file <filename>.
Example: @genix.params
CONNect | OPEN
Open TCP/IP-socket connection
to generator.
DISConnect | BYE | CLOSE
Closes TCP/IP-socket connection to
generator.
DEBUG [<value>]
Increase debug level or set to <value>.
Example: DEBUG 2
HELP | ?
Prints online help.
HOST [<hostname>]
Use
<hostname> to connect to the generator.
Example: HOST 192.0.2.100
PORT [<no>]
Use <no> as TCP/IP-port number to
connect to the generator.
Example: PORT 502
QUIT | EXIT
Terminate program.
Example: EXIT
VERBose [<value>]
Increase verbosity level or set to
<value>.
Example: VERBOSE 0
UNIX | % [<string>]
Anything after the keyword
will be treated as a shell command. The command messages produced on stdout
will be sent to the network socket. BEWARE: if the program marmux is being
run with super-user privileges, any user will be able to run any command
on the PC!
Example: UNIX ls /home/mar555/data
FAST | SAFEty | RESEt | VOLT | CURRent
| XRAY | STANdby | AUTOcycle
FAST [ON | OFF | 0 | 1]
Open or close the "FAST"
X-ray shutter. Whithout argument: close shutter.
Example: FAST 1
SAFEty [ON | OFF | 0 | 1]
Open or close the "SAFETY" X-ray
shutter. Whithout argument: close shutter.
Example: SAFETY ON
RESEt
Reset the hardware faults.
VOLT | KV | HV<value>
Change the set point for the high voltage to <value> kV. Default is 50.0 kV.
Example: VOLT 45.0
CURRent | MA<value>
Change the set point for the
current to <value> mA. Default is 1.00 mA.
Example: CURRENT 0.40
XRAY [[ ON | NORMal | 1 ] | [ OFF | 0 ] | STANdby]
Turn X-rays OFF, or set them in STANdby mode or in NORMal operation mode.
Valid shortcuts are: XRAY OFF = OFF, XRAY STANdby = STANdby and XRAY NORMal
= NORMal.
Example: XRAY STANDBY