Skip to content
This repository has been archived by the owner on Sep 28, 2023. It is now read-only.

Connecting to the rover wirelessly

Jump to bottom
mdepp edited this page Feb 29, 2020 · 16 revisions

Wiring

Router (showing LEDs) PoE Injector (base station) PoE Injector (rover)

The simplest way to connect a laptop to the rover is to directly connect each to an Ethernet cable. However, it is generally more convenient to connect to the rover wirelessly. We do this using two routers, one on the rover itself and one at the base station. So our connection looks like laptop <-> station router <-> rover router <-> rover.

In detail, you will need to:

  • At the base station: Plug in the PoE injector to a wall socket. Connect the base station router Ethernet cable to the port labeled POE on the PoE injector. Connect an Ethernet cable between the laptop and the port labeled LAN on the PoE injector.
  • At the rover: Make sure the 3S battery is connected so the tx2 and router have power. Connect the tx2 to its power cable and turn it on (nominally you do this by pressing button nearest the green board once, but in practice you will probably have to mash buttons a bit before it turns on). Connect the Ethernet cable from the on-rover PoE injector to the tx2 (the router should already be connected).

Router and base station configuration

The routers are configured as follows:

  1. Base station router
  • device name: SPEAR Station
  • network mode: bridge
  • wireless mode: access point
  • ssid: SPEAR
  • ip address: 192.168.1.20
  • username/password: see the appropriate file on google drive
  1. Rover router
  • device name: SPEAR Rover
  • network mode: bridge
  • wireless mode: station
  • ssid: SPEAR
  • ip address: 192.168.1.21
  • username/password: see the appropriate file on google drive
  1. Laptop: the laptop is connected to the base station router via ethernet. In Ubuntu 18.04, make a new wired network configuration (under "Network" in settings) with IPv4 method Manual, ip address 192.168.1.<something>, and netmask 255.255.255.0. Change <something> to some number to customize your IP address to whatever you want.
  2. Rover: the rover connection functions almost identically to the base station connection. The tx2 right now contains a premade configuration (called SPEAR Station or something similar) with ip address 192.168.1.61.

Note -- Currently connecting to the rover is only tested using the Docker configuration (with the network setup done natively in Linux). You may be able to get this working in a VM but it would require configuring the wired network connection in Windows and somehow giving the VM access to it.

We plan to eventually route all communication between the rover and the base station to nimbro_topic_transport, which directly sends ros topics over a network (ros can also do this automatically but nimbro_topic_transport gives more control over the process). Currently however we just run ros nodes on both the base station (in docker) and the rover (over ssh) and use ROS_MASTER_URI to tell ros where to send the topics. To set this up,

  • At the base station, ROS_MASTER_URI should be http://192.168.1.61:11311 and ROS_IP should be the IP address of the laptop.
  • At the rover, ROS_MASTER_URI should be http://192.168.1.61:11311 and ROS_IP should be 192.168.1.61 (of course, these would change if the tx2 IP address changed).

Ideally, these environment variables should be set up by docker-compose.yml or unpack.sh. In practice, until we improve the code you should probably double-check before running things.

Setting up and running a drive test

What follows is a guide to running the necessary code on the rover to perform drive tests. This illustrates the general ideas behind connecting to the rover and running ROS nodes on it.

First, set up the physical and network configurations as described above. There is no need to redo the network configuration setup for the tx2 and the routers, so you can skip those sections.

To verify this has been done correctly, you can

  • check the LEDs on the routers, which indicate the strength of the connection between the two
  • verify your laptop's connection to the base station router, using ping 192.168.1.20
  • verify your laptop's connection to the rover router, using ping 192.168.1.21
  • verify your laptop's connection to the tx2, using ping 192.168.1.61

Now ssh into the tx2 using ssh -X nvidia@192.168.1.61 (the password is nvidia), and run tmux so we can run multiple things at once. Start a ROS master by running roscore.

At this point, if roscore displays no output or crashes with some kind of complaint about addresses, the environment variables on the rover have not been set properly. Make sure ROS_MASTER_URI and ROS_IP are set as described earlier.

Every time the tx2 reboots you will need to set up CAN. To do this, run the setup script with

/home/nvidia/Desktop/setup-can.bash

Now run everything needed for drive using

roslaunch spear_rover drive.launch

Since this launch file launches rqt_robot_steering, a GUI should appear with sliders for linear and angular velocities. You can move these sliders around to make sure the wheels work as expected.

If not, and in the absence of an obvious error in drive.launch, there is probably a firmware issue in the wheel drivers (e.g. they are not configured properly).

The rover can technically be controlled entirely by the steering GUI, but it's pretty clunky. Using a joystick is far better. To get started, plug the DualShock 3 controller into your laptop. If all four red lights on the controller are flashing, it is not connected. Press the central button to connect (once it is connected, only a single red light will be on). To verify it is connected, run ls /dev/input/js* to list all connected joysticks.

Since the joystick is connected to your laptop and not to the rover, the joystick code needs to run locally. Start up a docker container by running docker-compose run spear from the software directory. To verify the container has started correctly, you can

  • run ls /dev/input/js* to make sure the joystick is visible within the container
  • run echo $ROS_MASTER_URI and echo $ROS_IP to ensure they have been set correctly as per the previous section

Run tmux to start up tmux in the container, since it is useful for debugging. Now run roslaunch spear_rover joystick.launch. You should now be able to drive the rover around by holding down the left trigger and moving the left joystick.

If at this point the wheels don't turn, but they do turn when using the steering GUI, something has gone wrong either in the station code or in the connection to the rover. Make sure to verify the previous sections if you have not done so already. For additional debugging, you might

  • run rostopic echo /joy to see if the joystick input is being received at all
  • run rostopic echo /joy, and make sure the left trigger and horizontal/vertical axes of the left joystick map to the correct buttons/axes (if not, you will have to change some parameters in joystick.launch)
  • run rostopic echo /rover_diff_drive_controller/cmd_vel to verify that joystick inputs are being correctly translated to drive commands
  • go back to the terminal that is ssh'd into the rover and run rostopic echo /rover_diff_drive_controller/cmd_vel in that terminal to verify that the drive commands are being correctly sent over the network
Clone this wiki locally