rosserial for VEX V5

This package contains everything needed to run rosserial on the VEX V5 Robot Brain, on the PROS 3.0.0 tooling.

Requirements

• Software:
  1. Linux (Only tested on Ubuntu 18.04LTS) (possible on windows with a Linux virtual machine, provided there is USB support)
  2. ROS installed on Linux (Only tested on ROS Melodic) - installation guide.
  3. PROS installed on Linux - installation guide
• Hardware:
  1. VEX essentials:
  2. V5 Robot Brain
  3. V5 Robot Battery
  4. MicroUSB cable

Table Of Contents

• Setup
• Examples
  • Hello World Example
• Generating Custom Messages
• Limitations
• Speed
• Troubleshooting

Setup

This setup requires knowledge of entering commands into a Linux terminal.

Note: it is possible to follow along with this guide without understanding basic ROS constructs (such as workspaces, projects, rosrun, roslaunch, and catkin_make). However, in order to work with ROS beyond the examples in this project, you will need to learn about the ROS framework itself. See the ROS documentation, getting-started, and tutorials pages for more information.

ROS Workspace

This workspace is used to generate a PROS project, and then help the Robot Brain interact with ROS using that generated project.

Notice the first source command below. This includes ROS commands into the terminal (such as catkin_make), so it will come first in most of the terminal commands in this setup process. Make sure you replace melodic with your corresponding ROS version name, if it

is not melodic (e.g. kinetic). Open up a terminal, and enter:

source /opt/ros/melodic/setup.bash
mkdir -p ~/ros-vex-workspace/src; cd ~/ros-vex-workspace/src
git clone https://github.com/ros-drivers/rosserial.git
cd ..; catkin_make; catkin_make install

Next, generate a PROS project, which has the code that runs on the Robot Brain. The project can exist anywhere (it does NOT need to be inside the ROS workspace).

source ~/ros-vex-workspace/install/setup.bash
rosrun rosserial_vex_v5 genscript.sh ~/path/to/prosproject

Examples

These examples are made to run out-of-the-box, and they made to be proof-of-concepts of what ROS can provide. ROS allows standardized messages to be sent to and from the Brain and an outside computer, which allows for all kinds of ideas and projects to be organized with messages!

To understand what is going on with the example code, look at the tutorials for the sister project, Rosserial Arduino.

Set up the physical download connection by plugging in the microUSB into the Robot Brain and into the computer.

Hello World Example

source ~/your-workspace-name/install/setup.bash
cd ~/path/to/prosproject
prosv5 make; prosv5 upload; roslaunch rosserial_vex_v5 hello_world.launch

Generating Custom Messages

To design you own ROS messages, it is necessary to add the msgs directory to this project, add the message_generation dependency, and make several modifications to this project's CMakeLists.txt. This infrastructure is removed from this project by default, because there are many useful built-in message types that are used commonly across ROS packages anyway.

See documentation and source of sister packages, such as rosserial_arduino, for more information about generating custom messages.

Platforms

This has been developed and tested on ROS melodic, but it should work on many earier/later versions as well.

Speed

Over microUSB, any message can stream at 100hz. Higher speeds (e.g. 500hz) are unstable right now.

Troubleshooting

If any part of the launching or downloading process fails, try unplugging the V5 Brain and replugging it in after 20 seconds. It is possible that the ports being used (user vs. system) got switched around, and need to reset.

This project is similar to Rosserial Arduino in usage, so refer to these tutorials for even more information.

Changelog for package rosserial_vex_v5

0.9.2 (2021-04-02)

0.9.1 (2020-09-09)

0.9.0 (2020-08-25)

• Use os.path.join for path concatenation (#495)
• Fix Travis for Noetic + Python 3
• Bump minimum CMake version to 3.7.2 (Melodic).
• Fix py3 print usages and trailing whitespaces (#469)
• Contributors: Hermann von Kleist, Mike Purvis, acxz

0.8.0 (2018-10-11)

• VEX Cortex Usage improvements and VEX V5 Support (#385)
• Contributors: CanyonTurtle

0.7.7

• README fixes
• started tagging versions
• initial was wrong version number, fixed.