summaryrefslogtreecommitdiff
path: root/gnu/packages/libftdi.scm
diff options
context:
space:
mode:
Diffstat (limited to 'gnu/packages/libftdi.scm')
-rw-r--r--gnu/packages/libftdi.scm17
1 files changed, 16 insertions, 1 deletions
diff --git a/gnu/packages/libftdi.scm b/gnu/packages/libftdi.scm
index 25db26793d..279618144d 100644
--- a/gnu/packages/libftdi.scm
+++ b/gnu/packages/libftdi.scm
@@ -78,6 +78,12 @@
"/share/libftdi/examples")
(string-append #$output:python
"/share/libftdi/examples")))))
+ (add-after 'install-python-binding 'install-udev-rules
+ (lambda _
+ (install-file
+ (string-append
+ "../libftdi1-" #$version "/packages/99-libftdi.rules")
+ (string-append #$output "/lib/udev/rules.d/"))))
(add-after 'install-python-binding 'install-documentation
(lambda _
(let ((share (string-append #$output:doc "/share")))
@@ -98,6 +104,15 @@
(synopsis "FTDI USB driver with bitbang mode")
(description
"libFTDI is a library to talk to FTDI chips: FT232BM, FT245BM, FT2232C,
-FT2232D, FT245R and FT232H including the popular bitbangmode.")
+FT2232D, FT245R and FT232H including the popular bitbangmode.
+To use @code{libftdi} without root privileges it is necessary to install the
+necessary udev rules. This can be done by extending @code{udev-service-type}
+in the @code{operating-system} configuration file with this package, as in:
+@lisp
+(udev-rules-service 'libftdi libftdi #:groups '(\"plugdev\")
+@end lisp
+Additionally, the @samp{plugdev} group should be registered in the
+@code{supplementary-groups} field of your @code{user-account}
+declaration. Refer to @samp{info \"(guix) Base Services\"} for examples.")
(license (list license:gpl2 ; ftdi_eeprom, C++ bindings
license:lgpl2.1)))) ; main library