drivers/staging/media/atomisp/pci/ia_css_firmware.h

Source file repositories/reference/linux-study-clean/drivers/staging/media/atomisp/pci/ia_css_firmware.h

File Facts

System
Linux kernel
Corpus path
drivers/staging/media/atomisp/pci/ia_css_firmware.h
Extension
.h
Size
1720 bytes
Lines
58
Domain
Driver Families
Bucket
drivers/staging
Inferred role
Driver Families: implementation source
Status
source implementation candidate

Why This File Exists

Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.

Dependency Surface

Detected Declarations

Annotated Snippet

struct ia_css_fw {
	void	    *data;  /** pointer to the firmware data */
	unsigned int bytes; /** length in bytes of firmware data */
};

struct device;

/* @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 -EINVAL in case of any
 *				errors and 0 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.
 */
int
ia_css_load_firmware(struct device *dev, 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.
 * This function may only be called when the CSS API is in uninitialized state
 * (e.g. after calling ia_css_uninit()).
 */
void
ia_css_unload_firmware(void);

#endif /* __IA_CSS_FIRMWARE_H */

Annotation

Implementation Notes