Please participate in the MPF User Survey 2018.
Configuring your machine for OPP¶
1. Configure the Hardware platform for OPP¶
To use MPF with OPP, you need to configure your platform as opp, like this:
hardware: platform: opp driverboards: gen2
You also need to configure the
driverboards: entry for what kind of
driver boards you’re controlling: right now, only gen2 is supported.
2. Configure the OPP-specific hardware settings¶
When you use OPP hardware with MPF, you also need to add an
section to your machine-wide config which contains some OPP-
specific hardware settings. MPF’s default config file
(mpfconfig.yaml) contains enough default settings to get you up and
running. The only thing you absolutely have to configure is your
Understanding OPP hardware ports¶
Even though OPP controllers are USB devices, they use “virtual” COM ports to communicate with the host computer running MPF. On your computer, if you look at your list of ports and then plug-in your OPP controller, you will see a new port appear. The exact names and numbers of these ports will vary depending on your computer and what else you’ve plugged in in the past.
Note: USB to serial converters add latency when communicating between the host computer, and the target device. It probably will not matter, but if given the choice between a “real” serial port, and a USB-serial port converter, the “real” serial port will have less latency. The real serial port must use 5V signal levels when talking to OPP hardware.
Adding the port to your config file¶
If you’re using an OPP controller, you need to add the serial port to your MPF config. So if you plug in the OPP controller and see a port such as COM7 appear, you’d set your config like this:
opp: ports: COM7
Full details of the port options as well as the other options
available here are in the
opp: section of the configuration
file reference. Note that if you’re using Windows and you have COM
port numbers greater than 9, you may have to enter the port names like
\\.\COM12, etc. (It’s a Windows
thing. Google it for details.) That said, it seems that Windows 10 can
just use the port names like normal:
com10, com11, com12, so try
that first and then try the alternate format if it doesn’t work.
Changing the polling rate¶
If you encounter issues with the polling rate (in other words: Your OPP processor boards can’t answer MPF’s polls fast enough) you may want to change it. (Default: 100Hz)
This can be done by simply adding the
poll_hz: line to the
opp: ports: COM7 poll_hz: 50
You only want to do this if you encounter issues. This will increase the time between two switches beeing read. Depending on the number of processor boards in your chain you could possibly miss some fast balls