zephyr/drivers/smbus/intel_pch_smbus.h

149 lines
5.4 KiB
C

/*
* Copyright (c) 2022 Intel Corporation
*
* Intel I/O Controller Hub (ICH) later renamed to Intel Platform Controller
* Hub (PCH) SMBus driver.
*
* PCH provides SMBus 2.0 - compliant Host Controller.
*
* SPDX-License-Identifier: Apache-2.0
*/
#ifndef ZEPHYR_DRIVERS_SMBUS_PCH_H_
#define ZEPHYR_DRIVERS_SMBUS_PCH_H_
/* PCI Configuration Space registers */
/* Host Configuration (HCFG) - Offset 40h, 8 bits */
#define PCH_SMBUS_HCFG 0x10
#define PCH_SMBUS_HCFG_HST_EN BIT(0) /* Enable SMBus controller */
/* PCH SMBus I/O and Memory Mapped registers */
/* Host Status Register Address (HSTS) */
#define PCH_SMBUS_HSTS 0x00
#define PCH_SMBUS_HSTS_HOST_BUSY BIT(0) /* Host Busy */
#define PCH_SMBUS_HSTS_INTERRUPT BIT(1) /* Interrupt */
#define PCH_SMBUS_HSTS_DEV_ERROR BIT(2) /* Device Error */
#define PCH_SMBUS_HSTS_BUS_ERROR BIT(3) /* Bus Error */
#define PCH_SMBUS_HSTS_FAILED BIT(4) /* Failed */
#define PCH_SMBUS_HSTS_SMB_ALERT BIT(5) /* SMB Alert */
#define PCH_SMBUS_HSTS_INUSE BIT(6) /* In Use */
#define PCH_SMBUS_HSTS_BYTE_DONE BIT(7) /* Byte Done */
#define PCH_SMBUS_HSTS_ERROR (PCH_SMBUS_HSTS_DEV_ERROR | \
PCH_SMBUS_HSTS_BUS_ERROR | \
PCH_SMBUS_HSTS_FAILED)
/* Host Control Register (HCTL) */
#define PCH_SMBUS_HCTL 0x02 /* Host Control */
#define PCH_SMBUS_HCTL_INTR_EN BIT(0) /* INT Enable */
#define PCH_SMBUS_HCTL_KILL BIT(1) /* Kill current trans */
#define PCH_SMBUS_HCTL_CMD GENMASK(4, 2) /* Command */
/* SMBUS Commands */
#define PCH_SMBUS_HCTL_CMD_QUICK (0 << 2) /* Quick cmd*/
#define PCH_SMBUS_HCTL_CMD_BYTE (1 << 2) /* Byte cmd */
#define PCH_SMBUS_HCTL_CMD_BYTE_DATA (2 << 2) /* Byte Data cmd */
#define PCH_SMBUS_HCTL_CMD_WORD_DATA (3 << 2) /* Word Data cmd */
#define PCH_SMBUS_HCTL_CMD_PROC_CALL (4 << 2) /* Process Call cmd */
#define PCH_SMBUS_HCTL_CMD_BLOCK (5 << 2) /* Block cmd */
#define PCH_SMBUS_HCTL_CMD_I2C_READ (6 << 2) /* I2C Read cmd */
#define PCH_SMBUS_HCTL_CMD_BLOCK_PROC (7 << 2) /* Block Process cmd */
#define PCH_SMBUS_HCTL_CMD_SET(cmd) (cmd << 2)
#define PCH_SMBUS_HCTL_CMD_GET(val) (val & PCH_SMBUS_HCTL_CMD)
#define PCH_SMBUS_HCTL_LAST_BYTE BIT(5) /* Last byte block op */
#define PCH_SMBUS_HCTL_START BIT(6) /* Start SMBUS cmd */
#define PCH_SMBUS_HCTL_PEC_EN BIT(7) /* Enable PEC */
/* Host Command Register (HCMD) */
#define PCH_SMBUS_HCMD 0x03
/* Transmit Slave Address Register (TSA) */
#define PCH_SMBUS_TSA 0x04
#define PCH_SMBUS_TSA_RW BIT(0) /* Direction */
#define PCH_SMBUS_TSA_ADDR_MASK GENMASK(7, 1) /* Address mask */
/* Set 7-bit address */
#define PCH_SMBUS_TSA_ADDR_SET(addr) (((addr) & BIT_MASK(7)) << 1)
/* Get Peripheral address from register value */
#define PCH_SMBUS_TSA_ADDR_GET(reg) ((reg >> 1) & BIT_MASK(7))
/* Data 0 Register (HD0) */
#define PCH_SMBUS_HD0 0x05 /* Data 0 / Count */
/* Data 1 Register (HD1) */
#define PCH_SMBUS_HD1 0x06 /* Data 1 */
/* Host Block Data (HBD) */
#define PCH_SMBUS_HBD 0x07 /* Host block data */
/* Packet Error Check Data Register (PEC) */
#define PCH_SMBUS_PEC 0x08 /* PEC data */
/* Receive Slave Address Register (RSA) */
#define PCH_SMBUS_RSA 0x09 /* Receive slave addr */
/* Slave Data Register (SD) (16 bits) */
#define PCH_SMBUS_SD 0x0a /* Slave data */
/* Auxiliary Status (AUXS) */
#define PCH_SMBUS_AUXS 0x0c /* Auxiliary Status */
#define PCH_SMBUS_AUXS_CRC_ERROR BIT(0) /* CRC error */
/* Auxiliary Control (AUXC) */
#define PCH_SMBUS_AUXC 0x0d /* Auxiliary Control */
#define PCH_SMBUS_AUXC_AAC BIT(0) /* Auto append CRC */
#define PCH_SMBUS_AUXC_EN_32BUF BIT(1) /* Enable 32-byte buf */
/* SMLink Pin Control Register (SMLC) */
#define PCH_SMBUS_SMLC 0x0e /* SMLink pin control */
/* SMBus Pin control Register (SMBC) */
#define PCH_SMBUS_SMBC 0x0f /* SMBus pin control */
#define PCH_SMBUS_SMBC_CLK_CUR_STS BIT(0) /* SMBCLK pin status */
#define PCH_SMBUS_SMBC_DATA_CUR_STS BIT(1) /* SMBDATA pin status */
#define PCH_SMBUS_SMBC_CLK_CTL BIT(2) /* SMBCLK pin CTL */
/* Slave Status Register (SSTS) */
#define PCH_SMBUS_SSTS 0x10 /* Slave Status */
#define PCH_SMBUS_SSTS_HNS BIT(0) /* Host Notify Status */
/* Slave Command Register (SCMD) */
#define PCH_SMBUS_SCMD 0x11 /* Slave Command */
#define PCH_SMBUS_SCMD_HNI_EN BIT(0) /* Host Notify INT En */
#define PCH_SMBUS_SCMD_HNW_EN BIT(1) /* Host Notify Wake */
#define PCH_SMBUS_SCMD_SMBALERT_DIS BIT(2) /* Disable Smbalert */
/* Notify Device Address Register (NDA) */
#define PCH_SMBUS_NDA 0x14 /* Notify Device addr */
/* Notify Data Low Byte Register (NDLB) */
#define PCH_SMBUS_NDLB 0x16 /* Notify Data low */
/* Notify Data High Byte Register (NDHB) */
#define PCH_SMBUS_NDHB 0x17 /* Notify Data high */
/* Debug helpers */
#if CONFIG_SMBUS_LOG_LEVEL >= LOG_LEVEL_DBG
/* Dump HSTS register using define to show calling function */
#define pch_dump_register_hsts(reg) \
LOG_DBG("HSTS: 0x%02x: %s%s%s%s%s%s%s%s", reg, \
reg & PCH_SMBUS_HSTS_HOST_BUSY ? "[Host Busy] " : "", \
reg & PCH_SMBUS_HSTS_INTERRUPT ? "[Interrupt] " : "", \
reg & PCH_SMBUS_HSTS_DEV_ERROR ? "[Device Error] " : "",\
reg & PCH_SMBUS_HSTS_BUS_ERROR ? "[Bus Error] " : "", \
reg & PCH_SMBUS_HSTS_FAILED ? "[Failed] " : "", \
reg & PCH_SMBUS_HSTS_SMB_ALERT ? "[SMBALERT] " : "", \
reg & PCH_SMBUS_HSTS_BYTE_DONE ? "[Byte Done] " : "", \
reg & PCH_SMBUS_HSTS_INUSE ? "[In USE] " : "");
#else
#define pch_dump_register_hsts(reg)
#endif
#endif /* ZEPHYR_DRIVERS_SMBUS_PCH_H_ */