###############################################################################
# BRLTTY - A background process providing access to the console screen (when in
#          text mode) for a blind person using a refreshable braille display.
#
# Copyright (C) 1995-2025 by The BRLTTY Developers.
#
# BRLTTY comes with ABSOLUTELY NO WARRANTY.
#
# This is free software, placed under the terms of the
# GNU Lesser General Public License, as published by the Free Software
# Foundation; either version 2.1 of the License, or (at your option) any
# later version. Please see the file LICENSE-LGPL for details.
#
# Web Page: http://brltty.app/
#
# This software is maintained by Dave Mielke <dave@mielke.cc>.
###############################################################################

##############################################################
# Udev rules for giving BRLTTY access to HID braille devices #
##############################################################

#############################################################################
# BRLTTY is now able to switch to running as an unprivileged user, using    #
# only a few capabilities), and we don't want to be using CAP_DAC_OVERRIDE. #
#############################################################################

SUBSYSTEM!="hidraw", GOTO="brltty_hid_end"
ACTION!="add", GOTO="brltty_hid_end"

IMPORT{file}="/sys$devpath/../../uevent"
ENV{HID_ID}=="0005:*", GOTO="brltty_hid_bluetooth"
ATTRS{bInterfaceNumber}=="?*", GOTO="brltty_hid_usb"
GOTO="brltty_hid_end"

LABEL="brltty_hid_usb"
ENV{.BRLTTY_HID_NAME}="$attr{../product}-Intf:$attr{bInterfaceNumber}"
GOTO="brltty_hid_filter"

LABEL="brltty_hid_bluetooth"
ENV{.BRLTTY_HID_NAME}="$env{HID_NAME}"
GOTO="brltty_hid_filter"

LABEL="brltty_hid_filter"
ENV{.BRLTTY_HID_NAME}=="NLS eReader*", GOTO="brltty_hid_add"
ENV{.BRLTTY_HID_NAME}=="Brailliant BI 40X*", GOTO="brltty_hid_add"
ENV{.BRLTTY_HID_NAME}=="Brailliant BI 20X*", GOTO="brltty_hid_add"
ENV{.BRLTTY_HID_NAME}=="APH Chameleon 20*", GOTO="brltty_hid_add"
ENV{.BRLTTY_HID_NAME}=="APH Mantis Q40*", GOTO="brltty_hid_add"
ENV{.BRLTTY_HID_NAME}=="NLS eReader Humanware*", GOTO="brltty_hid_add"
ENV{.BRLTTY_HID_NAME}=="Humanware BrailleOne*", GOTO="brltty_hid_add"
GOTO="brltty_hid_end"

LABEL="brltty_hid_add"
SYMLINK+="brltty/HID-$env{.BRLTTY_HID_NAME}"
TEST=="/usr/bin/setfacl", GOTO="brltty_hid_setfacl"
GOTO="brltty_hid_end"

LABEL="brltty_hid_setfacl"
RUN+="/usr/bin/setfacl -m u:brltty:rw /dev/$name"
GOTO="brltty_hid_end"

LABEL="brltty_hid_end"
