ihex: add ihex2fw tool for converting HEX files into firmware images
[linux-2.6.git] / firmware / Makefile
1 #
2 # kbuild file for firmware/
3 #
4
5 # Create $(fwabs) from $(CONFIG_EXTRA_FIRMWARE_DIR) -- if it doesn't have a
6 # leading /, it's relative to $(srctree).
7 fwdir := $(subst ",,$(CONFIG_EXTRA_FIRMWARE_DIR))
8 fwabs := $(addprefix $(srctree)/,$(filter-out /%,$(fwdir)))$(filter /%,$(fwdir))
9
10 fw-external-y := $(subst ",,$(CONFIG_EXTRA_FIRMWARE))
11
12 # There are three cases to care about:
13 # 1. Building kernel with CONFIG_FIRMWARE_IN_KERNEL=y -- $(fw-shipped-y) should
14 #    include the firmware files to include, according to .config
15 # 2. 'make modules_install', which will install firmware for modules, and 
16 #    _also_ for the in-kernel drivers when CONFIG_FIRMWARE_IN_KERNEL=n
17 # 3. 'make firmware_install', which installs all firmware, unconditionally.
18
19 # For the former two cases we want $(fw-shipped-y) and $(fw-shipped-m) to be
20 # accurate. In the latter case it doesn't matter -- it'll use $(fw-shipped-all).
21 # But be aware that the config file might not be included at all.
22
23
24 fw-shipped-all := $(fw-shipped-y) $(fw-shipped-m) $(fw-shipped-)
25
26 # Directories which we _might_ need to create, so we have a rule for them.
27 firmware-dirs := $(sort $(patsubst %,$(objtree)/$(obj)/%/,$(dir $(fw-external-y) $(fw-shipped-all))))
28
29 quiet_cmd_mkdir = MKDIR   $(patsubst $(objtree)/%,%,$@)
30       cmd_mkdir = mkdir -p $@
31
32 quiet_cmd_ihex  = IHEX    $@
33       cmd_ihex  = $(OBJCOPY) -Iihex -Obinary $< $@
34
35 quiet_cmd_ihex2fw  = IHEX2FW $@
36       cmd_ihex2fw  = $(objtree)/$(obj)/ihex2fw $< $@
37
38 quiet_cmd_fwbin = MK_FW   $@
39       cmd_fwbin = FWNAME="$(patsubst firmware/%.gen.S,%,$@)";                \
40                   FWSTR="$(subst /,_,$(subst .,_,$(subst -,_,$(patsubst      \
41                                 firmware/%.gen.S,%,$@))))";                  \
42                   ASM_WORD=$(if $(CONFIG_64BIT),.quad,.long);                \
43                   ASM_ALIGN=$(if $(CONFIG_64BIT),3,2);                       \
44                   PROGBITS=$(if $(CONFIG_ARM),%,@)progbits;                  \
45                   echo "/* Generated by firmware/Makefile */"           > $@;\
46                   echo "    .section .rodata"                           >>$@;\
47                   echo "    .p2align $${ASM_ALIGN}"                     >>$@;\
48                   echo "_fw_$${FWSTR}_bin:"                             >>$@;\
49                   echo "    .incbin \"$(2)\""                           >>$@;\
50                   echo "_fw_end:"                                       >>$@;\
51                   echo "   .section .rodata.str,\"aMS\",$${PROGBITS},1" >>$@;\
52                   echo "    .p2align $${ASM_ALIGN}"                     >>$@;\
53                   echo "_fw_$${FWSTR}_name:"                            >>$@;\
54                   echo "    .string \"$$FWNAME\""                       >>$@;\
55                   echo "    .section .builtin_fw,\"a\",$${PROGBITS}"    >>$@;\
56                   echo "    .p2align $${ASM_ALIGN}"                     >>$@;\
57                   echo "    $${ASM_WORD} _fw_$${FWSTR}_name"            >>$@;\
58                   echo "    $${ASM_WORD} _fw_$${FWSTR}_bin"             >>$@;\
59                   echo "    $${ASM_WORD} _fw_end - _fw_$${FWSTR}_bin"   >>$@;
60
61 # One of these files will change, or come into existence, whenever
62 # the configuration changes between 32-bit and 64-bit. The .S files
63 # need to change when that happens.
64 wordsize_deps := $(wildcard include/config/64bit.h include/config/32bit.h \
65                 include/config/ppc32.h include/config/ppc64.h \
66                 include/config/superh32.h include/config/superh64.h \
67                 include/config/x86_32.h include/config/x86_64.h)
68
69 # Workaround for make < 3.81, where .SECONDEXPANSION doesn't work.
70 # It'll end up depending on these targets, so make them a PHONY rule which
71 # depends on _all_ the directories in $(firmware-dirs), and it'll work out OK.
72 PHONY += $(objtree)/$$(%) $(objtree)/$(obj)/$$(%)
73 $(objtree)/$$(%) $(objtree)/$(obj)/$$(%): $(firmware-dirs)
74         @true
75
76 # For the $$(dir %) trick, where we need % to be expanded first.
77 .SECONDEXPANSION:
78
79 $(patsubst %,$(obj)/%.gen.S, $(fw-shipped-y)): %: $(wordsize_deps) \
80                 | $(objtree)/$$(dir %)
81         $(call cmd,fwbin,$(patsubst %.gen.S,%,$@))
82 $(patsubst %,$(obj)/%.gen.S, $(fw-external-y)): %: $(wordsize_deps) \
83                 include/config/builtin/firmware/dir.h | $(objtree)/$$(dir %)
84         $(call cmd,fwbin,$(fwabs)/$(patsubst $(obj)/%.gen.S,%,$@))
85
86 # The .o files depend on the binaries directly; the .S files don't.
87 $(patsubst %,$(obj)/%.gen.o, $(fw-shipped-y)): %.gen.o: %
88 $(patsubst %,$(obj)/%.gen.o, $(fw-external-y)): $(obj)/%.gen.o: $(fwdir)/%
89
90 # .ihex is used just as a simple way to hold binary files in a source tree
91 # where binaries are frowned upon. They are directly converted with objcopy.
92 $(obj)/%: $(obj)/%.ihex | $(objtree)/$(obj)/$$(dir %)
93         $(call cmd,ihex)
94
95 # .HEX is also Intel HEX, but where the offset and length in each record
96 # is actually meaningful, because the firmware has to be loaded in a certain
97 # order rather than as a single binary blob. Thus, we convert them into our
98 # more compact binary representation of ihex records (<linux/ihex.h>)
99 $(obj)/%.fw: $(obj)/%.HEX $(obj)/ihex2fw | $(objtree)/$(obj)/$$(dir %)
100         $(call cmd,ihex2fw)
101
102 $(firmware-dirs):
103         $(call cmd,mkdir)
104
105 obj-y                            += $(patsubst %,%.gen.o, $(fw-external-y))
106 obj-$(CONFIG_FIRMWARE_IN_KERNEL) += $(patsubst %,%.gen.o, $(fw-shipped-y))
107
108 # Remove .S files and binaries created from ihex
109 # (during 'make clean' .config isn't included so they're all in $(fw-shipped-))
110 targets := $(fw-shipped-) $(patsubst $(obj)/%,%, \
111                                 $(shell find $(obj) -name \*.gen.S 2>/dev/null))
112
113 # Without this, built-in.o won't be created when it's empty, and the
114 # final vmlinux link will fail.
115 obj-n := dummy
116
117 hostprogs-y := ihex2fw