Skip to content

Commit 74f942b

Browse files
committed
update installation
1 parent 10f38d3 commit 74f942b

1 file changed

Lines changed: 9 additions & 3 deletions

File tree

INSTALLATION.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -95,12 +95,18 @@ Note that on MacOS, serial ports may appear as `/dev/tty*` *or* `/dev/cu*`. To u
9595

9696
### Linux (including Raspberry Pi OS)
9797

98-
Some Linux distributions may not include the necessary pip, venv, tkinter, Pillow or spatialite libraries by default. They may need to be installed separately, e.g. a combination of some or all of the following:
98+
Some Linux distributions may not include the necessary pip, venv, tkinter, Pillow or spatialite libraries by default. They may need to be installed separately, e.g. for Debian-based distibutions, a combination of some or all of the following:
9999

100100
```shell
101101
sudo apt install python3-pip python3-tk python3-pil python3-venv python3-pil.imagetk libjpeg-dev zlib1g-dev tk-dev libspatialite
102102
```
103103

104+
For Arch-based distributions:
105+
106+
```shell
107+
sudo pacman -S tk libspatialite
108+
```
109+
104110
⁴ Support for the sqlite3 `mod_spatialite` extension may require a custom version of Python to be [compiled from source](https://github.com/semuconsulting/PyGPSClient/blob/master/examples/python_compile.sh) if a suitable version is not available from any of the distribution's repos.
105111

106112
## <a name="userpriv">User Privileges</a>
@@ -112,10 +118,10 @@ To check and set the necessary group permissions:
112118
```shell
113119
stat /dev/ttyACM0 | grep Gid
114120
```
115-
`Access: (0660/crw-rw----) Uid: ( 0/ root) Gid: ( 20/ dialout)` <-- group in this case is `dialout`; add user to this group using usermod:
121+
`Access: (0660/crw-rw----) Uid: ( 0/ root) Gid: ( 20/ dialout)` <-- group in this case is `dialout`; add user to this group using usermod (*you may have to log out and in again for this to take effect*):
116122

117123
```shell
118-
usermod -a -G dialout myuser
124+
sudo usermod -a -G dialout myuser
119125
```
120126

121127
For Debian-based platforms, the group is normally `dialout`; on Arch-based platforms it may be `uucp` or `tty`.

0 commit comments

Comments
 (0)