dm: Add comments to dt-structs contents

These structs do not have comments at present. Add them.

Signed-off-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
Simon Glass 2021-08-07 07:24:08 -06:00
parent f99cbe4e86
commit 4ee0cc89db

View File

@ -10,16 +10,43 @@
#if CONFIG_IS_ENABLED(OF_PLATDATA)
struct driver_info;
/**
* struct phandle_0_arg - hold a phandle record with no arguments
*
* This holds a phandle pointing to another device. See 'Indexes' in the
* of-plat-rst documentation.
*
* @idx: udevice index (or driver_info index if !OF_PLATDATA_INST)
* @arg: arguments
*/
struct phandle_0_arg {
uint idx;
int arg[0];
};
/**
* struct phandle_2_arg - hold a phandle record with up to one argument
*
* This holds a phandle pointing to another device. See 'Indexes' in the
* of-plat-rst documentation.
*
* @idx: udevice index (or driver_info index if !OF_PLATDATA_INST)
* @arg: arguments
*/
struct phandle_1_arg {
uint idx;
int arg[1];
};
/**
* struct phandle_2_arg - hold a phandle record with up to two arguments
*
* This holds a phandle pointing to another device. See 'Indexes' in the
* of-plat-rst documentation.
*
* @idx: udevice index (or driver_info index if !OF_PLATDATA_INST)
* @arg: arguments
*/
struct phandle_2_arg {
uint idx;
int arg[2];