665891e3a8
This change adds a helper function `fw_config_probe_dev()` that allows the caller to check if any of the probe conditions are true for any given device. If device has no probe conditions or a matching probe condition, then it returns true and provides the matching probe condition back to caller (if provided with a valid pointer). Else, it returns false. When fw_config support is disabled, this function always returns true. Change-Id: Ic2dae338e6fbd7755feb23ca86c50c42103f349b Signed-off-by: Furquan Shaikh <furquan@google.com> Reviewed-on: https://review.coreboot.org/c/coreboot/+/54751 Reviewed-by: Tim Wawrzynczak <twawrzynczak@chromium.org> Reviewed-by: Karthik Ramasubramanian <kramasub@google.com> Reviewed-by: EricR Lai <ericr_lai@compal.corp-partner.google.com> Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
102 lines
3.2 KiB
C
102 lines
3.2 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
|
|
#ifndef __FW_CONFIG__
|
|
#define __FW_CONFIG__
|
|
|
|
#include <device/device.h>
|
|
#include <static.h> /* Provides fw_config definitions from devicetree.cb */
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
|
|
#define UNDEFINED_FW_CONFIG ~((uint64_t)0)
|
|
|
|
/**
|
|
* struct fw_config - Firmware configuration field and option.
|
|
* @field_name: Name of the field that this option belongs to.
|
|
* @option_name: Name of the option within this field.
|
|
* @mask: Bitmask of the field.
|
|
* @value: Value of the option within the mask.
|
|
*/
|
|
struct fw_config {
|
|
const char *field_name;
|
|
const char *option_name;
|
|
uint64_t mask;
|
|
uint64_t value;
|
|
};
|
|
|
|
/* Generate a pointer to a compound literal of the fw_config structure. */
|
|
#define FW_CONFIG(__field, __option) (&(const struct fw_config) { \
|
|
.field_name = FW_CONFIG_FIELD_##__field##_NAME, \
|
|
.option_name = FW_CONFIG_FIELD_##__field##_OPTION_##__option##_NAME, \
|
|
.mask = FW_CONFIG_FIELD_##__field##_MASK, \
|
|
.value = FW_CONFIG_FIELD_##__field##_OPTION_##__option##_VALUE \
|
|
})
|
|
|
|
/**
|
|
* fw_config_get() - Provide firmware configuration value.
|
|
*
|
|
* Return 64bit firmware configuration value determined for the system.
|
|
*/
|
|
uint64_t fw_config_get(void);
|
|
|
|
#if CONFIG(FW_CONFIG)
|
|
|
|
/**
|
|
* fw_config_probe() - Check if field and option matches.
|
|
* @match: Structure containing field and option to probe.
|
|
*
|
|
* Return %true if match is found, %false if match is not found.
|
|
*/
|
|
bool fw_config_probe(const struct fw_config *match);
|
|
|
|
/**
|
|
* fw_config_for_each_found() - Call a callback for each fw_config field found
|
|
* @cb: The callback function
|
|
* @arg: A context argument that is passed to the callback
|
|
*/
|
|
void fw_config_for_each_found(void (*cb)(const struct fw_config *config, void *arg), void *arg);
|
|
|
|
/**
|
|
* fw_config_is_provisioned() - Determine if FW_CONFIG has been provisioned.
|
|
* Return %true if FW_CONFIG has been provisioned, %false otherwise.
|
|
*/
|
|
bool fw_config_is_provisioned(void);
|
|
|
|
/**
|
|
* fw_config_get_found() - Return a pointer to the fw_config struct for a given field.
|
|
* @field_mask: A field mask from static.h, e.g., FW_CONFIG_FIELD_FEATURE_MASK
|
|
*
|
|
* Return pointer to cached `struct fw_config` if successfully probed, otherwise NULL.
|
|
*/
|
|
const struct fw_config *fw_config_get_found(uint64_t field_mask);
|
|
|
|
/**
|
|
* fw_config_probe_dev() - Check if any of the probe conditions are true for given device.
|
|
* @dev: Device for which probe conditions are checked
|
|
* @matching_probe: If any probe condition match, then the matching probe condition is returned
|
|
* to the caller.
|
|
* Return %true if device has no probing conditions or if a matching probe condition is
|
|
* encountered, %false otherwise.
|
|
*/
|
|
bool fw_config_probe_dev(const struct device *dev, const struct fw_config **matching_probe);
|
|
|
|
#else
|
|
|
|
static inline bool fw_config_probe(const struct fw_config *match)
|
|
{
|
|
/* Always return true when probing with disabled fw_config. */
|
|
return true;
|
|
}
|
|
|
|
static inline bool fw_config_probe_dev(const struct device *dev,
|
|
const struct fw_config **matching_probe)
|
|
{
|
|
/* Always return true when probing with disabled fw_config. */
|
|
if (matching_probe)
|
|
*matching_probe = NULL;
|
|
return true;
|
|
}
|
|
|
|
#endif /* CONFIG(FW_CONFIG) */
|
|
|
|
#endif /* __FW_CONFIG__ */
|