7.8 KiB

Raw Permalink Blame History

HAL IO コールバック

TPM ハードウェアとの通信を処理するために、単一のハードウェア抽象化レイヤー (HAL) コールバックを登録する必要があります。このページでは、コールバック、wolfTPM に同梱されている実装例、およびそれらを制御するビルドオプションについて説明します。

初期セットアップを支援するため、複数のプラットフォーム向けのサンプルが用意されています。システムが提供する組み込みのハードウェアインターフェースを使用する場合は、HAL IO コールバックとして NULL を指定できます。

利用可能なシステム TPM インターフェースは次のとおりです。

Linux /dev/tpm0: WOLFTPM_LINUX_DEV または --enable-devtpm で有効化します。
Windows TBS: WOLFTPM_WINAPI または --enable-winapi で有効化します。
ソフトウェア TPM シミュレータ: WOLFTPM_SWTPM または --enable-swtpm で有効化します。

HAL IO コールバックを使用する場合は、ライブラリの初期化時に次の関数で登録します。

TPM2 ネイティブ API: TPM2_Init
wolfTPM ラッパー: wolfTPM2_Init

HAL 実装例

プラットフォーム	サンプルファイル	ビルドオプション
Atmel ASF	`tpm_io_atmel.c`	`WOLFSSL_ATMEL`
Barebox	`tpm_io_barebox.c`	`__BAREBOX__`
Infineon	`tpm_io_infineon.c`	`WOLFTPM_INFINEON_TRICORE`
Linux	`tpm_io_linux.c`	`__linux__`
Microchip	`tpm_io_microchip.c`	`WOLFTPM_MICROCHIP_HARMONY`
QNX	`tpm_io_qnx.c`	`__QNX__`
ST Cube HAL	`tpm_io_st.c`	`WOLFSSL_STM32_CUBEMX`
wolfHAL	`tpm_io_wolfhal.c`	`WOLFTPM_WOLFHAL`
Xilinx	`tpm_io_xilinx.c`	`__XILINX__`

wolfHAL

WOLFTPM_WOLFHAL または --enable-wolfhal で有効化します。wolfHAL のヘッダーがインクルードパス上にある必要があります。

この HAL はプラットフォーム選択チェーンの最後に配置されているため、他のプラットフォームマクロが定義されていない場合にのみ使用されます。たとえば、CubeMX のヘッダーが存在する STM32 ターゲット向けにビルドすると、代わりに tpm_io_st.c が選択されます。

ボード定義

wolfTPM はボード定義を同梱していません。tpm_io_wolfhal.c は "wolfHAL_board.h" をインクルードするため、アプリケーション側でインクルードパス上に用意する必要があります。wolfHAL のプロジェクトにはすでに存在するため、ほとんどの場合は、以下の TPM 固有のエントリを追加するだけで済みます。

SPI の場合:

マクロ	型	説明
`BOARD_SPI_DEV`	`whal_Spi*`	TPM が接続されている SPI インスタンス
`BOARD_SPI_COM_CFG`	`whal_Spi_ComCfg*`	SPI セッションパラメータ
`BOARD_GPIO_DEV`	`whal_Gpio*`	チップセレクトを駆動する GPIO インスタンス
`BOARD_CS_PIN`	ピン番号	チップセレクトピン (アクティブローで駆動)

I2C の場合 (--enable-i2c が設定する WOLFTPM_ADV_IO も必要):

マクロ	型	説明
`BOARD_I2C_DEV`	`whal_I2c*`	TPM が接続されている I2C インスタンス
`BOARD_I2C_COM_CFG`	`whal_I2c_ComCfg*`	TPM のターゲットアドレスを含む I2C セッションパラメータ

TPM のターゲットアドレスは BOARD_I2C_COM_CFG の addr フィールドに設定します。ほとんどの TPM 2.0 I2C デバイスは 0x2e を使用します。他の I2C HAL が使用する TPM2_I2C_ADDR マクロはここでは効果がないため、定義するとコンパイルエラーになります。

TPM 2.0 の I2C デバイスは、ウェイクアップに約 80 us かかり、準備ができるまで NAK を返すため、各転送は最大 TPM_I2C_TRIES 回 (デフォルトは 10) 再試行されます。この回数を変更するには TPM_I2C_TRIES を定義します。

エントリが不足している場合は、必要なマクロ名を示すメッセージとともにコンパイル時に報告されます。選択したバスで必要なマクロのみがチェックされます。

既存の wolfHAL_board.h への追加例:

/* TPM on SPI1, chip select on PA15 */
extern whal_Spi_ComCfg g_tpmSpiComCfg;
#define BOARD_SPI_COM_CFG  (&g_tpmSpiComCfg)
#define BOARD_CS_PIN       15

I2C の場合は、セッション設定に TPM アドレスを含めます。

/* board.c */
whal_I2c_ComCfg g_tpmI2cComCfg = {
    .freq   = 400000, /* Hz */
    .addr   = 0x2e,   /* TPM target address */
    .addrSz = 7,      /* bits */
};

/* wolfHAL_board.h */
extern whal_I2c_ComCfg g_tpmI2cComCfg;
#define BOARD_I2C_COM_CFG  (&g_tpmI2cComCfg)