RaceCom API of end effector service
***********************************

.. note::

   This service is available starting from system version `>=5.7.0`.


The end effector service enables application developers to access and manage end effector profiles. This includes
reading available profiles, identifying the currently selected profile, and switching between activated profiles.

End effector service operations
-------------------------------

+-----------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------+
| operation       | request type | result type | error type      | description                                                                                                                    |
+=================+==============+=============+=================+================================================================================================================================+
| activateProfile | {            | {}          | {               | Activates the specified end effector profile identified by `id`.                                                               |
|                 | string id;   |             | string code;    | When attempting to activate a profile identified by `id` that does not exist, the service returns an error code of `NotFound`. |
|                 | }            |             | string message; | For all other errors encountered during the operation, the service returns an error code of `InternalError`.                   |
|                 |              |             | }               |                                                                                                                                |
+-----------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------------------------------+


End effector service events
---------------------------

+-----------------+--------------+-----------------------------------------------------------------------------------------------------------+
| event           | event type   | description                                                                                               |
+=================+==============+===========================================================================================================+
| active_profile  | {            | Identifies the profile, uniquely distinguished by `id` and associated with a `name`, as currently active. |
|                 | string id;   |                                                                                                           |
|                 | string name; |                                                                                                           |
|                 | }            |                                                                                                           |
+-----------------+--------------+-----------------------------------------------------------------------------------------------------------+
| profiles        | []{          | Enumerates available profiles, providing the `id` and `name` for each.                                    |
|                 | string id;   |                                                                                                           |
|                 | string name; |                                                                                                           |
|                 | }            |                                                                                                           |
+-----------------+--------------+-----------------------------------------------------------------------------------------------------------+