Fix some layout issues and typos.
Reorganizing some files to parts of the documentation where their content matches. Signed-off-by: Juergen Beisert <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
This commit is contained in:
parent
bf725a2945
commit
7733de908b
|
@ -10,7 +10,10 @@ ARM type:
|
||||||
|
|
||||||
- @subpage pcm037
|
- @subpage pcm037
|
||||||
- @subpage pcm038
|
- @subpage pcm038
|
||||||
|
- @subpage pcm043
|
||||||
|
- @subpage imx21ads
|
||||||
- @subpage imx27ads
|
- @subpage imx27ads
|
||||||
|
- @subpage the3stack
|
||||||
- @subpage scb9328
|
- @subpage scb9328
|
||||||
- @subpage netx
|
- @subpage netx
|
||||||
- @subpage dev_omap_arch
|
- @subpage dev_omap_arch
|
||||||
|
|
|
@ -8,9 +8,9 @@ Some background knowledge for some frameworks in U-Boot v2
|
||||||
|
|
||||||
Hints and tips for simply adapting U-Boot v2
|
Hints and tips for simply adapting U-Boot v2
|
||||||
|
|
||||||
- @subpage dev_board
|
|
||||||
- @subpage dev_cpu
|
|
||||||
- @subpage dev_architecture
|
- @subpage dev_architecture
|
||||||
|
- @subpage dev_cpu
|
||||||
|
- @subpage dev_board
|
||||||
- @subpage dev_params
|
- @subpage dev_params
|
||||||
|
|
||||||
Various themes:
|
Various themes:
|
||||||
|
@ -19,4 +19,4 @@ Various themes:
|
||||||
- @subpage boot_preparation
|
- @subpage boot_preparation
|
||||||
- @subpage uboot_simul
|
- @subpage uboot_simul
|
||||||
|
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -29,17 +29,65 @@ to find the right place in whatever environment and U-Boot sizes.
|
||||||
.section ".text_entry","ax"
|
.section ".text_entry","ax"
|
||||||
@endcode
|
@endcode
|
||||||
|
|
||||||
|
@section arch_files List of changes
|
||||||
|
|
||||||
|
- create a new subdirectory in /arch
|
||||||
|
TODO
|
||||||
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/** @page dev_cpu Intergrate a new CPU (MACH)
|
/** @page dev_cpu Integrate a new CPU (MACH)
|
||||||
|
|
||||||
Features required for every CPU:
|
Features required for every CPU:
|
||||||
|
|
||||||
- clocksource
|
- clocksource
|
||||||
- CPU reset function
|
- CPU reset function
|
||||||
|
|
||||||
|
@section time_keeping Time keeping
|
||||||
|
|
||||||
|
In U-Boot-v2 we are using the clocksource mechanism from the Linux Kernel.
|
||||||
|
This makes it fairly easy to add timer functionality for a new board or
|
||||||
|
architecture.
|
||||||
|
|
||||||
|
Apart from initialization there is only one function to be registerd:
|
||||||
|
clocksource_read(). This function returns the current value of a free running
|
||||||
|
counter. Other functions like udelay() and get_time_ns() are derived from this
|
||||||
|
function. The only thing you have to implement is a clocksource driver and
|
||||||
|
to register it at runtime.
|
||||||
|
|
||||||
|
@code
|
||||||
|
static uint64_t mycpu_clocksource_read(void)
|
||||||
|
{
|
||||||
|
TODO
|
||||||
|
}
|
||||||
|
|
||||||
|
static struct clocksource cs = {
|
||||||
|
.read = mycpu_clocksource_read,
|
||||||
|
.mask = 0xffffffff,
|
||||||
|
.shift = 10,
|
||||||
|
};
|
||||||
|
|
||||||
|
....
|
||||||
|
init_clock(&cs);
|
||||||
|
....
|
||||||
|
@endcode
|
||||||
|
|
||||||
|
See arch/arm/mach-imx/clocksource.c for an example. clocksource drivers from
|
||||||
|
the Linux Kernel can be used nearly 1:1, except for the register accesses.
|
||||||
|
|
||||||
|
Note: For clocksources the __lshrdi3 symbol is needed. You can find the
|
||||||
|
function for your architecture in the Linux Kernel or a libc of your choice.
|
||||||
|
|
||||||
|
Note: U-Boot-v2 expects an upward counting counter!
|
||||||
|
|
||||||
|
@section reset_function Reset function
|
||||||
|
|
||||||
|
TODO
|
||||||
|
|
||||||
- @subpage dev_arm_mach
|
- @subpage dev_arm_mach
|
||||||
- @subpage dev_bf_mach
|
- @subpage dev_bf_mach
|
||||||
- @subpage dev_ppc_mach
|
- @subpage dev_ppc_mach
|
||||||
|
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -34,4 +34,17 @@ the first C instruction in U-Boot. At this point of time:\n
|
||||||
For details on specific architectures:
|
For details on specific architectures:
|
||||||
- @subpage dev_omap_arch
|
- @subpage dev_omap_arch
|
||||||
|
|
||||||
|
@section mach_arm_files List of changes
|
||||||
|
|
||||||
|
Lets call the new MACH new_cpu.
|
||||||
|
|
||||||
|
- create a new subdirectory in /arch/arm/new_cpu
|
||||||
|
- add /arch/arm/new_cpu/Kconfig
|
||||||
|
- add /arch/arm/new_cpu/Makfile
|
||||||
|
- add other CPU specific code into /arch/arm/new_cpu/
|
||||||
|
- modify /arch/arm/Kconfig
|
||||||
|
- modify /arch/arm/Makfile
|
||||||
|
|
||||||
|
TODO add more details
|
||||||
|
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -78,7 +78,7 @@ TBD
|
||||||
|
|
||||||
@section board_mod_files These files needs to be modified:
|
@section board_mod_files These files needs to be modified:
|
||||||
|
|
||||||
- modify board/board.doc
|
- modify board/board.dox
|
||||||
- modify arch/\<architecture\>/Kconfig
|
- modify arch/\<architecture\>/Kconfig
|
||||||
- add your board (MACH_*) to the list
|
- add your board (MACH_*) to the list
|
||||||
- add your default text base address for this architecture (ARCH_TEXT_BASE)
|
- add your default text base address for this architecture (ARCH_TEXT_BASE)
|
||||||
|
|
|
@ -1,4 +1,4 @@
|
||||||
/** @page 3stack Freescale MX35 3-Stack Board
|
/** @page the3stack Freescale MX35 3-Stack Board
|
||||||
|
|
||||||
|
|
||||||
*/
|
*/
|
||||||
|
|
Loading…
Reference in New Issue