u-boot/include/fs_loader.h
Sean Anderson 0998a20cfc misc: fs_loader: Add function to get the chosen loader
The fs_loader device is used to pull in settings via the chosen node.
However, there was no library function for this, so arria10 was doing it
explicitly. This function subsumes that, and uses ofnode_get_chosen_node
instead of navigating the device tree directly. Because fs_loader pulls
its config from the environment by default, it's fine to create a device
with nothing backing it at all. Doing this allows enabling
CONFIG_FS_LOADER without needing to modify the device tree.

Signed-off-by: Sean Anderson <sean.anderson@seco.com>
Reviewed-by: Simon Glass <sjg@chromium.org>
Reviewed-by: Ramon Fried <rfried.dev@gmail.com>
2023-01-12 14:06:15 -05:00

67 lines
1.8 KiB
C

/*
* Copyright (C) 2018 Intel Corporation <www.intel.com>
*
* SPDX-License-Identifier: GPL-2.0
*/
#ifndef _FS_LOADER_H_
#define _FS_LOADER_H_
struct udevice;
/**
* struct phandle_part - A place for storing phandle of node and its partition
*
* This holds information about a phandle of the block device, and its
* partition where the firmware would be loaded from.
*
* @phandle: Phandle of storage device node
* @partition: Partition of block device
*/
struct phandle_part {
u32 phandle;
u32 partition;
};
/**
* struct phandle_part - A place for storing all supported storage devices
*
* This holds information about all supported storage devices for driver use.
*
* @phandlepart: Attribute data for block device.
* @mtdpart: MTD partition for ubi partition.
* @ubivol: UBI volume-name for ubifsmount.
*/
struct device_plat {
struct phandle_part phandlepart;
char *mtdpart;
char *ubivol;
};
/**
* request_firmware_into_buf - Load firmware into a previously allocated buffer.
* @dev: An instance of a driver.
* @name: Name of firmware file.
* @buf: Address of buffer to load firmware into.
* @size: Size of buffer.
* @offset: Offset of a file for start reading into buffer.
*
* The firmware is loaded directly into the buffer pointed to by @buf.
*
* Return: Size of total read, negative value when error.
*/
int request_firmware_into_buf(struct udevice *dev,
const char *name,
void *buf, size_t size, u32 offset);
/**
* get_fs_loader() - Get the chosen filesystem loader
* @dev: Where to store the device
*
* This gets a filesystem loader device based on the value of
* /chosen/firmware-loader. If no such property exists, it returns a
* firmware loader which is configured by environmental variables.
*
* Return: 0 on success, negative value on error
*/
int get_fs_loader(struct udevice **dev);
#endif