Difference between revisions of "Quick Start Guide/Preparation"

From Ethersex_Wiki
Jump to: navigation, search
(binutils 2.22 bug)
(Linux Debian / Ubuntu)
 
(8 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
= Requirements =
 
= Requirements =
  
* AVR GCC-Compiler (Version 4.1 or higher)
+
* Native GCC-Compiler (for the lxdialog utility required by make menuconfig)
* AVR LIBC (Version 1.6.8, for 128er ATMegas 1.7)
+
* AVR GCC-Compiler >= 4.7
 +
* AVR LIBC >= 1.8
 +
* AVR Binutils >= 2.22
 
* GNU-Tools (Bash, Make, m4, awk)
 
* GNU-Tools (Bash, Make, m4, awk)
 
* AVR-Programmer (e.g. avrdude)
 
* 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 [http://gcc.gnu.org/bugzilla/show_bug.cgi?id=52692 GCC 4.7.1 has been released].
+
<s>'''Attention:''' binutils ''2.22'' has a bug that causes the compilation of ethersex to fail. Install version 2.21 until [http://gcc.gnu.org/bugzilla/show_bug.cgi?id=52692 GCC 4.7.1 has been released].</s>
  
 
== Linux Debian / Ubuntu ==
 
== Linux Debian / Ubuntu ==
  
   apt-get install gcc-avr avr-libc binutils-avr m4 gawk libncurses5-dev make dialog git-core avrdude  
+
   apt-get install gcc gcc-avr avr-libc binutils-avr m4 gawk libncurses5-dev make dialog git-core avrdude
  
 
== Arch Linux ==
 
== Arch Linux ==
Line 18: Line 20:
 
   pacman -Sy m4 avr-binutils avr-libc avrdude avr-gcc git gawk ncurses make perl
 
   pacman -Sy m4 avr-binutils avr-libc avrdude avr-gcc git gawk ncurses make perl
  
== Mac OSX ==
+
== 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. [http://www.macports.org MacPorts] are used for that. In case MacPorts are outdated, there is a [http://www.heise.de/ct/projekte/machmit/ctbot/wiki/AVRToolchain guide] for building the AVR toolchain manually. Using MacPorts is easier and faster.
  
Using MacPorts (www.macports.org)
+
Who already programmed and flashed an Atmel AVR has a proper working environment. Else the packages for programming an AVR need to be installed:
Apple Bash and sed doesn't work, you need to install Bash V4.0 and GNU sed.
+
sudo port install avr-binutils avr-gcc avr-libc avrdude
First, sync the Port Repository to ensure that you´ll build the latest versions of the requirements.
 
  
port selfupgrade
+
For newbies it is recommended to connect a LED and have that flashing by the AVR before jumping into the Ethersex adventure.
  
port install git-core avrdude avr-binutils avr-gcc avr-libc bash sed
+
Who already uses git, can skip the next step:
 +
sudo port install git-core
  
 
+
Now install the software packages that are required by Ethersex:
You can also use the CrossPack, but MacPorts is more straightforward and updated.
+
sudo port install bash gsed gawk dialog
[http://www.obdev.at/products/crosspack/index-de.html]
 
 
 
If the MacPort versions of avr-gcc or avrdude are too old. Here is a instuction how to build the toolchain manually: [http://www.heise.de/ct/projekte/machmit/ctbot/wiki/AVRToolchain]
 
  
 
= Download the Source from GitHub =
 
= Download the Source from GitHub =

Latest revision as of 19:15, 17 December 2017

Requirements

  • 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

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

next step