mpf 0.57.4.dev3__tar.gz → 0.57.5.dev1__tar.gz

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/.github/workflows/build_wheels.yml

@@ -22,10 +22,13 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.11
+          python-version: 3.13
 
       - name: Install MPF
         run: |
+          sudo apt-get update
+          sudo apt-get install -y '^libxcb.*-dev' libx11-xcb-dev libjpeg-dev
+          sudo apt-get install -y qt6-base-dev
           pip install --upgrade pip setuptools wheel build
           pip install -e .
 

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/.github/workflows/prospector.yml

@@ -1,12 +1,21 @@
 name: Lint all Python files
 
-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - dev
+      - 0.80.x
+  pull_request:
+    branches:
+      - dev
+      - 0.80.x
+
 
 jobs:
   prospector:
     name: Run Prospector on all Python files
     runs-on: ubuntu-latest
-    
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v2
@@ -14,10 +23,11 @@ jobs:
       - name: Setup python
         uses: actions/setup-python@v4
         with:
-          python-version: 3.11
+          python-version: 3.13
 
       - name: Install MPF
         run: |
+          sudo apt-get install -y libjpeg-dev
           pip install --upgrade pip setuptools wheel build prospector
           pip install -e .
 

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/.github/workflows/run_tests.yml

@@ -1,6 +1,14 @@
 name: Test on all platforms
 
-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - dev
+      - 0.80.x
+  pull_request:
+    branches:
+      - dev
+      - 0.80.x
 
 jobs:
   tests:
@@ -18,6 +26,12 @@ jobs:
           python-version: "3.10"
         - os: windows-latest
           python-version: 3.11
+        - os: windows-latest
+          python-version: 3.12
+        - os: windows-latest
+          python-version: 3.13
+        - os: windows-latest
+          python-version: 3.14
         - os: ubuntu-latest
           python-version: 3.8
         - os: ubuntu-latest
@@ -26,6 +40,12 @@ jobs:
           python-version: "3.10"
         - os: ubuntu-latest
           python-version: 3.11
+        - os: ubuntu-latest
+          python-version: 3.12
+        - os: ubuntu-latest
+          python-version: 3.13
+        - os: ubuntu-latest
+          python-version: 3.14
         - os: macos-latest
           python-version: 3.8
         - os: macos-latest
@@ -34,6 +54,12 @@ jobs:
           python-version: "3.10"
         - os: macos-latest
           python-version: 3.11
+        - os: macos-latest
+          python-version: 3.12
+        - os: macos-latest
+          python-version: 3.13
+        - os: macos-latest
+          python-version: 3.14
 
     steps:
       - name: Checkout MPF
@@ -44,6 +70,18 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
+      - name: Install jpeg support for pillow
+        shell: bash
+        run: |
+          if [ "${{ runner.os }}" == "Windows" ]; then
+            choco install libjpeg-turbo
+          elif [ "${{ runner.os }}" == "Linux" ]; then
+            # do nothing, Linux works without additional install
+            sudo apt-get install -y libjpeg-dev
+          else #must be mac!
+            brew install libjpeg-turbo
+          fi
+
       - name: Install MPF
         run: |
           pip install --upgrade pip setuptools wheel build coveralls
@@ -79,4 +117,4 @@ jobs:
         pip3 install --upgrade coveralls
         coveralls --service=github --finish
       env:
-        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/AUTHORS.md

@@ -30,6 +30,7 @@ their spare time, unpaid, for the love of pinball!
  * Dave Ensminger <dave@ensadi.com>
  * Charles Duncan (nullbuilds)
  * Eric Selk <ericselk2018@gmail.com>
+ * Alex Lobascio (bosh)
  * Jerome Vivien
 
 MPF was inspired by pyprocgame which was written by:
@@ -37,4 +38,4 @@ MPF was inspired by pyprocgame which was written by:
  * Adam Preble
  * Gerry Stellenberg
 
-Want to contribute to MPF? Get started here: https://missionpinball.org/about/contributing_to_mpf/
+Want to contribute to MPF? Get started here: https://missionpinball.org/latest/about/contributing_to_mpf/

mpf-0.57.5.dev1/CONTRIBUTING.md

@@ -0,0 +1 @@
+See: https://missionpinball.org/latest/about/contributing_to_mpf/

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: mpf
-Version: 0.57.4.dev3
+Version: 0.57.5.dev1
 Summary: The Mission Pinball Framework (MPF)
 Author-email: The Mission Pinball Framework Team <brian@missionpinball.org>
 License: MIT
 Project-URL: homepage, https://missionpinball.org
-Project-URL: support-forum, https://missionpinball.org/community/
+Project-URL: support-forum, https://missionpinball.org/latest/community/
 Keywords: pinball
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -14,13 +14,16 @@ Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Natural Language :: English
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Topic :: Artistic Software
 Classifier: Topic :: Games/Entertainment :: Arcade
-Requires-Python: >=3.8
+Requires-Python: <3.15,>=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 License-File: AUTHORS.md
@@ -34,7 +37,7 @@ Requires-Dist: ruamel.yaml==0.18.6
 Requires-Dist: setuptools~=72.2.0
 Requires-Dist: sortedcontainers==2.4.0
 Requires-Dist: terminaltables==3.1.10
-Requires-Dist: Pillow==9.5.0
+Requires-Dist: Pillow>=10.4.0
 Provides-Extra: crash-reporter
 Requires-Dist: requests==2.28.2; extra == "crash-reporter"
 Provides-Extra: irc

mpf-0.57.5.dev1/RELEASE.md

@@ -0,0 +1 @@
+See: https://missionpinball.org/latest/versions/release_notes/

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/docs/code/machine_code.rst

@@ -18,7 +18,7 @@ match up to any of MPF's built in devices. The elevator and claw unloader
 in *Demolition Man* is a good example, and what we'll use here.
 
 (You can read about how to download and run *Demo Man* in the
-`example games section <https://missionpinball.org/example_games/>`_
+`example games section <https://missionpinball.org/latest/examples/>`_
 section of the MPF User Documentation.)
 
 Here's how to create a custom code class:

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/docs/dev/event_annotations.rst

@@ -25,7 +25,7 @@ document the event in code and in the docs, we use a custom docblock annotation:
     reason: The reason for this awesomeness is stated here.
   '''
 
-The event should be added to the `event reference <https://missionpinball.org/events/>`_
+The event should be added to the `event reference <https://missionpinball.org/latest/events/>`_
 on missionpinball.org.
 
 Note: As of June 2023, the events list on missionpinball.org is no longer automatically generated.

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/docs/dev/mc.widget_player.rst

@@ -42,7 +42,7 @@ So here is our base ``widget`` from the config file that we will be using.
             x: 35
 
 Refer to the widget section in the docs for more info on how to set it up:
-https://missionpinball.org/mc/widgets/
+https://missionpinball.org/latest/mc/widgets/
 
 Writing the settings to show/play this widget in code
 ^^^^^^^^^^^^^^^
@@ -69,7 +69,7 @@ When it comes to the settings we start with the following:
 
 You need to add ``action`` and ``key`` to make the ``widget`` work.
 Refer to the ``widget_player`` section for more info on these and what other functions can be added:
-https://missionpinball.org/config_players/widget_player/
+https://missionpinball.org/latest/config_players/widget_player/
 
 Now you can show the pre-defined widget from the config file.
 
@@ -107,7 +107,7 @@ The following code shows how to override an image and x-coordinate
 You can ``change``/``add`` everything this way from the related type of ``widget``, or the common settings for all widgets.
 Refer to the common settings for a overview of all settings.
 
-https://missionpinball.org/mc/widgets/common_settings/
+https://missionpinball.org/latest/mc/widgets/common_settings/
 
 Just make sure you format this way
 
@@ -127,7 +127,7 @@ Creating animation from predefined animations
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 The easiest thing is to change/add pre-defined animations.
 See chapter 9 of widget animation for more info on this:
-https://missionpinball.org/mc/widgets/animation/
+https://missionpinball.org/latest/mc/widgets/animation/
 
 .. code-block:: python
 

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/docs/testing/tutorial/2.rst

@@ -1,7 +1,7 @@
 Testing Tutorial Step 2. Create your machine folder
 ===================================================
 
-`Step 2 of the MPF Tutorial <https://missionpinball.org/tutorial/2_creating_a_new_machine>`_ is where
+`Step 2 of the MPF Tutorial <https://missionpinball.org/latest/tutorial/2_creating_a_new_machine>`_ is where
 you create your machine folder and get MPF up and running with an empty config. Since it ends with MPF running and the
 attract mode being active, we can actually write a test for it!
 

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/docs/testing/writing_machine_tests.rst

@@ -25,7 +25,7 @@ your tests pass again!)
 .. rubric:: Tutorial for writing your own tests
 
 We have a complete tutorial which walks you through writing tests for your own machine. This tutorial
-conveniently follows the general MPF tutorial at `<https://missionpinball.org/tutorial>`_. Each step here matches the
+conveniently follows the general MPF tutorial at `<https://missionpinball.org/latest/tutorial>`_. Each step here matches the
 step with the same number there. (Just make sure you'll looking at the same version of the documentation
 in both places.)
 

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/_version.py

@@ -10,7 +10,7 @@ PyPI.
 
 """
 
-__version__ = '0.57.4.dev3'  # Also consider whether MPF-MC pyproject.toml should be updated
+__version__ = '0.57.5.dev1'  # Also consider whether MPF-MC pyproject.toml should be updated
 '''The full version of MPF.'''
 
 __short_version__ = '0.57'
@@ -37,7 +37,7 @@ extended_version = "Mission Pinball Framework v{}, Config version:{}, Show versi
 '''An extended version string that includes the MPF version, show version,
 and BCP versions used in this build of MPF.'''
 
-log_url = "https://missionpinball.org/logs"
+log_url = "https://missionpinball.org/latest/logs"
 # TODO make dynamic "https://docs.missionpinball.org/en/dev/logs/{}.html"
 
 __api__ = ['version',

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/config_players/random_event_player.py

@@ -23,48 +23,44 @@ class RandomEventPlayer(ConfigPlayer):
         """Return true if scope is not player."""
         return settings['scope'] != "player"
 
-    def _get_randomizer(self, settings, context, calling_context):
-        key = "random_{}.{}".format(context, calling_context)
-        if settings['scope'] == "player":
-            if not self.machine.game.player[key]:
-                self.machine.game.player[key] = Randomizer(
-                    settings['events'], self.machine, template_type="event")
-                r'''player_var: random_(x).(y)
+    def _build_randomizer(self, settings):
+        randomizer = Randomizer(settings['events'], self.machine, template_type="event")
+
+        if settings['force_all']:
+            randomizer.force_all = True
 
-                desc: Holds references to Randomizer settings that need to be
-                tracked on a player basis. There is nothing you need to know
-                or do with this, rather this is just FYI on what the player
-                variables that start with "random\_" are.
-                '''
+        if not settings['force_different']:
+            randomizer.force_different = False
 
-                if settings['force_all']:
-                    self.machine.game.player[key].force_all = True
+        if settings['disable_random']:
+            randomizer.disable_random = True
 
-                if not settings['force_different']:
-                    self.machine.game.player[key].force_different = False
+        randomizer.fallback_value = settings.get('fallback_event')
+        return randomizer
 
-                if settings['disable_random']:
-                    self.machine.game.player[key].disable_random = True
+    def _get_randomizer(self, settings, context, calling_context):
+        key = "random_{}.{}".format(context, calling_context)
+        if settings['scope'] == "player":
+            if not self.machine.game.player[key]:
+                self.machine.game.player[key] = self._build_randomizer(settings)
 
-                self.machine.game.player[key].fallback_value = settings.get('fallback_event')
+            '''player_var: random_(x).(y)
 
+            desc: Holds references to Randomizer settings that need to be
+            tracked on a player basis. There is nothing you need to know
+            or do with this, rather this is just FYI on what the player
+            variables that start with "random_" are.
+            '''
             return self.machine.game.player[key]
 
         if key not in self._machine_wide_dict:
-            self._machine_wide_dict[key] = Randomizer(
-                settings['events'], self.machine, template_type="event")
-
-            if settings['force_all']:
-                self._machine_wide_dict[key].force_all = True
-
-            if not settings['force_different']:
-                self._machine_wide_dict[key].force_different = False
-
-            if settings['disable_random']:
-                self._machine_wide_dict[key].disable_random = True
+            self._machine_wide_dict[key] = self._build_randomizer(settings)
 
-            self._machine_wide_dict[key].fallback_value = settings.get('fallback_event')
+        '''machine_var: random_(x).(y)
 
+        desc: Holds references to Randomizer settings that need to be
+        tracked on a machine basis.
+        '''
         return self._machine_wide_dict[key]
 
     def play(self, settings, context, calling_context, priority=0, **kwargs):

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/config_spec.yaml

@@ -449,7 +449,7 @@ diverters:
     __type__: device
     activate_events: event_handler|event_handler:ms|None
     activation_coil: single|machine(coils)|None
-    activation_time: single|ms|0
+    activation_time: single|template_ms|None
     activation_switches: list|machine(switches)|None
     allow_multiple_concurrent_ejects_to_same_side: single|bool|true
     cool_down_time: single|ms|0
@@ -622,6 +622,7 @@ fast:
     __type__: config
     net: single|subconfig(fast_net)|None
     exp: single|subconfig(fast_exp)|None
+    exp_int: single|subconfig(fast_exp)|None    
     aud: single|subconfig(fast_aud)|None
     seg: single|subconfig(fast_seg)|None
     dmd: single|subconfig(fast_dmd)|None
@@ -643,6 +644,7 @@ fast_net:
     default_quick_debounce_close: single|ms|2
     default_normal_debounce_open: single|ms|4
     default_normal_debounce_close: single|ms|4
+    mute_unconfigured_switches: single|bool|false
     gi_hz: single|int|30
     lamp_hz: single|int|30
 fast_io_loop:
@@ -811,6 +813,7 @@ hardware:
     accelerometers: list|str|default
     i2c: list|str|default
     stepper_controllers: list|str|default
+    shaker_controllers: list|str|default
     hardware_sound_system: list|str|default
 hardware_sound_systems:
     __valid_in__: machine
@@ -1021,6 +1024,7 @@ counter_control_events:  # subconfig for mode counters
     action: single|enum(add,subtract,jump)|
     event: single|event_handler|
     value: single|template_int|None
+    priority: single|int|0
 sequences:
     __valid_in__: machine, mode
     __type__: device
@@ -1120,7 +1124,7 @@ mpf:
     plugins: ignore
     platforms: ignore
     paths: ignore
-    report_crashes: single|enum(ask,never,always)|ask
+    report_crashes: single|enum(ask,never,always)|never
     rgbw_white_behavior: single|enum(white_only,min_rgb,duck_rgb)|duck_rgb
 mpf-mc:
     __valid_in__: machine                           # todo add to validator
@@ -1135,6 +1139,7 @@ multiballs:
     shoot_again: single|template_ms|10s
     hurry_up_time: single|template_ms|0
     grace_period: single|template_ms|0
+    restart_grace_period: single|template_ms|0
     ball_locks: list|machine(ball_devices)|None
     enable_events: event_handler|event_handler:ms|None
     disable_events: event_handler|event_handler:ms|None
@@ -1474,6 +1479,8 @@ score_reel_groups:
     __type__: device
     reels: list|machine(score_reels)|
     chimes: list|machine(coils)|None
+    enable_chimes_events: event_handler|event_handler:ms|ball_started
+    disable_chimes_events: event_handler|event_handler:ms|game_ended
     lights_tag: single|str|None
 segment_displays:
     __valid_in__: machine
@@ -1966,6 +1973,18 @@ steppers:
 stepper_position_settings:
     event: single|str|
     speed: single|int|None
+shakers:
+    __valid_in__: machine
+    __type__: device
+    default_power: single|float|0.0
+    number: single|str|
+    control_events: dict|str:subconfig(shaker_pulse_settings)|None
+    platform: single|str|None
+    platform_settings: single|dict|None
+shaker_pulse_settings:
+    action: single|enum(pulse,stop)|pulse
+    power: single|float|None
+    duration: single|template_secs|None
 spike_stepper_settings:
     homing_speed: single|int|10
     speed: single|int|20
@@ -1999,6 +2018,7 @@ sequence_shots:
     delay_event_list: event_handler|event_handler:ms|None
     sequence_timeout: single|ms|0
     playfield: single|machine(playfields)|None
+    allow_multiple_active: single|bool|true
 switches:
     __valid_in__: machine
     __type__: device
@@ -2260,6 +2280,8 @@ widgets:
         start_frame: single|int_or_token|0
         rotation: single|int_or_token|0
         scale: single|float_or_token|1.0
+        mag_filter: single|enum(linear,nearest)|linear
+        min_filter: single|enum(linear,nearest)|linear
     line:
         points: list|num_or_token|
         thickness: single|float_or_token|1.0

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/core/clock.py

@@ -64,21 +64,27 @@ class ClockBase(LogMixin):
 
         self.debug_log("Starting tickless clock")
         if not loop:
-            self.loop = self._create_event_loop()   # type: asyncio.AbstractEventLoop
+            self.loop = self._get_or_create_loop()  # type: asyncio.AbstractEventLoop
         else:
             self.loop = loop                        # type: asyncio.AbstractEventLoop
 
         asyncio.set_event_loop(self.loop)
 
-    def _create_event_loop(self):
+    def _get_or_create_loop(self):
+        try:
+            return asyncio.get_event_loop()
+        except RuntimeError:
+            return self._create_loop()
+
+    def _create_loop(self):
         try:
             # pylint: disable-msg=import-outside-toplevel
             import uvloop
         except ImportError:
             pass
         else:
-            asyncio.set_event_loop_policy(uvloop.EventLoopPolicy())
-        return asyncio.get_event_loop()
+            return uvloop.new_event_loop()
+        return asyncio.new_event_loop()
 
     def run(self, stop_future):
         """Run the clock."""

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/core/events.py

@@ -900,7 +900,31 @@ class QueuedEvent:
 
 
 def event_handler(relative_priority):
-    """Decorate an event handler."""
+    """Decorate an event handler.
+
+    Priority order is important for a complex device management reason -
+    handler resolution across multiple devices, especially of the same type.
+
+    Say you have two flipper definitions on the same switch and coil pairing, for
+    example with a "weak flipper" mode. Flippers are managed through enable and
+    disable events that are bound through create_machinewide_device_control_events
+    reading their enable_events and disable_events configs.
+
+    There is no way to provide priority adjustment to these events, so if the
+    normal flipper uses "start_weak_flippers" as its disable event, and the
+    weak flipper uses that as its enable event, then you have a tie and thus
+    ambiguous resolution order to the two handlers that will manage the current
+    rule on the coil.
+
+    What would generally be expected is that the weak flipper would win there,
+    meaning the enable-weak must win. But to do that, it must go _last_. So
+    therefore the _disable_ event handler needs a higher priority than the
+    enable handler.
+
+    Therefore the best practice with choosing event_handler relative_priority
+    is to put destructive/cleanup handlers at higher priority, and
+    positive/enabling handlers at lower priority.
+    """
     def decorator(func):
         """Decorate a function with relative priority."""
         func.relative_priority = relative_priority

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/core/machine.py

@@ -61,6 +61,7 @@ if MYPY:   # pragma: no cover
     from mpf.devices.digital_output import DigitalOutput    # pylint: disable-msg=cyclic-import,unused-import
     from logging import Logger  # noqa
     from mpf.devices.autofire import AutofireCoil   # pylint: disable-msg=cyclic-import,unused-import
+    from mpf.devices.shaker import Shaker   # pylint: disable-msg=cyclic-import,unused-import
     from mpf.devices.stepper import Stepper     # pylint: disable-msg=cyclic-import,unused-import
     from mpf.config_players.show_player import ShowPlayer   # pylint: disable-msg=cyclic-import,unused-import
     from mpf.devices.dmd import Dmd     # pylint: disable-msg=cyclic-import,unused-import
@@ -167,6 +168,7 @@ class MachineController(LogMixin):
             self.autofire_coils = {}                    # type: Dict[str, AutofireCoil]
             self.motors = {}                            # type: Dict[str, Motor]
             self.digital_outputs = {}                   # type: Dict[str, DigitalOutput]
+            self.shakers = {}                           # type: Dict[str, Shaker]
             self.shows = {}                             # type: Dict[str, Show]
             self.shots = {}                             # type: Dict[str, Shot]
             self.shot_groups = {}                       # type: Dict[str, ShotGroup]

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/core/mode_device.py

@@ -22,13 +22,13 @@ class ModeDevice(Device, metaclass=abc.ABCMeta):
         self.mode = None    # type: Optional[Mode]
 
     async def device_added_to_mode(self, mode: Mode) -> None:
-        """Add device to a running mode.
+        """Add device to a loading mode.
 
         Args:
         ----
             mode: Mode which loaded the device
         """
-        del mode
+        self.mode = mode
         await self._initialize()
 
     def device_loaded_in_mode(self, mode: Mode, player: Player) -> None:
@@ -42,7 +42,7 @@ class ModeDevice(Device, metaclass=abc.ABCMeta):
             player: Current active player
         """
         del player
-        self.mode = mode
+        del mode
 
     @property
     def can_exist_outside_of_game(self) -> bool:
@@ -88,4 +88,3 @@ class ModeDevice(Device, metaclass=abc.ABCMeta):
             mode: Mode which stopped
         """
         del mode
-        self.mode = None

{mpf-0.57.4.dev3 → mpf-0.57.5.dev1}/mpf/core/platform.py

@@ -12,6 +12,7 @@ from mpf.core.utility_functions import Util
 
 MYPY = False
 if MYPY:   # pragma: no cover
+    from mpf.devices.shaker import Shaker   # pylint: disable-msg=cyclic-import,unused-import
     from mpf.devices.switch import Switch   # pylint: disable-msg=cyclic-import,unused-import
     from mpf.devices.stepper import Stepper     # pylint: disable-msg=cyclic-import,unused-import
     from mpf.devices.servo import Servo     # pylint: disable-msg=cyclic-import,unused-import
@@ -19,6 +20,7 @@ if MYPY:   # pragma: no cover
     from mpf.platforms.interfaces.switch_platform_interface import SwitchPlatformInterface  # pylint: disable-msg=cyclic-import,unused-import; # noqa
     from mpf.platforms.interfaces.light_platform_interface import LightPlatformInterface    # pylint: disable-msg=cyclic-import,unused-import; # noqa
     from mpf.platforms.interfaces.servo_platform_interface import ServoPlatformInterface    # pylint: disable-msg=cyclic-import,unused-import; # noqa
+    from mpf.platforms.interfaces.shaker_platform_interface import ShakerPlatformInterface    # pylint: disable-msg=cyclic-import,unused-import; # noqa
     from mpf.platforms.interfaces.segment_display_platform_interface import SegmentDisplayPlatformInterface     # pylint: disable-msg=cyclic-import,unused-import; # noqa
     from mpf.platforms.interfaces.hardware_sound_platform_interface import HardwareSoundPlatformInterface   # pylint: disable-msg=cyclic-import,unused-import; # noqa
     from mpf.platforms.interfaces.stepper_platform_interface import StepperPlatformInterface    # pylint: disable-msg=cyclic-import,unused-import; # noqa
@@ -60,6 +62,7 @@ class BasePlatform(LogMixin, metaclass=abc.ABCMeta):
         self.features['has_segment_displays'] = False
         self.features['has_hardware_sound_systems'] = True
         self.features['has_steppers'] = False
+        self.features['has_shakers'] = False
         self.features['allow_empty_numbers'] = False
         self.features['hardware_eos_repulse'] = False
 
@@ -404,6 +407,53 @@ class StepperPlatform(BasePlatform, metaclass=abc.ABCMeta):
         raise NotImplementedError
 
 
+class ShakerPlatform(BasePlatform, metaclass=abc.ABCMeta):
+
+    """Baseclass for shaker platforms in MPF."""
+
+    __slots__ = []  # type: List[str]
+
+    def __init__(self, machine):
+        """Add shaker feature."""
+        super().__init__(machine)
+        self.features['has_shakers'] = True
+
+    @classmethod
+    def get_stepper_config_section(cls) -> Optional[str]:
+        """Return config section for additional stepper config items."""
+        return None
+
+    def validate_shaker_section(self, shaker: "Shaker", config: dict) -> dict:
+        """Validate a shaker config for platform.
+
+        Args:
+        ----
+            shaker: Shaker to validate.
+            config: Config to validate.
+
+        Returns: Validated config.
+        """
+        if self.get_shaker_config_section():
+            spec = self.get_shaker_config_section()    # pylint: disable-msg=assignment-from-none
+            config = shaker.machine.config_validator.validate_config(spec, config, shaker.name)
+        elif config:
+            raise AssertionError("No platform_config supported but not empty {} for shaker {}".
+                                 format(config, shaker.name))
+
+        return config
+
+    @abc.abstractmethod
+    async def configure_shaker(self, number: str, config: dict) -> "ShakerPlatformInterface":
+        """Configure a shaker device in platform.
+
+        Args:
+        ----
+            number: Number of the shaker
+            config: Config for this shaker.
+        """
+        raise NotImplementedError
+
+
 class LightConfigColors(Enum):
 
     """Light color for LightConfig."""