Difference between revisions of "Quick Start Guide/Preparation"

From Ethersex_Wiki
Jump to: navigation, search
m
(Linux Debian / Ubuntu)
 
(7 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 20: Line 22:
 
== FreeBSD ==
 
== FreeBSD ==
 
   add gmake avr-binutils avr-gcc avr-libc  (to compile)
 
   add gmake avr-binutils avr-gcc avr-libc  (to compile)
   add gsed m4 gawk (need for ethersex), add avrdude
+
   add gsed m4 gawk (need for ethersex), add avrdude git
 
   use add_page -r PKG-NAME or use ports (goggle freebsd ports install)
 
   use add_page -r PKG-NAME or use ports (goggle freebsd ports install)
  
== Mac OSX ==
+
== 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.
  
 +
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
  
Using MacPorts (www.macports.org)
+
For newbies it is recommended to connect a LED and have that flashing by the AVR before jumping into the Ethersex adventure.
Apple Bash and sed doesn't work, you need to install Bash V4.0 and GNU sed.
 
First, sync the Port Repository to ensure that you´ll build the latest versions of the requirements.
 
  
port selfupgrade
+
Who already uses git, can skip the next step:
 +
sudo port install git-core
  
port install git-core avrdude avr-binutils avr-gcc avr-libc bash sed
+
Now install the software packages that are required by Ethersex:
 
+
sudo port install bash gsed gawk dialog
 
 
You can also use the CrossPack, but MacPorts is more straightforward and updated.
 
[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 20: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