bootloader-ap (Boot Loader for Application Processors)

Developed by TJ <linux@tjworld.net>
Copyright (C) 2010-

A GPLv3 licensed boot-loader for ARM-based communications devices based on modern System-on-Chip 
architectures such as the Qualcomm MSM7x30, which is the first target of this implementation.

The intention is to provide a completely Free and Open Source boot-loader that can be utilised by 
system manufacturers and user's who prefer to install a custom boot-loader.

Inspired by the HTC Vision device, known as the HTC Desire Z and T-Mobile G2. This device was locked 
by HTC to prevent easy customisation.

= Developer Notes =

Gathering the chip-set specifications for some parts of this code can be challenging. Prudent use of
a search engine can uncover many fragments of open-source code patches to many Linux kernel projects
for embedded devices.

To guard against any possible challenge as to the source of specifications and settings that
aren't publicly released by chip-set or device manufacturers there is a comment template to prefix
to any code that describes or uses those specifications or settings. Here's an example:

/*
  SOURCE: HTC Vision Linux kernel 2.6.32 source
  SOURCE_FILE: arch/arm/mach-msm/arch-init-7x30.S
  SOURCE_URL: http://dl3.htc.com/RomCode/Source_and_Binaries/vision-2.6.32-g814e0a1.tar.gz
  SOURCE_FOR: MSM7x30 equates, status-codes, IOMEM addresses, CP15 functions
*/

... some code

/* SOURCE_END */

By using pseudo-defines (SOURCE, SOURCE_*, SOURCE_END) inside a C-style comment block (/* ... */) it
makes it possible to use an automated tool to gather and document all sources of specifications and 
settings.