diff options
author | Juergen Beisert <jbe@pengutronix.de> | 2014-09-08 11:29:07 +0200 |
---|---|---|
committer | Sascha Hauer <s.hauer@pengutronix.de> | 2014-09-09 10:30:25 +0200 |
commit | a6982e2e262440f551fe4dac0378d2dea76c86f5 (patch) | |
tree | 931c5e1661eb0c3971ea5407ee1e1dd115253d1f /include | |
parent | 5a5ba5ad30f22f0e3a4c0c56d180261136e3dfe4 (diff) | |
download | barebox-a6982e2e262440f551fe4dac0378d2dea76c86f5.tar.gz |
Add a Firmware programming framework
This framework handles a list of registered Firmware programming handlers
to unify a firmware programming interface by hiding the details how
to program a specific Firmware in its handler. This is created with FPGAs
in mind but should be usable for other devices aswell.
A user has two possibilities to load a firmware. A device file is create
under /dev/ which can be used to copy a firmware to. Additionally a
firmwareload command is introduced which can list the registered firmware
handlers and also to upload a firmware.
Signed-off-by: Juergen Beisert <jbe@pengutronix.de>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
Signed-off-by: Steffen Trumtrar <s.trumtrar@pengutronix.de>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
Diffstat (limited to 'include')
-rw-r--r-- | include/firmware.h | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/include/firmware.h b/include/firmware.h new file mode 100644 index 0000000000..f6f78c840c --- /dev/null +++ b/include/firmware.h @@ -0,0 +1,42 @@ +/* + * Copyright (c) 2013 Juergen Beisert <kernel@pengutronix.de>, Pengutronix + * + * This program is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License version 2 + * as published by the Free Software Foundation. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + */ + +#ifndef FIRMWARE_H +#define FIRMWARE_H + +#include <types.h> +#include <driver.h> + +struct firmware_handler { + char *id; /* unique identifier for this firmware device */ + char *model; /* description for this device */ + struct device_d *dev; + /* called once to prepare the firmware's programming cycle */ + int (*open)(struct firmware_handler*); + /* called multiple times to program the firmware with the given data */ + int (*write)(struct firmware_handler*, const void*, size_t); + /* called once to finish programming cycle */ + int (*close)(struct firmware_handler*); +}; + +struct firmware_mgr; + +int firmwaremgr_register(struct firmware_handler *); + +struct firmware_mgr *firmwaremgr_find(const char *); + +void firmwaremgr_list_handlers(void); + +int firmwaremgr_load_file(struct firmware_mgr *, const char *path); + +#endif /* FIRMWARE_H */ |