From: Tien Fong Chee <tien.fong.c...@intel.com>

Provide information about

- overview of file system firmware loader driver model
- describe default storage device in device tree source
- describe fie system firmware loader API

Signed-off-by: Tien Fong Chee <tien.fong.c...@intel.com>
---
 doc/driver-model/fs_firmware_loader.txt |  100 +++++++++++++++++++++++++++++++
 1 files changed, 100 insertions(+), 0 deletions(-)
 create mode 100644 doc/driver-model/fs_firmware_loader.txt

diff --git a/doc/driver-model/fs_firmware_loader.txt 
b/doc/driver-model/fs_firmware_loader.txt
new file mode 100644
index 0000000..167660a
--- /dev/null
+++ b/doc/driver-model/fs_firmware_loader.txt
@@ -0,0 +1,100 @@
+/*
+ * Copyright (C) 2018 Intel Corporation <www.intel.com>
+ *
+ * SPDX-License-Identifier:    GPL-2.0
+ */
+
+Introduction
+------------
+This is file system firmware loader for U-Boot framework, which has very close
+to some Linux Firmware API. For the details of Linux Firmware API, you can 
refer
+to https://01.org/linuxgraphics/gfx-docs/drm/driver-api/firmware/index.html.
+
+File system firmware loader can be used to load whatever(firmware, image,
+and binary) from the storage device in file system format into target location
+such as memory, then consumer driver such as FPGA driver can program FPGA image
+from the target location into FPGA.
+
+To enable firmware loader driver model, CONFIG_FS_LOADER need to be set at
+<board_name>_defconfig such as "CONFIG_FS_LOADER=y".
+
+Firmware Loader API core features
+---------------------------------
+=> Firmware storage device described in device tree source
+   ----------------------------------------
+   =>  Example of default storage device partition search set for mmc, usb,
+       sata and ubi as shown in below:
+       Example for mmc:
+       fs_loader {
+               u-boot,dm-pre-reloc;
+               compatible = "fs_loader";
+               storage_device = "mmc";
+               devpart = "0:1";
+       };
+
+       Example for usb:
+       fs_loader {
+               u-boot,dm-pre-reloc;
+               compatible = "fs_loader";
+               storage_device = "usb";
+               devpart = "0:1";
+       };
+
+       Example for sata:
+       fs_loader {
+               u-boot,dm-pre-reloc;
+               compatible = "fs_loader";
+               storage_device = "sata";
+               devpart = "0:1";
+       };
+
+       Example for ubi:
+       fs_loader {
+               u-boot,dm-pre-reloc;
+               compatible = "fs_loader";
+               storage_device = "ubi";
+               mtdpart = "UBI",
+               ubivol = "ubi0";
+       };
+
+
+       However, the default fs_loader with property devpart, mtdpart, and
+       ubivol values can be overwritten with value which is defined in the
+       environment variable "fw_dev_part", "fw_ubi_mtdpart", and
+       "fw_ubi_volume" respectively.
+       For example: env_set("fw_dev_part", "0:2");
+
+File system firmware Loader API
+-------------------------------
+=> int request_firmware_into_buf(struct udevice *dev,
+                                struct firmware **firmware_p,
+                                const char *name,
+                                void *buf, size_t size, u32 offset)
+   -----------------------------------------------------------------
+   =>  Load firmware into a previously allocated buffer
+
+       Parameters:
+       struct udevice *dev
+               An instance of a driver
+
+       struct firmware **firmware_p
+               pointer to firmware image
+
+       const char *name
+               name of firmware file
+
+       void *buf
+               address of buffer to load firmware into
+
+       size_t size
+               size of buffer
+
+       u32 offset
+               offset of a file for start reading into buffer
+
+       return: size of total read
+               -ve when error
+
+       Description:
+       The firmware is loaded directly into the buffer pointed to by buf and
+       the @firmware_p data member is pointed at buf.
-- 
1.7.7.4

_______________________________________________
U-Boot mailing list
U-Boot@lists.denx.de
https://lists.denx.de/listinfo/u-boot

Reply via email to