From 6c4c8c606fd3c4b294577339173f8d824a235649 Mon Sep 17 00:00:00 2001
From: Alexandre Iooss <alexandre.iooss@ledger.fr>
Date: Thu, 21 Jul 2022 14:55:39 +0200
Subject: [PATCH] Add explanations in header

---
 20-hw1.rules      | 11 +++++++++++
 add_udev_rules.sh | 11 +++++++++++
 2 files changed, 22 insertions(+)

diff --git a/20-hw1.rules b/20-hw1.rules
index cba158d..dd3ac59 100644
--- a/20-hw1.rules
+++ b/20-hw1.rules
@@ -1,3 +1,14 @@
+# Ledger device udev rules
+#
+# You may need to place this file in /etc/udev/rules.d/ and then run
+# `udevadm control --reload` to enable non-root access to Ledger USB devices.
+#
+# Product identifiers are built using a 1-byte prefix corresponding to the device
+# then 3-bytes to identify which USB interface are activated by current device
+# application. For example "5011" corresponds to Nano S Plus with only WebUSB
+# activated.
+# Legacy product identifiers are "000[1-5]".
+
 # HW.1 / Nano
 SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="1b7c|2b7c|3b7c|4b7c", TAG+="uaccess", TAG+="udev-acl"
 # Blue
diff --git a/add_udev_rules.sh b/add_udev_rules.sh
index 3e1dc7c..6da0174 100755
--- a/add_udev_rules.sh
+++ b/add_udev_rules.sh
@@ -1,5 +1,16 @@
 #!/bin/bash
 cat <<EOF > /etc/udev/rules.d/20-hw1.rules
+# Ledger device udev rules
+#
+# You may need to place this file in /etc/udev/rules.d/ and then run
+# `udevadm control --reload` to enable non-root access to Ledger USB devices.
+#
+# Product identifiers are built using a 1-byte prefix corresponding to the device
+# then 3-bytes to identify which USB interface are activated by current device
+# application. For example "5011" corresponds to Nano S Plus with only WebUSB
+# activated.
+# Legacy product identifiers are "000[1-5]".
+
 # HW.1 / Nano
 SUBSYSTEMS=="usb", ATTRS{idVendor}=="2581", ATTRS{idProduct}=="1b7c|2b7c|3b7c|4b7c", TAG+="uaccess", TAG+="udev-acl"
 # Blue