Change the Tango event subscription mode
========================================

Taurus normally uses ``AsyncRead`` as the default Tango event subscription mode.
For an explanation of the available modes and the initial read behavior, see
:doc:`../explanation/events`.

.. _EventModesCustomSettings:

Change the default mode with Custom Settings
--------------------------------------------

You can set the **default EventSubMode** machine-wide using **Taurus Custom
Settings**. See :doc:`../reference/settings`.

.. _EventModesCLI:

Change the mode from the command line
-------------------------------------

Taurus provides two CLI switches to control Tango event subscriptions at launch:

- ``--disable-tango-event-subscription``
  Disables Tango change-event subscriptions and forces polling.

- ``--tango-event-sub-mode {Sync,SyncRead,Async,AsyncRead}``
  Selects the subscription mode for change events for this run.

Precedence:

1. If events are disabled via CLI, polling is used regardless of the selected mode.
2. Otherwise, the mode is taken from CLI; if not set, from custom settings;
   otherwise Taurus uses the project default (``AsyncRead``).