SDOCM00115293 Linux transport interfaces need documentation
[ipc/ipcdev.git] / ipc-bios.mak
1 #
2 #   Copyright (c) 2012-2015, Texas Instruments Incorporated
3 #
4 #   Redistribution and use in source and binary forms, with or without
5 #   modification, are permitted provided that the following conditions
6 #   are met:
7 #
8 #   *  Redistributions of source code must retain the above copyright
9 #      notice, this list of conditions and the following disclaimer.
10 #
11 #   *  Redistributions in binary form must reproduce the above copyright
12 #      notice, this list of conditions and the following disclaimer in the
13 #      documentation and/or other materials provided with the distribution.
14 #
15 #   *  Neither the name of Texas Instruments Incorporated nor the names of
16 #      its contributors may be used to endorse or promote products derived
17 #      from this software without specific prior written permission.
18 #
19 #   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20 #   AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
21 #   THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 #   PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
23 #   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
24 #   EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
25 #   PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
26 #   OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
27 #   WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
28 #   OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
29 #   EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30 #
31 #  ======== ipc-bios.mak ========
32 #
34 #
35 # Where to install/stage the packages
36 # Typically this would point to the devkit location
37 #
38 DESTDIR ?= <UNDEFINED>
40 packagesdir ?= /packages
41 libdir ?= /lib
42 includedir ?= /include
44 ifeq ($(docdir),)
45 docdir := /share/ti/ipc/doc
46 packagedocdir := /docs/ipc
47 else
48 packagedocdir := $(docdir)
49 endif
51 ifeq ($(prefix),)
52 prefix := /usr
53 packageprefix := /
54 else
55 packageprefix := $(prefix)
56 endif
58 include ./products.mak
60 #
61 # Set XDCARGS to some of the variables above.  XDCARGS are passed
62 # to the XDC build engine... which will load ipc-bios.bld... which will
63 # extract these variables and use them to determine what to build and which
64 # toolchains to use.
65 #
66 # Note that not all of these variables need to be set to something valid.
67 # Unfortunately, since these vars are unconditionally assigned, your build line
68 # will be longer and more noisy than necessary (e.g., it will include C66
69 # assignment even if you're just building for C64P).
70 #
71 # Some background is here:
72 #     http://rtsc.eclipse.org/docs-tip/Command_-_xdc#Environment_Variables
73 #
74 XDCARGS= \
75     PLATFORM=\"$(PLATFORM)\" \
76     BIOS_SMPENABLED=\"$(BIOS_SMPENABLED)\" \
77     ti.targets.C64P=\"$(ti.targets.C64P)\" \
78     ti.targets.C64P_big_endian=\"$(ti.targets.C64P_big_endian)\" \
79     ti.targets.C674=\"$(ti.targets.C674)\" \
80     ti.targets.arm.elf.Arm9=\"$(ti.targets.arm.elf.Arm9)\" \
81     ti.targets.arm.elf.A8F=\"$(ti.targets.arm.elf.A8F)\" \
82     ti.targets.arm.elf.A8Fnv=\"$(ti.targets.arm.elf.A8Fnv)\" \
83     ti.targets.arm.elf.M3=\"$(ti.targets.arm.elf.M3)\" \
84     ti.targets.arm.elf.M4=\"$(ti.targets.arm.elf.M4)\" \
85     ti.targets.arm.elf.M4F=\"$(ti.targets.arm.elf.M4F)\" \
86     ti.targets.elf.C64P=\"$(ti.targets.elf.C64P)\" \
87     ti.targets.elf.C64P_big_endian=\"$(ti.targets.elf.C64P_big_endian)\" \
88     ti.targets.elf.C64T=\"$(ti.targets.elf.C64T)\" \
89     ti.targets.elf.C66=\"$(ti.targets.elf.C66)\" \
90     ti.targets.elf.C66_big_endian=\"$(ti.targets.elf.C66_big_endian)\" \
91     ti.targets.elf.C674=\"$(ti.targets.elf.C674)\" \
92     ti.targets.arp32.elf.ARP32=\"$(ti.targets.arp32.elf.ARP32)\" \
93     ti.targets.arp32.elf.ARP32_far=\"$(ti.targets.arp32.elf.ARP32_far)\" \
94     gnu.targets.arm.A8F=\"$(gnu.targets.arm.A8F)\" \
95     gnu.targets.arm.A15F=\"$(gnu.targets.arm.A15F)\"
97 ifeq ($(MAKECMDGOALS),release)
98     XDCARGS += GOAL=release
99 endif
102 # Get list of packages to rebuild. Remove examples from the list.
104 XDCPKG := $(XDC_INSTALL_DIR)/bin/xdcpkg
106 # Check for Windows specific env vars to determine if we are on Windows
107 ifeq (,$(findstring :,$(WINDIR)$(windir)$(COMSPEC)$(comspec)))
108    FILTER = grep -v
109 else
110    # Find is the rough equivalent of grep on Windows
111    FILTER = find /v
112    # Replace '/' with '\' because cmd.exe requires '\'s in command names
113    XDCPKG := $(subst /,\,$(XDCPKG))
114 endif
116 LIST = $(shell $(XDCPKG) ./packages | $(FILTER) "examples")
119 # Set XDCPATH to contain necessary repositories.
121 XDCPATH = $(BIOS_INSTALL_DIR)/packages
122 export XDCPATH
125 # Set XDCOPTIONS.  Use -v for a verbose build.
127 #XDCOPTIONS=v
128 export XDCOPTIONS
131 # Set XDC executable command
132 # Note that XDCBUILDCFG points to the ipc-bios.bld file which uses
133 # the arguments specified by XDCARGS
135 XDC = $(XDC_INSTALL_DIR)/xdc $(JOBS) XDCARGS="$(XDCARGS)" XDCBUILDCFG=./ipc-bios.bld
137 ######################################################
138 ## Shouldnt have to modify anything below this line ##
139 ######################################################
141 all:
142         @echo building ipc packages ...
143 # build everything in the Bios IPC package
144         @$(XDC) -P $(LIST)
146 libs:
147         @echo "#"
148         @echo "# Making $@ ..."
149         @$(XDC) .dlls -P $(patsubst %/tests,,$(LIST))
151 release:
152         @echo building ipc packages ...
153 # create a XDC release for the Bios IPC package
154         @$(XDC) release -P $(LIST)
156 clean:
157         @ echo cleaning ipc packages ...
158         @ $(XDC) clean -Pr ./packages
160 install-packages:
161         @ echo installing ipc packages to $(DESTDIR) ...
162         @ mkdir -p $(DESTDIR)/$(packageprefix)/$(packagedocdir)
163         @ cp -rf $(wildcard ipc_*_release_notes.html) docs/* $(DESTDIR)/$(packageprefix)/$(packagedocdir)
164         @ mkdir -p $(DESTDIR)/$(packageprefix)/$(packagesdir)
165         @ cp -rf packages/* $(DESTDIR)/$(packageprefix)/$(packagesdir)
167 install:
168         @ echo installing ti/ipc to $(DESTDIR) ...
169         @ mkdir -p $(DESTDIR)/$(prefix)/$(docdir)
170         @ cp -rf $(wildcard ipc_*_release_notes.html) docs/* $(DESTDIR)/$(prefix)/$(docdir)
171         @ mkdir -p $(DESTDIR)/$(prefix)/$(includedir)/ti/ipc
172         @ cp -rf packages/ti/ipc/*.h $(DESTDIR)/$(prefix)/$(includedir)/ti/ipc