From 511fd0b2bb60e640895e7c51f71db29ddeb42aa4 Mon Sep 17 00:00:00 2001 From: Simon Glass Date: Sun, 12 Nov 2017 21:52:05 -0700 Subject: binman: Add better Makefile debugging There is a debugging option in the Makefile to allow people to figure out which u-boot.dtsi files are used in the build. But is it not easy to use since it only shows files it finds, not those it is looking for. Update it and update the mention of it to the docs. Signed-off-by: Simon Glass --- tools/binman/README | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'tools/binman/README') diff --git a/tools/binman/README b/tools/binman/README index cb47e73599a..63f97226429 100644 --- a/tools/binman/README +++ b/tools/binman/README @@ -446,7 +446,8 @@ If you are having trouble figuring out what is going on, you can uncomment the 'warning' line in scripts/Makefile.lib to see what it has found: # Uncomment for debugging - # $(warning binman_dtsi_options: $(binman_dtsi_options)) + # This shows all the files that were considered and the one that we chose. + # u_boot_dtsi_options_debug = $(u_boot_dtsi_options_raw) Code coverage -- cgit v1.2.3 From 9c0a8b1f44a18343acb48a7b6cf6ec724a7fac93 Mon Sep 17 00:00:00 2001 From: Simon Glass Date: Sun, 12 Nov 2017 21:52:06 -0700 Subject: binman: Add docs explaining how to enable binman for a board The process is not obvious. Add a little section to explain how to move a board to use binman. Signed-off-by: Simon Glass --- tools/binman/README | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'tools/binman/README') diff --git a/tools/binman/README b/tools/binman/README index 63f97226429..4ef76c8f089 100644 --- a/tools/binman/README +++ b/tools/binman/README @@ -206,6 +206,27 @@ for its instructions in the 'binman' node. Binman has a few other options which you can see by running 'binman -h'. +Enabling binman for a board +--------------------------- + +At present binman is invoked from a rule in the main Makefile. Typically you +will have a rule like: + +ifneq ($(CONFIG_ARCH_),) +u-boot-.bin: checkbinman FORCE + $(call if_changed,binman) +endif + +This assumes that u-boot-.bin is a target, and is the final file +that you need to produce. You can make it a target by adding it to ALL-y +either in the main Makefile or in a config.mk file in your arch subdirectory. + +Once binman is executed it will pick up its instructions from a device-tree +file, typically -u-boot.dtsi, where is your CONFIG_SYS_SOC value. +You can use other, more specific CONFIG options - see 'Automatic .dtsi +inclusion' below. + + Image description format ------------------------ -- cgit v1.2.3