Difference between revisions of "Swarm Robot Project Documentation"

From Mech
Jump to navigationJump to search
Line 1: Line 1:
__TOC__
__TOC__
=Getting Started=
=Getting Started=
In order to get started, you will need the following:
In order to run the system, you will need:
# e-puck robots
# e-puck robots
# [[http://hades.mech.northwestern.edu/wiki/index.php/Swarm_Project_E-puck_Code |Code for e-pucks]]
# [http://hades.mech.northwestern.edu/wiki/index.php/Swarm_Project_E-puck_Code |Compiled .hex file found in e-puck code project]
# [http://www.etc.ugal.ro/cchiculita/software/picbootloader.htm Tiny Bootloader]
# [http://www.etc.ugal.ro/cchiculita/software/picbootloader.htm Tiny Bootloader]
# [[Machine_Vision_Localization_System|Machine Vision Localization System]]
# [[Machine_Vision_Localization_System|Compiled program for Machine Vision Localization System]].
# You may also want to use one or more of the [[#Analysis_Tools|Analysis Tools]] such as the real-time display.
# You may also want to use one or more of the [[#Analysis_Tools|Analysis Tools]] such as the real-time display.

==Items needed to edit the e-puck code==
If you want to edit the e-puck code, you will need the following:
# Microchip [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en019469&part=SW007002 MPLAB] (for editing code, not needed to run)
# Microchip [http://www.microchip.com/stellent/idcplg?IdcService=SS_GET_PAGE&nodeId=1406&dDocName=en535363 C compiler for dsPICs] (for editing code, not needed to run)
# [http://hades.mech.northwestern.edu/wiki/index.php/Swarm_Project_E-puck_Code |Code for e-pucks]

==Programming the e-pucks==
To program the e-puck, y

===Setting up the e-pucks===
The e-pucks require that a special bootloader program be loaded on it if you want to program the e-puck over a bluetooth radio. If you can


=e-pucks=
=e-pucks=

Revision as of 11:46, 21 January 2009

Getting Started

In order to run the system, you will need:

  1. e-puck robots
  2. |Compiled .hex file found in e-puck code project
  3. Tiny Bootloader
  4. Compiled program for Machine Vision Localization System.
  5. You may also want to use one or more of the Analysis Tools such as the real-time display.

Items needed to edit the e-puck code

If you want to edit the e-puck code, you will need the following:

  1. Microchip MPLAB (for editing code, not needed to run)
  2. Microchip C compiler for dsPICs (for editing code, not needed to run)
  3. |Code for e-pucks

Programming the e-pucks

To program the e-puck, y

Setting up the e-pucks

The e-pucks require that a special bootloader program be loaded on it if you want to program the e-puck over a bluetooth radio. If you can

e-pucks

The e-puck is a cylindrical robot from EPFL with a diameter of 70 mm and a height of 53 mm, with a stepper motor driven wheel mounted on each side of the body. The e-puck’s size was ideal for the project, and its stepper motor driven wheels offered consistency and accuracy—highly desirable features for motion planning and dead reckoning. In order to address the requirement for wireless communication, the original extension module on the e-puck which contained peripherals including a speaker, infrared receiver, and mode selection switch, was replaced by a custom-made extension module that held an XBee radio module which connected to the serial port of the microcontroller.

Information about the e-puck can be found at http://www.e-puck.org/

e-puck code

The code on the e-puck was written in C and compiled using Microchip's MPLAB C Compiler for dsPIC DSCs (student version). The student version can be downloaded from [Microchip's website.] When you set up the project, be sure to add the linker library file (libp30F6014A-coff.a) and linker script (p30f6014A.gld) in the project.

Note that the robots will start out in 'sleep' mode. Use the 'wake' command on the visualization system to start the robots.

The documentation for the code can be found at Swarm_Project_E-puck_Code.

Packet Structure

The send and receive packets (for the XBee radios using their proprietary API mode) are different, e.g. the packet received by one PIC is not the exact copy of the packet what was sent out of the other PIC's serial port. The data frame, or payload, is unchanged, although it may be reformatted in the presence of escape characters. See the XBee manual for detailed information on XBee API packets.

Data Frame

The data frame of the packet contains the data needed for the swarm consensus estimator, as well as any additional statistics that we may wish to piggyback with the packet (for example, position and orientation data for data logging).

The data frame (in its current state) contains 15 floating point numbers. The contents are as follows:

  1. x_1
  2. w_1
  3. x_2
  4. w_2
  5. x_3
  6. w_3
  7. x_4
  8. w_4
  9. x_5
  10. w_5
  11. Robot X coordinate
  12. Robot Y coordinate
  13. Robot Theta orientation
  14. Robot left wheel speed
  15. Robot right wheel speed

Each number is a 32-bit floating point, which means that the data frame is 60 bytes long, although it could be longer if escape characters are needed (see API Operation in the XBee Manual).

XBee Radios

The XBee radio module is a low-cost, low-power (1mW) radio that uses the IEEE 802.15.4 standard (which specifies the physical layer and medium access control layer of the network) and operates on the 2.4GHz ISM frequency band. Each module contains both a RF transceiver and a microcontroller whose firmware provides a basic implementation of networking capabilities such as addressing, packet, and checksums. The radios together form a peer-to-peer network where each member of the network can broadcast messages to any other member of the network. The XBee module communicates with the PIC microcontroller on the e-puck via the serial port using the RS-232 serial data transfer protocol at 115200 bauds per second.

Due to the robust nature of the swarming algorithm, some packet loss was acceptable; packet recovery schemes were foregone in favor of simplicity and lower power consumption.

XBee Radio Configuration

The XBee radio has 20 input/output pins whose signals and functions can be found in section 1.5 in the user’s manual. The only pins that are of particular interest us are:

  • Pin 1: 3.3V Power
  • Pin 2 (output): UART Data Out
  • Pin 3 (input): UART Data In
  • Pin 10: Power Ground
  • Pin 12 (output): CTS flow control
  • Pin 16 (input): RTS flow control

The RTS and CTS signals are for flow control. When the RTS line is pulled low, the XBee module will hold any data waiting to be sent to the microcontroller in a buffer until the line is pulled high again. When the buffer is almost full, the XBee module will pull the CTS signal high.

Details about the XBee radio and its operation can be found in the user’s manual.

Two firmware options for the microcontroller are available from Digi. The first option implements a suite of networking capabilities including packets, checksums, addressing, and diagnostics; this implementation is specific to the XBee radios and not compatible with other wireless devices. The second option is a ZigBee protocol stack, which is a mesh networking standard for low data rate networks. Because routing and mesh networking capabilities were not needed for this project, the first option was used for simplicity.

The XBee module can be configured using the X-CTU terminal program from Digi, either by sending commands from the terminal or by using the configuration utility found under the “Modem Configuration” tab. For this project, each of the radios on the e-pucks were configured by typing the following commands into the terminal:

+++
atre
atmy <ID>
atap 2
atd6 1
atbd 7
atwr

where <ID> is an ID number used to differentiate the radios. The firmware on the e-puck requires that the IDs range from 0 to 31. In our case, the XBee radios on the robots were given ID numbers 1 through 8, and the base station radio was given an ID of 0.

Entering the +++ command into the terminal will make the radio enter command mode. The functions of the commands are described below:

XBee AT Commands
Command Description
ATRE Resets the radio parameters to their factory default.
ATMY <ID> Sets the ID of the radio.
ATAP 2 Enables mode 2 of the radio’s API to enable

advanced features such as packets and addressing

ATD6 1 Enables the RTS flow control pin. If this pin is pulled low,

the XBee will hold bytes to be transmitted to the microcontroller in its buffer.

ATBD 7 Sets to baud rate to 115200 bps.
ATWR Writes the new setting to non-volatile memory.

In order for the radios to be able to communicate, they must all be on the same channel and have the same network ID. If the radios experience interference from other XBee radios, the channel or network ID can be changed.

XBee Interface Extension Board

The XBee Interface Extension Board was created with Traxmaker. The extension modules plug into the e-puck via Samtec BTE-020-02-L-D-A connectors, which can be obtained directly from Samtec or one of their distributors. The Traxmaker parts library, which contains the connector and can be downloaded here: Media:Traxmaker_XBee_Lbrary.zip.

Current Version

E-puck XBee board v1.gif

The Traxmaker file for the current version of the XBee extension board can be downloaded here :Media:e-puck_xbee_board_v1.PCB. Note that the CTS and RTS pins were connected to the sel2 and sel3 pins (instead of y0 and y1) by soldering on jumper wires.


Board In Development

Epuck xbee board v2.gif

A version of the e-puck with a color sensor circuit built in can be downloaded here: Media:epuck_xbee_board_v2.PCB. This version uses a high-impedance op-amp to amplify signals from three photodiodes (for red, green, and blue), and feeds the outputs into the ADC channels formerly used by the X,Y, and Z axis accelerometers. A 10k potentiometer adjusts the sensitivity for each channel of the amplifier. The RTS flow control line on the XBee is connected to the sel3 line of the e-puck. The CTS line is not hardwired to the sel2 pin, but can easily be connected with a jumper.


Localization Vision System

A machine vision system was developed for robot localization, a la GPS. The system uses cameras and pattern recognition algorithms to track the position and orientation of various targets in a workspace, and radios the data to the respective robots. The description of the system can be found at Machine_Vision_Localization_System.

Analysis Tools

Real-time Display

Data logger

Packet Sender