12874c5fdSThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */ 2b8b572e1SStephen Rothwell /* 3b8b572e1SStephen Rothwell * include/asm-ppc/pmac_low_i2c.h 4b8b572e1SStephen Rothwell * 5b8b572e1SStephen Rothwell * Copyright (C) 2003 Ben. Herrenschmidt (benh@kernel.crashing.org) 6b8b572e1SStephen Rothwell */ 7b8b572e1SStephen Rothwell #ifndef __PMAC_LOW_I2C_H__ 8b8b572e1SStephen Rothwell #define __PMAC_LOW_I2C_H__ 9b8b572e1SStephen Rothwell #ifdef __KERNEL__ 10b8b572e1SStephen Rothwell 11b8b572e1SStephen Rothwell /* i2c mode (based on the platform functions format) */ 12b8b572e1SStephen Rothwell enum { 13b8b572e1SStephen Rothwell pmac_i2c_mode_dumb = 1, 14b8b572e1SStephen Rothwell pmac_i2c_mode_std = 2, 15b8b572e1SStephen Rothwell pmac_i2c_mode_stdsub = 3, 16b8b572e1SStephen Rothwell pmac_i2c_mode_combined = 4, 17b8b572e1SStephen Rothwell }; 18b8b572e1SStephen Rothwell 19b8b572e1SStephen Rothwell /* RW bit in address */ 20b8b572e1SStephen Rothwell enum { 21b8b572e1SStephen Rothwell pmac_i2c_read = 0x01, 22b8b572e1SStephen Rothwell pmac_i2c_write = 0x00 23b8b572e1SStephen Rothwell }; 24b8b572e1SStephen Rothwell 25b8b572e1SStephen Rothwell /* i2c bus type */ 26b8b572e1SStephen Rothwell enum { 27b8b572e1SStephen Rothwell pmac_i2c_bus_keywest = 0, 28b8b572e1SStephen Rothwell pmac_i2c_bus_pmu = 1, 29b8b572e1SStephen Rothwell pmac_i2c_bus_smu = 2, 30b8b572e1SStephen Rothwell }; 31b8b572e1SStephen Rothwell 32b8b572e1SStephen Rothwell /* i2c bus features */ 33b8b572e1SStephen Rothwell enum { 34b8b572e1SStephen Rothwell /* can_largesub : supports >1 byte subaddresses (SMU only) */ 35b8b572e1SStephen Rothwell pmac_i2c_can_largesub = 0x00000001u, 36b8b572e1SStephen Rothwell 37b8b572e1SStephen Rothwell /* multibus : device node holds multiple busses, bus number is 38b8b572e1SStephen Rothwell * encoded in bits 0xff00 of "reg" of a given device 39b8b572e1SStephen Rothwell */ 40b8b572e1SStephen Rothwell pmac_i2c_multibus = 0x00000002u, 41b8b572e1SStephen Rothwell }; 42b8b572e1SStephen Rothwell 43b8b572e1SStephen Rothwell /* i2c busses in the system */ 44b8b572e1SStephen Rothwell struct pmac_i2c_bus; 45b8b572e1SStephen Rothwell struct i2c_adapter; 46b8b572e1SStephen Rothwell 47b8b572e1SStephen Rothwell /* Init, called early during boot */ 48b8b572e1SStephen Rothwell extern int pmac_i2c_init(void); 49b8b572e1SStephen Rothwell 50b8b572e1SStephen Rothwell /* Lookup an i2c bus for a device-node. The node can be either the bus 51b8b572e1SStephen Rothwell * node itself or a device below it. In the case of a multibus, the bus 52b8b572e1SStephen Rothwell * node itself is the controller node, else, it's a child of the controller 53b8b572e1SStephen Rothwell * node 54b8b572e1SStephen Rothwell */ 55b8b572e1SStephen Rothwell extern struct pmac_i2c_bus *pmac_i2c_find_bus(struct device_node *node); 56b8b572e1SStephen Rothwell 57b8b572e1SStephen Rothwell /* Get the address for an i2c device. This strips the bus number if 58b8b572e1SStephen Rothwell * necessary. The 7 bits address is returned 1 bit right shifted so that the 59b8b572e1SStephen Rothwell * direction can be directly ored in 60b8b572e1SStephen Rothwell */ 61b8b572e1SStephen Rothwell extern u8 pmac_i2c_get_dev_addr(struct device_node *device); 62b8b572e1SStephen Rothwell 63b8b572e1SStephen Rothwell /* Get infos about a bus */ 64b8b572e1SStephen Rothwell extern struct device_node *pmac_i2c_get_controller(struct pmac_i2c_bus *bus); 65b8b572e1SStephen Rothwell extern struct device_node *pmac_i2c_get_bus_node(struct pmac_i2c_bus *bus); 66b8b572e1SStephen Rothwell extern int pmac_i2c_get_type(struct pmac_i2c_bus *bus); 67b8b572e1SStephen Rothwell extern int pmac_i2c_get_flags(struct pmac_i2c_bus *bus); 68b8b572e1SStephen Rothwell extern int pmac_i2c_get_channel(struct pmac_i2c_bus *bus); 69b8b572e1SStephen Rothwell 706dfa5ca3SJean Delvare /* i2c layer adapter helpers */ 71b8b572e1SStephen Rothwell extern struct i2c_adapter *pmac_i2c_get_adapter(struct pmac_i2c_bus *bus); 72b8b572e1SStephen Rothwell extern struct pmac_i2c_bus *pmac_i2c_adapter_to_bus(struct i2c_adapter *adapter); 73b8b572e1SStephen Rothwell 74b8b572e1SStephen Rothwell /* March a device or bus with an i2c adapter structure, to be used by drivers 75b8b572e1SStephen Rothwell * to match device-tree nodes with i2c adapters during adapter discovery 76b8b572e1SStephen Rothwell * callbacks 77b8b572e1SStephen Rothwell */ 78b8b572e1SStephen Rothwell extern int pmac_i2c_match_adapter(struct device_node *dev, 79b8b572e1SStephen Rothwell struct i2c_adapter *adapter); 80b8b572e1SStephen Rothwell 81b8b572e1SStephen Rothwell 82b8b572e1SStephen Rothwell /* (legacy) Locking functions exposed to i2c-keywest */ 83b8b572e1SStephen Rothwell extern int pmac_low_i2c_lock(struct device_node *np); 84b8b572e1SStephen Rothwell extern int pmac_low_i2c_unlock(struct device_node *np); 85b8b572e1SStephen Rothwell 86b8b572e1SStephen Rothwell /* Access functions for platform code */ 87b8b572e1SStephen Rothwell extern int pmac_i2c_open(struct pmac_i2c_bus *bus, int polled); 88b8b572e1SStephen Rothwell extern void pmac_i2c_close(struct pmac_i2c_bus *bus); 89b8b572e1SStephen Rothwell extern int pmac_i2c_setmode(struct pmac_i2c_bus *bus, int mode); 90b8b572e1SStephen Rothwell extern int pmac_i2c_xfer(struct pmac_i2c_bus *bus, u8 addrdir, int subsize, 91b8b572e1SStephen Rothwell u32 subaddr, u8 *data, int len); 92b8b572e1SStephen Rothwell 93b8b572e1SStephen Rothwell /* Suspend/resume code called by via-pmu directly for now */ 94b8b572e1SStephen Rothwell extern void pmac_pfunc_i2c_suspend(void); 95b8b572e1SStephen Rothwell extern void pmac_pfunc_i2c_resume(void); 96b8b572e1SStephen Rothwell 97b8b572e1SStephen Rothwell #endif /* __KERNEL__ */ 98b8b572e1SStephen Rothwell #endif /* __PMAC_LOW_I2C_H__ */ 99