Fix a typo in the comment and add a (somewhat vague) description of the values returned.
[kugel-rb/myfork.git] / tools / root.make
blob49f6a7fdbc3109922f8a232dd587c030350897ff
1 # __________ __ ___.
2 # Open \______ \ ____ ____ | | _\_ |__ _______ ___
3 # Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
4 # Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
5 # Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
6 # \/ \/ \/ \/ \/
7 # $Id$
10 include $(TOOLSDIR)/functions.make
12 DEFINES = -DROCKBOX -DMEMORYSIZE=$(MEMORYSIZE) -DMEM=$(MEMORYSIZE) $(TARGET) \
13 -DTARGET_ID=$(TARGET_ID) -DTARGET_NAME=\"$(MODELNAME)\" \
14 -DAPPSVERSION=\"$(VERSION)\" $(BUILDDATE) \
15 $(EXTRA_DEFINES) # <-- -DSIMULATOR or not
16 INCLUDES = -I$(BUILDDIR) -I$(BUILDDIR)/lang $(TARGET_INC)
18 CFLAGS = $(INCLUDES) $(DEFINES) $(GCCOPTS)
19 PPCFLAGS = $(filter-out -Dmain=SDL_main,$(CFLAGS)) # cygwin sdl-config fix
21 TOOLS = $(TOOLSDIR)/rdf2binary $(TOOLSDIR)/convbdf \
22 $(TOOLSDIR)/codepages $(TOOLSDIR)/scramble $(TOOLSDIR)/bmp2rb \
23 $(TOOLSDIR)/uclpack $(TOOLSDIR)/mktccboot $(TOOLSDIR)/mkboot
25 RBINFO = $(BUILDDIR)/rockbox-info.txt
27 # list suffixes to be understood by $*
28 .SUFFIXES: .rock .codec .map .elf .c .S .o .bmp .a
30 .PHONY: all clean tags zip tools manual bin build info langs
32 ifeq (,$(filter clean veryclean reconf tags voice voicetools manual manual-pdf manual-html manual-zhtml manual-txt manual-ztxt manual-zip help fontzip ,$(MAKECMDGOALS)))
33 # none of the above
34 DEPFILE = $(BUILDDIR)/make.dep
36 endif
38 all: $(DEPFILE) build
40 # Subdir makefiles. their primary purpose is to populate SRC & OTHER_SRC
41 # but they also define special dependencies and compile rules
42 include $(TOOLSDIR)/tools.make
43 include $(FIRMDIR)/firmware.make
44 include $(ROOTDIR)/apps/bitmaps/bitmaps.make
46 ifneq (,$(findstring bootloader,$(APPSDIR)))
47 include $(APPSDIR)/bootloader.make
48 else ifneq (,$(findstring bootbox,$(APPSDIR)))
49 BOOTBOXLDOPTS = -Wl,--gc-sections
50 include $(APPSDIR)/bootbox.make
51 else
52 include $(APPSDIR)/apps.make
53 include $(APPSDIR)/lang/lang.make
55 ifdef SOFTWARECODECS
56 include $(APPSDIR)/codecs/codecs.make
57 endif
59 ifdef ENABLEDPLUGINS
60 include $(APPSDIR)/plugins/bitmaps/pluginbitmaps.make
61 include $(APPSDIR)/plugins/plugins.make
62 endif
64 ifdef SIMVER
65 include $(ROOTDIR)/uisimulator/uisimulator.make
66 endif
67 endif # bootloader
69 OBJ := $(SRC:.c=.o)
70 OBJ := $(OBJ:.S=.o)
71 OBJ += $(BMP:.bmp=.o)
72 OBJ := $(subst $(ROOTDIR),$(BUILDDIR),$(OBJ))
74 build: $(TOOLS) $(BUILDDIR)/$(BINARY) $(CODECS) $(ROCKS) $(ARCHOSROM) $(RBINFO)
76 $(RBINFO): $(BUILDDIR)/$(BINARY)
77 $(SILENT)echo Creating $(@F)
78 $(SILENT)$(TOOLSDIR)/mkinfo.pl $@
80 $(DEPFILE) dep:
81 $(call PRINTS,Generating dependencies)
82 @echo foo > /dev/null # there must be a "real" command in the rule
83 $(call mkdepfile,$(DEPFILE),$(SRC))
84 $(call mkdepfile,$(DEPFILE),$(OTHER_SRC))
85 @mv $(DEPFILE)_ $(DEPFILE)
86 $(call bmpdepfile,$(DEPFILE),$(BMP) $(PBMP))
88 bin: $(DEPFILE) $(TOOLS) $(BUILDDIR)/$(BINARY)
89 rocks: $(DEPFILE) $(TOOLS) $(ROCKS)
90 codecs: $(DEPFILE) $(TOOLS) $(CODECS)
91 tools: $(TOOLS)
93 -include $(DEPFILE)
95 veryclean: clean
96 $(SILENT)rm -rf $(TOOLS)
98 clean:
99 $(SILENT)echo Cleaning build directory
100 $(SILENT)rm -rf rockbox.zip rockbox.7z rockbox.tar rockbox.tar.gz \
101 rockbox.tar.bz2 TAGS apps firmware comsim sim lang \
102 manual *.pdf *.a credits.raw rockbox.ipod bitmaps \
103 pluginbitmaps UI256.bmp rockbox-full.zip html txt \
104 rockbox-manual*.zip sysfont.h rockbox-info.txt voicefontids \
105 *.wav *.mp3 *.voice $(CLEANOBJS) \
106 $(LINKRAM) $(LINKROM) rockbox.elf rockbox.map rockbox.bin \
107 make.dep rombox.elf rombox.map rombox.bin rombox.ucl romstart.txt \
108 $(BINARY) $(FLASHFILE) uisimulator bootloader flash $(BOOTLINK)
110 #### linking the binaries: ####
112 .SECONDEXPANSION:
114 ifeq (,$(findstring bootloader,$(APPSDIR)))
115 # not bootloader
117 OBJ += $(LANG_O)
119 ifndef SIMVER
121 ## target build
122 RAMLDS := $(FIRMDIR)/target/$(CPU)/$(MANUFACTURER)/app.lds
123 LINKRAM := $(BUILDDIR)/ram.link
124 ROMLDS := $(FIRMDIR)/rom.lds
125 LINKROM := $(BUILDDIR)/rom.link
128 $(LINKRAM): $(RAMLDS)
129 $(call PRINTS,PP $(@F))
130 $(call preprocess2file,$<,$@,-DLOADADDRESS=$(LOADADDRESS))
132 $(LINKROM): $(ROMLDS)
133 $(call PRINTS,PP $(@F))
134 $(call preprocess2file,$<,$@,-DLOADADDRESS=$(LOADADDRESS))
136 $(BUILDDIR)/rockbox.elf : $$(OBJ) $$(FIRMLIB) $$(VOICESPEEXLIB) $$(LINKRAM)
137 $(call PRINTS,LD $(@F))$(CC) $(GCCOPTS) -Os -nostdlib -o $@ $(OBJ) \
138 -L$(BUILDDIR)/firmware -lfirmware \
139 -L$(BUILDDIR)/apps/codecs $(VOICESPEEXLIB:lib%.a=-l%) \
140 -lgcc $(BOOTBOXLDOPTS) \
141 -T$(LINKRAM) -Wl,-Map,$(BUILDDIR)/rockbox.map
143 $(BUILDDIR)/rombox.elf : $$(OBJ) $$(FIRMLIB) $$(VOICESPEEXLIB) $$(LINKROM)
144 $(call PRINTS,LD $(@F))$(CC) $(GCCOPTS) -Os -nostdlib -o $@ $(OBJ) \
145 $(VOICESPEEXLIB) $(FIRMLIB) -lgcc -L$(BUILDDIR)/firmware \
146 -T$(LINKROM) -Wl,-Map,$(BUILDDIR)/rombox.map
148 $(BUILDDIR)/rockbox.bin : $(BUILDDIR)/rockbox.elf
149 $(call PRINTS,OC $(@F))$(OC) $(if $(filter yes, $(USE_ELF)), -S -x, -O binary) $< $@
151 $(BUILDDIR)/rombox.bin : $(BUILDDIR)/rombox.elf
152 $(call PRINTS,OC $(@F))$(OC) -O binary $< $@
155 # If there's a flashfile defined for this target (rockbox.ucl for Archos
156 # models) Then check if the mkfirmware script fails, as then it is (likely)
157 # because the image is too big and we need to create a compressed image
158 # instead.
160 $(BUILDDIR)/$(BINARY) : $(BUILDDIR)/rockbox.bin $(FLASHFILE)
161 $(call PRINTS,SCRAMBLE $(notdir $@))($(MKFIRMWARE) $< $@; \
162 stat=$$?; \
163 if test -n "$(FLASHFILE)"; then \
164 if test "$$stat" -ne 0; then \
165 echo "Image too big, making a compressed version!"; \
166 $(MAKE) -C $(FIRMDIR)/decompressor OBJDIR=$(BUILDDIR)/firmware/decompressor; \
167 $(MKFIRMWARE) $(BUILDDIR)/firmware/decompressor/compressed.bin $@; \
168 fi \
169 fi )
171 # archos
172 $(BUILDDIR)/rockbox.ucl: $(BUILDDIR)/rockbox.bin
173 $(call PRINTS,UCLPACK $(@F))$(TOOLSDIR)/uclpack --best --2e -b1048576 $< $@ >/dev/null
175 MAXINFILE = $(BUILDDIR)/temp.txt
176 MAXOUTFILE = $(BUILDDIR)/romstart.txt
178 $(BUILDDIR)/rombox.ucl: $(BUILDDIR)/rombox.bin $(MAXOUTFILE)
179 $(call PRINTS,UCLPACK $(@F))$(TOOLSDIR)/uclpack --none $< $@ >/dev/null; \
180 perl $(TOOLSDIR)/romsizetest.pl `cat $(MAXOUTFILE)` $<; \
181 if test $$? -ne 0; then \
182 echo "removing UCL file again, making it a fake one"; \
183 echo "fake" > $@; \
186 $(MAXOUTFILE):
187 $(call PRINTS,Creating $(@F))
188 $(SILENT)$(shell echo '#include "config.h"' > $(MAXINFILE))
189 $(SILENT)$(shell echo "ROM_START" >> $(MAXINFILE))
190 $(call preprocess2file,$(MAXINFILE),$(MAXOUTFILE))
191 $(SILENT)rm $(MAXINFILE)
193 # iriver
194 $(BUILDDIR)/rombox.iriver: $(BUILDDIR)/rombox.bin
195 $(call PRINTS,Build ROM file)$(MKFIRMWARE) $< $@
197 endif # !SIMVER
198 endif # !bootloader
201 voicetools:
202 $(SILENT)$(MAKE) -C $(TOOLSDIR) CC=$(HOSTCC) AR=$(HOSTAR) rbspeexenc voicefont wavtrim
204 tags:
205 $(SILENT)rm -f TAGS
206 $(SILENT)etags -o $(BUILDDIR)/TAGS $(filter-out %.o,$(SRC) $(OTHER_SRC))
208 fontzip:
209 $(SILENT)$(TOOLSDIR)/buildzip.pl $(VERBOSEOPT) -m \"$(MODELNAME)\" -r "$(ROOTDIR)" --rbdir="$(RBDIR)" -f 1 -o rockbox-fonts.zip $(TARGET) $(BINARY)
211 zip:
212 $(SILENT)for f in `cat $(BUILDDIR)/apps/features`; do feat="$$feat:$$f" ; done ; \
213 $(TOOLSDIR)/buildzip.pl $(VERBOSEOPT) -m \"$(MODELNAME)\" -i \"$(TARGET_ID)\" -r "$(ROOTDIR)" --rbdir="$(RBDIR)" $(TARGET) $(BINARY)
215 mapzip:
216 $(SILENT)find . -name "*.map" | xargs zip rockbox-maps.zip
218 fullzip:
219 $(SILENT)for f in `cat $(BUILDDIR)/apps/features`; do feat="$$feat:$$f" ; done; \
220 $(TOOLSDIR)/buildzip.pl $(VERBOSEOPT) -m \"$(MODELNAME)\" -i \"$(TARGET_ID)\" -r "$(ROOTDIR)" --rbdir="$(RBDIR)" -f 2 -o rockbox-full.zip $(TARGET) $(BINARY)
222 7zip:
223 $(SILENT)for f in `cat $(BUILDDIR)/apps/features`; do feat="$$feat:$$f" ; done; \
224 $(TOOLSDIR)/buildzip.pl $(VERBOSEOPT) -m \"$(MODELNAME)\" -i \"$(TARGET_ID)\" -o "rockbox.7z" -z "7za a -mx=9" -r "$(ROOTDIR)" --rbdir="$(RBDIR)" $(TARGET) $(BINARY)
226 tar:
227 $(SILENT)rm -f rockbox.tar
228 $(SILENT)for f in `cat $(BUILDDIR)/apps/features`; do feat="$$feat:$$f" ; done; \
229 $(TOOLSDIR)/buildzip.pl $(VERBOSEOPT) -m \"$(MODELNAME)\" -i \"$(TARGET_ID)\" -o "rockbox.tar" -z "tar -cf" -r "$(ROOTDIR)" --rbdir="$(RBDIR)" $(TARGET) $(BINARY)
231 bzip2: tar
232 $(SILENT)bzip2 -f9 rockbox.tar
234 gzip: tar
235 $(SILENT)gzip -f9 rockbox.tar
237 manual manual-pdf:
238 $(SILENT)$(MAKE) -C $(MANUALDIR) OBJDIR=$(BUILDDIR)/manual manual-pdf
239 manual-html:
240 $(SILENT)$(MAKE) -C $(MANUALDIR) OBJDIR=$(BUILDDIR)/manual manual-html
241 manual-zhtml: manual-zip
242 manual-txt:
243 $(SILENT)$(MAKE) -C $(MANUALDIR) OBJDIR=$(BUILDDIR)/manual manual-txt
244 manual-ztxt:
245 $(SILENT)$(MAKE) -C $(MANUALDIR) OBJDIR=$(BUILDDIR)/manual manual-txt-zip
246 manual-zip:
247 $(SILENT)$(MAKE) -C $(MANUALDIR) OBJDIR=$(BUILDDIR)/manual manual-zip
249 ifdef TTS_ENGINE
251 voice: voicetools features
252 $(SILENT)for f in `cat $(BUILDDIR)/apps/features`; do feat="$$feat:$$f" ; done ; \
253 for lang in `echo $(VOICELANGUAGE) |sed "s/,/ /g"`; do $(TOOLSDIR)/voice.pl -V -l=$$lang -t=$(MODELNAME)$$feat -i=$(TARGET_ID) -e="$(ENCODER)" -E="$(ENC_OPTS)" -s=$(TTS_ENGINE) -S="$(TTS_OPTS)"; done \
255 endif
257 ifdef SIMVER
259 install:
260 @echo "Installing your build in your 'simdisk' dir"
261 $(SILENT)for f in `cat $(BUILDDIR)/apps/features`; do feat="$$feat:$$f" ; done; \
262 $(TOOLSDIR)/buildzip.pl $(VERBOSEOPT) -m \"$(MODELNAME)\" -i \"$(TARGET_ID)\" -s -r "$(ROOTDIR)" --rbdir="$(RBDIR)" -f 0 $(TARGET) $(BINARY)
264 fullinstall:
265 @echo "Installing a full setup in your 'simdisk' dir"
266 $(SILENT)for f in `cat $(BUILDDIR)/apps/features`; do feat="$$feat:$$f" ; done; \
267 $(TOOLSDIR)/buildzip.pl $(VERBOSEOPT) -m \"$(MODELNAME)\" -i \"$(TARGET_ID)\" -s -r "$(ROOTDIR)" --rbdir="$(RBDIR)" -f 2 $(TARGET) $(BINARY)
269 endif
271 help:
272 @echo "A few helpful make targets"
273 @echo ""
274 @echo "all - builds a full Rockbox (default), including tools"
275 @echo "bin - builds only the Rockbox.<target name> file"
276 @echo "rocks - builds only plugins"
277 @echo "codecs - builds only codecs"
278 @echo "dep - regenerates make dependency database"
279 @echo "clean - cleans a build directory (not tools)"
280 @echo "veryclean - cleans the build and tools directories"
281 @echo "manual - builds a manual (pdf)"
282 @echo "manual-html - HTML manual"
283 @echo "manual-zip - HTML manual (zipped)"
284 @echo "manual-txt - txt manual"
285 @echo "fullzip - creates a rockbox.zip of your build with fonts"
286 @echo "zip - creates a rockbox.zip of your build (no fonts)"
287 @echo "gzip - creates a rockbox.tar.gz of your build (no fonts)"
288 @echo "bzip2 - creates a rockbox.tar.bz2 of your build (no fonts)"
289 @echo "7zip - creates a rockbox.7z of your build (no fonts)"
290 @echo "fontzip - creates rockbox-fonts.zip"
291 @echo "mapzip - creates rockbox-maps.zip with all .map files"
292 @echo "tools - builds the tools only"
293 @echo "voice - creates the voice clips (voice builds only)"
294 @echo "voicetools - builds the voice tools only"
295 @echo "install - installs your build (for simulator builds only, no fonts)"
296 @echo "fullinstall - installs your build (for simulator builds only, with fonts)"
297 @echo "reconf - rerun configure with the same selection"
299 ### general compile rules:
301 # when source and object are in different locations (normal):
302 $(BUILDDIR)/%.o: $(ROOTDIR)/%.c
303 $(SILENT)mkdir -p $(dir $@)
304 $(call PRINTS,CC $(subst $(ROOTDIR)/,,$<))$(CC) $(CFLAGS) -c $< -o $@
306 $(BUILDDIR)/%.o: $(ROOTDIR)/%.S
307 $(SILENT)mkdir -p $(dir $@)
308 $(call PRINTS,CC $(subst $(ROOTDIR)/,,$<))$(CC) $(CFLAGS) -c $< -o $@
310 # when source and object are both in BUILDDIR (generated code):
311 %.o: %.c
312 $(SILENT)mkdir -p $(dir $@)
313 $(call PRINTS,CC $(subst $(ROOTDIR)/,,$<))$(CC) $(CFLAGS) -c $< -o $@
315 %.o: %.S
316 $(SILENT)mkdir -p $(dir $@)
317 $(call PRINTS,CC $(subst $(ROOTDIR)/,,$<))$(CC) $(CFLAGS) -c $< -o $@
319 Makefile: $(TOOLSDIR)/configure
320 $(SILENT)echo "*** tools/configure is newer than Makefile. You should run 'make reconf'."
322 reconf:
323 $(SILENT)$(TOOLSDIR)/configure $(CONFIGURE_OPTIONS)