mirror of
https://github.com/u-boot/u-boot.git
synced 2025-04-30 08:07:59 +00:00

Driver model currently only operates after relocation is complete. In this state U-Boot typically has a small amount of memory available. In adding support for driver model prior to relocation we must try to use as little memory as possible. In addition, on some machines the memory has not be inited and/or the CPU is not running at full speed or the data cache is off. These can reduce execution performance, so the less initialisation that is done before relocation the better. An immediately-obvious improvement is to only initialise drivers which are actually going to be used before relocation. On many boards the only such driver is a serial UART, so this provides a very large potential benefit. Allow drivers to mark themselves as 'pre-reloc' which means that they will be initialised prior to relocation. This can be done either with a driver flag or with a 'dm,pre-reloc' device tree property. To support this, the various dm scanning function now take a 'pre_reloc_only' parameter which indicates that only drivers marked pre-reloc should be bound. Signed-off-by: Simon Glass <sjg@chromium.org>
65 lines
1.5 KiB
C
65 lines
1.5 KiB
C
/*
|
|
* Copyright (c) 2013 Google, Inc
|
|
*
|
|
* (C) Copyright 2012
|
|
* Pavel Herrmann <morpheus.ibis@gmail.com>
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0+
|
|
*/
|
|
|
|
#ifndef _DM_ROOT_H_
|
|
#define _DM_ROOT_H_
|
|
|
|
struct udevice;
|
|
|
|
/**
|
|
* dm_root() - Return pointer to the top of the driver tree
|
|
*
|
|
* This function returns pointer to the root node of the driver tree,
|
|
*
|
|
* @return pointer to root device, or NULL if not inited yet
|
|
*/
|
|
struct udevice *dm_root(void);
|
|
|
|
/**
|
|
* dm_scan_platdata() - Scan all platform data and bind drivers
|
|
*
|
|
* This scans all available platdata and creates drivers for each
|
|
*
|
|
* @pre_reloc_only: If true, bind only drivers with the DM_FLAG_PRE_RELOC
|
|
* flag. If false bind all drivers.
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int dm_scan_platdata(bool pre_reloc_only);
|
|
|
|
/**
|
|
* dm_scan_fdt() - Scan the device tree and bind drivers
|
|
*
|
|
* This scans the device tree and creates a driver for each node
|
|
*
|
|
* @blob: Pointer to device tree blob
|
|
* @pre_reloc_only: If true, bind only drivers with the DM_FLAG_PRE_RELOC
|
|
* flag. If false bind all drivers.
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int dm_scan_fdt(const void *blob, bool pre_reloc_only);
|
|
|
|
/**
|
|
* dm_init() - Initialise Driver Model structures
|
|
*
|
|
* This function will initialize roots of driver tree and class tree.
|
|
* This needs to be called before anything uses the DM
|
|
*
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int dm_init(void);
|
|
|
|
/**
|
|
* dm_uninit - Uninitialise Driver Model structures
|
|
*
|
|
* All devices will be removed and unbound
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int dm_uninit(void);
|
|
|
|
#endif
|