Move README.md build instructions to wiki
This commit is contained in:
Marius Greuel
parent
47b5d1af73
commit
c71fab0889
136
README.md
136
README.md
|
|
@ -20,7 +20,7 @@ The latest version of AVRDUDE is always available here:\
|
|||
|
||||
To get AVRDUDE for Windows, install the latest version from the [Releases](http://download.savannah.gnu.org/releases/avrdude/) page.
|
||||
|
||||
Alternatively, you may [build AVRDUDE](#building-avrdude-for-windows) yourself from source.
|
||||
Alternatively, you may [build AVRDUDE](https://github.com/avrdudes/avrdude/wiki) yourself from source.
|
||||
|
||||
## Getting AVRDUDE for Linux
|
||||
|
||||
|
|
@ -30,13 +30,13 @@ To install AVRDUDE for Linux, install the package `avrdude` by running the follo
|
|||
sudo apt-get install avrdude
|
||||
```
|
||||
|
||||
Alternatively, you may [build AVRDUDE](#building-avrdude-for-linux) yourself from source.
|
||||
Alternatively, you may [build AVRDUDE](https://github.com/avrdudes/avrdude/wiki) yourself from source.
|
||||
|
||||
## Getting AVRDUDE for MacOS
|
||||
|
||||
On MacOS, AVRDUDE can be installed through Mac Ports.
|
||||
|
||||
Alternatively, you may [build AVRDUDE](#building-avrdude-for-macos) yourself from source.
|
||||
Alternatively, you may [build AVRDUDE](https://github.com/avrdudes/avrdude/wiki) yourself from source.
|
||||
|
||||
## Using AVRDUDE
|
||||
|
||||
|
|
@ -56,133 +56,5 @@ avrdude -c arduino -P COM1 -b 115200 -p atmega328p -D -U flash:w:objs/blink.hex:
|
|||
```
|
||||
|
||||
There are many different programmers and options that may be required for the programming to succeed.
|
||||
For more information, refer to the [AVRDUDE documentation](#todo).
|
||||
|
||||
## General build instructions
|
||||
|
||||
### Prerequisites
|
||||
|
||||
Depending on your requirements, the following prerequisites are
|
||||
needed:
|
||||
|
||||
* libelf including header files (for directly reading ELF files)
|
||||
* libusb 0.1 or 1.0 (or compatible), including header files
|
||||
* libftdi or libftdi1 (for direct access to FTDI devices)
|
||||
* libhidapi or libhid (for access to recent Atmel/Microchip dongles)
|
||||
|
||||
### Building
|
||||
|
||||
All source code is located in the `src/` subdirectory. Thus all
|
||||
instructions are relative to that directory.
|
||||
|
||||
Source-code releases contain an up-to-date configure script that
|
||||
can be run to generate the required Makefiles:
|
||||
|
||||
```console
|
||||
cd src && ./configure && make && sudo make install
|
||||
```
|
||||
At the end of the configure script, a configuration summary is issued,
|
||||
like this:
|
||||
|
||||
```console
|
||||
Configuration summary:
|
||||
----------------------
|
||||
DO HAVE libelf
|
||||
DO HAVE libusb
|
||||
DO HAVE libusb_1_0
|
||||
DO HAVE libftdi1
|
||||
DON'T HAVE libftdi
|
||||
DON'T HAVE libhid
|
||||
DO HAVE libhidapi
|
||||
DO HAVE pthread
|
||||
DISABLED doc
|
||||
DISABLED parport
|
||||
DISABLED linuxgpio
|
||||
DISABLED linuxspi
|
||||
```
|
||||
|
||||
Make sure all the features you are interested in have been found.
|
||||
|
||||
Building the development source tree might possibly require to
|
||||
re-generate the configure script using the autoconf/automake
|
||||
tools. This can be done using the `bootstrap` script:
|
||||
|
||||
```console
|
||||
cd src && ./bootstrap
|
||||
```
|
||||
|
||||
## Building AVRDUDE for Windows
|
||||
|
||||
### Windows Prerequisites
|
||||
|
||||
TODO.
|
||||
|
||||
### Windows Build Instructions
|
||||
|
||||
TODO.
|
||||
|
||||
## Building AVRDUDE for Linux
|
||||
|
||||
### Linux Prerequisites
|
||||
|
||||
To build AVRDUDE for Linux, you need to install the following packages:
|
||||
|
||||
```console
|
||||
sudo apt-get install build-essential git automake libtool flex bison libelf-dev libusb-dev libftdi1-dev libhidapi-dev
|
||||
```
|
||||
|
||||
To build the documentation, you need to install the following packages:
|
||||
|
||||
```console
|
||||
sudo apt-get install texlive texi2html
|
||||
```
|
||||
|
||||
### Linux Build Instructions
|
||||
|
||||
To build AVRDUDE for Linux, run the following commands:
|
||||
|
||||
```console
|
||||
git clone https://github.com/avrdudes/avrdude
|
||||
cd avrdude
|
||||
./bootstrap
|
||||
./configure
|
||||
make
|
||||
```
|
||||
|
||||
To build the documentation for AVRDUDE, run the following commands:
|
||||
|
||||
```console
|
||||
cd doc
|
||||
make all
|
||||
```
|
||||
|
||||
## Building AVRDUDE for MacOS
|
||||
|
||||
### Prerequisites
|
||||
|
||||
The following things are needed to build AVRDUDE on MacOS:
|
||||
|
||||
* a C compiler; either full XCode, or the XCode Command Line tools
|
||||
* autoconf, automake, libtool, hidapi, libftdi1, libusb, libelf;
|
||||
they can be installed e.g. from Mac Ports using
|
||||
```console
|
||||
port install autoconf automake \
|
||||
libtool hidapi libftdi1 libusb libelf
|
||||
```
|
||||
|
||||
### Compilation
|
||||
|
||||
Depending on the location of the prerequisites, the `CPPFLAGS` and
|
||||
`LDFLAGS` variables need to be set accordingly. Mac Ports installs
|
||||
everything under `/opt/local`, so use
|
||||
|
||||
```console
|
||||
./configure CPPFLAGS=-I/opt/local/include LDFLAGS=-L/opt/local/lib
|
||||
```
|
||||
|
||||
MacOS Brew requires
|
||||
|
||||
```console
|
||||
./configure CPPFLAGS=-I/usr/local/include LDFLAGS=-L/usr/local/Cellar
|
||||
```
|
||||
|
||||
For more information, refer to the [AVRDUDE documentation](http://download.savannah.gnu.org/releases/avrdude/avrdude-doc-6.4.pdf).
|
||||
|
|
|
|||
Loading…
Reference in New Issue