xref: /linux/Documentation/admin-guide/braille-console.rst (revision 24bce201d79807b668bf9d9e0aca801c5c0d5f78)
1Linux Braille Console
2=====================
3
4To get early boot messages on a braille device (before userspace screen
5readers can start), you first need to compile the support for the usual serial
6console (see :ref:`Documentation/admin-guide/serial-console.rst <serial_console>`), and
7for braille device
8(in :menuselection:`Device Drivers --> Accessibility support --> Console on braille device`).
9
10Then you need to specify a ``console=brl``, option on the kernel command line, the
11format is::
12
13	console=brl,serial_options...
14
15where ``serial_options...`` are the same as described in
16:ref:`Documentation/admin-guide/serial-console.rst <serial_console>`.
17
18So for instance you can use ``console=brl,ttyS0`` if the braille device is connected to the first serial port, and ``console=brl,ttyS0,115200`` to
19override the baud rate to 115200, etc.
20
21By default, the braille device will just show the last kernel message (console
22mode).  To review previous messages, press the Insert key to switch to the VT
23review mode.  In review mode, the arrow keys permit to browse in the VT content,
24:kbd:`PAGE-UP`/:kbd:`PAGE-DOWN` keys go at the top/bottom of the screen, and
25the :kbd:`HOME` key goes back
26to the cursor, hence providing very basic screen reviewing facility.
27
28Sound feedback can be obtained by adding the ``braille_console.sound=1`` kernel
29parameter.
30
31For simplicity, only one braille console can be enabled, other uses of
32``console=brl,...`` will be discarded.  Also note that it does not interfere with
33the console selection mechanism described in
34:ref:`Documentation/admin-guide/serial-console.rst <serial_console>`.
35
36For now, only the VisioBraille device is supported.
37
38Samuel Thibault <samuel.thibault@ens-lyon.org>
39