libcros 0.6.6

/* Copyright 2015 The ChromiumOS Authors
 * Use of this source code is governed by a BSD-style license that can be
 * found in the LICENSE file.
 */

#![allow(non_camel_case_types, non_upper_case_globals, dead_code)]

macro_rules! BIT {
  ($nr:expr) => {
    1usize << $nr
  };
}

#[repr(u32)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum vendor_cmd_cc {
  /* Original extension commands */
  EXTENSION_AES = 0,
  EXTENSION_HASH = 1,
  EXTENSION_RSA = 2,
  EXTENSION_ECC = 3,
  EXTENSION_FW_UPGRADE = 4,
  EXTENSION_HKDF = 5,
  EXTENSION_ECIES = 6,
  EXTENSION_POST_RESET = 7,

  LAST_EXTENSION_COMMAND = 15,

  /* Our TPMv2 vendor-specific command codes. 16 bits available. */
  VENDOR_CC_GET_LOCK = 16,
  VENDOR_CC_SET_LOCK = 17,
  VENDOR_CC_SYSINFO = 18,
  /*
   * VENDOR_CC_IMMEDIATE_RESET may have an argument, which is a (uint16_t)
   * time delay (in milliseconds) in doing a reset. Max value is 1000.
   * The command may also be called without an argument, which will be
   * regarded as zero time delay.
   */
  VENDOR_CC_IMMEDIATE_RESET = 19,
  VENDOR_CC_INVALIDATE_INACTIVE_RW = 20,
  VENDOR_CC_COMMIT_NVMEM = 21,
  /* DEPRECATED(22): deep sleep control command. */
  VENDOR_CC_REPORT_TPM_STATE = 23,
  VENDOR_CC_TURN_UPDATE_ON = 24,
  VENDOR_CC_GET_BOARD_ID = 25,
  VENDOR_CC_SET_BOARD_ID = 26,
  VENDOR_CC_U2F_APDU = 27,
  VENDOR_CC_POP_LOG_ENTRY = 28,
  VENDOR_CC_GET_REC_BTN = 29,
  VENDOR_CC_RMA_CHALLENGE_RESPONSE = 30,
  /* DEPRECATED(31): CCD password command (now part of VENDOR_CC_CCD) */
  /*
   * Disable factory mode. Reset all ccd capabilities to default and reset
   * write protect to follow battery presence.
   */
  VENDOR_CC_DISABLE_FACTORY = 32,
  /* DEPRECATED(33): Manage CCD password phase */
  VENDOR_CC_CCD = 34,
  VENDOR_CC_GET_ALERTS_DATA = 35,
  VENDOR_CC_SPI_HASH = 36,
  VENDOR_CC_PINWEAVER = 37,
  /*
   * Check the factory reset settings. If they're all set correctly, do a
   * factory reset to enable ccd factory mode. All capabilities will be
   * set to Always and write protect will be permanently disabled. This
   * mode can't be reset unless VENDOR_CC_DISABLE_FACTORY is called or
   * the 'ccd reset' console command is run.
   */
  VENDOR_CC_RESET_FACTORY = 38,
  /*
   * Get the write protect setting. This will return a single byte with
   * bits communicating the write protect setting as described by the
   * WPV subcommands.
   */
  VENDOR_CC_WP = 39,
  /*
   * Either enable or disable TPM mode. This is allowed for one-time only
   * until next TPM reset EVENT. In other words, once TPM mode is set,
   * then it cannot be altered to the other mode value. The allowed input
   * values are either TPM_MODE_ENABLED or TPM_MODE_DISABLED as defined
   * in 'enum tpm_modes', tpm_registers.h.
   * If the input size is zero, it won't change TPM_MODE.
   * If either the input size is zero or the input value is valid,
   * it will respond with the current tpm_mode value in uint8_t format.
   *
   *  Return code:
   *   VENDOR_RC_SUCCESS: completed successfully.
   *   VENDOR_RC_INTERNAL_ERROR: failed for an internal reason.
   *   VENDOR_RC_NOT_ALLOWED: failed in changing TPM_MODE,
   *                          since it is already set.
   *   VENDOR_RC_NO_SUCH_SUBCOMMAND: failed because the given input
   *                                 is undefined.
   */
  VENDOR_CC_TPM_MODE = 40,
  /*
   * Initializes INFO1 SN data space, and sets SN hash. Takes three
   * int32 as parameters, which are written as the SN hash.
   */
  VENDOR_CC_SN_SET_HASH = 41,
  /*
   * Increments the RMA count in the INFO1 SN data space. The space must
   * have been previously initialized with the _SET_HASH command above for
   * this to succeed. Takes one byte as parameter, which indicates the
   * number to increment the RMA count by; this is typically 1 or 0.
   *
   * Incrementing the RMA count by 0 will set the RMA indicator, but not
   * incremement the count. This is useful to mark that a device has been
   * RMA'd, but that we were not able to log the new serial number.
   *
   * Incrementing the count by the maximum RMA count (currently 7) will
   * always set the RMA count to the maximum value, regardless of the
   * previous value. This can be used with any device, regardless of
   * current state, to mark it as RMA'd but with an unknown RMA count.
   */
  VENDOR_CC_SN_INC_RMA = 42,

  /*
   * Gets the latched state of a power button press to indicate user
   * recent user presence. The power button state is automatically cleared
   * after PRESENCE_TIMEOUT.
   */
  VENDOR_CC_GET_PWR_BTN = 43,

  /*
   * U2F commands.
   */
  VENDOR_CC_U2F_GENERATE = 44,
  VENDOR_CC_U2F_SIGN = 45,
  VENDOR_CC_U2F_ATTEST = 46,

  VENDOR_CC_FLOG_TIMESTAMP = 47,
  VENDOR_CC_ENDORSEMENT_SEED = 48,

  VENDOR_CC_U2F_MODE = 49,

  /*
   * HMAC-SHA256 DRBG invocation for ACVP tests
   */
  VENDOR_CC_DRBG_TEST = 50,

  VENDOR_CC_TRNG_TEST = 51,

  /* EC EFS(Early Firmware Selection) commands */
  VENDOR_CC_GET_BOOT_MODE = 52,
  VENDOR_CC_RESET_EC = 53,

  VENDOR_CC_SEED_AP_RO_CHECK = 54,

  VENDOR_CC_FIPS_CMD = 55,

  VENDOR_CC_GET_AP_RO_HASH = 56,

  VENDOR_CC_GET_AP_RO_STATUS = 57,

  VENDOR_CC_AP_RO_VALIDATE = 58,

  /*
   * Vendor command to disable deep sleep during the next TPM_RST_L
   * assertion. Cr50 used to use 22 to do this. It can't reuse that
   * because some old boards still send it, and deep sleep shouldn't
   * be disabled on those boards.
   */
  VENDOR_CC_DS_DIS_TEMP = 59,

  VENDOR_CC_USER_PRES = 60,

  /* POP_LOG_ENTRY with a 64 bit previous timestamp in ms */
  VENDOR_CC_POP_LOG_ENTRY_MS = 61,

  /*
   * Get/set AP RO configuration settings
   *
   * The message sent and received to this vendor command,
   * with the exception * of SET responses, uses the
   * following form:
   *
   * ```c
   * struct __attribute__((__packed__)) command_msg {
   *   // Current version of the API
   *   uint8_t version;
   *   // Determines payload type, see
   *   // `arv_config_setting_command_e`.
   *   uint8_t command;
   *   // Type here depends on command
   *   struct command_data data;
   * };
   * ```
   */
  VENDOR_CC_GET_AP_RO_VERIFY_SETTING = 62,
  VENDOR_CC_SET_AP_RO_VERIFY_SETTING = 63,

  /* Ti50 only. */
  VENDOR_CC_SET_CAPABILITY = 64,
  VENDOR_CC_GET_TI50_STATS = 65,
  VENDOR_CC_GET_CRASHLOG = 66,
  VENDOR_CC_GET_CONSOLE_LOGS = 67,

  VENDOR_CC_GET_FACTORY_CONFIG = 68,
  VENDOR_CC_SET_FACTORY_CONFIG = 69,

  VENDOR_CC_GET_TIME = 70,

  VENDOR_CC_GET_BOOT_TRACE = 71,

  VENDOR_CC_GET_CHASSIS_OPEN = 72,
  /*
   * 72 was also the old VENDOR_CC_GET_CR50_METRICS value. It was moved
   * to avoid conflict with ti50.
   */
  VENDOR_CC_GET_CR50_METRICS = 73,

  /*
   * Used for UMA collection for feature launch. After feature launch,
   * this can be removed as long as the value is reserved.
   * Cr50 doesn.t use this.
   * VENDOR_CC_GET_AP_RO_RESET_COUNTS = 74,
   */
  /* Returns info to identify the specific GSC chip type. */
  VENDOR_CC_GET_CHIP_ID = 75,

  /* Loads and stores superblock macs for the Trusty storage application.
   */
  VENDOR_CC_TRUSTY_STORAGE_MAC = 77,

  LAST_VENDOR_COMMAND = 65535,
}

pub const CONFIG_EXTENSION_COMMAND: u32 = 0xbaccd00a;
pub const TPM_CC_VENDOR_BIT_MASK: u32 = 0x20000000;

/// vendor_cmd_rc can't be an enum due to duplicate discriminants between
/// the EXTENSION_HASH error codes and the VENDOR_RC codes.
pub type vendor_cmd_rc = u32;

/* EXTENSION_HASH error codes */
/* Attempt to start a session on an active handle. */
pub const EXC_HASH_DUPLICATED_HANDLE: vendor_cmd_rc = 1;
pub const EXC_HASH_TOO_MANY_HANDLES: vendor_cmd_rc = 2; /* No room to allocate a new context. */
/* Continuation/finish on unknown context. */
pub const EXC_HASH_UNKNOWN_CONTEXT: vendor_cmd_rc = 3;

/* Our TPMv2 vendor-specific response codes. */
pub const VENDOR_RC_SUCCESS: vendor_cmd_rc = 0;
pub const VENDOR_RC_BOGUS_ARGS: vendor_cmd_rc = 1;
pub const VENDOR_RC_READ_FLASH_FAIL: vendor_cmd_rc = 2;
pub const VENDOR_RC_WRITE_FLASH_FAIL: vendor_cmd_rc = 3;
pub const VENDOR_RC_REQUEST_TOO_BIG: vendor_cmd_rc = 4;
pub const VENDOR_RC_RESPONSE_TOO_BIG: vendor_cmd_rc = 5;
pub const VENDOR_RC_INTERNAL_ERROR: vendor_cmd_rc = 6;
pub const VENDOR_RC_NOT_ALLOWED: vendor_cmd_rc = 7;
pub const VENDOR_RC_NO_SUCH_SUBCOMMAND: vendor_cmd_rc = 8;
pub const VENDOR_RC_IN_PROGRESS: vendor_cmd_rc = 9;
pub const VENDOR_RC_PASSWORD_REQUIRED: vendor_cmd_rc = 10;
pub const VENDOR_RC_NVMEM_LOCKED: vendor_cmd_rc = 11;

/* Maximum possible failure reason. */
pub const VENDOR_RC_NO_SUCH_COMMAND: vendor_cmd_rc = 127;

/*
 * Bits 10 and 8 set, this is to be ORed with the rest of the error
 * values to make the combined value compliant with the spec
 * requirements.
 */
pub const VENDOR_RC_ERR: vendor_cmd_rc = 0x500;

#[repr(u32)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum tpm_modes {
  TPM_MODE_ENABLED_TENTATIVE = 0,
  TPM_MODE_ENABLED = 1,
  TPM_MODE_DISABLED = 2,
  TPM_MODE_MAX = 3,
}

/* Various upgrade command return values. */
#[repr(u32)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum return_value {
  UPGRADE_SUCCESS = 0,
  UPGRADE_BAD_ADDR = 1,
  UPGRADE_ERASE_FAILURE = 2,
  UPGRADE_DATA_ERROR = 3,
  UPGRADE_WRITE_FAILURE = 4,
  UPGRADE_VERIFY_ERROR = 5,
  UPGRADE_GEN_ERROR = 6,
  UPGRADE_MALLOC_ERROR = 7,
  UPGRADE_ROLLBACK_ERROR = 8,
  UPGRADE_RATE_LIMIT_ERROR = 9,
  UPGRADE_UNALIGNED_BLOCK_ERROR = 10,
  UPGRADE_TRUNCATED_HEADER_ERROR = 11,
  UPGRADE_BOARD_ID_ERROR = 12,
  UPGRADE_BOARD_FLAGS_ERROR = 13,
  UPGRADE_DEV_ID_MISMATCH_ERROR = 14,
}

/* Returns info to identify the specific GSC chip type. */
#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct get_chip_id_response {
  pub tpm_did_vid: u32,
  pub chip_id: u32,
}

/*
 * Type of the GSC device. This is used to represent which type of GSC we are
 * connected to and to tag an image file for compatibility.
 * for downloading.
 */
#[repr(u32)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum gsc_device {
  GSC_DEVICE_H1 = 0,
  GSC_DEVICE_CT = 1,
  GSC_DEVICE_DT = 2,
  GSC_DEVICE_NT = 3,
}

/*****************************************************************************/
/* Ti50 Specific Structs */
#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct ti50_stats_v0 {
  /* filesystem initialization time in ms */
  pub fs_init_time: u32,
  /* filesustem usage in bytes */
  pub fs_usage: u32,
  /* AP RO verification time in ms */
  pub aprov_time: u32,
  /* combination of AP RO verification result and failure reason, used by
   * UMA
   */
  pub expanded_aprov_status: u32,
}

#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct ti50_stats_v1 {
  pub stats: ti50_stats_v0,
  /* [31:27] - bits used
   * [27: 4] - unused
   * [ 3: 3] - CCD_MODE
   * [ 2: 2] - rdd keep alive at boot
   * [ 1: 0] - rdd keep alive state
   */
  pub misc_status: u32,
}

/*
 * Keep in sync with
 * ti50/common/applications/sys_mgr/src/tpm_vendor/metrics.rs
 * The latest time new fields were added as version 2.
 */
#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct ti50_stats {
  pub v1: ti50_stats_v1,
  pub version: u32,
  pub filesystem_busy_count: u32,
  pub crypto_busy_count: u32,
  pub dispatcher_busy_count: u32,
  pub timeslices_expired: u32,
  pub crypto_init_time: u32,
}

pub const METRICSV_BITS_USED_SHIFT: u32 = 27;
pub const METRICSV_RDD_KEEP_ALIVE_MASK: u32 = 3;
pub const METRICSV_RDD_KEEP_ALIVE_AT_BOOT_SHIFT: u32 = 2;
pub const METRICSV_RDD_KEEP_ALIVE_AT_BOOT_MASK: u32 = 1 << METRICSV_RDD_KEEP_ALIVE_AT_BOOT_SHIFT;
pub const METRICSV_CCD_MODE_SHIFT: u32 = 3;
pub const METRICSV_CCD_MODE_MASK: u32 = 1 << METRICSV_CCD_MODE_SHIFT;
pub const METRICSV_WP_ASSERTED_SHIFT: u32 = 4;
pub const METRICSV_WP_ASSERTED_MASK: u32 = 1 << METRICSV_WP_ASSERTED_SHIFT;
pub const METRICSV_ALLOW_UNVERIFIED_RO_SHIFT: u32 = 5;
pub const METRICSV_ALLOW_UNVERIFIED_RO_MASK: u32 = 1 << METRICSV_ALLOW_UNVERIFIED_RO_SHIFT;
pub const METRICSV_IS_PROD_SHIFT: u32 = 6;
pub const METRICSV_IS_PROD_MASK: u32 = 1 << METRICSV_IS_PROD_SHIFT;
pub const METRICSV_RDD_IS_DETECTED_SHIFT: u32 = 7;
pub const METRICSV_RDD_IS_DETECTED_MASK: u32 = 1 << METRICSV_RDD_IS_DETECTED_SHIFT;

/* End Ti50 Specific Structs */
/*****************************************************************************/

/*
 * VENDOR_CC_WP options, only WP_ENABLE is accepted for cr50. For ti50,
 * enable, disable, and follow are all supported.
 */
#[repr(u32)]
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum wp_options {
  WP_NONE = 0,
  WP_CHECK = 1,
  WP_ENABLE = 2,
  WP_DISABLE = 3,
  WP_FOLLOW = 4,
}

/*
 * Subcommand code, used to set write protect.
 */
pub const WPV_UPDATE: usize = BIT!(0);
pub const WPV_ENABLE: usize = BIT!(1);
pub const WPV_FORCE: usize = BIT!(2);
pub const WPV_ATBOOT_SET: usize = BIT!(3);
pub const WPV_ATBOOT_ENABLE: usize = BIT!(4);
pub const WPV_FWMP_FORCE_WP_EN: usize = BIT!(5);

#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct signed_header_version {
  pub minor: u32,
  pub major: u32,
  pub epoch: u32,
}

/// Packet to be recieved during connection establishment.
#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct first_response_pdu {
  pub return_value: u32,

  /* The below fields are present in versions 2 and up. */
  pub protocol_version: u32,

  /* The below fields are present in versions 3 and up. */
  pub backup_ro_offset: u32,
  pub backup_rw_offset: u32,

  /* The below fields are present in versions 4 and up. */
  /* Versions of the currently active RO and RW sections. */
  pub shv: [signed_header_version; 2],

  /* The below fields are present in versions 5 and up */
  /* keyids of the currently active RO and RW sections. */
  pub keyid: [u32; 2],
}

/// Response from VENDOR_CC_SYSINFO
#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct sys_info_repsonse {
  pub ro_keyid: u32,
  pub rw_keyid: u32,
  pub dev_id0: u32,
  pub dev_id1: u32,
}

#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct cr50_stats_response {
  /* struct version number */
  pub version: u32,
  /* Source of last reset. */
  pub reset_src: u32,
  /* Board properties for current boot. */
  pub brdprop: u32,
  /* Misc status.
   * [31: 5] - unused
   * [   4] - ambiguous brdprop
   * [   3] - rddkeepalive atboot state
   * [   2] - CCD_MODE enabled
   * [   1] - rdd keep alive state
   * [   0] - rdd detected
   */
  pub misc_status: u32,
  /* Time since last cr50 reset */
  pub reset_time_s: u32,
  /* Time since last cold reset */
  pub cold_reset_time_s: u32,
}

#[repr(C, packed)]
#[derive(Debug, Clone, Copy)]
pub struct board_id {
  pub board_type: u32,
  pub type_inv: u32,
  pub flags: u32,
}

const F_TAG: usize = size_of::<u16>(); // 2
const F_SUBCMD: usize = size_of::<u16>(); // 2

const F_LEN: usize = size_of::<u32>(); // 4
const F_CODE: usize = size_of::<u32>(); // 4
const F_DIGEST: usize = size_of::<u32>(); // 4
const F_ADDR: usize = size_of::<u32>(); // 4

pub const TPM_ORDINAL_OFFSET: usize = F_TAG + F_LEN;
pub const TPM_SUBCMD_OFFSET: usize = TPM_ORDINAL_OFFSET + F_CODE;
pub const TPM_PKT_CMD_HEADER_SIZE: usize = TPM_SUBCMD_OFFSET + F_SUBCMD;
pub const TPM_PKT_UPG_HEADER_SIZE: usize = TPM_PKT_CMD_HEADER_SIZE + F_DIGEST + F_ADDR;

pub const MAX_RX_BUF_SIZE: usize = 2048;
pub const SIGNED_TRANSFER_SIZE: usize = 1024;
pub const MAX_TX_BUF_SIZE: usize = SIGNED_TRANSFER_SIZE + TPM_PKT_UPG_HEADER_SIZE;