1.. _ps2-sample:
2
3PS/2 Interface
4####################################
5
6Overview
7********
8
9This sample demonstrates how to use the :ref:`PS/2 API <ps2_api>`.
10Callbacks are registered that will write to the console indicating PS2 events.
11These events indicate mouse configuration responses and mouse interaction.
12
13Building and Running
14********************
15
16The sample can be built and executed on boards supporting PS/2.
17It requires a correct fixture setup. Please connect a PS/2 mouse in order to
18exercise the functionality.
19For the correct execution of that sample in twister, add into boards's
20map-file next fixture settings::
21
22      - fixture: fixture_connect_mouse
23
24Sample output
25=============
26
27.. code-block:: console
28
29   PS/2 test with mouse
30   Note: You are expected to see several interrupts
31   as you configure/move the mouse!
32