Skip to content

Commit 1861b2d

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

File tree

1 file changed

+16
-0
lines changed

1 file changed

+16
-0
lines changed

README.rst

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,22 @@ 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+
sudo usermod -a -G dialout $USER
62+
63+
64+
Another way, is to use udev rules to modify the permissions on the serial port. There are some instructions
65+
on the [micropython wiki](https://github.com/micropython/micropython/wiki/Board-STM32F407-Discovery#programming-from-linux-via-dfu)
66+
that you can use to setup your udev rules (you don't need to install dfu-utils just to update the permissions).
67+
5268
Sample Session
5369
==============
5470

0 commit comments

Comments
 (0)