Page MenuHomegib gitb

Updated 1,144 Days AgoPublic

Getting started

  1. Install MPLAB X, the IDE. If you're asked by the installer if you also want the IPE, yes you do.
  2. Install MPLAB XC16, the C compiler for the chip in the E-Puck. XC8 or 32 will not work.
  3. Create a VCS password in /settings → VCS Password. (You can log in with GitHub to this link if necessary.)
  4. Clone the Git repository rEPUCK to somewhere in your documents. Use your Phabricator username and VCS password.
  5. On Windows, install Tiny Bootloader. On macOS, an equivalent tool is in the tool/ folder of the Git repo. This is so you can transfer your program to the e-puck.
  6. Open the MPLAB IDE and open the cloned project by selecting the e-puck.X folder inside the clone. Try building it and make sure there are no errors.

Connecting to the e-puck

First time

  1. Turn on Bluetooth on your computer. In Bluetooth settings, add the device, choose the e-puck with the correct name and enter the 4 digit device ID as the PIN.
  2. The device will connect and immediately disconnect — this is correct.
  3. Find the COM port or device identifier of the device. On Windows, find the device in network devices, properties and choose the services tab. In the right column is something like COM4 or COM6. On macOS, run \ls -1 /dev/tty.e-puck* and the identifier will be something like /dev/tty.e-puck_3356-COM1.

Transferring a program

  1. Build the code in MPLAB. This places a firmware file at e-puck.X/dist/default/production/e-puck.X.production.hex.
  2. On Windows, open Tiny Bootloader, select the firmware file in the top line and select the COM port you identified earlier in the sidebar and press the write button. On macOS, open Terminal and run /path/to/e-puck/tool/epuckupload -f /path/to/e-puck/dist/default/production/e-puck.production.hex /dev/tty.e-puck_3356-COM1 replacing the identifier at the end if necessary.
  3. When the process begins, press the reset button on the device. In Tiny Bootloader, you have 5 seconds from starting the process. On macOS, you have 30 seconds.
  4. When the program has finished transferring, it begins execution immediately. The device automatically disconnects from your computer.

Using the EPuckMonitor

  1. Download EPuckMonitor. It's the one for e-puck2 but actually works, just some of the program functionality doesn't exist on the device like RGB adjustment.
  2. Transfer the firmware necessary to use the monitor to the e-puck. Follow the instructions above, using the firmware file located at tool/firmware.hex. This is a big firmware that will take about a minute to transfer.
  3. On Windows, enter the COM port e.g. COM4. On macOS, enter the full identifier e.g. /dev/tty.e-puck_3356-COM1. Press Connect.
Last Author
Last Edited
Oct 18 2018, 1:40 PM

Event Timeline

grgarside edited the content of this document. (Show Details)
grgarside added a project: Restricted Project.
grgarside changed the visibility from "Restricted Project (Project)" to "Public (No Login Required)".