You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+22-22Lines changed: 22 additions & 22 deletions
Original file line number
Diff line number
Diff line change
@@ -5,13 +5,13 @@ A complete re-write of the old RoboBuggy. This code was run for RD23, RD24 and R
5
5
## Table of Contents
6
6
- Installation and Initial Setup
7
7
- Launching Code
8
+
- Infrastructure Documentation
8
9
- Code Structure and Documentation
9
10
10
11
11
12
---
12
13
## Installation and Initial Setup
13
14
### Necessary + Recommended Software
14
-
TODO: add explanations for what each software is for
15
15
- Docker
16
16
- Foxglove
17
17
- VSCode (recommended)
@@ -29,12 +29,10 @@ TODO: add explanations for what each software is for
29
29
### Git
30
30
31
31
32
-
33
-
## TODO: other docs which i don't know if they're necessary
34
32
### Install Softwares: WSL, Ubuntu
35
33
- Go to Microsoft Store to install "Ubuntu 20.04.6 LTS". TODO: is this actually necessary?
36
34
37
-
### Set up repo in WSL TODO: again, do we actually need wsl?
35
+
### Set up repo in WSL
38
36
- To set up ssh key, follow this link: [Connecting to GitHub with SSH](https://docs.github.com/en/authentication/connecting-to-github-with-ssh).
39
37
- Note: Ensure that the SSH keys are generated while in the WSL terminal
40
38
- In the website above, see these two pages: [Generating a new SSH key and adding it to the ssh-agent](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and ["Adding a new SSH key to your GitHub account"](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account).
@@ -46,23 +44,10 @@ TODO: add explanations for what each software is for
46
44
- In the website above, see these two pages: [Generating a new SSH key and adding it to the ssh-agent](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) and ["Adding a new SSH key to your GitHub account"](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account).
47
45
48
46
49
-
## Initial Setup
50
-
51
47
### Clone the Repository
52
48
This is so you can edit our codebase locally, and sync your changes with the rest of the team through Git.
53
49
- In your terminal type: `$ git clone https://github.com/CMU-Robotics-Club/RoboBuggy2.git`.
54
-
- The clone link above is find in github: code -> local -> Clone SSH.
TODO: what is this actually doing? explain what these lines of code do
60
-
- Navigate to `/rb_ws`. This is the catkin workspace where we will be doing all our ROS stuff.
61
-
- To build the ROS workspace and source it, run:
62
-
63
-
catkin_make
64
-
source /rb_ws/devel/setup.bash # sets variables so that our package is visible to ROS commands
65
-
- To learn ROS on your own, follow the guide on https://wiki.ros.org/ROS/Tutorials. TODO: add recommendations on which aspects of ROS we use most
50
+
- The clone link above is the URL or can be found above: code -> local -> Clone HTTPS.
66
51
67
52
68
53
### Foxglove Visualization
@@ -93,6 +78,13 @@ TODO: explain what X11 is for (i think it's only for the manual velocity updater
93
78
- Then you can go in the docker container using the `docker exec -it robobuggy2-main-1 bash`.
94
79
- When you are done, type Ctrl+C and use `$exit` to exit.
95
80
81
+
### ROS
82
+
- Navigate to `/rb_ws`. This is the catkin workspace where we will be doing all our ROS stuff.
83
+
- (This should only need to be run the first time you set up the repository) - to build the ROS workspace and source it, run:
84
+
catkin_make
85
+
source /rb_ws/devel/setup.bash # sets variables so that our package is visible to ROS commands
86
+
- To learn ROS on your own, follow the guide on https://wiki.ros.org/ROS/Tutorials. TODO: add recommendations on which aspects of ROS we use most
87
+
96
88
### 2D Simulation
97
89
- Boot up the docker container
98
90
- Run `roslaunch buggy sim_2d_single.launch` to simulate 1 buggy
@@ -106,8 +98,8 @@ TODO: explain what X11 is for (i think it's only for the manual velocity updater
106
98
- To prevent topic name collision, a topic named `t` associated with buggy named `x` have format `x/t`. The names are `SC` and `Nand` in the 2 buggy simulator. In the one buggy simulator, the name can be defined as a launch arg.
107
99
- See [**Foxglove Visualization**](#foxglove-visualization) for visualizing the simulation. Beware that since topic names are user-defined, you will need to adjust the topic names in each panel.
108
100
109
-
### Connecting to and Launching the RoboBuggy
110
-
When launching the buggy:
101
+
### Connecting to and Launching the RoboBuggies
102
+
When launching Short Circuit:
111
103
- Connect to the Wi-Fi named ShortCircuit.
112
104
- In the command line window:
113
105
SSH to the computer on ShortCircuit and go to folder
@@ -118,9 +110,12 @@ Then `$ cd RoboBuggy2`
118
110
- Go to docker container
119
111
`$ docker_exec`
120
112
- Open foxglove and do local connection to “ws://192.168.1.217/8765”
121
-
- Roslauch in docker container by `$ roslaunch buggy sc-main.launch` (or `$ roslaunch buggy nand-main.launch` for NAND)
113
+
- Roslauch in docker container by `$ roslaunch buggy sc-main.launch`
122
114
(wait until no longer prints “waiting for covariance to be better”)
123
115
116
+
When launching NAND:
117
+
- WORK IN PROGRESS
118
+
124
119
When shutting down the buggy:
125
120
- Stop roslauch
126
121
`$ ^C (Ctrl+C)`
@@ -130,11 +125,16 @@ When shutting down the buggy:
130
125
`$ sudo shutdown now`
131
126
132
127
## Documentation
128
+
### Infrastructure Documentation
129
+
WORK IN PROGRESS
130
+
133
131
### Simulator notes
134
132
- Longitude + Latitude for Foxglove visualization on map: `/state/pose_navsat` (sensor_msgs/NavSatFix)
135
-
- UTM coordinates (assume we're in Zone 17T): `/sim_2d/utm` (geometry_msgs/Pose - position.x = Easting meters , position.y = Northing meters, position.z = heading in degrees from East axis + is CCW)
133
+
- UTM coordinates (assume we're in Zone 17N): `/sim_2d/utm` (geometry_msgs/Pose - position.x = Easting meters , position.y = Northing meters, position.z = heading in degrees from East axis + is CCW)
136
134
- INS Simulation: `/nav/odom` (nsg_msgs/Odometry) (**Noise** is implemented to vary ~1cm)
137
135
Commands:
138
136
- Steering angle: `/buggy/steering` in degrees (std_msgs/Float64)
139
137
- Velocity: `/buggy/velocity` in m/s (std_msgs/Float64)
0 commit comments