| /* |
| * Support for Intel Camera Imaging ISP subsystem. |
| * Copyright (c) 2015, Intel Corporation. |
| * |
| * This program is free software; you can redistribute it and/or modify it |
| * under the terms and conditions of the GNU General Public License, |
| * version 2, as published by the Free Software Foundation. |
| * |
| * This program is distributed in the hope 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 __IA_CSS_FIRMWARE_H |
| #define __IA_CSS_FIRMWARE_H |
| |
| /** @file |
| * This file contains firmware loading/unloading support functionality |
| */ |
| |
| #include "ia_css_err.h" |
| #include "ia_css_env.h" |
| |
| /** CSS firmware package structure. |
| */ |
| struct ia_css_fw { |
| void *data; /**< pointer to the firmware data */ |
| unsigned int bytes; /**< length in bytes of firmware data */ |
| }; |
| |
| /** @brief Loads the firmware |
| * @param[in] env Environment, provides functions to access the |
| * environment in which the CSS code runs. This is |
| * used for host side memory access and message |
| * printing. |
| * @param[in] fw Firmware package containing the firmware for all |
| * predefined ISP binaries. |
| * @return Returns IA_CSS_ERR_INTERNAL_ERROR in case of any |
| * errors and IA_CSS_SUCCESS otherwise. |
| * |
| * This function interprets the firmware package. All |
| * contents of this firmware package are copied into local data structures, so |
| * the fw pointer could be freed after this function completes. |
| * |
| * Rationale for this function is that it can be called before ia_css_init, and thus |
| * speeds up ia_css_init (ia_css_init is called each time a stream is created but the |
| * firmware only needs to be loaded once). |
| */ |
| enum ia_css_err |
| ia_css_load_firmware(const struct ia_css_env *env, |
| const struct ia_css_fw *fw); |
| |
| /** @brief Unloads the firmware |
| * @return None |
| * |
| * This function unloads the firmware loaded by ia_css_load_firmware. |
| * It is pointless to call this function if no firmware is loaded, |
| * but it won't harm. Use this to deallocate all memory associated with the firmware. |
| */ |
| void |
| ia_css_unload_firmware(void); |
| |
| /** @brief Checks firmware version |
| * @param[in] fw Firmware package containing the firmware for all |
| * predefined ISP binaries. |
| * @return Returns true when the firmware version matches with the CSS |
| * host code version and returns false otherwise. |
| * This function checks if the firmware package version matches with the CSS host code version. |
| */ |
| bool |
| ia_css_check_firmware_version(const struct ia_css_fw *fw); |
| |
| #endif /* __IA_CSS_FIRMWARE_H */ |
