Files
linux-nvgpu/drivers/gpu/nvgpu/include/nvgpu/firmware.h
Philip Elcan dc9ba05cd4 gpu: nvgpu: firmware: use u32 for flags
Update the nvgpu_request_firmware API to use u32 for the flags
parameter. The API previously defined the flags parameter to be an int.
However, the flags were defined as UL. This was causing MISRA 10.3
violations for implicitly assigning an object of different essential
type. So, this change makes all definitions a u32.

JIRA NVGPU-1008

Change-Id: I09eb75d4e2a20e7ac6dba80d3bc06335d3c78d62
Signed-off-by: Philip Elcan <pelcan@nvidia.com>
Reviewed-on: https://git-master.nvidia.com/r/2023223
Reviewed-by: svc-misra-checker <svc-misra-checker@nvidia.com>
Reviewed-by: svc-mobile-coverity <svc-mobile-coverity@nvidia.com>
GVS: Gerrit_Virtual_Submit
Reviewed-by: Adeel Raza <araza@nvidia.com>
Reviewed-by: mobile promotions <svcmobile_promotions@nvidia.com>
Tested-by: mobile promotions <svcmobile_promotions@nvidia.com>
2019-02-20 23:05:04 -08:00

75 lines
2.5 KiB
C

/*
* Copyright (c) 2016-2019, NVIDIA CORPORATION. All rights reserved.
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#ifndef NVGPU_FIRMWARE_H
#define NVGPU_FIRMWARE_H
#include <nvgpu/types.h>
struct gk20a;
#define NVGPU_REQUEST_FIRMWARE_NO_WARN BIT32(0)
#define NVGPU_REQUEST_FIRMWARE_NO_SOC BIT32(1)
struct nvgpu_firmware {
u8 *data;
size_t size;
};
/**
* nvgpu_request_firmware - load a firmware blob from filesystem.
*
* @g The GPU driver struct for device to load firmware for
* @fw_name The base name of the firmware file.
* @flags Flags for loading;
*
* NVGPU_REQUEST_FIRMWARE_NO_WARN: Do not display warning on
* failed load.
*
* NVGPU_REQUEST_FIRMWARE_NO_SOC: Do not attempt loading from
* path <SOC_NAME>.
*
* nvgpu_request_firmware() will load firmware from:
*
* <system firmware load path>/<GPU name>/<fw_name>
*
* If that fails and NO_SOC is not enabled, it'll try next from:
*
* <system firmware load path>/<SOC name>/<fw_name>
*
* It'll allocate a nvgpu_firmware structure and initializes it and returns
* it to caller.
*/
struct nvgpu_firmware *nvgpu_request_firmware(struct gk20a *g,
const char *fw_name,
u32 flags);
/**
* nvgpu_release_firmware - free firmware and associated nvgpu_firmware blob
*
* @g The GPU driver struct for device to free firmware for
* @fw The firmware to free. fw blob will also be freed.
*/
void nvgpu_release_firmware(struct gk20a *g, struct nvgpu_firmware *fw);
#endif /* NVGPU_FIRMWARE_H */