README.md

LEGO MINDSTORMS EV3 source code

Things you will need

A Linux (virtual) installation. I used Ubuntu 13.04 on VMware Workstation, but I am sure other combinations also work.
The reason for the Linux installation requirement is due to the case-sensitive filenames used by the Linux kernel source repository. Attempting to clone the source repository to a non-case sensitive file system such as Mac OSX HFS+ or Windows FAT would result in a corrupted repository.

Eclipse. I used Helios Service Release 1, but I know more recent versions will also work.

A USB to serial port dongle. You need to splice an NXT cable and hook up dig0 (pin 5) and dig1 (pin 6) to TX and RX, not 100% which way around. GND is pin 2 and 3, just pick one. The brick’s console is on port 1 and has a baud rate of 115200 8N1. I have a pre-made one with an NXT socket, it’s not actually as fancy as it sounds. A guide can be found here.

An SD card to put your custom firmware on. It doesn’t use up a lot of space, but I’d stick with a simple 2GB one

A pair of flat-nosed pliers, for removing the SD card

A Netgear WNA1100 WiFi dongle. It is currently the only WiFi dongle that is supported by the EV3’s firmware.

Getting Started

Use Git to clone this repo:

git clone https://github.com/mindboards/ev3sources.git

The scripts in the EV3 sources expect the source code to live in a projects folder in your home directory. You will need to create a projects symlink to the ev3sources folder that was created when you cloned the Git repo.

Contributing

To make changes to the source code, click on the Fork button at the top of this page. This will create a copy of this repository under your own GitHub account. You can make changes to this repository as you wish. See this page for more information about Forking.