Skip to content

Commit

Permalink
doc/getting-started: add hint for correct access rights on serial device
Browse files Browse the repository at this point in the history
  • Loading branch information
mguetschow committed Apr 19, 2024
1 parent 3ba49d5 commit e6fb623
Showing 1 changed file with 10 additions and 0 deletions.
10 changes: 10 additions & 0 deletions doc/doxygen/src/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -239,6 +239,16 @@ serial interface:
make term BOARD=samr21-xpro PORT=/dev/ttyACM1
~~~~~~~~

For flashing and accessing the board via the serial interface, the current user
needs to have the correct access rights on the serial device.
The easiest way to ensure this is to add the current user to the group that is
owning the serial device. For example, this can be achieved on Linux by issuing
the following line, logging out and logging in again:

~~~~~~~~ {.sh}
sudo usermod -aG $(stat --format="%G" /dev/ttyACM0) $USER
~~~~~~~~

Note that the `PORT` macro has a slightly different semantic in `native`. Here
it is used to provide the name of the TAP interface you want to use for the
virtualized networking capabilities of RIOT.
Expand Down

0 comments on commit e6fb623

Please sign in to comment.