{"id":82,"date":"2017-03-31T01:01:57","date_gmt":"2017-03-31T01:01:57","guid":{"rendered":"http:\/\/sheriftolba.com\/wordpress\/?p=82"},"modified":"2026-01-02T02:15:07","modified_gmt":"2026-01-02T02:15:07","slug":"ubuntu-ros-on-beaglebone-black-bbb-rev-c","status":"publish","type":"post","link":"https:\/\/sheriftolba.com\/wordpress\/ubuntu-ros-on-beaglebone-black-bbb-rev-c\/","title":{"rendered":"ROS on Ubuntu on Beaglebone Black (BBB) Rev. C"},"content":{"rendered":"

Introduction<\/h2>\n

Beaglebone Black (BBB) is a very nice single-board PC that offers numerous features. When it comes to building robots that can do nontrivial tasks, it is my first choice. Installing an OS on the BBB and getting it ready to use can be time consuming. By following the simple steps provided in this post, large amounts of time can be saved and devoted instead to development of the software to accomplish the targeted tasks of the robot.<\/p>\n

Although BBB comes with a pre-installed copy of the Debian Jessie<\/em> Linux distribution, ROS developers do not currently\u00a0build packages for Kinetic Jessie for armhf<\/em>\u00a0architecture; they only provide builds for amd64<\/em> and arm64 \u00a0<\/em>(as mentioned\u00a0here<\/a>). \u00a0However, they have armhf builds for Ubuntu Xenial<\/em>. Because Ubuntu is my favorite Linux distribution, this was a breeze for me!<\/p>\n

I hope this post will help you save some time. Also, please don’t hesitate to share your comments and suggestions to help make this post better. I will be using it as a living document that I will always try to update to reflect best approaches reached.<\/p>\n

Installing Ubuntu Xenial on BBB<\/h2>\n

Using an SD card to flash the eMMC is easy for Windows users. An SD card \u2265 2GB is needed (I used 16GB). I will cover the necessary steps using Windows as this is what I used.<\/p>\n

    \n
  1. Get\u00a0the latest image\u00a0here<\/a>.<\/li>\n
  2. Download SD Formatter\u00a0here<\/a>\u00a0or\u00a0here<\/a>. You will need to use this if you decide to rewrite the image on the card as you’ll notice that formatting the card \u00a0the normal way results in a shrunk card size.<\/li>\n
  3. Download Win32 Disk Imager\u00a0here<\/a>. You will need this to burn the image onto the SD card.<\/li>\n
  4. Download 7-Zip\u00a0here<\/a>. You will need this to extract the .xz compression of the .img file.<\/li>\n<\/ol>\n

    Now that you’ve downloaded these files, follow the below steps to prepare your SD card for burning the image to the BBB’s eMMC.<\/p>\n

      \n
    1. Use 7-Zip to extract the compressed image. This results a .img file.<\/li>\n
    2. Open\u00a0Win32 Disk Imager, select \u00a0your BBB’s drive letter, and select your Ubunutu\u00a0.img file.<\/li>\n
    3. Once you are done, safely remove the SD card.<\/li>\n<\/ol>\n

      I would like to note here that, having read a few articles here and there during the many installs that I’ve done on the BBB, I always had the misconception that\u00a0connecting the BBB to the USB port of my laptop is not a good idea when running the install and it is better to use 5V adapter for that purpose. THIS IS NOT TRUE. Continue reading to learn what really matters to initiate a successful install.<\/p><\/blockquote>\n

      The important thing to keep in mind when starting to burn the image\u00a0on the BBB is to do the following:<\/p>\n

        \n
      1. Insert the card into the BBB. It doesn’t really matter whether it is on or off.<\/li>\n
      2. Connect the BBB to the USB port of your computer if not connected.<\/li>\n
      3. Press the reset button.\"\"<\/li>\n
      4. To tell if an install has been successfully initiated, the four user LEDs should start to light in a sweeping sequence and continue for around 20 minutes.<\/li>\n<\/ol>\n

        Sometimes, the sweeping sequence may stop after a couple of minutes and the install will fail. You will know this by observing that the LEDs will all stay on. If this happens, just redo step 3 until the sweeping persists roughly for the amount of time mentioned above.<\/p><\/blockquote>\n

        When the install finishes, the LEDs will light up steadily. You can then remove the SD card and press the restart button.<\/p>\n

        Congratulations! you have just installed Ubuntu on your BBB.<\/p>\n

        Connecting \u00a0to \u00a0BBB through Putty<\/h2>\n

        The next step is to be able to connect to the BBB through USB. Do the following:<\/p>\n

          \n
        1. Get and install Putty from here<\/a>.<\/li>\n
        2. With the BBB plugged in to the USB port of your computer, browse to your BBB’s drive, find the suitable drivers for your Windows architecture, e.g. 64-bit vs 32-bit and install them.<\/li>\n
        3. Run Putty and enter the IP address 192.168.7.2 in Host Name<\/em> \u00a0and 22 in\u00a0Port<\/em>.<\/li>\n
        4. Pick a suitable name for your session (e.g. BBB) \u00a0then click Save.<\/em><\/li>\n
        5. With the saved session selected, \u00a0click Open<\/em>.<\/li>\n
        6. A terminal will be opened and, if Ubuntu installation was successful, you will be prompted to enter a username.<\/li>\n
        7. Type ubuntu\u00a0<\/em>and hit Enter.<\/em><\/li>\n
        8. Enter temppwd<\/em> for the password.<\/li>\n
        9. You are now logged into your embedded Ubuntu instance.<\/li>\n<\/ol>\n

          You can display the release info of your Ubuntu instance using the cat<\/code> command as follows:\u00a0cat \/etc\/*release<\/code><\/p><\/blockquote>\n

          \"\"<\/a><\/p>\n

          Connecting your \u00a0BBB to the Internet \u00a0through USB<\/h2>\n

          If you try pinging 8.8.8.8 (www.google.com), you will not get any response. This is because the BBB doesn’t know how to connect to the internet through USB. Hitting Ctrl+c<\/code> will show that no packets have been received.<\/p>\n

          \"\"<\/a><\/p>\n

          To enable internet access through USB on Windows, follow these steps:<\/p>\n

          1) Bridging your network connection<\/h3>\n
            \n
          1. Go to\u00a0Control Panel\\Network and Internet\\Network Connections.<\/em><\/li>\n
          2. Identify the two adapters that represent the connection used by your computer and the one representing the BBB. In my case, these were WiFi<\/em> and Ethernet 3<\/em>, respectively. BBB’s connection will contain Linux USB Ethernet\/RNDIS Gadget<\/em> in its device description\u00a0section of the name.\"\"<\/a><\/li>\n
          3. Go to the Sharing<\/em> tab in the properties of the connection used by your computer and check Allow other users to connect through this computer’s internet connection<\/em>. \u00a0Next, select BBB’s connection from the dropdown menu.\"\"<\/a><\/li>\n
          4. Switch to the Networking<\/em> tab \u00a0and edit the Properties<\/em> of Internet Protocol Version 4 (TCP\/IPv4)<\/em> to make sure that IP and DNS server addresses are obtained automatically.\"\"<\/li>\n
          5. Repeat the previous step for BBB’s network adapter.\"\"<\/a><\/li>\n<\/ol>\n

            2) Configuring \u00a0internet connectivity on your BBB<\/h3>\n

            Now that we have created the bridge between the USB connection that connects the BBB to the computer and the one that connects the computer to the internet, it is time to configure the BBB to be able to utilize that bridge.<\/p>\n

            Switch to Putty and do the following steps:<\/p>\n

              \n
            1. Set the default gateway of your BBB to your computer’s IP address by using the command:<\/li>\n
            2. \n
              sudo \/sbin\/route add default gw 192.168.7.1<\/pre>\n<\/li>\n
            3. If you try to ping googe’s IP address (8.8.8.8) now, you should be able to receive packets.\"\"<\/li>\n
            4. To be able to use domain names instead of IP address, you need to configure the name servers in your resolve.conf<\/em>. You can do this by editing \u00a0that file and adding google’s name servers as follows:
              \n<\/a><\/li>\n
            5. \n
              sudo nano \/etc\/resolv.conf<\/pre>\n
              Add these to the file:<\/li>\n
            6. \n
              domain localdomain\nsearch localdomain\nnameserver 8.8.8.8\nnameserver 8.8.4.4<\/pre>\n<\/li>\n
            7. If you try to ping www.google.com, you will get a similar response to this:\"\"<\/a><\/li>\n<\/ol>\n
              There is a\u00a0caveat with this approach:<\/p>\n
              CAVEAT 1 – Sometimes, the bridged connection can fail and attempting to connect to the internet from the BBB will not work. This can be fixed by unchecking the\u00a0“Allow other users to connect through this computer’s internet connection” in the Sharing tab of the main connection’s settings then re-applying it and selecting the second connection from the menu.<\/p><\/blockquote>\n
              The other thing to keep in mind is that running the above steps enables internet connectivity only until the BBB is restarted. If you’d like these changes between restarts (the almost certain scenario), you need to add the commands that set the default gateway and name servers to the rc.local<\/em> file as follows:<\/p>\n
                \n
              1. \u00a0Edit the rc.local file in you favorite editor.<\/li>\n
              2. \n
                sudo nano \/etc\/rc.local<\/pre>\n<\/li>\n
              3. Add the two following lines to the end of the file.<\/li>\n
              4. \n
                # set default gateway\n\/sbin\/route add default gw 192.168.7.1 || exit 1\n\n# append nameservers to the end of the \/etc\/resolve.conf file\n# echo \"domain localdomain\\nsearch localdomain\\nnameserver 8.8.8.8\\nnameserver 8.8.4.4\" > \/etc\/resolv.conf || exit 2<\/pre>\n<\/li>\n<\/ol>\n
                Installing \u00a0ROS on Ubuntu on BBB<\/h2>\n
                Now that you are connected to the internet, you can install ROS on your Ubuntu. The following sections show you how to do this and are adapted versions from ROS’s installation instructions on Ubuntu install of ROS Kinetic<\/a> page.<\/p>\n
                1) Updating APT Configuration<\/h3>\n
                First you need to configure apt<\/code>‘s\u00a0sources list to allow it to accept packages from all kinds of repositories that Ubuntu recognizes\u00a0(Main, Universe, Restricted, and Multiverse). This can be done using the following steps:<\/p>\n
                  \n
                1. Use your favorite text editor to edit the sources.list<\/code> file:<\/li>\n
                2. \n
                  sudo nano \/etc\/apt\/sources.list<\/pre>\n<\/li>\n
                3. Add\u00a0restricted, universe, and multiverse<\/code>\u00a0after main<\/code>\u00a0to the two entries \u00a0containing Ubuntu’s release name and updates (xenial<\/code> and xenial-updates<\/code> in my case). These entries represent the URI’s of the binaries or pre-compiled packages for Xenial and its updates.\"\"<\/a><\/li>\n
                4. Save the file and quit.<\/li>\n<\/ol>\n
                  Next, ROS’s packages repository URI need to be added to sources.list<\/code>. Although this will work, it is better to use the sources.list.d<\/code> directory to add dedicated file to list ROS sources. This can be done as follows:<\/p>\n
                  sudo sh -c 'echo \"deb http:\/\/packages.ros.org\/ros\/ubuntu $(lsb_release -sc) main\" > \/etc\/apt\/sources.list.d\/ros-latest.list'<\/pre>\n
                  This command basically says: run the shell command echo<\/code>, plugging in Ubuntu’s release name in the args <\/em>section of the source’s entry and redirect the standard output to the file\u00a0ros-latest.list<\/em>.<\/p>\n
                  The last step of this configuration is to add an authentication key to apt<\/code> to make it trust the packages supplied by ROS’s repository. This can be done using this command:<\/p>\n
                  wget http:\/\/packages.ros.org\/ros.key -O - | sudo apt-key add -<\/pre>\n
                  The -O<\/code> option of wget<\/code> specifies where to direct the output of the download. By using the '-'<\/code>, we are telling it to direct it to standard output. \u00a0Similarly, the use of the\u00a0'-'<\/code> when adding the key using apt<\/code>‘s key management utility apt-key<\/code>, means read it from standard input.<\/p>\n
                  At this point, you should be ready to start the installation process for ROS …<\/p>\n
                  2) ROS Install<\/h3>\n
                  Now that package sources have been specified, we need to resynchronize\u00a0apt<\/code>‘s package index files from their sources. Run the following command:<\/p>\n
                  sudo apt-get update<\/pre>\n
                  To confirm that ROS Kinetic packages are now available and can be installed, you can search the cache as follows:<\/p>\n
                  apt-cache search ros-kinetic<\/pre>\n
                  On ROS’s Kinetic install on Ubuntu (here<\/a>) under Section 1.4 Installation, different install options based on the different needs. In my case, I selected ros-base<\/em> (bare bones) as I believe this should do the job on a BBB. If any specific packages are found to be needed later, individual install can be performed. To make sure that ros-base<\/em> is available, \u00a0you may want to run the above command piping the output to grep<\/code>.<\/p>\n
                  apt-cache search ros-kinetic | grep ros-base<\/pre>\n
                  \"\"<\/a><\/p>\n
                  You can now install\u00a0ros-kinetic-ros-base<\/em> using apt<\/code> as follows:<\/p>\n
                  sudo apt-get install ros-kinetic-ros-base<\/pre>\n
                  Congratulations!! you now have ROS Kinetic on BBB … but there are a few things that you need do before starting to play with ROS and start building robots …<\/p>\n
                  3) Initializing Some Tools<\/h3>\n
                  One of the tools you will likely\u00a0need is rosdep<\/em>, which\u00a0is a command line system dependency installation tool. It is especially useful if you are a developer and want to build packages from source. It is also required by some ROS core components. Because it has been already installed as part of ROS install, we only need to initialize it and update it to get any new definitions. To confirm it is already installed, you can run:<\/p>\n
                  rosdep --version<\/pre>\n
                  In my case, the installed version was 0.11.5. To initialize and update rosdep<\/em>, you can run the two following commands:<\/p>\n
                  sudo rosdep init\nrosdep update<\/pre>\n
                  As recommended by ros.org, it is useful to configure ROS environment variables to be automatically set on shell start. This can be done by adding the command that sources ROS’s setup.bash<\/em> to your\u00a0.bashrc.\u00a0<\/em>This can be done as follows:<\/p>\n
                  echo \"source \/opt\/ros\/kinetic\/setup.bash\" >> ~\/.bashrc\nsource ~\/.bashrc<\/pre>\n
                  The first command appends the\u00a0setup.bash<\/em> sourcing command to the end of the .bashrc<\/em> file so that it can be run at the start of every bash session. The second command sources the .bashrc<\/em> file for the current session to make it source setup.bash<\/em>.<\/p>\n
                  Another useful tool for downloading ROS package sources is rosinstall<\/em>. This can obtained using apt<\/em> as follows:<\/p>\n
                  sudo apt-get install python-rosinstall<\/pre>\n
                  References<\/h2>\n
                    \n
                  1. Nootrix: ROS Installation Made Easy<\/a><\/li>\n
                  2. ROS.org: Ubuntu install of ROS Kinetic<\/a><\/li>\n
                  3. apt-key man page<\/a><\/li>\n
                  4. Ubuntu Repositories<\/a><\/li>\n
                  5. Ubuntu Repositories\/CommandLine<\/a><\/li>\n
                  6. BeagleBoard Ubuntu<\/a><\/li>\n
                  7. ROS Answers: Incomplete packages for kinetic armhf jessie<\/a><\/li>\n
                  8. How to Connect a Beaglebone Black to the Internet via USB<\/a><\/li>\n
                  9. rosdep<\/a><\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
                    Introduction Beaglebone Black (BBB) is a very nice single-board PC that offers numerous features. When it comes to building robots that can do nontrivial tasks, it is my first choice. Installing an OS on the BBB and getting it ready to use can be time consuming. By following the simple steps provided in this post, […]<\/a><\/p>\n","protected":false},"author":1,"featured_media":87,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[41],"tags":[],"class_list":["post-82","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-technology"],"mb":[],"mfb_rest_fields":["title"],"_links":{"self":[{"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/posts\/82","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/comments?post=82"}],"version-history":[{"count":53,"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/posts\/82\/revisions"}],"predecessor-version":[{"id":679,"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/posts\/82\/revisions\/679"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/media\/87"}],"wp:attachment":[{"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/media?parent=82"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/categories?post=82"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sheriftolba.com\/wordpress\/wp-json\/wp\/v2\/tags?post=82"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}