diff options
Diffstat (limited to 'src/superio/smsc/sch5545/sch5545_emi.h')
-rw-r--r-- | src/superio/smsc/sch5545/sch5545_emi.h | 167 |
1 files changed, 167 insertions, 0 deletions
diff --git a/src/superio/smsc/sch5545/sch5545_emi.h b/src/superio/smsc/sch5545/sch5545_emi.h new file mode 100644 index 0000000000..2bf3a769a5 --- /dev/null +++ b/src/superio/smsc/sch5545/sch5545_emi.h @@ -0,0 +1,167 @@ +/* SPDX-License-Identifier: GPL-2.0-only */ + +#ifndef SUPERIO_SCH_5545_EMI_H +#define SUPERIO_SCH_5545_EMI_H + +#include <stdlib.h> +#include <stdint.h> + +/* Embedded Memory Interface registers */ +#define SCH5545_EMI_HOST_TO_EC_MAILBOX 0x0 +#define SCH5545_EMI_EC_TO_HOST_MAILBOX 0x1 +#define SCH5545_EMI_EC_ADDR 0x2 +#define SCH5545_EMI_EC_DATA 0x4 +#define SCH5545_EMI_INT_SOURCE 0x8 +#define SCH5545_EMI_INT_MASK 0xa + +#define EMI_EC_8BIT_ACCESS 0 +#define EMI_EC_16BIT_ACCESS 1 +#define EMI_EC_32BIT_ACCESS 2 +#define EMI_EC_32BIT_AUTO_ACCESS 3 + +/** + * Reads and returns the base address of EMI from the SuperIO. + */ +uint16_t sch5545_read_emi_bar(uint8_t sio_port); +/** + * One must call this function at every stage before using any of the EMI + * functions. The base address of EMI interface must not be zero. + */ +void sch5545_emi_init(uint8_t sio_port); +/** + * Reads the EC to Host mailbox register and then writes the same content to + * clear it. + */ +void sch5545_emi_ec2h_mailbox_clear(void); +/** + * Writes the interrupt mask register with 0. + */ +void sch5545_emi_disable_interrupts(void); +/** + * Writes the Host to EC mailbox 8bit register with mbox_message. + */ +void sch5545_emi_h2ec_mbox_write(uint8_t mbox_message); +/** + * Reads and returns the Host to EC mailbox 8bit register. + */ +uint8_t sch5545_emi_h2ec_mbox_read(void); +/** + * Writes the EC to Host mailbox 8bit register with mbox_message. + */ +void sch5545_emi_ec2h_mbox_write(uint8_t mbox_message); +/** + * Reads and returns the EC to Host mailbox 8bit register. + */ +uint8_t sch5545_emi_ec2h_mbox_read(void); +/** + * Sets the mask for all EC interrupts. + */ +void sch5545_emi_set_int_mask(uint16_t mask); +/** + * Sets the EC interrupt mask for LSB in the Interrupt Mask register. + */ +void sch5545_emi_set_int_mask_low(uint8_t mask); +/** + * Sets the EC interrupt mask for MSB in the Interrupt Mask register. + */ +void sch5545_emi_set_int_mask_high(uint8_t mask); +/** + * Returns LSB of Interrupt mask register. + */ +uint8_t sch5545_emi_get_int_mask_low(void); +/** + * Returns MSB of Interrupt mask register. + */ +uint8_t sch5545_emi_get_int_mask_high(void); +/** + * Returns the content of interrupt mask register. + */ +uint16_t sch5545_emi_get_int_mask(void); +/** + * Clears the interrupt status bits. + */ +void sch5545_emi_clear_int_src(void); +/** + * Writes int_src bits to clear the desired interrupt source LSB. + */ +void sch5545_emi_set_int_src_low(uint8_t int_src); +/** + * Writes int_src bits to clear the desired interrupt source MSB. + */ +void sch5545_emi_set_int_src_high(uint8_t int_src); +/** + * Writes int_src bits to clear the desired interrupt source bits. + */ +void sch5545_emi_set_int_src(uint16_t int_src); +/** + * Returns LSB of interrupt source register. + */ +uint8_t sch5545_emi_get_int_src_low(void); +/** + * Returns MSB of interrupt source register. + */ +uint8_t sch5545_emi_get_int_src_high(void); +/** + * Returns the content of interrupt source register. + */ +uint16_t sch5545_emi_get_int_src(void); +/** + * Sets the EC address registers with given addr for indirect access to + * Embedded Memory. + */ +void sch5545_emi_set_ec_addr(uint16_t addr); +/** + * Return the current EC address used for indirect access to Embedded Memory. + */ +uint16_t sch5545_emi_read_ec_addr(void); +/** + * Writes any byte of 4 bytes from the 32bit dword indicated by addr. The + * function will automatically align to the matching 32bit dword. + */ +void sch5545_emi_ec_write8(uint16_t addr, uint8_t data); +/** + * Writes any word of 2 words from the 32bit dword indicated by addr. The addr + * must be aligned to 16bit access, because function programs the right access + * mode rounding the address to be written to 16 bit boundary. + */ +void sch5545_emi_ec_write16(uint16_t addr, uint16_t data); +/** + * Writes dword of data at the desired address indicated by addr. The addr must + * be aligned to 32bit access, because function programs the right access mode + * rounding the address to be written to 32 bit boundary. + */ +void sch5545_emi_ec_write32(uint16_t addr, uint32_t data); +/** + * Writes an array of dwords at the desired address indicated by addr. The addr + * must be aligned to 32bit access, because function programs the right access + * mode rounding the address to be written to 32 bit boundary. The address is + * autoincremented by each IO write operation automatically. + */ +void sch5545_emi_ec_write32_bulk(uint16_t addr, const uint32_t *buffer, size_t len); +/** + * Reads any byte of 4 bytes from the 32bit dword indicated by addr. The + * function will automatically align to the matching 32bit dword. + */ +uint8_t sch5545_emi_ec_read8(uint16_t addr); +/** + * Reads any word of 2 words from the 32bit dword indicated by addr. The addr + * must be aligned to 16bit access, because function programs the right access + * mode rounding the address to be read to 16 bit boundary. + */ +uint16_t sch5545_emi_ec_read16(uint16_t addr); +/** + * Reads dword of data at the desired address indicated by addr. The addr must + * be aligned to 32bit access, because function programs the right access mode + * rounding the address to be read to 32 bit boundary. + */ +uint32_t sch5545_emi_ec_read32(uint16_t addr); +/** + * Reads a stream of dwords of size len to an array of dwords from the desired + * address indicated by addr. The addr must be aligned to 32bit access, because + * function programs the right access mode rounding the start address to be + * read to 32 bit boundary. The address is autoincremented by each IO read + * operation automatically. + */ +void sch5545_emi_ec_read32_bulk(uint16_t addr, uint32_t *buffer, size_t len); + +#endif /* SUPERIO_SCH_5545_EMI_H */ |