2 # kbuild file for firmware/
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))
10 fw-external-y := $(subst ",,$(CONFIG_EXTRA_FIRMWARE))
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.
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.
23 fw-shipped-$(CONFIG_SMCTR) += tr_smctr.bin
24 fw-shipped-$(CONFIG_SND_KORG1212) += korg/k1212.dsp
25 fw-shipped-$(CONFIG_SND_MAESTRO3) += ess/maestro3_assp_kernel.fw \
26 ess/maestro3_assp_minisrc.fw
27 fw-shipped-$(CONFIG_SND_YMFPCI) += yamaha/ds1_ctrl.fw yamaha/ds1_dsp.fw \
29 fw-shipped-$(CONFIG_USB_KAWETH) += kaweth/new_code.bin kaweth/trigger_code.bin \
30 kaweth/new_code_fix.bin \
31 kaweth/trigger_code_fix.bin
33 fw-shipped-all := $(fw-shipped-y) $(fw-shipped-m) $(fw-shipped-)
35 # Directories which we _might_ need to create, so we have a rule for them.
36 firmware-dirs := $(sort $(patsubst %,$(objtree)/$(obj)/%/,$(dir $(fw-external-y) $(fw-shipped-all))))
38 quiet_cmd_mkdir = MKDIR $(patsubst $(objtree)/%,%,$@)
39 cmd_mkdir = mkdir -p $@
41 quiet_cmd_ihex = IHEX $@
42 cmd_ihex = $(OBJCOPY) -Iihex -Obinary $< $@
44 quiet_cmd_ihex2fw = IHEX2FW $@
45 cmd_ihex2fw = $(objtree)/$(obj)/ihex2fw $< $@
47 quiet_cmd_h16tofw = H16TOFW $@
48 cmd_h16tofw = $(objtree)/$(obj)/ihex2fw -w $< $@
50 quiet_cmd_fwbin = MK_FW $@
51 cmd_fwbin = FWNAME="$(patsubst firmware/%.gen.S,%,$@)"; \
52 FWSTR="$(subst /,_,$(subst .,_,$(subst -,_,$(patsubst \
53 firmware/%.gen.S,%,$@))))"; \
54 ASM_WORD=$(if $(CONFIG_64BIT),.quad,.long); \
55 ASM_ALIGN=$(if $(CONFIG_64BIT),3,2); \
56 PROGBITS=$(if $(CONFIG_ARM),%,@)progbits; \
57 echo "/* Generated by firmware/Makefile */" > $@;\
58 echo " .section .rodata" >>$@;\
59 echo " .p2align $${ASM_ALIGN}" >>$@;\
60 echo "_fw_$${FWSTR}_bin:" >>$@;\
61 echo " .incbin \"$(2)\"" >>$@;\
62 echo "_fw_end:" >>$@;\
63 echo " .section .rodata.str,\"aMS\",$${PROGBITS},1" >>$@;\
64 echo " .p2align $${ASM_ALIGN}" >>$@;\
65 echo "_fw_$${FWSTR}_name:" >>$@;\
66 echo " .string \"$$FWNAME\"" >>$@;\
67 echo " .section .builtin_fw,\"a\",$${PROGBITS}" >>$@;\
68 echo " .p2align $${ASM_ALIGN}" >>$@;\
69 echo " $${ASM_WORD} _fw_$${FWSTR}_name" >>$@;\
70 echo " $${ASM_WORD} _fw_$${FWSTR}_bin" >>$@;\
71 echo " $${ASM_WORD} _fw_end - _fw_$${FWSTR}_bin" >>$@;
73 # One of these files will change, or come into existence, whenever
74 # the configuration changes between 32-bit and 64-bit. The .S files
75 # need to change when that happens.
76 wordsize_deps := $(wildcard include/config/64bit.h include/config/32bit.h \
77 include/config/ppc32.h include/config/ppc64.h \
78 include/config/superh32.h include/config/superh64.h \
79 include/config/x86_32.h include/config/x86_64.h)
81 # Workaround for make < 3.81, where .SECONDEXPANSION doesn't work.
82 # It'll end up depending on these targets, so make them a PHONY rule which
83 # depends on _all_ the directories in $(firmware-dirs), and it'll work out OK.
84 PHONY += $(objtree)/$$(%) $(objtree)/$(obj)/$$(%)
85 $(objtree)/$$(%) $(objtree)/$(obj)/$$(%): $(firmware-dirs)
88 # For the $$(dir %) trick, where we need % to be expanded first.
91 $(patsubst %,$(obj)/%.gen.S, $(fw-shipped-y)): %: $(wordsize_deps) \
92 | $(objtree)/$$(dir %)
93 $(call cmd,fwbin,$(patsubst %.gen.S,%,$@))
94 $(patsubst %,$(obj)/%.gen.S, $(fw-external-y)): %: $(wordsize_deps) \
95 include/config/builtin/firmware/dir.h | $(objtree)/$$(dir %)
96 $(call cmd,fwbin,$(fwabs)/$(patsubst $(obj)/%.gen.S,%,$@))
98 # The .o files depend on the binaries directly; the .S files don't.
99 $(patsubst %,$(obj)/%.gen.o, $(fw-shipped-y)): %.gen.o: %
100 $(patsubst %,$(obj)/%.gen.o, $(fw-external-y)): $(obj)/%.gen.o: $(fwdir)/%
102 # .ihex is used just as a simple way to hold binary files in a source tree
103 # where binaries are frowned upon. They are directly converted with objcopy.
104 $(obj)/%: $(obj)/%.ihex | $(objtree)/$(obj)/$$(dir %)
107 # .HEX is also Intel HEX, but where the offset and length in each record
108 # is actually meaningful, because the firmware has to be loaded in a certain
109 # order rather than as a single binary blob. Thus, we convert them into our
110 # more compact binary representation of ihex records (<linux/ihex.h>)
111 $(obj)/%.fw: $(obj)/%.HEX $(obj)/ihex2fw | $(objtree)/$(obj)/$$(dir %)
114 # .H16 is our own modified form of Intel HEX, with 16-bit length for records.
115 $(obj)/%.fw: $(obj)/%.H16 $(obj)/ihex2fw | $(objtree)/$(obj)/$$(dir %)
121 obj-y += $(patsubst %,%.gen.o, $(fw-external-y))
122 obj-$(CONFIG_FIRMWARE_IN_KERNEL) += $(patsubst %,%.gen.o, $(fw-shipped-y))
124 # Remove .S files and binaries created from ihex
125 # (during 'make clean' .config isn't included so they're all in $(fw-shipped-))
126 targets := $(fw-shipped-) $(patsubst $(obj)/%,%, \
127 $(shell find $(obj) -name \*.gen.S 2>/dev/null))
129 # Without this, built-in.o won't be created when it's empty, and the
130 # final vmlinux link will fail.
133 hostprogs-y := ihex2fw