Quick Start Guide/Preparation
Contents
Requirements
- AVR GCC-Compiler >= 4.7
- AVR LIBC >= 1.8
- 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-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
FreeBSD
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