Skip to content

Commit 96d0366

Browse files
committed
removed todos
1 parent fffdf20 commit 96d0366

File tree

1 file changed

+22
-22
lines changed

1 file changed

+22
-22
lines changed

README.md

Lines changed: 22 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,13 @@ A complete re-write of the old RoboBuggy. This code was run for RD23, RD24 and R
55
## Table of Contents
66
- Installation and Initial Setup
77
- Launching Code
8+
- Infrastructure Documentation
89
- Code Structure and Documentation
910

1011

1112
---
1213
## Installation and Initial Setup
1314
### Necessary + Recommended Software
14-
TODO: add explanations for what each software is for
1515
- Docker
1616
- Foxglove
1717
- VSCode (recommended)
@@ -29,12 +29,10 @@ TODO: add explanations for what each software is for
2929
### Git
3030

3131

32-
33-
## TODO: other docs which i don't know if they're necessary
3432
### Install Softwares: WSL, Ubuntu
3533
- Go to Microsoft Store to install "Ubuntu 20.04.6 LTS". TODO: is this actually necessary?
3634

37-
### Set up repo in WSL TODO: again, do we actually need wsl?
35+
### Set up repo in WSL
3836
- To set up ssh key, follow this link: [Connecting to GitHub with SSH](https://docs.github.com/en/authentication/connecting-to-github-with-ssh).
3937
- Note: Ensure that the SSH keys are generated while in the WSL terminal
4038
- 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
4644
- 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).
4745

4846

49-
## Initial Setup
50-
5147
### Clone the Repository
5248
This is so you can edit our codebase locally, and sync your changes with the rest of the team through Git.
5349
- 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.
55-
- ![image](https://github.com/CMU-Robotics-Club/RoboBuggy2/assets/116482510/8ea809f7-35f9-4517-b98d-42e2e869d233)
56-
57-
58-
### ROS
59-
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.
6651

6752

6853
### Foxglove Visualization
@@ -93,6 +78,13 @@ TODO: explain what X11 is for (i think it's only for the manual velocity updater
9378
- Then you can go in the docker container using the `docker exec -it robobuggy2-main-1 bash`.
9479
- When you are done, type Ctrl+C and use `$exit` to exit.
9580

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+
9688
### 2D Simulation
9789
- Boot up the docker container
9890
- 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
10698
- 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.
10799
- 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.
108100

109-
### Connecting to and Launching the RoboBuggy
110-
When launching the buggy:
101+
### Connecting to and Launching the RoboBuggies
102+
When launching Short Circuit:
111103
- Connect to the Wi-Fi named ShortCircuit.
112104
- In the command line window:
113105
SSH to the computer on ShortCircuit and go to folder
@@ -118,9 +110,12 @@ Then `$ cd RoboBuggy2`
118110
- Go to docker container
119111
`$ docker_exec`
120112
- 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`
122114
(wait until no longer prints “waiting for covariance to be better”)
123115

116+
When launching NAND:
117+
- WORK IN PROGRESS
118+
124119
When shutting down the buggy:
125120
- Stop roslauch
126121
`$ ^C (Ctrl+C)`
@@ -130,11 +125,16 @@ When shutting down the buggy:
130125
`$ sudo shutdown now`
131126

132127
## Documentation
128+
### Infrastructure Documentation
129+
WORK IN PROGRESS
130+
133131
### Simulator notes
134132
- 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)
136134
- INS Simulation: `/nav/odom` (nsg_msgs/Odometry) (**Noise** is implemented to vary ~1cm)
137135
Commands:
138136
- Steering angle: `/buggy/steering` in degrees (std_msgs/Float64)
139137
- Velocity: `/buggy/velocity` in m/s (std_msgs/Float64)
140138

139+
### Auton Logic
140+
WORK IN PROGRESS

0 commit comments

Comments
 (0)