Skip to content

Commit a28df4c

Browse files
committed
Updated README about serial port permisions.
1 parent 36c0f6d commit a28df4c

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

README.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,23 @@ Debian/Ubuntu users can get pip3 using:
4949

5050
sudo apt-get install python3-pip
5151

52+
Serial Port Permissions (linux)
53+
===============================
54+
55+
Under linux, the USB serial ports are owned by root and typically have a group of dialout (for ubuntu).
56+
Different unix distros may use a slightly different group name. In order for rshell (or any terminal emulator)
57+
to access the serial port, you'll need to ensure that your user account has sufficient priviledge.
58+
One way to do this is to ensure that your user is added to the dialout group, using a command like:
59+
60+
::
61+
62+
sudo usermod -a -G dialout $USER
63+
64+
65+
Another way, is to use udev rules to modify the permissions on the serial port. There are some instructions
66+
on the [micropython wiki](https://github.com/micropython/micropython/wiki/Board-STM32F407-Discovery#programming-from-linux-via-dfu)
67+
that you can use to setup your udev rules (you don't need to install dfu-utils just to update the permissions).
68+
5269
Sample Session
5370
==============
5471

0 commit comments

Comments
 (0)