Update README.md

This commit is contained in:
GLEN TURNER (8GT6)
2015-05-26 10:15:43 -04:00
parent 1825e5a5f0
commit 81f5e06b76

View File

@@ -2,36 +2,43 @@
The purpose of this project is an example of how to write a web page that can be accessed by any device on the same network as the host computer by accessing the IP of that host computer.
Here are the following requirements:
Here are the following setup requirements:
1. A roscore running
2. The IP of the machine running ROS
4. Permissions be changed on the working directory
3. apache2 up and running
3. Web Server up and running
### Quick Start Guide
To connect to a remote computer, connect to the remote master by replaceing the appropriate IP addresses as shown here:
This guide is for after you have completed the setup requirements
sudo route add 192.168.2.1 gw 192.168.0.103
export ROS_MASTER_URI=http://192.168.0.103:11311
export ROS_IP=192.168.0.101
If you are connecting to a remote computer that is running the roscore, you need to run the following lines in the terminal:
Then run the bash file in the working directory.
sudo route add 192.168.2.1 gw <your IP>
export ROS_MASTER_URI=http://<Host computer IP>:11311
export ROS_IP=<your IP>
Then run the bash file in the working directory by running the following in the terminal.
bash bashLaunchFile.bash
If you are having troubles, make sure the .bash file's permissions permit execution and make sure the working directory ("rosbridge\_GUI\_example") and all it's sub folder's permissions for "others" permit "Create and delete files" for enlcosed files and folders.
#Setup Requirements
## ROS Core
If you are either using a remote rosmaster or a local one, make sure on the computer that you are going to use to host the webpage can access and echo topics that you wish to display on the webpage.
If you are either using a remote or local rosmaster, make sure on the computer that you are going to use to host the webpage can access and echo topics that you wish to display on the webpage.
## The IP of the machine running ROS
This is required when connecting using the rosbridge
## Folder Permissions
This was a big problem for me. If you ever get errors on the page that permissions where denied, navigate to the directory above the working directory, right click on the directory that you are working in, change the permissions for all folders and sub folders so that everyone can access it.
## apache2 up and running
## Web Server up and running
There are two options for launching a web server. Python and apache2. Python is a single line run in the work directory while apache2 runs in the background.
## Python Web Server
### apache2 up and running
apache2 is used to host the webpage on your computer.
Google can help you find the install instructions which are straight forward.
@@ -62,11 +69,14 @@ And, modify that as you want.
Require all granted
</Directory>
5. Folder Permissions
This was a big problem for me. If you ever get errors on the page that permissions where denied, navigate to the directory above the working directory, right click on the directory that you are working in, change the permissions for all folders and sub folders so that everyone can access it.
3.Restart apache.
service apache2 restart
## Getting server up and running#
## Web Server up and running
Here the rosbridge\_suite that is used to link the websocket and ROS: http://wiki.ros.org/rosbridge_suite.