Installing and Customizing the brltty Service

Support for a Braille device is provided by the BRLTTY daemon (brltty). You configure this service through the /etc/brltty.conf configuration file.

Note:

The brltty service isn't available by default. To use this service you must install the brltty package.

Install the brltty package.
```
sudo dnf install -y brltty
```
Configure settings in /etc/brltty.conf as needed.
See Configurable Settings of the brltty Service.
Enable the brltty service.
```
sudo systemctl enable --now brltty
```
Reboot the system.

Verify that the brltty service is running.

After the system reboots, verify that the service is running, as follows:

sudo systemctl status brltty

* brltty service - Braille display driver for Linux/Unix
   Loaded: loaded (/usr/lib/systemd/system/brltty.service; enabled; vendor preset: disabled
   Active: active (running) since Wed 2020-04-15 12:07:48 PDT; 25min ago
...

Note:

If you change settings in /etc/brltty.conf, then you must also restart Orca. To configure Braille options in the Screen Reader, see Configuring Braille Options on the Screen Reader.

For more information, see the brltty(1) manual page.

Configurable Settings of the brltty Service

The following are a selection of configurations that you can set in /etc/brltty.conf:

Table 4-1 Configuration settings of the brltty service

Functional Requirement	Configuration Setting
Authorize users who can use the Braille device.	Specify the users on the line `#api-parameters Auth=user:`, for example: `api-parameters Auth=user:jsmith, jdoe, bbrown`
Authorize groups who can use the Braille device.	Specify the groups on the line `#api-parameters Aut=group:`. For example, for a group called `braille`, you would enter: `api-parameters Auth=group:braille`
Specify the Braille display device driver.	Uncomment the appropriate `#braille-driver` line that contains the selected driver. Drivers are identified by two-letter codes, which are provided in the configuration file, for example: `braille-driver vo` On a single `braille-driver` line, you can specify multiple, comma-separated drivers. In this case, the service automatically scans the list and detects the appropriate driver.
Specify the type of Braille display device.	Uncomment the appropriate `#braille-device` line that contains the selected device. Several lines that correspond to specific device types are provided, for example: `braille-device bluetooth:address` On a single `braille-device` line, you can specify multiple, comma-separated devices. In this case, the service automatically scans the list and detects the appropriate device.