STEVE_Cammast/README.md

55 lines
2.5 KiB
Markdown
Raw Normal View History

2021-04-08 13:00:24 +02:00
# STEVE
## Stereo Vision Explorer
2021-04-08 16:57:23 +02:00
[Beschreibung]
2021-04-08 13:00:24 +02:00
[Logo / Patch]()
## Setup local copy
In order to download this repository to a local machine (Desktop, Raspberry Pi) do this:
2021-04-08 13:12:02 +02:00
* Create new directory to use as a workspace: `mkdir -p ~/workspace`
Depending on framework (ROS/ROS2) move to the location where you place your packages.
* Move to directory: `cd ~/workspace`
2021-04-08 13:00:24 +02:00
* `git init`
* `git remote add origin https://egit.irs.uni-stuttgart.de/RoverLehre/STEVE_Cammast.git`
* `git fetch --all`
* `git reset --hard origin/master`
* **Important:**
Configure `.git/config` in order commit changes using your personal egit account:
```txt
[user]
name = <replace with your username>
email = <replace with your irs-email>
```
For example:
```txt
[user]
name = maxmustermann
email = max@irs.uni-stuttgart.de
```
* **Important:**
Do not upload to the `master` branch but instead create your own branch. This prevents pushing experimental code to `master`. Creating a new branch will copy your local `master` repository to your new branch:
* Create a new branch: `git branch <branch_name>`
* Move to new branch: `git ckeckout <branch_name>`
* Check content: `ls -s`
* After creating a new branch **or** changing its content you must push it to the remote repo:
* `git commit -am "new branch created"`
* `git push origin <branch_name>`
* Continue working in your local and remote branch but do not push to `master`!
2021-04-08 13:04:58 +02:00
2021-04-13 15:45:13 +02:00
## Run local copy
2021-04-13 15:50:04 +02:00
In order to run the code the steps above must be done within the ROS *catkin* workspace (eg. `~/catkin_ws/src/`). The folder *Steve* thus represents the ROS package folder.
Read the [ROS documentation](http://wiki.ros.org/catkin/workspaces) on the function of the *catkin* workspace and follow the ROS [instructions on building](http://wiki.ros.org/catkin/commands/catkin_make) your *catkin* workspace.
2021-04-13 15:43:57 +02:00
2021-04-08 13:04:58 +02:00
## Folders
* __documentation__ contains instruction material, text and pictures for documentation purposes
* __Steve__ contains the ROS package for running the Steve Camera Mast on a Raspberry Pi (3/4)
## Prerequisites
2021-04-08 16:57:23 +02:00
* The user should have read the [Design Report](Link), especially appendix A (Assembly and Installation Procedure). However, this report represents the end of the student project and is only in part still correct.
*
2021-04-08 13:14:01 +02:00
2021-04-08 13:04:58 +02:00
## How to use
% Describe how to use the package %
2021-04-15 19:55:14 +02:00
**[LINK to separate document describing software](https://egit.irs.uni-stuttgart.de/RoverLehre/STEVE_Cammast/src/branch/master/documentation/STEVE_instructions.md)**