Table of Contents generated with DocToc

• Eurobot Bare Module Project
  • About
    • Motivations
    • Who are we ?
  • Workspace configuration
    • Dependencies
      • Debian
      • Archlinux
        • Install yaourt
      • Install dependencies
      • OS X
    • Repository configuration
  • Build and use a module
  • How to create a new module
  • How to update a module from the bare repository
  • Copyright and License

Eurobot Bare Module Project

About

This is a bare module project from which all of our other module projects are forking from. This repository contains an example structure (based on Ladislas's Bare Arduino Project) and the common librairies (like mcp_can).

Motivations

All repositories beginning with eurobot-* are part of the Robotik UTT participation for the eurobot contest.

In order to reuse some parts every year, the robot code is splitted between independent modules.

Each module has the following minimal hardware:

• Atmega 328p with an Arduino bootloader
• MCP2551 and MCP2515 to provide a CAN Bus interface

Who are we ?

We are the Robotik UTT team. A student club of Robotics, from the University of Technology of Troyes (France).

Workspace configuration

Dependencies

• arduino: Provide arduino librairies
• avr-gcc: Compiler for atmel avr microcontrollers
• avr-libc: The standard library for atmel avr microcontrollers
• avrdude: Programmer for atmel avr microcontrollers
• binutils: Binary tools
• python-serial (with python 2 or 3): Reset arduino before programming it

Debian

# First add the git-core ppa
sudo add-apt-repository ppa:git-core/ppa

# Update list
sudo apt-get update && sudo apt-get upgrade

# Install dependencies
sudo apt-get install git arduino gcc-avr binutils avr-libc avrdude python-serial

Check that everything is up: avr-gcc -v && avrdude -v.

Archlinux

Arduino is not in the official repository, but in community-driven repositories (AUR).

Install yaourt

sudo bash -c "echo \"

[archlinuxfr]
SigLevel = Never
Server = http://repo.archlinux.fr/\\\$arch
\" >> /etc/pacman.conf"

# Update your system and programm list and install yaourt
pacman -Syu yaourt

Install dependencies

yaourt -S git arduino avrdude avr-gcc avr-binutils avr-libc python-pyserial

Check that everything is up: avr-gcc -v && avrdude -v.

OS X

• Arduino IDE 1.0.x or 1.6.x - Download the app from the website
• Homebrew - Follow the instructions on their website

brew tap osx-cross/avr
brew install avr-libc
brew install avrdude
brew install python
pip install pyserial

Check that everything is up: avr-gcc -v && avrdude -v.

Repository configuration

First cd to your repository folder:

# Update git submodules
git submodule update --init --recursive

You will have to create your platform-specific Makefile. Examples are given in the src folder. Each src/XXXX contains the source code for an Arduino: make sure that each of these folders contains it's own Makefile.

cd src/XXXX

# Copy `makefile-linux.mk` or `makefile-osx.mk` in the current directory as `Makefile`
cp ../makefile-linux.mk ./Makefile

# Edit the Makefile to suit your needs
nano Makefile

Build and use a module

TODO

How to create a new module

TODO

How to update a module from the bare repository

TODO

Copyright and License

This project is led by the Robotik UTT team. Thanks to Bare arduino project from Ladislas de Toldi for the structure.

See the LICENSE.md file