So you’re ready to try out ev3dev. Great! Here are step-by-step instructions to help you get ev3dev up and running on your EV3 or Raspberry Pi.
First, here are the things you need before starting:
A way to communicate.
For the EV3, this can be one of the following:
For Raspberry Pi you can use a wired Ethernet connection first. With PiStorms the EV3 options will work too since you have a built-in screen to configure them on. With BrickPi you can also set up other connections from the console using an external screen and keyboard.
The instructions on this page only apply to releases dated December 2015 or later. Older releases are no longer supported. There are many major changes in the December release, so if something seems broken or the documentation seems incorrect, please open an issue on GitHub.
This will erase everything on your SD card! Backup your files if you do not want to lose them!
Now it’s time to write the image to the card.
Launch Etcher after it has finished installing.
Click the “Select image” button and browse to the folder where you
downloaded an ev3dev release. Select the file that you downloaded.
The release can be a
you have will work with Etcher.
Plug the SD card into your PC (if your PC doesn’t have a micro SD slot, you can use an adapter or external reader). Etcher should detect the new device and display its information under the “Select drive” step. Confirm that the selected drive is correct.
If you have multiple removable drives available, you may need to use the “Change” button to select the proper device.
When you are confident that you have selected the correct drive, click “Flash!” and wait for the operation to complete.
If you arrive at this screen, you have successfully flashed your SD card and are ready to move on to the next step.
This is for Raspberry Pi only! Users of other platforms can skip this step.
You must make some changes to
config.txt to enable support for BrickPi or
PiStorms before you put your SD card in your Raspberry Pi.
You may have to remove the SD card from your host computer and plug it back in
after flashing it in order for it to be detected. In your file browser, open
EV3DEV_BOOT. This contains a file named
in your favorite text editor and follow the instructions in the file to enable
either BrickPi or PiStorms.
Put the SD Card in your EV3 and power it on. At first, you will see the MINDSTORMS boot splash and the red LEDs will be on. This is immediately followed by the ev3dev boot splash and the LEDs changing to orange. The LEDs indicate disk (SD card) activity.
Note: If you are using Raspberry Pi hardware without a screen, just wait for the Activity LED to stop flashing, then go to the next step.
After about one minute, the screen will go blank. This happens on the first boot only. The first boot takes longer than subsequent boots because the EV3 has to create a unique SSH host ids and take care of a few other housekeeping items. After another minute or two, you will see the brickman loading… screen. If nothing has happened after five minutes, something is not right - check the troubleshooting tips below.
You will notice the number in the battery in the upper right corner. This displays the remaining voltage of the power supply. It is not possible to calculate an accurate percent value of the remaining energy, so this value is chosen. If the voltage drops below 5V the brick will turn off. All unsaved data will be lost. Keep in mind, that it may take a much longer time from 8V to 6.5V than from 6.5V down to 5V!
There are lots of choices here. Your choice depends on what type of connection you want to use and on the OS of your host computer, so pick the one that applies:
For Raspberry Pi with no display, you must use the wired Ethernet port
to connect for the first time. You can set up additional connections using the
Now that you have a network connection, you should connect to your EV3 with SSH if you haven’t done so already.
The brick can run almost all programming languages that any other Linux distro can, so your favorite language is probably supported. Language bindings have already been written for many languages. You can learn more about the available libraries here.
If the language you want isn’t listed, you still can use it, but you’ll have to do more of the heavy lifting yourself. You can look at the driver index page for information on the interfaces you need to use to control devices. Once you get the hang of it, you can even write your own interface library and have it listed here!
When you are ready to wish your EV3 goodnight, turn if off by pressing the
back button from the main menu in brickman or pressing and holding the back
button from any screen in brickman. This will open a dialog where you can select
Power Off to turn off the EV3. (Running
sudo poweroff in a terminal works too.)