u-boot.git/doc/driver-model, branch v2018.01

dtoc: Rename the phandle struct

2017-09-15T11:27:47+00:00

Rather than naming the phandle struct according to the number of cells it
uses (e.g. struct phandle_2_cell) name it according to the number of
arguments it has (e.g. struct phandle_1_arg). This is a more intuitive
naming.

Signed-off-by: Simon Glass 
Tested-by: Kever Yang

dm: core: Add livetree documentation

2017-09-04T08:10:06+00:00

Add some documentation for the live device tree support in U-Boot. This
was missing from the initial series.

Signed-off-by: Simon Glass 
Suggested-by: Lukasz Majewski 
Reviewed-by: Łukasz Majewski

dm: Add migration plan for CONFIG_BLK

2017-09-04T08:10:06+00:00

The CONFIG_BLK conversion involves quite invasive changes in the U-Boot
code, with #ifdefs and different code paths. We should try to move over to
this soon so we can drop the old code.

Set a deadline of 9 months for this work, rounded up to the next release.

Signed-off-by: Simon Glass 
Reviewed-by: Tom Rini

dtoc: Support multiple compatible strings in a node

2017-07-11T16:08:19+00:00

Sometimes a node will have multiple compatible strings. Drivers may use
one or the other so the best approach seems to be to #define them to be
equivalent.

Update dtoc to support this.

Signed-off-by: Simon Glass 
Tested-by: Kever Yang

dm: Add callback to modify the device tree

2017-03-23T14:46:23+00:00

Certain boards come in different variations by way of utilizing daughter
boards, for example. These boards might contain additional chips, which
are added to the main board's busses, e.g. I2C.

The device tree support for such boards would either, quite naturally,
employ the overlay mechanism to add such chips to the tree, or would use
one large default device tree, and delete the devices that are actually
not present.

Regardless of approach, even on the U-Boot level, a modification of the
device tree is a prerequisite to have such modular families of boards
supported properly.

Therefore, we add an option to make the U-Boot device tree (the actual
copy later used by the driver model) writeable, and add a callback
method that allows boards to modify the device tree at an early stage,
at which, hopefully, also the application of device tree overlays will
be possible.

Signed-off-by: Mario Six 
Reviewed-by: Simon Glass 
Signed-off-by: Stefan Roese

dm: allow limiting pre-reloc markings to spl or tpl

2017-03-16T22:03:44+00:00

Right now the u-boot,dm-pre-reloc flag will make each marked node
always appear in both spl and tpl. But systems needing an additional
tpl might have special constraints for each, like the spl needing to
be very tiny.

So introduce two additional flags to mark nodes for only spl or tpl
environments and introduce a function dm_fdt_pre_reloc to automate
the necessary checks in code instances checking for pre-relocation
flags.

The behaviour of the original flag stays untouched and still marks
a node for both spl and tpl.

Signed-off-by: Heiko Stuebner 
Reviewed-by: Simon Glass 
Tested-by: Kever Yang

dm: core: Replace of_offset with accessor

2017-02-08T13:12:14+00:00

At present devices use a simple integer offset to record the device tree
node associated with the device. In preparation for supporting a live
device tree, which uses a node pointer instead, refactor existing code to
access this field through an inline function.

Signed-off-by: Simon Glass

dm: Add timeline and guide for porting I2C drivers

2016-12-05T12:28:12+00:00

Add a README with a brief guide to porting i2c drivers over to use driver
model.

Add a timeline also. All I2C drivers should be converted by the end
of June 2017.

Signed-off-by: Simon Glass 
Acked-by: Heiko Schocher

serial: Drop the s3c24x0 serial driver

2016-12-04T18:55:00+00:00

This is not used by any boards. Drop it.

Signed-off-by: Simon Glass 
Acked-by: David Müller 
Reviewed-by: Jagan Teki

serial: Update docs to indicate mcfuart supports DM_SERIAL

2016-12-04T18:54:59+00:00

This driver was converted so we should remove it from the list.

Signed-off-by: Simon Glass