xref: /aosp_15_r20/external/coreboot/src/include/device/smbus_host.h (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 
3 #ifndef __DEVICE_SMBUS_HOST_H__
4 #define __DEVICE_SMBUS_HOST_H__
5 
6 #include <stddef.h>
7 #include <stdint.h>
8 #include <console/console.h>
9 
10 /* Low-level SMBUS host controller. */
11 
12 int do_smbus_recv_byte(uintptr_t base, u8 device);
13 int do_smbus_send_byte(uintptr_t base, u8 device, u8 val);
14 int do_smbus_read_byte(uintptr_t base, u8 device, u8 address);
15 int do_smbus_write_byte(uintptr_t base, u8 device, u8 address, u8 data);
16 int do_smbus_read_word(uintptr_t base, u8 device, u8 address);
17 int do_smbus_write_word(uintptr_t base, u8 device, u8 address, u16 data);
18 
19 int do_smbus_block_read(uintptr_t base, u8 device, u8 cmd, size_t max_bytes, u8 *buf);
20 int do_smbus_block_write(uintptr_t base, u8 device, u8 cmd, size_t bytes, const u8 *buf);
21 int do_smbus_process_call(uintptr_t base, u8 device, u8 cmd, u16 data, u16 *buf);
22 
23 /* For Intel, implemented since ICH5. */
24 int do_i2c_eeprom_read(uintptr_t base, u8 device, u8 offset, size_t bytes, u8 *buf);
25 int do_i2c_block_write(uintptr_t base, u8 device, size_t bytes, u8 *buf);
26 
27 /* Upstream API */
28 
29 uintptr_t smbus_base(void);
30 int smbus_enable_iobar(uintptr_t base);
31 void smbus_host_reset(uintptr_t base);
32 void smbus_set_slave_addr(uintptr_t base, u8 slave_address);
33 
enable_smbus(void)34 static inline void enable_smbus(void)
35 {
36 	uintptr_t base = smbus_base();
37 
38 	if (smbus_enable_iobar(base) < 0)
39 		die("SMBus controller not found!");
40 
41 	smbus_host_reset(base);
42 	printk(BIOS_DEBUG, "SMBus controller enabled\n");
43 }
44 
45 #if DEVTREE_EARLY
smbus_read_byte(u8 device,u8 address)46 static inline int smbus_read_byte(u8 device, u8 address)
47 {
48 	uintptr_t base = smbus_base();
49 	return do_smbus_read_byte(base, device, address);
50 }
51 
smbus_read_word(u8 device,u8 address)52 static inline int smbus_read_word(u8 device, u8 address)
53 {
54 	uintptr_t base = smbus_base();
55 	return do_smbus_read_word(base, device, address);
56 }
57 
smbus_write_byte(u8 device,u8 address,u8 data)58 static inline int smbus_write_byte(u8 device, u8 address, u8 data)
59 {
60 	uintptr_t base = smbus_base();
61 	return do_smbus_write_byte(base, device, address, data);
62 }
63 
smbus_block_read(u8 device,u8 cmd,size_t max_bytes,u8 * buf)64 static inline int smbus_block_read(u8 device, u8 cmd, size_t max_bytes, u8 *buf)
65 {
66 	uintptr_t base = smbus_base();
67 	return do_smbus_block_read(base, device, cmd, max_bytes, buf);
68 }
69 
smbus_block_write(u8 device,u8 cmd,size_t bytes,const u8 * buf)70 static inline int smbus_block_write(u8 device, u8 cmd, size_t bytes, const u8 *buf)
71 {
72 	uintptr_t base = smbus_base();
73 	return do_smbus_block_write(base, device, cmd, bytes, buf);
74 }
75 
i2c_eeprom_read(u8 device,u8 offset,size_t bytes,u8 * buf)76 static inline int i2c_eeprom_read(u8 device, u8 offset, size_t bytes, u8 *buf)
77 {
78 	uintptr_t base = smbus_base();
79 	return do_i2c_eeprom_read(base, device, offset, bytes, buf);
80 }
81 #endif
82 
83 #endif
84