Skip to content

Commit 43edeae

Browse files
authored
Merge pull request #17 from PeterKietzmann/opt_readme
vagrant minor fixes/improvements in readme
2 parents 9b63e6e + 8e465f6 commit 43edeae

1 file changed

Lines changed: 11 additions & 2 deletions

File tree

README.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ For links go to [https://github.com/RIOT-OS/Tutorials](https://github.com/RIOT-O
77
**Quick Setup** (Using a Virtual Machine)
88

99
* Install and set up [git](https://help.github.com/articles/set-up-git/)
10-
* Install [VirtualBox 5.0](https://www.virtualbox.org/wiki/Download_Old_Builds_5_0) & [VirtualBox Extension Pack](https://www.virtualbox.org/wiki/Downloads)
10+
* Install latest [VirtualBox](https://www.virtualbox.org/wiki/Downloads) & [VirtualBox Extension Pack](https://www.virtualbox.org/wiki/Downloads) for **your system**
1111
* Install [Vagrant](https://www.vagrantup.com/downloads.html)
1212
* Linux, OSX:
1313
* `git clone --recursive https://github.com/RIOT-OS/Tutorials`
@@ -20,6 +20,7 @@ For links go to [https://github.com/RIOT-OS/Tutorials](https://github.com/RIOT-O
2020
git submodule update --init --recursive
2121
```
2222
* Change to the `RIOT` directory: `cd Tutorials/RIOT/`
23+
* In case a virtual machine is disseminated locally, adapt the path for the vagrant box `vagrant box add RIOT-VM <path to box>`
2324
* Run `vagrant up` and `vagrant ssh` afterwards. See the [Vagrant RIOT Setup](https://github.com/RIOT-OS/RIOT/blob/master/dist/tools/vagrant/README.md) for a more general explanation.
2425

2526
**Recommended Setup** (Without Using a VM)
@@ -51,12 +52,20 @@ For links go to [https://github.com/RIOT-OS/Tutorials](https://github.com/RIOT-O
5152

5253
## Troubleshooting
5354

54-
If you get the following error after running `vagrant up`
55+
### If you get the following error after running `vagrant up`
5556

5657
> The guest machine entered an invalid state while waiting for it to boot. Valid states are 'starting, running'. The machine is in the 'poweroff' state.
5758

5859
Make sure you have the [Extension Pack](https://www.virtualbox.org/wiki/Downloads) installed.
5960

61+
### If you cannot flash a connected board (`/dev/ttyXXXX` does not exist)
62+
63+
Make sure your user is a member of the usergroup `vboxusers`. On Linux you can add the current user with
64+
65+
`usermod -a -G vboxusers $USER`.
66+
67+
Note that you need to log out once to reload a Linux user's group assignments
68+
6069
## License
6170
This work and all its related code and documents are licensed under a
6271
[Creative Commons Attribution-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-sa/4.0/)

0 commit comments

Comments
 (0)