drivers/i3c/master/dw-i3c-master.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  * Copyright (c) 2023 Code Construct
   4  *
   5  * Author: Jeremy Kerr <jk@codeconstruct.com.au>
   6  */
   7
   8 #include <linux/clk.h>
   9 #include <linux/i3c/master.h>
  10 #include <linux/reset.h>
  11 #include <linux/types.h>
  12
  13 #define DW_I3C_MAX_DEVS 32
  14
  15 struct dw_i3c_master_caps {
  16         u8 cmdfifodepth;
  17         u8 datafifodepth;
  18 };
  19
  20 struct dw_i3c_dat_entry {
  21         u8 addr;
  22         bool is_i2c_addr;
  23         struct i3c_dev_desc *ibi_dev;
  24 };
  25
  26 struct dw_i3c_master {
  27         struct i3c_master_controller base;
  28         struct device *dev;
  29         u16 maxdevs;
  30         u16 datstartaddr;
  31         u32 free_pos;
  32         struct {
  33                 struct list_head list;
  34                 struct dw_i3c_xfer *cur;
  35                 spinlock_t lock;
  36         } xferqueue;
  37         struct dw_i3c_master_caps caps;
  38         void __iomem *regs;
  39         struct reset_control *core_rst;
  40         struct clk *core_clk;
  41         struct clk *pclk;
  42         char version[5];
  43         char type[5];
  44         u32 sir_rej_mask;
  45         bool i2c_slv_prsnt;
  46         u32 dev_addr;
  47         u32 i3c_pp_timing;
  48         u32 i3c_od_timing;
  49         u32 ext_lcnt_timing;
  50         u32 bus_free_timing;
  51         u32 i2c_fm_timing;
  52         u32 i2c_fmp_timing;
  53         u32 quirks;
  54         /*
  55          * Per-device hardware data, used to manage the device address table
  56          * (DAT)
  57          *
  58          * Locking: the devs array may be referenced in IRQ context while
  59          * processing an IBI. However, IBIs (for a specific device, which
  60          * implies a specific DAT entry) can only happen while interrupts are
  61          * requested for that device, which is serialised against other
  62          * insertions/removals from the array by the global i3c infrastructure.
  63          * So, devs_lock protects against concurrent updates to devs->ibi_dev
  64          * between request_ibi/free_ibi and the IBI irq event.
  65          */
  66         struct dw_i3c_dat_entry devs[DW_I3C_MAX_DEVS];
  67         spinlock_t devs_lock;
  68
  69         /* platform-specific data */
  70         const struct dw_i3c_platform_ops *platform_ops;
  71
  72         struct work_struct hj_work;
  73 };
  74
  75 struct dw_i3c_platform_ops {
  76         /*
  77          * Called on early bus init: the i3c has been set up, but before any
  78          * transactions have taken place. Platform implementations may use to
  79          * perform actual device enabling with the i3c core ready.
  80          */
  81         int (*init)(struct dw_i3c_master *i3c);
  82
  83         /*
  84          * Initialise a DAT entry to enable/disable IBIs. Allows the platform
  85          * to perform any device workarounds on the DAT entry before
  86          * inserting into the hardware table.
  87          *
  88          * Called with the DAT lock held; must not sleep.
  89          */
  90         void (*set_dat_ibi)(struct dw_i3c_master *i3c,
  91                             struct i3c_dev_desc *dev, bool enable, u32 *reg);
  92 };
  93
  94 extern int dw_i3c_common_probe(struct dw_i3c_master *master,
  95                                struct platform_device *pdev);
  96 extern void dw_i3c_common_remove(struct dw_i3c_master *master);
  97