forked from kubos/uboot
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Remove/update old generic-board documentation and warning
Remove the warning from the Makefile, since boards that do not use generic board will no longer build. Also update documentation. Signed-off-by: Simon Glass <[email protected]> Reviewed-by: Andreas Bießmann <[email protected]>
- Loading branch information
Showing
5 changed files
with
8 additions
and
94 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -5,29 +5,22 @@ | |
# SPDX-License-Identifier: GPL-2.0+ | ||
# | ||
|
||
DEPRECATION NOTICE FOR arch/<arch>/lib/board.c | ||
|
||
For board maintainers: Please submit patches for boards you maintain before | ||
July 2014, to make them use generic board. | ||
|
||
For architecture maintainers: Please submit patches to remove your | ||
architecture-specific board.c file before October 2014. | ||
|
||
|
||
Background | ||
---------- | ||
|
||
U-Boot has traditionally had a board.c file for each architecture. This has | ||
introduced quite a lot of duplication, with each architecture tending to do | ||
U-Boot traditionally had a board.c file for each architecture. This introduced | ||
quite a lot of duplication, with each architecture tending to do | ||
initialisation slightly differently. To address this, a new 'generic board | ||
init' feature was introduced a year ago in March 2013 (further motivation is | ||
init' feature was introduced in March 2013 (further motivation is | ||
provided in the cover letter below). | ||
|
||
All boards and architectures have moved to this as of mid 2016. | ||
|
||
|
||
What has changed? | ||
----------------- | ||
|
||
The main change is that the arch/<arch>/lib/board.c file is being removed in | ||
The main change is that the arch/<arch>/lib/board.c file is removed in | ||
favour of common/board_f.c (for pre-relocation init) and common/board_r.c | ||
(for post-relocation init). | ||
|
||
|
@@ -36,55 +29,6 @@ fields which are common to all architectures. Architecture-specific fields | |
have been moved to separate structures. | ||
|
||
|
||
Supported Architectures | ||
------------------------ | ||
|
||
If you are unlucky then your architecture may not support generic board. | ||
The following architectures are supported now: | ||
|
||
arc | ||
arm | ||
avr32 | ||
blackfin | ||
m68k | ||
microblaze | ||
mips | ||
nios2 | ||
powerpc | ||
sandbox | ||
x86 | ||
|
||
If your architecture is not supported, you need to select | ||
HAVE_GENERIC_BOARD in arch/Kconfig | ||
and test it with a suitable board, as follows. | ||
|
||
|
||
Adding Support for your Board | ||
----------------------------- | ||
|
||
To enable generic board for your board, define CONFIG_SYS_GENERIC_BOARD in | ||
your board config header file. | ||
|
||
Test that U-Boot still functions correctly on your board, and fix any | ||
problems you find. Don't be surprised if there are no problems - generic | ||
board has had a reasonable amount of testing with common boards. | ||
|
||
|
||
DeadLine | ||
-------- | ||
|
||
Please don't take this the wrong way - there is no intent to make your life | ||
miserable, and we have the greatest respect and admiration for U-Boot users. | ||
However, with any migration there has to be a period where the old way is | ||
deprecated and removed. Every patch to the deprecated code introduces a | ||
potential breakage in the new unused code. Therefore: | ||
|
||
Boards or architectures not converted over to general board by the | ||
end of 2014 may be forcibly changed over (potentially causing run-time | ||
breakage) or removed. | ||
|
||
|
||
|
||
Further Background | ||
------------------ | ||
|
||
|
@@ -190,3 +134,4 @@ convenience. | |
|
||
Simon Glass, [email protected] | ||
March 2014 | ||
Updated after final removal, May 2016 |