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 fw-shipped-$(CONFIG_DVB_TTUSB_BUDGET) += ttusb-budget/dspbootcode.bin
  24 fw-shipped-$(CONFIG_SMCTR) += tr_smctr.bin
  25 fw-shipped-$(CONFIG_SND_KORG1212) += korg/k1212.dsp
  26 fw-shipped-$(CONFIG_SND_MAESTRO3) += ess/maestro3_assp_kernel.fw \
  27                                      ess/maestro3_assp_minisrc.fw
  28 fw-shipped-$(CONFIG_SND_YMFPCI) += yamaha/ds1_ctrl.fw yamaha/ds1_dsp.fw \
  29                                    yamaha/ds1e_ctrl.fw
  30 fw-shipped-$(CONFIG_USB_EMI26) += emi26/loader.fw emi26/firmware.fw \
  31                                   emi26/bitstream.fw
  32 fw-shipped-$(CONFIG_USB_EMI62) += emi62/loader.fw emi62/bitstream.fw \
  33                                   emi62/spdif.fw emi62/midi.fw
  34 fw-shipped-$(CONFIG_USB_KAWETH) += kaweth/new_code.bin kaweth/trigger_code.bin \
  35                                    kaweth/new_code_fix.bin \
  36                                    kaweth/trigger_code_fix.bin
  37 ifdef CONFIG_FIRMWARE_IN_KERNEL
  38 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_MPR) += keyspan/mpr.fw
  39 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA18X) += keyspan/usa18x.fw
  40 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA19) += keyspan/usa19.fw
  41 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA19QI) += keyspan/usa19qi.fw
  42 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA19QW) += keyspan/usa19qw.fw
  43 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA19W) += keyspan/usa19w.fw
  44 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA28) += keyspan/usa28.fw
  45 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA28XA) += keyspan/usa28xa.fw
  46 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA28XB) += keyspan/usa28xb.fw
  47 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA28X) += keyspan/usa28x.fw
  48 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA49W) += keyspan/usa49w.fw
  49 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_USA49WLC) += keyspan/usa49wlc.fw
  50 else
  51 fw-shipped- := keyspan/mpr.fw keyspan/usa18x.fw keyspan/usa19.fw        \
  52         keyspan/usa19qi.fw keyspan/usa19qw.fw keyspan/usa19w.fw         \
  53         keyspan/usa28.fw keyspan/usa28xa.fw keyspan/usa28xb.fw          \
  54         keyspan/usa28x.fw keyspan/usa49w.fw keyspan/usa49wlc.fw
  55 endif
  56 fw-shipped-$(CONFIG_USB_SERIAL_KEYSPAN_PDA) += keyspan_pda/keyspan_pda.fw
  57 fw-shipped-$(CONFIG_USB_SERIAL_XIRCOM) += keyspan_pda/xircom_pgs.fw
  58
  59 fw-shipped-all := $(fw-shipped-y) $(fw-shipped-m) $(fw-shipped-)
  60
  61 # Directories which we _might_ need to create, so we have a rule for them.
  62 firmware-dirs := $(sort $(patsubst %,$(objtree)/$(obj)/%/,$(dir $(fw-external-y) $(fw-shipped-all))))
  63
  64 quiet_cmd_mkdir = MKDIR   $(patsubst $(objtree)/%,%,$@)
  65       cmd_mkdir = mkdir -p $@
  66
  67 quiet_cmd_ihex  = IHEX    $@
  68       cmd_ihex  = $(OBJCOPY) -Iihex -Obinary $< $@
  69
  70 quiet_cmd_ihex2fw  = IHEX2FW $@
  71       cmd_ihex2fw  = $(objtree)/$(obj)/ihex2fw $< $@
  72
  73 quiet_cmd_h16tofw  = H16TOFW $@
  74       cmd_h16tofw  = $(objtree)/$(obj)/ihex2fw -w $< $@
  75
  76 quiet_cmd_fwbin = MK_FW   $@
  77       cmd_fwbin = FWNAME="$(patsubst firmware/%.gen.S,%,$@)";                \
  78                   FWSTR="$(subst /,_,$(subst .,_,$(subst -,_,$(patsubst      \
  79                                 firmware/%.gen.S,%,$@))))";                  \
  80                   ASM_WORD=$(if $(CONFIG_64BIT),.quad,.long);                \
  81                   ASM_ALIGN=$(if $(CONFIG_64BIT),3,2);                       \
  82                   PROGBITS=$(if $(CONFIG_ARM),%,@)progbits;                  \
  83                   echo "/* Generated by firmware/Makefile */"           > $@;\
  84                   echo "    .section .rodata"                           >>$@;\
  85                   echo "    .p2align $${ASM_ALIGN}"                     >>$@;\
  86                   echo "_fw_$${FWSTR}_bin:"                             >>$@;\
  87                   echo "    .incbin \"$(2)\""                           >>$@;\
  88                   echo "_fw_end:"                                       >>$@;\
  89                   echo "   .section .rodata.str,\"aMS\",$${PROGBITS},1" >>$@;\
  90                   echo "    .p2align $${ASM_ALIGN}"                     >>$@;\
  91                   echo "_fw_$${FWSTR}_name:"                            >>$@;\
  92                   echo "    .string \"$$FWNAME\""                       >>$@;\
  93                   echo "    .section .builtin_fw,\"a\",$${PROGBITS}"    >>$@;\
  94                   echo "    .p2align $${ASM_ALIGN}"                     >>$@;\
  95                   echo "    $${ASM_WORD} _fw_$${FWSTR}_name"            >>$@;\
  96                   echo "    $${ASM_WORD} _fw_$${FWSTR}_bin"             >>$@;\
  97                   echo "    $${ASM_WORD} _fw_end - _fw_$${FWSTR}_bin"   >>$@;
  98
  99 # One of these files will change, or come into existence, whenever
 100 # the configuration changes between 32-bit and 64-bit. The .S files
 101 # need to change when that happens.
 102 wordsize_deps := $(wildcard include/config/64bit.h include/config/32bit.h \
 103                 include/config/ppc32.h include/config/ppc64.h \
 104                 include/config/superh32.h include/config/superh64.h \
 105                 include/config/x86_32.h include/config/x86_64.h)
 106
 107 # Workaround for make < 3.81, where .SECONDEXPANSION doesn't work.
 108 # It'll end up depending on these targets, so make them a PHONY rule which
 109 # depends on _all_ the directories in $(firmware-dirs), and it'll work out OK.
 110 PHONY += $(objtree)/$$(%) $(objtree)/$(obj)/$$(%)
 111 $(objtree)/$$(%) $(objtree)/$(obj)/$$(%): $(firmware-dirs)
 112         @true
 113
 114 # For the $$(dir %) trick, where we need % to be expanded first.
 115 .SECONDEXPANSION:
 116
 117 $(patsubst %,$(obj)/%.gen.S, $(fw-shipped-y)): %: $(wordsize_deps) \
 118                 | $(objtree)/$$(dir %)
 119         $(call cmd,fwbin,$(patsubst %.gen.S,%,$@))
 120 $(patsubst %,$(obj)/%.gen.S, $(fw-external-y)): %: $(wordsize_deps) \
 121                 include/config/builtin/firmware/dir.h | $(objtree)/$$(dir %)
 122         $(call cmd,fwbin,$(fwabs)/$(patsubst $(obj)/%.gen.S,%,$@))
 123
 124 # The .o files depend on the binaries directly; the .S files don't.
 125 $(patsubst %,$(obj)/%.gen.o, $(fw-shipped-y)): %.gen.o: %
 126 $(patsubst %,$(obj)/%.gen.o, $(fw-external-y)): $(obj)/%.gen.o: $(fwdir)/%
 127
 128 # .ihex is used just as a simple way to hold binary files in a source tree
 129 # where binaries are frowned upon. They are directly converted with objcopy.
 130 $(obj)/%: $(obj)/%.ihex | $(objtree)/$(obj)/$$(dir %)
 131         $(call cmd,ihex)
 132
 133 # .HEX is also Intel HEX, but where the offset and length in each record
 134 # is actually meaningful, because the firmware has to be loaded in a certain
 135 # order rather than as a single binary blob. Thus, we convert them into our
 136 # more compact binary representation of ihex records (<linux/ihex.h>)
 137 $(obj)/%.fw: $(obj)/%.HEX $(obj)/ihex2fw | $(objtree)/$(obj)/$$(dir %)
 138         $(call cmd,ihex2fw)
 139
 140 # .H16 is our own modified form of Intel HEX, with 16-bit length for records.
 141 $(obj)/%.fw: $(obj)/%.H16 $(obj)/ihex2fw | $(objtree)/$(obj)/$$(dir %)
 142         $(call cmd,h16tofw)
 143
 144 $(firmware-dirs):
 145         $(call cmd,mkdir)
 146
 147 obj-y                            += $(patsubst %,%.gen.o, $(fw-external-y))
 148 obj-$(CONFIG_FIRMWARE_IN_KERNEL) += $(patsubst %,%.gen.o, $(fw-shipped-y))
 149
 150 # Remove .S files and binaries created from ihex
 151 # (during 'make clean' .config isn't included so they're all in $(fw-shipped-))
 152 targets := $(fw-shipped-) $(patsubst $(obj)/%,%, \
 153                                 $(shell find $(obj) -name \*.gen.S 2>/dev/null))
 154
 155 # Without this, built-in.o won't be created when it's empty, and the
 156 # final vmlinux link will fail.
 157 obj-n := dummy
 158
 159 hostprogs-y := ihex2fw