[[File:Neato-xv-11.jpg|thumb]]
== <span class="mw-customtoggle-0" style="font-size:small; display:inline-block; float:right;"><span class="mw-customtoggletext">[Show/hide]</span></span> Connecting to ROS ==<div id="mw-customcollapsible-0" class="mw-collapsible mw-collapsed">TextThe following procedure will help you install the Robot Operating System on Ubuntu 10.10 for use with the XV-11.
TextI have tested this running Ubuntu 10.10 as a VMware virtual machine as well as installed on a system as the booted OS. Ubuntu is a very easy to use Linux release you can download from here Now lets get started! Open a terminal by clicking on Applications -> Accessories -> Terminal Enter the following commands by copying and pasting them into the terminal window. Use CTRL-C to copy and then CTRL-SHIFT-V to paste them in the terminal window.
Textsudo sh -c ‘echo “deb http://code.ros.org/packages/ros/ubuntu maverick main” > /etc/apt/sources.list.d/ros-latest.list’wget http://code.ros.org/packages/ros.key -O - | sudo apt-key add -sudo apt-get updatesudo apt-get install ros-cturtle-baseThe last command will install approximately 5GB worth of software so grab some coffee, a Rockstar, or your stimulant of choice! Once it is done installing run the commands below to install some more ROS software in your home folder.
Textcd; mkdir ros; cd rossvn co https://brown-ros-pkg.googlecode.com/svn/tags/brown-ros-pkg/teleop_twist_keyboardsvn co http://albany-ros-pkg.googlecode.com/svn/trunk/slam_coreslam/coreslamsvn co http://albany-ros-pkg.googlecode.com/svn/trunk/neato_robotecho ‘. /opt/ros/cturtle/setup.sh’ >> ~/.bashrcecho ‘export ROS_PACKAGE_PATH=~/ros:${ROS_PACKAGE_PATH}’ >> ~/.bashrcsource ~/.bashrcsudo suecho ‘. /opt/ros/cturtle/setup.sh’ >> ~/.bashrcecho ‘export ROS_PACKAGE_PATH=${ROS_PACKAGE_PATH}’ >> ~/.bashrcexitcd ~/ros/teleop_twist_keyboard; rosmakecd ~/ros/coreslam; rosmakecd ~/ros/neato_robot; rosmakeNow we will edit the /etc/modules file so the usbserial driver will be automatically loaded with the parameters needed. We also add the cdc_acm driver to the blacklist so it will not be used with the XV-11. On a Macbook Pro the system used this driver instead of usbserial.
Textsudo suecho “usbserial vendor=0x2108 product=0x780B” >> /etc/modulesecho “blacklist cdc_acm” >> /etc/modprobe.d/blacklist.confmodprobe usbserial vendor=0x2108 product=0x780Brmmod cdc_acmexitAlmost time to plug your XV-11 into the system!! For the sake of simplicity do not plug in any other USB to serial devices at this point. This will ensure your XV-11 appears as /dev/ttyUSB0 and will simplify setup at this point.
Textls /dev/ttyU*Once you plug in the XV-11 you should see /dev/ttyUSB0 appear. Now lets load the XV-11 drivers.
Textroslaunch neato_node bringup.launchEntering the above command should initiate a connection to /dev/ttyUSB0 and after a couple seconds you will hear the LIDAR start to spin on the XV-11. Don’t worry if you don’t hear it, press CTRL-C to exit the driver then enter the command again. I have found it does not seem to start properly upon first load. Now press CTRL-SHIFT-T while your terminal window is selected to open a new tab within that terminal window, just like a new web browser tab. We will open a few of these tabs to load the different ROS drivers/programs.
Textroslaunch 2dnav_neato move_base.launch(open a new tab before running the next command)rosrun rviz rvizJust to verify, you should have three tabs open now with these three commands simultaneously running. SWEET HUH!! Now you have the GUI application running, just a couple more steps and its play time! On the top menu bar click Plugins -> Manage then click the box next to Loaded and click OK. There is a video here with details on setting up RViz. You can use this file with RViz and it has all those parameters already setup. Right click on the file and save it. Within RViz just go to File -> Open Config and select the XV11.vcg file. Now open a new terminal which we will use for keyboard control to manually navigate the XV-11.
Textrosrun teleop_twist_keyboard teleop_twist_keyboard.pyYou will see which keys are used to navigate on the screen once the program is running. The default speed settings are too fast for the XV-11 so you need to reduce the speed before it will respond to any input. Repeatedly press the “x” key to reduce speed when traveling in a straight line to about 0.10 and then do the same with the “c” key to reduce rotational speed to about 0.15. Now you can use the keyboard keys to navigate.
From this point you need to create your own map using gmapping and save the map so a map of your area is loaded when launching 2dnav_neato. gmapping needs to be modified from the base install on your system at this point to correct the reversed laser scan data. This wiki will be updated shortly with that procedure. gmapping is what will allow you to create a map of your surroundings which you will use to navigate.
</div>