Merge branch 'for-2.6.22' of git://git.kernel.org/pub/scm/linux/kernel/git/paulus/powerpc

                           and property data. The old style variable

                           and property data. The old style variable

                           alignment would make it impossible to do

                           alignment would make it impossible to do

                           "simple" insertion of properties using

                           "simple" insertion of properties using

                           memove (thanks Milton for

                           memmove (thanks Milton for

                           noticing). Updated kernel patch as well

                           noticing). Updated kernel patch as well

			 - Correct a few more alignment constraints

			 - Correct a few more alignment constraints

			 - Add a chapter about the device-tree

			 - Add a chapter about the device-tree

 ToDo:

 ToDo:

	- Add some definitions of interrupt tree (simple/complex)

	- Add some definitions of interrupt tree (simple/complex)

	- Add some definitions for pci host bridges

	- Add some definitions for PCI host bridges

	- Add some common address format examples

	- Add some common address format examples

	- Add definitions for standard properties and "compatible"

	- Add definitions for standard properties and "compatible"

	  names for cells that are not already defined by the existing

	  names for cells that are not already defined by the existing

        forth words isn't required), you can enter the kernel with:

        forth words isn't required), you can enter the kernel with:

              r5 : OF callback pointer as defined by IEEE 1275

              r5 : OF callback pointer as defined by IEEE 1275

              bindings to powerpc. Only the 32 bit client interface

              bindings to powerpc. Only the 32-bit client interface

              is currently supported

              is currently supported

              r3, r4 : address & length of an initrd if any or 0

              r3, r4 : address & length of an initrd if any or 0

  for this is to keep kernels on embedded systems small and efficient;

  for this is to keep kernels on embedded systems small and efficient;

  part of this is due to the fact the code is already that way. In the

  part of this is due to the fact the code is already that way. In the

  future, a kernel may support multiple platforms, but only if the

  future, a kernel may support multiple platforms, but only if the

  platforms feature the same core architectire.  A single kernel build

  platforms feature the same core architecture.  A single kernel build

  cannot support both configurations with Book E and configurations

  cannot support both configurations with Book E and configurations

  with classic Powerpc architectures.

  with classic Powerpc architectures.

  enable another config option to select the specific board

  enable another config option to select the specific board

  supported.

  supported.

NOTE: If ben doesn't merge the setup files, may need to change this to

NOTE: If Ben doesn't merge the setup files, may need to change this to

point to setup_32.c

point to setup_32.c

                                           booting on */

                                           booting on */

        /* version 3 fields below */

        /* version 3 fields below */

        u32     size_dt_strings;        /* size of the strings block */

        u32     size_dt_strings;        /* size of the strings block */

        /* version 17 fields below */

        u32	size_dt_struct;		/* size of the DT structure block */

};

};

   Along with the constants:

   Along with the constants:

   - off_mem_rsvmap

   - off_mem_rsvmap

     This is an offset from the beginning of the header to the start

     This is an offset from the beginning of the header to the start

     of the reserved memory map. This map is a list of pairs of 64

     of the reserved memory map. This map is a list of pairs of 64-

     bit integers. Each pair is a physical address and a size. The

     bit integers. Each pair is a physical address and a size. The

     list is terminated by an entry of size 0. This map provides the

     list is terminated by an entry of size 0. This map provides the

     kernel with a list of physical memory areas that are "reserved"

     kernel with a list of physical memory areas that are "reserved"

     and thus not to be used for memory allocations, especially during

     and thus not to be used for memory allocations, especially during

     contain _at least_ this DT block itself (header,total_size). If

     contain _at least_ this DT block itself (header,total_size). If

     you are passing an initrd to the kernel, you should reserve it as

     you are passing an initrd to the kernel, you should reserve it as

     well. You do not need to reserve the kernel image itself. The map

     well. You do not need to reserve the kernel image itself. The map

     should be 64 bit aligned.

     should be 64-bit aligned.

   - version

   - version

     to reallocate it easily at boot and free up the unused flattened

     to reallocate it easily at boot and free up the unused flattened

     structure after expansion. Version 16 introduces a new more

     structure after expansion. Version 16 introduces a new more

     "compact" format for the tree itself that is however not backward

     "compact" format for the tree itself that is however not backward

     compatible. You should always generate a structure of the highest

     compatible. Version 17 adds an additional field, size_dt_struct,

     version defined at the time of your implementation. Currently

     allowing it to be reallocated or moved more easily (this is

     that is version 16, unless you explicitly aim at being backward

     particularly useful for bootloaders which need to make

     compatible.

     adjustments to a device tree based on probed information). You

     should always generate a structure of the highest version defined

     at the time of your implementation. Currently that is version 17,

     unless you explicitly aim at being backward compatible.

   - last_comp_version

   - last_comp_version

     is backward compatible with version 1 (that is, a kernel build

     is backward compatible with version 1 (that is, a kernel build

     for version 1 will be able to boot with a version 2 format). You

     for version 1 will be able to boot with a version 2 format). You

     should put a 1 in this field if you generate a device tree of

     should put a 1 in this field if you generate a device tree of

     version 1 to 3, or 0x10 if you generate a tree of version 0x10

     version 1 to 3, or 16 if you generate a tree of version 16 or 17

     using the new unit name format.

     using the new unit name format.

   - boot_cpuid_phys

   - boot_cpuid_phys

     point (see further chapters for more informations on the required

     point (see further chapters for more informations on the required

     device-tree contents)

     device-tree contents)

   - size_dt_strings

     This field only exists on version 3 and later headers.  It

     gives the size of the "strings" section of the device tree (which

     starts at the offset given by off_dt_strings).

   - size_dt_struct

     This field only exists on version 17 and later headers.  It gives

     the size of the "structure" section of the device tree (which

     starts at the offset given by off_dt_struct).

   So the typical layout of a DT block (though the various parts don't

   So the typical layout of a DT block (though the various parts don't

   need to be in that order) looks like this (addresses go from top to

   need to be in that order) looks like this (addresses go from top to

A node has 2 names. The actual node name is generally contained in a

A node has 2 names. The actual node name is generally contained in a

property of type "name" in the node property list whose value is a

property of type "name" in the node property list whose value is a

zero terminated string and is mandatory for version 1 to 3 of the

zero terminated string and is mandatory for version 1 to 3 of the

format definition (as it is in Open Firmware). Version 0x10 makes it

format definition (as it is in Open Firmware). Version 16 makes it

optional as it can generate it from the unit name defined below.

optional as it can generate it from the unit name defined below.

There is also a "unit name" that is used to differentiate nodes with

There is also a "unit name" that is used to differentiate nodes with

interrupt tree which will be described in a further version of this

interrupt tree which will be described in a further version of this

document.

document.

This "linux, phandle" property is a 32 bit value that uniquely

This "linux, phandle" property is a 32-bit value that uniquely

identifies a node. You are free to use whatever values or system of

identifies a node. You are free to use whatever values or system of

values, internal pointers, or whatever to generate these, the only

values, internal pointers, or whatever to generate these, the only

requirement is that every node for which you provide that property has

requirement is that every node for which you provide that property has

designates a node followed by the node unit name. Properties are

designates a node followed by the node unit name. Properties are

presented with their name followed by their content. "content"

presented with their name followed by their content. "content"

represents an ASCII string (zero terminated) value, while <content>

represents an ASCII string (zero terminated) value, while <content>

represents a 32 bit hexadecimal value. The various nodes in this

represents a 32-bit hexadecimal value. The various nodes in this

example will be discussed in a later chapter. At this point, it is

example will be discussed in a later chapter. At this point, it is

only meant to give you a idea of what a device-tree looks like. I have

only meant to give you a idea of what a device-tree looks like. I have

purposefully kept the "name" and "linux,phandle" properties which

purposefully kept the "name" and "linux,phandle" properties which

     * [align gap to next 4 bytes boundary]

     * [align gap to next 4 bytes boundary]

     * for each property:

     * for each property:

        * token OF_DT_PROP (that is 0x00000003)

        * token OF_DT_PROP (that is 0x00000003)

        * 32 bit value of property value size in bytes (or 0 of no

        * 32-bit value of property value size in bytes (or 0 if no

     * value)

          value)

        * 32 bit value of offset in string block of property name

        * 32-bit value of offset in string block of property name

        * property value data if any

        * property value data if any

        * [align gap to next 4 bytes boundary]

        * [align gap to next 4 bytes boundary]

     * [child nodes if any]

     * [child nodes if any]

     * token OF_DT_END_NODE (that is 0x00000002)

     * token OF_DT_END_NODE (that is 0x00000002)

So the node content can be summarised as a start token, a full path,

So the node content can be summarized as a start token, a full path,

a list of properties, a list of child nodes, and an end token. Every

a list of properties, a list of child nodes, and an end token. Every

child node is a full node structure itself as defined above.

child node is a full node structure itself as defined above.

----------------------------------------------

----------------------------------------------

The general rule is documented in the various Open Firmware

The general rule is documented in the various Open Firmware

documentations. If you chose to describe a bus with the device-tree

documentations. If you choose to describe a bus with the device-tree

and there exist an OF bus binding, then you should follow the

and there exist an OF bus binding, then you should follow the

specification. However, the kernel does not require every single

specification. However, the kernel does not require every single

device or bus to be described by the device tree.

device or bus to be described by the device tree.

on the processor bus.

on the processor bus.

Those 2 properties define 'cells' for representing an address and a

Those 2 properties define 'cells' for representing an address and a

size. A "cell" is a 32 bit number. For example, if both contain 2

size. A "cell" is a 32-bit number. For example, if both contain 2

like the example tree given above, then an address and a size are both

like the example tree given above, then an address and a size are both

composed of 2 cells, and each is a 64 bit number (cells are

composed of 2 cells, and each is a 64-bit number (cells are

concatenated and expected to be in big endian format). Another example

concatenated and expected to be in big endian format). Another example

is the way Apple firmware defines them, with 2 cells for an address

is the way Apple firmware defines them, with 2 cells for an address

and one cell for a size.  Most 32-bit implementations should define

and one cell for a size.  Most 32-bit implementations should define

The "reg" property only defines addresses and sizes (if #size-cells

The "reg" property only defines addresses and sizes (if #size-cells

is non-0) within a given bus. In order to translate addresses upward

is non-0) within a given bus. In order to translate addresses upward

(that is into parent bus addresses, and possibly into cpu physical

(that is into parent bus addresses, and possibly into CPU physical

addresses), all busses must contain a "ranges" property. If the

addresses), all busses must contain a "ranges" property. If the

"ranges" property is missing at a given level, it's assumed that

"ranges" property is missing at a given level, it's assumed that

translation isn't possible. The format of the "ranges" property for a

translation isn't possible. The format of the "ranges" property for a

PCI<->ISA bridge, that would be a PCI address. It defines the base

PCI<->ISA bridge, that would be a PCI address. It defines the base

address in the parent bus where the beginning of that range is mapped.

address in the parent bus where the beginning of that range is mapped.

For a new 64 bit powerpc board, I recommend either the 2/2 format or

For a new 64-bit powerpc board, I recommend either the 2/2 format or

Apple's 2/1 format which is slightly more compact since sizes usually

Apple's 2/1 format which is slightly more compact since sizes usually

fit in a single 32 bit word.   New 32 bit powerpc boards should use a

fit in a single 32-bit word.   New 32-bit powerpc boards should use a

1/1 format, unless the processor supports physical addresses greater

1/1 format, unless the processor supports physical addresses greater

than 32-bits, in which case a 2/1 format is recommended.

than 32-bits, in which case a 2/1 format is recommended.

  Required properties:

  Required properties:

    - device_type : has to be "cpu"

    - device_type : has to be "cpu"

    - reg : This is the physical cpu number, it's a single 32 bit cell

    - reg : This is the physical CPU number, it's a single 32-bit cell

      and is also used as-is as the unit number for constructing the

      and is also used as-is as the unit number for constructing the

      unit name in the full path. For example, with 2 CPUs, you would

      unit name in the full path. For example, with 2 CPUs, you would

      have the full path:

      have the full path:

      the kernel timebase/decrementer calibration based on this

      the kernel timebase/decrementer calibration based on this

      value.

      value.

    - clock-frequency : a cell indicating the CPU core clock frequency

    - clock-frequency : a cell indicating the CPU core clock frequency

      in Hz. A new property will be defined for 64 bit values, but if

      in Hz. A new property will be defined for 64-bit values, but if

      your frequency is < 4Ghz, one cell is enough. Here as well as

      your frequency is < 4Ghz, one cell is enough. Here as well as

      for the above, the common code doesn't use that property, but

      for the above, the common code doesn't use that property, but

      you are welcome to re-use the pSeries or Maple one. A future

      you are welcome to re-use the pSeries or Maple one. A future

  This node is a bit "special". Normally, that's where open firmware

  This node is a bit "special". Normally, that's where open firmware

  puts some variable environment information, like the arguments, or

  puts some variable environment information, like the arguments, or

  phandle pointers to nodes like the main interrupt controller, or the

  the default input/output devices.

  default input/output devices.

  This specification makes a few of these mandatory, but also defines

  This specification makes a few of these mandatory, but also defines

  some linux-specific properties that would be normally constructed by

  some linux-specific properties that would be normally constructed by

      that the kernel tries to find out the default console and has

      that the kernel tries to find out the default console and has

      knowledge of various types like 8250 serial ports. You may want

      knowledge of various types like 8250 serial ports. You may want

      to extend this function to add your own.

      to extend this function to add your own.

    - interrupt-controller : This is one cell containing a phandle

      value that matches the "linux,phandle" property of your main

      interrupt controller node. May be used for interrupt routing.

  Note that u-boot creates and fills in the chosen node for platforms

  Note that u-boot creates and fills in the chosen node for platforms

  that use it.

  that use it.

  (Note: a practice that is now obsolete was to include a property

  under /chosen called interrupt-controller which had a phandle value

  that pointed to the main interrupt controller)

  f) the /soc<SOCname> node

  f) the /soc<SOCname> node

  This node is used to represent a system-on-a-chip (SOC) and must be

  This node is used to represent a system-on-a-chip (SOC) and must be

  The SOC node may contain child nodes for each SOC device that the

  The SOC node may contain child nodes for each SOC device that the

  platform uses.  Nodes should not be created for devices which exist

  platform uses.  Nodes should not be created for devices which exist

  on the SOC but are not used by a particular platform. See chapter VI

  on the SOC but are not used by a particular platform. See chapter VI

  for more information on how to specify devices that are part of an

  for more information on how to specify devices that are part of a SOC.

SOC.

  Example SOC node for the MPC8540:

  Example SOC node for the MPC8540:

        [-o output-filename] [-V output_version] input_filename

        [-o output-filename] [-V output_version] input_filename

The "output_version" defines what versio of the "blob" format will be

The "output_version" defines what version of the "blob" format will be

generated. Supported versions are 1,2,3 and 16. The default is

generated. Supported versions are 1,2,3 and 16. The default is

currently version 3 but that may change in the future to version 16.

currently version 3 but that may change in the future to version 16.

				 */

				 */

  property2 = <1234abcd>;	/* define a property containing a

  property2 = <1234abcd>;	/* define a property containing a

                                 * numerical 32 bits value (hexadecimal)

                                 * numerical 32-bit value (hexadecimal)

				 */

				 */

  property3 = <12345678 12345678 deadbeef>;

  property3 = <12345678 12345678 deadbeef>;

                                /* define a property containing 3

                                /* define a property containing 3

                                 * numerical 32 bits values (cells) in

                                 * numerical 32-bit values (cells) in

                                 * hexadecimal

                                 * hexadecimal

				 */

				 */

  property4 = [0a 0b 0c 0d de ea ad be ef];

  property4 = [0a 0b 0c 0d de ea ad be ef];

    its usage in early_init_devtree(), and the corresponding various

    its usage in early_init_devtree(), and the corresponding various

    early_init_dt_scan_*() callbacks. That code can be re-used in a

    early_init_dt_scan_*() callbacks. That code can be re-used in a

    GPL bootloader, and as the author of that code, I would be happy

    GPL bootloader, and as the author of that code, I would be happy

    to discuss possible free licencing to any vendor who wishes to

    to discuss possible free licensing to any vendor who wishes to

    integrate all or part of this code into a non-GPL bootloader.

    integrate all or part of this code into a non-GPL bootloader.

=======================================

=======================================

Many companies are now starting to develop system-on-a-chip

Many companies are now starting to develop system-on-a-chip

processors, where the processor core (cpu) and many peripheral devices

processors, where the processor core (CPU) and many peripheral devices

exist on a single piece of silicon.  For these SOCs, an SOC node

exist on a single piece of silicon.  For these SOCs, an SOC node

should be used that defines child nodes for the devices that make

should be used that defines child nodes for the devices that make

up the SOC. While platforms are not required to use this model in

up the SOC. While platforms are not required to use this model in

MPC8540.

MPC8540.

2) Specifying interrupt information for SOC devices

2) Representing devices without a current OF specification

---------------------------------------------------

Each device that is part of an SOC and which generates interrupts

should have the following properties:

	- interrupt-parent : contains the phandle of the interrupt

          controller which handles interrupts for this device

	- interrupts : a list of tuples representing the interrupt

          number and the interrupt sense and level for each interrupt

          for this device.

This information is used by the kernel to build the interrupt table

for the interrupt controllers in the system.

Sense and level information should be encoded as follows:

   Devices connected to openPIC-compatible controllers should encode

   sense and polarity as follows:

	0 = low to high edge sensitive type enabled

	1 = active low level sensitive type enabled

	2 = active high level sensitive type enabled

	3 = high to low edge sensitive type enabled

   ISA PIC interrupt controllers should adhere to the ISA PIC

   encodings listed below:

	0 =  active low level sensitive type enabled

	1 =  active high level sensitive type enabled

	2 =  high to low edge sensitive type enabled

	3 =  low to high edge sensitive type enabled

3) Representing devices without a current OF specification

----------------------------------------------------------

----------------------------------------------------------

Currently, there are many devices on SOCs that do not have a standard

Currently, there are many devices on SOCs that do not have a standard

    - phy-handle : The phandle for the PHY connected to this ethernet

    - phy-handle : The phandle for the PHY connected to this ethernet

      controller.

      controller.

  Recommended properties:

    - linux,network-index : This is the intended "index" of this

      network device.  This is used by the bootwrapper to interpret

      MAC addresses passed by the firmware when no information other

      than indices is available to associate an address with a device.

  Example:

  Example:

	ethernet@24000 {

	ethernet@24000 {

   and additions :  

   and additions :  

   Required properties :

   Required properties :

    - compatible : Should be "fsl-usb2-mph" for multi port host usb

    - compatible : Should be "fsl-usb2-mph" for multi port host USB

      controllers, or "fsl-usb2-dr" for dual role usb controllers

      controllers, or "fsl-usb2-dr" for dual role USB controllers

    - phy_type : For multi port host usb controllers, should be one of

    - phy_type : For multi port host USB controllers, should be one of

      "ulpi", or "serial". For dual role usb controllers, should be

      "ulpi", or "serial". For dual role USB controllers, should be

      one of "ulpi", "utmi", "utmi_wide", or "serial".

      one of "ulpi", "utmi", "utmi_wide", or "serial".

    - reg : Offset and length of the register set for the device

    - reg : Offset and length of the register set for the device

    - port0 : boolean; if defined, indicates port0 is connected for

    - port0 : boolean; if defined, indicates port0 is connected for

    - interrupt-parent : the phandle for the interrupt controller that

    - interrupt-parent : the phandle for the interrupt controller that

      services interrupts for this device.

      services interrupts for this device.

   Example multi port host usb controller device node : 

   Example multi port host USB controller device node :

	usb@22000 {

	usb@22000 {

	        device_type = "usb";

	        device_type = "usb";

		compatible = "fsl-usb2-mph";

		compatible = "fsl-usb2-mph";

		port1;

		port1;

	};

	};

   Example dual role usb controller device node : 

   Example dual role USB controller device node :

	usb@23000 {

	usb@23000 {

		device_type = "usb";

		device_type = "usb";

		compatible = "fsl-usb2-dr";

		compatible = "fsl-usb2-dr";

    - channel-fifo-len : An integer representing the number of

    - channel-fifo-len : An integer representing the number of

      descriptor pointers each channel fetch fifo can hold.

      descriptor pointers each channel fetch fifo can hold.

    - exec-units-mask : The bitmask representing what execution units

    - exec-units-mask : The bitmask representing what execution units

      (EUs) are available. It's a single 32 bit cell. EU information

      (EUs) are available. It's a single 32-bit cell. EU information

      should be encoded following the SEC's Descriptor Header Dword

      should be encoded following the SEC's Descriptor Header Dword

      EU_SEL0 field documentation, i.e. as follows:

      EU_SEL0 field documentation, i.e. as follows:

      bits 8 through 31 are reserved for future SEC EUs.

      bits 8 through 31 are reserved for future SEC EUs.

    - descriptor-types-mask : The bitmask representing what descriptors

    - descriptor-types-mask : The bitmask representing what descriptors

      are available. It's a single 32 bit cell. Descriptor type

      are available. It's a single 32-bit cell. Descriptor type

      information should be encoded following the SEC's Descriptor

      information should be encoded following the SEC's Descriptor

      Header Dword DESC_TYPE field documentation, i.e. as follows:

      Header Dword DESC_TYPE field documentation, i.e. as follows:

   Required properties:

   Required properties:

   - device_type : should be "spi".

   - device_type : should be "spi".

   - compatible : should be "fsl_spi".

   - compatible : should be "fsl_spi".

   - mode : the spi operation mode, it can be "cpu" or "qe".

   - mode : the SPI operation mode, it can be "cpu" or "qe".

   - reg : Offset and length of the register set for the device

   - reg : Offset and length of the register set for the device

   - interrupts : <a b> where a is the interrupt number and b is a

   - interrupts : <a b> where a is the interrupt number and b is a

     field that represents an encoding of the sense and level

     field that represents an encoding of the sense and level

   - mac-address : list of bytes representing the ethernet address.

   - mac-address : list of bytes representing the ethernet address.

   - phy-handle : The phandle for the PHY connected to this controller.

   - phy-handle : The phandle for the PHY connected to this controller.

   Recommended properties:

   - linux,network-index : This is the intended "index" of this

     network device.  This is used by the bootwrapper to interpret

     MAC addresses passed by the firmware when no information other

     than indices is available to associate an address with a device.

   Example:

   Example:

	ucc@2000 {

	ucc@2000 {

		device_type = "network";

		device_type = "network";

     - partitions : Several pairs of 32-bit values where the first value is

     - partitions : Several pairs of 32-bit values where the first value is

       partition's offset from the start of the device and the second one is

       partition's offset from the start of the device and the second one is

       partition size in bytes with LSB used to signify a read only

       partition size in bytes with LSB used to signify a read only

       partition (so, the parition size should always be an even number).

       partition (so, the partition size should always be an even number).

     - partition-names : The list of concatenated zero terminated strings

     - partition-names : The list of concatenated zero terminated strings

       representing the partition names.

       representing the partition names.

     - probe-type : The type of probe which should be done for the chip

     - probe-type : The type of probe which should be done for the chip

   More devices will be defined as this spec matures.

   More devices will be defined as this spec matures.

VII - Specifying interrupt information for devices

===================================================

The device tree represents the busses and devices of a hardware

system in a form similar to the physical bus topology of the

hardware.

In addition, a logical 'interrupt tree' exists which represents the

hierarchy and routing of interrupts in the hardware.

The interrupt tree model is fully described in the

document "Open Firmware Recommended Practice: Interrupt

Mapping Version 0.9".  The document is available at:

<http://playground.sun.com/1275/practice>.

1) interrupts property

----------------------

Devices that generate interrupts to a single interrupt controller

should use the conventional OF representation described in the

OF interrupt mapping documentation.

Each device which generates interrupts must have an 'interrupt'

property.  The interrupt property value is an arbitrary number of

of 'interrupt specifier' values which describe the interrupt or

interrupts for the device.

The encoding of an interrupt specifier is determined by the

interrupt domain in which the device is located in the

interrupt tree.  The root of an interrupt domain specifies in

its #interrupt-cells property the number of 32-bit cells

required to encode an interrupt specifier.  See the OF interrupt

mapping documentation for a detailed description of domains.

For example, the binding for the OpenPIC interrupt controller

specifies  an #interrupt-cells value of 2 to encode the interrupt

number and level/sense information. All interrupt children in an

OpenPIC interrupt domain use 2 cells per interrupt in their interrupts

property.

The PCI bus binding specifies a #interrupt-cell value of 1 to encode

which interrupt pin (INTA,INTB,INTC,INTD) is used.

2) interrupt-parent property

----------------------------

The interrupt-parent property is specified to define an explicit

link between a device node and its interrupt parent in

the interrupt tree.  The value of interrupt-parent is the

phandle of the parent node.

If the interrupt-parent property is not defined for a node, it's

interrupt parent is assumed to be an ancestor in the node's

_device tree_ hierarchy.

3) OpenPIC Interrupt Controllers

--------------------------------

OpenPIC interrupt controllers require 2 cells to encode

interrupt information.  The first cell defines the interrupt

number.  The second cell defines the sense and level

information.

Sense and level information should be encoded as follows:

	0 = low to high edge sensitive type enabled

	1 = active low level sensitive type enabled

	2 = active high level sensitive type enabled

	3 = high to low edge sensitive type enabled

4) ISA Interrupt Controllers

----------------------------

ISA PIC interrupt controllers require 2 cells to encode

interrupt information.  The first cell defines the interrupt

number.  The second cell defines the sense and level

information.

ISA PIC interrupt controllers should adhere to the ISA PIC

encodings listed below:

	0 =  active low level sensitive type enabled

	1 =  active high level sensitive type enabled

	2 =  high to low edge sensitive type enabled

	3 =  low to high edge sensitive type enabled

Appendix A - Sample SOC node for MPC8540

Appendix A - Sample SOC node for MPC8540

========================================

========================================

	  This option will slow down process creation somewhat.

	  This option will slow down process creation somewhat.

config DEBUG_PAGEALLOC

        bool "Debug page memory allocations"

        depends on DEBUG_KERNEL && !SOFTWARE_SUSPEND

        help

          Unmap pages from the kernel linear mapping after free_pages().

          This results in a large slowdown, but helps to find certain types

          of memory corruptions.

config HCALL_STATS

config HCALL_STATS

	bool "Hypervisor call instrumentation"

	bool "Hypervisor call instrumentation"

	depends on PPC_PSERIES && DEBUG_FS

	depends on PPC_PSERIES && DEBUG_FS

config SERIAL_TEXT_DEBUG

config SERIAL_TEXT_DEBUG

	bool "Support for early boot texts over serial port"

	bool "Support for early boot texts over serial port"

	depends on 4xx || LOPEC || MV64X60 || PPLUS || PRPMC800 || \

	depends on 4xx

		PPC_GEN550 || PPC_MPC52xx

config PPC_EARLY_DEBUG

config PPC_EARLY_DEBUG

	bool "Early debugging (dangerous)"

	bool "Early debugging (dangerous)"

# kernel considerably.

# kernel considerably.

CFLAGS += $(call cc-option,-funit-at-a-time)

CFLAGS += $(call cc-option,-funit-at-a-time)

ifndef CONFIG_FSL_BOOKE

# Never use string load/store instructions as they are

CFLAGS		+= -mstring

# often slow when they are implemented at all

endif

CFLAGS		+= -mno-string

ifeq ($(CONFIG_6xx),y)

ifeq ($(CONFIG_6xx),y)

CFLAGS		+= -mcpu=powerpc

CFLAGS		+= -mcpu=powerpc

CPPFLAGS_vmlinux.lds	:= -Upowerpc

CPPFLAGS_vmlinux.lds	:= -Upowerpc

BOOT_TARGETS = zImage zImage.initrd uImage

BOOT_TARGETS = zImage zImage.initrd uImage cuImage

PHONY += $(BOOT_TARGETS)

PHONY += $(BOOT_TARGETS)

  @echo '  *_defconfig     - Select default config from arch/$(ARCH)/configs'

  @echo '  *_defconfig     - Select default config from arch/$(ARCH)/configs'

endef

endef

install:

	$(Q)$(MAKE) $(build)=$(boot) BOOTIMAGE=$(KBUILD_IMAGE) install

archclean:

archclean:

	$(Q)$(MAKE) $(clean)=$(boot)

	$(Q)$(MAKE) $(clean)=$(boot)

kernel-vmlinux.strip.gz

kernel-vmlinux.strip.gz

mktree

mktree

uImage

uImage

cuImage

cuImage.bin.gz

cuImage.elf

zImage

zImage

zImage.chrp

zImage.chrp

zImage.coff

zImage.coff