Git-Mirrors/tillitis-key
1
0
Fork 0
mirror of https://github.com/tillitis/tillitis-key1.git synced 2024-10-01 01:45:38 -04:00
Code Issues Packages Projects Releases Wiki Activity

Add section on udev permissions to toolchain setup

Browse Source
This commit is contained in:
Matthew Mets 2023-02-16 15:10:07 +00:00 committed by Michael Cardell Widerkrantz
parent 84e2bedef5
commit 7364cd75be
No known key found for this signature in database
GPG Key ID: D3DB3DDF57E704E5
1 changed files with 31 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
doc/toolchain_setup.md
View File

@ -27,6 +27,37 @@ sudo apt install build-essential clang lld llvm bison flex libreadline-dev \
golang clang-format
```
## Device permissions
To allow sudo-less programming, you can install a udev rule that will
assign the tkey programmer, and also an unprogrammed CH552, to the
dialout group. You will also need to add your user to this group:
```
sudo cp contrib/99-tillitis.rules /etc/udev/rules.d
sudo usermod -aG dialout ${USER}
```
To apply the new group, log out and then log back in.
You can check the device permissions to determine if the group was
successfully applied. First, use lsusb to find the location of the
programmer:
```
lsusb -d cafe:4010
Bus 001 Device 023: ID cafe:4010 Blinkinlabs ICE40 programmer
```
Then, you can check the permissions by using the bus and device
number reported above. Note that this pair is ephimeral and may
change after every device insertion:
```
ls -l /dev/bus/usb/001/023
crw-rw---- 1 root dialout 189, 22 Feb 16 14:58 /dev/bus/usb/001/023
```
## Gateware: Yosys/Icestorm toolchain
If the LED of your TKey is steady white when you plug it, then the