Difference between revisions of "Quick Start Guide/Preparation"

From Ethersex_Wiki
Jump to: navigation, search
(+ArchLinux)
 
(Linux Debian / Ubuntu)
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{i18n|Quick Start Guide/Preparation}}
 
{{i18n|Quick Start Guide/Preparation}}
  
=== Download the Source from GITHUB ===
+
= Requirements =
  
You can download Ethersex from github via git protocol
+
* 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)
  
git clone git://github.com/ethersex/ethersex.git
+
<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>
  
or via http
+
== Linux Debian / Ubuntu ==
  
git clone http://github.com/ethersex/ethersex.git
+
  apt-get install gcc gcc-avr avr-libc binutils-avr m4 gawk libncurses5-dev make dialog git-core avrdude
  
Updating a local version of ethersex is possible with:
+
== Arch Linux ==
  
git pull origin
+
  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. [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.
  
=== Requirements ===
+
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
  
* AVR GCC-Compiler (Version 4.1 or higher)
+
For newbies it is recommended to connect a LED and have that flashing by the AVR before jumping into the Ethersex adventure.
* AVR LIBC (Version 1.6.8, for 128er ATMegas 1.7)
 
* GNU-Tools (Bash, Make, m4, awk)
 
* AVR-Programmer (e.g. avrdude)
 
  
 +
Who already uses git, can skip the next step:
 +
sudo port install git-core
  
== Linux Debian / Ubuntu ==
+
Now install the software packages that are required by Ethersex:
 +
sudo port install bash gsed gawk dialog
  
  apt-get install gcc-avr avr-libc binutils-avr m4 gawk libncurses5-dev make dialog git-core avrdude
+
= Download the Source from GitHub =
  
== Arch Linux ==
+
You can download Ethersex from github via git protocol
  
  pacman -Sy m4 avr-binutils avr-libc avrdude avr-gcc git gawk ncurses make perl
+
git clone git://github.com/ethersex/ethersex.git
  
== Mac OSX ==
+
or via http
  
 +
git clone http://github.com/ethersex/ethersex.git
  
Using MacPorts (www.macports.org)
+
Updating a local version of ethersex is possible with:
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
+
git pull origin
 
 
port install git-core avrdude avr-binutils avr-gcc avr-libc bash sed
 
 
 
 
 
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]
+
[[Quick_Start_Guide/Configuration | next step]]

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