From 591c7ebf18359e9686aa592bc5636e9811a5a468 Mon Sep 17 00:00:00 2001 From: Tim Wawrzynczak Date: Tue, 15 Feb 2022 17:59:58 -0700 Subject: [PATCH] drivers/tpm/spi: Convert static functions to enum cb_err return types Instead of using raw integers to indicate success/failure, enum cb_err can be used to makes things clearer, so this patch converts most functions to return that instead of int. TEST=boot to OS on google/dratini, no TPM errors seen Signed-off-by: Tim Wawrzynczak Change-Id: Ifb749c931fe008b16d42fcf157af820ec8fbf5ac Reviewed-on: https://review.coreboot.org/c/coreboot/+/61976 Tested-by: build bot (Jenkins) Reviewed-by: Felix Held --- src/drivers/spi/tpm/tpm.c | 144 +++++++++++++++++++------------------- 1 file changed, 71 insertions(+), 73 deletions(-) diff --git a/src/drivers/spi/tpm/tpm.c b/src/drivers/spi/tpm/tpm.c index 9c7baa9d3a..971e60348f 100644 --- a/src/drivers/spi/tpm/tpm.c +++ b/src/drivers/spi/tpm/tpm.c @@ -16,9 +16,10 @@ #include #include #include +#include #include #include -#include +#include #include "tpm.h" @@ -86,30 +87,25 @@ __weak int tis_plat_irq_status(void) /* * TPM may trigger a IRQ after finish processing previous transfer. * Waiting for this IRQ to sync TPM status. - * - * Returns 1 on success, 0 on failure (timeout). */ -static int tpm_sync(void) +static enum cb_err tpm_sync(void) { struct stopwatch sw; stopwatch_init_msecs_expire(&sw, 10); while (!tis_plat_irq_status()) { - if (stopwatch_expired(&sw)) { - printk(BIOS_ERR, "Timeout wait for TPM IRQ!\n"); - return 0; - } + if (stopwatch_expired(&sw)) + return CB_ERR; } - return 1; + + return CB_SUCCESS; } /* * Each TPM2 SPI transaction starts the same: CS is asserted, the 4 byte * header is sent to the TPM, the master waits til TPM is ready to continue. - * - * Returns 1 on success, 0 on failure (TPM SPI flow control timeout.) */ -static int start_transaction(int read_write, size_t bytes, unsigned int addr) +static enum cb_err start_transaction(int read_write, size_t bytes, unsigned int addr) { spi_frame_header header, header_resp; uint8_t byte; @@ -128,7 +124,9 @@ static int start_transaction(int read_write, size_t bytes, unsigned int addr) /* Wait for TPM to finish previous transaction if needed */ if (tpm_sync_needed) { - tpm_sync(); + if (tpm_sync() != CB_SUCCESS) + printk(BIOS_ERR, "Timeout waiting for TPM IRQ!\n"); + /* * During the first invocation of this function on each stage * this if () clause code does not run (as tpm_sync_needed @@ -207,11 +205,11 @@ static int start_transaction(int read_write, size_t bytes, unsigned int addr) if (ret) { printk(BIOS_ERR, "SPI-TPM: transfer error\n"); spi_release_bus(&spi_slave); - return 0; + return CB_ERR; } if (header_resp.body[3] & 1) - return 1; + return CB_SUCCESS; /* * Now poll the bus until TPM removes the stall bit. Give it up to 100 @@ -222,12 +220,12 @@ static int start_transaction(int read_write, size_t bytes, unsigned int addr) if (stopwatch_expired(&sw)) { printk(BIOS_ERR, "TPM flow control failure\n"); spi_release_bus(&spi_slave); - return 0; + return CB_ERR; } spi_xfer(&spi_slave, NULL, 0, &byte, 1); } while (!(byte & 1)); - return 1; + return CB_SUCCESS; } /* @@ -308,48 +306,45 @@ static void read_bytes(void *buffer, size_t bytes) /* * To write a register, start transaction, transfer data to the TPM, deassert * CS when done. - * - * Returns one to indicate success, zero to indicate failure. */ -static int tpm2_write_reg(unsigned int reg_number, const void *buffer, size_t bytes) +static enum cb_err tpm2_write_reg(unsigned int reg_number, const void *buffer, size_t bytes) { trace_dump("W", reg_number, bytes, buffer, 0); - if (!start_transaction(false, bytes, reg_number)) - return 0; + if (start_transaction(false, bytes, reg_number) != CB_SUCCESS) + return CB_ERR; write_bytes(buffer, bytes); spi_release_bus(&spi_slave); - return 1; + return CB_SUCCESS; } /* * To read a register, start transaction, transfer data from the TPM, deassert * CS when done. * - * Returns one to indicate success, zero to indicate failure. In case of - * failure zero out the user buffer. + * In case of failure zero out the user buffer. */ -static int tpm2_read_reg(unsigned int reg_number, void *buffer, size_t bytes) +static enum cb_err tpm2_read_reg(unsigned int reg_number, void *buffer, size_t bytes) { - if (!start_transaction(true, bytes, reg_number)) { + if (start_transaction(true, bytes, reg_number) != CB_SUCCESS) { memset(buffer, 0, bytes); - return 0; + return CB_ERR; } read_bytes(buffer, bytes); spi_release_bus(&spi_slave); trace_dump("R", reg_number, bytes, buffer, 0); - return 1; + return CB_SUCCESS; } /* * Status register is accessed often, wrap reading and writing it into * dedicated functions. */ -static int read_tpm_sts(uint32_t *status) +static enum cb_err read_tpm_sts(uint32_t *status) { return tpm2_read_reg(TPM_STS_REG, status, sizeof(*status)); } -static int __must_check write_tpm_sts(uint32_t status) +static enum cb_err __must_check write_tpm_sts(uint32_t status) { return tpm2_write_reg(TPM_STS_REG, &status, sizeof(status)); } @@ -383,7 +378,7 @@ static void tpm2_write_access_reg(uint8_t cmd) tpm2_write_reg(TPM_ACCESS_REG, &cmd, sizeof(cmd)); } -static int tpm2_claim_locality(void) +static enum cb_err tpm2_claim_locality(void) { uint8_t access; struct stopwatch sw; @@ -422,17 +417,18 @@ static int tpm2_claim_locality(void) printk(BIOS_INFO, "TPM ready after %ld ms\n", stopwatch_duration_msecs(&sw)); - return 1; + return CB_SUCCESS; } while (!stopwatch_expired(&sw)); printk(BIOS_ERR, "Failed to claim locality 0 after %ld ms, status: %#x\n", stopwatch_duration_msecs(&sw), access); - return 0; + return CB_ERR; } -static int cr50_parse_fw_version(const char *version_str, struct cr50_firmware_version *ver) +static enum cb_err cr50_parse_fw_version(const char *version_str, + struct cr50_firmware_version *ver) { int epoch, major, minor; @@ -440,33 +436,33 @@ static int cr50_parse_fw_version(const char *version_str, struct cr50_firmware_v if (!number) number = strstr(version_str, " RW_B:"); if (!number) - return -1; + return CB_ERR_ARG; number += 6; /* Skip past the colon. */ epoch = skip_atoi(&number); if (*number++ != '.') - return -2; + return CB_ERR_ARG; major = skip_atoi(&number); if (*number++ != '.') - return -2; + return CB_ERR_ARG; minor = skip_atoi(&number); ver->epoch = epoch; ver->major = major; ver->minor = minor; - return 0; + return CB_SUCCESS; } -static int cr50_fw_supports_board_cfg(struct cr50_firmware_version *version) +static bool cr50_fw_supports_board_cfg(struct cr50_firmware_version *version) { /* Cr50 supports the CR50_BOARD_CFG register from version 0.5.5 / 0.6.5 * and onwards. */ if (version->epoch > 0 || version->major >= 7 || (version->major >= 5 && version->minor >= 5)) - return 1; + return true; printk(BIOS_INFO, "Cr50 firmware does not support CR50_BOARD_CFG, version: %d.%d.%d\n", version->epoch, version->major, version->minor); - return 0; + return false; } /** @@ -478,7 +474,8 @@ static void cr50_set_board_cfg(void) if (!cr50_fw_supports_board_cfg(&cr50_firmware_version)) return; /* Set the CR50_BOARD_CFG register, for e.g. asking cr50 to use longer ready pulses. */ - if (!tpm2_read_reg(CR50_BOARD_CFG, &board_cfg_value, sizeof(board_cfg_value))) { + if (tpm2_read_reg(CR50_BOARD_CFG, &board_cfg_value, sizeof(board_cfg_value)) + != CB_SUCCESS) { printk(BIOS_INFO, "Error reading from cr50\n"); return; } @@ -499,7 +496,8 @@ static void cr50_set_board_cfg(void) printk(BIOS_INFO, "Current CR50_BOARD_CFG = 0x%08x, setting to 0x%08x\n", board_cfg_value, CR50_BOARD_CFG_VALUE); board_cfg_value = CR50_BOARD_CFG_VALUE; - if (!tpm2_write_reg(CR50_BOARD_CFG, &board_cfg_value, sizeof(board_cfg_value))) + if (tpm2_write_reg(CR50_BOARD_CFG, &board_cfg_value, sizeof(board_cfg_value)) + != CB_SUCCESS) printk(BIOS_INFO, "Error writing to cr50\n"); } @@ -512,7 +510,9 @@ static uint32_t cr50_get_board_cfg(void) uint32_t board_cfg_value; if (!cr50_fw_supports_board_cfg(&cr50_firmware_version)) return 0; - if (!tpm2_read_reg(CR50_BOARD_CFG, &board_cfg_value, sizeof(board_cfg_value))) { + + if (tpm2_read_reg(CR50_BOARD_CFG, &board_cfg_value, sizeof(board_cfg_value)) + != CB_SUCCESS) { printk(BIOS_INFO, "Error reading from cr50\n"); return 0; } @@ -530,7 +530,7 @@ static const uint32_t supported_did_vids[] = { 0x0000104a /* ST33HTPH2E32 */ }; -static int first_access_this_boot(void) +static bool first_access_this_boot(void) { return ENV_SEPARATE_VERSTAGE || ENV_BOOTBLOCK || !CONFIG(VBOOT); } @@ -584,10 +584,10 @@ int tpm2_init(struct spi_slave *spi_if) * Claim locality 0, do it only during the first * initialization after reset. */ - if (!tpm2_claim_locality()) + if (tpm2_claim_locality() != CB_SUCCESS) return -1; - if (!read_tpm_sts(&status)) { + if (read_tpm_sts(&status) != CB_SUCCESS) { printk(BIOS_ERR, "Reading status reg failed\n"); return -1; } @@ -635,7 +635,8 @@ int tpm2_init(struct spi_slave *spi_if) } while (chunk_count * chunk_size < sizeof(version_str) - chunk_size); version_str[chunk_count * chunk_size] = '\0'; printk(BIOS_INFO, "Firmware version: %s\n", version_str); - if (cr50_parse_fw_version(version_str, &cr50_firmware_version)) { + + if (cr50_parse_fw_version(version_str, &cr50_firmware_version) != CB_SUCCESS) { printk(BIOS_ERR, "Did not recognize Cr50 version format\n"); return -1; } @@ -650,12 +651,9 @@ int tpm2_init(struct spi_slave *spi_if) /* * This is in seconds, certain TPM commands, like key generation, can take * long time to complete. - * - * Returns one to indicate success, zero (not yet implemented) to indicate - * failure. */ #define MAX_STATUS_TIMEOUT 120 -static int wait_for_status(uint32_t status_mask, uint32_t status_expected) +static enum cb_err wait_for_status(uint32_t status_mask, uint32_t status_expected) { uint32_t status; struct stopwatch sw; @@ -666,12 +664,12 @@ static int wait_for_status(uint32_t status_mask, uint32_t status_expected) if (stopwatch_expired(&sw)) { printk(BIOS_ERR, "failed to get expected status %x\n", status_expected); - return false; + return CB_ERR; } read_tpm_sts(&status); } while ((status & status_mask) != status_expected); - return 1; + return CB_SUCCESS; } enum fifo_transfer_direction { @@ -689,9 +687,9 @@ union fifo_transfer_buffer { * Transfer requested number of bytes to or from TPM FIFO, accounting for the * current burst count value. */ -static int __must_check fifo_transfer(size_t transfer_size, - union fifo_transfer_buffer buffer, - enum fifo_transfer_direction direction) +static enum cb_err __must_check fifo_transfer(size_t transfer_size, + union fifo_transfer_buffer buffer, + enum fifo_transfer_direction direction) { size_t transaction_size; size_t burst_count; @@ -713,22 +711,22 @@ static int __must_check fifo_transfer(size_t transfer_size, transaction_size = MIN(transaction_size, 64); if (direction == fifo_receive) { - if (!tpm2_read_reg(TPM_DATA_FIFO_REG, - buffer.rx_buffer + handled_so_far, - transaction_size)) - return 0; + if (tpm2_read_reg(TPM_DATA_FIFO_REG, + buffer.rx_buffer + handled_so_far, + transaction_size) != CB_SUCCESS) + return CB_ERR; } else { - if (!tpm2_write_reg(TPM_DATA_FIFO_REG, - buffer.tx_buffer + handled_so_far, - transaction_size)) - return 0; + if (tpm2_write_reg(TPM_DATA_FIFO_REG, + buffer.tx_buffer + handled_so_far, + transaction_size) != CB_SUCCESS) + return CB_ERR; } handled_so_far += transaction_size; } while (handled_so_far != transfer_size); - return 1; + return CB_SUCCESS; } size_t tpm2_process_command(const void *tpm2_command, size_t command_size, @@ -761,7 +759,7 @@ size_t tpm2_process_command(const void *tpm2_command, size_t command_size, } /* Let the TPM know that the command is coming. */ - if (!write_tpm_sts(TPM_STS_COMMAND_READY)) { + if (write_tpm_sts(TPM_STS_COMMAND_READY) != CB_SUCCESS) { printk(BIOS_ERR, "TPM_STS_COMMAND_READY failed\n"); return 0; } @@ -778,21 +776,21 @@ size_t tpm2_process_command(const void *tpm2_command, size_t command_size, * burst count or the maximum PDU size, whatever is smaller. */ fifo_buffer.tx_buffer = cmd_body; - if (!fifo_transfer(command_size, fifo_buffer, fifo_transmit)) { + if (fifo_transfer(command_size, fifo_buffer, fifo_transmit) != CB_SUCCESS) { printk(BIOS_ERR, "fifo_transfer %zd command bytes failed\n", command_size); return 0; } /* Now tell the TPM it can start processing the command. */ - if (!write_tpm_sts(TPM_STS_GO)) { + if (write_tpm_sts(TPM_STS_GO) != CB_SUCCESS) { printk(BIOS_ERR, "TPM_STS_GO failed\n"); return 0; } /* Now wait for it to report that the response is ready. */ expected_status_bits = TPM_STS_VALID | TPM_STS_DATA_AVAIL; - if (!wait_for_status(expected_status_bits, expected_status_bits)) { + if (wait_for_status(expected_status_bits, expected_status_bits) != CB_SUCCESS) { /* * If timed out, which should never happen, let's at least * print out the offending command. @@ -831,7 +829,7 @@ size_t tpm2_process_command(const void *tpm2_command, size_t command_size, */ bytes_to_go = payload_size - 1 - HEADER_SIZE; fifo_buffer.rx_buffer = rsp_body + HEADER_SIZE; - if (!fifo_transfer(bytes_to_go, fifo_buffer, fifo_receive)) { + if (fifo_transfer(bytes_to_go, fifo_buffer, fifo_receive) != CB_SUCCESS) { printk(BIOS_ERR, "fifo_transfer %zd receive bytes failed\n", bytes_to_go); return 0; @@ -860,7 +858,7 @@ size_t tpm2_process_command(const void *tpm2_command, size_t command_size, } /* Move the TPM back to idle state. */ - if (!write_tpm_sts(TPM_STS_COMMAND_READY)) { + if (write_tpm_sts(TPM_STS_COMMAND_READY) != CB_SUCCESS) { printk(BIOS_ERR, "TPM_STS_COMMAND_READY failed\n"); return 0; }