Quick Start Guide/Preparation

From Ethersex_Wiki
Jump to: navigation, search


  • Native GCC-Compiler (for the lxdialog utility required by make menuconfig)
  • AVR GCC-Compiler >= 4.7
  • AVR LIBC >= 1.8
  • AVR Binutils >= 2.22
  • GNU-Tools (Bash, Make, m4, awk)
  • AVR-Programmer (e.g. avrdude)

Attention: binutils 2.22 has a bug that causes the compilation of ethersex to fail. Install version 2.21 until GCC 4.7.1 has been released.

Linux Debian / Ubuntu

 apt-get install gcc gcc-avr avr-libc binutils-avr m4 gawk libncurses5-dev make dialog git-core avrdude

Arch Linux

 pacman -Sy m4 avr-binutils avr-libc avrdude avr-gcc git gawk ncurses make perl


 add gmake avr-binutils avr-gcc avr-libc  (to compile)
 add gsed m4 gawk (need for ethersex), add avrdude git
 use add_page -r PKG-NAME or use ports (goggle freebsd ports install)

Mac OS X

Before compiling Ethersex on Mac OS X additional software packages need to be installed. MacPorts are used for that. In case MacPorts are outdated, there is a guide for building the AVR toolchain manually. Using MacPorts is easier and faster.

Who already programmed and flashed an Atmel AVR has a proper working environment. Else the packages for programming an AVR need to be installed:

sudo port install avr-binutils avr-gcc avr-libc avrdude

For newbies it is recommended to connect a LED and have that flashing by the AVR before jumping into the Ethersex adventure.

Who already uses git, can skip the next step:

sudo port install git-core

Now install the software packages that are required by Ethersex:

sudo port install bash gsed gawk dialog

Download the Source from GitHub

You can download Ethersex from github via git protocol

git clone git://github.com/ethersex/ethersex.git

or via http

git clone http://github.com/ethersex/ethersex.git

Updating a local version of ethersex is possible with:

git pull origin

next step