Makefile: Set shell to /bin/bash
[librecmc/linux-libre-firmware.git] / INSTALL
1 Briefly, running "make" without specifying any targets will build
2 everything. You may not necessarily want everything though and can
3 also specify targets to make. For example:
4
5     make av7110
6
7 Please see the included Makefile for a list of all available targets.
8
9 Once the desired things are built, "make install" will put them into
10 the appropriate place, which is /lib/firmware by default although you
11 can override this with something like:
12
13     make prefix=/desired/path install
14
15 In order to build everything you will need the following on the host
16 system:
17
18     * A C/C++ compiler, like GCC
19     * Cmake
20     * dfu-util - Device Firmware Upgrade Utilities
21     * GNU Bison/YACC
22     * GNU Flex
23     * GNU Gperf
24     * GNU Make
25     * GNU Wget
26     * GNU C cross-compiler for AVR
27     * Standard C library for Atmel AVR
28     * GNU C cross-compiler for ARM:
29         - arm-linux-gnueabi-gcc
30         - arm-linux-gnueabi-ld
31         - arm-linux-gnueabi-objcopy
32         - arm-none-eabi-gcc
33         - arm-none-eabi-objcopy
34         - arm-none-eabi-as
35
36 On GNU/Linux distros that use apt you can install these with:
37
38     apt install gcc-avr avr-libc binutils-arm-linux-gnueabi \
39     binutils-arm-none-eabi bison cmake dfu-util flex g++ gcc \
40     gcc-arm-linux-gnueabi gcc-arm-none-eabi gperf make wget
41
42 CARL9170 Firmware Configuration
43 -------------------------------
44 When building the carl9170 firmware you will be prompted with
45 configuration questions.
46
47 atusb: Firmware for the ATUSB IEEE 802.15.4 USB Adapter
48 -------------------------------------------------------
49
50 To flash the firmware you need dfu-util on the host. Issue
51
52     dfu-util -d 20b7:1540 -D atusb.dfu
53
54 right after plugging the device into the USB port while the red led is
55 still on.
56
57 Refer to the included README file for more information.
58
59 Licensing
60 ---------
61
62 You can redistribute and/or modify this file under the terms of the
63 GNU General Public License as published by the Free Software
64 Foundation, either version 3 of the License, or (at your option) any
65 later version.