How to configure coils/drivers/magnets (P-ROC/P3-ROC)

Related Config File Sections
coils:

To configure coils, drivers, motors, and/or magnets (basically anything connected to PD-16 board’s driver outputs) with P-ROC/P3-ROC hardware, you can follow the guides and instructions in the Coils (Solenoids) docs.

(If you’re using a P-ROC with an existing machine’s driver board, like a WPC machine, then see the existing machine documentation.)

The only specific thing you have to know for this platform is the number format:

number:

../../_images/multimorphic_PD-16.png

For PD-16-based devices, the numbering format is:

number: Ax-By-z

The “A” and “B” capital letters are required. (A means Address, B means Bank). The lowercase x, y, and z letters should be replaced with numbers to represent the following on a PD-16 driver board:

  • x : Board address (0-31)
  • y : Bank address (0 for A, 1 for B)
  • z : Output number (0-7)

Note

The output number is the logical number, not the pin number. For example, Output 0 is on Pin 1, and there is a key pin at 2 or 3. Check the manual for the exact mapping.

For example:

coils:
   some_coil:
      number: A0-B1-6
      default_pulse_ms: 30

Burst Switches as Local Outputs (P3-Roc only)

../../_images/multimorphic_p3_roc.png

If you want to use burst switches as local outputs set DIP switch 1 to on on the P3-Roc. You can use those 64 output as direct outputs:

coils:
   local_output0:
      number: direct-0  # direct driver 0
   local_output20:
      number: direct-20 # direct driver 20

Make sure to assign IDs >= 2 to all PD-16 boards if you set DIP 1 (MPF cannot check this for you). Local outputs behave just like any other output on the P3-Roc. Hardware rules, pulse, hold, pwm etc. will behave exactly the same way.

You may also use outputs as digital_outputs. For instance, to control a motor driver circuit:

digital_outputs:
   motor_left:
      number: direct-5
      type: driver
   motor_rigth:
      number: direct-6
      type: driver

Note

You need at least Firmware version 2.6 to use burst switches as local outputs on the P3-Roc.

Warning

There is no electronic protection on the P3-Roc for burst switches (neither as local outputs nor as burst optos). Additionally, there are no drivers attached to the outputs and they cannot drive any pinball mechs. Make sure not to draw too much current out of those outputs. Also, any voltage above 3.3V or below 0V will irrevisibly damage the P3-Roc. Make sure you know what you are doing before turning this on. We advise to use PD-16 for normal playfield/mech drivers and only use local outputs with additional circuits (not directly).